@rowsncolumns/functions 14.0.29

package/LICENSE.md

@@ -0,0 +1,100 @@
+# Rows n' Columns Commercial License Agreement
+
+This Rows n' Columns Commercial License Agreement (the "Agreement") governs
+the use of the Rows n' Columns software packages published under the
+`@rowsncolumns` npm scope, including associated JavaScript, WebAssembly
+binaries, stylesheets, type definitions and documentation (the "Software").
+
+The Software is **not** open source. Downloading or installing the Software
+from a public package registry does not grant any right to use it beyond the
+evaluation use described below.
+
+## 1. Definitions
+
+- **"Licensor"** means Rows n' Columns (rowsncolumns.app).
+- **"Licensee"** means the individual or legal entity identified in an Order.
+- **"Order"** means a purchase of a license for the Software from Licensor,
+  identified by an order ID and associated with a License Key.
+- **"License Key"** means the signed key issued by Licensor that identifies
+  the Licensee, license tier, and Update Window.
+- **"Update Window"** means the period stated in the Order during which
+  Software versions released by Licensor are covered by the License Key.
+
+## 2. License Grant
+
+Subject to payment of the applicable fees and compliance with this Agreement,
+Licensor grants Licensee a non-exclusive, non-transferable, worldwide license
+to use, and to distribute in compiled form as an embedded component of
+Licensee's own applications, any version of the Software released during the
+Update Window, in accordance with the license tier stated in the Order.
+
+This grant is perpetual for versions released during the Update Window:
+Licensee may continue to use those versions after the Update Window ends.
+Versions released after the Update Window ends require a new or renewed
+Order.
+
+## 3. Evaluation Use
+
+The Software may be used without a License Key solely for internal
+evaluation and development purposes. Evaluation use in production, or
+removal or suppression of evaluation notices, is not permitted.
+
+## 4. Restrictions
+
+Except as expressly permitted by this Agreement or by applicable law that
+cannot be contractually waived, Licensee shall not:
+
+1. redistribute, resell, sublicense, or otherwise make the Software
+   available as a standalone product, library, or development component;
+2. use the Software to build a product that competes with the Software;
+3. remove, alter, or circumvent License Key validation, evaluation notices,
+   watermarks, or copyright notices in the Software;
+4. share License Keys with any third party, or use a License Key outside
+   the scope of the tier stated in the Order;
+5. reverse engineer, decompile, or disassemble the Software except to the
+   extent permitted by applicable law.
+
+## 5. Ownership
+
+The Software is licensed, not sold. Licensor and its licensors retain all
+right, title, and interest in and to the Software, including all
+intellectual property rights.
+
+## 6. Third-Party Components
+
+The Software may include third-party open-source components. Those
+components remain governed by their own license terms, which are included
+with the applicable component and are not limited by this Agreement.
+
+## 7. Termination
+
+This Agreement terminates automatically upon material breach by Licensee
+that remains uncured 30 days after written notice. Upon termination,
+Licensee must cease use and distribution of the Software, except that
+end-user copies of Licensee applications already distributed in compliance
+with this Agreement are unaffected.
+
+## 8. Warranty Disclaimer
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT.
+
+## 9. Limitation of Liability
+
+TO THE MAXIMUM EXTENT PERMITTED BY LAW, IN NO EVENT SHALL LICENSOR BE LIABLE
+FOR ANY INDIRECT, INCIDENTAL, SPECIAL, CONSEQUENTIAL, OR PUNITIVE DAMAGES,
+OR ANY LOSS OF PROFITS, DATA, OR GOODWILL, ARISING OUT OF OR RELATED TO THIS
+AGREEMENT, AND LICENSOR'S AGGREGATE LIABILITY SHALL NOT EXCEED THE FEES PAID
+BY LICENSEE IN THE TWELVE MONTHS PRECEDING THE CLAIM.
+
+## 10. General
+
+This Agreement constitutes the entire agreement between the parties
+concerning the Software and supersedes any prior agreements. If any
+provision is held unenforceable, the remainder remains in effect. Failure to
+enforce a provision is not a waiver.
+
+For licensing inquiries, visit <https://www.rowsncolumns.app/pricing>.
+
+Copyright © Rows n' Columns. All rights reserved.

