microsoft-graph 2.26.0 → 2.28.0

package/dist/cjs/services/dataSource.js

@@ -0,0 +1,195 @@
+"use strict";
+/**
+ * Tooling for easily creating, updating, and deleting items in a worksheet or range.
+ * @module dataSource
+ * @category Services
+ * @experimental
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dataSourceFromWorksheet = dataSourceFromWorksheet;
+exports.dataSourceFromRange = dataSourceFromRange;
+exports.listItems = listItems;
+exports.createItem = createItem;
+exports.updateItem = updateItem;
+exports.deleteItem = deleteItem;
+const InvalidOperationError_ts_1 = __importDefault(require("../errors/InvalidOperationError.js"));
+const ProtocolError_ts_1 = __importDefault(require("../errors/ProtocolError.js"));
+const deleteWorkbookRange_ts_1 = __importDefault(require("../operations/workbookRange/deleteWorkbookRange.js"));
+const getWorkbookWorksheetRange_ts_1 = __importDefault(require("../operations/workbookRange/getWorkbookWorksheetRange.js"));
+const insertWorkbookCells_ts_1 = __importDefault(require("../operations/workbookRange/insertWorkbookCells.js"));
+const updateWorkbookRange_ts_1 = __importDefault(require("../operations/workbookRange/updateWorkbookRange.js"));
+const getWorkbookWorksheetUsedRangeRef_ts_1 = __importDefault(require("../operations/workbookWorksheet/getWorkbookWorksheetUsedRangeRef.js"));
+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");
+/**
+ * Define a datasource from an entire worksheet.
+ * @template T Type of the record, extending RecordBase.
+ * @param worksheetRef Workbook range reference to define the data source on.
+ * @param decode Function to decode a row into a record.
+ * @param encode Function to encode a record into a row. Optional.
+ * @returns The initialized data source.
+ * @experimental
+ */
+async function dataSourceFromWorksheet(worksheetRef, decode, encode = null) {
+    const rangeRef = await (0, getWorkbookWorksheetUsedRangeRef_ts_1.default)(worksheetRef);
+    return dataSourceFromRange(rangeRef, decode, encode);
+}
+/**
+ * Defines a data source from a given range.
+ * @template T Type of the record, extending RecordBase.
+ * @param rangeRef Workbook range reference to define the data source on.
+ * @param decode Function to decode a row into a record.
+ * @param encode Function to encode a record into a row. Optional.
+ * @returns The initialized data source.
+ * @experimental
+ */
+async function dataSourceFromRange(rangeRef, decode, encode = null) {
+    if ((0, addressManipulation_ts_1.countAddressRows)(rangeRef.address) < 1) {
+        throw new InvalidOperationError_ts_1.default("Cannot create a data source from an empty range. It must at least contain a header row.");
+    }
+    const headRef = (0, addressManipulation_ts_1.subRange)(rangeRef, 0, 1);
+    const bodyRef = (0, addressManipulation_ts_1.subRange)(rangeRef, 1);
+    const head = await getHead(headRef);
+    const { ay: bodyOffset } = (0, cartesianAddress_ts_1.addressToCartesian)(bodyRef.address);
+    const source = {
+        bodyRef,
+        bodyOffset,
+        coding: {
+            decode,
+            encode,
+        },
+        head,
+        async *[Symbol.asyncIterator]() {
+            let index = 0;
+            for await (const row of (0, readWorkbookRows_ts_1.default)(source.bodyRef)) {
+                const record = rowToRecord(row, source);
+                const rowNumber = indexToRowNumber(source.bodyOffset, index);
+                yield {
+                    index,
+                    rowNumber,
+                    record,
+                };
+                index++;
+            }
+        },
+    };
+    return source;
+}
+/**
+ * Reads all items from the data source.
+ * @template T Type of the record, extending RecordBase.
+ * @param source Data source to read from.
+ * @returns Array of all items in the data source.
+ * @deprecated Iterate on the source directly using `for await (const item of source)`.
+ */
+async function* listItems(source) {
+    for await (const item of source) {
+        yield item;
+    }
+}
+/**
+ * Creates a new item in the data source.
+ * @template T Type of the record, extending RecordBase.
+ * @param source Data source to insert into. Must be initialized.
+ * @param record Record to insert.
+ * @param after Index after which to insert the new item. If null, inserts at the end. If -1 inserts at top.
+ * @returns Newly created item, including its index, row number, and record.
+ * @throws {InvalidOperationError} If the data source is not initialized.
+ * @throws {InvalidArgumentError} If the 'after' index is out of range.
+ * @experimental
+ */
+async function createItem(source, record, after = null) {
+    const count = (0, addressManipulation_ts_1.countAddressRows)(source.bodyRef.address);
+    const index = (after === null ? count : after + 1);
+    const rowNumber = indexToRowNumber(source.bodyOffset, index);
+    await (0, insertWorkbookCells_ts_1.default)((0, addressManipulation_ts_1.superRange)(source.bodyRef, index, 1), "Down");
+    source.bodyRef = (0, addressManipulation_ts_1.superRange)(source.bodyRef, 0, count + 1);
+    await updateItem(source, index, record);
+    return {
+        index,
+        rowNumber,
+        record,
+    };
+}
+/**
+ * Updates an item in the data source at the specified index.
+ * @template T Type of the record, extending RecordBase.
+ * @param source Data source to update. Must be initialized.
+ * @param index Index of the item to update.
+ * @param record New record to write at the specified index.
+ * @throws {InvalidOperationError} If the data source is not initialized.
+ * @throws {InvalidArgumentError} If the index is out of range.
+ * @experimental
+ */
+async function updateItem(source, index, record) {
+    const row = recordToRow(record, source);
+    const rowRef = (0, addressManipulation_ts_1.subRange)(source.bodyRef, index, 1);
+    await (0, updateWorkbookRange_ts_1.default)(rowRef, {
+        values: [row.map((x) => x.value)],
+        text: [row.map((x) => x.text)],
+        numberFormat: [row.map((x) => x.format)],
+    });
+}
+/**
+ * Deletes an item from the data source at the specified index.
+ * @template T Type of the record, extending RecordBase.
+ * @param source Data source to delete from. Must be initialized.
+ * @param index Index of the item to delete.
+ * @throws {InvalidOperationError} If the data source is not initialized.
+ * @experimental
+ */
+async function deleteItem(source, index) {
+    const rowRef = (0, addressManipulation_ts_1.subRange)(source.bodyRef, index, 1);
+    await (0, deleteWorkbookRange_ts_1.default)(rowRef, "Up");
+    source.bodyRef = (0, addressManipulation_ts_1.subRange)(source.bodyRef, 0, -1);
+}
+function rowToRecord(row, source) {
+    const sourceRow = source.head.reduce((acc, heading, columnIndex) => {
+        const cell = row[columnIndex];
+        if (!cell) {
+            throw new ProtocolError_ts_1.default(`Cell for '${heading}' is undefined`);
+        }
+        acc[heading] = cell;
+        return acc;
+    }, {});
+    const record = source.coding.decode(sourceRow);
+    return record;
+}
+function recordToRow(record, source) {
+    if (!source.coding.encode) {
+        throw new InvalidOperationError_ts_1.default("Data source does not have an encoder defined. Add an encoder for reading.");
+    }
+    const sourceRow = source.coding.encode(record);
+    const row = source.head.map((heading) => {
+        const cell = sourceRow[heading];
+        if (cell === undefined) {
+            throw new Error(`Encoder produced undefined value for '${heading}'.`); // TODO: Make more specific error
+        }
+        return {
+            value: cell.value ?? "",
+            text: cell.text ?? (cell.value ?? "").toString(),
+            format: cell.format ?? cellFormat_ts_1.generalCellFormat,
+            style: {
+                merge: {},
+                alignment: {},
+                borders: {},
+                fill: {},
+                font: {},
+            },
+        };
+    });
+    return row;
+}
+function indexToRowNumber(bodyOffset, index) {
+    return (bodyOffset + index + 1); // +1 to convert to 1-based index
+}
+async function getHead(headRef) {
+    const headRange = await (0, getWorkbookWorksheetRange_ts_1.default)(headRef);
+    const head = headRange.text[0].map((x) => x);
+    return head;
+}

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

