@gridsheet/core 3.0.0-rc.10

package/dist/formula/functions/__base.js

@@ -0,0 +1,265 @@
+import { Spilling as g } from "../../sentinels.js";
+import { FormulaError as p } from "../formula-error.js";
+import { stripSheet as $ } from "../solver.js";
+import { hasDeepPending as S, createPropagatedPending as A, buildAsyncCacheKey as C, getAsyncCache as I, asyncCacheMiss as P, awaitAndSave as q, hasPendingArg as D } from "./__async.js";
+import { Time as E } from "../../lib/time.js";
+const u = (r) => (r == null ? void 0 : r.__gsType) === "Sheet", z = {
+  name: "condition",
+  description: 'The condition to evaluate. Use "=" for equal, "<" for less than, ">" for greater than, "<=" for less than or equal, ">=" for greater than or equal, "<>" for not equal.',
+  acceptedTypes: ["any"]
+}, N = (r, { nullable: t = !0, errorTolerant: o = !1, acceptedTypes: s }) => {
+  if (!s || s.length === 0)
+    return !0;
+  if (r == null)
+    return t;
+  if (p.is(r) || r instanceof Error) {
+    if (o)
+      return !0;
+    throw r;
+  }
+  for (const e of s)
+    switch (e) {
+      case "any":
+        return !0;
+      case "number":
+        if (typeof r == "number")
+          return !0;
+        break;
+      case "string":
+        if (typeof r == "string")
+          return !0;
+        break;
+      case "boolean":
+        if (typeof r == "boolean")
+          return !0;
+        break;
+      case "date":
+        if (r instanceof Date)
+          return !0;
+        break;
+      case "time":
+        if (E.is(r))
+          return !0;
+        break;
+      case "matrix":
+        if (b(r))
+          return !0;
+        break;
+      case "reference":
+        if (u(r))
+          return !0;
+        break;
+    }
+  return !1;
+}, b = (r) => u(r) || g.is(r) || Array.isArray(r) && Array.isArray(r[0]), j = (r, t) => {
+  var e;
+  if (!b(r))
+    return r;
+  if (u(r))
+    return $({ value: r, raise: !1, at: t });
+  const o = g.is(r) ? r.matrix : r;
+  return (e = o == null ? void 0 : o[0]) == null ? void 0 : e[0];
+}, T = (r) => {
+  if (u(r))
+    return !r.hasSingleCell;
+  if (g.is(r)) {
+    const t = r.matrix;
+    return t.length > 1 || t.length === 1 && t[0].length > 1;
+  }
+  return Array.isArray(r) && Array.isArray(r[0]) ? r.length > 1 || r[0].length > 1 : !1;
+}, k = (r, t) => {
+  const o = [];
+  let s = -1, e = 0;
+  for (let i = 0; i < r.length; i++)
+    r[i].variadic && (s < 0 && (s = i), e++);
+  for (let i = 0; i < t; i++)
+    if (s >= 0 && i >= s) {
+      const h = (i - s) % e;
+      o.push(s + h);
+    } else i < r.length ? o.push(i) : o.push(r.length - 1);
+  return o;
+}, w = class w {
+  constructor({ args: t, sheet: o, at: s }) {
+    this.defs = [], this.description = "", this.category = "other", this.isAsync = !1, this.hashPrecision = 1, this.useInflight = !0, this.broadcastDisabled = !1, this.autoSpilling = !1, this.eachMatrix = (e, i) => {
+      if (u(e)) {
+        const h = e.solve({ at: this.at, raise: !0 });
+        for (let n = 0; n < h.length; n++)
+          for (let c = 0; c < h[n].length; c++)
+            i(h[n][c]);
+      } else if (g.is(e)) {
+        const h = e.matrix;
+        for (let n = 0; n < h.length; n++)
+          for (let c = 0; c < h[n].length; c++)
+            i(h[n][c]);
+      } else if (Array.isArray(e) && Array.isArray(e[0]))
+        for (let h = 0; h < e.length; h++)
+          for (let n = 0; n < e[h].length; n++)
+            i(e[h][n]);
+      else
+        i(e);
+    }, this.args = t.map((e) => {
+      try {
+        return e.evaluate({ sheet: o });
+      } catch (i) {
+        return i;
+      }
+    }), this.sheet = o, this.at = s ?? "?";
+  }
+  _main(...t) {
+    return this.autoSpilling ? new g(this.main(...t)) : this.main(...t);
+  }
+  /**
+   * Validate and normalise arguments before `main()` is called.
+   *
+   * Checks:
+   * 1. Argument count satisfies defs (respecting optional / variadic).
+   * 2. Each argument's runtime type matches the corresponding def's `type` list.
+   *
+   * Subclasses may override for additional coercion / spreading.
+   */
+  validate(t) {
+    const o = [...t], s = this.defs;
+    if (s.length === 0) {
+      if (t.length !== 0)
+        throw new p("#N/A", "Too many arguments: expected 0, got " + t.length + ".");
+      return o;
+    }
+    let e = 0, i = !1;
+    for (const n of s)
+      n.variadic && (i = !0), n.optional || e++;
+    if (t.length < e)
+      throw new p("#N/A", `Too few arguments: expected at least ${e}, got ${t.length}.`);
+    if (!i && t.length > s.length)
+      throw new p("#N/A", `Too many arguments: expected at most ${s.length}, got ${t.length}.`);
+    const h = k(s, t.length);
+    for (let n = 0; n < t.length; n++) {
+      const c = s[h[n]];
+      if (!c)
+        continue;
+      let a = t[n];
+      if (!(!c.acceptedTypes || c.acceptedTypes.length === 0)) {
+        if (T(a)) {
+          if (!c.takesMatrix)
+            continue;
+        } else b(a) && (c.takesMatrix || (a = j(a, this.at)));
+        if (!N(a, c))
+          throw new p(
+            "#VALUE!",
+            `Argument "${c.name}" (position ${n + 1}) expected ${c.acceptedTypes.join(" | ")}, got ${typeof a}.`
+          );
+        o[n] = a;
+      }
+    }
+    return o;
+  }
+  /**
+   * Extract a 2D array from a matrix value (Spilling, Sheet, or nested array).
+   * Default behavior for Sheet is value.solve(). Functions like COL can override
+   * this to preserve Sheet metadata per cell.
+   */
+  toMatrix(t) {
+    return g.is(t) ? t.matrix : u(t) ? t.solve({ at: this.at }) : Array.isArray(t) && Array.isArray(t[0]) ? t : [[t]];
+  }
+  /**
+   * Collapse a 1×1 matrix value (Sheet, Spilling, or 2D array) to a scalar.
+   * Non-matrix values pass through unchanged.
+   *
+   * Override in sub-classes that need the original Sheet / reference
+   * metadata (e.g. COL, ROW) — for instance, to extract position
+   * information before collapsing.
+   */
+  toScalar(t) {
+    var o, s, e;
+    if (u(t)) {
+      const { rows: i, cols: h } = t.shape;
+      return i === 1 && h === 1 ? t.strip({}) : t;
+    }
+    return g.is(t) ? (s = (o = t.matrix) == null ? void 0 : o[0]) == null ? void 0 : s[0] : Array.isArray(t) ? Array.isArray(t[0]) ? (e = t[0]) == null ? void 0 : e[0] : t[0] : t;
+  }
+  call() {
+    const t = this.broadcast();
+    if (t !== void 0)
+      return t;
+    if (S(this.args, this.at))
+      return A();
+    if (this.args = this.validate(this.args), this.isAsync) {
+      const o = C(this.constructor.name, this.args, this.hashPrecision), s = I(this.sheet, this.at, o, this.useInflight);
+      if (s !== P)
+        return s;
+      const e = this._main(...this.args);
+      return q(e, this.sheet, this.at, o, this.ttlMilliseconds, this.useInflight);
+    }
+    return this._main(...this.args);
+  }
+  /**
+   * If any broadcastable argument is a matrix (multi-cell), expand the call
+   * across all element positions and return a Spilling.
+   * Returns `undefined` when no broadcast is necessary.
+   *
+   * Rules:
+   * - broadcastDisabled = true → never broadcast
+   * - An arg is broadcastable when its corresponding args[].takesMatrix is not true
+   * - A Sheet/Spilling/2D-array whose size is (1,1) is treated as a scalar
+   *   (not broadcast); only multi-cell matrices trigger broadcast
+   * - For variadic args, extra args are assigned round-robin
+   *   across the variadic helpArg positions
+   */
+  broadcast() {
+    if (this.broadcastDisabled)
+      return;
+    const t = k(this.defs, this.args.length), o = this.args.map((a, f) => {
+      var d;
+      const l = t[f];
+      return !((d = this.defs[l]) != null && d.takesMatrix);
+    }), s = this.args.map((a, f) => o[f] && T(a) ? this.toMatrix(a) : null);
+    if (s.every((a) => a === null))
+      return;
+    const e = this.args.map((a, f) => s[f] !== null ? a : this.toScalar(a));
+    let i = 1, h = 1;
+    for (const a of s)
+      a && (i = Math.max(i, a.length), h = Math.max(
+        h,
+        a.reduce((f, l) => Math.max(f, l.length), 0)
+      ));
+    const n = this.args, c = [];
+    for (let a = 0; a < i; a++) {
+      const f = [];
+      for (let l = 0; l < h; l++) {
+        const d = e.map((m, _) => {
+          var M;
+          const y = s[_];
+          return y ? ((M = y == null ? void 0 : y[a]) == null ? void 0 : M[l]) ?? null : m;
+        });
+        try {
+          if (D(d))
+            f.push(A());
+          else {
+            const m = this.validate(d);
+            S(m, this.at) ? f.push(A()) : f.push(this._main(...m));
+          }
+        } catch (m) {
+          f.push(m);
+        }
+      }
+      c.push(f);
+    }
+    return this.args = n, c;
+  }
+};
+w.__name = "";
+let x = w;
+class B extends x {
+  constructor() {
+    super(...arguments), this.isAsync = !0;
+  }
+}
+export {
+  x as BaseFunction,
+  B as BaseFunctionAsync,
+  z as conditionArg,
+  b as isMatrix,
+  T as isMultiCell,
+  u as isSheet,
+  j as stripMatrix
+};
+//# sourceMappingURL=__base.js.map