package/Readme.md

@@ -0,0 +1,5 @@
+# Functions
+
+Contains function descriptions and custom functions used by calculator
+
+TODO

package/dist/cjs/formulas/array-formula.d.ts

@@ -0,0 +1,4 @@
+import type { FunctionArgument } from "@rowsncolumns/calculator";
+import type FormulaParser from "@rowsncolumns/fast-formula-parser";
+export declare const ARRAYFORMULA: (_: FormulaParser, arg: FunctionArgument) => import("@rowsncolumns/fast-formula-parser").FormulaResult;
+//# sourceMappingURL=array-formula.d.ts.map

package/dist/cjs/formulas/array-formula.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"array-formula.d.ts","sourceRoot":"","sources":["../../../formulas/array-formula.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,aAAa,MAAM,mCAAmC,CAAC;AAEnE,eAAO,MAAM,YAAY,GAAI,GAAG,aAAa,EAAE,KAAK,gBAAgB,8DAEnE,CAAC"}

package/dist/cjs/formulas/array-formula.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ARRAYFORMULA = void 0;
+var ARRAYFORMULA = function (_, arg) {
+    return arg.value;
+};
+exports.ARRAYFORMULA = ARRAYFORMULA;

package/dist/cjs/formulas/crypto-price.d.ts

@@ -0,0 +1,4 @@
+import { FunctionArgument } from "@rowsncolumns/calculator";
+import type FormulaParser from "@rowsncolumns/fast-formula-parser";
+export declare const CRYPTOPRICE: (parser: FormulaParser, arg: FunctionArgument) => Promise<number[][]>;
+//# sourceMappingURL=crypto-price.d.ts.map

package/dist/cjs/formulas/crypto-price.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto-price.d.ts","sourceRoot":"","sources":["../../../formulas/crypto-price.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAEjB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,aAAa,MAAM,mCAAmC,CAAC;AAGnE,eAAO,MAAM,WAAW,GACtB,QAAQ,aAAa,EACrB,KAAK,gBAAgB,wBAoCtB,CAAC"}

package/dist/cjs/formulas/crypto-price.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CRYPTOPRICE = void 0;
+var tslib_1 = require("tslib");
+var calculator_1 = require("@rowsncolumns/calculator");
+var fast_formula_parser_1 = require("@rowsncolumns/fast-formula-parser");
+var CRYPTOPRICE = function (parser, arg) { return tslib_1.__awaiter(void 0, void 0, void 0, function () {
+    var fetchPrices;
+    return tslib_1.__generator(this, function (_a) {
+        switch (_a.label) {
+            case 0:
+                if (!arg || !arg.value || arg.value instanceof fast_formula_parser_1.FormulaError) {
+                    throw new fast_formula_parser_1.FormulaError("#VALUE!", "Symbol pair is required");
+                }
+                fetchPrices = function () { return tslib_1.__awaiter(void 0, void 0, void 0, function () {
+                    var results, values, err_1;
+                    return tslib_1.__generator(this, function (_a) {
+                        switch (_a.label) {
+                            case 0:
+                                _a.trys.push([0, 3, , 4]);
+                                return [4 /*yield*/, fetch("https://api.gemini.com/v2/ticker/".concat(String(arg.value).toLowerCase()), {
+                                        method: "GET",
+                                    })];
+                            case 1:
+                                results = _a.sent();
+                                return [4 /*yield*/, results.json()];
+                            case 2:
+                                values = _a.sent();
+                                return [2 /*return*/, [[Number(values.ask), Number(values.bid)]]];
+                            case 3:
+                                err_1 = _a.sent();
+                                throw new fast_formula_parser_1.FormulaError("#NULL!", String(err_1));
+                            case 4: return [2 /*return*/];
+                        }
+                    });
+                }); };
+                (0, calculator_1.calculationPipeline)(parser, function (onUpdate) {
+                    var timeout = setInterval(function () { return tslib_1.__awaiter(void 0, void 0, void 0, function () {
+                        var values;
+                        return tslib_1.__generator(this, function (_a) {
+                            switch (_a.label) {
+                                case 0: return [4 /*yield*/, fetchPrices()];
+                                case 1:
+                                    values = _a.sent();
+                                    if (values !== undefined) {
+                                        onUpdate(values);
+                                    }
+                                    return [2 /*return*/];
+                            }
+                        });
+                    }); }, 5000);
+                    console.log("Sub", timeout);
+                    return function () {
+                        console.log("Unsub", timeout);
+                        clearInterval(timeout);
+                    };
+                });
+                return [4 /*yield*/, fetchPrices()];
+            case 1: return [2 /*return*/, _a.sent()];
+        }
+    });
+}); };
+exports.CRYPTOPRICE = CRYPTOPRICE;