@@ -1,4 +1,5 @@
 /**
+ * Utilities for iterating over AsyncIterables.
  * @module Iteration
  * @category Services
  */

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

@@ -1 +1 @@
-{"version":3,"file":"iteration.d.ts","sourceRoot":"","sources":["../../../src/services/iteration.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,CAAC,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAMhF"}
+{"version":3,"file":"iteration.d.ts","sourceRoot":"","sources":["../../../src/services/iteration.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,CAAC,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAMhF"}

package/dist/cjs/services/iteration.js

@@ -1,5 +1,6 @@
 "use strict";
 /**
+ * Utilities for iterating over AsyncIterables.
  * @module Iteration
  * @category Services
  */

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

@@ -2,6 +2,7 @@
  * Delete a drive item, avoiding locking issues through automatic retries.
  * @module deleteDriveItemWithRetry
  * @category Tasks
+ * @hidden
  */
 import type { DriveItemRef } from "../models/DriveItem.ts";
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"deleteDriveItemWithRetry.d.ts","sourceRoot":"","sources":["../../../src/tasks/deleteDriveItemWithRetry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAI3D;;;;;;GAMG;AACH,wBAA8B,wBAAwB,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAahG"}
+{"version":3,"file":"deleteDriveItemWithRetry.d.ts","sourceRoot":"","sources":["../../../src/tasks/deleteDriveItemWithRetry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAI3D;;;;;;GAMG;AACH,wBAA8B,wBAAwB,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAahG"}

package/dist/cjs/tasks/deleteDriveItemWithRetry.js

@@ -3,6 +3,7 @@
  * Delete a drive item, avoiding locking issues through automatic retries.
  * @module deleteDriveItemWithRetry
  * @category Tasks
+ * @hidden
  */
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };

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

@@ -0,0 +1,24 @@
+/**
+ * Iterate over the rows in a given worksheet range.
+ * @module iterateRows
+ * @category Tasks
+ * @experimental
+ */
+import type { CellScope } from "../models/Cell.ts";
+import type { Row } from "../models/Row.ts";
+import type { WorkbookRangeRef } from "../models/WorkbookRange.ts";
+/**
+ * Iterate over the rows in a given worksheet range.
+ * @param rangeRef Reference to the workbook range to iterate over.
+ * @param skip Number of rows to skip before starting to yield rows. Can be negative to get last rows (e.g., -1 for the last row).
+ * @param take Max number of rows to yield. `POSITIVE_INFINITY` returns all rows.
+ * @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!
+ * @example
+ * for await (const row of iterateRows(rangeRef)) {
+ *   console.log(row);
+ * }
+ */
+export declare function iterateRows(rangeRef: WorkbookRangeRef, skip?: number, take?: number, scope?: Partial<CellScope>, maxCellsPerOperation?: number | null): AsyncIterable<Row>;
+//# sourceMappingURL=iterateRows.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"iterateRows.d.ts","sourceRoot":"","sources":["../../../src/tasks/iterateRows.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAA6C,SAAS,EAAwE,MAAM,mBAAmB,CAAC;AAGpK,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAWnE;;;;;;;;;;;;GAYG;AACH,wBAAuB,WAAW,CAAC,QAAQ,EAAE,gBAAgB,EAAE,IAAI,SAAI,EAAE,IAAI,GAAE,MAAiC,EAAE,KAAK,GAAE,OAAO,CAAC,SAAS,CAAgB,EAAE,oBAAoB,GAAE,MAAM,GAAG,IAAW,GAAG,aAAa,CAAC,GAAG,CAAC,CAiC1N"}

package/dist/cjs/tasks/iterateRows.js

@@ -0,0 +1,127 @@
+"use strict";
+/**
+ * Iterate over the rows in a given worksheet range.
+ * @module iterateRows
+ * @category Tasks
+ * @experimental
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.iterateRows = iterateRows;
+const InvalidArgumentError_ts_1 = __importDefault(require("../errors/InvalidArgumentError.js"));
+const getWorkbookRangeFill_ts_1 = __importDefault(require("../operations/workbookRange/getWorkbookRangeFill.js"));
+const getWorkbookRangeFont_ts_1 = __importDefault(require("../operations/workbookRange/getWorkbookRangeFont.js"));
+const getWorkbookRangeFormat_ts_1 = __importDefault(require("../operations/workbookRange/getWorkbookRangeFormat.js"));
+const getWorkbookWorksheetRange_ts_1 = __importDefault(require("../operations/workbookRange/getWorkbookWorksheetRange.js"));
+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 };
+/**
+ * Iterate over the rows in a given worksheet range.
+ * @param rangeRef Reference to the workbook range to iterate over.
+ * @param skip Number of rows to skip before starting to yield rows. Can be negative to get last rows (e.g., -1 for the last row).
+ * @param take Max number of rows to yield. `POSITIVE_INFINITY` returns all rows.
+ * @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!
+ * @example
+ * for await (const row of iterateRows(rangeRef)) {
+ *   console.log(row);
+ * }
+ */
+async function* iterateRows(rangeRef, skip = 0, take = Number.POSITIVE_INFINITY, scope = defaultScope, maxCellsPerOperation = null) {
+    const totalRangeRef = (0, addressManipulation_ts_1.subRange)(rangeRef, skip, take);
+    const totalColumnCount = (0, addressManipulation_ts_1.countAddressColumns)(totalRangeRef.address);
+    const totalRowCount = (0, addressManipulation_ts_1.countAddressRows)(totalRangeRef.address);
+    const maxRowsPerOperation = calculateMaxRowsPerOperation(totalColumnCount, maxCellsPerOperation);
+    const rangeSelect = scopeToRangeSelect(scope);
+    for (let operationRowStart = 0; operationRowStart < totalRowCount; operationRowStart += maxRowsPerOperation) {
+        const operationRowCount = Math.min(maxRowsPerOperation, totalRowCount - operationRowStart);
+        const operationRangeRef = (0, addressManipulation_ts_1.subRange)(totalRangeRef, operationRowStart, operationRowCount);
+        const range = rangeSelect ? await (0, getWorkbookWorksheetRange_ts_1.default)(operationRangeRef, rangeSelect) : null;
+        for (let rowIndex = 0; rowIndex < operationRowCount; rowIndex++) {
+            const row = [];
+            for (let columnIndex = 0; columnIndex < totalColumnCount; columnIndex++) {
+                const value = (range?.values?.[rowIndex]?.[columnIndex] ?? ""); // The root of these is undefined if that detail isn't in scope
+                const text = (range?.text?.[rowIndex]?.[columnIndex] ?? "");
+                const format = (range?.numberFormat?.[rowIndex]?.[columnIndex] ?? "");
+                const style = await getStyle((0, addressManipulation_ts_1.subRange)(rangeRef, rowIndex, 1, columnIndex, 1), scope); // This line is potentially expensive
+                row.push({
+                    value,
+                    text,
+                    format,
+                    style,
+                });
+            }
+            yield row;
+        }
+    }
+}
+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;
+    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,
+        },
+    };
+    function extractBorderStyle(borders, side) {
+        if (!borders) {
+            return undefined;
+        }
+        const border = borders.find((x) => x.sideIndex === side);
+        if (!border) {
+            return undefined;
+        }
+        return {
+            color: border.color,
+            style: border.style,
+            weight: border.weight,
+        };
+    }
+}
+function calculateMaxRowsPerOperation(columnCount, overwriteMaxCellsPerOperation) {
+    const maxCellsPerOperation = overwriteMaxCellsPerOperation ?? batch_ts_1.maxCellsPerRequest;
+    const maxRowsPerOperation = Math.floor(maxCellsPerOperation / columnCount);
+    if (maxRowsPerOperation < 1) {
+        throw new InvalidArgumentError_ts_1.default("maxCellsPerOperation must be greater than or equal to the number of columns in the range.");
+    }
+    return maxRowsPerOperation;
+}
+function scopeToRangeSelect(scope) {
+    if (!(scope.values || scope.text || scope.format)) {
+        return null;
+    }
+    return { values: scope.values ?? false, text: scope.text ?? false, numberFormat: scope.format ?? false };
+}

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,CA0DhL"}
+{"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"}