package/dist/formula/functions/__base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"__base.js","sources":["../../../src/formula/functions/__base.ts"],"sourcesContent":["import { type Sheet } from '../../lib/sheet';\n\n/** Duck-type check for Sheet instances (avoids runtime import cycle). */\nexport const isSheet = (v: any): v is Sheet => v?.__gsType === 'Sheet';\n/** Duck-type check for Time instances (avoids runtime import cycle). */\nconst isTime = (v: any): boolean => v != null && v.__gsType === 'Time';\nimport { Spilling } from '../../sentinels';\nimport type { Id } from '../../types';\nimport { FormulaError } from '../formula-error';\nimport { stripSheet } from '../../formula/solver';\nimport type { Expression } from '../evaluator';\nimport {\n  hasPendingArg,\n  hasDeepPending,\n  buildAsyncCacheKey,\n  awaitAndSave,\n  createPropagatedPending,\n  getAsyncCache,\n  asyncCacheMiss,\n} from './__async';\nimport { Time } from '../../lib/time';\n\nexport type FunctionCategory =\n  | 'math'\n  | 'statistics'\n  | 'text'\n  | 'time'\n  | 'lookup'\n  | 'information'\n  | 'finance'\n  | 'engineering'\n  | 'logical'\n  | 'other';\n\nexport type FunctionProps = {\n  args: Expression[];\n  sheet: Sheet;\n  at?: Id;\n};\n\nexport type FunctionArgumentType = 'number' | 'string' | 'boolean' | 'date' | 'time' | 'matrix' | 'reference' | 'any';\n\nexport type FunctionArgumentDefinition = {\n  name: string;\n  description: string;\n  // if true, this argument can be omitted (i.e. fewer args than defs.length is allowed)\n  optional?: boolean;\n  // If true, blank will be treated as 0 for numbers, \"\" for strings, etc. Default: true\n  nullable?: boolean;\n  variadic?: boolean;\n\n  errorTolerant?: boolean;\n  acceptedTypes?: FunctionArgumentType[];\n  /** When true, this argument takes a range/matrix value — broadcasting is suppressed for it. */\n  takesMatrix?: boolean;\n};\n\nexport const conditionArg: FunctionArgumentDefinition = {\n  name: 'condition',\n  description:\n    'The condition to evaluate. Use \"=\" for equal, \"<\" for less than, \">\" for greater than, \"<=\" for less than or equal, \">=\" for greater than or equal, \"<>\" for not equal.',\n  acceptedTypes: ['any'],\n};\n\n/**\n * Check whether a value matches one of the allowed type names\n * from a FunctionArgumentDefinition.acceptedTypes array.\n */\nconst matchesType = (\n  value: any,\n  { nullable = true, errorTolerant = false, acceptedTypes }: FunctionArgumentDefinition,\n): boolean => {\n  if (!acceptedTypes || acceptedTypes.length === 0) {\n    return true;\n  }\n  if (value == null) {\n    return nullable;\n  }\n  if (FormulaError.is(value) || value instanceof Error) {\n    if (errorTolerant) {\n      return true;\n    }\n    throw value;\n  }\n  for (const t of acceptedTypes) {\n    switch (t) {\n      case 'any':\n        return true;\n      case 'number':\n        if (typeof value === 'number') {\n          return true;\n        }\n        break;\n      case 'string':\n        if (typeof value === 'string') {\n          return true;\n        }\n        break;\n      case 'boolean':\n        if (typeof value === 'boolean') {\n          return true;\n        }\n        break;\n      case 'date':\n        if (value instanceof Date) {\n          return true;\n        }\n        break;\n      case 'time':\n        if (Time.is(value)) {\n          return true;\n        }\n        break;\n      case 'matrix':\n        if (isMatrix(value)) {\n          return true;\n        }\n        break;\n      case 'reference':\n        if (isSheet(value)) {\n          return true;\n        }\n        break;\n    }\n  }\n  return false;\n};\n\n/**\n * Check if a value is a \"matrix\" (Sheet, Spilling, or 2D array).\n */\nexport const isMatrix = (value: any): boolean => {\n  return isSheet(value) || Spilling.is(value) || (Array.isArray(value) && Array.isArray(value[0]));\n};\n\n/**\n * Extract the scalar from a 1×1 matrix (Sheet, Spilling, or plain 2D array).\n * Returns the value unchanged if it is not a matrix.\n */\nexport const stripMatrix = (value: any, at: Id): any => {\n  if (!isMatrix(value)) {\n    return value;\n  }\n  if (isSheet(value)) {\n    return stripSheet({ value, raise: false, at });\n  }\n  const m: any[][] = Spilling.is(value) ? value.matrix : value;\n  let val = m?.[0]?.[0];\n  return val;\n};\n\n/**\n * Check if a value is a matrix that is larger than 1×1.\n */\nexport const isMultiCell = (value: any): boolean => {\n  if (isSheet(value)) {\n    return !value.hasSingleCell;\n  }\n  if (Spilling.is(value)) {\n    const m = value.matrix;\n    return m.length > 1 || (m.length === 1 && m[0].length > 1);\n  }\n  if (Array.isArray(value) && Array.isArray(value[0])) {\n    return value.length > 1 || value[0].length > 1;\n  }\n  return false;\n};\n\n/**\n * Resolve which FunctionArgumentDefinition index each args position maps to,\n * accounting for variadic args at the tail.\n *\n * Example: args = [A, B(variadic), C(variadic)], args has 7 elements\n *   positions 0 → A, 1 → B, 2 → C, 3 → B, 4 → C, 5 → B, 6 → C\n */\nconst resolveParamIndex = (defs: FunctionArgumentDefinition[], argCount: number): number[] => {\n  const indices: number[] = [];\n\n  // Find the first variadic arg position\n  let iterStart = -1;\n  let iterCount = 0;\n  for (let i = 0; i < defs.length; i++) {\n    if (defs[i].variadic) {\n      if (iterStart < 0) {\n        iterStart = i;\n      }\n      iterCount++;\n    }\n  }\n\n  for (let i = 0; i < argCount; i++) {\n    if (iterStart >= 0 && i >= iterStart) {\n      // Map extra args round-robin across variadic args\n      const j = (i - iterStart) % iterCount;\n      indices.push(iterStart + j);\n    } else if (i < defs.length) {\n      indices.push(i);\n    } else {\n      // Beyond defs and no variadic — fall back to last def\n      indices.push(defs.length - 1);\n    }\n  }\n  return indices;\n};\n\nexport class BaseFunction {\n  public defs: FunctionArgumentDefinition[] = [];\n  public example: string | undefined;\n  public description = '';\n  public category: FunctionCategory = 'other';\n  /** Indicates if this function is async. Override in subclass or use BaseFunctionAsync. */\n  protected isAsync: boolean = false;\n  /** Cache TTL in milliseconds. Override in subclass to set expiry. undefined = never expires. */\n  protected ttlMilliseconds?: number;\n  /** Hash precision for cache key generation. Higher values reduce collision risk. Default: 1 */\n  protected hashPrecision: number = 1;\n  /** If true, reuse the same in-flight promise for matching cache keys across different cells. */\n  protected useInflight: boolean = true;\n  /** If true, broadcasting is unconditionally disabled for this function. */\n  protected broadcastDisabled: boolean = false;\n  protected args: any[];\n  protected autoSpilling: boolean = false;\n  public sheet: Sheet;\n  public at: Id;\n  static __name = '';\n\n  constructor({ args, sheet, at }: FunctionProps) {\n    this.args = args.map((a) => {\n      try {\n        return a.evaluate({ sheet });\n      } catch (e) {\n        return e;\n      }\n    });\n    this.sheet = sheet;\n    this.at = at ?? '?';\n  }\n\n  private _main(...args: any[]): any {\n    if (this.autoSpilling) {\n      // @ts-expect-error main is not defined in BaseFunction\n      return new Spilling(this.main(...args));\n    }\n    // @ts-expect-error main is not defined in BaseFunction\n    return this.main(...args);\n  }\n\n  /**\n   * Validate and normalise arguments before `main()` is called.\n   *\n   * Checks:\n   * 1. Argument count satisfies defs (respecting optional / variadic).\n   * 2. Each argument's runtime type matches the corresponding def's `type` list.\n   *\n   * Subclasses may override for additional coercion / spreading.\n   */\n  protected validate(args: any[]): any[] {\n    const validatedArgs = [...args];\n\n    const defs = this.defs;\n    if (defs.length === 0) {\n      if (args.length !== 0) {\n        throw new FormulaError('#N/A', 'Too many arguments: expected 0, got ' + args.length + '.');\n      }\n      return validatedArgs;\n    }\n\n    // --- argument count check ---\n    // minArgs: count of defs that are neither optional nor variadic,\n    //          plus non-optional variadic defs (need at least one instance each).\n    let minArgs = 0;\n    let hasIterable = false;\n    let variadicCount = 0;\n    for (const d of defs) {\n      if (d.variadic) {\n        hasIterable = true;\n        variadicCount++;\n        if (!d.optional) {\n          minArgs++;\n        }\n      } else if (!d.optional) {\n        minArgs++;\n      }\n    }\n\n    if (args.length < minArgs) {\n      throw new FormulaError('#N/A', `Too few arguments: expected at least ${minArgs}, got ${args.length}.`);\n    }\n\n    // maxArgs: if no variadic defs, max = defs.length\n    if (!hasIterable && args.length > defs.length) {\n      throw new FormulaError('#N/A', `Too many arguments: expected at most ${defs.length}, got ${args.length}.`);\n    }\n\n    // --- per-argument type check ---\n    const indices = resolveParamIndex(defs, args.length);\n    for (let i = 0; i < args.length; i++) {\n      const def = defs[indices[i]];\n      if (!def) {\n        continue;\n      }\n      let value = args[i];\n      if (!def.acceptedTypes || def.acceptedTypes.length === 0) {\n        continue;\n      }\n\n      if (isMultiCell(value)) {\n        if (!def.takesMatrix) {\n          continue;\n        }\n      } else if (isMatrix(value)) {\n        // For 1x1 Sheet, Spilling, or plain 2D array, extract the single value for validation.\n        // UNLESS the definition explicitly takes a matrix (e.g. SUM(A1) — let it pass through).\n        if (!def.takesMatrix) {\n          value = stripMatrix(value, this.at);\n        }\n      }\n      if (!matchesType(value, def)) {\n        throw new FormulaError(\n          '#VALUE!',\n          `Argument \"${def.name}\" (position ${i + 1}) expected ${def.acceptedTypes.join(' | ')}, got ${typeof value}.`,\n        );\n      }\n      validatedArgs[i] = value;\n    }\n    return validatedArgs;\n  }\n\n  eachMatrix = (value: any, callback: (v: any) => void) => {\n    if (isSheet(value)) {\n      const matrix = value.solve({ at: this.at, raise: true });\n      for (let r = 0; r < matrix.length; r++) {\n        for (let c = 0; c < matrix[r].length; c++) {\n          callback(matrix[r][c]);\n        }\n      }\n    } else if (Spilling.is(value)) {\n      const matrix = value.matrix;\n      for (let r = 0; r < matrix.length; r++) {\n        for (let c = 0; c < matrix[r].length; c++) {\n          callback(matrix[r][c]);\n        }\n      }\n    } else if (Array.isArray(value) && Array.isArray(value[0])) {\n      for (let r = 0; r < value.length; r++) {\n        for (let c = 0; c < value[r].length; c++) {\n          callback(value[r][c]);\n        }\n      }\n    } else {\n      callback(value);\n    }\n  };\n\n  /**\n   * Extract a 2D array from a matrix value (Spilling, Sheet, or nested array).\n   * Default behavior for Sheet is value.solve(). Functions like COL can override\n   * this to preserve Sheet metadata per cell.\n   */\n  protected toMatrix(value: any): any[][] {\n    if (Spilling.is(value)) {\n      return value.matrix;\n    }\n    if (isSheet(value)) {\n      return value.solve({ at: this.at });\n    }\n    if (Array.isArray(value) && Array.isArray(value[0])) {\n      return value;\n    }\n    return [[value]];\n  }\n\n  /**\n   * Collapse a 1×1 matrix value (Sheet, Spilling, or 2D array) to a scalar.\n   * Non-matrix values pass through unchanged.\n   *\n   * Override in sub-classes that need the original Sheet / reference\n   * metadata (e.g. COL, ROW) — for instance, to extract position\n   * information before collapsing.\n   */\n  protected toScalar(value: any): any {\n    if (isSheet(value)) {\n      const { rows, cols } = value.shape;\n      if (rows === 1 && cols === 1) {\n        return value.strip({});\n      }\n      return value;\n    }\n    if (Spilling.is(value)) {\n      return value.matrix?.[0]?.[0];\n    }\n    if (Array.isArray(value)) {\n      if (Array.isArray(value[0])) {\n        return value[0]?.[0];\n      }\n      return value[0];\n    }\n    return value;\n  }\n\n  public call() {\n    // Broadcast BEFORE validate, because validate may strip Tables to scalars.\n    // broadcast only activates when there are 2+ args and at least one\n    // broadcastable arg is a multi-cell matrix.\n    const broadcastResult = this.broadcast();\n    if (broadcastResult !== undefined) {\n      return broadcastResult;\n    }\n\n    // If any argument is still pending, propagate before validate runs\n    // (Pending values would fail type checks in validate).\n    if (hasDeepPending(this.args, this.at)) {\n      return createPropagatedPending();\n    }\n\n    this.args = this.validate(this.args);\n\n    // For async functions, build cache key and check cache before execution\n    if (this.isAsync) {\n      const key = buildAsyncCacheKey(this.constructor.name, this.args, this.hashPrecision);\n      const cached = getAsyncCache(this.sheet, this.at, key, this.useInflight);\n      if (cached !== asyncCacheMiss) {\n        return cached;\n      }\n\n      const promise = this._main(...this.args);\n      return awaitAndSave(promise, this.sheet, this.at, key, this.ttlMilliseconds, this.useInflight);\n    }\n\n    // For sync functions, just call and return\n    return this._main(...this.args);\n  }\n\n  /**\n   * If any broadcastable argument is a matrix (multi-cell), expand the call\n   * across all element positions and return a Spilling.\n   * Returns `undefined` when no broadcast is necessary.\n   *\n   * Rules:\n   * - broadcastDisabled = true → never broadcast\n   * - An arg is broadcastable when its corresponding args[].takesMatrix is not true\n   * - A Sheet/Spilling/2D-array whose size is (1,1) is treated as a scalar\n   *   (not broadcast); only multi-cell matrices trigger broadcast\n   * - For variadic args, extra args are assigned round-robin\n   *   across the variadic helpArg positions\n   */\n  private broadcast(): any[][] | undefined {\n    if (this.broadcastDisabled) {\n      return undefined;\n    }\n\n    // Map each args index to its corresponding args index\n    const helpIndices = resolveParamIndex(this.defs, this.args.length);\n\n    // Determine which arg positions are broadcastable (takesMatrix: true suppresses broadcasting).\n    const broadcastable: boolean[] = this.args.map((_, i) => {\n      const hIdx = helpIndices[i];\n      return !this.defs[hIdx]?.takesMatrix;\n    });\n\n    // Collect matrices only for broadcastable positions whose value is a multi-cell matrix\n    const matrices: (any[][] | null)[] = this.args.map((arg, i) => {\n      if (broadcastable[i] && isMultiCell(arg)) {\n        return this.toMatrix(arg);\n      }\n      return null;\n    });\n\n    // If no broadcastable arg is actually a multi-cell matrix, nothing to do\n    if (matrices.every((m) => m === null)) {\n      return undefined;\n    }\n\n    // Collapse 1×1 matrix args (non-broadcast) to scalars for the cell-level calls\n    const scalarArgs = this.args.map((arg, i) => {\n      if (matrices[i] !== null) {\n        return arg;\n      } // will be expanded per-cell\n      return this.toScalar(arg);\n    });\n\n    // Compute the max rows / cols across all matrix arguments\n    let maxRows = 1;\n    let maxCols = 1;\n    for (const m of matrices) {\n      if (m) {\n        maxRows = Math.max(maxRows, m.length);\n        maxCols = Math.max(\n          maxCols,\n          m.reduce((acc, row) => Math.max(acc, row.length), 0),\n        );\n      }\n    }\n\n    // Save original args so we can restore after each cell iteration\n    const originalBareArgs = this.args;\n\n    // Iterate over every (row, col) position\n    const result: any[][] = [];\n    for (let r = 0; r < maxRows; r++) {\n      const row: any[] = [];\n      for (let c = 0; c < maxCols; c++) {\n        // Build the argument list for this cell position\n        const cellArgs = scalarArgs.map((arg, i) => {\n          const m = matrices[i];\n          if (m) {\n            // If the position exists in the matrix, use it; otherwise null\n            return m?.[r]?.[c] ?? null;\n          }\n          return arg;\n        });\n        try {\n          if (hasPendingArg(cellArgs)) {\n            row.push(createPropagatedPending());\n          } else {\n            // Validate cell-level args\n            const validatedArgs = this.validate(cellArgs);\n            if (hasDeepPending(validatedArgs, this.at)) {\n              row.push(createPropagatedPending());\n            } else {\n              row.push(this._main(...validatedArgs));\n            }\n          }\n        } catch (e) {\n          row.push(e);\n        }\n      }\n      result.push(row);\n    }\n\n    // Restore original args\n    this.args = originalBareArgs;\n\n    return result;\n  }\n}\n\n/**\n * Base class for async functions.\n * Extend this class to create async functions that support caching.\n */\nexport class BaseFunctionAsync extends BaseFunction {\n  protected isAsync: boolean = true;\n}\n\nexport type FunctionMapping = { [functionName: string]: typeof BaseFunction };\n"],"names":["isSheet","v","conditionArg","matchesType","value","nullable","errorTolerant","acceptedTypes","FormulaError","t","Time","isMatrix","Spilling","stripMatrix","at","stripSheet","m","_a","isMultiCell","resolveParamIndex","defs","argCount","indices","iterStart","iterCount","j","_BaseFunction","args","sheet","callback","matrix","r","c","a","e","validatedArgs","minArgs","hasIterable","d","i","def","rows","cols","_b","_c","broadcastResult","hasDeepPending","createPropagatedPending","key","buildAsyncCacheKey","cached","getAsyncCache","asyncCacheMiss","promise","awaitAndSave","helpIndices","broadcastable","_","hIdx","matrices","arg","scalarArgs","maxRows","maxCols","acc","row","originalBareArgs","result","cellArgs","hasPendingArg","BaseFunction","BaseFunctionAsync"],"mappings":"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"}

