@rowsncolumns/functions 14.0.29

package/dist/cjs/formulas/index.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GETPIVOTDATA = exports.SPARKLINE = exports.FORMULATEXT = exports.DATASOURCE = exports.SPLIT = exports.JOIN = exports.SEQUENCE = exports.UNIQUE = exports.MULTIPLY = exports.SELECTION_STATUS = exports.IMAGE = exports.CRYPTOPRICE = exports.REALTIME = exports.HYPERLINK = exports.STARRATING = exports.ARRAYFORMULA = exports.IMPORTDATA = void 0;
+var import_data_1 = require("./import-data");
+Object.defineProperty(exports, "IMPORTDATA", { enumerable: true, get: function () { return import_data_1.IMPORTDATA; } });
+var array_formula_1 = require("./array-formula");
+Object.defineProperty(exports, "ARRAYFORMULA", { enumerable: true, get: function () { return array_formula_1.ARRAYFORMULA; } });
+var star_rating_1 = require("./star-rating");
+Object.defineProperty(exports, "STARRATING", { enumerable: true, get: function () { return star_rating_1.STARRATING; } });
+var hyperlink_1 = require("./hyperlink");
+Object.defineProperty(exports, "HYPERLINK", { enumerable: true, get: function () { return hyperlink_1.HYPERLINK; } });
+var real_time_1 = require("./real-time");
+Object.defineProperty(exports, "REALTIME", { enumerable: true, get: function () { return real_time_1.REALTIME; } });
+var crypto_price_1 = require("./crypto-price");
+Object.defineProperty(exports, "CRYPTOPRICE", { enumerable: true, get: function () { return crypto_price_1.CRYPTOPRICE; } });
+var image_1 = require("./image");
+Object.defineProperty(exports, "IMAGE", { enumerable: true, get: function () { return image_1.IMAGE; } });
+var selection_status_1 = require("./selection-status");
+Object.defineProperty(exports, "SELECTION_STATUS", { enumerable: true, get: function () { return selection_status_1.SELECTION_STATUS; } });
+var multiply_1 = require("./multiply");
+Object.defineProperty(exports, "MULTIPLY", { enumerable: true, get: function () { return multiply_1.MULTIPLY; } });
+var unique_1 = require("./unique");
+Object.defineProperty(exports, "UNIQUE", { enumerable: true, get: function () { return unique_1.UNIQUE; } });
+var sequence_1 = require("./sequence");
+Object.defineProperty(exports, "SEQUENCE", { enumerable: true, get: function () { return sequence_1.SEQUENCE; } });
+var join_1 = require("./join");
+Object.defineProperty(exports, "JOIN", { enumerable: true, get: function () { return join_1.JOIN; } });
+var split_1 = require("./split");
+Object.defineProperty(exports, "SPLIT", { enumerable: true, get: function () { return split_1.SPLIT; } });
+var datasource_1 = require("./datasource");
+Object.defineProperty(exports, "DATASOURCE", { enumerable: true, get: function () { return datasource_1.DATASOURCE; } });
+var formula_text_1 = require("./formula-text");
+Object.defineProperty(exports, "FORMULATEXT", { enumerable: true, get: function () { return formula_text_1.FORMULATEXT; } });
+var sparkline_1 = require("./sparkline");
+Object.defineProperty(exports, "SPARKLINE", { enumerable: true, get: function () { return sparkline_1.SPARKLINE; } });
+var get_pivot_data_1 = require("./get-pivot-data");
+Object.defineProperty(exports, "GETPIVOTDATA", { enumerable: true, get: function () { return get_pivot_data_1.GETPIVOTDATA; } });

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

@@ -0,0 +1,4 @@
+import type { FunctionArgument } from "@rowsncolumns/calculator";
+import type FormulaParser from "@rowsncolumns/fast-formula-parser";
+export declare const JOIN: (_: FormulaParser, delimiter: FunctionArgument, ...args: FunctionArgument[]) => string;
+//# sourceMappingURL=join.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"join.d.ts","sourceRoot":"","sources":["../../../formulas/join.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,aAAa,MAAM,mCAAmC,CAAC;AAInE,eAAO,MAAM,IAAI,GACf,GAAG,aAAa,EAChB,WAAW,gBAAgB,EAC3B,GAAG,MAAM,gBAAgB,EAAE,WA6B5B,CAAC"}

