microsoft-graph 2.31.1 → 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/cell.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Cell utilities.
+ * @module CellFormat
+ * @category Services
+ */
+import type { CellFormat, CellScope } from "../models/Cell.ts";
+export declare const generalCellFormat: CellFormat;
+export declare const textCellFormat: CellFormat;
+export declare const numberCellFormat: CellFormat;
+export declare const accountingCellFormat: CellFormat;
+export declare const defaultCellScope: CellScope;
+//# sourceMappingURL=cell.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cell.d.ts","sourceRoot":"","sources":["../../../src/services/cell.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE/D,eAAO,MAAM,iBAAiB,EAAgB,UAAU,CAAC;AACzD,eAAO,MAAM,cAAc,EAAU,UAAU,CAAC;AAChD,eAAO,MAAM,gBAAgB,EAAiB,UAAU,CAAC;AACzD,eAAO,MAAM,oBAAoB,EAA2D,UAAU,CAAC;AAMvG,eAAO,MAAM,gBAAgB,EAAE,SAQ9B,CAAC"}

package/dist/cjs/services/cell.js

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * Cell utilities.
+ * @module CellFormat
+ * @category Services
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultCellScope = exports.accountingCellFormat = exports.numberCellFormat = exports.textCellFormat = exports.generalCellFormat = void 0;
+exports.generalCellFormat = "General";
+exports.textCellFormat = "@";
+exports.numberCellFormat = "#,##0.00";
+exports.accountingCellFormat = '_($* #,##0.00_);_($* (#,##0.00);_($* "-"??_);_(@_)';
+// export const currencyCellFormat = "$#,##0.00" as CellFormat;
+// export const percentageCellFormat = "0.00%" as CellFormat;
+// export const dateShortCellFormat = "dd/mm/yyyy" as CellFormat;
+// export const timeCellFormat = "h:mm:ss AM/PM" as CellFormat;
+exports.defaultCellScope = {
+    values: true,
+    text: true,
+    format: true,
+    alignment: false,
+    borders: false,
+    fill: false,
+    font: false,
+};

package/dist/cjs/services/dataSource.js

