@danielsimonjr/mathts-functions 0.64.3 → 0.66.0

package/dist/{chunk-UMUT2YEC.js → chunk-5A2EZLXV.js}

@@ -39,11 +39,6 @@ var WasmLoader = class _WasmLoader {
   loading = null;
   isNode;
   lastMetrics = null;
-  // Memory pool for reusable allocations
-  float64Pool = [];
-  int32Pool = [];
-  poolSizeThreshold = 1024 * 1024;
-  // 1MB max per pool entry
   constructor() {
     this.isNode = typeof process !== "undefined" && process.versions?.node !== void 0;
   }
@@ -64,7 +59,14 @@ var WasmLoader = class _WasmLoader {
       return this.loading;
     }
     this.loading = this.loadModule(wasmPath);
-    this.wasmModule = await this.loading;
+    try {
+      this.wasmModule = await this.loading;
+    } catch (error) {
+      this.compiledModule = null;
+      throw error;
+    } finally {
+      this.loading = null;
+    }
     return this.wasmModule;
   }
   /**
@@ -246,175 +248,6 @@ var WasmLoader = class _WasmLoader {
   getLoadingMetrics() {
     return this.lastMetrics;
   }
-  /**
-   * Allocate Float64Array in WASM memory
-   * Uses memory pooling for frequently reused sizes
-   */
-  allocateFloat64Array(data) {
-    const module = this.wasmModule;
-    if (!module) throw new Error("WASM module not loaded");
-    const length = data.length;
-    const byteLength = length * 8;
-    let ptr;
-    if (byteLength <= this.poolSizeThreshold) {
-      const poolEntry = this.getFromPool(this.float64Pool, byteLength);
-      if (poolEntry) {
-        ptr = poolEntry.ptr;
-        poolEntry.inUse = true;
-      } else {
-        ptr = module.__new(byteLength, 2);
-      }
-    } else {
-      ptr = module.__new(byteLength, 2);
-    }
-    const array = new Float64Array(module.memory.buffer, ptr, length);
-    array.set(data);
-    return { ptr, array };
-  }
-  /**
-   * Allocate Float64Array without copying data (for output buffers)
-   */
-  allocateFloat64ArrayEmpty(length) {
-    const module = this.wasmModule;
-    if (!module) throw new Error("WASM module not loaded");
-    const byteLength = length * 8;
-    let ptr;
-    if (byteLength <= this.poolSizeThreshold) {
-      const poolEntry = this.getFromPool(this.float64Pool, byteLength);
-      if (poolEntry) {
-        ptr = poolEntry.ptr;
-        poolEntry.inUse = true;
-      } else {
-        ptr = module.__new(byteLength, 2);
-      }
-    } else {
-      ptr = module.__new(byteLength, 2);
-    }
-    const array = new Float64Array(module.memory.buffer, ptr, length);
-    return { ptr, array };
-  }
-  /**
-   * Allocate Int32Array in WASM memory
-   * Uses memory pooling for frequently reused sizes
-   */
-  allocateInt32Array(data) {
-    const module = this.wasmModule;
-    if (!module) throw new Error("WASM module not loaded");
-    const length = data.length;
-    const byteLength = length * 4;
-    let ptr;
-    if (byteLength <= this.poolSizeThreshold) {
-      const poolEntry = this.getFromPool(this.int32Pool, byteLength);
-      if (poolEntry) {
-        ptr = poolEntry.ptr;
-        poolEntry.inUse = true;
-      } else {
-        ptr = module.__new(byteLength, 1);
-      }
-    } else {
-      ptr = module.__new(byteLength, 1);
-    }
-    const array = new Int32Array(module.memory.buffer, ptr, length);
-    array.set(data);
-    return { ptr, array };
-  }
-  /**
-   * Allocate Int32Array without copying data (for output buffers)
-   */
-  allocateInt32ArrayEmpty(length) {
-    const module = this.wasmModule;
-    if (!module) throw new Error("WASM module not loaded");
-    const byteLength = length * 4;
-    let ptr;
-    if (byteLength <= this.poolSizeThreshold) {
-      const poolEntry = this.getFromPool(this.int32Pool, byteLength);
-      if (poolEntry) {
-        ptr = poolEntry.ptr;
-        poolEntry.inUse = true;
-      } else {
-        ptr = module.__new(byteLength, 1);
-      }
-    } else {
-      ptr = module.__new(byteLength, 1);
-    }
-    const array = new Int32Array(module.memory.buffer, ptr, length);
-    return { ptr, array };
-  }
-  /**
-   * Get a suitable entry from the memory pool
-   */
-  getFromPool(pool, requestedSize) {
-    let bestFit = null;
-    let bestFitWaste = Infinity;
-    for (const entry of pool) {
-      if (!entry.inUse && entry.size >= requestedSize) {
-        const waste = entry.size - requestedSize;
-        if (waste < bestFitWaste && entry.size <= requestedSize * 2) {
-          bestFit = entry;
-          bestFitWaste = waste;
-        }
-      }
-    }
-    return bestFit;
-  }
-  /**
-   * Return allocation to pool for reuse
-   */
-  release(ptr, isFloat64 = true) {
-    const pool = isFloat64 ? this.float64Pool : this.int32Pool;
-    const entry = pool.find((e) => e.ptr === ptr);
-    if (entry) {
-      entry.inUse = false;
-      return;
-    }
-    this.free(ptr);
-  }
-  /**
-   * Free allocated memory (immediate, bypasses pool)
-   */
-  free(ptr) {
-    const module = this.wasmModule;
-    if (!module) return;
-    this.float64Pool = this.float64Pool.filter((e) => e.ptr !== ptr);
-    this.int32Pool = this.int32Pool.filter((e) => e.ptr !== ptr);
-    module.__unpin(ptr);
-  }
-  /**
-   * Clear the memory pool
-   */
-  clearPool() {
-    const module = this.wasmModule;
-    if (!module) return;
-    for (const entry of this.float64Pool) {
-      module.__unpin(entry.ptr);
-    }
-    for (const entry of this.int32Pool) {
-      module.__unpin(entry.ptr);
-    }
-    this.float64Pool = [];
-    this.int32Pool = [];
-  }
-  /**
-   * Get pool statistics
-   */
-  getPoolStats() {
-    const f64InUse = this.float64Pool.filter((e) => e.inUse).length;
-    const f64Bytes = this.float64Pool.reduce((sum, e) => sum + e.size, 0);
-    const i32InUse = this.int32Pool.filter((e) => e.inUse).length;
-    const i32Bytes = this.int32Pool.reduce((sum, e) => sum + e.size, 0);
-    return {
-      float64: {
-        total: this.float64Pool.length,
-        inUse: f64InUse,
-        totalBytes: f64Bytes
-      },
-      int32: {
-        total: this.int32Pool.length,
-        inUse: i32InUse,
-        totalBytes: i32Bytes
-      }
-    };
-  }
   /**
    * Run garbage collection
    */