package/dist/formula/functions/__utils.d.ts

@@ -0,0 +1,28 @@
+import { Sheet } from '../../lib/sheet';
+import { Id, PointType } from '../../types';
+export declare const gt: (left: any, right: any) => boolean;
+export declare const gte: (left: any, right: any) => boolean;
+export declare const lt: (left: any, right: any) => boolean;
+export declare const lte: (left: any, right: any) => boolean;
+export declare const eq: (left: any, right: any) => boolean;
+export declare const ne: (left: any, right: any) => boolean;
+export type EnsureNumberOptions = {
+    alternative?: number;
+    ignore?: boolean;
+};
+export type EnsureBooleanOptions = {
+    alternative?: boolean;
+    ignore?: boolean;
+};
+export declare const ensureNumber: (value: any, options?: EnsureNumberOptions) => number;
+export declare const ensureString: (value: any) => string;
+export declare const ensureBoolean: (value: any, options?: EnsureBooleanOptions) => boolean;
+/**
+ * Converts a value to a Date object.
+ * Accepts: Date, number (ms since epoch), string (parseable date string).
+ */
+export declare function ensureDate(value: any): Date;
+export declare const check: (value: any, condition: string) => boolean;
+export declare const eachMatrix: (value: any, callback: (v: any, relativePoint: PointType) => void, at: Id) => void;
+export declare const createBooleanMask: (sheets: Sheet[], conditions: string[], at: Id) => boolean[][];
+//# sourceMappingURL=__utils.d.ts.map