package/dist/cjs/formulas/join.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JOIN = void 0;
+var fast_formula_parser_1 = require("@rowsncolumns/fast-formula-parser");
+var utils_1 = require("@rowsncolumns/utils");
+var JOIN = function (_, delimiter) {
+    var args = [];
+    for (var _i = 2; _i < arguments.length; _i++) {
+        args[_i - 2] = arguments[_i];
+    }
+    if (!delimiter || (0, utils_1.isNil)(delimiter.value)) {
+        throw new fast_formula_parser_1.FormulaError("#NA!", "Invalid delimiter");
+    }
+    var delim = String(delimiter.value);
+    var values = args
+        .map(function (_a) {
+        var value = _a.value, position = _a.position, isRangeRef = _a.isRangeRef;
+        if (isRangeRef) {
+            // Validate
+            var rangePosition = position;
+            if (rangePosition.from.col !== rangePosition.to.col &&
+                rangePosition.from.row !== rangePosition.to.row) {
+                throw new fast_formula_parser_1.FormulaError("#VALUE!", "JOIN range must be a single row or a single column.");
+            }
+        }
+        if (Array.isArray(value)) {
+            return value.flat();
+        }
+        return value;
+    })
+        .flat();
+    return values.join(delim);
+};
+exports.JOIN = JOIN;

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"multiply.d.ts","sourceRoot":"","sources":["../../../formulas/multiply.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,aAAa,MAAM,mCAAmC,CAAC;AAInE,eAAO,MAAM,QAAQ,GACnB,GAAG,aAAa,EAChB,SAAS,gBAAgB,EACzB,SAAS,gBAAgB,WAiB1B,CAAC"}

package/dist/cjs/formulas/multiply.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MULTIPLY = void 0;
+var fast_formula_parser_1 = require("@rowsncolumns/fast-formula-parser");
+var utils_1 = require("@rowsncolumns/utils");
+var MULTIPLY = function (_, factor1, factor2) {
+    if ((0, utils_1.isNil)(factor1.value) || (0, utils_1.isNil)(factor2.value)) {
+        throw new fast_formula_parser_1.FormulaError("#N/A!", "Wrong number of arguments to MULTIPLY. Expected 2 arguments.");
+    }
+    if (typeof factor1.value !== "number" || typeof factor2.value !== "number") {
+        throw new fast_formula_parser_1.FormulaError("#VALUE", "Function MULTIPLY expects number values.");
+    }
+    return factor1.value * factor2.value;
+};
+exports.MULTIPLY = MULTIPLY;

package/dist/cjs/formulas/real-time.d.ts

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

package/dist/cjs/formulas/real-time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"real-time.d.ts","sourceRoot":"","sources":["../../../formulas/real-time.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAEjB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,aAAa,MAAM,mCAAmC,CAAC;AAEnE,eAAO,MAAM,QAAQ,GAAI,QAAQ,aAAa,EAAE,KAAK,gBAAgB,WAepE,CAAC"}

package/dist/cjs/formulas/real-time.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.REALTIME = void 0;
+var calculator_1 = require("@rowsncolumns/calculator");
+var REALTIME = function (parser, arg) {
+    (0, calculator_1.calculationPipeline)(parser, function (onUpdate) {
+        var timer = setInterval(function () {
+            onUpdate([[2, Math.random(), Math.random(), 2]]);
+        }, 5000);
+        console.log("sub", timer);
+        return function () {
+            console.log("unsub", timer);
+            clearTimeout(timer);
+        };
+    });
+    return "Loading";
+};
+exports.REALTIME = REALTIME;

package/dist/cjs/formulas/selection-status.d.ts

@@ -0,0 +1,4 @@
+import type { FunctionArgument } from "@rowsncolumns/calculator";
+import type FormulaParser from "@rowsncolumns/fast-formula-parser";
+export declare const SELECTION_STATUS: (_: FormulaParser, arg: FunctionArgument) => (number | undefined)[];
+//# sourceMappingURL=selection-status.d.ts.map

