@affino/datagrid-formula-engine 0.1.1

package/dist/syntax/functionGroups/logicFunctions.js

@@ -0,0 +1,140 @@
+import { areFormulaValuesEqual, coerceFormulaValueToBoolean, isFormulaErrorValue, isFormulaValueBlank, } from "../values.js";
+import { booleanResult, defaultIfEmpty, defineFormulaFunctions, expandFormulaArgs, expandFormulaValue, formulaValueMatchesCriterion, normalizeTextSearch, } from "../functionHelpers.js";
+export const DATAGRID_LOGIC_FORMULA_FUNCTIONS = defineFormulaFunctions({
+    AND: {
+        arity: { min: 1 },
+        compute: args => booleanResult(args.every(value => coerceFormulaValueToBoolean(value !== null && value !== void 0 ? value : null))),
+    },
+    CONTAINS: {
+        arity: 2,
+        compute: args => {
+            var _a, _b;
+            const needle = normalizeTextSearch((_a = args[0]) !== null && _a !== void 0 ? _a : null);
+            if (needle.length === 0) {
+                return false;
+            }
+            return expandFormulaValue((_b = args[1]) !== null && _b !== void 0 ? _b : null)
+                .some(value => normalizeTextSearch(value).includes(needle));
+        },
+    },
+    HAS: {
+        arity: 2,
+        compute: args => {
+            var _a;
+            return expandFormulaValue((_a = args[0]) !== null && _a !== void 0 ? _a : null)
+                .some(value => { var _a; return areFormulaValuesEqual(value, (_a = args[1]) !== null && _a !== void 0 ? _a : null); });
+        },
+    },
+    IF: {
+        arity: 3,
+        compute: args => { var _a, _b, _c; return (coerceFormulaValueToBoolean((_a = args[0]) !== null && _a !== void 0 ? _a : null) ? (_b = args[1]) !== null && _b !== void 0 ? _b : 0 : (_c = args[2]) !== null && _c !== void 0 ? _c : 0); },
+    },
+    IFERROR: {
+        arity: 2,
+        compute: args => { var _a, _b, _c; return (isFormulaErrorValue((_a = args[0]) !== null && _a !== void 0 ? _a : null) ? (_b = args[1]) !== null && _b !== void 0 ? _b : 0 : (_c = args[0]) !== null && _c !== void 0 ? _c : 0); },
+    },
+    IFS: {
+        arity: { min: 2 },
+        compute: args => {
+            var _a, _b;
+            for (let index = 0; index < args.length; index += 2) {
+                if (coerceFormulaValueToBoolean((_a = args[index]) !== null && _a !== void 0 ? _a : null)) {
+                    return (_b = args[index + 1]) !== null && _b !== void 0 ? _b : 0;
+                }
+            }
+            return 0;
+        },
+    },
+    COALESCE: {
+        arity: { min: 1 },
+        compute: args => {
+            for (const value of args) {
+                if (!isFormulaValueBlank(value !== null && value !== void 0 ? value : null)) {
+                    return value;
+                }
+            }
+            return 0;
+        },
+    },
+    IN: {
+        arity: { min: 2 },
+        compute: args => expandFormulaArgs(args.slice(1)).some(value => { var _a; return areFormulaValuesEqual((_a = args[0]) !== null && _a !== void 0 ? _a : null, value); }) ? 1 : 0,
+    },
+    ISBLANK: {
+        arity: 1,
+        compute: args => { var _a; return isFormulaValueBlank((_a = args[0]) !== null && _a !== void 0 ? _a : null); },
+    },
+    ISBOOLEAN: {
+        arity: 1,
+        compute: args => typeof defaultIfEmpty(args[0], null) === "boolean",
+    },
+    ISDATE: {
+        arity: 1,
+        compute: args => {
+            var _a;
+            const value = (_a = args[0]) !== null && _a !== void 0 ? _a : null;
+            if (Array.isArray(value)) {
+                return value[0] instanceof Date;
+            }
+            return value instanceof Date;
+        },
+    },
+    ISERROR: {
+        arity: 1,
+        compute: args => { var _a; return isFormulaErrorValue((_a = args[0]) !== null && _a !== void 0 ? _a : null); },
+    },
+    ISEVEN: {
+        arity: 1,
+        compute: args => {
+            var _a;
+            const value = Number((_a = args[0]) !== null && _a !== void 0 ? _a : 0);
+            return Number.isInteger(value) && value % 2 === 0;
+        },
+    },
+    ISNUMBER: {
+        arity: 1,
+        compute: args => {
+            var _a;
+            const value = (_a = args[0]) !== null && _a !== void 0 ? _a : null;
+            if (Array.isArray(value)) {
+                return typeof value[0] === "number";
+            }
+            return typeof value === "number";
+        },
+    },
+    ISODD: {
+        arity: 1,
+        compute: args => {
+            var _a;
+            const value = Number((_a = args[0]) !== null && _a !== void 0 ? _a : 0);
+            return Number.isInteger(value) && Math.abs(value % 2) === 1;
+        },
+    },
+    ISTEXT: {
+        arity: 1,
+        compute: args => {
+            var _a;
+            const value = (_a = args[0]) !== null && _a !== void 0 ? _a : null;
+            if (Array.isArray(value)) {
+                return typeof value[0] === "string";
+            }
+            return typeof value === "string";
+        },
+    },
+    NOT: {
+        arity: 1,
+        compute: args => { var _a; return !coerceFormulaValueToBoolean((_a = args[0]) !== null && _a !== void 0 ? _a : null); },
+    },
+    OR: {
+        arity: { min: 1 },
+        compute: args => args.some(value => coerceFormulaValueToBoolean(value !== null && value !== void 0 ? value : null)),
+    },
+    COUNTIF: {
+        arity: 2,
+        compute: args => {
+            var _a;
+            return expandFormulaValue((_a = args[0]) !== null && _a !== void 0 ? _a : null)
+                .filter(value => { var _a; return formulaValueMatchesCriterion(value, (_a = args[1]) !== null && _a !== void 0 ? _a : null); }).length;
+        },
+    },
+});