package/dist/formula/functions/__utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"__utils.d.ts","sourceRoot":"","sources":["../../../src/formula/functions/__utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAKxC,OAAO,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGjD,eAAO,MAAM,EAAE,GAAI,MAAM,GAAG,EAAE,OAAO,GAAG,KAAG,OAS1C,CAAC;AAEF,eAAO,MAAM,GAAG,GAAI,MAAM,GAAG,EAAE,OAAO,GAAG,KAAG,OAS3C,CAAC;AAEF,eAAO,MAAM,EAAE,GAAI,MAAM,GAAG,EAAE,OAAO,GAAG,KAAG,OAE1C,CAAC;AAEF,eAAO,MAAM,GAAG,GAAI,MAAM,GAAG,EAAE,OAAO,GAAG,KAAG,OAE3C,CAAC;AAEF,eAAO,MAAM,EAAE,GAAI,MAAM,GAAG,EAAE,OAAO,GAAG,KAAG,OAE1C,CAAC;AAEF,eAAO,MAAM,EAAE,GAAI,MAAM,GAAG,EAAE,OAAO,GAAG,KAAG,OAE1C,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,OAAO,GAAG,EAAE,UAAU,mBAAmB,KAAG,MAsCxE,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,OAAO,GAAG,KAAG,MAsBzC,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,OAAO,GAAG,EAAE,UAAU,oBAAoB,KAAG,OA0B1E,CAAC;AAEF;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,GAAG,GAAG,IAAI,CAqB3C;AAID,eAAO,MAAM,KAAK,GAAI,OAAO,GAAG,EAAE,WAAW,MAAM,KAAG,OAqCrD,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,OAAO,GAAG,EAAE,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,aAAa,EAAE,SAAS,KAAK,IAAI,EAAE,IAAI,EAAE,SAwBlG,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,QAAQ,KAAK,EAAE,EAAE,YAAY,MAAM,EAAE,EAAE,IAAI,EAAE,KAAG,OAAO,EAAE,EAsB1F,CAAC"}