package/dist/cjs/formulas/selection-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection-status.d.ts","sourceRoot":"","sources":["../../../formulas/selection-status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,aAAa,MAAM,mCAAmC,CAAC;AAGnE,eAAO,MAAM,gBAAgB,GAAI,GAAG,aAAa,EAAE,KAAK,gBAAgB,2BAsCvE,CAAC"}

package/dist/cjs/formulas/selection-status.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SELECTION_STATUS = void 0;
+var tslib_1 = require("tslib");
+var utils_1 = require("@rowsncolumns/utils");
+var SELECTION_STATUS = function (_, arg) {
+    var e_1, _a, e_2, _b;
+    var sum = 0;
+    var count = 0;
+    var numCount = 0;
+    var min;
+    var max;
+    if (Array.isArray(arg.value)) {
+        try {
+            for (var _c = tslib_1.__values(arg.value), _d = _c.next(); !_d.done; _d = _c.next()) {
+                var row = _d.value;
+                try {
+                    for (var row_1 = (e_2 = void 0, tslib_1.__values(row)), row_1_1 = row_1.next(); !row_1_1.done; row_1_1 = row_1.next()) {
+                        var value = row_1_1.value;
+                        if (typeof value === "number") {
+                            sum += value;
+                            numCount++;
+                            if (min === undefined || value < min) {
+                                min = value;
+                            }
+                            if (max === undefined || value > max) {
+                                max = value;
+                            }
+                        }
+                        if (!(0, utils_1.isNil)(value)) {
+                            count++;
+                        }
+                    }
+                }
+                catch (e_2_1) { e_2 = { error: e_2_1 }; }
+                finally {
+                    try {
+                        if (row_1_1 && !row_1_1.done && (_b = row_1.return)) _b.call(row_1);
+                    }
+                    finally { if (e_2) throw e_2.error; }
+                }
+            }
+        }
+        catch (e_1_1) { e_1 = { error: e_1_1 }; }
+        finally {
+            try {
+                if (_d && !_d.done && (_a = _c.return)) _a.call(_c);
+            }
+            finally { if (e_1) throw e_1.error; }
+        }
+    }
+    // [sum, count, average, min, max, numericalCount]
+    // `numericalCount` is the count of cells holding numbers — distinct
+    // from `count` which counts any non-empty cell. Matches Excel and
+    // Sheets status-bar semantics.
+    return [
+        numCount === 0 ? undefined : sum,
+        count,
+        numCount === 0 ? undefined : sum / numCount,
+        min,
+        max,
+        numCount,
+    ];
+};
+exports.SELECTION_STATUS = SELECTION_STATUS;

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

@@ -0,0 +1,5 @@
+import type { FunctionArgument } from "@rowsncolumns/calculator";
+import type FormulaParser from "@rowsncolumns/fast-formula-parser";
+import { FormulaResultArray } from "@rowsncolumns/fast-formula-parser";
+export declare const SEQUENCE: (_: FormulaParser, rows: FunctionArgument, columns: FunctionArgument, start: FunctionArgument | undefined, step: FunctionArgument | undefined) => FormulaResultArray;
+//# sourceMappingURL=sequence.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sequence.d.ts","sourceRoot":"","sources":["../../../formulas/sequence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,aAAa,MAAM,mCAAmC,CAAC;AACnE,OAAO,EAEL,kBAAkB,EACnB,MAAM,mCAAmC,CAAC;AAG3C,eAAO,MAAM,QAAQ,GACnB,GAAG,aAAa,EAChB,MAAM,gBAAgB,EACtB,SAAS,gBAAgB,EACzB,OAAO,gBAAgB,GAAG,SAAS,EACnC,MAAM,gBAAgB,GAAG,SAAS,uBA8BnC,CAAC"}