package/dist/cjs/formulas/datasource.d.ts

@@ -0,0 +1,4 @@
+import { FunctionArgument, DataSource } from "@rowsncolumns/calculator";
+import FormulaParser from "@rowsncolumns/fast-formula-parser";
+export declare const DATASOURCE: (parser: FormulaParser, data: FunctionArgument, limit: FunctionArgument) => DataSource | undefined;
+//# sourceMappingURL=datasource.d.ts.map

package/dist/cjs/formulas/datasource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"datasource.d.ts","sourceRoot":"","sources":["../../../formulas/datasource.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,aAA+B,MAAM,mCAAmC,CAAC;AAGhF,eAAO,MAAM,UAAU,GACrB,QAAQ,aAAa,EACrB,MAAM,gBAAgB,EACtB,OAAO,gBAAgB,KACtB,UAAU,GAAG,SAsBf,CAAC"}

package/dist/cjs/formulas/datasource.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DATASOURCE = void 0;
+var calculator_1 = require("@rowsncolumns/calculator");
+var fast_formula_parser_1 = require("@rowsncolumns/fast-formula-parser");
+var utils_1 = require("@rowsncolumns/utils");
+var DATASOURCE = function (parser, data, limit) {
+    if (parser.isPreview) {
+        return undefined;
+    }
+    if (!data.value || !Array.isArray(data.value)) {
+        // throw new FormulaError("#NA!", "Invalid data");
+    }
+    if (limit && !(0, utils_1.isNumber)(limit.value)) {
+        throw new fast_formula_parser_1.FormulaError("#NA!", "Limit should be a number");
+    }
+    var rowCount = (0, utils_1.isNil)(limit === null || limit === void 0 ? void 0 : limit.value) ? undefined : Number(limit.value);
+    var datasource = new calculator_1.DataSource(parser, parser.position, data.value, rowCount);
+    return datasource;
+};
+exports.DATASOURCE = DATASOURCE;

package/dist/cjs/formulas/formula-text.d.ts

@@ -0,0 +1,5 @@
+import type { FunctionArgument } from "@rowsncolumns/calculator";
+import type FormulaParser from "@rowsncolumns/fast-formula-parser";
+import type { CellData } from "@rowsncolumns/common-types";
+export declare const FORMULATEXT: (parser: FormulaParser<CellData>, arg: FunctionArgument) => string;
+//# sourceMappingURL=formula-text.d.ts.map

package/dist/cjs/formulas/formula-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formula-text.d.ts","sourceRoot":"","sources":["../../../formulas/formula-text.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,aAAa,MAAM,mCAAmC,CAAC;AAEnE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAE3D,eAAO,MAAM,WAAW,GACtB,QAAQ,aAAa,CAAC,QAAQ,CAAC,EAC/B,KAAK,gBAAgB,WAatB,CAAC"}