@@ -25,7 +25,7 @@ const getWorkbookWorksheetUsedRangeRef_ts_1 = __importDefault(require("../operat
 const readWorkbookRows_ts_1 = __importDefault(require("../tasks/readWorkbookRows.js"));
 const addressManipulation_ts_1 = require("./addressManipulation.js");
 const cartesianAddress_ts_1 = require("./cartesianAddress.js");
-const cellFormat_ts_1 = require("./cellFormat.js");
+const cell_ts_1 = require("./cell.js");
 /**
  * Define a datasource from an entire worksheet.
  * @template T Type of the record, extending RecordBase.
@@ -173,14 +173,12 @@ function recordToRow(record, source) {
         return {
             value: cell.value ?? "",
             text: cell.text ?? (cell.value ?? "").toString(),
-            format: cell.format ?? cellFormat_ts_1.generalCellFormat,
-            style: {
-                merge: {},
-                alignment: {},
-                borders: {},
-                fill: {},
-                font: {},
-            },
+            format: cell.format ?? cell_ts_1.generalCellFormat,
+            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;AAWnE;;;;;;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,CAAgB,EAAE,oBAAoB,GAAE,MAAM,GAAG,IAAW,GAAG,aAAa,CAAC,WAAW,CAAC,CAwC/K"}
+{"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

@@ -18,20 +18,19 @@ const getWorkbookWorksheetRange_ts_1 = __importDefault(require("../operations/wo
 const listWorkbookRangeBorders_ts_1 = __importDefault(require("../operations/workbookRange/listWorkbookRangeBorders.js"));
 const addressManipulation_ts_1 = require("../services/addressManipulation.js");
 const batch_ts_1 = require("../services/batch.js");
-const defaultScope = { values: true, text: true, format: true };
+const cell_ts_1 = require("../services/cell.js");
 /**
  * Iterate over the rows in a given worksheet range.
  * @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)) {
  *   console.log(row);
  * }
  */
-async function* iterateRows(rangeRef, scope = defaultScope, maxCellsPerOperation = null) {
+async function* iterateRows(rangeRef, scope = cell_ts_1.defaultCellScope, maxCellsPerOperation = null) {
     const totalColumnCount = (0, addressManipulation_ts_1.countAddressColumns)(rangeRef.address);
     const totalRowCount = (0, addressManipulation_ts_1.countAddressRows)(rangeRef.address);
     const maxRowsPerOperation = calculateMaxRowsPerOperation(totalColumnCount, maxCellsPerOperation);
@@ -46,12 +45,20 @@ async function* iterateRows(rangeRef, scope = defaultScope, maxCellsPerOperation
                 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 = defaultScope, maxCellsPerOperation
         }
     }
 }
-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/readFirstRow.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Read the first row from a given workbook range.
+ * @module readFirstRow
+ * @category Tasks
+ * @experimental
+ */
+import type { Cell } from "../models/Cell.ts";
+import type { WorkbookRangeRef } from "../models/WorkbookRange.ts";
+/** * Read the first row from a given workbook range.
+ * @param rangeRef Reference to the workbook range to read.
+ * @param scope Amount of detail to include for each cell.
+ * @returns A promise that resolves to an array of cells in the first row.
+ * @remarks Particularly useful for reading header rows.
+ * @example
+ * const firstRow = await readFirstRow(rangeRef);
+ */
+export default function readFirstRow(rangeRef: WorkbookRangeRef, scope?: import("../models/Cell.ts").CellScope): Promise<Cell[]>;
+//# sourceMappingURL=readFirstRow.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"readFirstRow.d.ts","sourceRoot":"","sources":["../../../src/tasks/readFirstRow.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAKnE;;;;;;;GAOG;AACH,wBAA8B,YAAY,CAAC,QAAQ,EAAE,gBAAgB,EAAE,KAAK,wCAAmB,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAQhH"}

package/dist/cjs/tasks/readFirstRow.js

@@ -0,0 +1,31 @@
+"use strict";
+/**
+ * Read the first row from a given workbook range.
+ * @module readFirstRow
+ * @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 = readFirstRow;
+const InvalidArgumentError_ts_1 = __importDefault(require("../errors/InvalidArgumentError.js"));
+const addressManipulation_ts_1 = require("../services/addressManipulation.js");
+const cell_ts_1 = require("../services/cell.js");
+const iterateRows_ts_1 = require("./iterateRows.js");
+/** * Read the first row from a given workbook range.
+ * @param rangeRef Reference to the workbook range to read.
+ * @param scope Amount of detail to include for each cell.
+ * @returns A promise that resolves to an array of cells in the first row.
+ * @remarks Particularly useful for reading header rows.
+ * @example
+ * const firstRow = await readFirstRow(rangeRef);
+ */
+async function readFirstRow(rangeRef, scope = cell_ts_1.defaultCellScope) {
+    const firstRowRef = (0, addressManipulation_ts_1.subRange)(rangeRef, 0, 1);
+    for await (const { cells } of (0, iterateRows_ts_1.iterateRows)(firstRowRef, scope)) {
+        return cells;
+    }
+    throw new InvalidArgumentError_ts_1.default("No rows in the specified range.");
+}

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

@@ -0,0 +1,20 @@
+/**
+ * Read all rows from a given workbook range.
+ * @module readRows
+ * @category Tasks
+ * @experimental
+ */
+import type { Cell } from "../models/Cell.ts";
+import type { WorkbookRangeRef } from "../models/WorkbookRange.ts";
+/**
+ * Read all rows from a given workbook range.
+ * @param rangeRef Reference to the workbook range to read.
+ * @param scope Amount of detail to include for each cell.
+ * @returns A promise that resolves to an array of rows, each containing an array of cells.
+ * @remarks Where practical, prefer using {@link iterateRows} for more efficient memory usage.
+ * @experimental
+ * @example
+ * const rows = await readRows(rangeRef);
+ */
+export default function readRows(rangeRef: WorkbookRangeRef, scope?: import("../models/Cell.ts").CellScope): Promise<Cell[][]>;
+//# sourceMappingURL=readRows.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"readRows.d.ts","sourceRoot":"","sources":["../../../src/tasks/readRows.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAInE;;;;;;;;;GASG;AACH,wBAA8B,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,EAAE,KAAK,wCAAmB,GAAG,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAO9G"}

package/dist/cjs/tasks/readRows.js

@@ -0,0 +1,28 @@
+"use strict";
+/**
+ * Read all rows from a given workbook range.
+ * @module readRows
+ * @category Tasks
+ * @experimental
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = readRows;
+const cell_ts_1 = require("../services/cell.js");
+const iterateRows_ts_1 = require("./iterateRows.js");
+/**
+ * Read all rows from a given workbook range.
+ * @param rangeRef Reference to the workbook range to read.
+ * @param scope Amount of detail to include for each cell.
+ * @returns A promise that resolves to an array of rows, each containing an array of cells.
+ * @remarks Where practical, prefer using {@link iterateRows} for more efficient memory usage.
+ * @experimental
+ * @example
+ * const rows = await readRows(rangeRef);
+ */
+async function readRows(rangeRef, scope = cell_ts_1.defaultCellScope) {
+    const rows = [];
+    for await (const { cells } of (0, iterateRows_ts_1.iterateRows)(rangeRef, scope)) {
+        rows.push(cells);
+    }
+    return rows;
+}

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);
+}