package/dist/cjs/formulas/sequence.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SEQUENCE = void 0;
+var fast_formula_parser_1 = require("@rowsncolumns/fast-formula-parser");
+var utils_1 = require("@rowsncolumns/utils");
+var SEQUENCE = function (_, rows, columns, start, step) {
+    var _a, _b, _c;
+    if (!rows.value || typeof (rows === null || rows === void 0 ? void 0 : rows.value) !== "number") {
+        throw new fast_formula_parser_1.FormulaError("#NUM!", "Function SEQUENCE parameter 1 should be greater than or equal to 1.");
+    }
+    if (!(0, utils_1.isNil)(columns) && typeof (columns === null || columns === void 0 ? void 0 : columns.value) !== "number") {
+        throw new fast_formula_parser_1.FormulaError("#NUM!", "Function SEQUENCE parameter 2 should be greater than or equal to 1.");
+    }
+    var rowValue = rows.value;
+    var columnValue = (_a = columns === null || columns === void 0 ? void 0 : columns.value) !== null && _a !== void 0 ? _a : 1;
+    var startValue = (_b = start === null || start === void 0 ? void 0 : start.value) !== null && _b !== void 0 ? _b : 1;
+    var stepValue = (_c = step === null || step === void 0 ? void 0 : step.value) !== null && _c !== void 0 ? _c : 1;
+    var results = [];
+    for (var i = 0; i < rowValue; i++) {
+        var rows_1 = [];
+        for (var j = 0; j < columnValue; j++) {
+            rows_1.push(startValue);
+            startValue += stepValue;
+        }
+        results.push(rows_1);
+    }
+    return results;
+};
+exports.SEQUENCE = SEQUENCE;

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

@@ -0,0 +1,22 @@
+import type { FunctionArgument } from "@rowsncolumns/calculator";
+import type FormulaParser from "@rowsncolumns/fast-formula-parser";
+export declare const IMPORTDATA: (_parser: FormulaParser, _url: FunctionArgument) => Promise<never>;
+export declare const functions: {
+    IMPORTDATA: (_parser: FormulaParser, _url: FunctionArgument) => Promise<never>;
+    ARRAYFORMULA: (_: FormulaParser, arg: FunctionArgument) => import("@rowsncolumns/fast-formula-parser").FormulaResult;
+    STARRATING: (_: FormulaParser, arg: FunctionArgument) => import("@rowsncolumns/fast-formula-parser").RecursiveFormula;
+    HYPERLINK: (_: FormulaParser, url: FunctionArgument, title?: FunctionArgument) => import("@rowsncolumns/common-types").HyperlinkResult | undefined;
+    REALTIME: (parser: FormulaParser, arg: FunctionArgument) => string;
+    CRYPTOPRICE: (parser: FormulaParser, arg: FunctionArgument) => Promise<number[][]>;
+    IMAGE: (_: FormulaParser, url: FunctionArgument) => import("@rowsncolumns/common-types").ImageResult;
+    SELECTION_STATUS: (_: FormulaParser, arg: FunctionArgument) => (number | undefined)[];
+    MULTIPLY: (_: FormulaParser, factor1: FunctionArgument, factor2: FunctionArgument) => number;
+    UNIQUE: (_: FormulaParser, range: FunctionArgument, byColumnArg?: FunctionArgument, exactlyOnceArg?: FunctionArgument) => import("@rowsncolumns/fast-formula-parser").FormulaResult;
+    SEQUENCE: (_: FormulaParser, rows: FunctionArgument, columns: FunctionArgument, start: FunctionArgument | undefined, step: FunctionArgument | undefined) => import("@rowsncolumns/fast-formula-parser").FormulaResultArray;
+    JOIN: (_: FormulaParser, delimiter: FunctionArgument, ...args: FunctionArgument[]) => string;
+    SPLIT: (_: FormulaParser, text: FunctionArgument, delimiter: FunctionArgument, splitByEach?: FunctionArgument, removeEmptyText?: FunctionArgument) => string[][];
+    DATASOURCE: (parser: FormulaParser, data: FunctionArgument, limit: FunctionArgument) => import("@rowsncolumns/calculator").DataSource | undefined;
+    FORMULATEXT: (parser: FormulaParser<import("@rowsncolumns/common-types").CellData>, arg: FunctionArgument) => string;
+    SPARKLINE: (parser: FormulaParser, dataArg: FunctionArgument, optionsArg: FunctionArgument) => import("@rowsncolumns/common-types").SparkLineResult | undefined;
+};
+//# sourceMappingURL=server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../formulas/server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,aAAa,MAAM,mCAAmC,CAAC;AAsBnE,eAAO,MAAM,UAAU,GACrB,SAAS,aAAa,EACtB,MAAM,gBAAgB,mBAMvB,CAAC;AAEF,eAAO,MAAM,SAAS;0BATX,aAAa,QAChB,gBAAgB;;;;;;;;;;;;;;;;CAyB+B,CAAC"}