@@ -427,7 +260,6 @@ var WasmLoader = class _WasmLoader {
    * Reset the loader (for testing)
    */
   reset() {
-    this.clearPool();
     this.wasmModule = null;
     this.compiledModule = null;
     this.loading = null;
@@ -435,6 +267,57 @@ var WasmLoader = class _WasmLoader {
   }
 };
 var wasmLoader = WasmLoader.getInstance();
+var INTEGRITY_FAILURE = "WASM integrity check failed";
+async function loadWasm(wasmPath) {
+  try {
+    await wasmLoader.load(wasmPath);
+    return true;
+  } catch (error) {
+    if (error instanceof Error && error.message.startsWith(INTEGRITY_FAILURE)) throw error;
+    return false;
+  }
+}
+function isWasmLoaded() {
+  return wasmLoader.isLoaded();
+}
+
+// src/wasm/policy.ts
+var WASM_DISPATCH_POLICY = {
+  // Element-wise (public `abs`, `sin`, ... on a Float64Array).
+  array_abs_ptr: { min: 1024 },
+  // 0.76/0.55 · 0.44/0.42 · 0.54/0.54 · 0.49/0.71
+  array_log10_ptr: { min: 1024 },
+  // 0.89/0.82 · 0.70/0.77 · 0.70/0.72 · 0.76/0.83
+  array_sin_ptr: { min: 1024, max: 131072 },
+  // 0.76/0.77 · 0.72/0.75 · (0.92/0.81 · 0.79/0.96)
+  array_log1p_ptr: { min: 1024, max: 16384 },
+  // 0.82/0.88 · (1.09/1.24 ...)
+  array_cos_ptr: { min: 16384 },
+  // (1.54/0.79) · 0.64/0.61 · 0.62/0.62 · 0.79/0.69
+  array_atanh_ptr: { min: 16384 },
+  // (0.93/0.85) · 0.70/0.73 · 0.77/0.78 · 0.81/0.83
+  array_log_ptr: { min: 16384 },
+  // (0.92/0.86) · 0.80/0.77 · 0.80/0.79 · 0.84/0.83
+  array_sec_ptr: { min: 16384, max: 1048576 },
+  // 0.76/0.79 · 0.76/0.83 · (0.90/0.88)
+  // A fused chain keeps its data in WASM memory between ops: (sin, exp) 0.36-0.49 and
+  // (tanh, expm1), both of which lose alone, 0.64-0.77, at every size.
+  fused_chain: { min: 1024 },
+  // Least-squares fits (public polyFit / chebyshevFit / legendreFit): 0.34-0.67.
+  poly_fit_f64: { min: 1024 },
+  cheb_fit_f64: { min: 1024 },
+  legendre_fit_f64: { min: 1024 },
+  // Only the largest measured size wins: lgamma 0.77/0.78, sort (median, quantile)
+  // 0.78/0.81 and 0.77/0.79 at 1M; 131K was 0.90-1.05.
+  lgamma_f64: { min: 1048576 },
+  sort_f64: { min: 1048576 }
+};
+var overrides = null;
+function wasmPolicyAllows(kernel, n) {
+  const own = (o, k) => Object.prototype.hasOwnProperty.call(o, k);
+  const band = overrides !== null && own(overrides, kernel) ? overrides[kernel] : overrides !== null && own(overrides, "*") ? overrides["*"] : WASM_DISPATCH_POLICY[kernel];
+  return band != null && n >= band.min && (band.max === void 0 || n < band.max);
+}
 
 // src/wasm/bridges/common.ts
 function getWasm() {
@@ -498,6 +381,9 @@ var AS_ID_ARRAY_BUFFER = 1;
 var AS_ID_FLOAT64_ARRAY = 5;
 var AS_ID_INT32_ARRAY = 6;
 var AS_HEADER_BYTES = 12;
+function resetAsHeap(mod) {
+  if (typeof mod.heap_reset === "function") mod.heap_reset();
+}
 function asAllocHeader(mod, byteLength, typeId) {
   const bufferPtr = mod.__pin(mod.__new(byteLength, AS_ID_ARRAY_BUFFER)) >>> 0;
   const headerPtr = mod.__new(AS_HEADER_BYTES, typeId) >>> 0;
@@ -546,6 +432,10 @@ function withAsF64(wasm, inputs, body) {
       } catch {
       }
     }
+    try {
+      resetAsHeap(mod);
+    } catch {
+    }
   }
 }
 function withAsI32(wasm, inputs, body) {
@@ -570,11 +460,15 @@ function withAsI32(wasm, inputs, body) {
       } catch {
       }
     }
