@trebco/treb 37.0.0 → 37.1.0

package/build/treb-calculator/src/primitives.js

@@ -0,0 +1,398 @@
+/*
+ * This file is part of TREB.
+ *
+ * TREB is free software: you can redistribute it and/or modify it under the
+ * terms of the GNU General Public License as published by the Free Software
+ * Foundation, either version 3 of the License, or (at your option) any
+ * later version.
+ *
+ * TREB is distributed in the hope that it will be useful, but WITHOUT ANY
+ * WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+ * FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
+ * details.
+ *
+ * You should have received a copy of the GNU General Public License along
+ * with TREB. If not, see <https://www.gnu.org/licenses/>.
+ *
+ * Copyright 2022-2026 trebco, llc.
+ * info@treb.app
+ *
+ */
+import { ValueType } from 'treb-base-types';
+import { DivideByZeroError, ValueError } from './function-error';
+import * as ComplexLib from './complex-math';
+/**
+ * a is either a complex union value or undefined. if it's defined,
+ * return it. if it's undefined, return a complex number with the given
+ * real value.
+ */
+const EnsureComplex = (a, real = 0) => {
+    if (a && a.type === ValueType.complex) {
+        return a;
+    }
+    return {
+        type: ValueType.complex,
+        value: {
+            real,
+            imaginary: 0,
+        },
+    };
+};
+/**
+ * return a complex number or, if there's no imaginary component, reduce it to a real
+ */
+const BoxComplex = (value) => {
+    return value.imaginary ?
+        { type: ValueType.complex, value } :
+        { type: ValueType.number, value: value.real };
+};
+const NumericTypes = (a, b) => {
+    if (a.type === ValueType.error) {
+        return [0, 0, a];
+    }
+    if (b.type === ValueType.error) {
+        return [0, 0, b];
+    }
+    const result = [0, 0];
+    // FIXME: what about empty string? should === 0?
+    switch (a.type) {
+        case ValueType.number:
+            result[0] = a.value;
+            break;
+        case ValueType.boolean:
+            result[0] = a.value ? 1 : 0;
+            break;
+        case ValueType.undefined:
+            break;
+        case ValueType.complex:
+            result[3] = a;
+            break;
+        default:
+            return [0, 0, ValueError()]; // FIXME
+    }
+    switch (b.type) {
+        case ValueType.number:
+            result[1] = b.value;
+            break;
+        case ValueType.boolean:
+            result[1] = b.value ? 1 : 0;
+            break;
+        case ValueType.undefined:
+            break;
+        case ValueType.complex:
+            result[4] = b;
+            break;
+        default:
+            return [0, 0, ValueError()]; // FIXME
+    }
+    // if we have one complex value, ensure we have two, so
+    // we don't have to test again.
+    if (result[3] || result[4]) {
+        result[3] = EnsureComplex(result[3], result[0]);
+        result[4] = EnsureComplex(result[4], result[1]);
+    }
+    return result;
+};
+export const Add = (a, b) => {
+    const [x, y, z, c1, c2] = NumericTypes(a, b);
+    if (z) {
+        return z;
+    }
+    if (c1 && c2) {
+        return BoxComplex({
+            real: c1.value.real + c2.value.real,
+            imaginary: c1.value.imaginary + c2.value.imaginary,
+        });
+    }
+    return { value: x + y, type: ValueType.number };
+};
+export const Subtract = (a, b) => {
+    const [x, y, z, c1, c2] = NumericTypes(a, b);
+    if (z) {
+        return z;
+    }
+    if (c1 && c2) {
+        return BoxComplex({
+            real: c1.value.real - c2.value.real,
+            imaginary: c1.value.imaginary - c2.value.imaginary,
+        });
+    }
+    return { value: x - y, type: ValueType.number };
+};
+/**
+ * power function that only uses complex numbers if one of
+ * the arguments is complex. this is intended to prevent complex
+ * numbers from leaking in to spreadsheets.
+ */
+const PowerGated = (a, b) => {
+    const [x, y, z, c1, c2] = NumericTypes(a, b);
+    if (z) {
+        return z;
+    }
+    if (c1 && c2) {
+        return BoxComplex(ComplexLib.Power(c1.value, c2.value));
+    }
+    const value = Math.pow(x, y);
+    if (isNaN(value)) {
+        return ValueError();
+    }
+    return { type: ValueType.number, value };
+};
+/**
+ * power function that uses complex exponentiation if one of the arguments
+ * is complex, or if the exponent is < 1.
+ */
+const PowerComplex = (a, b) => {
+    const [x, y, z, c1, c2] = NumericTypes(a, b);
+    if (z) {
+        return z;
+    }
+    // if one argument is complex, we will always get both as complex.
+    // so we don't need to re-test. for the same reason if exponent 
+    // is < 1 we will have to convert both.
+    if (c1 && c2) {
+        return BoxComplex(ComplexLib.Power(c1.value, c2.value));
+    }
+    if (x < 0 && y !== 0 && Math.abs(y) < 1) {
+        return BoxComplex(ComplexLib.Power({ real: x, imaginary: 0 }, { real: y, imaginary: 0 }));
+    }
+    const value = Math.pow(x, y);
+    if (isNaN(value)) {
+        return ValueError();
+    }
+    return { type: ValueType.number, value };
+};
+/*
+export const Power = (a: UnionValue, b: UnionValue): UnionValue => {
+  const [x, y, z, c1, c2] = NumericTypes(a, b);
+  if (z) { return z; }
+
+  if (c1 && c2) {
+    return BoxComplex(ComplexLib.Power(c1.value, c2.value));
+  }
+
+  const value = Math.pow(x, y);
+  if (isNaN(value)) { return ValueError(); }
+
+  return { type: ValueType.number, value };
+  
+};
+*/
+let Power = PowerGated;
+export const Multiply = (a, b) => {
+    const [x, y, z, c1, c2] = NumericTypes(a, b);
+    if (z) {
+        return z;
+    }
+    if (c1 && c2) {
+        return BoxComplex(ComplexLib.Multiply(c1.value, c2.value));
+    }
+    return { value: x * y, type: ValueType.number };
+};
+export const Divide = (a, b) => {
+    const [x, y, z, c1, c2] = NumericTypes(a, b);
+    if (z) {
+        return z;
+    }
+    if (c1 && c2) {
+        if (c2.value.real === 0 && c2.value.imaginary === 0) {
+            return DivideByZeroError();
+        }
+        return BoxComplex(ComplexLib.Divide(c1.value, c2.value));
+    }
+    if (y === 0) {
+        return DivideByZeroError();
+    }
+    return { value: x / y, type: ValueType.number };
+};
+export const Modulo = (a, b) => {
+    const [x, y, z] = NumericTypes(a, b);
+    if (z) {
+        return z;
+    }
+    if (y === 0) {
+        return DivideByZeroError();
+    }
+    return { value: x % y, type: ValueType.number };
+};
+/*
+export const Concatenate = (a: UnionValue, b: UnionValue): UnionValue => {
+  if (a.type === ValueType.error) { return a; }
+  if (b.type === ValueType.error) { return b; }
+
+  return {
+    type: ValueType.string,
+    value: `${a.type === ValueType.undefined ? '' : a.value}${b.type === ValueType.undefined ? '' : b.value}`,
+  };
+
+};
+*/
+export const Equals = (a, b) => {
+    if (a.type === ValueType.error) {
+        return a;
+    }
+    if (b.type === ValueType.error) {
+        return b;
+    }
+    // empty cells equal 0 (real or complex) and ""
+    if ((a.type === ValueType.undefined && (b.value === '' || b.value === 0 || (b.type === ValueType.complex && b.value.real === 0 && b.value.imaginary === 0)))
+        || (b.type === ValueType.undefined && (a.value === '' || a.value === 0 || (a.type === ValueType.complex && a.value.real === 0 && a.value.imaginary === 0)))) {
+        return { type: ValueType.boolean, value: true, };
+    }
+    if (a.type === ValueType.complex) {
+        if (b.type === ValueType.complex) {
+            return { type: ValueType.boolean, value: ((a.value.imaginary === b.value.imaginary) && (a.value.real === b.value.real)) };
+        }
+        else {
+            return { type: ValueType.boolean, value: ((!a.value.imaginary) && (a.value.real === b.value)) };
+        }
+    }
+    else if (b.type === ValueType.complex) {
+        return { type: ValueType.boolean, value: ((!b.value.imaginary) && (a.value === b.value.real)) };
+    }
+    // this is standard (icase) string equality. we might also need
+    // to handle wildcard string matching, although it's not the 
+    // default case for = operators.
+    if (a.type === ValueType.string && b.type === ValueType.string) {
+        return {
+            type: ValueType.boolean,
+            value: a.value.toLowerCase() === b.value.toLowerCase(),
+        };
+    }
+    return { type: ValueType.boolean, value: a.value == b.value }; // note ==
+};
+export const NotEquals = (a, b) => {
+    const result = Equals(a, b);
+    if (result.type === ValueType.error) {
+        return result;
+    }
+    return {
+        type: ValueType.boolean,
+        value: !result.value,
+    };
+};
+/* *
+ * this is duplicative, but it seems better than another function call.
+ * not sure if that is over-optimization (it is).
+ * /
+export const NotEquals = (a: UnionValue, b: UnionValue): UnionValue => {
+  if (a.type === ValueType.error) { return a; }
+  if (b.type === ValueType.error) { return b; }
+  
+  // empty cells equal 0 and ""
+  // FIXME: should also equal a complex with 0+0i
+
+  if ((a.type === ValueType.undefined && (b.value === '' || b.value === 0))
+      || (b.type === ValueType.undefined && (a.value === '' || a.value === 0))) {
+
+    return { type: ValueType.boolean, value: false, };
+  }
+
+  if (a.type === ValueType.complex || b.type === ValueType.complex) {
+    return {
+      type: ValueType.boolean,
+      value: !((a.type === b.type) &&
+        a.value.real == b.value.real &&          // ==
+        a.value.imaginary == b.value.imaginary)  // ==
+    };
+
+  }
+
+  return { type: ValueType.boolean, value: a.value != b.value }; // note ==
+};
+*/
+// NOTE: our comparisons don't match Excel with different types -- we could
+// probably figure out what Excel is doing, but I'm not sure it's useful or
+// worthwhile
+export const GreaterThan = (a, b) => {
+    if (a.type === ValueType.error) {
+        return a;
+    }
+    if (b.type === ValueType.error) {
+        return b;
+    }
+    if (a.type === ValueType.complex || b.type === ValueType.complex) {
+        return ValueError();
+    }
+    return { type: ValueType.boolean, value: (a.value || 0) > (b.value || 0) };
+};
+const Comparable = (a, b) => {
+    if (a.type === ValueType.complex ||
+        a.type === ValueType.array ||
+        a.type === ValueType.dimensioned_quantity ||
+        a.type === ValueType.object ||
+        b.type === ValueType.complex ||
+        b.type === ValueType.array ||
+        b.type === ValueType.dimensioned_quantity ||
+        b.type === ValueType.object) {
+        return false;
+    }
+    return true;
+};
+export const GreaterThanEqual = (a, b) => {
+    if (a.type === ValueType.error) {
+        return a;
+    }
+    if (b.type === ValueType.error) {
+        return b;
+    }
+    if (!Comparable(a, b)) {
+        return ValueError();
+    }
+    return { type: ValueType.boolean, value: (a.value || 0) >= (b.value || 0) };
+};
+export const LessThan = (a, b) => {
+    if (a.type === ValueType.error) {
+        return a;
+    }
+    if (b.type === ValueType.error) {
+        return b;
+    }
+    if (!Comparable(a, b)) {
+        return ValueError();
+    }
+    //if (a.type === ValueType.complex || b.type === ValueType.complex) {
+    //  return ValueError();
+    //}
+    return { type: ValueType.boolean, value: (a.value || 0) < (b.value || 0) };
+};
+export const LessThanEqual = (a, b) => {
+    if (a.type === ValueType.error) {
+        return a;
+    }
+    if (b.type === ValueType.error) {
+        return b;
+    }
+    //if (a.type === ValueType.complex || b.type === ValueType.complex) {
+    //  return ValueError();
+    //}
+    if (!Comparable(a, b)) {
+        return ValueError();
+    }
+    return { type: ValueType.boolean, value: (a.value || 0) <= (b.value || 0) };
+};
+export const UseComplex = () => {
+    Power = PowerComplex;
+};
+export const MapOperator = (operator) => {
+    switch (operator) {
+        // case '&': return Concatenate;
+        case '+': return Add;
+        case '-': return Subtract;
+        case '*': return Multiply;
+        case '/': return Divide;
+        case '^': return Power;
+        case '**': return Power;
+        case '%': return Modulo; // NOTE: not an excel operator
+        case '=': return Equals;
+        case '==': return Equals;
+        case '!=': return NotEquals;
+        case '<>': return NotEquals;
+        case '>': return GreaterThan;
+        case '>=': return GreaterThanEqual;
+        case '<': return LessThan;
+        case '<=': return LessThanEqual;
+    }
+    return undefined;
+};
+//# sourceMappingURL=primitives.js.map