package/dist/syntax/functionGroups/numericFunctions.d.ts

@@ -0,0 +1,2 @@
+export declare const DATAGRID_NUMERIC_FORMULA_FUNCTIONS: Readonly<Record<string, import("../types.js").DataGridFormulaFunctionDefinition>>;
+//# sourceMappingURL=numericFunctions.d.ts.map

package/dist/syntax/functionGroups/numericFunctions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"numericFunctions.d.ts","sourceRoot":"","sources":["../../../src/syntax/functionGroups/numericFunctions.ts"],"names":[],"mappings":"AA2CA,eAAO,MAAM,kCAAkC,mFAsO7C,CAAA"}

package/dist/syntax/functionGroups/numericFunctions.js

@@ -0,0 +1,268 @@
+import { coerceFormulaValueToNumber, } from "../values.js";
+import { collectValuesFromArgs, computeAverage, computeMedian, computePercentile, computeStdDev, countPresentValues, defineFormulaFunctions, expandFormulaArgs, expandFormulaValue, toNumericFormulaValues, } from "../functionHelpers.js";
+function ceilToMultiple(value, multiple) {
+    if (!Number.isFinite(multiple) || multiple === 0) {
+        return 0;
+    }
+    const significance = Math.abs(multiple);
+    return Math.sign(value || 1) * Math.ceil(Math.abs(value) / significance) * significance;
+}
+function floorToMultiple(value, multiple) {
+    if (!Number.isFinite(multiple) || multiple === 0) {
+        return 0;
+    }
+    const significance = Math.abs(multiple);
+    if (value >= 0) {
+        return Math.floor(value / significance) * significance;
+    }
+    return -Math.floor(Math.abs(value) / significance) * significance;
+}
+function roundToMultiple(value, multiple) {
+    if (!Number.isFinite(multiple) || multiple === 0) {
+        return 0;
+    }
+    const significance = Math.abs(multiple);
+    return Math.round(value / significance) * significance;
+}
+export const DATAGRID_NUMERIC_FORMULA_FUNCTIONS = defineFormulaFunctions({
+    ABS: {
+        arity: 1,
+        compute: args => { var _a; return Math.abs(coerceFormulaValueToNumber((_a = args[0]) !== null && _a !== void 0 ? _a : null)); },
+    },
+    AVG: {
+        compute: args => computeAverage(expandFormulaArgs(args)),
+    },
+    AVERAGE: {
+        compute: args => computeAverage(expandFormulaArgs(args)),
+    },
+    AVGW: {
+        arity: 2,
+        compute: args => {
+            var _a, _b, _c, _d;
+            const values = toNumericFormulaValues(expandFormulaValue((_a = args[0]) !== null && _a !== void 0 ? _a : null));
+            const weights = toNumericFormulaValues(expandFormulaValue((_b = args[1]) !== null && _b !== void 0 ? _b : null));
+            const length = Math.min(values.length, weights.length);
+            if (length === 0) {
+                return 0;
+            }
+            let weightedTotal = 0;
+            let weightTotal = 0;
+            for (let index = 0; index < length; index += 1) {
+                const weight = (_c = weights[index]) !== null && _c !== void 0 ? _c : 0;
+                weightedTotal += ((_d = values[index]) !== null && _d !== void 0 ? _d : 0) * weight;
+                weightTotal += weight;
+            }
+            return weightTotal === 0 ? 0 : weightedTotal / weightTotal;
+        },
+    },
+    CEIL: {
+        arity: { min: 1, max: 2 },
+        compute: args => {
+            var _a, _b;
+            return ceilToMultiple(coerceFormulaValueToNumber((_a = args[0]) !== null && _a !== void 0 ? _a : null), Math.abs(coerceFormulaValueToNumber((_b = args[1]) !== null && _b !== void 0 ? _b : 1)));
+        },
+    },
+    CEILING: {
+        arity: { min: 1, max: 2 },
+        compute: args => {
+            var _a, _b;
+            return ceilToMultiple(coerceFormulaValueToNumber((_a = args[0]) !== null && _a !== void 0 ? _a : null), Math.abs(coerceFormulaValueToNumber((_b = args[1]) !== null && _b !== void 0 ? _b : 1)));
+        },
+    },
+    CHAR: {
+        arity: 1,
+        compute: args => { var _a; return String.fromCharCode(Math.trunc(coerceFormulaValueToNumber((_a = args[0]) !== null && _a !== void 0 ? _a : null))); },
+    },
+    COUNT: {
+        compute: args => countPresentValues(expandFormulaArgs(args)),
+    },
+    COUNTM: {
+        compute: args => countPresentValues(expandFormulaArgs(args)),
+    },
+    DECTOHEX: {
+        arity: 1,
+        compute: args => { var _a; return Math.trunc(coerceFormulaValueToNumber((_a = args[0]) !== null && _a !== void 0 ? _a : null)).toString(16).toUpperCase(); },
+    },
+    FLOOR: {
+        arity: { min: 1, max: 2 },
+        compute: args => {
+            var _a, _b;
+            return floorToMultiple(coerceFormulaValueToNumber((_a = args[0]) !== null && _a !== void 0 ? _a : null), Math.abs(coerceFormulaValueToNumber((_b = args[1]) !== null && _b !== void 0 ? _b : 1)));
+        },
+    },
+    HEXTODEC: {
+        arity: 1,
+        compute: args => {
+            var _a;
+            const raw = String((_a = args[0]) !== null && _a !== void 0 ? _a : "").trim();
+            if (raw.length === 0) {
+                return 0;
+            }
+            const parsed = Number.parseInt(raw, 16);
+            return Number.isFinite(parsed) ? parsed : 0;
+        },
+    },
+    INT: {
+        arity: 1,
+        compute: args => { var _a; return Math.trunc(coerceFormulaValueToNumber((_a = args[0]) !== null && _a !== void 0 ? _a : null)); },
+    },
+    LARGE: {
+        arity: 2,
+        compute: args => {
+            var _a, _b, _c;
+            const values = [...toNumericFormulaValues(expandFormulaValue((_a = args[0]) !== null && _a !== void 0 ? _a : null))].sort((left, right) => right - left);
+            const rank = Math.trunc(coerceFormulaValueToNumber((_b = args[1]) !== null && _b !== void 0 ? _b : null));
+            return rank < 1 || rank > values.length ? 0 : ((_c = values[rank - 1]) !== null && _c !== void 0 ? _c : 0);
+        },
+    },
+    MAX: {
+        compute: args => {
+            const values = toNumericFormulaValues(expandFormulaArgs(args));
+            return values.length === 0 ? 0 : Math.max(...values);
+        },
+    },
+    MEDIAN: {
+        compute: args => computeMedian(expandFormulaArgs(args)),
+    },
+    MIN: {
+        compute: args => {
+            const values = toNumericFormulaValues(expandFormulaArgs(args));
+            return values.length === 0 ? 0 : Math.min(...values);
+        },
+    },
+    MOD: {
+        arity: 2,
+        compute: args => {
+            var _a, _b;
+            const left = coerceFormulaValueToNumber((_a = args[0]) !== null && _a !== void 0 ? _a : null);
+            const right = coerceFormulaValueToNumber((_b = args[1]) !== null && _b !== void 0 ? _b : null);
+            return right === 0 ? 0 : left % right;
+        },
+    },
+    MROUND: {
+        arity: 2,
+        compute: args => {
+            var _a, _b;
+            return roundToMultiple(coerceFormulaValueToNumber((_a = args[0]) !== null && _a !== void 0 ? _a : null), Math.abs(coerceFormulaValueToNumber((_b = args[1]) !== null && _b !== void 0 ? _b : null)));
+        },
+    },
+    NPV: {
+        arity: { min: 2 },
+        compute: args => {
+            var _a;
+            const rate = coerceFormulaValueToNumber((_a = args[0]) !== null && _a !== void 0 ? _a : null);
+            const cashFlows = toNumericFormulaValues(collectValuesFromArgs(args, 1));
+            return cashFlows.reduce((sum, value, index) => sum + (value / ((1 + rate) ** (index + 1))), 0);
+        },
+    },
+    PERCENTILE: {
+        arity: 2,
+        compute: args => {
+            var _a, _b;
+            return computePercentile(expandFormulaValue((_a = args[0]) !== null && _a !== void 0 ? _a : null), coerceFormulaValueToNumber((_b = args[1]) !== null && _b !== void 0 ? _b : null));
+        },
+    },
+    POW: {
+        arity: 2,
+        compute: args => {
+            var _a, _b;
+            return Math.pow(coerceFormulaValueToNumber((_a = args[0]) !== null && _a !== void 0 ? _a : null), coerceFormulaValueToNumber((_b = args[1]) !== null && _b !== void 0 ? _b : null));
+        },
+    },
+    RANKAVG: {
+        arity: { min: 2, max: 3 },
+        compute: args => {
+            var _a, _b, _c;
+            const target = coerceFormulaValueToNumber((_a = args[0]) !== null && _a !== void 0 ? _a : null);
+            const values = [...toNumericFormulaValues(expandFormulaValue((_b = args[1]) !== null && _b !== void 0 ? _b : null))];
+            const descending = coerceFormulaValueToNumber((_c = args[2]) !== null && _c !== void 0 ? _c : 0) !== 1;
+            const sorted = [...values].sort((left, right) => descending ? right - left : left - right);
+            const matchingRanks = sorted
+                .map((value, index) => (value === target ? index + 1 : null))
+                .filter((value) => value !== null);
+            if (matchingRanks.length === 0) {
+                return 0;
+            }
+            return matchingRanks.reduce((sum, value) => sum + value, 0) / matchingRanks.length;
+        },
+    },
+    RANKEQ: {
+        arity: { min: 2, max: 3 },
+        compute: args => {
+            var _a, _b, _c;
+            const target = coerceFormulaValueToNumber((_a = args[0]) !== null && _a !== void 0 ? _a : null);
+            const values = [...toNumericFormulaValues(expandFormulaValue((_b = args[1]) !== null && _b !== void 0 ? _b : null))];
+            const descending = coerceFormulaValueToNumber((_c = args[2]) !== null && _c !== void 0 ? _c : 0) !== 1;
+            const sorted = [...values].sort((left, right) => descending ? right - left : left - right);
+            const rank = sorted.findIndex(value => value === target);
+            return rank < 0 ? 0 : rank + 1;
+        },
+    },
+    ROUND: {
+        arity: { min: 1, max: 2 },
+        compute: args => {
+            var _a, _b;
+            const value = coerceFormulaValueToNumber((_a = args[0]) !== null && _a !== void 0 ? _a : null);
+            const digits = Math.trunc(coerceFormulaValueToNumber((_b = args[1]) !== null && _b !== void 0 ? _b : null));
+            const factor = 10 ** Math.abs(digits);
+            if (digits >= 0) {
+                return Math.round(value * factor) / factor;
+            }
+            return Math.round(value / factor) * factor;
+        },
+    },
+    ROUNDDOWN: {
+        arity: { min: 1, max: 2 },
+        compute: args => {
+            var _a, _b;
+            const value = coerceFormulaValueToNumber((_a = args[0]) !== null && _a !== void 0 ? _a : null);
+            const digits = Math.trunc(coerceFormulaValueToNumber((_b = args[1]) !== null && _b !== void 0 ? _b : null));
+            const factor = 10 ** Math.abs(digits);
+            if (digits >= 0) {
+                return Math.trunc(value * factor) / factor;
+            }
+            return Math.trunc(value / factor) * factor;
+        },
+    },
+    ROUNDUP: {
+        arity: { min: 1, max: 2 },
+        compute: args => {
+            var _a, _b;
+            const value = coerceFormulaValueToNumber((_a = args[0]) !== null && _a !== void 0 ? _a : null);
+            const digits = Math.trunc(coerceFormulaValueToNumber((_b = args[1]) !== null && _b !== void 0 ? _b : null));
+            const factor = 10 ** Math.abs(digits);
+            if (digits >= 0) {
+                return Math.sign(value || 1) * Math.ceil(Math.abs(value) * factor) / factor;
+            }
+            return Math.sign(value || 1) * Math.ceil(Math.abs(value) / factor) * factor;
+        },
+    },
+    SMALL: {
+        arity: 2,
+        compute: args => {
+            var _a, _b, _c;
+            const values = [...toNumericFormulaValues(expandFormulaValue((_a = args[0]) !== null && _a !== void 0 ? _a : null))].sort((left, right) => left - right);
+            const rank = Math.trunc(coerceFormulaValueToNumber((_b = args[1]) !== null && _b !== void 0 ? _b : null));
+            return rank < 1 || rank > values.length ? 0 : ((_c = values[rank - 1]) !== null && _c !== void 0 ? _c : 0);
+        },
+    },
+    STDEVA: {
+        compute: args => computeStdDev(expandFormulaArgs(args), "sample"),
+    },
+    STDEVP: {
+        compute: args => computeStdDev(expandFormulaArgs(args), "population"),
+    },
+    STDEVPA: {
+        compute: args => computeStdDev(expandFormulaArgs(args), "population"),
+    },
+    STDEVS: {
+        compute: args => computeStdDev(expandFormulaArgs(args), "sample"),
+    },
+    SUM: {
+        compute: args => toNumericFormulaValues(expandFormulaArgs(args)).reduce((sum, value) => sum + value, 0),
+    },
+    UNICHAR: {
+        arity: 1,
+        compute: args => { var _a; return String.fromCodePoint(Math.trunc(coerceFormulaValueToNumber((_a = args[0]) !== null && _a !== void 0 ? _a : null))); },
+    },
+});