package/dist/cjs/formulas/formula-text.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FORMULATEXT = void 0;
+var fast_formula_parser_1 = require("@rowsncolumns/fast-formula-parser");
+var FORMULATEXT = function (parser, arg) {
+    var _a;
+    var cellData = parser.getCellData(arg.position);
+    var userEnteredValue = Array.isArray(cellData)
+        ? undefined
+        : (_a = cellData === null || cellData === void 0 ? void 0 : cellData.ue) !== null && _a !== void 0 ? _a : cellData === null || cellData === void 0 ? void 0 : cellData.userEnteredValue;
+    var formulaValue = userEnteredValue === null || userEnteredValue === void 0 ? void 0 : userEnteredValue.formulaValue;
+    if (formulaValue) {
+        return formulaValue;
+    }
+    throw new fast_formula_parser_1.FormulaError("#NA", "Invalid formula parse result.");
+};
+exports.FORMULATEXT = FORMULATEXT;

package/dist/cjs/formulas/get-pivot-data.d.ts

@@ -0,0 +1,32 @@
+import type { FunctionArgument } from "@rowsncolumns/calculator";
+/**
+ * GETPIVOTDATA(value_name, pivot_range, [field, item, ...])
+ *
+ * Looks up an aggregated value at the intersection of the named
+ * value column and the named field/item criteria within a rendered
+ * pivot range.
+ *
+ * Excel signature support:
+ *   - GETPIVOTDATA("Sum of Revenue", $A$1)
+ *       → grand total of "Sum of Revenue" (no criteria)
+ *   - GETPIVOTDATA("Sum of Revenue", $A$1, "Region", "West")
+ *       → cell at intersection where Region=West
+ *   - GETPIVOTDATA("Sum of Revenue", $A$1, "Region", "West", "Year", 2024)
+ *       → multi-field criteria, ANDed
+ *
+ * This implementation treats the pivot range as a 2D matrix and
+ * does header-matching: it scans the leading row(s) for column-
+ * dimension headers, the leading column(s) for row-dimension
+ * headers, and resolves the requested value at the intersection.
+ *
+ * Returns `#REF!` if criteria don't resolve to a unique cell, or
+ * `#NA!` if `value_name` isn't found in the range.
+ *
+ * Limitations vs Excel:
+ *   - Doesn't honor pivot scoping (which pivot owns the cell). We
+ *     work off the provided range only.
+ *   - Doesn't auto-derive "Sum of X" / "Avg of X" — caller must
+ *     pass the rendered header verbatim.
+ */
+export declare const GETPIVOTDATA: (_parser: unknown, valueName: FunctionArgument, pivotRange: FunctionArgument, ...criteria: FunctionArgument[]) => unknown;
+//# sourceMappingURL=get-pivot-data.d.ts.map

package/dist/cjs/formulas/get-pivot-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-pivot-data.d.ts","sourceRoot":"","sources":["../../../formulas/get-pivot-data.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAGjE;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,YAAY,GACvB,SAAS,OAAO,EAChB,WAAW,gBAAgB,EAC3B,YAAY,gBAAgB,EAC5B,GAAG,UAAU,gBAAgB,EAAE,KAC9B,OA4HF,CAAC"}

package/dist/cjs/formulas/get-pivot-data.js