package/dist/cjs/formulas/server.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.functions = exports.IMPORTDATA = void 0;
+var tslib_1 = require("tslib");
+var fast_formula_parser_1 = require("@rowsncolumns/fast-formula-parser");
+var array_formula_1 = require("./array-formula");
+var crypto_price_1 = require("./crypto-price");
+var datasource_1 = require("./datasource");
+var formula_text_1 = require("./formula-text");
+var hyperlink_1 = require("./hyperlink");
+var image_1 = require("./image");
+var join_1 = require("./join");
+var multiply_1 = require("./multiply");
+var real_time_1 = require("./real-time");
+var selection_status_1 = require("./selection-status");
+var sequence_1 = require("./sequence");
+var sparkline_1 = require("./sparkline");
+var split_1 = require("./split");
+var star_rating_1 = require("./star-rating");
+var unique_1 = require("./unique");
+var IMPORTDATA = function (_parser, _url) { return tslib_1.__awaiter(void 0, void 0, void 0, function () {
+    return tslib_1.__generator(this, function (_a) {
+        throw new fast_formula_parser_1.FormulaError("#N/A", "IMPORTDATA is not available in the server calculation worker.");
+    });
+}); };
+exports.IMPORTDATA = IMPORTDATA;
+exports.functions = {
+    IMPORTDATA: exports.IMPORTDATA,
+    ARRAYFORMULA: array_formula_1.ARRAYFORMULA,
+    STARRATING: star_rating_1.STARRATING,
+    HYPERLINK: hyperlink_1.HYPERLINK,
+    REALTIME: real_time_1.REALTIME,
+    CRYPTOPRICE: crypto_price_1.CRYPTOPRICE,
+    IMAGE: image_1.IMAGE,
+    SELECTION_STATUS: selection_status_1.SELECTION_STATUS,
+    MULTIPLY: multiply_1.MULTIPLY,
+    UNIQUE: unique_1.UNIQUE,
+    SEQUENCE: sequence_1.SEQUENCE,
+    JOIN: join_1.JOIN,
+    SPLIT: split_1.SPLIT,
+    DATASOURCE: datasource_1.DATASOURCE,
+    FORMULATEXT: formula_text_1.FORMULATEXT,
+    SPARKLINE: sparkline_1.SPARKLINE,
+};

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

@@ -0,0 +1,5 @@
+import type { FunctionArgument } from "@rowsncolumns/calculator";
+import { SparkLineResult } from "@rowsncolumns/common-types";
+import type FormulaParser from "@rowsncolumns/fast-formula-parser";
+export declare const SPARKLINE: (parser: FormulaParser, dataArg: FunctionArgument, optionsArg: FunctionArgument) => SparkLineResult | undefined;
+//# sourceMappingURL=sparkline.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sparkline.d.ts","sourceRoot":"","sources":["../../../formulas/sparkline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,KAAK,aAAa,MAAM,mCAAmC,CAAC;AAGnE,eAAO,MAAM,SAAS,GACpB,QAAQ,aAAa,EACrB,SAAS,gBAAgB,EACzB,YAAY,gBAAgB,KAC3B,eAAe,GAAG,SA6DpB,CAAC"}

