@trebco/treb 37.0.0 → 37.0.1

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

@@ -0,0 +1,324 @@
+/*
+ * 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';
+export const DAY_MS = 1000 * 60 * 60 * 24;
+export const IsArrayOrTypedArray = (test) => {
+    return Array.isArray(test) || (test instanceof Float64Array) || (test instanceof Float64Array);
+};
+export const Transpose2 = (arr) => {
+    const result = [];
+    const cols = arr.length;
+    const rows = arr[0].length;
+    for (let r = 0; r < rows; r++) {
+        result[r] = [];
+        for (let c = 0; c < cols; c++) {
+            result[r][c] = arr[c][r];
+        }
+    }
+    return result;
+};
+export const TransposeArray = (arr) => {
+    if (!arr)
+        return [];
+    if (typeof arr[0] === 'undefined')
+        return [];
+    /*
+    if (!IsArrayOrTypedArray(arr[0])) {
+      if (arr instanceof Float32Array || arr instanceof Float64Array){
+        return Array.prototype.slice.call(arr).map((x: T) => [x]);
+      }
+      return arr.map((x) => [x]);
+    }
+    */
+    const tmp = [];
+    const cols = arr.length;
+    const rows = arr[0].length;
+    for (let r = 0; r < rows; r++) {
+        tmp[r] = [];
+        for (let c = 0; c < cols; c++) {
+            tmp[r][c] = arr[c][r];
+        }
+    }
+    return tmp;
+};
+export const StringToColumn = (s) => {
+    let index = 0;
+    s = s.toUpperCase();
+    for (let i = 0; i < s.length; i++) {
+        index *= 26;
+        index += (s.charCodeAt(i) - 64);
+    }
+    return index - 1;
+};
+export const ColumnToString = (column) => {
+    // there's some weird case where this hangs, not sure
+    // how that happens. trap it and figure it out.
+    const original = column;
+    let s = '';
+    for (;;) {
+        const c = column % 26;
+        s = String.fromCharCode(65 + c) + s;
+        column = Math.floor(column / 26);
+        if (column)
+            column--;
+        if (column < 0)
+            throw (new Error('Column < 0!, original was ' + original));
+        else
+            break;
+    }
+    return s;
+};
+export const OffsetFormula = (formula, offset) => {
+    const cache = {};
+    formula = formula.replace(/\b([A-Za-z]+)(\d+)\b/g, (m, p1, p2) => {
+        if (!cache[m]) {
+            const c = ColumnToString(StringToColumn(p1) + offset.columns);
+            const r = Number(p2) + offset.rows;
+            cache[m] = c + r.toString();
+        }
+        return cache[m];
+    });
+    return formula;
+};
+/**
+ * assuming boxed (union) arguments, return a flat list of values.
+ * @param args
+ */
+export const FlattenBoxed = (args) => {
+    // let's go back to imperative style for now
+    let result = [];
+    for (const arg of args) {
+        if (arg?.type === ValueType.array) {
+            // possibly recursive
+            for (const row of arg.value) {
+                // what's faster, concatenate or ...push?
+                // result.push(...FlattenBoxed(row));
+                result = result.concat(FlattenBoxed(row));
+            }
+        }
+        else {
+            result.push(arg);
+        }
+    }
+    return result;
+};
+/* *
+ * flatten a set of arguments
+ * UPDATE: we no longer accept the "arguments" object. must be an array.
+ * callers can use rest spread to collect arguments.
+ *
+ * @deprecated - use a better-typed version
+ * /
+export const FlattenCellValues = (args: any[]): any[] => {
+  if (!Array.isArray(args)) { return [args]; } // special case
+  return args.reduce((a: any[], b: any) => {
+    if (typeof b === 'undefined') return a;
+    if (Array.isArray(b)) return a.concat(FlattenCellValues(b));
+    if (b instanceof Float32Array) return a.concat(Array.from(b));
+    if (b instanceof Float64Array) return a.concat(Array.from(b));
+    return a.concat([b]);
+  }, []);
+};
+*/
+/**
+ * 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 const FlattenCellValues = (args, keep_undefined = false) => {
+    if (!Array.isArray(args)) {
+        return [args];
+    } // special case
+    return args.reduce((a, b) => {
+        if (typeof b === 'undefined' && !keep_undefined)
+            return a;
+        if (Array.isArray(b))
+            return a.concat(FlattenCellValues(b, keep_undefined));
+        if (b instanceof Float32Array)
+            return a.concat(Array.from(b));
+        if (b instanceof Float64Array)
+            return a.concat(Array.from(b));
+        return a.concat([b]);
+    }, []);
+};
+/**
+ * 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 const FlattenNumbers = (args) => (FlattenCellValues(args)).filter((value) => typeof value === 'number');
+export const FilterIntrinsics = (data, fill = false) => {
+    if (fill) {
+        return data.map((value => {
+            switch (typeof value) {
+                case 'number':
+                case 'undefined':
+                case 'string':
+                case 'boolean':
+                    return value;
+            }
+            return undefined;
+        }));
+    }
+    return data.filter((value) => {
+        switch (typeof value) {
+            case 'number':
+            case 'undefined':
+            case 'string':
+            case 'boolean':
+                return true;
+        }
+        return false;
+    });
+};
+/*
+
+// anyone using this? (...) removing
+
+export const UndefinedToEmptyString = (args: any[]): any[] => {
+  for (let i = 0; i < args.length; i++) {
+    if (Array.isArray(args[i])) {
+      args[i] = UndefinedToEmptyString(args[i]);
+    }
+    else if (typeof args[i] === 'undefined') {
+      args[i] = '';
+    }
+  }
+  return args;
+};
+*/
+/** type guard. FIXME: move */
+const IsArrayUnion = (value) => {
+    return (!!value && typeof value === 'object' && value.type === ValueType.array);
+};
+/**
+ * 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.
+ *
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export const ApplyArrayX = (map, base) => {
+    return (...args) => {
+        // we need to look at the actual parameters passed, not the signature.
+        // spreadsheet language supports "extra" parameters. we usually just 
+        // repeat the tail parameter, but in this case we will NOT repeat the 
+        // application (why not?)
+        const arrays = [];
+        // the result needs to be the same shape as the input. so we use the 
+        // first array we find to create this map.
+        let shape = [];
+        for (const [i, arg] of args.entries()) {
+            if (arg && map[i]) {
+                const arr = Array.isArray(arg) ? arg : IsArrayUnion(arg) ? arg.value : undefined;
+                if (arr) {
+                    arrays[i] = arr;
+                    if (!shape.length) {
+                        shape = arr;
+                    }
+                }
+            }
+        }
+        if (arrays.length) {
+            // this is pretty, but 3 functional loops? ouch
+            return {
+                type: ValueType.array,
+                value: shape.map((_, i) => _.map((_, j) => {
+                    // this was breaking on boolean false, because 
+                    // it used || instead of ??. if we don't require 
+                    // boxed arguments, we need to handle naked booleans
+                    // actually, this is still slightly wrong. we know (actually the 
+                    // caller of this function knows) if each argument is boxed or not, 
+                    // and if it's not, we should not return the boxed undefined type, 
+                    // we should just return undefined.
+                    // that actually would basically solve false booleans as well, even
+                    // if it were incorrectly returning undefined. the issue is we were
+                    // returning a boxed undefined, which evaluates to true.
+                    const apply = args.map((arg, index) => arrays[index] ? (arrays[index][i][j] ?? { type: ValueType.undefined }) : arg);
+                    return base(...apply);
+                })),
+            };
+        }
+        // scalar case
+        return base(...args);
+    };
+};
+/**
+ * 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 const ParseWildcards = (text) => {
+    const result = [];
+    const length = text.length;
+    const escaped_chars = '[\\^$.|?*+()';
+    for (let i = 0; i < length; i++) {
+        let char = text[i];
+        switch (char) {
+            case '*':
+                result.push('.', '*');
+                break;
+            case '?':
+                result.push('.');
+                break;
+            case '~':
+                char = text[++i] || '';
+            // eslint-disable-next-line no-fallthrough
+            default:
+                for (let j = 0; j < escaped_chars.length; j++) {
+                    if (char === escaped_chars[j]) {
+                        result.push('\\');
+                        break;
+                    }
+                }
+                result.push(char);
+                break;
+        }
+    }
+    return result.join('');
+};
+export const StringUnion = (value) => ({ type: ValueType.string, value });
+export const NumberUnion = (value) => ({ type: ValueType.number, value });
+//# sourceMappingURL=utilities.js.map

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

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

package/build/treb-charts/src/chart-functions.d.ts

@@ -0,0 +1,8 @@
+import type { CompositeFunctionDescriptor } from 'treb-calculator/src/descriptors';
+export type ChartFunction = 'Bar.Chart' | 'Line.Chart' | 'Area.Chart' | 'Column.Chart' | 'Bubble.Chart' | 'Donut.Chart' | 'Pie.Chart' | 'Scatter.Line' | 'Scatter.Plot' | 'Box.Plot';
+type SupportFunction = 'Group' | 'Series';
+/**
+ * chart functions for registration
+ */
+export declare const ChartFunctions: Record<ChartFunction | SupportFunction, CompositeFunctionDescriptor>;
+export {};