@@ -0,0 +1,188 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GETPIVOTDATA = void 0;
+var tslib_1 = require("tslib");
+var fast_formula_parser_1 = require("@rowsncolumns/fast-formula-parser");
+/**
+ * GETPIVOTDATA(value_name, pivot_range, [field, item, ...])
+ *
+ * Looks up an aggregated value at the intersection of the named
+ * value column and the named field/item criteria within a rendered
+ * pivot range.
+ *
+ * Excel signature support:
+ *   - GETPIVOTDATA("Sum of Revenue", $A$1)
+ *       → grand total of "Sum of Revenue" (no criteria)
+ *   - GETPIVOTDATA("Sum of Revenue", $A$1, "Region", "West")
+ *       → cell at intersection where Region=West
+ *   - GETPIVOTDATA("Sum of Revenue", $A$1, "Region", "West", "Year", 2024)
+ *       → multi-field criteria, ANDed
+ *
+ * This implementation treats the pivot range as a 2D matrix and
+ * does header-matching: it scans the leading row(s) for column-
+ * dimension headers, the leading column(s) for row-dimension
+ * headers, and resolves the requested value at the intersection.
+ *
+ * Returns `#REF!` if criteria don't resolve to a unique cell, or
+ * `#NA!` if `value_name` isn't found in the range.
+ *
+ * Limitations vs Excel:
+ *   - Doesn't honor pivot scoping (which pivot owns the cell). We
+ *     work off the provided range only.
+ *   - Doesn't auto-derive "Sum of X" / "Avg of X" — caller must
+ *     pass the rendered header verbatim.
+ */
+var GETPIVOTDATA = function (_parser, valueName, pivotRange) {
+    var e_1, _a, e_2, _b, e_3, _c;
+    var _d, _e, _f, _g, _h, _j, _k, _l, _m;
+    var criteria = [];
+    for (var _i = 3; _i < arguments.length; _i++) {
+        criteria[_i - 3] = arguments[_i];
+    }
+    if (valueName == null || pivotRange == null) {
+        throw new fast_formula_parser_1.FormulaError("#NA!", "GETPIVOTDATA requires value name and pivot range");
+    }
+    var target = String((_d = valueName.value) !== null && _d !== void 0 ? _d : "")
+        .trim()
+        .toLowerCase();
+    if (!target) {
+        throw new fast_formula_parser_1.FormulaError("#NA!", "GETPIVOTDATA value name is empty");
+    }
+    // The pivot range arrives as a 2-D array (FunctionArgument.value
+    // for a CellRange is rows[cols][]). Single-cell args come in as
+    // a scalar — coerce to the 2D shape.
+    var raw = pivotRange.value;
+    var matrix = Array.isArray(raw)
+        ? Array.isArray(raw[0])
+            ? raw
+            : [raw]
+        : [[raw]];
+    if (matrix.length === 0 || matrix[0].length === 0) {
+        throw new fast_formula_parser_1.FormulaError("#REF!", "GETPIVOTDATA range is empty");
+    }
+    // Parse criteria into pairs.
+    var pairs = [];
+    for (var i = 0; i < criteria.length; i += 2) {
+        var field = String((_f = (_e = criteria[i]) === null || _e === void 0 ? void 0 : _e.value) !== null && _f !== void 0 ? _f : "")
+            .trim()
+            .toLowerCase();
+        var item = String((_h = (_g = criteria[i + 1]) === null || _g === void 0 ? void 0 : _g.value) !== null && _h !== void 0 ? _h : "")
+            .trim()
+            .toLowerCase();
+        if (!field)
+            continue;
+        pairs.push({ field: field, item: item });
+    }
+    var cellAt = function (r, c) {
+        var _a, _b;
+        return String((_b = (_a = matrix[r]) === null || _a === void 0 ? void 0 : _a[c]) !== null && _b !== void 0 ? _b : "")
+            .trim()
+            .toLowerCase();
+    };
+    // Find the value column: scan all cells; the topmost row that
+    // contains `target` is the value-header row, and we record the
+    // column index. Excel typically puts these in row 0 or 1 of the
+    // rendered range.
+    var numRows = matrix.length;
+    var numCols = matrix[0].length;
+    var valueColumn = -1;
+    var valueHeaderRow = -1;
+    outer: for (var r = 0; r < numRows; r++) {
+        for (var c = 0; c < numCols; c++) {
+            if (cellAt(r, c) === target) {
+                valueColumn = c;
+                valueHeaderRow = r;
+                break outer;
+            }
+        }
+    }
+    if (valueColumn < 0) {
+        throw new fast_formula_parser_1.FormulaError("#NA!", "GETPIVOTDATA: value '".concat(valueName.value, "' not found in range"));
+    }
+    // No criteria → assume the grand-total cell. Convention in Excel
+    // is the last row of the value column (after subtotals settle).
+    // Fall back to first non-header cell if no row qualifies.
+    if (pairs.length === 0) {
+        for (var r = numRows - 1; r > valueHeaderRow; r--) {
+            var v = (_j = matrix[r]) === null || _j === void 0 ? void 0 : _j[valueColumn];
+            if (v != null && v !== "")
+                return v;
+        }
+        return (_l = (_k = matrix[valueHeaderRow + 1]) === null || _k === void 0 ? void 0 : _k[valueColumn]) !== null && _l !== void 0 ? _l : null;
+    }
+    // Match a row: for each criterion (field, item), find the
+    // column where the header row contains `field`, then check the
+    // candidate row's cell at that column equals `item`. ALL pairs
+    // must match (AND).
+    var fieldColumns = new Map();
+    try {
+        for (var pairs_1 = tslib_1.__values(pairs), pairs_1_1 = pairs_1.next(); !pairs_1_1.done; pairs_1_1 = pairs_1.next()) {
+            var field = pairs_1_1.value.field;
+            for (var c = 0; c < numCols; c++) {
+                // Find any row where header[r][c] === field. Excel pivots
+                // typically place row dimensions in left columns; we find
+                // any column whose header anywhere in the leading rows
+                // matches.
+                var matched = false;
+                for (var r = 0; r <= valueHeaderRow; r++) {
+                    if (cellAt(r, c) === field) {
+                        fieldColumns.set(field, c);
+                        matched = true;
+                        break;
+                    }
+                }
+                if (matched)
+                    break;
+            }
+        }
+    }
+    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+    finally {
+        try {
+            if (pairs_1_1 && !pairs_1_1.done && (_a = pairs_1.return)) _a.call(pairs_1);
+        }
+        finally { if (e_1) throw e_1.error; }
+    }
+    try {
+        // If any field can't be located → #REF!
+        for (var pairs_2 = tslib_1.__values(pairs), pairs_2_1 = pairs_2.next(); !pairs_2_1.done; pairs_2_1 = pairs_2.next()) {
+            var field = pairs_2_1.value.field;
+            if (!fieldColumns.has(field)) {
+                throw new fast_formula_parser_1.FormulaError("#REF!", "GETPIVOTDATA: field '".concat(field, "' not found"));
+            }
+        }
+    }
+    catch (e_2_1) { e_2 = { error: e_2_1 }; }
+    finally {
+        try {
+            if (pairs_2_1 && !pairs_2_1.done && (_b = pairs_2.return)) _b.call(pairs_2);
+        }
+        finally { if (e_2) throw e_2.error; }
+    }
+    for (var r = valueHeaderRow + 1; r < numRows; r++) {
+        var allMatch = true;
+        try {
+            for (var pairs_3 = (e_3 = void 0, tslib_1.__values(pairs)), pairs_3_1 = pairs_3.next(); !pairs_3_1.done; pairs_3_1 = pairs_3.next()) {
+                var _o = pairs_3_1.value, field = _o.field, item = _o.item;
+                var col = fieldColumns.get(field);
+                if (cellAt(r, col) !== item) {
+                    allMatch = false;
+                    break;
+                }
+            }
+        }
+        catch (e_3_1) { e_3 = { error: e_3_1 }; }
+        finally {
+            try {
+                if (pairs_3_1 && !pairs_3_1.done && (_c = pairs_3.return)) _c.call(pairs_3);
+            }
+            finally { if (e_3) throw e_3.error; }
+        }
+        if (allMatch) {
+            var v = (_m = matrix[r]) === null || _m === void 0 ? void 0 : _m[valueColumn];
+            return v !== null && v !== void 0 ? v : null;
+        }
+    }
+    throw new fast_formula_parser_1.FormulaError("#REF!", "GETPIVOTDATA: no row matches the supplied criteria");
+};
+exports.GETPIVOTDATA = GETPIVOTDATA;