package/dist/cjs/tasks/iterateWorkbookRange.js

@@ -58,6 +58,13 @@ async function* iterateWorkbookRange(rangeRef, overwriteRowsPerRequest = null) {
                 text: text[r]?.[c] ?? "",
                 value: values[r]?.[c] ?? "",
                 format: format?.[r]?.[c] ?? "",
+                style: {
+                    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;AAOnE;;;;;;;GAOG;AACH,wBAA+B,gBAAgB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,wBAAwB,GAAE,MAAM,GAAG,IAAW,GAAG,aAAa,CAAC,GAAG,CAAC,CAmD9I"}
+{"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"}

package/dist/cjs/tasks/readWorkbookRows.js

@@ -15,6 +15,13 @@ 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.
  *
@@ -56,6 +63,7 @@ async function* readWorkbookRows(rangeRef, overwriteMaxRowsPerChunk = null) {
                 text: text[r]?.[c] ?? "",
                 value: values[r]?.[c] ?? "",
                 format: numberFormat?.[r]?.[c] ?? "",
+                style: emptyStyle,
             }));
             yield row;
         }

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

@@ -1,3 +1,8 @@
+/**
+ * Set one or more columns visibility.
+ * @module setColumnHidden
+ * @category Tasks
+ */
 import type { WorkbookRangeRef } from "../models/WorkbookRange.ts";
 /**
  * Set one or more columns visibility.

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

@@ -1 +1 @@
-{"version":3,"file":"setColumnHidden.d.ts","sourceRoot":"","sources":["../../../src/tasks/setColumnHidden.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAInE;;;;GAIG;AACH,wBAA8B,eAAe,CAAC,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAQxG"}
+{"version":3,"file":"setColumnHidden.d.ts","sourceRoot":"","sources":["../../../src/tasks/setColumnHidden.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAInE;;;;GAIG;AACH,wBAA8B,eAAe,CAAC,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAQxG"}

package/dist/cjs/tasks/setColumnHidden.js

@@ -1,4 +1,9 @@
 "use strict";
+/**
+ * Set one or more columns visibility.
+ * @module setColumnHidden
+ * @category Tasks
+ */
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };

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

