microsoft-graph 2.32.0 → 2.33.0

package/dist/cjs/models/Cell.d.ts

@@ -24,32 +24,6 @@ export type Cell = {
      * Formatting that is applied to the value to derive the text representation.
      */
     format: CellFormat;
-    /**
-     * Style applied to the cell to affect its appearance, like color, borders, alignment, etc.
-     */
-    style: CellStyle;
-};
-/**
- * CellValue represents the value of a cell in a spreadsheet.
- * @see {@link Cell} for a more comprehensive representation of a cell, which includes text and formatting.
- */
-export type CellValue = string | number | boolean;
-/**
- * Text content of a cell in a worksheet.
- * @remarks This is a string that represents the text displayed in the cell, which may differ from the actual value of the cell (e.g., due to formatting).
- */
-export type CellText = string;
-/**
- * Format to be applied to a cell value to convert it to text to display to the user.
- * @see {@link Cell} for a more comprehensive representation of a cell, which includes text and formatting.
- */
-export type CellFormat = string & {
-    __brand: "CellFormat";
-};
-/**
- * Style applied to the cell to affect its appearance, like color, borders, alignment, etc.
- */
-export type CellStyle = {
     /**
      * 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.
@@ -73,10 +47,10 @@ export type CellStyle = {
      * @experimental
      */
     borders: {
-        top?: Border | undefined;
-        bottom?: Border | undefined;
-        left?: Border | undefined;
-        right?: Border | undefined;
+        edgeTop?: Border | undefined;
+        edgeBottom?: Border | undefined;
+        edgeLeft?: Border | undefined;
+        edgeRight?: Border | undefined;
         insideVertical?: Border | undefined;
         insideHorizontal?: Border | undefined;
         diagonalDown?: Border | undefined;
@@ -102,15 +76,32 @@ export type CellStyle = {
         underline?: CellUnderline;
     };
 };
+/**
+ * CellValue represents the value of a cell in a spreadsheet.
+ * @see {@link Cell} for a more comprehensive representation of a cell, which includes text and formatting.
+ */
+export type CellValue = string | number | boolean;
+/**
+ * Text content of a cell in a worksheet.
+ * @remarks This is a string that represents the text displayed in the cell, which may differ from the actual value of the cell (e.g., due to formatting).
+ */
+export type CellText = string;
+/**
+ * Format to be applied to a cell value to convert it to text to display to the user.
+ * @see {@link Cell} for a more comprehensive representation of a cell, which includes text and formatting.
+ */
+export type CellFormat = string & {
+    __brand: "CellFormat";
+};
 /**
  * The amount of detail that we're reading from a cell.
  */
 export type CellScope = {
-    /** Raw cell value. CHEAP (~1 op per 10K cells, no additional op with `text` or `format`) */
+    /** Raw cell value. CHEAP (+1 op per 10K cells, no additional op with `text` or `format`) */
     values: boolean;
-    /** Formatted value, as presented to the user. CHEAP (~1 op per 10K cells, no additional call op `values` or `format`) */
+    /** Formatted value, as presented to the user. CHEAP (+1 op per 10K cells, no additional call op `values` or `format`) */
     text: boolean;
-    /** Logic used to format values to text. CHEAP (~1 op per 10K cells, no additional call op `values` or `text`) */
+    /** Logic used to format values to text. CHEAP (+1 op per 10K cells, no additional call op `values` or `text`) */
     format: boolean;
     /** Content position with the cell. VERY EXPENSIVE (+1 op per cell) */
     alignment: boolean;

package/dist/cjs/models/Cell.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Cell.d.ts","sourceRoot":"","sources":["../../../src/models/Cell.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Cell.d.ts","sourceRoot":"","sources":["../../../src/models/Cell.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C;;;GAGG;AACH,MAAM,MAAM,IAAI,GAAG;IAClB;;;OAGG;IACH,IAAI,EAAE,QAAQ,CAAC;IAEf;;OAEG;IACH,KAAK,EAAE,SAAS,CAAC;IAEjB;;OAEG;IACH,MAAM,EAAE,UAAU,CAAC;IAEnB;;;;OAIG;IACH,KAAK,EAAE;QACN,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;KACd,CAAC;IAEF;;;OAGG;IACH,SAAS,EAAE;QACV,UAAU,CAAC,EAAE,uBAAuB,CAAC;QACrC,QAAQ,CAAC,EAAE,qBAAqB,CAAC;QACjC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;KAC/B,CAAC;IAEF;;;OAGG;IACH,OAAO,EAAE;QACR,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC7B,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAChC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC9B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC/B,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QACpC,gBAAgB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QACtC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAClC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAChC,CAAC;IAEF;;;OAGG;IACH,IAAI,EAAE;QACL,KAAK,CAAC,EAAE,KAAK,CAAC;KACd,CAAC;IACF;;;OAGG;IACH,IAAI,EAAE;QACL,IAAI,CAAC,EAAE,QAAQ,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,KAAK,CAAC;QACd,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,SAAS,CAAC,EAAE,aAAa,CAAC;KAC1B,CAAC;CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAElD;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC;AAE9B;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG;IACjC,OAAO,EAAE,YAAY,CAAC;CACtB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG;IACvB,4FAA4F;IAC5F,MAAM,EAAE,OAAO,CAAC;IAEhB,yHAAyH;IACzH,IAAI,EAAE,OAAO,CAAC;IAEd,iHAAiH;IACjH,MAAM,EAAE,OAAO,CAAC;IAEhB,sEAAsE;IACtE,SAAS,EAAE,OAAO,CAAC;IAEnB,qDAAqD;IACrD,OAAO,EAAE,OAAO,CAAC;IAEjB,8DAA8D;IAC9D,IAAI,EAAE,OAAO,CAAC;IAEd,kDAAkD;IAClD,IAAI,EAAE,OAAO,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,uBAAuB,GAAG,aAAa,CAAC;AAE7I,MAAM,MAAM,qBAAqB,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,aAAa,CAAC;AAE5F,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,kBAAkB,GAAG,kBAAkB,CAAC"}

package/dist/cjs/operations/workbookRange/getWorkbookRangeFormat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getWorkbookRangeFormat.d.ts","sourceRoot":"","sources":["../../../../src/operations/workbookRange/getWorkbookRangeFormat.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAKtE;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,sBAAsB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,cAAc,CAAC,mBAAmB,GAAG,gBAAgB,CAAC,CAmBjI"}
+{"version":3,"file":"getWorkbookRangeFormat.d.ts","sourceRoot":"","sources":["../../../../src/operations/workbookRange/getWorkbookRangeFormat.ts"],"names":[],"mappings":"AACA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAKtE;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,sBAAsB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,cAAc,CAAC,mBAAmB,GAAG,gBAAgB,CAAC,CAmBjI"}

package/dist/cjs/operations/workbookRange/getWorkbookRangeFormat.js

@@ -1,4 +1,5 @@
 "use strict";
+// TODO: Rename to getWorkbookRangeAlignment
 /**
  * Retrieve the format of a workbook range.
  * @module getWorkbookRangeFormat

package/dist/cjs/operations/workbookRange/getWorkbookWorksheetRange.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getWorkbookWorksheetRange.d.ts","sourceRoot":"","sources":["../../../../src/operations/workbookRange/getWorkbookWorksheetRange.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAKtE;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,yBAAyB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,YAAY,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,cAAc,CAAC,aAAa,GAAG,gBAAgB,CAAC,CA2BrM"}
+{"version":3,"file":"getWorkbookWorksheetRange.d.ts","sourceRoot":"","sources":["../../../../src/operations/workbookRange/getWorkbookWorksheetRange.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAKtE;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,yBAAyB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,YAAY,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,cAAc,CAAC,aAAa,GAAG,gBAAgB,CAAC,CA2BrM"}

package/dist/cjs/operations/workbookRange/getWorkbookWorksheetRange.js

@@ -1,9 +1,5 @@
 "use strict";
-/**
- * Fetch a range.
- * @module getWorkbookWorksheetRange
- * @category Operations
- */
+// TODO: Rename to getWorkbookRangeValueTextFormat
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.default = getWorkbookWorksheetRange;
 const addressManipulation_ts_1 = require("../../services/addressManipulation.js");

package/dist/cjs/services/dataSource.js

@@ -174,13 +174,11 @@ function recordToRow(record, source) {
             value: cell.value ?? "",
             text: cell.text ?? (cell.value ?? "").toString(),
             format: cell.format ?? cell_ts_1.generalCellFormat,
-            style: {
-                merge: {},
-                alignment: {},
-                borders: {},
-                fill: {},
-                font: {},
-            },
+            merge: {},
+            alignment: {},
+            borders: {},
+            fill: {},
+            font: {},
         };
     });
     return row;