package/dist/cjs/formulas/hyperlink.d.ts

@@ -0,0 +1,5 @@
+import type { FunctionArgument } from "@rowsncolumns/calculator";
+import type FormulaParser from "@rowsncolumns/fast-formula-parser";
+import { type HyperlinkResult } from "@rowsncolumns/common-types";
+export declare const HYPERLINK: (_: FormulaParser, url: FunctionArgument, title?: FunctionArgument) => HyperlinkResult | undefined;
+//# sourceMappingURL=hyperlink.d.ts.map

package/dist/cjs/formulas/hyperlink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hyperlink.d.ts","sourceRoot":"","sources":["../../../formulas/hyperlink.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,aAAa,MAAM,mCAAmC,CAAC;AACnE,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAGlE,eAAO,MAAM,SAAS,GACpB,GAAG,aAAa,EAChB,KAAK,gBAAgB,EACrB,QAAO,gBAAsB,KAC5B,eAAe,GAAG,SAepB,CAAC"}

package/dist/cjs/formulas/hyperlink.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HYPERLINK = void 0;
+var fast_formula_parser_1 = require("@rowsncolumns/fast-formula-parser");
+var HYPERLINK = function (_, url, title) {
+    if (title === void 0) { title = url; }
+    if (!url.value) {
+        throw new fast_formula_parser_1.FormulaError("#VALUE!", "URL is required");
+    }
+    if (typeof url.value !== "string") {
+        throw new fast_formula_parser_1.FormulaError("#VALUE!", "URL should be a string");
+    }
+    if (typeof title.value !== "string") {
+        throw new fast_formula_parser_1.FormulaError("#VALUE!", "URL should be a string");
+    }
+    return {
+        title: title.value,
+        url: url.value,
+        kind: "hyperlink",
+    };
+};
+exports.HYPERLINK = HYPERLINK;

