@cortex-js/compute-engine 0.55.2 → 0.55.3

package/dist/core.umd.cjs

@@ -1,4 +1,4 @@
-/** ComputeEngineCore 0.55.2 */
+/** ComputeEngineCore 0.55.3 */
     (function(global,factory){typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports) : typeof define === 'function' && define.amd ? define(['exports'],factory):(global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global.ComputeEngineCore = {}));})(this, (function (exports) { 'use strict';
 var ComputeEngineCore = (() => {
   var __defProp = Object.defineProperty;
@@ -30731,8 +30731,7 @@ ${lines.join("\n")}`;
         broadcastable: true,
         idempotent: true,
         complexity: 1200,
-        signature: "(number) -> number",
-        type: ([x]) => x.type,
+        signature: "(number) -> real",
         sgn: ([x]) => {
           if (x.isSame(0)) return "zero";
           if (isNumber(x)) return "positive";
@@ -54283,8 +54282,11 @@ Error in definition of "${name}"`,
         for (const local of locals) {
           for (const arg of args) {
             if (isFunction2(arg, "Assign") && isSymbol2(arg.ops[0], local)) {
-              if (_BaseCompiler.isComplexValued(arg.ops[1])) {
+              const rhs = arg.ops[1];
+              if (_BaseCompiler.isComplexValued(rhs)) {
                 typeHints[local] = isWGSL ? "vec2f" : "vec2";
+              } else if (_BaseCompiler.isIntegerValued(rhs)) {
+                typeHints[local] = isWGSL ? "i32" : "int";
               }
               break;
             }
@@ -54489,12 +54491,9 @@ Error in definition of "${name}"`,
     /**
      * Determine at compile time whether an expression produces a complex value.
      *
-     * Rules:
-     * - Numbers: complex if im !== 0
-     * - Symbols: ImaginaryUnit is complex; others use expr.isReal
-     *   (undefined is treated as real -- assume-real policy)
-     * - Functions: Abs, Arg, Re, Im always return real.
-     *   All others: complex if any operand is complex.
+     * Uses the expression's declared type (from operator signatures) when
+     * available. Falls back to operand inspection for functions whose
+     * return type is unknown.
      */
     static isComplexValued(expr2) {
       if (isNumber(expr2)) return expr2.im !== 0;
@@ -54505,13 +54504,24 @@ Error in definition of "${name}"`,
         return t.matches("complex") && !t.matches("real");
       }
       if (isFunction2(expr2)) {
-        const op = expr2.operator;
-        if (op === "Abs" || op === "Arg" || op === "Re" || op === "Im")
-          return false;
+        const t = expr2.type;
+        if (t.matches("complex") && !t.matches("real")) return true;
+        if (t.matches("real")) return false;
         return expr2.ops.some((arg) => _BaseCompiler.isComplexValued(arg));
       }
       return false;
     }
+    /** True if the expression is provably integer-typed. */
+    static isIntegerValued(expr2) {
+      if (isNumber(expr2)) return expr2.im === 0 && Number.isInteger(expr2.re);
+      const t = expr2.type;
+      return t ? t.matches("integer") : false;
+    }
+    /** True if the expression is provably non-negative (sign ≥ 0). */
+    static isNonNegative(expr2) {
+      if (isNumber(expr2)) return expr2.im === 0 && expr2.re >= 0;
+      return expr2.isNonNegative === true;
+    }
     /**
      * Generate a temporary variable name
      */
@@ -54765,14 +54775,27 @@ Error in definition of "${name}"`,
     } catch (e) {
       if (options?.fallback ?? true) {
         console.warn(
-          `Compilation fallback for "${expr2.operator}": ${e.message}`
+          `Compilation fallback for "${expr2.operator}" (target: ${options?.to ?? "javascript"}): ${e.message}`
         );
+        const ce = expr2.engine;
+        const fallbackRun = ((vars) => {
+          ce.pushScope();
+          try {
+            if (vars && typeof vars === "object") {
+              for (const [k, v] of Object.entries(vars))
+                ce.assign(k, v);
+            }
+            return expr2.evaluate().re;
+          } finally {
+            ce.popScope();
+          }
+        });
         return {
           target: options?.to ?? "javascript",
           success: false,
           code: "",
           calling: "expression",
-          run: applicableN1(expr2)
+          run: fallbackRun
         };
       }
       throw e;
@@ -59922,6 +59945,86 @@ Error in definition of "${name}"`,
     for (const symbol2 of Object.values(commonSymbols)) symbol2?.reset();
   }
 
+  // src/compute-engine/compilation/constant-folding.ts
+  function formatFloat(n) {
+    const str = n.toString();
+    if (!str.includes(".") && !str.includes("e") && !str.includes("E")) {
+      return `${str}.0`;
+    }
+    return str;
+  }
+  function tryGetConstant(expr2) {
+    if (!isNumber(expr2)) return void 0;
+    if (expr2.im !== 0) return void 0;
+    const re = expr2.re;
+    if (!isFinite(re)) return void 0;
+    return re;
+  }
+  var NUMERIC_LITERAL_RE = /^-?\d+(\.\d+)?$/;
+  function foldTerms(terms, identity, op) {
+    const identityValue = op === "+" ? 0 : 1;
+    let numericAcc = null;
+    const symbolic = [];
+    for (const term of terms) {
+      if (NUMERIC_LITERAL_RE.test(term)) {
+        const val = parseFloat(term);
+        if (op === "*" && val === 0) return "0.0";
+        if (numericAcc === null) {
+          numericAcc = val;
+        } else {
+          numericAcc = op === "+" ? numericAcc + val : numericAcc * val;
+        }
+      } else {
+        symbolic.push(term);
+      }
+    }
+    if (numericAcc !== null && numericAcc !== identityValue) {
+      symbolic.unshift(formatFloat(numericAcc));
+    }
+    if (symbolic.length === 0) {
+      if (numericAcc !== null) return formatFloat(numericAcc);
+      return identity;
+    }
+    if (symbolic.length === 1) return symbolic[0];
+    return symbolic.join(op === "+" ? " + " : " * ");
+  }
+  function tryGetComplexParts(expr2, compile3) {
+    if (isSymbol2(expr2, "ImaginaryUnit")) {
+      return { re: null, im: "1.0" };
+    }
+    if (isNumber(expr2) && expr2.im !== 0) {
+      const re = expr2.re;
+      const im = expr2.im;
+      return {
+        re: re !== 0 ? formatFloat(re) : null,
+        im: formatFloat(im)
+      };
+    }
+    if (isFunction2(expr2, "Multiply")) {
+      const ops = expr2.ops;
+      const iIndex = ops.findIndex(
+        (op) => isSymbol2(op, "ImaginaryUnit") || isNumber(op) && op.re === 0 && op.im !== 0
+      );
+      if (iIndex >= 0) {
+        const iFactor = ops[iIndex];
+        const iScale = isSymbol2(iFactor, "ImaginaryUnit") ? 1 : iFactor.im;
+        const remaining = ops.filter((_, idx) => idx !== iIndex);
+        if (remaining.length === 0) {
+          return { re: null, im: formatFloat(iScale) };
+        }
+        const compiledFactors = remaining.map((r) => compile3(r));
+        if (iScale !== 1)
+          compiledFactors.unshift(formatFloat(iScale));
+        const imCode = foldTerms(compiledFactors, "1.0", "*");
+        return { re: null, im: imCode };
+      }
+    }
+    if (BaseCompiler.isComplexValued(expr2)) {
+      return null;
+    }
+    return { re: compile3(expr2), im: null };
+  }
+
   // src/compute-engine/compilation/javascript-target.ts
   var JAVASCRIPT_OPERATORS = {
     Add: ["+", 11],
@@ -59945,12 +60048,21 @@ Error in definition of "${name}"`,
     Abs: (args, compile3) => {
       if (BaseCompiler.isComplexValued(args[0]))
         return `_SYS.cabs(${compile3(args[0])})`;
+      if (BaseCompiler.isNonNegative(args[0])) return compile3(args[0]);
       return `Math.abs(${compile3(args[0])})`;
     },
     Add: (args, compile3) => {
       if (args.length === 1) return compile3(args[0]);
       const anyComplex = args.some((a) => BaseCompiler.isComplexValued(a));
-      if (!anyComplex) return `(${args.map((x) => compile3(x)).join(" + ")})`;
+      if (!anyComplex) {
+        const constants = args.map(tryGetConstant);
+        if (constants.every((c) => c !== void 0))
+          return String(constants.reduce((a, b) => a + b, 0));
+        const nonZero = args.filter((a) => tryGetConstant(a) !== 0);
+        if (nonZero.length === 0) return "0";
+        if (nonZero.length === 1) return compile3(nonZero[0]);
+        return `(${nonZero.map((x) => compile3(x)).join(" + ")})`;
+      }
       const parts = args.map((a) => {
         const code = compile3(a);
         return { code, isComplex: BaseCompiler.isComplexValued(a) };
@@ -60007,7 +60119,10 @@ Error in definition of "${name}"`,
       return `Math.atan(${compile3(args[0])})`;
     },
     Artanh: "Math.atanh",
-    Ceil: "Math.ceil",
+    Ceil: (args, compile3) => {
+      if (BaseCompiler.isIntegerValued(args[0])) return compile3(args[0]);
+      return `Math.ceil(${compile3(args[0])})`;
+    },
     Chop: "_SYS.chop",
     Cos: (args, compile3) => {
       if (BaseCompiler.isComplexValued(args[0]))
@@ -60050,7 +60165,10 @@ Error in definition of "${name}"`,
         return `_SYS.cexp(${compile3(args[0])})`;
       return `Math.exp(${compile3(args[0])})`;
     },
-    Floor: "Math.floor",
+    Floor: (args, compile3) => {
+      if (BaseCompiler.isIntegerValued(args[0])) return compile3(args[0]);
+      return `Math.floor(${compile3(args[0])})`;
+    },
     Fract: ([x], compile3) => {
       if (x === null) throw new Error("Fract: no argument");
       return BaseCompiler.inlineExpression("${x} - Math.floor(${x})", compile3(x));
@@ -60146,12 +60264,20 @@ Error in definition of "${name}"`,
       if (BaseCompiler.isComplexValued(base) || BaseCompiler.isComplexValued(exp3)) {
         return `_SYS.cpow(${compile3(base)}, ${compile3(exp3)})`;
       }
-      const expVal = exp3.re;
-      if (expVal === 0.5) return `Math.sqrt(${compile3(base)})`;
-      if (expVal === 1 / 3) return `Math.cbrt(${compile3(base)})`;
-      if (expVal === 1) return compile3(base);
-      if (expVal === -1) return `(1 / (${compile3(base)}))`;
-      if (expVal === -0.5) return `(1 / Math.sqrt(${compile3(base)}))`;
+      const bConst = tryGetConstant(base);
+      const eConst = tryGetConstant(exp3);
+      if (bConst !== void 0 && eConst !== void 0)
+        return String(Math.pow(bConst, eConst));
+      if (eConst === 0) return "1";
+      if (eConst === 1) return compile3(base);
+      if (eConst === 2 && (isSymbol2(base) || isNumber(base))) {
+        const code = compile3(base);
+        return `(${code} * ${code})`;
+      }
+      if (eConst === -1) return `(1 / (${compile3(base)}))`;
+      if (eConst === 0.5) return `Math.sqrt(${compile3(base)})`;
+      if (eConst === 1 / 3) return `Math.cbrt(${compile3(base)})`;
+      if (eConst === -0.5) return `(1 / Math.sqrt(${compile3(base)}))`;
       return `Math.pow(${compile3(base)}, ${compile3(exp3)})`;
     },
     Range: (args, compile3) => {
@@ -60188,16 +60314,29 @@ Error in definition of "${name}"`,
     Root: ([arg, exp3], compile3) => {
       if (arg === null) throw new Error("Root: no argument");
       if (exp3 === null) return `Math.sqrt(${compile3(arg)})`;
-      if (exp3?.re === 2) return `Math.sqrt(${compile3(arg)})`;
-      if (exp3?.re === 3) return `Math.cbrt(${compile3(arg)})`;
-      if (!isNaN(exp3?.re)) return `Math.pow(${compile3(arg)},  ${1 / exp3.re})`;
+      const aConst = tryGetConstant(arg);
+      const nConst = tryGetConstant(exp3);
+      if (aConst !== void 0 && nConst !== void 0 && nConst !== 0)
+        return String(Math.pow(aConst, 1 / nConst));
+      if (nConst === 2) return `Math.sqrt(${compile3(arg)})`;
+      if (nConst === 3) return `Math.cbrt(${compile3(arg)})`;
+      if (nConst !== void 0) return `Math.pow(${compile3(arg)}, ${1 / nConst})`;
       return `Math.pow(${compile3(arg)}, 1 / (${compile3(exp3)}))`;
     },
     Random: "Math.random",
-    Round: "Math.round",
+    Round: (args, compile3) => {
+      if (BaseCompiler.isIntegerValued(args[0])) return compile3(args[0]);
+      return `Math.round(${compile3(args[0])})`;
+    },
     Square: (args, compile3) => {
       const arg = args[0];
       if (arg === null) throw new Error("Square: no argument");
+      const c = tryGetConstant(arg);
+      if (c !== void 0) return String(c * c);
+      if (isSymbol2(arg)) {
+        const code = compile3(arg);
+        return `(${code} * ${code})`;
+      }
       return `Math.pow(${compile3(arg)}, 2)`;
     },
     Sec: (args, compile3) => {
@@ -60230,6 +60369,8 @@ Error in definition of "${name}"`,
     Sqrt: (args, compile3) => {
       if (BaseCompiler.isComplexValued(args[0]))
         return `_SYS.csqrt(${compile3(args[0])})`;
+      const c = tryGetConstant(args[0]);
+      if (c !== void 0) return String(Math.sqrt(c));
       return `Math.sqrt(${compile3(args[0])})`;
     },
     Tan: (args, compile3) => {
@@ -60246,9 +60387,14 @@ Error in definition of "${name}"`,
       if (a === null || b === null) throw new Error("Mod: missing argument");
       const ca = compile3(a);
       const cb = compile3(b);
+      if (BaseCompiler.isIntegerValued(a) && BaseCompiler.isIntegerValued(b) && BaseCompiler.isNonNegative(a))
+        return `(${ca} % ${cb})`;
       return `((${ca} % ${cb}) + ${cb}) % ${cb}`;
     },
-    Truncate: "Math.trunc",
+    Truncate: (args, compile3) => {
+      if (BaseCompiler.isIntegerValued(args[0])) return compile3(args[0]);
+      return `Math.trunc(${compile3(args[0])})`;
+    },
     Remainder: ([a, b], compile3) => {
       if (a === null || b === null)
         throw new Error("Remainder: missing argument");
@@ -60256,25 +60402,20 @@ Error in definition of "${name}"`,
         a
       )} / ${compile3(b)}))`;
     },
-    // Arithmetic operators handled as functions for completeness
-    Subtract: ([a, b], compile3) => {
-      if (a === null || b === null) throw new Error("Subtract: missing argument");
-      const ac = BaseCompiler.isComplexValued(a);
-      const bc = BaseCompiler.isComplexValued(b);
-      if (!ac && !bc) return `(${compile3(a)} - ${compile3(b)})`;
-      const ca = compile3(a);
-      const cb = compile3(b);
-      const reA = ac ? `(${ca}).re` : ca;
-      const imA = ac ? `(${ca}).im` : "0";
-      const reB = bc ? `(${cb}).re` : cb;
-      const imB = bc ? `(${cb}).im` : "0";
-      return `({ re: ${reA} - ${reB}, im: ${imA} - ${imB} })`;
-    },
+    // No Subtract function handler — Subtract canonicalizes to Add+Negate.
+    // The operator entry in JAVASCRIPT_OPERATORS handles any edge cases.
     Divide: ([a, b], compile3) => {
       if (a === null || b === null) throw new Error("Divide: missing argument");
       const ac = BaseCompiler.isComplexValued(a);
       const bc = BaseCompiler.isComplexValued(b);
-      if (!ac && !bc) return `(${compile3(a)} / ${compile3(b)})`;
+      if (!ac && !bc) {
+        const ca = tryGetConstant(a);
+        const cb = tryGetConstant(b);
+        if (ca !== void 0 && cb !== void 0 && cb !== 0)
+          return String(ca / cb);
+        if (cb === 1) return compile3(a);
+        return `(${compile3(a)} / ${compile3(b)})`;
+      }
       if (ac && bc) {
         return `(() => { const _a = ${compile3(a)}, _b = ${compile3(
           b
@@ -60291,13 +60432,26 @@ Error in definition of "${name}"`,
     },
     Negate: ([x], compile3) => {
       if (x === null) throw new Error("Negate: no argument");
-      if (!BaseCompiler.isComplexValued(x)) return `(-${compile3(x)})`;
+      if (!BaseCompiler.isComplexValued(x)) {
+        const c = tryGetConstant(x);
+        if (c !== void 0) return String(-c);
+        return `(-${compile3(x)})`;
+      }
       return `_SYS.cneg(${compile3(x)})`;
     },
     Multiply: (args, compile3) => {
       if (args.length === 1) return compile3(args[0]);
       const anyComplex = args.some((a) => BaseCompiler.isComplexValued(a));
-      if (!anyComplex) return `(${args.map((x) => compile3(x)).join(" * ")})`;
+      if (!anyComplex) {
+        if (args.some((a) => tryGetConstant(a) === 0)) return "0";
+        const constants = args.map(tryGetConstant);
+        if (constants.every((c) => c !== void 0))
+          return String(constants.reduce((a, b) => a * b, 1));
+        const nonOne = args.filter((a) => tryGetConstant(a) !== 1);
+        if (nonOne.length === 0) return "1";
+        if (nonOne.length === 1) return compile3(nonOne[0]);
+        return `(${nonOne.map((x) => compile3(x)).join(" * ")})`;
+      }
       if (args.length === 2) {
         const ac = BaseCompiler.isComplexValued(args[0]);
         const bc = BaseCompiler.isComplexValued(args[1]);
@@ -60382,20 +60536,30 @@ Error in definition of "${name}"`,
     AiryAi: "_SYS.airyAi",
     AiryBi: "_SYS.airyBi",
     // Combinatorics
+    Mandelbrot: ([c, maxIter], compile3) => {
+      if (c === null || maxIter === null)
+        throw new Error("Mandelbrot: missing arguments");
+      return `_SYS.mandelbrot(${compile3(c)}, ${compile3(maxIter)})`;
+    },
+    Julia: ([z, c, maxIter], compile3) => {
+      if (z === null || c === null || maxIter === null)
+        throw new Error("Julia: missing arguments");
+      return `_SYS.julia(${compile3(z)}, ${compile3(c)}, ${compile3(maxIter)})`;
+    },
     Binomial: (args, compile3) => `_SYS.binomial(${compile3(args[0])}, ${compile3(args[1])})`,
     Fibonacci: "_SYS.fibonacci",
     // Complex-specific functions
-    Re: (args, compile3) => {
+    Real: (args, compile3) => {
       if (BaseCompiler.isComplexValued(args[0]))
         return `(${compile3(args[0])}).re`;
       return compile3(args[0]);
     },
-    Im: (args, compile3) => {
+    Imaginary: (args, compile3) => {
       if (BaseCompiler.isComplexValued(args[0]))
         return `(${compile3(args[0])}).im`;
       return "0";
     },
-    Arg: (args, compile3) => {
+    Argument: (args, compile3) => {
       if (BaseCompiler.isComplexValued(args[0]))
         return `_SYS.carg(${compile3(args[0])})`;
       return `(${compile3(args[0])} >= 0 ? 0 : Math.PI)`;
@@ -60731,6 +60895,41 @@ Error in definition of "${name}"`,
     sinc,
     fresnelS,
     fresnelC,
+    mandelbrot: (c, maxIter) => {
+      let zx = 0, zy = 0;
+      const cx = typeof c === "number" ? c : c.re;
+      const cy = typeof c === "number" ? 0 : c.im;
+      const n = Math.round(maxIter);
+      for (let i = 0; i < n; i++) {
+        const newZx = zx * zx - zy * zy + cx;
+        zy = 2 * zx * zy + cy;
+        zx = newZx;
+        const mag2 = zx * zx + zy * zy;
+        if (mag2 > 4) {
+          const smooth = (i - Math.log2(Math.log2(mag2)) + 4) / n;
+          return Math.max(0, Math.min(1, smooth));
+        }
+      }
+      return 1;
+    },
+    julia: (z, c, maxIter) => {
+      let zx = typeof z === "number" ? z : z.re;
+      let zy = typeof z === "number" ? 0 : z.im;
+      const cx = typeof c === "number" ? c : c.re;
+      const cy = typeof c === "number" ? 0 : c.im;
+      const n = Math.round(maxIter);
+      for (let i = 0; i < n; i++) {
+        const newZx = zx * zx - zy * zy + cx;
+        zy = 2 * zx * zy + cy;
+        zx = newZx;
+        const mag2 = zx * zx + zy * zy;
+        if (mag2 > 4) {
+          const smooth = (i - Math.log2(Math.log2(mag2)) + 4) / n;
+          return Math.max(0, Math.min(1, smooth));
+        }
+      }
+      return 1;
+    },
     binomial: choose,
     fibonacci,
     // Complex helpers
@@ -61076,6 +61275,7 @@ Error in definition of "${name}"`,
     Add: ["+", 11],
     Negate: ["-", 14],
     Subtract: ["-", 11],
+    // Subtract canonicalizes to Add+Negate; kept as fallback
     Multiply: ["*", 12],
     Divide: ["/", 13],
     Equal: ["==", 8],
@@ -61091,6 +61291,12 @@ Error in definition of "${name}"`,
   function gpuVec2(target) {
     return target?.language === "wgsl" ? "vec2f" : "vec2";
   }
+  function compileIntArg(expr2, compile3, target) {
+    const c = tryGetConstant(expr2);
+    if (c !== void 0 && Number.isInteger(c)) return c.toString();
+    const intCast = target?.language === "wgsl" ? "i32" : "int";
+    return `${intCast}(${compile3(expr2)})`;
+  }
   var GPU_UNROLL_LIMIT = 100;
   function compileGPUSumProduct(kind, args, _compile2, target) {
     if (!args[0]) throw new Error(`${kind}: no body`);
@@ -61153,88 +61359,113 @@ Error in definition of "${name}"`,
       if (args.length === 0) return "0.0";
       if (args.length === 1) return compile3(args[0]);
       const anyComplex = args.some((a) => BaseCompiler.isComplexValued(a));
-      if (!anyComplex) return args.map((x) => compile3(x)).join(" + ");
-      const v2 = gpuVec2(target);
-      return args.map((a) => {
-        const code = compile3(a);
-        return BaseCompiler.isComplexValued(a) ? code : `${v2}(${code}, 0.0)`;
-      }).join(" + ");
-    },
-    Multiply: (args, compile3, _target) => {
-      if (args.length === 0) return "1.0";
-      if (args.length === 1) return compile3(args[0]);
-      const anyComplex = args.some((a) => BaseCompiler.isComplexValued(a));
-      if (!anyComplex) return args.map((x) => compile3(x)).join(" * ");
-      let result = compile3(args[0]);
-      let resultIsComplex = BaseCompiler.isComplexValued(args[0]);
-      for (let i = 1; i < args.length; i++) {
-        const code = compile3(args[i]);
-        const argIsComplex = BaseCompiler.isComplexValued(args[i]);
-        if (!resultIsComplex && !argIsComplex) {
-          result = `(${result} * ${code})`;
-        } else if (resultIsComplex && !argIsComplex) {
-          result = `(${code} * ${result})`;
-        } else if (!resultIsComplex && argIsComplex) {
-          result = `(${result} * ${code})`;
-          resultIsComplex = true;
-        } else {
-          result = `_gpu_cmul(${result}, ${code})`;
-        }
+      if (!anyComplex) {
+        return foldTerms(
+          args.map((x) => compile3(x)),
+          "0.0",
+          "+"
+        );
       }
-      return result;
-    },
-    Subtract: (args, compile3, target) => {
-      if (args.length === 0) return "0.0";
+      const parts = args.map((a) => tryGetComplexParts(a, compile3));
+      if (parts.some((p) => p === null)) {
+        const v2 = gpuVec2(target);
+        return args.map((a) => {
+          const code = compile3(a);
+          return BaseCompiler.isComplexValued(a) ? code : `${v2}(${code}, 0.0)`;
+        }).join(" + ");
+      }
+      const reParts = [];
+      const imParts = [];
+      for (const p of parts) {
+        if (p.re !== null) reParts.push(p.re);
+        if (p.im !== null) imParts.push(p.im);
+      }
+      const reSum = foldTerms(reParts, "0.0", "+");
+      const imSum = foldTerms(imParts, "0.0", "+");
+      return `${gpuVec2(target)}(${reSum}, ${imSum})`;
+    },
+    Multiply: (args, compile3, target) => {
+      if (args.length === 0) return "1.0";
       if (args.length === 1) return compile3(args[0]);
       const anyComplex = args.some((a) => BaseCompiler.isComplexValued(a));
       if (!anyComplex) {
-        if (args.length === 2) return `${compile3(args[0])} - ${compile3(args[1])}`;
-        let result2 = compile3(args[0]);
-        for (let i = 1; i < args.length; i++) {
-          result2 = `${result2} - ${compile3(args[i])}`;
-        }
-        return result2;
-      }
-      const v2 = gpuVec2(target);
-      const promote = (a) => {
-        const code = compile3(a);
-        return BaseCompiler.isComplexValued(a) ? code : `${v2}(${code}, 0.0)`;
-      };
-      if (args.length === 2) return `${promote(args[0])} - ${promote(args[1])}`;
-      let result = promote(args[0]);
-      for (let i = 1; i < args.length; i++) {
-        result = `${result} - ${promote(args[i])}`;
+        return foldTerms(
+          args.map((x) => compile3(x)),
+          "1.0",
+          "*"
+        );
       }
+      const iIndex = args.findIndex(
+        (op) => isSymbol2(op, "ImaginaryUnit") || isNumber(op) && op.re === 0 && op.im !== 0
+      );
+      if (iIndex >= 0) {
+        const iFactor = args[iIndex];
+        const iScale = isSymbol2(iFactor, "ImaginaryUnit") ? 1 : iFactor.im;
+        const realFactors = args.filter((_, i) => i !== iIndex);
+        const v2 = gpuVec2(target);
+        if (realFactors.length === 0)
+          return `${v2}(0.0, ${formatFloat(iScale)})`;
+        const factors = realFactors.map((f) => compile3(f));
+        if (iScale !== 1) factors.unshift(formatFloat(iScale));
+        const imCode = foldTerms(factors, "1.0", "*");
+        return `${v2}(0.0, ${imCode})`;
+      }
+      const realCodes = [];
+      const complexCodes = [];
+      for (const a of args) {
+        if (BaseCompiler.isComplexValued(a)) complexCodes.push(compile3(a));
+        else realCodes.push(compile3(a));
+      }
+      const scalarCode = foldTerms(realCodes, "1.0", "*");
+      let result = complexCodes[0];
+      for (let i = 1; i < complexCodes.length; i++) {
+        result = `_gpu_cmul(${result}, ${complexCodes[i]})`;
+      }
+      if (scalarCode !== "1.0") result = `(${scalarCode} * ${result})`;
       return result;
     },
+    // No Subtract function handler — Subtract canonicalizes to Add+Negate.
+    // The operator entry in GPU_OPERATORS handles any edge cases.
     Divide: (args, compile3, target) => {
       if (args.length === 0) return "1.0";
       if (args.length === 1) return compile3(args[0]);
       const ac = BaseCompiler.isComplexValued(args[0]);
       const bc = args.length >= 2 && BaseCompiler.isComplexValued(args[1]);
       if (!ac && !bc) {
-        if (args.length === 2) return `${compile3(args[0])} / ${compile3(args[1])}`;
+        if (args.length === 2) {
+          const a = tryGetConstant(args[0]);
+          const b = tryGetConstant(args[1]);
+          if (a !== void 0 && b !== void 0 && b !== 0)
+            return formatFloat(a / b);
+          if (b === 1) return compile3(args[0]);
+          return `${compile3(args[0])} / ${compile3(args[1])}`;
+        }
         let result = compile3(args[0]);
-        for (let i = 1; i < args.length; i++) {
+        for (let i = 1; i < args.length; i++)
           result = `${result} / ${compile3(args[i])}`;
-        }
         return result;
       }
       if (ac && bc) return `_gpu_cdiv(${compile3(args[0])}, ${compile3(args[1])})`;
-      if (ac && !bc) {
-        return `(${compile3(args[0])} / ${compile3(args[1])})`;
-      }
+      if (ac && !bc) return `(${compile3(args[0])} / ${compile3(args[1])})`;
       const v2 = gpuVec2(target);
       return `_gpu_cdiv(${v2}(${compile3(args[0])}, 0.0), ${compile3(args[1])})`;
     },
-    Negate: ([x], compile3) => {
+    Negate: ([x], compile3, target) => {
       if (x === null) throw new Error("Negate: no argument");
+      const c = tryGetConstant(x);
+      if (c !== void 0) return formatFloat(-c);
+      if (isNumber(x) && x.im !== 0) {
+        return `${gpuVec2(target)}(${formatFloat(-x.re)}, ${formatFloat(-x.im)})`;
+      }
+      if (isSymbol2(x, "ImaginaryUnit"))
+        return `${gpuVec2(target)}(0.0, -1.0)`;
       return `(-${compile3(x)})`;
     },
     // Standard math functions with complex dispatch
     Abs: (args, compile3) => {
       if (BaseCompiler.isComplexValued(args[0]))
         return `length(${compile3(args[0])})`;
+      if (BaseCompiler.isNonNegative(args[0])) return compile3(args[0]);
       return `abs(${compile3(args[0])})`;
     },
     Arccos: (args, compile3) => {
@@ -61252,7 +61483,10 @@ Error in definition of "${name}"`,
         return `_gpu_catan(${compile3(args[0])})`;
       return `atan(${compile3(args[0])})`;
     },
-    Ceil: "ceil",
+    Ceil: (args, compile3) => {
+      if (BaseCompiler.isIntegerValued(args[0])) return compile3(args[0]);
+      return `ceil(${compile3(args[0])})`;
+    },
     Clamp: "clamp",
     Cos: (args, compile3) => {
       if (BaseCompiler.isComplexValued(args[0]))
@@ -61266,7 +61500,10 @@ Error in definition of "${name}"`,
       return `exp(${compile3(args[0])})`;
     },
     Exp2: "exp2",
-    Floor: "floor",
+    Floor: (args, compile3) => {
+      if (BaseCompiler.isIntegerValued(args[0])) return compile3(args[0]);
+      return `floor(${compile3(args[0])})`;
+    },
     Fract: "fract",
     Ln: (args, compile3) => {
       if (BaseCompiler.isComplexValued(args[0]))
@@ -61288,10 +61525,25 @@ Error in definition of "${name}"`,
         const eCode = BaseCompiler.isComplexValued(exp3) ? compile3(exp3) : `${v2}(${compile3(exp3)}, 0.0)`;
         return `_gpu_cpow(${bCode}, ${eCode})`;
       }
+      const bConst = tryGetConstant(base);
+      const eConst = tryGetConstant(exp3);
+      if (bConst !== void 0 && eConst !== void 0)
+        return formatFloat(Math.pow(bConst, eConst));
+      if (eConst === 0) return "1.0";
+      if (eConst === 1) return compile3(base);
+      if (eConst === 2 && (isSymbol2(base) || isNumber(base))) {
+        const code = compile3(base);
+        return `(${code} * ${code})`;
+      }
+      if (eConst === -1) return `(1.0 / ${compile3(base)})`;
+      if (eConst === 0.5) return `sqrt(${compile3(base)})`;
       return `pow(${compile3(base)}, ${compile3(exp3)})`;
     },
     Radians: "radians",
-    Round: "round",
+    Round: (args, compile3) => {
+      if (BaseCompiler.isIntegerValued(args[0])) return compile3(args[0]);
+      return `round(${compile3(args[0])})`;
+    },
     Sign: "sign",
     Sin: (args, compile3) => {
       if (BaseCompiler.isComplexValued(args[0]))
@@ -61302,6 +61554,8 @@ Error in definition of "${name}"`,
     Sqrt: (args, compile3) => {
       if (BaseCompiler.isComplexValued(args[0]))
         return `_gpu_csqrt(${compile3(args[0])})`;
+      const c = tryGetConstant(args[0]);
+      if (c !== void 0) return formatFloat(Math.sqrt(c));
       return `sqrt(${compile3(args[0])})`;
     },
     Step: "step",
@@ -61310,17 +61564,20 @@ Error in definition of "${name}"`,
         return `_gpu_ctan(${compile3(args[0])})`;
       return `tan(${compile3(args[0])})`;
     },
-    Truncate: "trunc",
+    Truncate: (args, compile3) => {
+      if (BaseCompiler.isIntegerValued(args[0])) return compile3(args[0]);
+      return `trunc(${compile3(args[0])})`;
+    },
     // Complex-specific functions
-    Re: (args, compile3) => {
+    Real: (args, compile3) => {
       if (BaseCompiler.isComplexValued(args[0])) return `(${compile3(args[0])}).x`;
       return compile3(args[0]);
     },
-    Im: (args, compile3) => {
+    Imaginary: (args, compile3) => {
       if (BaseCompiler.isComplexValued(args[0])) return `(${compile3(args[0])}).y`;
       return "0.0";
     },
-    Arg: (args, compile3) => {
+    Argument: (args, compile3) => {
       if (BaseCompiler.isComplexValued(args[0])) {
         const code = compile3(args[0]);
         return `atan(${code}.y, ${code}.x)`;
@@ -61535,13 +61792,20 @@ Error in definition of "${name}"`,
     },
     Square: ([x], compile3) => {
       if (x === null) throw new Error("Square: no argument");
-      const arg = compile3(x);
-      return `(${arg} * ${arg})`;
+      if (isSymbol2(x) || isNumber(x)) {
+        const arg = compile3(x);
+        return `(${arg} * ${arg})`;
+      }
+      return `pow(${compile3(x)}, 2.0)`;
     },
     Root: ([x, n], compile3) => {
       if (x === null) throw new Error("Root: no argument");
       if (n === null || n === void 0) return `sqrt(${compile3(x)})`;
-      if (n?.re === 2) return `sqrt(${compile3(x)})`;
+      const nConst = tryGetConstant(n);
+      if (nConst === 2) return `sqrt(${compile3(x)})`;
+      const xConst = tryGetConstant(x);
+      if (xConst !== void 0 && nConst !== void 0)
+        return formatFloat(Math.pow(xConst, 1 / nConst));
       return `pow(${compile3(x)}, 1.0 / ${compile3(n)})`;
     },
     // Color functions (pure-math, GPU-compilable)
@@ -61583,18 +61847,14 @@ Error in definition of "${name}"`,
     Mandelbrot: ([c, maxIter], compile3, target) => {
       if (c === null || maxIter === null)
         throw new Error("Mandelbrot: missing arguments");
-      const intCast = target?.language === "wgsl" ? "i32" : "int";
-      return `_fractal_mandelbrot(${compile3(c)}, ${intCast}(${compile3(
-        maxIter
-      )}))`;
+      const iterCode = compileIntArg(maxIter, compile3, target);
+      return `_fractal_mandelbrot(${compile3(c)}, ${iterCode})`;
     },
     Julia: ([z, c, maxIter], compile3, target) => {
       if (z === null || c === null || maxIter === null)
         throw new Error("Julia: missing arguments");
-      const intCast = target?.language === "wgsl" ? "i32" : "int";
-      return `_fractal_julia(${compile3(z)}, ${compile3(c)}, ${intCast}(${compile3(
-        maxIter
-      )}))`;
+      const iterCode = compileIntArg(maxIter, compile3, target);
+      return `_fractal_julia(${compile3(z)}, ${compile3(c)}, ${iterCode})`;
     },
     // Vector/Matrix operations
     Cross: "cross",
@@ -64226,6 +64486,7 @@ ${workgroupAttr}fn main(${paramStr})${returnStr} {
     Add: ["_IA.add", 20],
     Negate: ["_IA.negate", 20],
     Subtract: ["_IA.sub", 20],
+    // Subtract canonicalizes to Add+Negate; kept as fallback
     Multiply: ["_IA.mul", 20],
     Divide: ["_IA.div", 20],
     // Comparisons return BoolInterval
@@ -64250,17 +64511,7 @@ ${workgroupAttr}fn main(${paramStr})${returnStr} {
       }
       return result;
     },
-    Subtract: (args, compile3) => {
-      if (args.length === 0) return "_IA.point(0)";
-      if (args.length === 1) return `_IA.negate(${compile3(args[0])})`;
-      if (args.length === 2)
-        return `_IA.sub(${compile3(args[0])}, ${compile3(args[1])})`;
-      let result = compile3(args[0]);
-      for (let i = 1; i < args.length; i++) {
-        result = `_IA.sub(${result}, ${compile3(args[i])})`;
-      }
-      return result;
-    },
+    // No Subtract handler — canonicalizes to Add+Negate before compilation.
     Multiply: (args, compile3) => {
       if (args.length === 0) return "_IA.point(1)";
       if (args.length === 1) return compile3(args[0]);
@@ -67234,7 +67485,9 @@ ${workgroupAttr}fn main(${paramStr})${returnStr} {
         }
         return new ExactNumericValue(value, makeNumericValue);
       }
-      throw Error("Unexpected value");
+      throw Error(
+        `Unexpected value: ${typeof value === "object" ? JSON.stringify(value) : String(value)}`
+      );
     }
     /**
      * The cost function is used to determine the "cost" of an expression. For example, when simplifying an expression, the simplification that results in the lowest cost is chosen.
@@ -67705,7 +67958,7 @@ ${workgroupAttr}fn main(${paramStr})${returnStr} {
   _setDefaultEngineFactory(() => new ComputeEngine());
 
   // src/core.ts
-  var version = "0.55.2";
+  var version = "0.55.3";
   return __toCommonJS(core_exports);
 })();
 /*! Bundled license information: