microsoft-graph 2.32.0 → 2.34.0

package/dist/esm/tasks/updateWorkbookRangeRows.js

@@ -0,0 +1,249 @@
+/**
+ * Update rows in a given workbook range.
+ * @module updateRows
+ * @category Tasks
+ * @experimental
+ */
+import { isEqual } from "lodash";
+import InvalidArgumentError from "../errors/InvalidArgumentError.js";
+import mergeWorkbookRange from "../operations/workbookRange/mergeWorkbookRange.js";
+import setWorkbookRangeBorder from "../operations/workbookRange/setWorkbookRangeBorder.js";
+import setWorkbookRangeFill from "../operations/workbookRange/setWorkbookRangeFill.js";
+import setWorkbookRangeFont from "../operations/workbookRange/setWorkbookRangeFont.js";
+import setWorkbookRangeFormat from "../operations/workbookRange/setWorkbookRangeFormat.js";
+import updateWorkbookRange from "../operations/workbookRange/updateWorkbookRange.js";
+import { superRange } from "../services/addressManipulation.js";
+import { maxCellsPerRequest } from "../services/batch.js";
+import { camelCaseToPascalCase } from "../services/stringCaseConversion.js";
+/**
+ * Update rows in a given workbook range.
+ * @param originRef Reference to the workbook range to update. Only the upper-left cell is used as an origin point.
+ * @param cells Array of arrays of cells to update in the specified range.
+ * @param maxCellsPerOperation Prescribe max cells to retrieve per operation. `null` automatically determines value. DO NOT SET EXCEPT FOR ADVANCED TUNING.
+ * @remarks `undefined` values are left unchanged. Applying styling to cells is slow, use sparingly.
+ * @experimental
+ * @example
+ * // Basic example:
+ * await updateRows(rangeRef, [
+ *   [{ value: 1 }, { value: 2 }],
+ *   [{ value: 3 }, { value: 4 }],
+ *   [{ value: 5 }, { value: 6 }],
+ * ]);
+ *
+ * // Advanced example with cell formatting:
+ * await updateRows(rangeRef, [
+ *   [{ value: "Column A", style: { alignment: { horizontal: "Right" }, font: { bold: true } } }, { value: "Column B", style: { alignment: { horizontal: "Right" }, font: { bold: true } }  }],
+ *   [{ value: 1, format: accountingCellFormat }, { value: "A" }],
+ *   [{ value: 2, format: accountingCellFormat }, { value: "B" }],
+ * ]);
+ */
+export default async function updateWorkbookRangeRows(originRef, cells, maxCellsPerOperation = null) {
+    let maxRowsPerOperation = maxCellsPerOperation;
+    let colCount = null;
+    let rowCount = 0;
+    const batch = [];
+    for await (const row of cells) {
+        if (colCount === null) {
+            colCount = row.length;
+        }
+        else if (colCount !== row.length) {
+            throw new InvalidArgumentError("Not all rows have the same number of cells. Ensure all rows are consistent in length.");
+        }
+        if (maxRowsPerOperation === null) {
+            maxRowsPerOperation = calculateMaxRowsPerOperation(colCount, maxCellsPerOperation);
+        }
+        if (batch.push(row) >= maxRowsPerOperation) {
+            rowCount += await writeBatch(batch, originRef, rowCount, colCount);
+        }
+    }
+    if (colCount !== null) {
+        rowCount += await writeBatch(batch, originRef, rowCount, colCount);
+    }
+}
+async function writeBatch(cells, originRef, rowsCompleted, colCount) {
+    const rowCount = cells.length;
+    if (rowCount === 0) {
+        return 0;
+    }
+    const rangeRef = superRange(originRef, rowsCompleted, rowCount, 0, colCount);
+    await writeValuesTextFormat(cells, rangeRef);
+    await writeMerges(cells, rangeRef, rowCount, colCount);
+    await writeAlignment(cells, rangeRef, rowCount, colCount);
+    await writeBorders(cells, rangeRef, rowCount, colCount);
+    await writeFill(cells, rangeRef, rowCount, colCount);
+    await writeFont(cells, rangeRef, rowCount, colCount);
+    cells.length = 0;
+    return rowCount;
+}
+async function writeValuesTextFormat(cells, rangeRef) {
+    const values = cells.map((r) => r.map((c) => c.value));
+    const text = cells.map((r) => r.map((c) => c.text));
+    const numberFormat = cells.map((r) => r.map((c) => c.format));
+    const hasValues = values.some((row) => row.some((value) => value !== undefined && value !== null));
+    const hasText = text.some((row) => row.some((value) => value !== undefined && value !== null));
+    const hasNumberFormat = numberFormat.some((row) => row.some((value) => value !== undefined && value !== null));
+    if (!(hasValues || hasText || hasNumberFormat)) {
+        return;
+    }
+    await updateWorkbookRange(rangeRef, {
+        values: hasValues ? values : undefined,
+        text: hasText ? text : undefined,
+        numberFormat: hasNumberFormat ? numberFormat : undefined,
+    });
+}
+async function writeMerges(cells, rangeRef, rowCount, colCount) {
+    const merged = new Array(rowCount).fill(null).map(() => new Array(colCount).fill(false));
+    for (let r = 0; r < rowCount; r++) {
+        for (let c = 0; c < colCount; c++) {
+            if (merged[r]?.[c]) {
+                continue;
+            }
+            const merge = cells[r]?.[c]?.merge;
+            if (!(merge?.right || merge?.down)) {
+                continue;
+            }
+            const rowSpan = (merge.down ?? 0) + 1;
+            const colSpan = (merge.right ?? 0) + 1;
+            markMerged(r, rowSpan, c, colSpan);
+            const subRangeRef = superRange(rangeRef, r, rowSpan, c, colSpan);
+            await mergeWorkbookRange(subRangeRef);
+        }
+    }
+    function markMerged(r, rowSpan, c, colSpan) {
+        for (let rr = r; rr < r + rowSpan; rr++) {
+            for (let cc = c; cc < c + colSpan; cc++) {
+                if (rr < rowCount && cc < colCount) {
+                    if (merged[rr][cc]) {
+                        throw new InvalidArgumentError(`Cell at (${rr}, ${cc}) is involved in multiple merges in this batch.`);
+                    }
+                    merged[rr][cc] = true;
+                }
+            }
+        }
+    }
+}
+async function writeAlignment(cells, originRef, rowCount, colCount) {
+    await forEachIdenticalRange(cells, rowCount, colCount, originRef, (cell) => cell.alignment, async (subRangeRef, alignment) => {
+        await setWorkbookRangeFormat(subRangeRef, {
+            verticalAlignment: alignment.vertical ?? null,
+            horizontalAlignment: alignment.horizontal ?? null,
+            wrapText: alignment.wrapText ?? null,
+        });
+    });
+}
+async function writeBorders(cells, originRef, rowCount, colCount) {
+    await forEachIdenticalRange(cells, rowCount, colCount, originRef, (cell) => cell.borders, async (subRangeRef, borders) => {
+        for (const key of Object.keys(borders)) {
+            const edge = camelCaseToPascalCase(key);
+            const border = borders[key];
+            if (border) {
+                await setWorkbookRangeBorder(subRangeRef, edge, border);
+            }
+        }
+    });
+}
+async function writeFill(cells, originRef, rowCount, colCount) {
+    await forEachIdenticalRange(cells, rowCount, colCount, originRef, (cell) => cell.fill, async (subRangeRef, fill) => {
+        await setWorkbookRangeFill(subRangeRef, fill);
+    });
+}
+async function writeFont(cells, originRef, rowCount, colCount) {
+    await forEachIdenticalRange(cells, rowCount, colCount, originRef, (cell) => cell.font, async (subRangeRef, font) => {
+        await setWorkbookRangeFont(subRangeRef, font);
+    });
+}
+async function forEachIdenticalRange(cells, rowCount, colCount, originRef, getValue, callback) {
+    const horizontalRanges = findRanges(true);
+    const verticalRanges = findRanges(false);
+    const bestRanges = horizontalRanges.length <= verticalRanges.length ? horizontalRanges : verticalRanges;
+    for (const { rangeRef, value } of bestRanges) {
+        await callback(rangeRef, value);
+    }
+    function idx(r, c) {
+        return r * colCount + c;
+    }
+    function expandHorizontally(r, c, value, visited) {
+        let maxCol = c;
+        while (maxCol + 1 < colCount && !visited[idx(r, maxCol + 1)] && isEqual(getValue(cells[r]?.[maxCol + 1] ?? {}), value)) {
+            maxCol++;
+        }
+        return maxCol;
+    }
+    function expandVertically(r, c, value, visited) {
+        let maxRow = r;
+        while (maxRow + 1 < rowCount && !visited[idx(maxRow + 1, c)] && isEqual(getValue(cells[maxRow + 1]?.[c] ?? {}), value)) {
+            maxRow++;
+        }
+        return maxRow;
+    }
+    function canExpandRow(r, cStart, cEnd, value, visited) {
+        for (let cc = cStart; cc <= cEnd; cc++) {
+            if (visited[idx(r, cc)] || !isEqual(getValue(cells[r]?.[cc] ?? {}), value)) {
+                return false;
+            }
+        }
+        return true;
+    }
+    function canExpandCol(c, rStart, rEnd, value, visited) {
+        for (let rr = rStart; rr <= rEnd; rr++) {
+            if (visited[idx(rr, c)] || !isEqual(getValue(cells[rr]?.[c] ?? {}), value)) {
+                return false;
+            }
+        }
+        return true;
+    }
+    function markVisitedAndPushRange(r, c, maxRow, maxCol, value, visited, ranges) {
+        for (let rr = r; rr <= maxRow; rr++) {
+            for (let cc = c; cc <= maxCol; cc++) {
+                visited[idx(rr, cc)] = true;
+            }
+        }
+        if (value) {
+            const subRangeRef = superRange(originRef, r, maxRow - r + 1, c, maxCol - c + 1);
+            ranges.push({
+                rangeRef: subRangeRef,
+                value,
+            });
+        }
+    }
+    function expandRange(r, c, value, horizontalFirst, visited) {
+        let maxRow = r;
+        let maxCol = c;
+        if (horizontalFirst) {
+            maxCol = expandHorizontally(r, c, value, visited);
+            while (maxRow + 1 < rowCount && canExpandRow(maxRow + 1, c, maxCol, value, visited)) {
+                maxRow++;
+            }
+        }
+        else {
+            maxRow = expandVertically(r, c, value, visited);
+            while (maxCol + 1 < colCount && canExpandCol(maxCol + 1, r, maxRow, value, visited)) {
+                maxCol++;
+            }
+        }
+        return { maxRow, maxCol };
+    }
+    function findRanges(horizontalFirst) {
+        const visited = new Array(rowCount * colCount).fill(false);
+        const ranges = [];
+        for (let r = 0; r < rowCount; r++) {
+            for (let c = 0; c < colCount; c++) {
+                if (visited[idx(r, c)]) {
+                    continue;
+                }
+                const value = getValue(cells[r]?.[c] ?? {});
+                const { maxRow, maxCol } = expandRange(r, c, value, horizontalFirst, visited);
+                markVisitedAndPushRange(r, c, maxRow, maxCol, value, visited, ranges);
+            }
+        }
+        return ranges;
+    }
+}
+function calculateMaxRowsPerOperation(columnCount, overwriteMaxCellsPerOperation) {
+    const maxCellsPerOperation = overwriteMaxCellsPerOperation ?? maxCellsPerRequest;
+    const maxRowsPerOperation = Math.floor(maxCellsPerOperation / columnCount);
+    if (maxRowsPerOperation < 1) {
+        throw new InvalidArgumentError("maxCellsPerOperation must be greater than or equal to the number of columns in the range."); // Excel supports up to 16k columns, which exceeds the assumed 10k cell limit per write. This might not be a problem, but not worth spending time checking this currently either.
+    }
+    return maxRowsPerOperation;
+}