package/build/treb-calculator/src/primitives.js.map

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

package/build/treb-calculator/src/utilities.d.ts

@@ -0,0 +1,68 @@
+import type { CellValue, UnionValue } from 'treb-base-types';
+export declare const DAY_MS: number;
+export declare const IsArrayOrTypedArray: (test: unknown) => boolean;
+export declare const Transpose2: <T>(arr: T[][]) => T[][];
+export declare const TransposeArray: <T>(arr: T[][]) => T[][];
+export declare const StringToColumn: (s: string) => number;
+export declare const ColumnToString: (column: number) => string;
+export declare const OffsetFormula: (formula: string, offset: {
+    columns: number;
+    rows: number;
+}) => string;
+/**
+ * assuming boxed (union) arguments, return a flat list of values.
+ * @param args
+ */
+export declare const FlattenBoxed: (args: UnionValue[]) => UnionValue[];
+/**
+ * specialization using the CellValue type. this should be preferable
+ * to using any, although we're still kind of hacking at it. also we
+ * need to allow typed arrays (I think we've mostly gotten those out?)
+ */
+export declare const FlattenCellValues: (args: (CellValue | CellValue[] | CellValue[][] | Float32Array | Float64Array)[], keep_undefined?: boolean) => CellValue[];
+/**
+ * flatten cell values, and filter out any non-numbers. this version does
+ * not account for booleans (you might want TRUE = 1). we do this a lot so
+ * combining the two operations seems like a useful place to reuse code.
+ */
+export declare const FlattenNumbers: (args: Parameters<typeof FlattenCellValues>[0]) => number[];
+export declare const FilterIntrinsics: (data: unknown[], fill?: boolean) => (string | number | boolean | undefined)[];
+/**
+ * this is an attempt at a generalized array application wrapper
+ * for functions. the rules are the same -- we apply functions pairwise
+ * (or tuple-wise), not combinatorially.
+ *
+ * we could simplify a bit if we require that functions used boxed
+ * values. we should do that anyway, and be consistent across functions.
+ * also we could get the `any`s out.
+ *
+ * (swapping param order, so we don't have hanging param after inline
+ * function definition -- shades of window.setTimeout)
+ *
+ * @param map - a list of parameters, by index, that can be unrolled. this
+ * allows us to support both out-of-order application and functions that take
+ * mixes of scalars and arrays.
+ *
+ * @param base - the underlying function. for any parameters that can
+ * be applied/unrolled, it should take a scalar.
+ *
+ */
+export declare const ApplyArrayX: <TFunc extends (...args: any[]) => UnionValue>(map: boolean[], base: TFunc) => (...args: Parameters<TFunc>) => UnionValue;
+/**
+ * parse a string with wildcards into a regex pattern
+ *
+ * from
+ * https://exceljet.net/glossary/wildcard
+ *
+ * Excel has 3 wildcards you can use in your formulas:
+ *
+ * Asterisk (*) - zero or more characters
+ * Question mark (?) - any one character
+ * Tilde (~) - escape for literal character (~*) a literal question mark (~?), or a literal tilde (~~)
+ *
+ * they're pretty liberal with escaping, nothing is an error, just roll with it
+ *
+ */
+export declare const ParseWildcards: (text: string) => string;
+export declare const StringUnion: (value: string) => UnionValue;
+export declare const NumberUnion: (value: number) => UnionValue;