@trebco/treb 32.13.2 → 36.1.2

package/treb-calculator/src/calculator.ts

@@ -14,7 +14,7 @@
  * 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-2025 trebco, llc. 
+ * Copyright 2022-2026 trebco, llc. 
  * info@treb.app
  * 
  */
@@ -36,7 +36,7 @@ import * as Utilities from './utilities';
 import { StringUnion } from './utilities';
 
 import { FunctionLibrary } from './function-library';
-import type { FunctionMap } from './descriptors';
+import type { ExtendedFunctionDescriptor, FunctionMap } from './descriptors';
 // import * as Utils from './utilities';
 
 import { AltFunctionLibrary, BaseFunctionLibrary } from './functions/base-functions';
@@ -148,6 +148,9 @@ export interface CalculatorOptions {
   /** enable spill arrays */
   spill?: boolean;
 
+  /** helpful flag for resource initialization */
+  headless?: boolean;
+
 }
 
 const default_calculator_options: CalculatorOptions = {
@@ -192,6 +195,8 @@ export class Calculator extends Graph {
 
   protected options: CalculatorOptions;
 
+  protected async_resource_init = false;
+
   /**
    * this is a flag we're using to communicate back to the embedded
    * sheet, when the grid has expanded as a result of a calculation 
@@ -1271,6 +1276,24 @@ export class Calculator extends Graph {
 
   }
 
+  /** 
+   * new async init method. we need this for subclasses, but 
+   * we should consider moving base methods in here as well.
+   * 
+   * this function must be idempotent, so we can call it from
+   * multiple paths
+   */
+  public async InitResources() {
+    if (this.async_resource_init) {
+      // console.info("init resources noop");
+      return;
+    }
+
+    // console.info("init resources (async)");
+
+    this.async_resource_init = true;
+  }
+
   /**
    * support for co-editing. we need to export calculated values from
    * the leader instance, because things like RAND() and NOW() are 
@@ -3158,30 +3181,126 @@ export class Calculator extends Graph {
 
       if (parse_result.expression) {
 
-        // FIXME: move macro function parsing here; so that we don't
-        // need special call semantics, and dependencies work as normal.
+        // some functions have UI - render and/or click. we want to attach
+        // those to the cell. this is complicated in the case of lambdas.
+
+        // case 1: library function. check directly.
+        // case 2: inline lambda. check the last parameter.
+        // case 3: indirect lambda (implicit-call), also
+        // case 4: named lambda: resolve, then handle like a lambda.
+
+        // AND NOTE, these could be nested... ?
+
+        // case 5: this is _not_ a pass through situation: an explicit call 
+        //         to lambda, which just defines a function.
+
+        let descriptor: ExtendedFunctionDescriptor|undefined;
+        let base: ExpressionUnit|undefined = parse_result.expression;
+
+        if (base?.type === 'implicit-call') {
 
-        // NOTE: the problem with that is you have to deep-parse every function,
-        // here, to look for macros. that might be OK, but the alternative is
-        // just to calculate them on demand, which seems a lot more efficient
+          // if this is a function, it's easy
 
-        // TEMP removing old macro handling
-        // const modified = this.ApplyMacroFunctions(parse_result.expression);
-        // if (modified) { parse_result.expression = modified; }
+          if (base.call.type === 'call') {
+            base = base.call;
+          }
+          else { // else if (base.call.type === 'address') {
+           
+            // if this is an address, we'll have to resolve it...
+            // I don't _think_ we need to handle any other types here 
+            // TODO/FIXME
+
+          }
+        }
+        else if (base?.type === 'call' ){
+
+          // handle case 5. top-level call, but indirect. this is the 
+          // case for lambdas defined in cell functions but not _called_
+
+          descriptor = this.library.Get(base.name);
+          if (descriptor?.pass_through_ui === 'indirect') {
+            base = undefined;
+          }
+
+        }
 
-        // ...
+        while (base?.type === 'call') {
 
+          descriptor = this.library.Get(base.name);
+          if (descriptor) {
+            if (descriptor.pass_through_ui && base.args.length) {
+              base = base.args[base.args.length - 1];
+            }
+            else {
+              break;
+            }
+          }
+          else {
+            const named = this.model.GetName(base.name, address.sheet_id);
+            if (named?.type === 'expression') {
+              base = named.expression;
+            }
+            else {
+              break;
+            }
+          }
+        }
+
+        if (descriptor) {
+          cell.render_function = descriptor.render;
+          cell.click_function = descriptor.click;
+        }
+
+        /*
         if (parse_result.expression.type === 'call') {
-          const func = this.library.Get(parse_result.expression.name);
 
-          // this is for sparklines and checkboxes atm
+          descriptor = this.library.Get(parse_result.expression.name);
+          if (!descriptor) {
+            const named = this.model.GetName(parse_result.expression.name, address.sheet_id);
+            if (named?.type === 'expression' && named.expression.type === 'call') {
+              descriptor = this.library.Get(named.expression.name);
+              console.info("D", descriptor);
+            }
+          }
+
+          if (descriptor) {
+            cell.render_function = descriptor.render;
+            cell.click_function = descriptor.click;
+          }
+
+        }
+        */
+
+        /*
+        if (parse_result.expression.type === 'call') {
+          const func = this.library.Get(parse_result.expression.name);
+          if (func) {
 
-          if (func && (func.render || func.click)) {
             cell.render_function = func.render;
             cell.click_function = func.click;
+
+            if (func.pass_through_ui) {
+              // ...
+            }
+
           }
+          else {
+            const named = this.model.GetName(parse_result.expression.name, address.sheet_id);
+            if (named?.type === 'expression') {
+              if (named.expression.type === 'call') {
+                const func = this.library.Get(named.expression.name);
+                if (func?.pass_through_ui && named.expression.args.length) {
+
+                  // check the _last_ argument
+                  const last = named.expression.args[named.expression.args.length - 1];
+                  console.info({last});
 
+                }
+              }
+            }
+          }
         }
+        */
 
         const dependencies = this.RebuildDependencies(parse_result.expression, address.sheet_id, '', undefined, address); // cell.sheet_id);
 

package/treb-calculator/src/complex-math.ts

@@ -14,7 +14,7 @@
  * 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-2025 trebco, llc. 
+ * Copyright 2022-2026 trebco, llc. 
  * info@treb.app
  * 
  */

package/treb-calculator/src/dag/array-vertex.ts

@@ -14,7 +14,7 @@
  * 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-2025 trebco, llc. 
+ * Copyright 2022-2026 trebco, llc. 
  * info@treb.app
  * 
  */

package/treb-calculator/src/dag/calculation_leaf_vertex.ts

@@ -14,7 +14,7 @@
  * 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-2025 trebco, llc. 
+ * Copyright 2022-2026 trebco, llc. 
  * info@treb.app
  * 
  */

package/treb-calculator/src/dag/graph.ts

@@ -14,7 +14,7 @@
  * 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-2025 trebco, llc. 
+ * Copyright 2022-2026 trebco, llc. 
  * info@treb.app
  * 
  */

package/treb-calculator/src/dag/spreadsheet_vertex.ts

@@ -14,7 +14,7 @@
  * 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-2025 trebco, llc. 
+ * Copyright 2022-2026 trebco, llc. 
  * info@treb.app
  * 
  */

package/treb-calculator/src/dag/spreadsheet_vertex_base.ts

@@ -14,7 +14,7 @@
  * 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-2025 trebco, llc. 
+ * Copyright 2022-2026 trebco, llc. 
  * info@treb.app
  * 
  */

package/treb-calculator/src/dag/state_leaf_vertex.ts

@@ -14,7 +14,7 @@
  * 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-2025 trebco, llc. 
+ * Copyright 2022-2026 trebco, llc. 
  * info@treb.app
  * 
  */

package/treb-calculator/src/dag/vertex.ts

@@ -14,7 +14,7 @@
  * 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-2025 trebco, llc. 
+ * Copyright 2022-2026 trebco, llc. 
  * info@treb.app
  * 
  */

package/treb-calculator/src/descriptors.ts

@@ -14,7 +14,7 @@
  * 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-2025 trebco, llc. 
+ * Copyright 2022-2026 trebco, llc. 
  * info@treb.app
  * 
  */
@@ -217,6 +217,14 @@ export interface CompositeFunctionDescriptor {
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
   export?: (...args: any[]) => string;
 
+  /**
+   * pass through UI functions, if possible. this is for lambda and let; we
+   * want to pass through sparklines, if a sparkline is the first function call
+   * 
+   * @internal
+   */
+  pass_through_ui?: 'direct' | 'indirect';
+
   /**
    * flag indicating we've unrolled this function. it's possible functions
    * will run through the registration process more than once and we don't

package/treb-calculator/src/expression-calculator.ts

@@ -14,7 +14,7 @@
  * 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-2025 trebco, llc. 
+ * Copyright 2022-2026 trebco, llc. 
  * info@treb.app
  * 
  */

package/treb-calculator/src/function-error.ts

@@ -14,7 +14,7 @@
  * 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-2025 trebco, llc. 
+ * Copyright 2022-2026 trebco, llc. 
  * info@treb.app
  * 
  */

package/treb-calculator/src/function-library.ts

@@ -14,7 +14,7 @@
  * 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-2025 trebco, llc. 
+ * Copyright 2022-2026 trebco, llc. 
  * info@treb.app
  * 
  */

package/treb-calculator/src/functions/base-functions.ts

@@ -14,7 +14,7 @@
  * 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-2025 trebco, llc. 
+ * Copyright 2022-2026 trebco, llc. 
  * info@treb.app
  * 
  */
@@ -2295,7 +2295,11 @@ export const BaseFunctionLibrary: FunctionMap = {
     },
 
     Product: {
-      arguments: [{boxed: true}],
+      arguments: [{
+        boxed: true,
+        name: 'values or ranges' ,
+        repeat: true,
+      }],
       fn: (...args: UnionValue[]): UnionValue => {
 
         let product: Complex = { real: 1, imaginary: 0 };
@@ -2371,6 +2375,8 @@ export const BaseFunctionLibrary: FunctionMap = {
         unroll: true, 
       } ],
 
+      xlfn: true,
+
       fn: (a: number, significance = 1, mode?: number) => {
 
         let value = 0;
@@ -2701,7 +2707,7 @@ export const BaseFunctionLibrary: FunctionMap = {
         return { handled: true }; // painted
       },
       fn: (...args: unknown[]): UnionValue => {
-        return { type: ValueType.object, value: args, key: 'sparkline-data' };
+        return { type: ValueType.object, value: args, key: 'sparkline-data', source: 'sparkline.column' };
       },
     },
 
@@ -2716,7 +2722,7 @@ export const BaseFunctionLibrary: FunctionMap = {
         return { handled: true }; // painted
       },
       fn: (...args: unknown[]): UnionValue => {
-        return { type: ValueType.object, value: args, key: 'sparkline-data' };
+        return { type: ValueType.object, value: args, key: 'sparkline-data', source: 'sparkline.line' };
       },
     },
 

package/treb-calculator/src/functions/beta.ts

@@ -14,7 +14,7 @@
  * 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-2025 trebco, llc. 
+ * Copyright 2022-2026 trebco, llc. 
  * info@treb.app
  * 
  */

package/treb-calculator/src/functions/checkbox.ts

@@ -14,7 +14,7 @@
  * 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-2025 trebco, llc. 
+ * Copyright 2022-2026 trebco, llc. 
  * info@treb.app
  * 
  */

package/treb-calculator/src/functions/complex-functions.ts

@@ -14,7 +14,7 @@
  * 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-2025 trebco, llc. 
+ * Copyright 2022-2026 trebco, llc. 
  * info@treb.app
  * 
  */

package/treb-calculator/src/functions/date-utils.ts

@@ -14,7 +14,7 @@
  * 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-2025 trebco, llc. 
+ * Copyright 2022-2026 trebco, llc. 
  * info@treb.app
  * 
  */

package/treb-calculator/src/functions/finance-functions.ts

@@ -14,7 +14,7 @@
  * 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-2025 trebco, llc. 
+ * Copyright 2022-2026 trebco, llc. 
  * info@treb.app
  * 
  */
@@ -24,8 +24,6 @@ import { type CellValue, type UnionValue, ValueType } from 'treb-base-types';
 import { FlattenCellValues } from '../utilities';
 
 import { ArgumentError, ValueError } from '../function-error';
-import { LotusDate, UnlotusDate } from 'treb-format';
-import { ConstructDate, DaysInYear } from './date-utils';
 
 // use a single, static object for base functions
 
@@ -158,7 +156,7 @@ export const FinanceFunctionLibrary: FunctionMap = {
     description: 'Returns the present value of a series of future cashflows',
     arguments: [
       { name: 'Rate' },
-      { name: 'Cashflow' },
+      { name: 'Cashflow', repeat: true },
     ],
     fn: (rate = 0, ...args: CellValue[]): UnionValue => {
 

package/treb-calculator/src/functions/fp.ts

@@ -14,7 +14,7 @@
  * 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-2025 trebco, llc. 
+ * Copyright 2022-2026 trebco, llc. 
  * info@treb.app
  * 
  */

package/treb-calculator/src/functions/function-utilities.ts

@@ -14,7 +14,7 @@
  * 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-2025 trebco, llc. 
+ * Copyright 2022-2026 trebco, llc. 
  * info@treb.app
  * 
  */

package/treb-calculator/src/functions/gamma.ts

@@ -14,7 +14,7 @@
  * 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-2025 trebco, llc. 
+ * Copyright 2022-2026 trebco, llc. 
  * info@treb.app
  * 
  */

package/treb-calculator/src/functions/information-functions.ts

@@ -14,7 +14,7 @@
  * 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-2025 trebco, llc. 
+ * Copyright 2022-2026 trebco, llc. 
  * info@treb.app
  * 
  */

package/treb-calculator/src/functions/lambda-functions.ts

@@ -14,7 +14,7 @@
  * 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-2025 trebco, llc. 
+ * Copyright 2022-2026 trebco, llc. 
  * info@treb.app
  * 
  */
@@ -37,6 +37,9 @@ export const LambdaFunctionLibrary: FunctionMap = {
       { name: 'Function', boxed: true, passthrough: true },
     ],
 
+    // pass through render/click functions
+    pass_through_ui: 'indirect',
+
     fn: (...args: ExpressionUnit[]) => {
       return {
         type: ValueType.function, 

package/treb-calculator/src/functions/matrix-functions.ts

@@ -14,7 +14,7 @@
  * 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-2025 trebco, llc. 
+ * Copyright 2022-2026 trebco, llc. 
  * info@treb.app
  * 
  */

package/treb-calculator/src/functions/normal.ts

@@ -15,7 +15,7 @@
  * 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-2025 trebco, llc. 
+ * Copyright 2022-2026 trebco, llc. 
  * info@treb.app
  * 
  */

package/treb-calculator/src/functions/regex-functions.ts

@@ -14,7 +14,7 @@
  * 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-2025 trebco, llc. 
+ * Copyright 2022-2026 trebco, llc. 
  * info@treb.app
  * 
  */
@@ -49,7 +49,7 @@ export const RegexFunctionLibrary: FunctionMap = {
 
       }
     ],
-    fn: (text: string, pattern: string, return_mode = 0, icase = false) => {
+    fn: (source_text, pattern = '', return_mode = 0, icase = false) => {
 
       const args: string[] = [];
       if (icase) {
@@ -59,7 +59,16 @@ export const RegexFunctionLibrary: FunctionMap = {
         args.push('g');
       }
 
-      const rex = new RegExp(pattern, args.length ? args.join('') : undefined);
+      const text = String(source_text ?? '');
+
+      let rex: RegExp|undefined;
+
+      try {
+        rex = new RegExp(pattern, args.length ? args.join('') : undefined);
+      }
+      catch {
+        return ArgumentError();
+      }
 
       switch (return_mode) {
         case 0:
@@ -151,7 +160,7 @@ export const RegexFunctionLibrary: FunctionMap = {
       if (occurrence === 0) {
         return {
           type: ValueType.string,
-          value: (text as any).replaceAll(rex, replacement), // huh?
+          value: text.replaceAll(rex, replacement), // huh?
         };
       }
 

package/treb-calculator/src/functions/sparkline.ts

@@ -14,7 +14,7 @@
  * 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-2025 trebco, llc. 
+ * Copyright 2022-2026 trebco, llc. 
  * info@treb.app
  * 
  */

package/treb-calculator/src/functions/statistics-functions.ts

@@ -14,7 +14,7 @@
  * 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-2025 trebco, llc. 
+ * Copyright 2022-2026 trebco, llc. 
  * info@treb.app
  * 
  */

package/treb-calculator/src/functions/students-t.ts

@@ -14,7 +14,7 @@
  * 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-2025 trebco, llc. 
+ * Copyright 2022-2026 trebco, llc. 
  * info@treb.app
  * 
  */

package/treb-calculator/src/functions/text-functions.ts

@@ -14,7 +14,7 @@
  * 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-2025 trebco, llc. 
+ * Copyright 2022-2026 trebco, llc. 
  * info@treb.app
  * 
  */
@@ -333,6 +333,10 @@ export const TextFunctionLibrary: FunctionMap = {
  /** canonical should be CONCAT; concatenate can be an alias */
  Concat: {
   description: 'Pastes strings together',
+  arguments: [{
+    name: 'text',
+    repeat: true,
+  }],
   fn: (...args: CellValue[]): UnionValue => {
 
     const values = Utils.FlattenCellValues(args);

package/treb-calculator/src/index.ts

@@ -14,7 +14,7 @@
  * 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-2025 trebco, llc. 
+ * Copyright 2022-2026 trebco, llc. 
  * info@treb.app
  * 
  */

package/treb-calculator/src/notifier-types.ts

@@ -14,7 +14,7 @@
  * 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-2025 trebco, llc. 
+ * Copyright 2022-2026 trebco, llc. 
  * info@treb.app
  * 
  */

package/treb-calculator/src/primitives.ts

@@ -14,7 +14,7 @@
  * 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-2025 trebco, llc. 
+ * Copyright 2022-2026 trebco, llc. 
  * info@treb.app
  * 
  */