@@ -1,3 +1,8 @@
+/**
+ * Set one or more rows visibility.
+ * @module setRowHidden
+ * @category Tasks
+ */
 import type { WorkbookRangeRef } from "../models/WorkbookRange.ts";
 /**
  * Set one or more rows visibility.

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

@@ -1 +1 @@
-{"version":3,"file":"setRowHidden.d.ts","sourceRoot":"","sources":["../../../src/tasks/setRowHidden.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAInE;;;;;GAKG;AACH,wBAA8B,YAAY,CAAC,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAQrG"}
+{"version":3,"file":"setRowHidden.d.ts","sourceRoot":"","sources":["../../../src/tasks/setRowHidden.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAInE;;;;;GAKG;AACH,wBAA8B,YAAY,CAAC,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAQrG"}

package/dist/cjs/tasks/setRowHidden.js

@@ -1,4 +1,9 @@
 "use strict";
+/**
+ * Set one or more rows visibility.
+ * @module setRowHidden
+ * @category Tasks
+ */
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };

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

@@ -1,11 +1,16 @@
+/**
+ * Sets the values of a specified workbook range.
+ * @module setWorkbookRangeValues
+ * @category Tasks
+ * @hidden
+ */
 import type { CellValue } from "../models/Cell.ts";
 import type { WorkbookRangeRef } from "../models/WorkbookRange.ts";
 /**
  * Sets the values of a specified workbook range.
- *
  * @param {WorkbookRangeRef} rangeRef Reference to the workbook range to update.
  * @param {CellRangeValues} values - The values to set in the specified workbook range. Must match the range's dimensions.
- *  * @deprecated Use `writeWorkbookRows` instead.
+ * @deprecated Use `writeWorkbookRows` instead.
  * @hidden
  */
 export default function setWorkbookRangeValues(rangeRef: WorkbookRangeRef, values: CellValue[][]): Promise<void>;

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