+    try {
+      resetAsHeap(mod);
+    } catch {
+    }
   }
 }
 function makeUnaryArrayDispatch(cfg) {
   return (xs) => {
-    if (xs.length >= cfg.threshold) {
+    if (xs.length >= cfg.threshold && wasmPolicyAllows(cfg.name, xs.length)) {
       const wasm = getWasm();
       if (wasm && isAsWasm(wasm)) {
         const out = withAsF64(
@@ -623,7 +517,7 @@ function rankF64JS(data) {
 }
 function sortF64Dispatch(data) {
   const n = data.length;
-  if (n >= WASM_SORT_THRESHOLD) {
+  if (n >= WASM_SORT_THRESHOLD && wasmPolicyAllows("sort_f64", n)) {
     const wasm = getWasm();
     if (wasm && isAsWasm(wasm)) {
       try {
@@ -644,7 +538,7 @@ function sortF64Dispatch(data) {
 }
 function argsortF64Dispatch(data) {
   const n = data.length;
-  if (n >= WASM_SORT_THRESHOLD) {
+  if (n >= WASM_SORT_THRESHOLD && wasmPolicyAllows("argsort_f64", n)) {
     const wasm = getWasm();
     if (wasm && isAsWasm(wasm)) {
       try {
@@ -662,7 +556,7 @@ function argsortF64Dispatch(data) {
 }
 function rankF64Dispatch(data) {
   const n = data.length;
-  if (n >= WASM_SORT_THRESHOLD) {
+  if (n >= WASM_SORT_THRESHOLD && wasmPolicyAllows("rank_f64", n)) {
     const wasm = getWasm();
     if (wasm && isAsWasm(wasm)) {
       try {
@@ -681,7 +575,9 @@ function rankF64Dispatch(data) {
 
 export {
   __export,
-  wasmLoader,
+  loadWasm,
+  isWasmLoaded,
+  wasmPolicyAllows,
   getWasm,
   isAsWasm,
   runUnaryPtr,

package/dist/combinatorics/bellNumbers.d.ts

@@ -9,6 +9,6 @@ interface BellNumbersDependencies {
     isInteger: (x: NumericValue) => boolean;
     stirlingS2: (n: NumericValue, k: NumericValue) => NumericValue;
 }
-export declare const createBellNumbers: import("../utils/factory.js").FactoryFunction<BellNumbersDependencies, unknown>;
+export declare const createBellNumbers: import("../utils/factory.js").FactoryFunction<BellNumbersDependencies, TypedFunction>;
 export {};
 //# sourceMappingURL=bellNumbers.d.ts.map

package/dist/combinatorics/bellNumbers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bellNumbers.d.ts","sourceRoot":"","sources":["../../src/combinatorics/bellNumbers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAGhE,KAAK,aAAa,GAAG,SAAS,CAAC;AAE/B,KAAK,YAAY,GAAG,MAAM,GAAG,aAAa,CAAC;AAE3C,UAAU,uBAAuB;IAC/B,KAAK,EAAE,aAAa,CAAC;IACrB,SAAS,EAAE,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,KAAK,YAAY,CAAC;IAC9D,UAAU,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,OAAO,CAAC;IACzC,SAAS,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,OAAO,CAAC;IACxC,UAAU,EAAE,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,KAAK,YAAY,CAAC;CAChE;AAKD,eAAO,MAAM,iBAAiB,iFAyC7B,CAAC"}
+{"version":3,"file":"bellNumbers.d.ts","sourceRoot":"","sources":["../../src/combinatorics/bellNumbers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAGhE,KAAK,aAAa,GAAG,SAAS,CAAC;AAE/B,KAAK,YAAY,GAAG,MAAM,GAAG,aAAa,CAAC;AAE3C,UAAU,uBAAuB;IAC/B,KAAK,EAAE,aAAa,CAAC;IACrB,SAAS,EAAE,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,KAAK,YAAY,CAAC;IAC9D,UAAU,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,OAAO,CAAC;IACzC,SAAS,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,OAAO,CAAC;IACxC,UAAU,EAAE,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,KAAK,YAAY,CAAC;CAChE;AAKD,eAAO,MAAM,iBAAiB,uFAyC7B,CAAC"}

package/dist/combinatorics/catalan.d.ts

@@ -11,6 +11,6 @@ interface CatalanDependencies {
     isNegative: (x: NumericValue) => boolean;
     isInteger: (x: NumericValue) => boolean;
 }
-export declare const createCatalan: import("../utils/factory.js").FactoryFunction<CatalanDependencies, unknown>;
+export declare const createCatalan: import("../utils/factory.js").FactoryFunction<CatalanDependencies, TypedFunction>;
 export {};
 //# sourceMappingURL=catalan.d.ts.map

package/dist/combinatorics/catalan.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"catalan.d.ts","sourceRoot":"","sources":["../../src/combinatorics/catalan.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAGhE,KAAK,aAAa,GAAG,SAAS,CAAC;AAE/B,KAAK,YAAY,GAAG,MAAM,GAAG,aAAa,CAAC;AAE3C,UAAU,mBAAmB;IAC3B,KAAK,EAAE,aAAa,CAAC;IACrB,SAAS,EAAE,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,KAAK,YAAY,CAAC;IAC9D,YAAY,EAAE,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,KAAK,YAAY,CAAC;IACjE,cAAc,EAAE,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,KAAK,YAAY,CAAC;IACnE,YAAY,EAAE,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,KAAK,YAAY,CAAC;IACjE,UAAU,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,OAAO,CAAC;IACzC,SAAS,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,OAAO,CAAC;CACzC;AAaD,eAAO,MAAM,aAAa,6EA2CzB,CAAC"}
+{"version":3,"file":"catalan.d.ts","sourceRoot":"","sources":["../../src/combinatorics/catalan.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAGhE,KAAK,aAAa,GAAG,SAAS,CAAC;AAE/B,KAAK,YAAY,GAAG,MAAM,GAAG,aAAa,CAAC;AAE3C,UAAU,mBAAmB;IAC3B,KAAK,EAAE,aAAa,CAAC;IACrB,SAAS,EAAE,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,KAAK,YAAY,CAAC;IAC9D,YAAY,EAAE,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,KAAK,YAAY,CAAC;IACjE,cAAc,EAAE,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,KAAK,YAAY,CAAC;IACnE,YAAY,EAAE,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,KAAK,YAAY,CAAC;IACjE,UAAU,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,OAAO,CAAC;IACzC,SAAS,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,OAAO,CAAC;CACzC;AAaD,eAAO,MAAM,aAAa,mFA2CzB,CAAC"}

package/dist/combinatorics/composition.d.ts

@@ -11,6 +11,6 @@ interface CompositionDependencies {
     isInteger: (x: NumericValue) => boolean;
     larger: (x: NumericValue, y: NumericValue) => boolean;
 }
-export declare const createComposition: import("../utils/factory.js").FactoryFunction<CompositionDependencies, unknown>;
+export declare const createComposition: import("../utils/factory.js").FactoryFunction<CompositionDependencies, TypedFunction>;
 export {};
 //# sourceMappingURL=composition.d.ts.map

package/dist/combinatorics/composition.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"composition.d.ts","sourceRoot":"","sources":["../../src/combinatorics/composition.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAGhE,KAAK,aAAa,GAAG,SAAS,CAAC;AAE/B,KAAK,YAAY,GAAG,MAAM,GAAG,aAAa,CAAC;AAE3C,UAAU,uBAAuB;IAC/B,KAAK,EAAE,aAAa,CAAC;IACrB,SAAS,EAAE,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,KAAK,YAAY,CAAC;IAC9D,YAAY,EAAE,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,KAAK,YAAY,CAAC;IACjE,UAAU,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,OAAO,CAAC;IACzC,UAAU,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,OAAO,CAAC;IACzC,SAAS,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,OAAO,CAAC;IACxC,MAAM,EAAE,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,KAAK,OAAO,CAAC;CACvD;AAaD,eAAO,MAAM,iBAAiB,iFAiD7B,CAAC"}
+{"version":3,"file":"composition.d.ts","sourceRoot":"","sources":["../../src/combinatorics/composition.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAGhE,KAAK,aAAa,GAAG,SAAS,CAAC;AAE/B,KAAK,YAAY,GAAG,MAAM,GAAG,aAAa,CAAC;AAE3C,UAAU,uBAAuB;IAC/B,KAAK,EAAE,aAAa,CAAC;IACrB,SAAS,EAAE,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,KAAK,YAAY,CAAC;IAC9D,YAAY,EAAE,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,KAAK,YAAY,CAAC;IACjE,UAAU,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,OAAO,CAAC;IACzC,UAAU,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,OAAO,CAAC;IACzC,SAAS,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,OAAO,CAAC;IACxC,MAAM,EAAE,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,KAAK,OAAO,CAAC;CACvD;AAaD,eAAO,MAAM,iBAAiB,uFAiD7B,CAAC"}

package/dist/combinatorics/stirlingS2.d.ts

@@ -17,6 +17,6 @@ interface StirlingS2Dependencies {
     bignumber?: (x: NumericValue) => BigNumberType;
     larger: (x: NumericValue, y: NumericValue) => boolean;
 }
-export declare const createStirlingS2: import("../utils/factory.js").FactoryFunction<StirlingS2Dependencies, unknown>;
+export declare const createStirlingS2: import("../utils/factory.js").FactoryFunction<StirlingS2Dependencies, TypedFunction>;
 export {};
 //# sourceMappingURL=stirlingS2.d.ts.map

package/dist/combinatorics/stirlingS2.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stirlingS2.d.ts","sourceRoot":"","sources":["../../src/combinatorics/stirlingS2.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAGhE,KAAK,aAAa,GAAG,SAAS,CAAC;AAE/B,KAAK,YAAY,GAAG,MAAM,GAAG,aAAa,CAAC;AAE3C,UAAU,sBAAsB;IAC9B,KAAK,EAAE,aAAa,CAAC;IACrB,SAAS,EAAE,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,KAAK,YAAY,CAAC;IAC9D,cAAc,EAAE,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,KAAK,YAAY,CAAC;IACnE,cAAc,EAAE,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,KAAK,YAAY,CAAC;IACnE,YAAY,EAAE,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,KAAK,YAAY,CAAC;IACjE,GAAG,EAAE,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,KAAK,YAAY,CAAC;IACxD,SAAS,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,YAAY,CAAC;IAC7C,YAAY,EAAE,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,KAAK,YAAY,CAAC;IACjE,UAAU,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,OAAO,CAAC;IACzC,SAAS,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,OAAO,CAAC;IACxC,MAAM,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,MAAM,CAAC;IACpC,SAAS,CAAC,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,aAAa,CAAC;IAC/C,MAAM,EAAE,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,KAAK,OAAO,CAAC;CACvD;AAmBD,eAAO,MAAM,gBAAgB,gFAwF5B,CAAC"}
+{"version":3,"file":"stirlingS2.d.ts","sourceRoot":"","sources":["../../src/combinatorics/stirlingS2.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAGhE,KAAK,aAAa,GAAG,SAAS,CAAC;AAE/B,KAAK,YAAY,GAAG,MAAM,GAAG,aAAa,CAAC;AAE3C,UAAU,sBAAsB;IAC9B,KAAK,EAAE,aAAa,CAAC;IACrB,SAAS,EAAE,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,KAAK,YAAY,CAAC;IAC9D,cAAc,EAAE,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,KAAK,YAAY,CAAC;IACnE,cAAc,EAAE,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,KAAK,YAAY,CAAC;IACnE,YAAY,EAAE,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,KAAK,YAAY,CAAC;IACjE,GAAG,EAAE,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,KAAK,YAAY,CAAC;IACxD,SAAS,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,YAAY,CAAC;IAC7C,YAAY,EAAE,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,KAAK,YAAY,CAAC;IACjE,UAAU,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,OAAO,CAAC;IACzC,SAAS,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,OAAO,CAAC;IACxC,MAAM,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,MAAM,CAAC;IACpC,SAAS,CAAC,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,aAAa,CAAC;IAC/C,MAAM,EAAE,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,KAAK,OAAO,CAAC;CACvD;AAmBD,eAAO,MAAM,gBAAgB,sFAwF5B,CAAC"}

package/dist/complex/arg.d.ts

@@ -2,6 +2,6 @@ import type { TypedFunction } from '../core/function/typed.js';
 interface ArgDependencies {
     typed: TypedFunction;
 }
-export declare const createArg: import("../utils/factory.js").FactoryFunction<ArgDependencies, unknown>;
+export declare const createArg: import("../utils/factory.js").FactoryFunction<ArgDependencies, TypedFunction>;
 export {};
 //# sourceMappingURL=arg.d.ts.map

package/dist/complex/arg.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"arg.d.ts","sourceRoot":"","sources":["../../src/complex/arg.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAc/D,UAAU,eAAe;IACvB,KAAK,EAAE,aAAa,CAAC;CACtB;AAKD,eAAO,MAAM,SAAS,yEAmDrB,CAAC"}
+{"version":3,"file":"arg.d.ts","sourceRoot":"","sources":["../../src/complex/arg.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAc/D,UAAU,eAAe;IACvB,KAAK,EAAE,aAAa,CAAC;CACtB;AAKD,eAAO,MAAM,SAAS,+EAmDrB,CAAC"}

package/dist/complex/conj.d.ts

@@ -2,6 +2,6 @@ import type { TypedFunction } from '../core/function/typed.js';
 interface ConjDependencies {
     typed: TypedFunction;
 }
-export declare const createConj: import("../utils/factory.js").FactoryFunction<ConjDependencies, unknown>;
+export declare const createConj: import("../utils/factory.js").FactoryFunction<ConjDependencies, TypedFunction>;
 export {};
 //# sourceMappingURL=conj.d.ts.map

package/dist/complex/conj.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conj.d.ts","sourceRoot":"","sources":["../../src/complex/conj.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAO/D,UAAU,gBAAgB;IACxB,KAAK,EAAE,aAAa,CAAC;CACtB;AAKD,eAAO,MAAM,UAAU,0EA8CtB,CAAC"}
+{"version":3,"file":"conj.d.ts","sourceRoot":"","sources":["../../src/complex/conj.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAO/D,UAAU,gBAAgB;IACxB,KAAK,EAAE,aAAa,CAAC;CACtB;AAKD,eAAO,MAAM,UAAU,gFA8CtB,CAAC"}

package/dist/complex/im.d.ts

@@ -2,6 +2,6 @@ import type { TypedFunction } from '../core/function/typed.js';
 interface ImDependencies {
     typed: TypedFunction;
 }
-export declare const createIm: import("../utils/factory.js").FactoryFunction<ImDependencies, unknown>;
+export declare const createIm: import("../utils/factory.js").FactoryFunction<ImDependencies, TypedFunction>;
 export {};
 //# sourceMappingURL=im.d.ts.map

package/dist/complex/im.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"im.d.ts","sourceRoot":"","sources":["../../src/complex/im.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAgB/D,UAAU,cAAc;IACtB,KAAK,EAAE,aAAa,CAAC;CACtB;AAKD,eAAO,MAAM,QAAQ,wEAuCnB,CAAC"}
+{"version":3,"file":"im.d.ts","sourceRoot":"","sources":["../../src/complex/im.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAgB/D,UAAU,cAAc;IACtB,KAAK,EAAE,aAAa,CAAC;CACtB;AAKD,eAAO,MAAM,QAAQ,8EAuCnB,CAAC"}

package/dist/complex/re.d.ts

@@ -2,6 +2,6 @@ import type { TypedFunction } from '../core/function/typed.js';
 interface ReDependencies {
     typed: TypedFunction;
 }
-export declare const createRe: import("../utils/factory.js").FactoryFunction<ReDependencies, unknown>;
+export declare const createRe: import("../utils/factory.js").FactoryFunction<ReDependencies, TypedFunction>;
 export {};
 //# sourceMappingURL=re.d.ts.map

package/dist/complex/re.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"re.d.ts","sourceRoot":"","sources":["../../src/complex/re.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAQ/D,UAAU,cAAc;IACtB,KAAK,EAAE,aAAa,CAAC;CACtB;AAKD,eAAO,MAAM,QAAQ,wEAuCnB,CAAC"}
+{"version":3,"file":"re.d.ts","sourceRoot":"","sources":["../../src/complex/re.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAQ/D,UAAU,cAAc;IACtB,KAAK,EAAE,aAAa,CAAC;CACtB;AAKD,eAAO,MAAM,QAAQ,8EAuCnB,CAAC"}

package/dist/core/function/typed.d.ts

@@ -39,17 +39,27 @@
  * Type definition for a signature map used in typed functions
  */
 export type TypedSignatures = Record<string, (...args: unknown[]) => unknown>;
+/**
+ * The signatures accepted when creating a typed function. Implementations are typed
+ * `(...args: never[]) => unknown`, the top type for "any function" in an input
+ * position (see `referToSelf` below).
+ */
+type TypedSignatureMap = Record<string, (...args: never[]) => unknown>;
 /**
  * Type definition for a typed function
  */
 export interface TypedFunction {
+    (name: string, signatures: TypedSignatureMap | TypedFunction, ...moreSignatures: Array<TypedSignatureMap | TypedFunction>): TypedFunction;
     (...args: unknown[]): unknown;
     /** The signatures of this typed function (always present on a typed function) */
     signatures: TypedSignatures;
     /** Check if a value is a typed function */
     isTypedFunction: (value: unknown) => value is TypedFunction;
     referToSelf: (callback: (self: TypedFunction) => (...args: never[]) => unknown) => (...args: unknown[]) => unknown;
-    referTo: (...signatureNames: string[]) => (callback: (...refs: Array<(...args: unknown[]) => unknown>) => (...args: never[]) => unknown) => (...args: unknown[]) => unknown;
+    referTo: (...args: [
+        ...signatureNames: string[],
+        callback: (...refs: Array<(...args: unknown[]) => unknown>) => (...args: never[]) => unknown
+    ]) => (...args: unknown[]) => unknown;
     create: () => TypedFunction;
     addTypes: (types: TypeDefinition[]) => void;
     addConversions: (conversions: TypeConversion[]) => void;

package/dist/core/function/typed.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"typed.d.ts","sourceRoot":"","sources":["../../../src/core/function/typed.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAiDH;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,CAAC;AAE9E;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IAC9B,iFAAiF;IACjF,UAAU,EAAE,eAAe,CAAC;IAC5B,2CAA2C;IAC3C,eAAe,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,aAAa,CAAC;IAO5D,WAAW,EAAE,CACX,QAAQ,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,KAC7D,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;IACrC,OAAO,EAAE,CACP,GAAG,cAAc,EAAE,MAAM,EAAE,KACxB,CACH,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,KACzF,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;IACrC,MAAM,EAAE,MAAM,aAAa,CAAC;IAC5B,QAAQ,EAAE,CAAC,KAAK,EAAE,cAAc,EAAE,KAAK,IAAI,CAAC;IAC5C,cAAc,EAAE,CAAC,WAAW,EAAE,cAAc,EAAE,KAAK,IAAI,CAAC;IACxD,aAAa,EAAE,CAAC,UAAU,EAAE,cAAc,KAAK,IAAI,CAAC;IACpD,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,UAAU,EAAE,eAAe,KAAK,OAAO,CAAC;IACpF,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,UAAU,EAAE,eAAe,KAAK,KAAK,CAAC;IAGnF,IAAI,EAAE,CAAC,EAAE,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;IAC3F,OAAO,EAAE,CACP,EAAE,EAAE,aAAa,EACjB,IAAI,EAAE,OAAO,EAAE,KACZ;QACH,cAAc,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC;QAChD,MAAM,EAAE,MAAM,EAAE,CAAC;KAClB,GAAG,IAAI,CAAC;CACV;AAED;;GAEG;AACH,UAAU,oBAAoB;IAC5B,KAAK,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;CAChD;AAED;;GAEG;AACH,UAAU,kBAAkB;IAC1B,KAAK,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACjD;AAED;;GAEG;AACH,UAAU,sBAAsB;IAC9B,KAAK,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;CAChC;AAED;;GAEG;AACH,UAAU,mBAAmB;IAC3B,KAAK,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG;QAAE,OAAO,EAAE,MAAM,MAAM,CAAA;KAAE,CAAC;CAClE;AAED;;GAEG;AACH,UAAU,iBAAiB;IACzB,SAAS,CAAC,EAAE,oBAAoB,CAAC;IACjC,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B,WAAW,CAAC,EAAE,sBAAsB,CAAC;IACrC,QAAQ,CAAC,EAAE,mBAAmB,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;AAEnD;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;CACtC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,CAAC;CAChB,CAAC;AAYF;;;;GAIG;AACH,eAAO,MAAM,WAAW,oFAwWvB,CAAC"}
+{"version":3,"file":"typed.d.ts","sourceRoot":"","sources":["../../../src/core/function/typed.ts"],"names":[],"mappings":"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"}

package/dist/factories/evaluate.d.ts

@@ -8,6 +8,12 @@
  * @packageDocumentation
  */
 import { createEvaluate } from '@danielsimonjr/mathts-expression';
+/** Map-like scope accepted by the expression compiler. */
+interface Scope {
+    has(key: string): boolean;
+    get(key: string): unknown;
+    set(key: string, value: unknown): void;
+}
 /**
  * Parse a math expression string into an AST node.
  * Can be used for inspection or pre-compilation.
@@ -16,21 +22,52 @@ import { createEvaluate } from '@danielsimonjr/mathts-expression';
  * typed-function conversion registrations.
  */
 export declare const parse: Parameters<typeof createEvaluate>[0];
+/**
+ * Options for {@link evaluate}, {@link compileExpr}, and {@link parser}.
+ */
+export interface PhysicsEvaluateOptions {
+    /**
+     * When `true`, disables the pre-compile AST validator.
+     * Only opt out when the host is providing trusted, hand-authored input.
+     */
+    unsafe?: boolean;
+    /**
+     * Opt-in physics reading of bare `e`.
+     *
+     * When `true`, `e` is the elementary charge `1.602176634e-19 C` (a Unit).
+     * `E` stays unbound so a formula can use it for energy. Euler's number is
+     * only `exp(x)`, for example `exp(1)`. An explicit scope binding for `e`
+     * still wins. Default `false`: `e` is Euler's number.
+     */
+    physics?: boolean;
+}
+/**
+ * Scope in which bare `e` is the elementary charge.
+ *
+ * Pass the result as `evaluate`'s scope, or use `{ physics: true }`.
+ * Entries already present on `scope` win, including an explicit `e`.
+ */
+export declare function physicsScope(scope?: Record<string, unknown> | Scope): Record<string, unknown> | Scope;
 /**
  * Evaluate a math expression string against the full activated math scope.
  *
  * @param expr - Expression string (e.g., '2 + 3', 'sin(pi/2)', 'x^2')
  * @param scope - Optional variable bindings (e.g., { x: 3 })
+ * @param options - Optional flags. `{ physics: true }` reads bare `e` as the elementary charge.
  * @returns The result of evaluating the expression
  *
  * @example
  * ```ts
- * evaluate('2 + 3');            // 5
- * evaluate('sin(pi / 2)');      // 1
- * evaluate('x^2 + 1', { x: 3 }) // 10
+ * evaluate('2 + 3');                              // 5
+ * evaluate('sin(pi / 2)');                        // 1
+ * evaluate('x^2 + 1', { x: 3 });                  // 10
+ * evaluate('e');                                  // Euler's number
+ * evaluate('e', undefined, { physics: true });    // 1.602176634e-19 C
+ * evaluate('exp(1)', undefined, { physics: true }); // Euler's number
  * ```
  */
-export declare const evaluate: ReturnType<typeof createEvaluate>;
+export declare function evaluate(expr: string, scope?: Record<string, unknown> | Scope, options?: PhysicsEvaluateOptions): unknown;
+export declare function evaluate(exprs: string[], scope?: Record<string, unknown> | Scope, options?: PhysicsEvaluateOptions): unknown[];
 /**
  * Compile a math expression into a reusable CompiledExpression.
  *
@@ -38,6 +75,7 @@ export declare const evaluate: ReturnType<typeof createEvaluate>;
  * many times with different variable bindings.
  *
  * @param expr - Expression string to compile
+ * @param options - Optional flags. `{ physics: true }` reads bare `e` as the elementary charge.
  * @returns CompiledExpression with an evaluate(scope?) method
  *
  * @example
@@ -45,9 +83,10 @@ export declare const evaluate: ReturnType<typeof createEvaluate>;
  * const compiled = compileExpr('x^2 + y');
  * compiled.evaluate({ x: 2, y: 1 }); // 5
  * compiled.evaluate({ x: 3, y: 2 }); // 11
+ * compileExpr('e', { physics: true }).evaluate(); // 1.602176634e-19 C
  * ```
  */
-export declare function compileExpr(expr: string): import("@danielsimonjr/mathts-expression").CompiledExpression;
+export declare function compileExpr(expr: string, options?: PhysicsEvaluateOptions): import("@danielsimonjr/mathts-expression").CompiledExpression;
 /**
  * A stateful parser with a retained scope. Variables persist across
  * `evaluate` calls.
@@ -55,6 +94,7 @@ export declare function compileExpr(expr: string): import("@danielsimonjr/mathts
  * Assignment expressions (`x = 5`) are rejected by the expression security
  * validator — manage retained state with `set` / `get` instead.
  *
+ * @param options - Optional flags. `{ physics: true }` reads bare `e` as the elementary charge.
  * @example
  * ```ts
  * const p = parser();
@@ -62,9 +102,10 @@ export declare function compileExpr(expr: string): import("@danielsimonjr/mathts
  * p.evaluate('x^2');               // 9
  * p.set('y', p.evaluate('x + 1')); // retain a computed value
  * p.get('y');                      // 4
+ * parser({ physics: true }).evaluate('exp(1)'); // Euler's number
  * ```
  */
-export declare function parser(): {
+export declare function parser(options?: PhysicsEvaluateOptions): {
     /** The live scope object — assignments during `evaluate` land here. */
     scope: Record<string, unknown>;
     /** Evaluate an expression against the retained scope. */
@@ -88,4 +129,5 @@ export declare function replacer(_key: string, value: unknown): unknown;
  * non-finite numbers tagged by {@link replacer} / the types' own `toJSON()`.
  */
 export declare function reviver(_key: string, value: unknown): unknown;
+export {};
 //# sourceMappingURL=evaluate.d.ts.map

package/dist/factories/evaluate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"evaluate.d.ts","sourceRoot":"","sources":["../../src/factories/evaluate.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,cAAc,EAEf,MAAM,kCAAkC,CAAC;AAiG1C;;;;;;GAMG;AACH,eAAO,MAAM,KAAK,EAAyB,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;AAMhF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,QAAQ,EAAE,UAAU,CAAC,OAAO,cAAc,CAAoC,CAAC;AAE5F;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,iEAEvC;AAMD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,MAAM;IAGlB,uEAAuE;;IAEvE,yDAAyD;mBAC1C,MAAM,GAAG,OAAO;IAG/B,gCAAgC;cACtB,MAAM,GAAG,OAAO;IAG1B,+BAA+B;cACrB,MAAM,SAAS,OAAO,GAAG,IAAI;IAGvC,kCAAkC;iBACrB,MAAM,GAAG,IAAI;IAG1B,oCAAoC;aAC3B,IAAI;EAIhB;AAMD;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAO9D;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAgB7D"}
+{"version":3,"file":"evaluate.d.ts","sourceRoot":"","sources":["../../src/factories/evaluate.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,cAAc,EAEf,MAAM,kCAAkC,CAAC;AAgB1C,0DAA0D;AAC1D,UAAU,KAAK;IACb,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC1B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC1B,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;CACxC;AAqFD;;;;;;GAMG;AACH,eAAO,MAAM,KAAK,EAAyB,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;AAmBhF;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAWD;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,KAAK,GACtC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,KAAK,CAmBjC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,QAAQ,CACtB,IAAI,EAAE,MAAM,EACZ,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,KAAK,EACvC,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC;AACX,wBAAgB,QAAQ,CACtB,KAAK,EAAE,MAAM,EAAE,EACf,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,KAAK,EACvC,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,EAAE,CAAC;AAYb;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,sBAAsB,iEAazE;AAMD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,MAAM,CAAC,OAAO,CAAC,EAAE,sBAAsB;IAOnD,uEAAuE;;IAEvE,yDAAyD;mBAC1C,MAAM,GAAG,OAAO;IAG/B,gCAAgC;cACtB,MAAM,GAAG,OAAO;IAG1B,+BAA+B;cACrB,MAAM,SAAS,OAAO,GAAG,IAAI;IAGvC,kCAAkC;iBACrB,MAAM,GAAG,IAAI;IAG1B,oCAAoC;aAC3B,IAAI;EAIhB;AAMD;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAO9D;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAgB7D"}