package/dist/cjs/formulas/sparkline.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SPARKLINE = void 0;
+var fast_formula_parser_1 = require("@rowsncolumns/fast-formula-parser");
+var SPARKLINE = function (parser, dataArg, optionsArg) {
+    if (parser.isPreview) {
+        return;
+    }
+    if (!dataArg) {
+        throw new fast_formula_parser_1.FormulaError("#N/A", "Wrong number of arguments to SPARKLINE. Expected between 1 and 2 arguments, but got 0 arguments.");
+    }
+    // The options literal can arrive in either shape from
+    // fast-formula-parser:
+    //   - row form:  {"k1","v1","k2","v2"}  → [["k1","v1","k2","v2"]]
+    //   - pair form: {"k1","v1";"k2","v2"}  → [["k1","v1"],["k2","v2"]]
+    // `Object.fromEntries` only works correctly for the pair form — for
+    // the row form it iterates the inner array and reads positions 0/1
+    // as the single [key, value] pair, silently dropping everything
+    // else (which is how `color`, `colorHigh`/`colorLow` and the high/
+    // low flags vanish before the renderer sees them). Flatten and walk
+    // in stride 2 so both shapes round-trip every pair.
+    var options = {};
+    if (Array.isArray(optionsArg === null || optionsArg === void 0 ? void 0 : optionsArg.value)) {
+        var flat = optionsArg.value.flat(Infinity);
+        for (var i = 0; i + 1 < flat.length; i += 2) {
+            var key = flat[i];
+            if (key == null)
+                continue;
+            options[String(key)] = flat[i + 1];
+        }
+    }
+    var isNumber = function (item) {
+        return typeof item === "number" && !isNaN(item);
+    };
+    var rawData = Array.isArray(dataArg.value)
+        ? dataArg.value.flat()
+        : [dataArg.value];
+    // Empty-cell handling: when the `emptycells` option is present
+    // (gap/zero/span — Excel's displayEmptyCellsAs) the renderer needs
+    // to know WHERE the empty cells were, so keep them as nulls.
+    // Without the option, compact them out — the legacy shape — so
+    // existing sparklines render byte-identical.
+    var preserveGaps = options.emptycells === "gap" ||
+        options.emptycells === "zero" ||
+        options.emptycells === "span";
+    var data = preserveGaps
+        ? rawData.map(function (item) { return (isNumber(item) ? item : null); })
+        : rawData.filter(isNumber);
+    if (data.filter(isNumber).length < 2) {
+        throw new fast_formula_parser_1.FormulaError("#N/A", "SPARKLINE requires more data points. Expected: 2, found: 0.");
+    }
+    return {
+        kind: "sparkline",
+        data: data,
+        options: options,
+    };
+};
+exports.SPARKLINE = SPARKLINE;

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

@@ -0,0 +1,12 @@
+import type { FunctionArgument } from "@rowsncolumns/calculator";
+import type FormulaParser from "@rowsncolumns/fast-formula-parser";
+/**
+ * SPLIT(text, delimiter, [split_by_each], [remove_empty_text])
+ *
+ * Google Sheets semantics:
+ *  - split_by_each   (default TRUE): treat each character in `delimiter` as a
+ *    separate delimiter; when FALSE, split on the whole delimiter string.
+ *  - remove_empty_text (default TRUE): drop empty results.
+ */
+export declare const SPLIT: (_: FormulaParser, text: FunctionArgument, delimiter: FunctionArgument, splitByEach?: FunctionArgument, removeEmptyText?: FunctionArgument) => string[][];
+//# sourceMappingURL=split.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"split.d.ts","sourceRoot":"","sources":["../../../formulas/split.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,aAAa,MAAM,mCAAmC,CAAC;AAOnE;;;;;;;GAOG;AACH,eAAO,MAAM,KAAK,GAChB,GAAG,aAAa,EAChB,MAAM,gBAAgB,EACtB,WAAW,gBAAgB,EAC3B,cAAc,gBAAgB,EAC9B,kBAAkB,gBAAgB,eAqCnC,CAAC"}

package/dist/cjs/formulas/split.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SPLIT = void 0;
+var fast_formula_parser_1 = require("@rowsncolumns/fast-formula-parser");
+var utils_1 = require("@rowsncolumns/utils");
+/** Escape a character so it is literal inside a regex character class. */
+var escapeForCharClass = function (s) { return s.replace(/[\]\\^-]/g, "\\$&"); };
+/**
+ * SPLIT(text, delimiter, [split_by_each], [remove_empty_text])
+ *
+ * Google Sheets semantics:
+ *  - split_by_each   (default TRUE): treat each character in `delimiter` as a
+ *    separate delimiter; when FALSE, split on the whole delimiter string.
+ *  - remove_empty_text (default TRUE): drop empty results.
+ */
+var SPLIT = function (_, text, delimiter, splitByEach, removeEmptyText) {
+    if (!text || (0, utils_1.isNil)(text.value)) {
+        throw new fast_formula_parser_1.FormulaError("#NA!", "Invalid text");
+    }
+    if (!delimiter || (0, utils_1.isNil)(delimiter.value)) {
+        throw new fast_formula_parser_1.FormulaError("#NA!", "Invalid delimiter");
+    }
+    var textValue = String(text.value);
+    var delim = String(delimiter.value);
+    var byEach = splitByEach && !(0, utils_1.isNil)(splitByEach.value)
+        ? Boolean(splitByEach.value)
+        : true;
+    var removeEmpty = removeEmptyText && !(0, utils_1.isNil)(removeEmptyText.value)
+        ? Boolean(removeEmptyText.value)
+        : true;
+    var parts;
+    if (byEach) {
+        // Split on ANY single character present in `delim`.
+        parts =
+            delim.length === 0
+                ? [textValue]
+                : textValue.split(new RegExp("[".concat(escapeForCharClass(delim), "]")));
+    }
+    else {
+        // Split on the whole delimiter string.
+        parts = delim.length === 0 ? [textValue] : textValue.split(delim);
+    }
+    if (removeEmpty) {
+        parts = parts.filter(function (part) { return part !== ""; });
+    }
+    return [parts];
+};
+exports.SPLIT = SPLIT;

package/dist/cjs/formulas/star-rating.d.ts

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

package/dist/cjs/formulas/star-rating.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"star-rating.d.ts","sourceRoot":"","sources":["../../../formulas/star-rating.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,aAAa,MAAM,mCAAmC,CAAC;AACnE,OAAO,EAEL,gBAAgB,EACjB,MAAM,mCAAmC,CAAC;AAE3C,eAAO,MAAM,UAAU,GACrB,GAAG,aAAa,EAChB,KAAK,gBAAgB,KACpB,gBAOF,CAAC"}

package/dist/cjs/formulas/star-rating.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.STARRATING = void 0;
+var fast_formula_parser_1 = require("@rowsncolumns/fast-formula-parser");
+var STARRATING = function (_, arg) {
+    if (!(arg === null || arg === void 0 ? void 0 : arg.value) || typeof (arg === null || arg === void 0 ? void 0 : arg.value) === "string") {
+        throw new fast_formula_parser_1.FormulaError("#VALUE!", "Required argument not provided");
+    }
+    return {
+        _formulaResult: "=REPT(CHAR(11088),".concat(arg.value, ")"),
+    };
+};
+exports.STARRATING = STARRATING;

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

@@ -0,0 +1,12 @@
+import type { FunctionArgument } from "@rowsncolumns/calculator";
+import type FormulaParser from "@rowsncolumns/fast-formula-parser";
+/**
+ * UNIQUE(range, [by_column], [exactly_once])
+ *
+ * Google Sheets semantics:
+ *  - by_column     (default FALSE): dedupe rows; when TRUE, dedupe columns.
+ *  - exactly_once  (default FALSE): return distinct records; when TRUE, return
+ *    only records that appear exactly once.
+ */
+export declare const UNIQUE: (_: FormulaParser, range: FunctionArgument, byColumnArg?: FunctionArgument, exactlyOnceArg?: FunctionArgument) => import("@rowsncolumns/fast-formula-parser").FormulaResult;
+//# sourceMappingURL=unique.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"unique.d.ts","sourceRoot":"","sources":["../../../formulas/unique.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,aAAa,MAAM,mCAAmC,CAAC;AAgBnE;;;;;;;GAOG;AACH,eAAO,MAAM,MAAM,GACjB,GAAG,aAAa,EAChB,OAAO,gBAAgB,EACvB,cAAc,gBAAgB,EAC9B,iBAAiB,gBAAgB,8DAgDlC,CAAC"}

