numbl 0.4.1 → 0.4.2

package/dist-lib/numbl-core/helpers/effectively-real.d.ts

@@ -0,0 +1,25 @@
+/**
+ * "Effectively real" helpers.
+ *
+ * numbl's JIT cannot always prove at compile time that the result of an
+ * operation is real (e.g. `sqrt(1 - x.^2/2)` — the argument's sign is not
+ * statically provable, so `sqrt` lifts to the complex path). The result is
+ * a complex-typed tensor whose imaginary lane is entirely zero — an
+ * artifact of static typing, not a value the user asked to be complex.
+ *
+ * Value-sensitive builtins (`isreal`, `min`, `max`, `sort`, …) must treat
+ * such a tensor exactly as they would a real one: otherwise `min`/`max`
+ * silently switch to magnitude ordering and `isreal` reports `false`,
+ * diverging from the interpreter (`--opt 0`, which never creates the
+ * artifact) and from MATLAB on real data. These helpers detect the
+ * all-zero imaginary lane and drop it so the real code path runs.
+ */
+import type { RuntimeValue } from "../runtime/index.js";
+import { type RuntimeTensor } from "../runtime/types.js";
+/** True when `imag` is absent or every element is exactly zero. */
+export declare function imagAllZero(imag: ArrayLike<number> | undefined): boolean;
+/** If `t` carries an all-zero imaginary lane, return a real view sharing
+ *  its data; otherwise return `t` unchanged. */
+export declare function stripZeroImagTensor(t: RuntimeTensor): RuntimeTensor;
+/** Tensor-aware variant for the generic `RuntimeValue` channel. */
+export declare function stripZeroImagValue(v: RuntimeValue): RuntimeValue;

package/dist-lib/numbl-core/jit/builtins/runtime/snippets.gen.d.ts

@@ -44,6 +44,7 @@ export * from "./tensor_ops/tensor_eye.js";
 export * from "./tensor_ops/tensor_fill_nd.js";
 export * from "./tensor_ops/tensor_fill_square.js";
 export * from "./tensor_ops/tensor_flip.js";
+export * from "./tensor_ops/tensor_imag_all_zero.js";
 export * from "./tensor_ops/tensor_linspace.js";
 export * from "./tensor_ops/tensor_logical_real.js";
 export * from "./tensor_ops/tensor_logspace.js";

package/dist-lib/numbl-core/jit/builtins/runtime/tensor_ops/tensor_imag_all_zero.d.ts

@@ -0,0 +1 @@
+export function mtoc2_tensor_imag_all_zero(a: any): boolean;

package/dist-lib/numbl-core/version.d.ts

@@ -1,2 +1,2 @@
 /** Numbl version, used for JIT disk cache invalidation. */
-export declare const NUMBL_VERSION = "0.4.1";
+export declare const NUMBL_VERSION = "0.4.2";