package/dist/cjs/formulas/image.d.ts

@@ -0,0 +1,5 @@
+import type { FunctionArgument } from "@rowsncolumns/calculator";
+import type FormulaParser from "@rowsncolumns/fast-formula-parser";
+import { type ImageResult } from "@rowsncolumns/common-types";
+export declare const IMAGE: (_: FormulaParser, url: FunctionArgument) => ImageResult;
+//# sourceMappingURL=image.d.ts.map

package/dist/cjs/formulas/image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image.d.ts","sourceRoot":"","sources":["../../../formulas/image.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,aAAa,MAAM,mCAAmC,CAAC;AACnE,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAG9D,eAAO,MAAM,KAAK,GAAI,GAAG,aAAa,EAAE,KAAK,gBAAgB,KAAG,WAW/D,CAAC"}

package/dist/cjs/formulas/image.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IMAGE = void 0;
+var fast_formula_parser_1 = require("@rowsncolumns/fast-formula-parser");
+var IMAGE = function (_, url) {
+    if (!url.value) {
+        throw new fast_formula_parser_1.FormulaError("#VALUE!", "URL is required");
+    }
+    if (typeof url.value !== "string") {
+        throw new fast_formula_parser_1.FormulaError("#VALUE!", "URL should be a string");
+    }
+    return {
+        imageUrl: url.value,
+        kind: "image",
+    };
+};
+exports.IMAGE = IMAGE;

package/dist/cjs/formulas/import-data.d.ts