package/dist/syntax/functionGroups/textFunctions.d.ts

@@ -0,0 +1,2 @@
+export declare const DATAGRID_TEXT_FORMULA_FUNCTIONS: Readonly<Record<string, import("../types.js").DataGridFormulaFunctionDefinition>>;
+//# sourceMappingURL=textFunctions.d.ts.map

package/dist/syntax/functionGroups/textFunctions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"textFunctions.d.ts","sourceRoot":"","sources":["../../../src/syntax/functionGroups/textFunctions.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,+BAA+B,mFA2G1C,CAAA"}

package/dist/syntax/functionGroups/textFunctions.js

@@ -0,0 +1,118 @@
+import { coerceFormulaValueToNumber, } from "../values.js";
+import { defineFormulaFunctions, expandFormulaArgs, stringifyFormulaScalarValue, } from "../functionHelpers.js";
+export const DATAGRID_TEXT_FORMULA_FUNCTIONS = defineFormulaFunctions({
+    CONCAT: {
+        compute: args => expandFormulaArgs(args)
+            .map(value => stringifyFormulaScalarValue(value))
+            .join(""),
+    },
+    FIND: {
+        arity: { min: 2, max: 3 },
+        compute: args => {
+            var _a, _b, _c;
+            const searchFor = String((_a = args[0]) !== null && _a !== void 0 ? _a : "");
+            const text = String((_b = args[1]) !== null && _b !== void 0 ? _b : "");
+            const startPosition = Math.max(1, Math.trunc(coerceFormulaValueToNumber((_c = args[2]) !== null && _c !== void 0 ? _c : 1)));
+            const index = text.indexOf(searchFor, startPosition - 1);
+            return index < 0 ? 0 : index + 1;
+        },
+    },
+    JOIN: {
+        arity: { min: 1, max: 2 },
+        compute: args => {
+            var _a, _b;
+            const delimiter = args.length > 1 ? String((_a = args[1]) !== null && _a !== void 0 ? _a : "") : "";
+            return expandFormulaArgs([(_b = args[0]) !== null && _b !== void 0 ? _b : null]).map(value => stringifyFormulaScalarValue(value)).join(delimiter);
+        },
+    },
+    LEFT: {
+        arity: { min: 1, max: 2 },
+        compute: args => {
+            var _a, _b;
+            const text = String((_a = args[0]) !== null && _a !== void 0 ? _a : "");
+            const count = Math.max(0, Math.trunc(coerceFormulaValueToNumber((_b = args[1]) !== null && _b !== void 0 ? _b : text.length)));
+            return text.slice(0, count);
+        },
+    },
+    LEN: {
+        arity: 1,
+        compute: args => {
+            var _a;
+            const value = (_a = args[0]) !== null && _a !== void 0 ? _a : null;
+            if (Array.isArray(value)) {
+                return value.length;
+            }
+            return stringifyFormulaScalarValue((value !== null && value !== void 0 ? value : null)).length;
+        },
+    },
+    LOWER: {
+        arity: 1,
+        compute: args => { var _a; return String((_a = args[0]) !== null && _a !== void 0 ? _a : "").toLowerCase(); },
+    },
+    MID: {
+        arity: 3,
+        compute: args => {
+            var _a, _b, _c;
+            const text = String((_a = args[0]) !== null && _a !== void 0 ? _a : "");
+            const start = Math.max(1, Math.trunc(coerceFormulaValueToNumber((_b = args[1]) !== null && _b !== void 0 ? _b : 1)));
+            const count = Math.max(0, Math.trunc(coerceFormulaValueToNumber((_c = args[2]) !== null && _c !== void 0 ? _c : 0)));
+            return text.slice(start - 1, start - 1 + count);
+        },
+    },
+    REPLACE: {
+        arity: 4,
+        compute: args => {
+            var _a, _b, _c, _d;
+            const text = String((_a = args[0]) !== null && _a !== void 0 ? _a : "");
+            const start = Math.max(1, Math.trunc(coerceFormulaValueToNumber((_b = args[1]) !== null && _b !== void 0 ? _b : 1)));
+            const count = Math.max(0, Math.trunc(coerceFormulaValueToNumber((_c = args[2]) !== null && _c !== void 0 ? _c : 0)));
+            const nextText = String((_d = args[3]) !== null && _d !== void 0 ? _d : "");
+            return `${text.slice(0, start - 1)}${nextText}${text.slice(start - 1 + count)}`;
+        },
+    },
+    RIGHT: {
+        arity: { min: 1, max: 2 },
+        compute: args => {
+            var _a, _b;
+            const text = String((_a = args[0]) !== null && _a !== void 0 ? _a : "");
+            const count = Math.max(0, Math.trunc(coerceFormulaValueToNumber((_b = args[1]) !== null && _b !== void 0 ? _b : text.length)));
+            return count >= text.length ? text : text.slice(text.length - count);
+        },
+    },
+    SUBSTITUTE: {
+        arity: { min: 3, max: 4 },
+        compute: args => {
+            var _a, _b, _c, _d;
+            const text = String((_a = args[0]) !== null && _a !== void 0 ? _a : "");
+            const oldText = String((_b = args[1]) !== null && _b !== void 0 ? _b : "");
+            const newText = String((_c = args[2]) !== null && _c !== void 0 ? _c : "");
+            const replaceNum = Math.trunc(coerceFormulaValueToNumber((_d = args[3]) !== null && _d !== void 0 ? _d : 0));
+            if (oldText.length === 0) {
+                return text;
+            }
+            if (replaceNum <= 0) {
+                return text.split(oldText).join(newText);
+            }
+            let seen = 0;
+            return text.split(oldText).join("\u0000").split("\u0000").reduce((result, part, index) => {
+                if (index === 0) {
+                    return part;
+                }
+                seen += 1;
+                return `${result}${seen === replaceNum ? newText : oldText}${part}`;
+            }, "");
+        },
+    },
+    TRIM: {
+        arity: 1,
+        compute: args => { var _a; return String((_a = args[0]) !== null && _a !== void 0 ? _a : "").trim(); },
+    },
+    UPPER: {
+        arity: 1,
+        compute: args => { var _a; return String((_a = args[0]) !== null && _a !== void 0 ? _a : "").toUpperCase(); },
+    },
+    VALUE: {
+        arity: 1,
+        compute: args => { var _a; return coerceFormulaValueToNumber((_a = args[0]) !== null && _a !== void 0 ? _a : null); },
+    },
+});

package/dist/syntax/functionHelpers.d.ts

@@ -0,0 +1,45 @@
+import type { DataGridFormulaAstNode, DataGridFormulaFunctionDefinition } from "./types.js";
+import type { DataGridFormulaScalarValue, DataGridFormulaValue } from "../coreTypes.js";
+export type { DataGridFormulaFunctionDefinition, };
+export interface FormulaCriterionEntry {
+    range: readonly DataGridFormulaScalarValue[];
+    criterion: DataGridFormulaValue;
+}
+export declare function normalizeFormulaTableName(value: DataGridFormulaValue): string;
+export declare function coerceFormulaValueToText(value: DataGridFormulaValue): string;
+export declare function createFormulaTableContextKey(tableName: string): string;
+export declare function resolveFormulaLiteralText(node: DataGridFormulaAstNode | undefined): string | null;
+export declare function defineFormulaFunctions(entries: Readonly<Record<string, DataGridFormulaFunctionDefinition>>): Readonly<Record<string, DataGridFormulaFunctionDefinition>>;
+export declare function collectFormulaTableValues(rowsInput: unknown, fieldValue: DataGridFormulaValue | undefined): readonly DataGridFormulaScalarValue[];
+export declare function findFormulaTableRelatedRows(rowsInput: unknown, keyFieldValue: DataGridFormulaValue | undefined, lookupValue: DataGridFormulaValue): readonly unknown[];
+export declare function collectFormulaTableRelatedValues(rowsInput: unknown, keyFieldValue: DataGridFormulaValue | undefined, lookupValue: DataGridFormulaValue, returnFieldValue: DataGridFormulaValue | undefined): readonly DataGridFormulaScalarValue[];
+export declare function expandFormulaValue(value: DataGridFormulaValue): readonly DataGridFormulaScalarValue[];
+export declare function expandFormulaArgs(args: readonly DataGridFormulaValue[]): readonly DataGridFormulaScalarValue[];
+export declare function coerceFormulaValueToDate(value: DataGridFormulaValue): Date | null;
+export declare function stringifyFormulaScalarValue(value: DataGridFormulaScalarValue): string;
+export declare function flattenFormulaValuesToStrings(values: readonly DataGridFormulaValue[]): readonly string[];
+export declare function formulaValueMatchesCriterion(candidate: DataGridFormulaValue, criterion: DataGridFormulaValue): boolean;
+export declare function collectFilteredValues(values: readonly DataGridFormulaScalarValue[], criteria: ReadonlyArray<{
+    range: readonly DataGridFormulaScalarValue[];
+    criterion: DataGridFormulaValue;
+}>): readonly DataGridFormulaScalarValue[];
+export declare function toDistinctFormulaValues(values: readonly DataGridFormulaScalarValue[]): readonly DataGridFormulaScalarValue[];
+export declare function toNumericFormulaValues(values: readonly DataGridFormulaScalarValue[]): readonly number[];
+export declare function toStrictNumericFormulaValues(values: readonly DataGridFormulaScalarValue[]): readonly number[];
+export declare function computeAverage(values: readonly DataGridFormulaScalarValue[]): number;
+export declare function computeMedian(values: readonly DataGridFormulaScalarValue[]): number;
+export declare function computePercentile(values: readonly DataGridFormulaScalarValue[], percentile: number): number;
+export declare function computeStdDev(values: readonly DataGridFormulaScalarValue[], mode: "sample" | "population"): number;
+export declare function isWeekday(date: Date): boolean;
+export declare function normalizeHolidayTimes(values: readonly DataGridFormulaValue[]): ReadonlySet<number>;
+export declare function addCalendarDays(date: Date, days: number): Date;
+export declare function countDaysBetween(start: Date, end: Date, inclusive: boolean): number;
+export declare function countWorkingDays(start: Date, end: Date, holidays: ReadonlySet<number>): number;
+export declare function addWorkingDays(start: Date, days: number, holidays: ReadonlySet<number>): Date;
+export declare function countPresentValues(values: readonly DataGridFormulaScalarValue[]): number;
+export declare function booleanResult(value: boolean): boolean;
+export declare function normalizeTextSearch(value: DataGridFormulaValue): string;
+export declare function collectValuesFromArgs(args: readonly DataGridFormulaValue[], startIndex?: number): readonly DataGridFormulaScalarValue[];
+export declare function defaultIfEmpty<T>(value: T | undefined, fallback: T): T;
+export declare function parseTimeLikeValue(value: DataGridFormulaValue): Date | null;
+//# sourceMappingURL=functionHelpers.d.ts.map

package/dist/syntax/functionHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"functionHelpers.d.ts","sourceRoot":"","sources":["../../src/syntax/functionHelpers.ts"],"names":[],"mappings":"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"}