package/build/treb-charts/src/chart-functions.js

@@ -0,0 +1,209 @@
+/*
+ * 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';
+/**
+ * function returns its arguments
+ *
+ * UPDATE: box this properly as "extended" type
+ */
+const Identity = (...args) => {
+    return {
+        type: ValueType.object,
+        value: args,
+        key: 'arguments',
+    };
+};
+/**
+ * chart functions for registration
+ */
+export const ChartFunctions = {
+    /* new: also helper */
+    Group: {
+        arguments: [
+            { name: 'Array...', metadata: true, },
+        ],
+        fn: (...args) => {
+            return {
+                type: ValueType.object,
+                value: args,
+                key: 'group',
+            };
+        },
+        category: ['grouping'],
+    },
+    /**
+     * UPDATE: adding explicit names to Series, for convention. Use the
+     * more general "group" if you just want to group things.
+     *
+     * boxing properly as "extended" type
+     *
+     * this is getting too specific to bubble charts, which have a lot
+     * of requirements that other charts don't have. can we split?
+     *
+     */
+    Series: {
+        arguments: [
+            { name: 'Label' }, // , metadata: true, },
+            { name: 'X', metadata: true, },
+            { name: 'Y', metadata: true, },
+            { name: 'Z', metadata: true, },
+            { name: 'Index', },
+            { name: 'Subtype', },
+            { name: 'Labels', description: 'Labels for bubble charts only (atm)' },
+            { name: 'Axis', description: `Series axis (scatter plot only)` },
+        ],
+        fn: (...args) => {
+            return {
+                type: ValueType.object,
+                value: {
+                    label: args[0],
+                    x: args[1],
+                    y: args[2],
+                    z: args[3],
+                    index: args[4],
+                    subtype: args[5],
+                    data_labels: args[6],
+                    axis: args[7],
+                },
+                key: 'series',
+            };
+        },
+        category: ['chart functions'],
+    },
+    /*
+    'Scatter.Series': {
+      arguments: [
+        { name: 'Label' }, // , metadata: true, },
+        { name: 'X', metadata: true, },
+        { name: 'Y', metadata: true, },
+        { name: 'index', },
+        { name: 'subtype', },
+        { name: 'axis', },
+      ],
+      fn: (...args: unknown[]) => {
+        return {
+          type: ValueType.object,
+          value: {
+            label: args[0],
+            x: args[1],
+            y: args[2],
+            index: args[3],
+            subtype: args[4],
+            axis: args[5],
+          },
+          key: 'series',
+        };
+      },
+    },
+    */
+    'Bar.Chart': {
+        arguments: [
+            { name: 'Data', metadata: true, },
+            { name: 'Categories', metadata: true, },
+            { name: 'ChartTitle' },
+        ],
+        fn: Identity,
+        category: ['chart functions'],
+    },
+    'Line.Chart': {
+        arguments: [
+            { name: 'y', metadata: true, },
+            { name: 'x', metadata: true, },
+            { name: 'ChartTitle' },
+        ],
+        fn: Identity,
+        category: ['chart functions'],
+    },
+    'Area.Chart': {
+        arguments: [
+            { name: 'y', metadata: true, },
+            { name: 'x', metadata: true, },
+            { name: 'ChartTitle' },
+        ],
+        fn: Identity,
+        category: ['chart functions'],
+    },
+    'Pie.Chart': {
+        arguments: [
+            { name: 'Values', metadata: true, },
+            { name: 'Labels' },
+            { name: 'Title' },
+            { name: 'Sort' },
+            { name: 'Label' },
+        ],
+        fn: Identity,
+        category: ['chart functions'],
+    },
+    'Donut.Chart': {
+        arguments: [
+            { name: 'Values', metadata: true, },
+            { name: 'Labels', metadata: true },
+            { name: 'Title' },
+            { name: 'Sort' },
+            { name: 'Label' },
+        ],
+        fn: Identity,
+        category: ['chart functions'],
+    },
+    'Scatter.Line': {
+        arguments: [
+            { name: 'Data', metadata: true, },
+            { name: 'ChartTitle' },
+        ],
+        fn: Identity,
+        category: ['chart functions'],
+    },
+    'Scatter.Plot': {
+        arguments: [
+            { name: 'Data', metadata: true, },
+            { name: 'ChartTitle' },
+        ],
+        fn: Identity,
+        category: ['chart functions'],
+    },
+    'Column.Chart': {
+        arguments: [
+            { name: 'Data', metadata: true, },
+            { name: 'Categories', metadata: true, },
+            { name: 'Chart Title' },
+        ],
+        fn: Identity,
+        category: ['chart functions'],
+    },
+    'Bubble.Chart': {
+        arguments: [
+            { name: 'Data', metadata: true, },
+            { name: 'Chart Title' },
+        ],
+        fn: Identity,
+        category: ['chart functions'],
+    },
+    'Box.Plot': {
+        arguments: [
+            { name: 'Data', metadata: true, },
+            { name: 'Chart Title' },
+            { name: 'Min/Max Style' }
+        ],
+        fn: Identity,
+        category: ['chart functions'],
+    },
+};
+//# sourceMappingURL=chart-functions.js.map

package/build/treb-charts/src/chart-functions.js.map

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