@@ -0,0 +1,11 @@
+import type { FunctionArgument } from "@rowsncolumns/calculator";
+import type FormulaParser from "@rowsncolumns/fast-formula-parser";
+/**
+ * // =IMPORTDATA("https://api.covidtracking.com/v1/us/daily.csv")
+ * =IMPORTDATA("https://api.covidtracking.com/v1/us/current.json")
+ * @param parser
+ * @param url
+ * @returns
+ */
+export declare const IMPORTDATA: (parser: FormulaParser, url: FunctionArgument) => Promise<string[][] | undefined>;
+//# sourceMappingURL=import-data.d.ts.map

package/dist/cjs/formulas/import-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-data.d.ts","sourceRoot":"","sources":["../../../formulas/import-data.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,aAAa,MAAM,mCAAmC,CAAC;AAInE;;;;;;GAMG;AAEH,eAAO,MAAM,UAAU,GAErB,QAAQ,aAAa,EACrB,KAAK,gBAAgB,oCAmBtB,CAAC"}

package/dist/cjs/formulas/import-data.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IMPORTDATA = void 0;
+var tslib_1 = require("tslib");
+var fast_formula_parser_1 = require("@rowsncolumns/fast-formula-parser");
+var toolkit_1 = require("@rowsncolumns/toolkit");
+/**
+ * // =IMPORTDATA("https://api.covidtracking.com/v1/us/daily.csv")
+ * =IMPORTDATA("https://api.covidtracking.com/v1/us/current.json")
+ * @param parser
+ * @param url
+ * @returns
+ */
+var IMPORTDATA = function (
+// getContext,
+parser, url) { return tslib_1.__awaiter(void 0, void 0, void 0, function () {
+    var fileExtension, response, results, err_1;
+    return tslib_1.__generator(this, function (_a) {
+        switch (_a.label) {
+            case 0:
+                if (!(url === null || url === void 0 ? void 0 : url.value) || typeof (url === null || url === void 0 ? void 0 : url.value) !== "string") {
+                    throw new fast_formula_parser_1.FormulaError("#VALUE!", "URL is missing");
+                }
+                fileExtension = url.value.split(".").pop();
+                if (fileExtension && !(["tsv", "csv"].indexOf(fileExtension) !== -1)) {
+                    throw new fast_formula_parser_1.FormulaError("#N/A", "Only CSV and TSV are supported by IMPORTDATA");
+                }
+                return [4 /*yield*/, fetch(url.value)];
+            case 1: return [4 /*yield*/, (_a.sent()).text()];
+            case 2:
+                response = _a.sent();
+                _a.label = 3;
+            case 3:
+                _a.trys.push([3, 5, , 6]);
+                return [4 /*yield*/, (0, toolkit_1.parseCSV)(response)];
+            case 4:
+                results = _a.sent();
+                return [2 /*return*/, results];
+            case 5:
+                err_1 = _a.sent();
+                throw new fast_formula_parser_1.FormulaError("#VALUE", String(err_1));
+            case 6: return [2 /*return*/];
+        }
+    });
+}); };
+exports.IMPORTDATA = IMPORTDATA;

package/dist/cjs/formulas/index.d.ts

@@ -0,0 +1,18 @@
+export { IMPORTDATA } from "./import-data";
+export { ARRAYFORMULA } from "./array-formula";
+export { STARRATING } from "./star-rating";
+export { HYPERLINK } from "./hyperlink";
+export { REALTIME } from "./real-time";
+export { CRYPTOPRICE } from "./crypto-price";
+export { IMAGE } from "./image";
+export { SELECTION_STATUS } from "./selection-status";
+export { MULTIPLY } from "./multiply";
+export { UNIQUE } from "./unique";
+export { SEQUENCE } from "./sequence";
+export { JOIN } from "./join";
+export { SPLIT } from "./split";
+export { DATASOURCE } from "./datasource";
+export { FORMULATEXT } from "./formula-text";
+export { SPARKLINE } from "./sparkline";
+export { GETPIVOTDATA } from "./get-pivot-data";
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/formulas/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../formulas/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC"}