package/dist/formula/functions/__utils.js

@@ -0,0 +1,179 @@
+import { stripSheet as p } from "../solver.js";
+import { Sheet as g } from "../../lib/sheet.js";
+import { FormulaError as d } from "../formula-error.js";
+import L from "dayjs";
+import { FULLDATE_FORMAT_UTC as C } from "../../constants.js";
+import { Pending as y, Spilling as R } from "../../sentinels.js";
+import { Time as S } from "../../lib/time.js";
+const u = (t, r) => {
+  if (typeof t == "string" || typeof r == "string")
+    return s(t) > s(r);
+  try {
+    return m(t) > m(r);
+  } catch {
+    return !1;
+  }
+}, A = (t, r) => {
+  if (typeof t == "string" || typeof r == "string")
+    return s(t) >= s(r);
+  try {
+    return m(t) >= m(r);
+  } catch {
+    return !1;
+  }
+}, T = (t, r) => !A(t, r), b = (t, r) => !u(t, r), N = (t, r) => s(t).toLowerCase() === s(r).toLowerCase(), P = (t, r) => !N(t, r), m = (t, r) => {
+  const { alternative: i, ignore: e } = r || {};
+  if (y.is(t))
+    return t;
+  if (typeof t > "u" && typeof i < "u")
+    return i;
+  if (!t)
+    return 0;
+  if (t instanceof g) {
+    const o = p({ value: t });
+    return m(o, { alternative: i });
+  }
+  if (t instanceof Date)
+    return t.getTime();
+  if (S.is(t))
+    return t.days;
+  if (typeof t == "string" && t.endsWith("%")) {
+    const o = parseFloat(t.slice(0, -1));
+    if (!isNaN(o))
+      return o / 100;
+  }
+  const n = parseFloat(t);
+  if (isNaN(n)) {
+    if (e)
+      return i ?? 0;
+    throw new d("#VALUE!", `${t} cannot be converted to a number`);
+  }
+  return n;
+}, s = (t) => {
+  if (y.is(t))
+    return t;
+  if (t === 0)
+    return "0";
+  if (!t)
+    return "";
+  if (t instanceof g) {
+    const r = p({ value: t });
+    return s(r);
+  }
+  switch (t.constructor.name) {
+    case "Date":
+      return L(t).format(C);
+    default:
+      return String(t);
+  }
+}, F = (t, r) => {
+  const { alternative: i, ignore: e } = r ?? {};
+  if (y.is(t))
+    return t;
+  if (typeof t > "u" && typeof i < "u")
+    return i;
+  if (t === null)
+    return !1;
+  if (t instanceof g) {
+    const n = p({ value: t });
+    return F(n, r);
+  }
+  if (typeof t == "string" || t instanceof String) {
+    const n = { true: !0, false: !1 }[t.toLowerCase()];
+    if (n == null) {
+      if (e)
+        return !1;
+      throw new d("#VALUE!", `text '${t}' cannot be converted to a boolean`);
+    }
+    return n;
+  }
+  return !!t;
+};
+function $(t) {
+  if (y.is(t) || t instanceof Date)
+    return t;
+  if (t instanceof g) {
+    const r = p({ value: t });
+    return $(r);
+  }
+  if (typeof t == "number")
+    return new Date(t);
+  if (typeof t == "string") {
+    const r = new Date(t);
+    if (!isNaN(r.getTime()))
+      return r;
+  }
+  throw new d("#VALUE!", `${t} cannot be converted to a date`);
+}
+const U = /^(<=|>=|<>|>|<|=)?(.*)$/, B = (t, r) => {
+  const i = r.match(U), [, e = "", n = ""] = i || [];
+  let o = n;
+  if (e === ">" || e === "<" || e === ">=" || e === "<=")
+    switch (typeof t == "number" && (o = parseFloat(n)), e) {
+      case ">":
+        return u(t, o);
+      case ">=":
+        return A(t, o);
+      case "<":
+        return T(t, o);
+      case "<=":
+        return b(t, o);
+    }
+  const f = e === "" || e === "=";
+  if (n === "")
+    return (t == null || t === "") === f;
+  if (typeof t == "string" || t instanceof String) {
+    const c = n.replace(/~\*/g, "(\\*)").replace(/~\?/g, "(\\?)").replace(/\*/g, "(.*)").replace(/\?/g, "(.)");
+    return RegExp(`^${c}$`, "i").test(t) === f;
+  }
+  return N(t, o) === f;
+}, M = (t, r, i) => {
+  if (t instanceof g) {
+    const e = t.solve({ at: i });
+    for (let n = 0; n < e.length; n++)
+      for (let o = 0; o < e[n].length; o++)
+        r(e[n][o], { y: n, x: o });
+  } else if (R.is(t)) {
+    const e = t.matrix;
+    for (let n = 0; n < e.length; n++)
+      for (let o = 0; o < e[n].length; o++)
+        r(e[n][o], { y: n, x: o });
+  } else if (Array.isArray(t) && Array.isArray(t[0]))
+    for (let e = 0; e < t.length; e++)
+      for (let n = 0; n < t[e].length; n++)
+        r(t[e][n], { y: e, x: n });
+  else
+    r(t, { y: 0, x: 0 });
+}, W = (t, r, i) => {
+  if (t.length === 0)
+    return [];
+  const e = t[0], n = e.numRows, o = e.numCols, f = Array.from({ length: n }, () => Array(o).fill(!0));
+  for (let c = 0; c < t.length; c++) {
+    const a = t[c], D = r[c];
+    M(
+      a,
+      (E, h) => {
+        var w, x;
+        (w = f[h.y])[x = h.x] && (w[x] = B(E, D));
+      },
+      i
+    );
+  }
+  return f;
+};
+export {
+  B as check,
+  W as createBooleanMask,
+  M as eachMatrix,
+  F as ensureBoolean,
+  $ as ensureDate,
+  m as ensureNumber,
+  s as ensureString,
+  N as eq,
+  u as gt,
+  A as gte,
+  T as lt,
+  b as lte,
+  P as ne
+};
+//# sourceMappingURL=__utils.js.map