@@ -1 +1 @@
-{"version":3,"file":"setWorkbookRangeValues.d.ts","sourceRoot":"","sources":["../../../src/tasks/setWorkbookRangeValues.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAInE;;;;;;;GAOG;AACH,wBAA8B,sBAAsB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,iBAcrG"}
+{"version":3,"file":"setWorkbookRangeValues.d.ts","sourceRoot":"","sources":["../../../src/tasks/setWorkbookRangeValues.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAInE;;;;;;GAMG;AACH,wBAA8B,sBAAsB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,iBAcrG"}

package/dist/cjs/tasks/setWorkbookRangeValues.js

@@ -1,4 +1,10 @@
 "use strict";
+/**
+ * Sets the values of a specified workbook range.
+ * @module setWorkbookRangeValues
+ * @category Tasks
+ * @hidden
+ */
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -9,10 +15,9 @@ const updateWorkbookRange_ts_1 = __importDefault(require("../operations/workbook
 const addressManipulation_ts_1 = require("../services/addressManipulation.js");
 /**
  * Sets the values of a specified workbook range.
- *
  * @param {WorkbookRangeRef} rangeRef Reference to the workbook range to update.
  * @param {CellRangeValues} values - The values to set in the specified workbook range. Must match the range's dimensions.
- *  * @deprecated Use `writeWorkbookRows` instead.
+ * @deprecated Use `writeWorkbookRows` instead.
  * @hidden
  */
 async function setWorkbookRangeValues(rangeRef, values) {

package/dist/esm/models/Border.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Defining a border that could be on a cell.
+ * @experimental
+ * @module Border
+ * @category Models
+ */
+import type { Color } from "./Color.ts";
+export type Border = {
+    color: Color;
+    style: BorderType;
+    weight: BorderWeight;
+};
+export type BorderSide = "EdgeTop" | "EdgeBottom" | "EdgeLeft" | "EdgeRight" | "InsideVertical" | "InsideHorizontal" | "DiagonalDown" | "DiagonalUp";
+export type BorderType = "None" | "Continuous" | "Dash" | "DashDot" | "DashDotDot" | "Dot" | "Double" | "SlantDashDot";
+export type BorderWeight = "Hairline" | "Thin" | "Medium" | "Thick";
+//# sourceMappingURL=Border.d.ts.map

package/dist/esm/models/Border.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Border.d.ts","sourceRoot":"","sources":["../../../src/models/Border.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,MAAM,MAAM,MAAM,GAAG;IACpB,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,UAAU,CAAC;IAClB,MAAM,EAAE,YAAY,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,YAAY,GAAG,UAAU,GAAG,WAAW,GAAG,gBAAgB,GAAG,kBAAkB,GAAG,cAAc,GAAG,YAAY,CAAC;AAErJ,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,YAAY,GAAG,KAAK,GAAG,QAAQ,GAAG,cAAc,CAAC;AAEvH,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC"}

package/dist/esm/models/Border.js

@@ -0,0 +1 @@
+export {};