package/dist/cjs/formulas/unique.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UNIQUE = void 0;
+var tslib_1 = require("tslib");
+var fast_formula_parser_1 = require("@rowsncolumns/fast-formula-parser");
+var utils_1 = require("@rowsncolumns/utils");
+/** Transpose a rectangular 2D array. */
+var transpose = function (matrix) {
+    if (matrix.length === 0)
+        return [];
+    var cols = matrix[0].length;
+    var out = [];
+    var _loop_1 = function (c) {
+        out.push(matrix.map(function (row) { return row[c]; }));
+    };
+    for (var c = 0; c < cols; c++) {
+        _loop_1(c);
+    }
+    return out;
+};
+/**
+ * UNIQUE(range, [by_column], [exactly_once])
+ *
+ * Google Sheets semantics:
+ *  - by_column     (default FALSE): dedupe rows; when TRUE, dedupe columns.
+ *  - exactly_once  (default FALSE): return distinct records; when TRUE, return
+ *    only records that appear exactly once.
+ */
+var UNIQUE = function (_, range, byColumnArg, exactlyOnceArg) {
+    var e_1, _a;
+    var _b;
+    if (!range) {
+        throw new fast_formula_parser_1.FormulaError("#NA!", "Wrong number of arguments to UNIQUE. Expected atleast 1 arguments, but got 0 arguments.");
+    }
+    // If the argument is not a cell or range ref
+    if (!range.isCellRef && !range.isRangeRef) {
+        return range.value;
+    }
+    if (range.isCellRef) {
+        return range.value;
+    }
+    var byColumn = byColumnArg && !(0, utils_1.isNil)(byColumnArg.value)
+        ? Boolean(byColumnArg.value)
+        : false;
+    var exactlyOnce = exactlyOnceArg && !(0, utils_1.isNil)(exactlyOnceArg.value)
+        ? Boolean(exactlyOnceArg.value)
+        : false;
+    var matrix = range.value;
+    // Records are the units we dedupe over: rows by default, columns when
+    // by_column is TRUE (transpose so the dedupe loop is uniform).
+    var records = byColumn ? transpose(matrix) : matrix;
+    var order = [];
+    var countByKey = new Map();
+    var firstByKey = new Map();
+    try {
+        for (var records_1 = tslib_1.__values(records), records_1_1 = records_1.next(); !records_1_1.done; records_1_1 = records_1.next()) {
+            var record = records_1_1.value;
+            var key = JSON.stringify(record);
+            if (!countByKey.has(key)) {
+                order.push(key);
+                firstByKey.set(key, record);
+            }
+            countByKey.set(key, ((_b = countByKey.get(key)) !== null && _b !== void 0 ? _b : 0) + 1);
+        }
+    }
+    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+    finally {
+        try {
+            if (records_1_1 && !records_1_1.done && (_a = records_1.return)) _a.call(records_1);
+        }
+        finally { if (e_1) throw e_1.error; }
+    }
+    var resultRecords = order
+        .filter(function (key) { return (exactlyOnce ? countByKey.get(key) === 1 : true); })
+        .map(function (key) { return firstByKey.get(key); });
+    return byColumn ? transpose(resultRecords) : resultRecords;
+};
+exports.UNIQUE = UNIQUE;

package/dist/cjs/function-descriptions.d.ts

@@ -0,0 +1,3 @@
+import type { CalculatorFunction } from "@rowsncolumns/common-types";
+export declare const functionDescriptions: CalculatorFunction[];
+//# sourceMappingURL=function-descriptions.d.ts.map

package/dist/cjs/function-descriptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"function-descriptions.d.ts","sourceRoot":"","sources":["../../function-descriptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAErE,eAAO,MAAM,oBAAoB,EAAE,kBAAkB,EA23SpD,CAAC"}