package/dist/formula/functions/__utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"__utils.js","sources":["../../../src/formula/functions/__utils.ts"],"sourcesContent":["import { stripSheet } from '../solver';\nimport { Sheet } from '../../lib/sheet';\nimport { FormulaError } from '../formula-error';\nimport dayjs from 'dayjs';\nimport { FULLDATE_FORMAT_UTC } from '../../constants';\nimport { Pending, Spilling } from '../../sentinels';\nimport type { Id, PointType } from '../../types';\nimport { Time } from '../../lib/time';\n\nexport const gt = (left: any, right: any): boolean => {\n  if (typeof left === 'string' || typeof right === 'string') {\n    return ensureString(left) > ensureString(right);\n  }\n  try {\n    return ensureNumber(left) > ensureNumber(right);\n  } catch {\n    return false;\n  }\n};\n\nexport const gte = (left: any, right: any): boolean => {\n  if (typeof left === 'string' || typeof right === 'string') {\n    return ensureString(left) >= ensureString(right);\n  }\n  try {\n    return ensureNumber(left) >= ensureNumber(right);\n  } catch {\n    return false;\n  }\n};\n\nexport const lt = (left: any, right: any): boolean => {\n  return !gte(left, right);\n};\n\nexport const lte = (left: any, right: any): boolean => {\n  return !gt(left, right);\n};\n\nexport const eq = (left: any, right: any): boolean => {\n  return ensureString(left).toLowerCase() === ensureString(right).toLowerCase();\n};\n\nexport const ne = (left: any, right: any): boolean => {\n  return !eq(left, right);\n};\n\nexport type EnsureNumberOptions = {\n  alternative?: number;\n  ignore?: boolean;\n};\n\nexport type EnsureBooleanOptions = {\n  alternative?: boolean;\n  ignore?: boolean;\n};\n\nexport const ensureNumber = (value: any, options?: EnsureNumberOptions): number => {\n  const { alternative, ignore } = options || {};\n  if (Pending.is(value)) {\n    return value as any;\n  }\n  if (typeof value === 'undefined' && typeof alternative !== 'undefined') {\n    return alternative;\n  }\n  if (!value) {\n    // falsy is 0\n    return 0;\n  }\n  if (value instanceof Sheet) {\n    const v = stripSheet({ value });\n    return ensureNumber(v, { alternative });\n  }\n  if (value instanceof Date) {\n    return value.getTime();\n  }\n  if (Time.is(value)) {\n    return value.days;\n  }\n\n  if (typeof value === 'string' && value.endsWith('%')) {\n    const num = parseFloat(value.slice(0, -1));\n    if (!isNaN(num)) {\n      return num / 100;\n    }\n  }\n\n  const num = parseFloat(value as string);\n  if (isNaN(num)) {\n    if (ignore) {\n      return alternative ?? 0;\n    }\n    throw new FormulaError('#VALUE!', `${value} cannot be converted to a number`);\n  }\n  return num;\n};\n\nexport const ensureString = (value: any): string => {\n  if (Pending.is(value)) {\n    return value as any;\n  }\n  if (value === 0) {\n    return '0';\n  }\n  if (!value) {\n    return '';\n  }\n  if (value instanceof Sheet) {\n    const v = stripSheet({ value });\n    return ensureString(v);\n  }\n  switch (value.constructor.name) {\n    case 'Date': {\n      const d: Date = value;\n      return dayjs(d).format(FULLDATE_FORMAT_UTC);\n    }\n    default:\n      return String(value);\n  }\n};\n\nexport const ensureBoolean = (value: any, options?: EnsureBooleanOptions): boolean => {\n  const { alternative, ignore } = options ?? {};\n  if (Pending.is(value)) {\n    return value as any;\n  }\n  if (typeof value === 'undefined' && typeof alternative !== 'undefined') {\n    return alternative;\n  }\n  if (value === null) {\n    return false;\n  }\n  if (value instanceof Sheet) {\n    const v = stripSheet({ value });\n    return ensureBoolean(v, options);\n  }\n  if (typeof value === 'string' || value instanceof String) {\n    const bool = { true: true, false: false }[value.toLowerCase()];\n    if (bool == null) {\n      if (ignore) {\n        return false;\n      }\n      throw new FormulaError('#VALUE!', `text '${value as string}' cannot be converted to a boolean`);\n    }\n    return bool;\n  }\n  return Boolean(value);\n};\n\n/**\n * Converts a value to a Date object.\n * Accepts: Date, number (ms since epoch), string (parseable date string).\n */\nexport function ensureDate(value: any): Date {\n  if (Pending.is(value)) {\n    return value as any;\n  }\n  if (value instanceof Date) {\n    return value;\n  }\n  if (value instanceof Sheet) {\n    const v = stripSheet({ value });\n    return ensureDate(v);\n  }\n  if (typeof value === 'number') {\n    return new Date(value);\n  }\n  if (typeof value === 'string') {\n    const d = new Date(value);\n    if (!isNaN(d.getTime())) {\n      return d;\n    }\n  }\n  throw new FormulaError('#VALUE!', `${value} cannot be converted to a date`);\n}\n\nconst CONDITION_REGEX = /^(<=|>=|<>|>|<|=)?(.*)$/;\n\nexport const check = (value: any, condition: string): boolean => {\n  const m = condition.match(CONDITION_REGEX);\n\n  const [, expr = '', target = ''] = m || [];\n  let comparison: any = target;\n  if (expr === '>' || expr === '<' || expr === '>=' || expr === '<=') {\n    if (typeof value === 'number') {\n      comparison = parseFloat(target);\n    }\n    switch (expr) {\n      case '>':\n        return gt(value, comparison);\n      case '>=':\n        return gte(value, comparison);\n      case '<':\n        return lt(value, comparison);\n      case '<=':\n        return lte(value, comparison);\n    }\n  }\n\n  const equals = expr === '' || expr === '=';\n  if (target === '') {\n    // empty target means \"\" or \"<>\"\n    return (value == null || value === '') === equals;\n  }\n\n  if (typeof value === 'string' || value instanceof String) {\n    const replaced = target\n      .replace(/~\\*/g, '(\\\\*)')\n      .replace(/~\\?/g, '(\\\\?)')\n      .replace(/\\*/g, '(.*)')\n      .replace(/\\?/g, '(.)');\n    const regex = RegExp(`^${replaced}$`, 'i');\n    return regex.test(value as string) === equals;\n  }\n  return eq(value, comparison) === equals;\n};\n\nexport const eachMatrix = (value: any, callback: (v: any, relativePoint: PointType) => void, at: Id) => {\n  if (value instanceof Sheet) {\n    const matrix = value.solve({ at });\n    for (let y = 0; y < matrix.length; y++) {\n      for (let x = 0; x < matrix[y].length; x++) {\n        callback(matrix[y][x], { y, x });\n      }\n    }\n  } else if (Spilling.is(value)) {\n    const matrix = value.matrix;\n    for (let y = 0; y < matrix.length; y++) {\n      for (let x = 0; x < matrix[y].length; x++) {\n        callback(matrix[y][x], { y, x });\n      }\n    }\n  } else if (Array.isArray(value) && Array.isArray(value[0])) {\n    for (let y = 0; y < value.length; y++) {\n      for (let x = 0; x < value[y].length; x++) {\n        callback(value[y][x], { y, x });\n      }\n    }\n  } else {\n    callback(value, { y: 0, x: 0 });\n  }\n};\n\nexport const createBooleanMask = (sheets: Sheet[], conditions: string[], at: Id): boolean[][] => {\n  if (sheets.length === 0) {\n    return [];\n  }\n  const refRange = sheets[0];\n  const numRows = refRange.numRows;\n  const numCols = refRange.numCols;\n\n  const mask: boolean[][] = Array.from({ length: numRows }, () => Array(numCols).fill(true));\n\n  for (let p = 0; p < sheets.length; p++) {\n    const condRange = sheets[p];\n    const condition = conditions[p];\n    eachMatrix(\n      condRange,\n      (v: any, pt: PointType) => {\n        mask[pt.y][pt.x] &&= check(v, condition);\n      },\n      at,\n    );\n  }\n  return mask;\n};\n"],"names":["gt","left","right","ensureString","ensureNumber","gte","lt","lte","eq","ne","value","options","alternative","ignore","Pending","Sheet","v","stripSheet","Time","num","FormulaError","dayjs","FULLDATE_FORMAT_UTC","ensureBoolean","bool","ensureDate","d","CONDITION_REGEX","check","condition","m","expr","target","comparison","equals","replaced","eachMatrix","callback","at","matrix","y","x","Spilling","createBooleanMask","sheets","conditions","refRange","numRows","numCols","mask","p","condRange","pt","_a","_b"],"mappings":";;;;;;;AASa,MAAAA,IAAK,CAACC,GAAWC,MAAwB;AACpD,MAAI,OAAOD,KAAS,YAAY,OAAOC,KAAU;AAC/C,WAAOC,EAAaF,CAAI,IAAIE,EAAaD,CAAK;AAE5C,MAAA;AACF,WAAOE,EAAaH,CAAI,IAAIG,EAAaF,CAAK;AAAA,EAAA,QACxC;AACC,WAAA;AAAA,EAAA;AAEX,GAEaG,IAAM,CAACJ,GAAWC,MAAwB;AACrD,MAAI,OAAOD,KAAS,YAAY,OAAOC,KAAU;AAC/C,WAAOC,EAAaF,CAAI,KAAKE,EAAaD,CAAK;AAE7C,MAAA;AACF,WAAOE,EAAaH,CAAI,KAAKG,EAAaF,CAAK;AAAA,EAAA,QACzC;AACC,WAAA;AAAA,EAAA;AAEX,GAEaI,IAAK,CAACL,GAAWC,MACrB,CAACG,EAAIJ,GAAMC,CAAK,GAGZK,IAAM,CAACN,GAAWC,MACtB,CAACF,EAAGC,GAAMC,CAAK,GAGXM,IAAK,CAACP,GAAWC,MACrBC,EAAaF,CAAI,EAAE,kBAAkBE,EAAaD,CAAK,EAAE,YAAY,GAGjEO,IAAK,CAACR,GAAWC,MACrB,CAACM,EAAGP,GAAMC,CAAK,GAaXE,IAAe,CAACM,GAAYC,MAA0C;AACjF,QAAM,EAAE,aAAAC,GAAa,QAAAC,EAAO,IAAIF,KAAW,CAAC;AACxC,MAAAG,EAAQ,GAAGJ,CAAK;AACX,WAAAA;AAET,MAAI,OAAOA,IAAU,OAAe,OAAOE,IAAgB;AAClD,WAAAA;AAET,MAAI,CAACF;AAEI,WAAA;AAET,MAAIA,aAAiBK,GAAO;AAC1B,UAAMC,IAAIC,EAAW,EAAE,OAAAP,GAAO;AAC9B,WAAON,EAAaY,GAAG,EAAE,aAAAJ,GAAa;AAAA,EAAA;AAExC,MAAIF,aAAiB;AACnB,WAAOA,EAAM,QAAQ;AAEnB,MAAAQ,EAAK,GAAGR,CAAK;AACf,WAAOA,EAAM;AAGf,MAAI,OAAOA,KAAU,YAAYA,EAAM,SAAS,GAAG,GAAG;AACpD,UAAMS,IAAM,WAAWT,EAAM,MAAM,GAAG,EAAE,CAAC;AACrC,QAAA,CAAC,MAAMS,CAAG;AACZ,aAAOA,IAAM;AAAA,EACf;AAGI,QAAAA,IAAM,WAAWT,CAAe;AAClC,MAAA,MAAMS,CAAG,GAAG;AACd,QAAIN;AACF,aAAOD,KAAe;AAExB,UAAM,IAAIQ,EAAa,WAAW,GAAGV,CAAK,kCAAkC;AAAA,EAAA;AAEvE,SAAAS;AACT,GAEahB,IAAe,CAACO,MAAuB;AAC9C,MAAAI,EAAQ,GAAGJ,CAAK;AACX,WAAAA;AAET,MAAIA,MAAU;AACL,WAAA;AAET,MAAI,CAACA;AACI,WAAA;AAET,MAAIA,aAAiBK,GAAO;AAC1B,UAAMC,IAAIC,EAAW,EAAE,OAAAP,GAAO;AAC9B,WAAOP,EAAaa,CAAC;AAAA,EAAA;AAEf,UAAAN,EAAM,YAAY,MAAM;AAAA,IAC9B,KAAK;AAEH,aAAOW,EADSX,CACF,EAAE,OAAOY,CAAmB;AAAA,IAE5C;AACE,aAAO,OAAOZ,CAAK;AAAA,EAAA;AAEzB,GAEaa,IAAgB,CAACb,GAAYC,MAA4C;AACpF,QAAM,EAAE,aAAAC,GAAa,QAAAC,EAAO,IAAIF,KAAW,CAAC;AACxC,MAAAG,EAAQ,GAAGJ,CAAK;AACX,WAAAA;AAET,MAAI,OAAOA,IAAU,OAAe,OAAOE,IAAgB;AAClD,WAAAA;AAET,MAAIF,MAAU;AACL,WAAA;AAET,MAAIA,aAAiBK,GAAO;AAC1B,UAAMC,IAAIC,EAAW,EAAE,OAAAP,GAAO;AACvB,WAAAa,EAAcP,GAAGL,CAAO;AAAA,EAAA;AAEjC,MAAI,OAAOD,KAAU,YAAYA,aAAiB,QAAQ;AAClD,UAAAc,IAAO,EAAE,MAAM,IAAM,OAAO,GAAM,EAAEd,EAAM,aAAa;AAC7D,QAAIc,KAAQ,MAAM;AAChB,UAAIX;AACK,eAAA;AAET,YAAM,IAAIO,EAAa,WAAW,SAASV,CAAe,oCAAoC;AAAA,IAAA;AAEzF,WAAAc;AAAA,EAAA;AAET,SAAO,EAAQd;AACjB;AAMO,SAASe,EAAWf,GAAkB;AAI3C,MAHII,EAAQ,GAAGJ,CAAK,KAGhBA,aAAiB;AACZ,WAAAA;AAET,MAAIA,aAAiBK,GAAO;AAC1B,UAAMC,IAAIC,EAAW,EAAE,OAAAP,GAAO;AAC9B,WAAOe,EAAWT,CAAC;AAAA,EAAA;AAEjB,MAAA,OAAON,KAAU;AACZ,WAAA,IAAI,KAAKA,CAAK;AAEnB,MAAA,OAAOA,KAAU,UAAU;AACvB,UAAAgB,IAAI,IAAI,KAAKhB,CAAK;AACxB,QAAI,CAAC,MAAMgB,EAAE,QAAS,CAAA;AACb,aAAAA;AAAA,EACT;AAEF,QAAM,IAAIN,EAAa,WAAW,GAAGV,CAAK,gCAAgC;AAC5E;AAEA,MAAMiB,IAAkB,2BAEXC,IAAQ,CAAClB,GAAYmB,MAA+B;AACzD,QAAAC,IAAID,EAAU,MAAMF,CAAe,GAEnC,CAAA,EAAGI,IAAO,IAAIC,IAAS,EAAE,IAAIF,KAAK,CAAC;AACzC,MAAIG,IAAkBD;AACtB,MAAID,MAAS,OAAOA,MAAS,OAAOA,MAAS,QAAQA,MAAS;AAI5D,YAHI,OAAOrB,KAAU,aACnBuB,IAAa,WAAWD,CAAM,IAExBD,GAAM;AAAA,MACZ,KAAK;AACI,eAAA/B,EAAGU,GAAOuB,CAAU;AAAA,MAC7B,KAAK;AACI,eAAA5B,EAAIK,GAAOuB,CAAU;AAAA,MAC9B,KAAK;AACI,eAAA3B,EAAGI,GAAOuB,CAAU;AAAA,MAC7B,KAAK;AACI,eAAA1B,EAAIG,GAAOuB,CAAU;AAAA,IAAA;AAI5B,QAAAC,IAASH,MAAS,MAAMA,MAAS;AACvC,MAAIC,MAAW;AAEL,YAAAtB,KAAS,QAAQA,MAAU,QAAQwB;AAG7C,MAAI,OAAOxB,KAAU,YAAYA,aAAiB,QAAQ;AACxD,UAAMyB,IAAWH,EACd,QAAQ,QAAQ,OAAO,EACvB,QAAQ,QAAQ,OAAO,EACvB,QAAQ,OAAO,MAAM,EACrB,QAAQ,OAAO,KAAK;AAEhB,WADO,OAAO,IAAIG,CAAQ,KAAK,GAAG,EAC5B,KAAKzB,CAAe,MAAMwB;AAAA,EAAA;AAElC,SAAA1B,EAAGE,GAAOuB,CAAU,MAAMC;AACnC,GAEaE,IAAa,CAAC1B,GAAY2B,GAAsDC,MAAW;AACtG,MAAI5B,aAAiBK,GAAO;AAC1B,UAAMwB,IAAS7B,EAAM,MAAM,EAAE,IAAA4B,GAAI;AACjC,aAASE,IAAI,GAAGA,IAAID,EAAO,QAAQC;AACjC,eAASC,IAAI,GAAGA,IAAIF,EAAOC,CAAC,EAAE,QAAQC;AAC3B,QAAAJ,EAAAE,EAAOC,CAAC,EAAEC,CAAC,GAAG,EAAE,GAAAD,GAAG,GAAAC,GAAG;AAAA,EAG1B,WAAAC,EAAS,GAAGhC,CAAK,GAAG;AAC7B,UAAM6B,IAAS7B,EAAM;AACrB,aAAS8B,IAAI,GAAGA,IAAID,EAAO,QAAQC;AACjC,eAASC,IAAI,GAAGA,IAAIF,EAAOC,CAAC,EAAE,QAAQC;AAC3B,QAAAJ,EAAAE,EAAOC,CAAC,EAAEC,CAAC,GAAG,EAAE,GAAAD,GAAG,GAAAC,GAAG;AAAA,EAEnC,WACS,MAAM,QAAQ/B,CAAK,KAAK,MAAM,QAAQA,EAAM,CAAC,CAAC;AACvD,aAAS8B,IAAI,GAAGA,IAAI9B,EAAM,QAAQ8B;AAChC,eAASC,IAAI,GAAGA,IAAI/B,EAAM8B,CAAC,EAAE,QAAQC;AAC1B,QAAAJ,EAAA3B,EAAM8B,CAAC,EAAEC,CAAC,GAAG,EAAE,GAAAD,GAAG,GAAAC,GAAG;AAAA;AAIlC,IAAAJ,EAAS3B,GAAO,EAAE,GAAG,GAAG,GAAG,GAAG;AAElC,GAEaiC,IAAoB,CAACC,GAAiBC,GAAsBP,MAAwB;AAC3F,MAAAM,EAAO,WAAW;AACpB,WAAO,CAAC;AAEJ,QAAAE,IAAWF,EAAO,CAAC,GACnBG,IAAUD,EAAS,SACnBE,IAAUF,EAAS,SAEnBG,IAAoB,MAAM,KAAK,EAAE,QAAQF,KAAW,MAAM,MAAMC,CAAO,EAAE,KAAK,EAAI,CAAC;AAEzF,WAASE,IAAI,GAAGA,IAAIN,EAAO,QAAQM,KAAK;AAChC,UAAAC,IAAYP,EAAOM,CAAC,GACpBrB,IAAYgB,EAAWK,CAAC;AAC9B,IAAAd;AAAA,MACEe;AAAA,MACA,CAACnC,GAAQoC,MAAkB;;AACpB,SAAAC,IAAAJ,EAAAG,EAAG,CAAC,GAAJE,IAAMF,EAAG,OAATC,EAAAC,KAAgB1B,EAAMZ,GAAGa,CAAS;AAAA,MACzC;AAAA,MACAS;AAAA,IACF;AAAA,EAAA;AAEK,SAAAW;AACT;"}