package/dist/esm/tasks/writeWorkbookRows.js

@@ -23,7 +23,7 @@ import { createWorkbookRangeRef } from "../services/workbookRange.js";
  * ]);
  */
 export default async function writeWorkbookRows(originRef, rows, overwriteMaxRowsPerChunk = null) {
-    let maxRowsPerUnderlyingRead = overwriteMaxRowsPerChunk;
+    let maxRowsPerOperation = overwriteMaxRowsPerChunk;
     let cellsPerRow = null;
     let rowsCompleted = 0;
     const batch = [];
@@ -34,10 +34,10 @@ export default async function writeWorkbookRows(originRef, rows, overwriteMaxRow
         else if (cellsPerRow !== row.length) {
             throw new InvalidArgumentError("Not all rows have the same number of cells. Ensure all rows are consistent in length.");
         }
-        if (maxRowsPerUnderlyingRead === null) {
-            maxRowsPerUnderlyingRead = Math.max(1, Math.floor(maxCellsPerRequest / cellsPerRow)); // Excel supports up to 16k columns, which exceeds the assumed 10k cell limit per write. This might not be a problem, but not worth spending time checking this currently either.
+        if (maxRowsPerOperation === null) {
+            maxRowsPerOperation = Math.max(1, Math.floor(maxCellsPerRequest / cellsPerRow)); // Excel supports up to 16k columns, which exceeds the assumed 10k cell limit per write. This might not be a problem, but not worth spending time checking this currently either.
         }
-        if (batch.push(row) >= maxRowsPerUnderlyingRead) {
+        if (batch.push(row) >= maxRowsPerOperation) {
             rowsCompleted += await flushBatch(batch, originRef, rowsCompleted);
         }
     }

package/docs/api/Cell.md

@@ -22,8 +22,32 @@ Contrary to common expectation, while a cell does contain a single value, it als
 
 | Property | Type | Description | Defined in |
 | ------ | ------ | ------ | ------ |
+| <a id="alignment"></a> `alignment` | `object` | **`Experimental`** Alignment of cell contents. | [src/models/Cell.ts:46](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L46) |
+| `alignment.horizontal?` | [`CellHorizontalAlignment`](#cellhorizontalalignment) | - | [src/models/Cell.ts:47](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L47) |
+| `alignment.vertical?` | [`CellVerticalAlignment`](#cellverticalalignment) | - | [src/models/Cell.ts:48](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L48) |
+| `alignment.wrapText?` | `boolean` | - | [src/models/Cell.ts:49](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L49) |
+| <a id="borders"></a> `borders` | `object` | **`Experimental`** Borders around the cell. | [src/models/Cell.ts:56](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L56) |
+| `borders.diagonalDown?` | [`Border`](Border.md#border) | - | [src/models/Cell.ts:63](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L63) |
+| `borders.diagonalUp?` | [`Border`](Border.md#border) | - | [src/models/Cell.ts:64](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L64) |
+| `borders.edgeBottom?` | [`Border`](Border.md#border) | - | [src/models/Cell.ts:58](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L58) |
+| `borders.edgeLeft?` | [`Border`](Border.md#border) | - | [src/models/Cell.ts:59](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L59) |
+| `borders.edgeRight?` | [`Border`](Border.md#border) | - | [src/models/Cell.ts:60](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L60) |
+| `borders.edgeTop?` | [`Border`](Border.md#border) | - | [src/models/Cell.ts:57](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L57) |
+| `borders.insideHorizontal?` | [`Border`](Border.md#border) | - | [src/models/Cell.ts:62](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L62) |
+| `borders.insideVertical?` | [`Border`](Border.md#border) | - | [src/models/Cell.ts:61](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L61) |
+| <a id="fill"></a> `fill` | `object` | **`Experimental`** Fill color of the cell. | [src/models/Cell.ts:71](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L71) |
+| `fill.color?` | [`Color`](Color.md#color) | - | [src/models/Cell.ts:72](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L72) |
+| <a id="font"></a> `font` | `object` | **`Experimental`** Font settings for the cell. | [src/models/Cell.ts:78](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L78) |
+| `font.bold?` | `boolean` | - | [src/models/Cell.ts:82](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L82) |
+| `font.color?` | [`Color`](Color.md#color) | - | [src/models/Cell.ts:81](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L81) |
+| `font.italic?` | `boolean` | - | [src/models/Cell.ts:83](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L83) |
+| `font.name?` | [`FontName`](FontName.md#fontname) | - | [src/models/Cell.ts:79](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L79) |
+| `font.size?` | `number` | - | [src/models/Cell.ts:80](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L80) |
+| `font.underline?` | [`CellUnderline`](#cellunderline) | - | [src/models/Cell.ts:84](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L84) |
 | <a id="format"></a> `format` | [`CellFormat`](#cellformat-1) | Formatting that is applied to the value to derive the text representation. | [src/models/Cell.ts:30](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L30) |
-| <a id="style"></a> `style` | [`CellStyle`](#cellstyle-1) | Style applied to the cell to affect its appearance, like color, borders, alignment, etc. | [src/models/Cell.ts:35](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L35) |
+| <a id="merge"></a> `merge` | `object` | **`Experimental`** Number of cell merges (WRITE ONLY). **Remarks** Due to API limitations, this value is never populated when reading a cell, but it can be set when writing a cell. | [src/models/Cell.ts:37](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L37) |
+| `merge.down?` | `number` | - | [src/models/Cell.ts:39](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L39) |
+| `merge.right?` | `number` | - | [src/models/Cell.ts:38](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L38) |
 | <a id="text"></a> `text` | [`CellText`](#celltext-1) | The text representation of the cell's value. **Remarks** This is often the same as the value, but can differ in cases where the value is a number and the text representation is formatted (e.g., "1,000" vs. 1000), or in the case of the value being a formula. | [src/models/Cell.ts:20](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L20) |
 | <a id="value"></a> `value` | [`CellValue`](#cellvalue-1) | The actual value of the cell. | [src/models/Cell.ts:25](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L25) |
 
@@ -33,7 +57,7 @@ Contrary to common expectation, while a cell does contain a single value, it als
 
 > **CellFormat** = `string` & `object`
 
-Defined in: [src/models/Cell.ts:54](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L54)
+Defined in: [src/models/Cell.ts:104](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L104)
 
 Format to be applied to a cell value to convert it to text to display to the user.
 
@@ -53,7 +77,7 @@ Format to be applied to a cell value to convert it to text to display to the use
 
 > **CellHorizontalAlignment** = `"General"` \| `"Left"` \| `"Center"` \| `"Right"` \| `"Fill"` \| `"Justify"` \| `"CenterAcrossSelection"` \| `"Distributed"`
 
-Defined in: [src/models/Cell.ts:150](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L150)
+Defined in: [src/models/Cell.ts:134](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L134)
 
 ***
 
@@ -61,7 +85,7 @@ Defined in: [src/models/Cell.ts:150](https://github.com/Future-Secure-AI/microso
 
 > **CellScope** = `object`
 
-Defined in: [src/models/Cell.ts:127](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L127)
+Defined in: [src/models/Cell.ts:111](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L111)
 
 The amount of detail that we're reading from a cell.
 
@@ -69,53 +93,13 @@ The amount of detail that we're reading from a cell.
 
 | Property | Type | Description | Defined in |
 | ------ | ------ | ------ | ------ |
-| <a id="alignment"></a> `alignment` | `boolean` | Content position with the cell. VERY EXPENSIVE (+1 op per cell) | [src/models/Cell.ts:138](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L138) |
-| <a id="borders"></a> `borders` | `boolean` | Cell borders. VERY EXPENSIVE (+1 op per cell) | [src/models/Cell.ts:141](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L141) |
-| <a id="fill"></a> `fill` | `boolean` | Background fill style. VERY EXPENSIVE (+1 op per cell) | [src/models/Cell.ts:144](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L144) |
-| <a id="font"></a> `font` | `boolean` | Text style. VERY EXPENSIVE (+1 op per cell) | [src/models/Cell.ts:147](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L147) |
-| <a id="format-1"></a> `format` | `boolean` | Logic used to format values to text. CHEAP (~1 op per 10K cells, no additional call op `values` or `text`) | [src/models/Cell.ts:135](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L135) |
-| <a id="text-1"></a> `text` | `boolean` | Formatted value, as presented to the user. CHEAP (~1 op per 10K cells, no additional call op `values` or `format`) | [src/models/Cell.ts:132](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L132) |
-| <a id="values"></a> `values` | `boolean` | Raw cell value. CHEAP (~1 op per 10K cells, no additional op with `text` or `format`) | [src/models/Cell.ts:129](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L129) |
-
-***
-
-### CellStyle
-
-> **CellStyle** = `object`
-
-Defined in: [src/models/Cell.ts:61](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L61)
-
-Style applied to the cell to affect its appearance, like color, borders, alignment, etc.
-
-#### Properties
-
-| Property | Type | Description | Defined in |
-| ------ | ------ | ------ | ------ |
-| <a id="alignment-1"></a> `alignment` | `object` | **`Experimental`** Alignment of cell contents. | [src/models/Cell.ts:75](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L75) |
-| `alignment.horizontal?` | [`CellHorizontalAlignment`](#cellhorizontalalignment) | - | [src/models/Cell.ts:76](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L76) |
-| `alignment.vertical?` | [`CellVerticalAlignment`](#cellverticalalignment) | - | [src/models/Cell.ts:77](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L77) |
-| `alignment.wrapText?` | `boolean` | - | [src/models/Cell.ts:78](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L78) |
-| <a id="borders-1"></a> `borders` | `object` | **`Experimental`** Borders around the cell. | [src/models/Cell.ts:84](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L84) |
-| `borders.bottom?` | [`Border`](Border.md#border) | - | [src/models/Cell.ts:86](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L86) |
-| `borders.diagonalDown?` | [`Border`](Border.md#border) | - | [src/models/Cell.ts:91](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L91) |
-| `borders.diagonalUp?` | [`Border`](Border.md#border) | - | [src/models/Cell.ts:92](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L92) |
-| `borders.insideHorizontal?` | [`Border`](Border.md#border) | - | [src/models/Cell.ts:90](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L90) |
-| `borders.insideVertical?` | [`Border`](Border.md#border) | - | [src/models/Cell.ts:89](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L89) |
-| `borders.left?` | [`Border`](Border.md#border) | - | [src/models/Cell.ts:87](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L87) |
-| `borders.right?` | [`Border`](Border.md#border) | - | [src/models/Cell.ts:88](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L88) |
-| `borders.top?` | [`Border`](Border.md#border) | - | [src/models/Cell.ts:85](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L85) |
-| <a id="fill-1"></a> `fill` | `object` | **`Experimental`** Fill color of the cell. | [src/models/Cell.ts:107](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L107) |
-| `fill.color?` | [`Color`](Color.md#color) | - | [src/models/Cell.ts:108](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L108) |
-| <a id="font-1"></a> `font` | `object` | **`Experimental`** Font settings for the cell. | [src/models/Cell.ts:114](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L114) |
-| `font.bold?` | `boolean` | - | [src/models/Cell.ts:118](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L118) |
-| `font.color?` | [`Color`](Color.md#color) | - | [src/models/Cell.ts:117](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L117) |
-| `font.italic?` | `boolean` | - | [src/models/Cell.ts:119](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L119) |
-| `font.name?` | [`FontName`](FontName.md#fontname) | - | [src/models/Cell.ts:115](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L115) |
-| `font.size?` | `number` | - | [src/models/Cell.ts:116](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L116) |
-| `font.underline?` | [`CellUnderline`](#cellunderline) | - | [src/models/Cell.ts:120](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L120) |
-| <a id="merge"></a> `merge` | `object` | **`Experimental`** Number of cell merges (WRITE ONLY). **Remarks** Due to API limitations, this value is never populated when reading a cell, but it can be set when writing a cell. | [src/models/Cell.ts:67](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L67) |
-| `merge.down?` | `number` | - | [src/models/Cell.ts:69](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L69) |
-| `merge.right?` | `number` | - | [src/models/Cell.ts:68](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L68) |
+| <a id="alignment-1"></a> `alignment` | `boolean` | Content position with the cell. VERY EXPENSIVE (+1 op per cell) | [src/models/Cell.ts:122](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L122) |
+| <a id="borders-1"></a> `borders` | `boolean` | Cell borders. VERY EXPENSIVE (+1 op per cell) | [src/models/Cell.ts:125](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L125) |
+| <a id="fill-1"></a> `fill` | `boolean` | Background fill style. VERY EXPENSIVE (+1 op per cell) | [src/models/Cell.ts:128](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L128) |
+| <a id="font-1"></a> `font` | `boolean` | Text style. VERY EXPENSIVE (+1 op per cell) | [src/models/Cell.ts:131](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L131) |
+| <a id="format-1"></a> `format` | `boolean` | Logic used to format values to text. CHEAP (+1 op per 10K cells, no additional call op `values` or `text`) | [src/models/Cell.ts:119](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L119) |
+| <a id="text-1"></a> `text` | `boolean` | Formatted value, as presented to the user. CHEAP (+1 op per 10K cells, no additional call op `values` or `format`) | [src/models/Cell.ts:116](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L116) |
+| <a id="values"></a> `values` | `boolean` | Raw cell value. CHEAP (+1 op per 10K cells, no additional op with `text` or `format`) | [src/models/Cell.ts:113](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L113) |
 
 ***
 
@@ -123,7 +107,7 @@ Style applied to the cell to affect its appearance, like color, borders, alignme
 
 > **CellText** = `string`
 
-Defined in: [src/models/Cell.ts:48](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L48)
+Defined in: [src/models/Cell.ts:98](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L98)
 
 Text content of a cell in a worksheet.
 
@@ -137,7 +121,7 @@ This is a string that represents the text displayed in the cell, which may diffe
 
 > **CellUnderline** = `"None"` \| `"Single"` \| `"Double"` \| `"SingleAccountant"` \| `"DoubleAccountant"`
 
-Defined in: [src/models/Cell.ts:154](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L154)
+Defined in: [src/models/Cell.ts:138](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L138)
 
 ***
 
@@ -145,7 +129,7 @@ Defined in: [src/models/Cell.ts:154](https://github.com/Future-Secure-AI/microso
 
 > **CellValue** = `string` \| `number` \| `boolean`
 
-Defined in: [src/models/Cell.ts:42](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L42)
+Defined in: [src/models/Cell.ts:92](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L92)
 
 CellValue represents the value of a cell in a spreadsheet.
 
@@ -159,4 +143,4 @@ CellValue represents the value of a cell in a spreadsheet.
 
 > **CellVerticalAlignment** = `"Top"` \| `"Center"` \| `"Bottom"` \| `"Justify"` \| `"Distributed"`
 
-Defined in: [src/models/Cell.ts:152](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L152)
+Defined in: [src/models/Cell.ts:136](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/models/Cell.ts#L136)

package/docs/api/CellFormat.md

@@ -10,7 +10,7 @@ Cell utilities.
 
 > `const` **accountingCellFormat**: [`CellFormat`](Cell.md#cellformat-1)
 
-Defined in: src/services/cell.ts:12
+Defined in: [src/services/cell.ts:12](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/services/cell.ts#L12)
 
 ***
 
@@ -18,7 +18,7 @@ Defined in: src/services/cell.ts:12
 
 > `const` **defaultCellScope**: [`CellScope`](Cell.md#cellscope)
 
-Defined in: src/services/cell.ts:18
+Defined in: [src/services/cell.ts:18](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/services/cell.ts#L18)
 
 ***
 
@@ -26,7 +26,7 @@ Defined in: src/services/cell.ts:18
 
 > `const` **generalCellFormat**: [`CellFormat`](Cell.md#cellformat-1)
 
-Defined in: src/services/cell.ts:9
+Defined in: [src/services/cell.ts:9](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/services/cell.ts#L9)
 
 ***
 
@@ -34,7 +34,7 @@ Defined in: src/services/cell.ts:9
 
 > `const` **numberCellFormat**: [`CellFormat`](Cell.md#cellformat-1)
 
-Defined in: src/services/cell.ts:11
+Defined in: [src/services/cell.ts:11](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/services/cell.ts#L11)
 
 ***
 
@@ -42,4 +42,4 @@ Defined in: src/services/cell.ts:11
 
 > `const` **textCellFormat**: [`CellFormat`](Cell.md#cellformat-1)
 
-Defined in: src/services/cell.ts:10
+Defined in: [src/services/cell.ts:10](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/services/cell.ts#L10)

package/docs/api/README.md

@@ -156,6 +156,8 @@
 | [createWorkbookAndStartSession](createWorkbookAndStartSession.md) | Create a new workbook and open a session for that workbook. |
 | [downloadDriveItemContent](downloadDriveItemContent.md) | Download a drive item and save it to the local disk. |
 | [getWorkbookWorksheetByName](getWorkbookWorksheetByName-1.md) | Get a worksheet by its name. |
+| [insertRow](insertRow.md) | Inserts a single row into a workbook range. |
+| [insertRows](insertRows.md) | Inserts rows into a workbook range. |
 | [iterateRows](iterateRows.md) | Iterate over the rows in a given worksheet range. |
 | [listDriveItems](listDriveItems.md) | List drive items in a drive or a drive item. |
 | [readFirstRow](readFirstRow.md) | Read the first row from a given workbook range. |
@@ -167,4 +169,6 @@
 | [setWorkbookTableBodyVisibleRows](setWorkbookTableBodyVisibleRows.md) | Set visible rows of a workbook table with the provided 2D array of values, ignoring hidden rows and inserting new rows at the end if needed. |
 | [tryCloseWorkbookSession](tryCloseWorkbookSession.md) | Try and close a workbook session. |
 | [tryDeleteDriveItem](tryDeleteDriveItem.md) | Attempts to delete a drive item, returning success status. |
+| [updateFirstRow](updateFirstRow.md) | Update first row in a given workbook range. |
+| [updateRows](updateRows.md) | Update rows in a given workbook range. |
 | [writeWorkbookRows](writeWorkbookRows.md) | Write rows to a workbook range. |

package/docs/api/getWorkbookRangeFormat.md

@@ -10,7 +10,7 @@ Retrieve the format of a workbook range.
 
 > **getWorkbookRangeFormat**(`rangeRef`): [`GraphOperation`](GraphOperation.md#graphoperation)\<`WorkbookRangeFormat` & [`SiteRef`](Site-1.md#siteref) & `object` & `object` & `object` & `object` & `object`\>
 
-Defined in: [src/operations/workbookRange/getWorkbookRangeFormat.ts:20](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/operations/workbookRange/getWorkbookRangeFormat.ts#L20)
+Defined in: [src/operations/workbookRange/getWorkbookRangeFormat.ts:21](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/operations/workbookRange/getWorkbookRangeFormat.ts#L21)
 
 Retrieve the format of a workbook range.
 

package/docs/api/getWorkbookWorksheetRange.md

@@ -10,7 +10,7 @@ Fetch a range.
 
 > **getWorkbookWorksheetRange**(`rangeRef`, `select?`): [`GraphOperation`](GraphOperation.md#graphoperation)\<`WorkbookRange` & [`SiteRef`](Site-1.md#siteref) & `object` & `object` & `object` & `object` & `object`\>
 
-Defined in: [src/operations/workbookRange/getWorkbookWorksheetRange.ts:21](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/operations/workbookRange/getWorkbookWorksheetRange.ts#L21)
+Defined in: [src/operations/workbookRange/getWorkbookWorksheetRange.ts:23](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/operations/workbookRange/getWorkbookWorksheetRange.ts#L23)
 
 Fetch a range.
 

package/docs/api/insertRow.md

@@ -0,0 +1,34 @@
+[Microsoft Graph SDK](README.md) / insertRow
+
+# insertRow
+
+**`Experimental`**
+
+Inserts a single row into a workbook range.
+
+## Functions
+
+### insertWorkbookRangeRow()
+
+> **insertWorkbookRangeRow**(`originRef`, `row`): [`Promise`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)\<`void`\>
+
+Defined in: [src/tasks/insertWorkbookRangeRow.ts:20](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/tasks/insertWorkbookRangeRow.ts#L20)
+
+**`Experimental`**
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `originRef` | [`WorkbookRangeRef`](WorkbookRange-1.md#workbookrangeref) | Reference to the workbook range to update. Only the upper-left cell is used as an origin point. |
+| `row` | [`Partial`](https://www.typescriptlang.org/docs/handbook/utility-types.html#partialtype)\<[`Cell`](Cell.md#cell)\>[] | Array of cells to insert as a single row. |
+
+#### Returns
+
+[`Promise`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)\<`void`\>
+
+#### Example
+
+```ts
+await insertRow(originRef, [{ value: "A1" }, { value: "B1" }, { value: "C1" }]);
+```

package/docs/api/insertRows.md

@@ -0,0 +1,47 @@
+[Microsoft Graph SDK](README.md) / insertRows
+
+# insertRows
+
+**`Experimental`**
+
+Inserts rows into a workbook range.
+
+## Functions
+
+### insertWorkbookRangeRows()
+
+> **insertWorkbookRangeRows**(`originRef`, `cells`, `maxCellsPerOperation`): [`Promise`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)\<`void`\>
+
+Defined in: [src/tasks/insertWorkbookRangeRows.ts:38](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/tasks/insertWorkbookRangeRows.ts#L38)
+
+**`Experimental`**
+
+#### Parameters
+
+| Parameter | Type | Default value | Description |
+| ------ | ------ | ------ | ------ |
+| `originRef` | [`WorkbookRangeRef`](WorkbookRange-1.md#workbookrangeref) | `undefined` | Reference to the workbook range to update. Only the upper-left cell is used as an origin point. |
+| `cells` | [`Iterable`](https://www.typescriptlang.org/docs/handbook/iterators-and-generators.html#iterable-interface)\<[`Partial`](https://www.typescriptlang.org/docs/handbook/utility-types.html#partialtype)\<[`Cell`](Cell.md#cell)\>[], `any`, `any`\> \| `AsyncIterable`\<[`Partial`](https://www.typescriptlang.org/docs/handbook/utility-types.html#partialtype)\<[`Cell`](Cell.md#cell)\>[], `any`, `any`\> | `undefined` | Array of arrays of cells to update in the specified range. |
+| `maxCellsPerOperation` | `null` \| `number` | `null` | Prescribe max cells to retrieve per operation. `null` automatically determines value. DO NOT SET EXCEPT FOR ADVANCED TUNING. |
+
+#### Returns
+
+[`Promise`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)\<`void`\>
+
+#### Example
+
+```ts
+// Basic example:
+await insertRows(originRef, [
+  [{ value: "A1" }, { value: "B1" }, { value: "C1" }],
+  [{ value: "A2" }, { value: "B2" }, { value: "C2" }],
+ [{ value: "A3" }, { value: "B3" }, { value: "C3" }],
+])
+
+// Advanced example with cell formatting:
+await insertRows(originRef, [
+  [{ value: "A1", format: { fontColor: "red" } }, { value: "B1" }, { value: "C1" }],
+  [{ value: "A2" }, { value: "B2", format: { fontColor: "blue" } }, { value: "C2" }],
+  [{ value: "A3" }, { value: "B3" }, { value: "C3", format: { fontColor: "green" } }],
+]);
+```