package/dist/cjs/services/stringCaseConversion.d.ts

@@ -9,4 +9,10 @@
  * @returns The camelCase string.
  */
 export declare function kebabToCamelCase(str: string): string;
+/**
+ * Converts a camelCase string to PascalCase.
+ * @param str - The camelCase string.
+ * @returns The PascalCase string.
+ */
+export declare function camelCaseToPascalCase(str: string): string;
 //# sourceMappingURL=stringCaseConversion.d.ts.map

package/dist/cjs/services/stringCaseConversion.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stringCaseConversion.d.ts","sourceRoot":"","sources":["../../../src/services/stringCaseConversion.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAIpD"}
+{"version":3,"file":"stringCaseConversion.d.ts","sourceRoot":"","sources":["../../../src/services/stringCaseConversion.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAIpD;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAKzD"}

package/dist/cjs/services/stringCaseConversion.js

@@ -6,6 +6,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.kebabToCamelCase = kebabToCamelCase;
+exports.camelCaseToPascalCase = camelCaseToPascalCase;
 /**
  * Converts a kebab-case string to camelCase.
  * @param str - The kebab-case string.
@@ -16,3 +17,14 @@ function kebabToCamelCase(str) {
         .replace(/^-+|-+$/g, "") // Remove leading and trailing dashes
         .replace(/-([a-z])/g, (_, letter) => letter.toUpperCase());
 }
+/**
+ * Converts a camelCase string to PascalCase.
+ * @param str - The camelCase string.
+ * @returns The PascalCase string.
+ */
+function camelCaseToPascalCase(str) {
+    if (!str) {
+        return str;
+    }
+    return str.charAt(0).toUpperCase() + str.slice(1);
+}

package/dist/cjs/tasks/iterateRows.d.ts

@@ -25,7 +25,6 @@ export type IteratedRow = {
  * @param rangeRef Reference to the workbook range to iterate over.
  * @param scope Amount of detail to include for each cell.
  * @param maxCellsPerOperation Prescribe max cells to retrieve per operation. `null` automatically determines value. DO NOT SET EXCEPT FOR ADVANCED TUNING.
- * @remarks Including `style` in the scope requires over three operations for each and every cell. Use this sparingly!
  * @experimental
  * @example
  * for await (const { row } of iterateRows(rangeRef)) {

package/dist/cjs/tasks/iterateRows.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"iterateRows.d.ts","sourceRoot":"","sources":["../../../src/tasks/iterateRows.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,IAAI,EAAuC,SAAS,EAAwE,MAAM,mBAAmB,CAAC;AAIpK,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAUnE;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG;IACzB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,MAAM,EAAE,SAAS,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAuB,WAAW,CAAC,QAAQ,EAAE,gBAAgB,EAAE,KAAK,GAAE,OAAO,CAAC,SAAS,CAAoB,EAAE,oBAAoB,GAAE,MAAM,GAAG,IAAW,GAAG,aAAa,CAAC,WAAW,CAAC,CAwCnL"}
+{"version":3,"file":"iterateRows.d.ts","sourceRoot":"","sources":["../../../src/tasks/iterateRows.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,IAAI,EAAuC,SAAS,EAA6D,MAAM,mBAAmB,CAAC;AAIzJ,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAUnE;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG;IACzB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,MAAM,EAAE,SAAS,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAuB,WAAW,CAAC,QAAQ,EAAE,gBAAgB,EAAE,KAAK,GAAE,OAAO,CAAC,SAAS,CAAoB,EAAE,oBAAoB,GAAE,MAAM,GAAG,IAAW,GAAG,aAAa,CAAC,WAAW,CAAC,CAgDnL"}

package/dist/cjs/tasks/iterateRows.js

@@ -24,7 +24,6 @@ const cell_ts_1 = require("../services/cell.js");
  * @param rangeRef Reference to the workbook range to iterate over.
  * @param scope Amount of detail to include for each cell.
  * @param maxCellsPerOperation Prescribe max cells to retrieve per operation. `null` automatically determines value. DO NOT SET EXCEPT FOR ADVANCED TUNING.
- * @remarks Including `style` in the scope requires over three operations for each and every cell. Use this sparingly!
  * @experimental
  * @example
  * for await (const { row } of iterateRows(rangeRef)) {
@@ -46,12 +45,20 @@ async function* iterateRows(rangeRef, scope = cell_ts_1.defaultCellScope, maxCel
                 const value = (range?.values?.[operationRowOffset]?.[columnOffset] ?? ""); // The root of these is undefined if that detail isn't in scope
                 const text = (range?.text?.[operationRowOffset]?.[columnOffset] ?? "");
                 const format = (range?.numberFormat?.[operationRowOffset]?.[columnOffset] ?? "");
-                const style = await getStyle((0, addressManipulation_ts_1.subRange)(rangeRef, operationRowOffset, 1, columnOffset, 1), scope); // This line is potentially expensive
+                const merge = {}; // No API available to retrieve merge information
+                const alignment = await getAlignment(rangeRef, scope);
+                const borders = await getBorders(rangeRef, scope);
+                const fill = await getFill(rangeRef, scope);
+                const font = await getFont(rangeRef, scope);
                 cells.push({
                     value,
                     text,
                     format,
-                    style,
+                    merge,
+                    alignment,
+                    borders,
+                    fill,
+                    font,
                 });
             }
             const offset = (operationRowStart + operationRowOffset);
@@ -66,41 +73,43 @@ async function* iterateRows(rangeRef, scope = cell_ts_1.defaultCellScope, maxCel
         }
     }
 }
-async function getStyle(rangeRef, scope) {
-    const alignment = scope.alignment ? await (0, getWorkbookRangeFormat_ts_1.default)(rangeRef) : null;
-    const borders = scope.borders ? await (0, listWorkbookRangeBorders_ts_1.default)(rangeRef) : null;
-    const fill = scope.fill ? await (0, getWorkbookRangeFill_ts_1.default)(rangeRef) : null;
-    const font = scope.font ? await (0, getWorkbookRangeFont_ts_1.default)(rangeRef) : null;
+async function getFont(rangeRef, scope) {
+    if (!scope.font) {
+        return {};
+    }
+    const response = await (0, getWorkbookRangeFont_ts_1.default)(rangeRef);
     return {
-        merge: {
-        /* Not provided by API */
-        },
-        alignment: {
-            vertical: alignment?.verticalAlignment,
-            horizontal: alignment?.horizontalAlignment,
-            wrapText: alignment?.wrapText ?? undefined,
-        },
-        borders: {
-            top: extractBorderStyle(borders, "EdgeTop"),
-            bottom: extractBorderStyle(borders, "EdgeBottom"),
-            left: extractBorderStyle(borders, "EdgeLeft"),
-            right: extractBorderStyle(borders, "EdgeRight"),
-            insideVertical: extractBorderStyle(borders, "InsideVertical"),
-            insideHorizontal: extractBorderStyle(borders, "InsideHorizontal"),
-            diagonalDown: extractBorderStyle(borders, "DiagonalDown"),
-            diagonalUp: extractBorderStyle(borders, "DiagonalUp"),
-        },
-        fill: {
-            color: fill?.color,
-        },
-        font: {
-            name: font?.name,
-            size: font?.size,
-            color: font?.color,
-            bold: font?.bold,
-            italic: font?.italic,
-            underline: font?.underline,
-        },
+        name: response?.name,
+        size: response?.size,
+        color: response?.color,
+        bold: response?.bold,
+        italic: response?.italic,
+        underline: response?.underline,
+    };
+}
+async function getFill(rangeRef, scope) {
+    if (!scope.fill) {
+        return {};
+    }
+    const response = await (0, getWorkbookRangeFill_ts_1.default)(rangeRef);
+    return {
+        color: response?.color,
+    };
+}
+async function getBorders(rangeRef, scope) {
+    if (!scope.borders) {
+        return {};
+    }
+    const response = await (0, listWorkbookRangeBorders_ts_1.default)(rangeRef);
+    return {
+        edgeTop: extractBorderStyle(response, "EdgeTop"),
+        edgeBottom: extractBorderStyle(response, "EdgeBottom"),
+        edgeLeft: extractBorderStyle(response, "EdgeLeft"),
+        edgeRight: extractBorderStyle(response, "EdgeRight"),
+        insideVertical: extractBorderStyle(response, "InsideVertical"),
+        insideHorizontal: extractBorderStyle(response, "InsideHorizontal"),
+        diagonalDown: extractBorderStyle(response, "DiagonalDown"),
+        diagonalUp: extractBorderStyle(response, "DiagonalUp"),
     };
     function extractBorderStyle(borders, side) {
         if (!borders) {
@@ -117,6 +126,17 @@ async function getStyle(rangeRef, scope) {
         };
     }
 }
+async function getAlignment(rangeRef, scope) {
+    if (!scope.alignment) {
+        return {};
+    }
+    const response = await (0, getWorkbookRangeFormat_ts_1.default)(rangeRef);
+    return {
+        vertical: response?.verticalAlignment,
+        horizontal: response?.horizontalAlignment,
+        wrapText: response?.wrapText ?? undefined,
+    };
+}
 function calculateMaxRowsPerOperation(columnCount, overwriteMaxCellsPerOperation) {
     const maxCellsPerOperation = overwriteMaxCellsPerOperation ?? batch_ts_1.maxCellsPerRequest;
     const maxRowsPerOperation = Math.floor(maxCellsPerOperation / columnCount);

package/dist/cjs/tasks/iterateWorkbookRange.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"iterateWorkbookRange.d.ts","sourceRoot":"","sources":["../../../src/tasks/iterateWorkbookRange.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAOnE;;;;;;;;GAQG;AACH,wBAA+B,oBAAoB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,uBAAuB,GAAE,MAAM,GAAG,IAAW,GAAG,aAAa,CAAC;IAAE,SAAS,EAAE,SAAS,CAAC;IAAC,GAAG,EAAE,GAAG,CAAA;CAAE,CAAC,CAiEhL"}
+{"version":3,"file":"iterateWorkbookRange.d.ts","sourceRoot":"","sources":["../../../src/tasks/iterateWorkbookRange.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAOnE;;;;;;;;GAQG;AACH,wBAA+B,oBAAoB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,uBAAuB,GAAE,MAAM,GAAG,IAAW,GAAG,aAAa,CAAC;IAAE,SAAS,EAAE,SAAS,CAAC;IAAC,GAAG,EAAE,GAAG,CAAA;CAAE,CAAC,CA+DhL"}

package/dist/cjs/tasks/iterateWorkbookRange.js

@@ -58,13 +58,11 @@ async function* iterateWorkbookRange(rangeRef, overwriteRowsPerRequest = null) {
                 text: text[r]?.[c] ?? "",
                 value: values[r]?.[c] ?? "",
                 format: format?.[r]?.[c] ?? "",
-                style: {
-                    merge: {},
-                    alignment: {},
-                    borders: {},
-                    fill: {},
-                    font: {},
-                },
+                merge: {},
+                alignment: {},
+                borders: {},
+                fill: {},
+                font: {},
             }));
             yield {
                 rowOffset: offset,

package/dist/cjs/tasks/readWorkbookRows.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"readWorkbookRows.d.ts","sourceRoot":"","sources":["../../../src/tasks/readWorkbookRows.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,GAAG,EAAa,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAenE;;;;;;;GAOG;AACH,wBAA+B,gBAAgB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,wBAAwB,GAAE,MAAM,GAAG,IAAW,GAAG,aAAa,CAAC,GAAG,CAAC,CAoD9I"}
+{"version":3,"file":"readWorkbookRows.d.ts","sourceRoot":"","sources":["../../../src/tasks/readWorkbookRows.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,GAAG,EAAa,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAOnE;;;;;;;GAOG;AACH,wBAA+B,gBAAgB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,wBAAwB,GAAE,MAAM,GAAG,IAAW,GAAG,aAAa,CAAC,GAAG,CAAC,CAwD9I"}

package/dist/cjs/tasks/readWorkbookRows.js

@@ -15,13 +15,6 @@ const addressManipulation_ts_1 = require("../services/addressManipulation.js");
 const addressOffset_ts_1 = require("../services/addressOffset.js");
 const batch_ts_1 = require("../services/batch.js");
 const workbookRange_ts_1 = require("../services/workbookRange.js");
-const emptyStyle = {
-    merge: {},
-    alignment: {},
-    borders: {},
-    fill: {},
-    font: {},
-};
 /**
  * Iterates over the rows in a given worksheet range.
  *
@@ -63,7 +56,11 @@ async function* readWorkbookRows(rangeRef, overwriteMaxRowsPerChunk = null) {
                 text: text[r]?.[c] ?? "",
                 value: values[r]?.[c] ?? "",
                 format: numberFormat?.[r]?.[c] ?? "",
-                style: emptyStyle,
+                merge: {},
+                alignment: {},
+                borders: {},
+                fill: {},
+                font: {},
             }));
             yield row;
         }

package/dist/cjs/tasks/updateFirstRow.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Update first row in a given workbook range.
+ * @module updateFirstRow
+ * @category Tasks
+ * @experimental
+ */
+import type { Cell } from "../models/Cell.ts";
+import type { WorkbookRangeRef } from "../models/WorkbookRange.ts";
+/**
+ * Update first row 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.
+ * @remarks `undefined` values are left unchanged. Applying styling to cells is slow, use sparingly.
+ * @experimental
+ * @example
+ * // Basic example:
+ * await updateFirstRow(rangeRef, [{ value: 1 }, { value: 2 }]);
+ *
+ * // 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 } } }
+ * ]);
+ */
+export default function updateFirstRow(originRef: WorkbookRangeRef, cells: Partial<Cell>[]): Promise<void>;
+//# sourceMappingURL=updateFirstRow.d.ts.map

package/dist/cjs/tasks/updateFirstRow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"updateFirstRow.d.ts","sourceRoot":"","sources":["../../../src/tasks/updateFirstRow.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAGnE;;;;;;;;;;;;;;;GAeG;AACH,wBAA8B,cAAc,CAAC,SAAS,EAAE,gBAAgB,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAG/G"}

package/dist/cjs/tasks/updateFirstRow.js

@@ -0,0 +1,33 @@
+"use strict";
+/**
+ * Update first row in a given workbook range.
+ * @module updateFirstRow
+ * @category Tasks
+ * @experimental
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = updateFirstRow;
+const updateRows_ts_1 = __importDefault(require("./updateRows.js"));
+/**
+ * Update first row 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.
+ * @remarks `undefined` values are left unchanged. Applying styling to cells is slow, use sparingly.
+ * @experimental
+ * @example
+ * // Basic example:
+ * await updateFirstRow(rangeRef, [{ value: 1 }, { value: 2 }]);
+ *
+ * // 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 } } }
+ * ]);
+ */
+async function updateFirstRow(originRef, cells) {
+    const rows = [cells];
+    await (0, updateRows_ts_1.default)(originRef, rows);
+}

package/dist/cjs/tasks/updateRows.d.ts

@@ -0,0 +1,26 @@
+import type { Cell } from "../models/Cell.ts";
+import type { WorkbookRangeRef } from "../models/WorkbookRange.ts";
+/**
+ * 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 function updateRows(originRef: WorkbookRangeRef, cells: Iterable<Partial<Cell>[]> | AsyncIterable<Partial<Cell>[]>, maxCellsPerOperation?: number | null): Promise<void>;
+//# sourceMappingURL=updateRows.d.ts.map

package/dist/cjs/tasks/updateRows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"updateRows.d.ts","sourceRoot":"","sources":["../../../src/tasks/updateRows.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAWnE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAA8B,UAAU,CAAC,SAAS,EAAE,gBAAgB,EAAE,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,oBAAoB,GAAE,MAAM,GAAG,IAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAwBlM"}