package/dist/formula/functions/abs.d.ts

@@ -0,0 +1,9 @@
+import { BaseFunction, FunctionCategory, FunctionArgumentDefinition } from './__base';
+export declare class AbsFunction extends BaseFunction {
+    example: string;
+    description: string;
+    defs: FunctionArgumentDefinition[];
+    category: FunctionCategory;
+    protected main(value: any): number;
+}
+//# sourceMappingURL=abs.d.ts.map

package/dist/formula/functions/abs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abs.d.ts","sourceRoot":"","sources":["../../../src/formula/functions/abs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,MAAM,UAAU,CAAC;AAKtF,qBAAa,WAAY,SAAQ,YAAY;IAC3C,OAAO,SAAa;IACpB,WAAW,SAAe;IAC1B,IAAI,EAAE,0BAA0B,EAAE,CAAgF;IAClH,QAAQ,EAAE,gBAAgB,CAAU;IAEpC,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG;CAG1B"}

package/dist/formula/functions/abs.js

@@ -0,0 +1,15 @@
+import { BaseFunction as t } from "./__base.js";
+import { ensureNumber as r } from "./__utils.js";
+const s = "Returns the absolute value of a number";
+class i extends t {
+  constructor() {
+    super(...arguments), this.example = "ABS(-2)", this.description = s, this.defs = [{ name: "value", description: "target number", acceptedTypes: ["number"] }], this.category = "math";
+  }
+  main(e) {
+    return Math.abs(r(e));
+  }
+}
+export {
+  i as AbsFunction
+};
+//# sourceMappingURL=abs.js.map

