microsoft-graph 2.21.0 → 2.22.1

package/.vscode/settings.json

@@ -12,6 +12,7 @@
     "Entra",
     "FSAI",
     "msgraph",
-    "sourcedoc"
+    "sourcedoc",
+    "subaddress"
   ],
 }

package/dist/cjs/models/{Source.d.ts → DataSource.d.ts}

@@ -1,15 +1,15 @@
 import type { ColumnName } from "./ColumnName.ts";
+import type { DataSourceDecoder } from "./DataSourceDecoder.ts";
+import type { DataSourceEncoder } from "./DataSourceEncoder.ts";
 import type { Item } from "./Item.ts";
 import type { RecordBase } from "./RecordBase.ts";
-import type { SourceDecoder } from "./SourceDecoder.ts";
-import type { SourceEncoder } from "./SourceEncoder.ts";
 import type { WorkbookRangeRef } from "./WorkbookRangeRef.ts";
-export type Source<T extends RecordBase> = {
+export type DataSource<T extends RecordBase> = {
     rangeRef: WorkbookRangeRef;
     head: ColumnName[];
     coding: {
-        decode: SourceDecoder<T>;
-        encode: SourceEncoder<T>;
+        decode: DataSourceDecoder<T>;
+        encode: DataSourceEncoder<T> | null;
     };
 } & AsyncIterable<Item<T>>;
-//# sourceMappingURL=Source.d.ts.map
+//# sourceMappingURL=DataSource.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DataSource.d.ts","sourceRoot":"","sources":["../../../src/models/DataSource.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,UAAU,IAAI;IAC9C,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,IAAI,EAAE,UAAU,EAAE,CAAC;IACnB,MAAM,EAAE;QACP,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC;QAC7B,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;KACpC,CAAC;CACF,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,4 @@
+import type { DataSourceRow } from "./DataSourceRow.ts";
+import type { RecordBase } from "./RecordBase.ts";
+export type DataSourceDecoder<T extends RecordBase> = (row: DataSourceRow) => T;
+//# sourceMappingURL=DataSourceDecoder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DataSourceDecoder.d.ts","sourceRoot":"","sources":["../../../src/models/DataSourceDecoder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,UAAU,IAAI,CAAC,GAAG,EAAE,aAAa,KAAK,CAAC,CAAC"}

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

@@ -0,0 +1,4 @@
+import type { DataSourceRow } from "./DataSourceRow.ts";
+import type { RecordBase } from "./RecordBase.ts";
+export type DataSourceEncoder<T extends RecordBase> = (record: T) => DataSourceRow;
+//# sourceMappingURL=DataSourceEncoder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DataSourceEncoder.d.ts","sourceRoot":"","sources":["../../../src/models/DataSourceEncoder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,UAAU,IAAI,CAAC,MAAM,EAAE,CAAC,KAAK,aAAa,CAAC"}

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

@@ -0,0 +1,4 @@
+export type DataSourceIndex = number & {
+    __brand: "Index";
+};
+//# sourceMappingURL=DataSourceIndex.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DataSourceIndex.d.ts","sourceRoot":"","sources":["../../../src/models/DataSourceIndex.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG;IACtC,OAAO,EAAE,OAAO,CAAC;CACjB,CAAC"}

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

@@ -0,0 +1,4 @@
+import type { Cell } from "./Cell.ts";
+import type { ColumnName } from "./ColumnName.ts";
+export type DataSourceRow = Record<ColumnName, Cell>;
+//# sourceMappingURL=DataSourceRow.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DataSourceRow.d.ts","sourceRoot":"","sources":["../../../src/models/DataSourceRow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC"}

package/dist/cjs/models/DataSourceRow.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -1,8 +1,8 @@
-import type { RowOffset } from "../models/RowOffset.ts";
+import type { DataSourceIndex } from "./DataSourceIndex.ts";
 import type { RecordBase } from "./RecordBase.ts";
 import type { RowNumber } from "./RowNumber.ts";
 export type Item<T extends RecordBase> = {
-    rowOffset: RowOffset;
+    index: DataSourceIndex;
     rowNumber: RowNumber;
     record: T;
 };

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

@@ -1 +1 @@
-{"version":3,"file":"Item.d.ts","sourceRoot":"","sources":["../../../src/models/Item.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,MAAM,IAAI,CAAC,CAAC,SAAS,UAAU,IAAI;IACxC,SAAS,EAAE,SAAS,CAAC;IACrB,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,CAAC,CAAC;CACV,CAAC"}
+{"version":3,"file":"Item.d.ts","sourceRoot":"","sources":["../../../src/models/Item.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,MAAM,IAAI,CAAC,CAAC,SAAS,UAAU,IAAI;IACxC,KAAK,EAAE,eAAe,CAAC;IACvB,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,CAAC,CAAC;CACV,CAAC"}

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

@@ -0,0 +1,3 @@
+import type { WorkbookRangeRef } from "../models/WorkbookRangeRef.ts";
+export type RangeOperationCallback = (rangeRef: WorkbookRangeRef) => Promise<void>;
+//# sourceMappingURL=RangeOperationCallback.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RangeOperationCallback.d.ts","sourceRoot":"","sources":["../../../src/models/RangeOperationCallback.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAEtE,MAAM,MAAM,sBAAsB,GAAG,CAAC,QAAQ,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/dist/cjs/models/RangeOperationCallback.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -1,4 +1,5 @@
 import type { Address, CellAddress, ColumnAddress, RowAddress } from "../models/Address.ts";
+import type { WorkbookRangeRef } from "../models/WorkbookRangeRef.ts";
 export type AddressComponents = {
     startColumn: ColumnAddress;
     endColumn: ColumnAddress;
@@ -128,4 +129,36 @@ export declare function countAddressRows(address: Address): number;
  * @returns The number of columns in the address.
  */
 export declare function countAddressColumns(address: Address): number;
+/**
+ * Extracts a subrange from a spreadsheet-style A1 range (e.g., "A1:D10"),
+ * allowing skip and take semantics on both rows and columns.
+ *
+ * Supports negative values for `skipRows` and `skipCols` to count from the end.
+ * Supports negative values for `takeRows` and `takeCols` to exclude from the end after skipping.
+ *
+ * @param address - The original range in A1 notation (e.g., "A1:D10").
+ * @param skipRows - Number of rows to skip. If negative, skips that many rows from the end. Default is 0.
+ * @param takeRows - Number of rows to take after skipping. If negative, excludes that many rows from the end of the remaining rows. Default is Infinity.
+ * @param skipCols - Number of columns to skip. If negative, skips that many columns from the end. Default is 0.
+ * @param takeCols - Number of columns to take after skipping. If negative, excludes that many columns from the end of the remaining columns. Default is Infinity.
+ * @returns A new A1-style range representing the sliced subrange (e.g., "B2:C5").
+ *
+ * @example
+ * subaddress("A1:D10", -1, 1); // Last row: "A10:D10"
+ * subaddress("A1:D10", -2, 1); // Second last row: "A9:D9"
+ * subaddress("A1:D10", 0, -1); // All but last row: "A1:D9"
+ * subaddress("A1:D10", 0, Infinity, -2, 1); // Second last column: "C1:C10"
+ */
+export declare function subaddress(address: Address, skipRows?: number, takeRows?: number, skipCols?: number, takeCols?: number): Address;
+/**
+ * Extracts a subrange from a WorkbookRangeRef using skip/take semantics.
+ * @param rangeRef Range reference to extract the sub-range from.
+ * @param skipRows Number of rows to skip. If negative, skips from the end. Default 0.
+ * @param takeRows Number of rows to take after skipping. If negative, excludes from the end. Default Infinity.
+ * @param skipCols Number of columns to skip. If negative, skips from the end. Default 0.
+ * @param takeCols Number of columns to take after skipping. If negative, excludes from the end. Default Infinity.
+ * @returns Extracted sub-range reference.
+ * @throws InvalidArgumentError if the requested rows or columns exceed the available range.
+ */
+export declare function subrange(rangeRef: WorkbookRangeRef, skipRows?: number, takeRows?: number, skipCols?: number, takeCols?: number): WorkbookRangeRef;
 //# sourceMappingURL=addressManipulation.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"addressManipulation.d.ts","sourceRoot":"","sources":["../../../src/services/addressManipulation.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAoB,aAAa,EAAsB,UAAU,EAAmB,MAAM,sBAAsB,CAAC;AAmBnJ,MAAM,MAAM,iBAAiB,GAAG;IAC/B,WAAW,EAAE,aAAa,CAAC;IAC3B,SAAS,EAAE,aAAa,CAAC;IACzB,QAAQ,EAAE,UAAU,CAAC;IACrB,MAAM,EAAE,UAAU,CAAC;CACnB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,UAAQ,GAAG,OAAO,CAE9E;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,iBAAiB,CAcpE;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,iBAAiB,EAAE,UAAU,UAAQ,GAAG,OAAO,CAsBzF;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,WAAW,CAGjE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,WAAW,CAGhE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAS5D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAS3D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAS/D;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAS9D;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAqChG;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAE7D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAE7D;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAKlF;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAG5D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAG/D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAG7D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAG1D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAGzD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAG5D"}
+{"version":3,"file":"addressManipulation.d.ts","sourceRoot":"","sources":["../../../src/services/addressManipulation.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAoB,aAAa,EAAsB,UAAU,EAAmB,MAAM,sBAAsB,CAAC;AAGnJ,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAkBtE,MAAM,MAAM,iBAAiB,GAAG;IAC/B,WAAW,EAAE,aAAa,CAAC;IAC3B,SAAS,EAAE,aAAa,CAAC;IACzB,QAAQ,EAAE,UAAU,CAAC;IACrB,MAAM,EAAE,UAAU,CAAC;CACnB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,UAAQ,GAAG,OAAO,CAE9E;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,iBAAiB,CAcpE;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,iBAAiB,EAAE,UAAU,UAAQ,GAAG,OAAO,CAsBzF;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,WAAW,CAGjE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,WAAW,CAGhE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAS5D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAS3D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAS/D;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAS9D;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAqChG;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAE7D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAE7D;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAKlF;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAG5D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAG/D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAG7D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAG1D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAGzD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAG5D;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,SAAI,EAAE,QAAQ,SAA2B,EAAE,QAAQ,SAAI,EAAE,QAAQ,SAA2B,GAAG,OAAO,CAqC1J;AAED;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,EAAE,QAAQ,SAAI,EAAE,QAAQ,SAA2B,EAAE,QAAQ,SAAI,EAAE,QAAQ,SAA2B,GAAG,gBAAgB,CAM3K"}

package/dist/cjs/services/addressManipulation.js

@@ -22,9 +22,12 @@ exports.isAllColumnsAddress = isAllColumnsAddress;
 exports.isAllRowsAddress = isAllRowsAddress;
 exports.countAddressRows = countAddressRows;
 exports.countAddressColumns = countAddressColumns;
+exports.subaddress = subaddress;
+exports.subrange = subrange;
 const InvalidArgumentError_ts_1 = __importDefault(require("../errors/InvalidArgumentError.js"));
 const UnsupportedAddressTypeError_ts_1 = __importDefault(require("../errors/UnsupportedAddressTypeError.js"));
 const addressOffset_ts_1 = require("./addressOffset.js");
+const cartesianAddress_ts_1 = require("./cartesianAddress.js");
 const firstColumn = "A";
 const lastColumn = "XFD";
 const firstRow = "1";
@@ -276,6 +279,77 @@ function countAddressColumns(address) {
     const components = decomposeAddress(address);
     return (0, addressOffset_ts_1.columnAddressToOffset)(components.endColumn) - (0, addressOffset_ts_1.columnAddressToOffset)(components.startColumn) + 1;
 }
+/**
+ * Extracts a subrange from a spreadsheet-style A1 range (e.g., "A1:D10"),
+ * allowing skip and take semantics on both rows and columns.
+ *
+ * Supports negative values for `skipRows` and `skipCols` to count from the end.
+ * Supports negative values for `takeRows` and `takeCols` to exclude from the end after skipping.
+ *
+ * @param address - The original range in A1 notation (e.g., "A1:D10").
+ * @param skipRows - Number of rows to skip. If negative, skips that many rows from the end. Default is 0.
+ * @param takeRows - Number of rows to take after skipping. If negative, excludes that many rows from the end of the remaining rows. Default is Infinity.
+ * @param skipCols - Number of columns to skip. If negative, skips that many columns from the end. Default is 0.
+ * @param takeCols - Number of columns to take after skipping. If negative, excludes that many columns from the end of the remaining columns. Default is Infinity.
+ * @returns A new A1-style range representing the sliced subrange (e.g., "B2:C5").
+ *
+ * @example
+ * subaddress("A1:D10", -1, 1); // Last row: "A10:D10"
+ * subaddress("A1:D10", -2, 1); // Second last row: "A9:D9"
+ * subaddress("A1:D10", 0, -1); // All but last row: "A1:D9"
+ * subaddress("A1:D10", 0, Infinity, -2, 1); // Second last column: "C1:C10"
+ */
+function subaddress(address, skipRows = 0, takeRows = Number.POSITIVE_INFINITY, skipCols = 0, takeCols = Number.POSITIVE_INFINITY) {
+    const { ax, bx, ay, by } = (0, cartesianAddress_ts_1.addressToCartesian)(address);
+    const [startRow, endRow] = slice(ay, by, skipRows, takeRows);
+    const [startCol, endCol] = slice(ax, bx, skipCols, takeCols);
+    if (startRow < ay || endRow > by || startRow > endRow || startCol < ax || endCol > bx || startCol > endCol) {
+        throw new InvalidArgumentError_ts_1.default(`Requested subaddress is out of bounds: rows [${startRow + 1},${endRow + 1}], cols [${startCol + 1},${endCol + 1}] in range.`);
+    }
+    return (0, cartesianAddress_ts_1.cartesianToAddress)({
+        ay: startRow,
+        by: endRow,
+        ax: startCol,
+        bx: endCol,
+    });
+    function slice(start, end, skip, take) {
+        let s = start;
+        let e = end;
+        if (skip > 0) {
+            s = start + skip;
+        }
+        else if (skip < 0) {
+            s = end + skip + 1;
+        }
+        if (!Number.isFinite(take)) {
+            // do nothing
+        }
+        else if (take >= 0) {
+            e = s + take - 1;
+        }
+        else if (take < 0) {
+            e += take;
+        }
+        return [s, e];
+    }
+}
+/**
+ * Extracts a subrange from a WorkbookRangeRef using skip/take semantics.
+ * @param rangeRef Range reference to extract the sub-range from.
+ * @param skipRows Number of rows to skip. If negative, skips from the end. Default 0.
+ * @param takeRows Number of rows to take after skipping. If negative, excludes from the end. Default Infinity.
+ * @param skipCols Number of columns to skip. If negative, skips from the end. Default 0.
+ * @param takeCols Number of columns to take after skipping. If negative, excludes from the end. Default Infinity.
+ * @returns Extracted sub-range reference.
+ * @throws InvalidArgumentError if the requested rows or columns exceed the available range.
+ */
+function subrange(rangeRef, skipRows = 0, takeRows = Number.POSITIVE_INFINITY, skipCols = 0, takeCols = Number.POSITIVE_INFINITY) {
+    const address = subaddress(rangeRef.address, skipRows, takeRows, skipCols, takeCols);
+    return {
+        ...rangeRef,
+        address,
+    };
+}
 function isSingleRow(components) {
     return components.startRow === components.endRow;
 }

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

@@ -0,0 +1 @@
+//# sourceMappingURL=dataSource.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dataSource.d.ts","sourceRoot":"","sources":["../../../src/services/dataSource.ts"],"names":[],"mappings":""}

package/dist/cjs/services/dataSource.js

@@ -0,0 +1,196 @@
+"use strict";
+// import InvalidArgumentError from "../errors/InvalidArgumentError.ts";
+// import InvalidOperationError from "../errors/InvalidOperationError.ts";
+// import NeverError from "../errors/NeverError.ts";
+// import type { Cell } from "../models/Cell.ts";
+// import type { ColumnName } from "../models/ColumnName.ts";
+// import type { ColumnOffset } from "../models/ColumnOffset.ts";
+// import type { DataSource } from "../models/DataSource.ts";
+// import type { DataSourceDecoder } from "../models/DataSourceDecoder.ts";
+// import type { DataSourceEncoder } from "../models/DataSourceEncoder.ts";
+// import type { DataSourceIndex } from "../models/DataSourceIndex.ts";
+// import type { DataSourceRow } from "../models/DataSourceRow.ts";
+// import type { Item } from "../models/Item.ts";
+// import type { RangeOperationCallback } from "../models/RangeOperationCallback.ts";
+// import type { RecordBase } from "../models/RecordBase.ts";
+// import type { RowNumber } from "../models/RowNumber.ts";
+// import type { RowOffset } from "../models/RowOffset.ts";
+// import type { WorkbookRangeRef } from "../models/WorkbookRangeRef.ts";
+// import type { WorkbookWorksheetRef } from "../models/WorkbookWorksheetRef.ts";
+// import deleteWorkbookRange from "../operations/workbookRange/deleteWorkbookRange.ts";
+// import insertWorkbookCells from "../operations/workbookRange/insertWorkbookCells.ts";
+// import updateWorkbookRange from "../operations/workbookRange/updateWorkbookRange.ts";
+// import readWorkbookRows from "../tasks/readWorkbookRows.ts";
+// import { countAddressColumns, countAddressRows } from "./addressManipulation.ts";
+// import { rowOffsetToAddress } from "./addressOffset.ts";
+// import { addressToCartesian, cartesianToAddress } from "./cartesianAddress.ts";
+// import { createWorkbookRangeRef } from "./workbookRange.ts";
+// /**
+//  * Define a range and create a data source on it. From there you can read, update, create, insert and delete items with a given encoding and decoding strategy.
+//  * @param parentRef
+//  * @param decode
+//  * @param encode
+//  * @returns
+//  */
+// export async function defineDataSource<T extends RecordBase>(parentRef: WorkbookWorksheetRef | WorkbookRangeRef, decode: DataSourceDecoder<T>, encode: DataSourceEncoder<T> | null = null): Promise<DataSource<T>> {
+// 	const rangeRef = "address" in parentRef ? parentRef : createWorkbookRangeRef(parentRef, "A1");
+// 	const source: DataSource<T> = {
+// 		rangeRef,
+// 		coding: {
+// 			decode,
+// 			encode,
+// 		},
+// 		head: [],
+// 		async *[Symbol.asyncIterator](): AsyncGenerator<Item<T>> {
+// 			const { ay } = addressToCartesian(this.rangeRef.address);
+// 			let hasHead = false;
+// 			let index = 0 as DataSourceIndex;
+// 			for await (const row of readWorkbookRows(source.rangeRef)) {
+// 				if (!hasHead) {
+// 					source.head = row.map((cell) => cell.text as unknown as ColumnName);
+// 					hasHead = true;
+// 					continue;
+// 				}
+// 				const record = rowToRecord<T>(row, source);
+// 				const rowNumber = indexToRowNumber(ay, index);
+// 				yield {
+// 					index,
+// 					rowNumber,
+// 					record,
+// 				};
+// 				index++;
+// 			}
+// 		},
+// 	};
+// 	return source;
+// }
+// export async function initializeDataSource<T extends RecordBase>(source: DataSource<T>, empty: T, formatHeader: RangeOperationCallback | null = null): Promise<void> {
+// 	if (!isEmpty(source)) {
+// 		throw new InvalidOperationError("Cannot initialize source with non-empty range.");
+// 	}
+// 	const { ax, ay } = addressToCartesian(source.rangeRef.address);
+// 	const address = cartesianToAddress({
+// 		ax,
+// 		bx: (ax + source.head.length - 1) as ColumnOffset,
+// 		ay,
+// 		by: ay,
+// 	});
+// 	await insertWorkbookCells(source.rangeRef, address, "Right");
+// 	source.rangeRef = createWorkbookRangeRef(source.rangeRef, address);
+// 	source.head = Object.keys(empty) as ColumnName[];
+// 	await updateWorkbookRange(source.rangeRef, {
+// 		values: [source.head],
+// 	});
+// 	if (formatHeader) {
+// 		await formatHeader(source.rangeRef);
+// 	}
+// }
+// export async function readAllItems<T extends RecordBase>(source: DataSource<T>): Promise<Item<T>[]> {
+// 	const result: Item<T>[] = [];
+// 	for await (const item of source) {
+// 		result.push(item);
+// 	}
+// 	return result;
+// }
+// export async function createItem<T extends RecordBase>(source: DataSource<T>, record: T, after: DataSourceIndex | null = null): Promise<Item<T>> {
+// 	if (isEmpty(source)) {
+// 		throw new InvalidOperationError("Source not initialized.");
+// 	}
+// 	const { ax, bx, ay, by } = addressToCartesian(source.rangeRef.address);
+// 	const index = after ?? offsetToIndex(by);
+// 	const rowNumber = indexToRowNumber(ay, index);
+// 	const rowOffset = indexToOffset(ay, index);
+// 	if (rowOffset <= ay || rowOffset > by) {
+// 		throw new InvalidArgumentError(`'after' is out of range. Range is from ${offsetToIndex(ay)} to ${offsetToIndex(by)}, but 'after' index is ${offsetToIndex(rowOffset)}.`);
+// 	}
+// 	source.rangeRef.address = cartesianToAddress({
+// 		ax,
+// 		bx,
+// 		ay,
+// 		by: (by + 1) as RowOffset,
+// 	});
+// 	await insertWorkbookCells(source.rangeRef, rowOffsetToAddress(indexToOffset(ay, index)), "Down");
+// 	await updateItem<T>(source, index, record);
+// 	return {
+// 		index,
+// 		rowNumber,
+// 		record,
+// 	};
+// }
+// function indexToOffset(rowOffset: RowOffset, index: DataSourceIndex): RowOffset {
+// 	return (rowOffset + index + 1) as RowOffset; // +1 to account for the header row
+// }
+// function indexToRowNumber(rowOffset: RowOffset, index: DataSourceIndex): RowNumber {
+// 	return (rowOffset + index + 2) as RowNumber; // +1 to account for the header row, +1 to convert to 1-based index
+// }
+// function offsetToIndex(rowOffset: RowOffset): DataSourceIndex {
+// 	return (rowOffset - 1) as DataSourceIndex; // -1 to convert from 1-based index to 0-based index
+// }
+// export async function updateItem<T extends RecordBase>(source: DataSource<T>, index: DataSourceIndex, record: T): Promise<void> {
+// 	if (isEmpty(source)) {
+// 		throw new InvalidOperationError("Source not initialized.");
+// 	}
+// 	const row = recordToRow(record, source);
+// 	const { ax, bx, ay, by } = addressToCartesian(source.rangeRef.address);
+// 	const rowOffset = indexToOffset(ay, index);
+// 	if (rowOffset <= ay || rowOffset > by) {
+// 		throw new InvalidArgumentError(`'after' is out of range. Range is from ${offsetToIndex(ay)} to ${offsetToIndex(by)}, but 'after' index is ${offsetToIndex(rowOffset)}.`);
+// 	}
+// 	const rangeRef = createWorkbookRangeRef(
+// 		source.rangeRef,
+// 		cartesianToAddress({
+// 			ax,
+// 			bx,
+// 			ay: (ay + index) as RowOffset,
+// 			by: (ay + index) as RowOffset,
+// 		}),
+// 	);
+// 	await updateWorkbookRange(rangeRef, {
+// 		values: [row.map((x) => x.value)],
+// 		text: [row.map((x) => x.text)],
+// 		numberFormat: [row.map((x) => x.numberFormat)],
+// 	});
+// }
+// export async function deleteItem<T extends RecordBase>(source: DataSource<T>, index: DataSourceIndex): Promise<void> {
+// 	if (isEmpty(source)) {
+// 		throw new InvalidOperationError("Source not initialized.");
+// 	}
+// 	const { ax, bx, ay, by } = addressToCartesian(source.rangeRef.address);
+// 	source.rangeRef.address = cartesianToAddress({
+// 		ax,
+// 		bx,
+// 		ay,
+// 		by: (by - 1) as RowOffset,
+// 	});
+// 	const rangeRef = createWorkbookRangeRef(source.rangeRef, rowOffsetToAddress(indexToOffset(ay, index)));
+// 	await deleteWorkbookRange(rangeRef, "Up");
+// }
+// function rowToRecord<T extends RecordBase>(row: Cell[], source: DataSource<T>): T {
+// 	const sourceRow = source.head.reduce((acc, heading, columnIndex) => {
+// 		const cell = row[columnIndex];
+// 		if (!cell) {
+// 			throw new NeverError(`Cell at index ${columnIndex} is undefined`);
+// 		}
+// 		acc[heading] = cell;
+// 		return acc;
+// 	}, {} as DataSourceRow);
+// 	const record = source.coding.decode(sourceRow);
+// 	return record;
+// }
+// function recordToRow<T extends RecordBase>(record: T, source: DataSource<T>): Cell[] {
+// 	if (!source.coding.encode) {
+// 		throw new InvalidOperationError("Data source does not have an encoder defined.");
+// 	}
+// 	const sourceRow = source.coding.encode(record);
+// 	const row = source.head.map((heading) => {
+// 		const cell = sourceRow[heading];
+// 		if (cell === undefined) {
+// 			throw new NeverError(`Cell at index ${heading} is undefined`);
+// 		}
+// 		return cell;
+// 	});
+// 	return row;
+// }
+// function isEmpty<T extends RecordBase>(source: DataSource<T>) {
+// 	return countAddressRows(source.rangeRef.address) <= 1 && countAddressColumns(source.rangeRef.address) <= 1; // TODO: It is possible that a data source has a single heading with no records
+// }

package/dist/esm/models/{Source.d.ts → DataSource.d.ts}

@@ -1,15 +1,15 @@
 import type { ColumnName } from "./ColumnName.ts";
+import type { DataSourceDecoder } from "./DataSourceDecoder.ts";
+import type { DataSourceEncoder } from "./DataSourceEncoder.ts";
 import type { Item } from "./Item.ts";
 import type { RecordBase } from "./RecordBase.ts";
-import type { SourceDecoder } from "./SourceDecoder.ts";
-import type { SourceEncoder } from "./SourceEncoder.ts";
 import type { WorkbookRangeRef } from "./WorkbookRangeRef.ts";
-export type Source<T extends RecordBase> = {
+export type DataSource<T extends RecordBase> = {
     rangeRef: WorkbookRangeRef;
     head: ColumnName[];
     coding: {
-        decode: SourceDecoder<T>;
-        encode: SourceEncoder<T>;
+        decode: DataSourceDecoder<T>;
+        encode: DataSourceEncoder<T> | null;
     };
 } & AsyncIterable<Item<T>>;
-//# sourceMappingURL=Source.d.ts.map
+//# sourceMappingURL=DataSource.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DataSource.d.ts","sourceRoot":"","sources":["../../../src/models/DataSource.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,UAAU,IAAI;IAC9C,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,IAAI,EAAE,UAAU,EAAE,CAAC;IACnB,MAAM,EAAE;QACP,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC;QAC7B,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;KACpC,CAAC;CACF,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,4 @@
+import type { DataSourceRow } from "./DataSourceRow.ts";
+import type { RecordBase } from "./RecordBase.ts";
+export type DataSourceDecoder<T extends RecordBase> = (row: DataSourceRow) => T;
+//# sourceMappingURL=DataSourceDecoder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DataSourceDecoder.d.ts","sourceRoot":"","sources":["../../../src/models/DataSourceDecoder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,UAAU,IAAI,CAAC,GAAG,EAAE,aAAa,KAAK,CAAC,CAAC"}

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

@@ -0,0 +1,4 @@
+import type { DataSourceRow } from "./DataSourceRow.ts";
+import type { RecordBase } from "./RecordBase.ts";
+export type DataSourceEncoder<T extends RecordBase> = (record: T) => DataSourceRow;
+//# sourceMappingURL=DataSourceEncoder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DataSourceEncoder.d.ts","sourceRoot":"","sources":["../../../src/models/DataSourceEncoder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,UAAU,IAAI,CAAC,MAAM,EAAE,CAAC,KAAK,aAAa,CAAC"}

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

@@ -0,0 +1,4 @@
+export type DataSourceIndex = number & {
+    __brand: "Index";
+};
+//# sourceMappingURL=DataSourceIndex.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DataSourceIndex.d.ts","sourceRoot":"","sources":["../../../src/models/DataSourceIndex.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG;IACtC,OAAO,EAAE,OAAO,CAAC;CACjB,CAAC"}

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

@@ -0,0 +1,4 @@
+import type { Cell } from "./Cell.ts";
+import type { ColumnName } from "./ColumnName.ts";
+export type DataSourceRow = Record<ColumnName, Cell>;
+//# sourceMappingURL=DataSourceRow.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DataSourceRow.d.ts","sourceRoot":"","sources":["../../../src/models/DataSourceRow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC"}

package/dist/esm/models/DataSourceRow.js

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

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

@@ -1,8 +1,8 @@
-import type { RowOffset } from "../models/RowOffset.ts";
+import type { DataSourceIndex } from "./DataSourceIndex.ts";
 import type { RecordBase } from "./RecordBase.ts";
 import type { RowNumber } from "./RowNumber.ts";
 export type Item<T extends RecordBase> = {
-    rowOffset: RowOffset;
+    index: DataSourceIndex;
     rowNumber: RowNumber;
     record: T;
 };

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

@@ -1 +1 @@
-{"version":3,"file":"Item.d.ts","sourceRoot":"","sources":["../../../src/models/Item.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,MAAM,IAAI,CAAC,CAAC,SAAS,UAAU,IAAI;IACxC,SAAS,EAAE,SAAS,CAAC;IACrB,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,CAAC,CAAC;CACV,CAAC"}
+{"version":3,"file":"Item.d.ts","sourceRoot":"","sources":["../../../src/models/Item.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,MAAM,IAAI,CAAC,CAAC,SAAS,UAAU,IAAI;IACxC,KAAK,EAAE,eAAe,CAAC;IACvB,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,CAAC,CAAC;CACV,CAAC"}

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

@@ -0,0 +1,3 @@
+import type { WorkbookRangeRef } from "../models/WorkbookRangeRef.ts";
+export type RangeOperationCallback = (rangeRef: WorkbookRangeRef) => Promise<void>;
+//# sourceMappingURL=RangeOperationCallback.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RangeOperationCallback.d.ts","sourceRoot":"","sources":["../../../src/models/RangeOperationCallback.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAEtE,MAAM,MAAM,sBAAsB,GAAG,CAAC,QAAQ,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/dist/esm/models/RangeOperationCallback.js

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

package/dist/esm/services/addressManipulation.d.ts

@@ -1,4 +1,5 @@
 import type { Address, CellAddress, ColumnAddress, RowAddress } from "../models/Address.ts";
+import type { WorkbookRangeRef } from "../models/WorkbookRangeRef.ts";
 export type AddressComponents = {
     startColumn: ColumnAddress;
     endColumn: ColumnAddress;
@@ -128,4 +129,36 @@ export declare function countAddressRows(address: Address): number;
  * @returns The number of columns in the address.
  */
 export declare function countAddressColumns(address: Address): number;
+/**
+ * Extracts a subrange from a spreadsheet-style A1 range (e.g., "A1:D10"),
+ * allowing skip and take semantics on both rows and columns.
+ *
+ * Supports negative values for `skipRows` and `skipCols` to count from the end.
+ * Supports negative values for `takeRows` and `takeCols` to exclude from the end after skipping.
+ *
+ * @param address - The original range in A1 notation (e.g., "A1:D10").
+ * @param skipRows - Number of rows to skip. If negative, skips that many rows from the end. Default is 0.
+ * @param takeRows - Number of rows to take after skipping. If negative, excludes that many rows from the end of the remaining rows. Default is Infinity.
+ * @param skipCols - Number of columns to skip. If negative, skips that many columns from the end. Default is 0.
+ * @param takeCols - Number of columns to take after skipping. If negative, excludes that many columns from the end of the remaining columns. Default is Infinity.
+ * @returns A new A1-style range representing the sliced subrange (e.g., "B2:C5").
+ *
+ * @example
+ * subaddress("A1:D10", -1, 1); // Last row: "A10:D10"
+ * subaddress("A1:D10", -2, 1); // Second last row: "A9:D9"
+ * subaddress("A1:D10", 0, -1); // All but last row: "A1:D9"
+ * subaddress("A1:D10", 0, Infinity, -2, 1); // Second last column: "C1:C10"
+ */
+export declare function subaddress(address: Address, skipRows?: number, takeRows?: number, skipCols?: number, takeCols?: number): Address;
+/**
+ * Extracts a subrange from a WorkbookRangeRef using skip/take semantics.
+ * @param rangeRef Range reference to extract the sub-range from.
+ * @param skipRows Number of rows to skip. If negative, skips from the end. Default 0.
+ * @param takeRows Number of rows to take after skipping. If negative, excludes from the end. Default Infinity.
+ * @param skipCols Number of columns to skip. If negative, skips from the end. Default 0.
+ * @param takeCols Number of columns to take after skipping. If negative, excludes from the end. Default Infinity.
+ * @returns Extracted sub-range reference.
+ * @throws InvalidArgumentError if the requested rows or columns exceed the available range.
+ */
+export declare function subrange(rangeRef: WorkbookRangeRef, skipRows?: number, takeRows?: number, skipCols?: number, takeCols?: number): WorkbookRangeRef;
 //# sourceMappingURL=addressManipulation.d.ts.map

package/dist/esm/services/addressManipulation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"addressManipulation.d.ts","sourceRoot":"","sources":["../../../src/services/addressManipulation.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAoB,aAAa,EAAsB,UAAU,EAAmB,MAAM,sBAAsB,CAAC;AAmBnJ,MAAM,MAAM,iBAAiB,GAAG;IAC/B,WAAW,EAAE,aAAa,CAAC;IAC3B,SAAS,EAAE,aAAa,CAAC;IACzB,QAAQ,EAAE,UAAU,CAAC;IACrB,MAAM,EAAE,UAAU,CAAC;CACnB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,UAAQ,GAAG,OAAO,CAE9E;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,iBAAiB,CAcpE;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,iBAAiB,EAAE,UAAU,UAAQ,GAAG,OAAO,CAsBzF;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,WAAW,CAGjE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,WAAW,CAGhE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAS5D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAS3D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAS/D;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAS9D;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAqChG;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAE7D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAE7D;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAKlF;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAG5D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAG/D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAG7D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAG1D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAGzD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAG5D"}
+{"version":3,"file":"addressManipulation.d.ts","sourceRoot":"","sources":["../../../src/services/addressManipulation.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAoB,aAAa,EAAsB,UAAU,EAAmB,MAAM,sBAAsB,CAAC;AAGnJ,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAkBtE,MAAM,MAAM,iBAAiB,GAAG;IAC/B,WAAW,EAAE,aAAa,CAAC;IAC3B,SAAS,EAAE,aAAa,CAAC;IACzB,QAAQ,EAAE,UAAU,CAAC;IACrB,MAAM,EAAE,UAAU,CAAC;CACnB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,UAAQ,GAAG,OAAO,CAE9E;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,iBAAiB,CAcpE;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,iBAAiB,EAAE,UAAU,UAAQ,GAAG,OAAO,CAsBzF;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,WAAW,CAGjE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,WAAW,CAGhE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAS5D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAS3D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAS/D;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAS9D;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAqChG;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAE7D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAE7D;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAKlF;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAG5D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAG/D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAG7D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAG1D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAGzD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAG5D;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,SAAI,EAAE,QAAQ,SAA2B,EAAE,QAAQ,SAAI,EAAE,QAAQ,SAA2B,GAAG,OAAO,CAqC1J;AAED;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,EAAE,QAAQ,SAAI,EAAE,QAAQ,SAA2B,EAAE,QAAQ,SAAI,EAAE,QAAQ,SAA2B,GAAG,gBAAgB,CAM3K"}