package/dist/formula/functions/abs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abs.js","sources":["../../../src/formula/functions/abs.ts"],"sourcesContent":["import { BaseFunction, FunctionCategory, FunctionArgumentDefinition } from './__base';\nimport { ensureNumber } from './__utils';\n\nconst description = `Returns the absolute value of a number`;\n\nexport class AbsFunction extends BaseFunction {\n  example = 'ABS(-2)';\n  description = description;\n  defs: FunctionArgumentDefinition[] = [{ name: 'value', description: 'target number', acceptedTypes: ['number'] }];\n  category: FunctionCategory = 'math';\n\n  protected main(value: any) {\n    return Math.abs(ensureNumber(value));\n  }\n}\n"],"names":["description","AbsFunction","BaseFunction","value","ensureNumber"],"mappings":";;AAGA,MAAMA,IAAc;AAEb,MAAMC,UAAoBC,EAAa;AAAA,EAAvC,cAAA;AAAA,UAAA,GAAA,SAAA,GACK,KAAA,UAAA,WACI,KAAA,cAAAF,GACuB,KAAA,OAAA,CAAC,EAAE,MAAM,SAAS,aAAa,iBAAiB,eAAe,CAAC,QAAQ,GAAG,GACnF,KAAA,WAAA;AAAA,EAAA;AAAA,EAEnB,KAAKG,GAAY;AACzB,WAAO,KAAK,IAAIC,EAAaD,CAAK,CAAC;AAAA,EAAA;AAEvC;"}

package/dist/formula/functions/add.d.ts

@@ -0,0 +1,10 @@
+import { BaseFunction, FunctionCategory, FunctionArgumentDefinition } from './__base';
+import { Time } from '../../lib/time';
+export declare class AddFunction extends BaseFunction {
+    example: string;
+    description: string;
+    defs: FunctionArgumentDefinition[];
+    category: FunctionCategory;
+    protected main(v1: number | Date | Time, v2: number | Date | Time): number | Date;
+}
+//# sourceMappingURL=add.d.ts.map

package/dist/formula/functions/add.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../../src/formula/functions/add.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,KAAK,gBAAgB,EAAE,KAAK,0BAA0B,EAAE,MAAM,UAAU,CAAC;AAEhG,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAMtC,qBAAa,WAAY,SAAQ,YAAY;IAC3C,OAAO,SAAe;IACtB,WAAW,SAAe;IAC1B,IAAI,EAAE,0BAA0B,EAAE,CAGhC;IACF,QAAQ,EAAE,gBAAgB,CAAU;IAEpC,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;CA0BlE"}

package/dist/formula/functions/add.js

@@ -0,0 +1,37 @@
+import n from "dayjs";
+import { FormulaError as a } from "../formula-error.js";
+import { BaseFunction as s } from "./__base.js";
+import { ensureNumber as i } from "./__utils.js";
+import { Time as r } from "../../lib/time.js";
+import { SECONDS_IN_DAY as o } from "../../constants.js";
+const d = `Returns the sum of two numbers.
+This is the same as the '+' operator.`;
+class b extends s {
+  constructor() {
+    super(...arguments), this.example = "ADD(2, 3)", this.description = d, this.defs = [
+      { name: "value1", description: "First additive.", acceptedTypes: ["number", "date", "time"] },
+      { name: "value2", description: "Second additive.", acceptedTypes: ["number", "date", "time"] }
+    ], this.category = "math";
+  }
+  main(e, t) {
+    if (typeof e == "number" && typeof t == "number")
+      return e + t;
+    if (e instanceof Date && r.is(t))
+      return r.ensure(t).add(e);
+    if (r.is(e) && t instanceof Date)
+      return r.ensure(e).add(t);
+    if (e instanceof Date && typeof t == "number")
+      return n(e).add(t * o, "second").toDate();
+    if (typeof e == "number" && t instanceof Date)
+      return n(t).add(e * o, "second").toDate();
+    try {
+      return i(e, { alternative: 0 }) + i(t, { alternative: 0 });
+    } catch {
+      throw new a("#VALUE!", "Mismatched types for augend or addend.");
+    }
+  }
+}
+export {
+  b as AddFunction
+};
+//# sourceMappingURL=add.js.map