@thi.ng/tensors 0.10.14 → 0.11.2

package/README.md

@@ -68,6 +68,7 @@ conventions are closely aligned to the ones used by the
 - [addN](https://docs.thi.ng/umbrella/tensors/variables/addN.html): Tensor-scalar addition
 - [argMax](https://docs.thi.ng/umbrella/tensors/functions/argMax.html): Maximum component index/value
 - [argMin](https://docs.thi.ng/umbrella/tensors/functions/argMin.html): Minimum component index/value
+- [cdf](https://docs.thi.ng/umbrella/tensors/variables/cdf.html): Cumulative distribution of 1D tensor
 - [clamp](https://docs.thi.ng/umbrella/tensors/variables/clamp.html): Tensor-tensor interval clamping
 - [clampN](https://docs.thi.ng/umbrella/tensors/variables/clampN.html): Tensor-scalar interval clamping
 - [convolve](https://docs.thi.ng/umbrella/tensors/variables/convolve.html): Tensor convolution (1D/2D/3D only)
@@ -76,8 +77,10 @@ conventions are closely aligned to the ones used by the
 - [div](https://docs.thi.ng/umbrella/tensors/variables/div.html): Tensor-tensor division
 - [divN](https://docs.thi.ng/umbrella/tensors/variables/divN.html): Tensor-scalar division
 - [dot](https://docs.thi.ng/umbrella/tensors/variables/dot.html): Dot product
+- [equalizeHistogram](https://docs.thi.ng/umbrella/tensors/functions/equalizeHistogram.html): histogram equalization
 - [exp](https://docs.thi.ng/umbrella/tensors/variables/exp.html): Componentwise `Math.exp`
 - [exp2](https://docs.thi.ng/umbrella/tensors/variables/exp2.html): Componentwise `2^x`
+- [histogramUint](https://docs.thi.ng/umbrella/tensors/functions/histogramUint.html): histogram of uint-based tensor
 - [identity](https://docs.thi.ng/umbrella/tensors/functions/identity.html): Square identity matrix tensor
 - [integrate](https://docs.thi.ng/umbrella/tensors/functions/integrate.html): Integrate tensor along innermost dimension
 - [log](https://docs.thi.ng/umbrella/tensors/variables/log.html): Componentwise `Math.log`
@@ -250,7 +253,7 @@ For Node.js REPL:
 const ten = await import("@thi.ng/tensors");
 ```
 
-Package sizes (brotli'd, pre-treeshake): ESM: 11.45 KB
+Package sizes (brotli'd, pre-treeshake): ESM: 11.80 KB
 
 ## Dependencies
 

package/api.d.ts

@@ -1,5 +1,4 @@
 import type { Type as $Type, ICopy, IEqualsDelta, IEquiv, ILength, IRelease, Maybe, NumericArray } from "@thi.ng/api";
-import type { Tensor0, Tensor1, Tensor2, Tensor3, Tensor4 } from "./tensor.js";
 export interface TensorData<T = number> extends Iterable<T>, ILength {
     [id: number]: T;
     fill(x: T, start?: number, end?: number): TensorData<T>;
@@ -12,9 +11,9 @@ export type Shape2 = [number, number];
 export type Shape3 = [number, number, number];
 export type Shape4 = [number, number, number, number];
 export type Shape = Shape0 | Shape1 | Shape2 | Shape3 | Shape4;
-export type ShapeTensor<S extends Shape, T> = S extends Shape4 ? Tensor4<T> : S extends Shape3 ? Tensor3<T> : S extends Shape2 ? Tensor2<T> : S extends Shape1 ? Tensor1<T> : Tensor0<T>;
+export type ShapeTensor<S extends Shape, T> = S extends Shape4 ? ITensor4<T> : S extends Shape3 ? ITensor3<T> : S extends Shape2 ? ITensor2<T> : S extends Shape1 ? ITensor1<T> : ITensor0<T>;
 export type Nested<T> = T[] | T[][] | T[][][] | T[][][][];
-export type NestedTensor<N extends Nested<T>, T> = N extends T[][][][] ? Tensor4<T> : N extends T[][][] ? Tensor3<T> : N extends T[][] ? Tensor2<T> : Tensor1<T>;
+export type NestedTensor<N extends Nested<T>, T> = N extends T[][][][] ? ITensor4<T> : N extends T[][][] ? ITensor3<T> : N extends T[][] ? ITensor2<T> : ITensor1<T>;
 export interface TypeMap {
     u8: number;
     u8c: number;
@@ -105,6 +104,7 @@ export interface ITensor<T = number> extends ICopy<ITensor<T>>, IEquiv, IEqualsD
      * @param storage
      */
     empty(storage?: ITensorStorage<T>): this;
+    fill(x: T): this;
     /**
      * Computes linear array index from given grid position. Reverse-op of
      * {@link ITensor.position}.
@@ -116,6 +116,10 @@ export interface ITensor<T = number> extends ICopy<ITensor<T>>, IEquiv, IEqualsD
      * @param pos
      */
     index(pos: NumericArray): number;
+    /**
+     * Returns an iterator of array indices used by this tensor
+     */
+    indices(): IterableIterator<number>;
     /**
      * Computes nD grid position for given linear array index. Reverse-op of
      * {@link ITensor.index}.
@@ -327,6 +331,11 @@ export interface ITensor<T = number> extends ICopy<ITensor<T>>, IEquiv, IEqualsD
      * that of the current shape (otherwise an error will be thrown).
      *
      * @remarks
+     * **IMPORTANT:** If no `newStride` is given, only "dense" tensors can be
+     * reshaped reliably (if in doubt, use {@link ITensor.pack} prior to
+     * reshaping).
+     *
+     * @remarks
      * Also see {@link ITensor.crop} and {@link ITensor.resize}
      *
      * @example
@@ -414,6 +423,21 @@ export interface ITensor<T = number> extends ICopy<ITensor<T>>, IEquiv, IEqualsD
     transpose(order: NumericArray): this;
     toJSON(): any;
 }
+export type ITensor0<T = number> = ITensor<T> & {
+    dim: 0;
+};
+export type ITensor1<T = number> = ITensor<T> & {
+    dim: 1;
+};
+export type ITensor2<T = number> = ITensor<T> & {
+    dim: 2;
+};
+export type ITensor3<T = number> = ITensor<T> & {
+    dim: 3;
+};
+export type ITensor4<T = number> = ITensor<T> & {
+    dim: 4;
+};
 export interface TensorCtor<T = number> {
     new (type: Type, storage: ITensorStorage<T>, data: TensorData<T>, shape: number[], stride: number[], offset?: number): ITensor<T>;
 }
@@ -442,186 +466,193 @@ export interface ITensorStorage<T> {
 }
 export type StorageRegistry = Record<Type, ITensorStorage<any>>;
 export interface TensorOpT<T = number> {
-    (out: Tensor0<T> | null, a: Tensor0<T>): Tensor0<T>;
-    (out: Tensor1<T> | null, a: Tensor1<T>): Tensor1<T>;
-    (out: Tensor2<T> | null, a: Tensor2<T>): Tensor2<T>;
-    (out: Tensor3<T> | null, a: Tensor3<T>): Tensor3<T>;
-    (out: Tensor4<T> | null, a: Tensor4<T>): Tensor4<T>;
+    (out: ITensor0<T> | null, a: ITensor0<T>): ITensor0<T>;
+    (out: ITensor1<T> | null, a: ITensor1<T>): ITensor1<T>;
+    (out: ITensor2<T> | null, a: ITensor2<T>): ITensor2<T>;
+    (out: ITensor3<T> | null, a: ITensor3<T>): ITensor3<T>;
+    (out: ITensor4<T> | null, a: ITensor4<T>): ITensor4<T>;
 }
 export interface TensorOpTT<T = number> {
-    (out: Tensor0<T> | null, a: Tensor0<T>, b: Tensor0<T>): Tensor0<T>;
-    (out: Tensor1<T> | null, a: Tensor0<T>, b: Tensor1<T>): Tensor1<T>;
-    (out: Tensor2<T> | null, a: Tensor0<T>, b: Tensor2<T>): Tensor2<T>;
-    (out: Tensor3<T> | null, a: Tensor0<T>, b: Tensor3<T>): Tensor3<T>;
-    (out: Tensor4<T> | null, a: Tensor0<T>, b: Tensor4<T>): Tensor4<T>;
-    (out: Tensor1<T> | null, a: Tensor1<T>, b: Tensor0<T>): Tensor1<T>;
-    (out: Tensor1<T> | null, a: Tensor1<T>, b: Tensor1<T>): Tensor1<T>;
-    (out: Tensor2<T> | null, a: Tensor1<T>, b: Tensor2<T>): Tensor2<T>;
-    (out: Tensor3<T> | null, a: Tensor1<T>, b: Tensor3<T>): Tensor3<T>;
-    (out: Tensor4<T> | null, a: Tensor1<T>, b: Tensor4<T>): Tensor4<T>;
-    (out: Tensor2<T> | null, a: Tensor2<T>, b: Tensor0<T>): Tensor2<T>;
-    (out: Tensor2<T> | null, a: Tensor2<T>, b: Tensor1<T>): Tensor2<T>;
-    (out: Tensor2<T> | null, a: Tensor2<T>, b: Tensor2<T>): Tensor2<T>;
-    (out: Tensor3<T> | null, a: Tensor2<T>, b: Tensor3<T>): Tensor3<T>;
-    (out: Tensor4<T> | null, a: Tensor2<T>, b: Tensor4<T>): Tensor4<T>;
-    (out: Tensor3<T> | null, a: Tensor3<T>, b: Tensor0<T>): Tensor3<T>;
-    (out: Tensor3<T> | null, a: Tensor3<T>, b: Tensor1<T>): Tensor3<T>;
-    (out: Tensor3<T> | null, a: Tensor3<T>, b: Tensor2<T>): Tensor3<T>;
-    (out: Tensor3<T> | null, a: Tensor3<T>, b: Tensor3<T>): Tensor3<T>;
-    (out: Tensor4<T> | null, a: Tensor3<T>, b: Tensor4<T>): Tensor4<T>;
-    (out: Tensor4<T> | null, a: Tensor4<T>, b: Tensor0<T>): Tensor4<T>;
-    (out: Tensor4<T> | null, a: Tensor4<T>, b: Tensor1<T>): Tensor4<T>;
-    (out: Tensor4<T> | null, a: Tensor4<T>, b: Tensor2<T>): Tensor4<T>;
-    (out: Tensor4<T> | null, a: Tensor4<T>, b: Tensor3<T>): Tensor4<T>;
-    (out: Tensor4<T> | null, a: Tensor4<T>, b: Tensor4<T>): Tensor4<T>;
+    (out: ITensor0<T> | null, a: ITensor0<T>, b: ITensor0<T>): ITensor0<T>;
+    (out: ITensor1<T> | null, a: ITensor0<T>, b: ITensor1<T>): ITensor1<T>;
+    (out: ITensor2<T> | null, a: ITensor0<T>, b: ITensor2<T>): ITensor2<T>;
+    (out: ITensor3<T> | null, a: ITensor0<T>, b: ITensor3<T>): ITensor3<T>;
+    (out: ITensor4<T> | null, a: ITensor0<T>, b: ITensor4<T>): ITensor4<T>;
+    (out: ITensor1<T> | null, a: ITensor1<T>, b: ITensor0<T>): ITensor1<T>;
+    (out: ITensor1<T> | null, a: ITensor1<T>, b: ITensor1<T>): ITensor1<T>;
+    (out: ITensor2<T> | null, a: ITensor1<T>, b: ITensor2<T>): ITensor2<T>;
+    (out: ITensor3<T> | null, a: ITensor1<T>, b: ITensor3<T>): ITensor3<T>;
+    (out: ITensor4<T> | null, a: ITensor1<T>, b: ITensor4<T>): ITensor4<T>;
+    (out: ITensor2<T> | null, a: ITensor2<T>, b: ITensor0<T>): ITensor2<T>;
+    (out: ITensor2<T> | null, a: ITensor2<T>, b: ITensor1<T>): ITensor2<T>;
+    (out: ITensor2<T> | null, a: ITensor2<T>, b: ITensor2<T>): ITensor2<T>;
+    (out: ITensor3<T> | null, a: ITensor2<T>, b: ITensor3<T>): ITensor3<T>;
+    (out: ITensor4<T> | null, a: ITensor2<T>, b: ITensor4<T>): ITensor4<T>;
+    (out: ITensor3<T> | null, a: ITensor3<T>, b: ITensor0<T>): ITensor3<T>;
+    (out: ITensor3<T> | null, a: ITensor3<T>, b: ITensor1<T>): ITensor3<T>;
+    (out: ITensor3<T> | null, a: ITensor3<T>, b: ITensor2<T>): ITensor3<T>;
+    (out: ITensor3<T> | null, a: ITensor3<T>, b: ITensor3<T>): ITensor3<T>;
+    (out: ITensor4<T> | null, a: ITensor3<T>, b: ITensor4<T>): ITensor4<T>;
+    (out: ITensor4<T> | null, a: ITensor4<T>, b: ITensor0<T>): ITensor4<T>;
+    (out: ITensor4<T> | null, a: ITensor4<T>, b: ITensor1<T>): ITensor4<T>;
+    (out: ITensor4<T> | null, a: ITensor4<T>, b: ITensor2<T>): ITensor4<T>;
+    (out: ITensor4<T> | null, a: ITensor4<T>, b: ITensor3<T>): ITensor4<T>;
+    (out: ITensor4<T> | null, a: ITensor4<T>, b: ITensor4<T>): ITensor4<T>;
 }
 export interface TensorOpTTT<T = number> {
-    (out: Tensor0<T> | null, a: Tensor0<T>, b: Tensor0<T>, c: Tensor0<T>): Tensor0<T>;
-    (out: Tensor1<T> | null, a: Tensor0<T>, b: Tensor0<T>, c: Tensor1<T>): Tensor1<T>;
-    (out: Tensor2<T> | null, a: Tensor0<T>, b: Tensor0<T>, c: Tensor2<T>): Tensor2<T>;
-    (out: Tensor3<T> | null, a: Tensor0<T>, b: Tensor0<T>, c: Tensor3<T>): Tensor3<T>;
-    (out: Tensor4<T> | null, a: Tensor0<T>, b: Tensor0<T>, c: Tensor4<T>): Tensor4<T>;
-    (out: Tensor1<T> | null, a: Tensor0<T>, b: Tensor1<T>, c: Tensor0<T>): Tensor1<T>;
-    (out: Tensor1<T> | null, a: Tensor0<T>, b: Tensor1<T>, c: Tensor1<T>): Tensor1<T>;
-    (out: Tensor2<T> | null, a: Tensor0<T>, b: Tensor1<T>, c: Tensor2<T>): Tensor2<T>;
-    (out: Tensor3<T> | null, a: Tensor0<T>, b: Tensor1<T>, c: Tensor3<T>): Tensor3<T>;
-    (out: Tensor4<T> | null, a: Tensor0<T>, b: Tensor1<T>, c: Tensor4<T>): Tensor4<T>;
-    (out: Tensor2<T> | null, a: Tensor0<T>, b: Tensor2<T>, c: Tensor0<T>): Tensor2<T>;
-    (out: Tensor2<T> | null, a: Tensor0<T>, b: Tensor2<T>, c: Tensor1<T>): Tensor2<T>;
-    (out: Tensor2<T> | null, a: Tensor0<T>, b: Tensor2<T>, c: Tensor2<T>): Tensor2<T>;
-    (out: Tensor3<T> | null, a: Tensor0<T>, b: Tensor2<T>, c: Tensor3<T>): Tensor3<T>;
-    (out: Tensor4<T> | null, a: Tensor0<T>, b: Tensor2<T>, c: Tensor4<T>): Tensor4<T>;
-    (out: Tensor3<T> | null, a: Tensor0<T>, b: Tensor3<T>, c: Tensor0<T>): Tensor3<T>;
-    (out: Tensor3<T> | null, a: Tensor0<T>, b: Tensor3<T>, c: Tensor1<T>): Tensor3<T>;
-    (out: Tensor3<T> | null, a: Tensor0<T>, b: Tensor3<T>, c: Tensor2<T>): Tensor3<T>;
-    (out: Tensor3<T> | null, a: Tensor0<T>, b: Tensor3<T>, c: Tensor3<T>): Tensor3<T>;
-    (out: Tensor4<T> | null, a: Tensor0<T>, b: Tensor3<T>, c: Tensor4<T>): Tensor4<T>;
-    (out: Tensor4<T> | null, a: Tensor0<T>, b: Tensor4<T>, c: Tensor0<T>): Tensor4<T>;
-    (out: Tensor4<T> | null, a: Tensor0<T>, b: Tensor4<T>, c: Tensor1<T>): Tensor4<T>;
-    (out: Tensor4<T> | null, a: Tensor0<T>, b: Tensor4<T>, c: Tensor2<T>): Tensor4<T>;
-    (out: Tensor4<T> | null, a: Tensor0<T>, b: Tensor4<T>, c: Tensor3<T>): Tensor4<T>;
-    (out: Tensor4<T> | null, a: Tensor0<T>, b: Tensor4<T>, c: Tensor4<T>): Tensor4<T>;
-    (out: Tensor1<T> | null, a: Tensor1<T>, b: Tensor0<T>, c: Tensor0<T>): Tensor1<T>;
-    (out: Tensor1<T> | null, a: Tensor1<T>, b: Tensor0<T>, c: Tensor1<T>): Tensor1<T>;
-    (out: Tensor2<T> | null, a: Tensor1<T>, b: Tensor0<T>, c: Tensor2<T>): Tensor2<T>;
-    (out: Tensor3<T> | null, a: Tensor1<T>, b: Tensor0<T>, c: Tensor3<T>): Tensor3<T>;
-    (out: Tensor4<T> | null, a: Tensor1<T>, b: Tensor0<T>, c: Tensor4<T>): Tensor4<T>;
-    (out: Tensor1<T> | null, a: Tensor1<T>, b: Tensor1<T>, c: Tensor0<T>): Tensor1<T>;
-    (out: Tensor1<T> | null, a: Tensor1<T>, b: Tensor1<T>, c: Tensor1<T>): Tensor1<T>;
-    (out: Tensor2<T> | null, a: Tensor1<T>, b: Tensor1<T>, c: Tensor2<T>): Tensor2<T>;
-    (out: Tensor3<T> | null, a: Tensor1<T>, b: Tensor1<T>, c: Tensor3<T>): Tensor3<T>;
-    (out: Tensor4<T> | null, a: Tensor1<T>, b: Tensor1<T>, c: Tensor4<T>): Tensor4<T>;
-    (out: Tensor2<T> | null, a: Tensor1<T>, b: Tensor2<T>, c: Tensor0<T>): Tensor2<T>;
-    (out: Tensor2<T> | null, a: Tensor1<T>, b: Tensor2<T>, c: Tensor1<T>): Tensor2<T>;
-    (out: Tensor2<T> | null, a: Tensor1<T>, b: Tensor2<T>, c: Tensor2<T>): Tensor2<T>;
-    (out: Tensor3<T> | null, a: Tensor1<T>, b: Tensor2<T>, c: Tensor3<T>): Tensor3<T>;
-    (out: Tensor4<T> | null, a: Tensor1<T>, b: Tensor2<T>, c: Tensor4<T>): Tensor4<T>;
-    (out: Tensor3<T> | null, a: Tensor1<T>, b: Tensor3<T>, c: Tensor0<T>): Tensor3<T>;
-    (out: Tensor3<T> | null, a: Tensor1<T>, b: Tensor3<T>, c: Tensor1<T>): Tensor3<T>;
-    (out: Tensor3<T> | null, a: Tensor1<T>, b: Tensor3<T>, c: Tensor2<T>): Tensor3<T>;
-    (out: Tensor3<T> | null, a: Tensor1<T>, b: Tensor3<T>, c: Tensor3<T>): Tensor3<T>;
-    (out: Tensor4<T> | null, a: Tensor1<T>, b: Tensor3<T>, c: Tensor4<T>): Tensor4<T>;
-    (out: Tensor4<T> | null, a: Tensor1<T>, b: Tensor4<T>, c: Tensor0<T>): Tensor4<T>;
-    (out: Tensor4<T> | null, a: Tensor1<T>, b: Tensor4<T>, c: Tensor1<T>): Tensor4<T>;
-    (out: Tensor4<T> | null, a: Tensor1<T>, b: Tensor4<T>, c: Tensor2<T>): Tensor4<T>;
-    (out: Tensor4<T> | null, a: Tensor1<T>, b: Tensor4<T>, c: Tensor3<T>): Tensor4<T>;
-    (out: Tensor4<T> | null, a: Tensor1<T>, b: Tensor4<T>, c: Tensor4<T>): Tensor4<T>;
-    (out: Tensor2<T> | null, a: Tensor2<T>, b: Tensor0<T>, c: Tensor0<T>): Tensor2<T>;
-    (out: Tensor2<T> | null, a: Tensor2<T>, b: Tensor0<T>, c: Tensor1<T>): Tensor2<T>;
-    (out: Tensor2<T> | null, a: Tensor2<T>, b: Tensor0<T>, c: Tensor2<T>): Tensor2<T>;
-    (out: Tensor3<T> | null, a: Tensor2<T>, b: Tensor0<T>, c: Tensor3<T>): Tensor3<T>;
-    (out: Tensor4<T> | null, a: Tensor2<T>, b: Tensor0<T>, c: Tensor4<T>): Tensor4<T>;
-    (out: Tensor2<T> | null, a: Tensor2<T>, b: Tensor1<T>, c: Tensor0<T>): Tensor2<T>;
-    (out: Tensor2<T> | null, a: Tensor2<T>, b: Tensor1<T>, c: Tensor1<T>): Tensor2<T>;
-    (out: Tensor2<T> | null, a: Tensor2<T>, b: Tensor1<T>, c: Tensor2<T>): Tensor2<T>;
-    (out: Tensor3<T> | null, a: Tensor2<T>, b: Tensor1<T>, c: Tensor3<T>): Tensor3<T>;
-    (out: Tensor4<T> | null, a: Tensor2<T>, b: Tensor1<T>, c: Tensor4<T>): Tensor4<T>;
-    (out: Tensor2<T> | null, a: Tensor2<T>, b: Tensor2<T>, c: Tensor0<T>): Tensor2<T>;
-    (out: Tensor2<T> | null, a: Tensor2<T>, b: Tensor2<T>, c: Tensor1<T>): Tensor2<T>;
-    (out: Tensor2<T> | null, a: Tensor2<T>, b: Tensor2<T>, c: Tensor2<T>): Tensor2<T>;
-    (out: Tensor3<T> | null, a: Tensor2<T>, b: Tensor2<T>, c: Tensor3<T>): Tensor3<T>;
-    (out: Tensor4<T> | null, a: Tensor2<T>, b: Tensor2<T>, c: Tensor4<T>): Tensor4<T>;
-    (out: Tensor3<T> | null, a: Tensor2<T>, b: Tensor3<T>, c: Tensor0<T>): Tensor3<T>;
-    (out: Tensor3<T> | null, a: Tensor2<T>, b: Tensor3<T>, c: Tensor1<T>): Tensor3<T>;
-    (out: Tensor3<T> | null, a: Tensor2<T>, b: Tensor3<T>, c: Tensor2<T>): Tensor3<T>;
-    (out: Tensor3<T> | null, a: Tensor2<T>, b: Tensor3<T>, c: Tensor3<T>): Tensor3<T>;
-    (out: Tensor4<T> | null, a: Tensor2<T>, b: Tensor3<T>, c: Tensor4<T>): Tensor4<T>;
-    (out: Tensor4<T> | null, a: Tensor2<T>, b: Tensor4<T>, c: Tensor0<T>): Tensor4<T>;
-    (out: Tensor4<T> | null, a: Tensor2<T>, b: Tensor4<T>, c: Tensor1<T>): Tensor4<T>;
-    (out: Tensor4<T> | null, a: Tensor2<T>, b: Tensor4<T>, c: Tensor2<T>): Tensor4<T>;
-    (out: Tensor4<T> | null, a: Tensor2<T>, b: Tensor4<T>, c: Tensor3<T>): Tensor4<T>;
-    (out: Tensor4<T> | null, a: Tensor2<T>, b: Tensor4<T>, c: Tensor4<T>): Tensor4<T>;
-    (out: Tensor3<T> | null, a: Tensor3<T>, b: Tensor0<T>, c: Tensor0<T>): Tensor3<T>;
-    (out: Tensor3<T> | null, a: Tensor3<T>, b: Tensor0<T>, c: Tensor1<T>): Tensor3<T>;
-    (out: Tensor3<T> | null, a: Tensor3<T>, b: Tensor0<T>, c: Tensor2<T>): Tensor3<T>;
-    (out: Tensor3<T> | null, a: Tensor3<T>, b: Tensor0<T>, c: Tensor3<T>): Tensor3<T>;
-    (out: Tensor4<T> | null, a: Tensor3<T>, b: Tensor0<T>, c: Tensor4<T>): Tensor4<T>;
-    (out: Tensor3<T> | null, a: Tensor3<T>, b: Tensor1<T>, c: Tensor0<T>): Tensor3<T>;
-    (out: Tensor3<T> | null, a: Tensor3<T>, b: Tensor1<T>, c: Tensor1<T>): Tensor3<T>;
-    (out: Tensor3<T> | null, a: Tensor3<T>, b: Tensor1<T>, c: Tensor2<T>): Tensor3<T>;
-    (out: Tensor3<T> | null, a: Tensor3<T>, b: Tensor1<T>, c: Tensor3<T>): Tensor3<T>;
-    (out: Tensor4<T> | null, a: Tensor3<T>, b: Tensor1<T>, c: Tensor4<T>): Tensor4<T>;
-    (out: Tensor3<T> | null, a: Tensor3<T>, b: Tensor2<T>, c: Tensor0<T>): Tensor3<T>;
-    (out: Tensor3<T> | null, a: Tensor3<T>, b: Tensor2<T>, c: Tensor1<T>): Tensor3<T>;
-    (out: Tensor3<T> | null, a: Tensor3<T>, b: Tensor2<T>, c: Tensor2<T>): Tensor3<T>;
-    (out: Tensor3<T> | null, a: Tensor3<T>, b: Tensor2<T>, c: Tensor3<T>): Tensor3<T>;
-    (out: Tensor4<T> | null, a: Tensor3<T>, b: Tensor2<T>, c: Tensor4<T>): Tensor4<T>;
-    (out: Tensor3<T> | null, a: Tensor3<T>, b: Tensor3<T>, c: Tensor0<T>): Tensor3<T>;
-    (out: Tensor3<T> | null, a: Tensor3<T>, b: Tensor3<T>, c: Tensor1<T>): Tensor3<T>;
-    (out: Tensor3<T> | null, a: Tensor3<T>, b: Tensor3<T>, c: Tensor2<T>): Tensor3<T>;
-    (out: Tensor3<T> | null, a: Tensor3<T>, b: Tensor3<T>, c: Tensor3<T>): Tensor3<T>;
-    (out: Tensor4<T> | null, a: Tensor3<T>, b: Tensor3<T>, c: Tensor4<T>): Tensor4<T>;
-    (out: Tensor4<T> | null, a: Tensor3<T>, b: Tensor4<T>, c: Tensor0<T>): Tensor4<T>;
-    (out: Tensor4<T> | null, a: Tensor3<T>, b: Tensor4<T>, c: Tensor1<T>): Tensor4<T>;
-    (out: Tensor4<T> | null, a: Tensor3<T>, b: Tensor4<T>, c: Tensor2<T>): Tensor4<T>;
-    (out: Tensor4<T> | null, a: Tensor3<T>, b: Tensor4<T>, c: Tensor3<T>): Tensor4<T>;
-    (out: Tensor4<T> | null, a: Tensor3<T>, b: Tensor4<T>, c: Tensor4<T>): Tensor4<T>;
-    (out: Tensor4<T> | null, a: Tensor4<T>, b: Tensor0<T>, c: Tensor0<T>): Tensor4<T>;
-    (out: Tensor4<T> | null, a: Tensor4<T>, b: Tensor0<T>, c: Tensor1<T>): Tensor4<T>;
-    (out: Tensor4<T> | null, a: Tensor4<T>, b: Tensor0<T>, c: Tensor2<T>): Tensor4<T>;
-    (out: Tensor4<T> | null, a: Tensor4<T>, b: Tensor0<T>, c: Tensor3<T>): Tensor4<T>;
-    (out: Tensor4<T> | null, a: Tensor4<T>, b: Tensor0<T>, c: Tensor4<T>): Tensor4<T>;
-    (out: Tensor4<T> | null, a: Tensor4<T>, b: Tensor1<T>, c: Tensor0<T>): Tensor4<T>;
-    (out: Tensor4<T> | null, a: Tensor4<T>, b: Tensor1<T>, c: Tensor1<T>): Tensor4<T>;
-    (out: Tensor4<T> | null, a: Tensor4<T>, b: Tensor1<T>, c: Tensor2<T>): Tensor4<T>;
-    (out: Tensor4<T> | null, a: Tensor4<T>, b: Tensor1<T>, c: Tensor3<T>): Tensor4<T>;
-    (out: Tensor4<T> | null, a: Tensor4<T>, b: Tensor1<T>, c: Tensor4<T>): Tensor4<T>;
-    (out: Tensor4<T> | null, a: Tensor4<T>, b: Tensor2<T>, c: Tensor0<T>): Tensor4<T>;
-    (out: Tensor4<T> | null, a: Tensor4<T>, b: Tensor2<T>, c: Tensor1<T>): Tensor4<T>;
-    (out: Tensor4<T> | null, a: Tensor4<T>, b: Tensor2<T>, c: Tensor2<T>): Tensor4<T>;
-    (out: Tensor4<T> | null, a: Tensor4<T>, b: Tensor2<T>, c: Tensor3<T>): Tensor4<T>;
-    (out: Tensor4<T> | null, a: Tensor4<T>, b: Tensor2<T>, c: Tensor4<T>): Tensor4<T>;
-    (out: Tensor4<T> | null, a: Tensor4<T>, b: Tensor3<T>, c: Tensor0<T>): Tensor4<T>;
-    (out: Tensor4<T> | null, a: Tensor4<T>, b: Tensor3<T>, c: Tensor1<T>): Tensor4<T>;
-    (out: Tensor4<T> | null, a: Tensor4<T>, b: Tensor3<T>, c: Tensor2<T>): Tensor4<T>;
-    (out: Tensor4<T> | null, a: Tensor4<T>, b: Tensor3<T>, c: Tensor3<T>): Tensor4<T>;
-    (out: Tensor4<T> | null, a: Tensor4<T>, b: Tensor3<T>, c: Tensor4<T>): Tensor4<T>;
-    (out: Tensor4<T> | null, a: Tensor4<T>, b: Tensor4<T>, c: Tensor0<T>): Tensor4<T>;
-    (out: Tensor4<T> | null, a: Tensor4<T>, b: Tensor4<T>, c: Tensor1<T>): Tensor4<T>;
-    (out: Tensor4<T> | null, a: Tensor4<T>, b: Tensor4<T>, c: Tensor2<T>): Tensor4<T>;
-    (out: Tensor4<T> | null, a: Tensor4<T>, b: Tensor4<T>, c: Tensor3<T>): Tensor4<T>;
-    (out: Tensor4<T> | null, a: Tensor4<T>, b: Tensor4<T>, c: Tensor4<T>): Tensor4<T>;
+    (out: ITensor0<T> | null, a: ITensor0<T>, b: ITensor0<T>, c: ITensor0<T>): ITensor0<T>;
+    (out: ITensor1<T> | null, a: ITensor0<T>, b: ITensor0<T>, c: ITensor1<T>): ITensor1<T>;
+    (out: ITensor2<T> | null, a: ITensor0<T>, b: ITensor0<T>, c: ITensor2<T>): ITensor2<T>;
+    (out: ITensor3<T> | null, a: ITensor0<T>, b: ITensor0<T>, c: ITensor3<T>): ITensor3<T>;
+    (out: ITensor4<T> | null, a: ITensor0<T>, b: ITensor0<T>, c: ITensor4<T>): ITensor4<T>;
+    (out: ITensor1<T> | null, a: ITensor0<T>, b: ITensor1<T>, c: ITensor0<T>): ITensor1<T>;
+    (out: ITensor1<T> | null, a: ITensor0<T>, b: ITensor1<T>, c: ITensor1<T>): ITensor1<T>;
+    (out: ITensor2<T> | null, a: ITensor0<T>, b: ITensor1<T>, c: ITensor2<T>): ITensor2<T>;
+    (out: ITensor3<T> | null, a: ITensor0<T>, b: ITensor1<T>, c: ITensor3<T>): ITensor3<T>;
+    (out: ITensor4<T> | null, a: ITensor0<T>, b: ITensor1<T>, c: ITensor4<T>): ITensor4<T>;
+    (out: ITensor2<T> | null, a: ITensor0<T>, b: ITensor2<T>, c: ITensor0<T>): ITensor2<T>;
+    (out: ITensor2<T> | null, a: ITensor0<T>, b: ITensor2<T>, c: ITensor1<T>): ITensor2<T>;
+    (out: ITensor2<T> | null, a: ITensor0<T>, b: ITensor2<T>, c: ITensor2<T>): ITensor2<T>;
+    (out: ITensor3<T> | null, a: ITensor0<T>, b: ITensor2<T>, c: ITensor3<T>): ITensor3<T>;
+    (out: ITensor4<T> | null, a: ITensor0<T>, b: ITensor2<T>, c: ITensor4<T>): ITensor4<T>;
+    (out: ITensor3<T> | null, a: ITensor0<T>, b: ITensor3<T>, c: ITensor0<T>): ITensor3<T>;
+    (out: ITensor3<T> | null, a: ITensor0<T>, b: ITensor3<T>, c: ITensor1<T>): ITensor3<T>;
+    (out: ITensor3<T> | null, a: ITensor0<T>, b: ITensor3<T>, c: ITensor2<T>): ITensor3<T>;
+    (out: ITensor3<T> | null, a: ITensor0<T>, b: ITensor3<T>, c: ITensor3<T>): ITensor3<T>;
+    (out: ITensor4<T> | null, a: ITensor0<T>, b: ITensor3<T>, c: ITensor4<T>): ITensor4<T>;
+    (out: ITensor4<T> | null, a: ITensor0<T>, b: ITensor4<T>, c: ITensor0<T>): ITensor4<T>;
+    (out: ITensor4<T> | null, a: ITensor0<T>, b: ITensor4<T>, c: ITensor1<T>): ITensor4<T>;
+    (out: ITensor4<T> | null, a: ITensor0<T>, b: ITensor4<T>, c: ITensor2<T>): ITensor4<T>;
+    (out: ITensor4<T> | null, a: ITensor0<T>, b: ITensor4<T>, c: ITensor3<T>): ITensor4<T>;
+    (out: ITensor4<T> | null, a: ITensor0<T>, b: ITensor4<T>, c: ITensor4<T>): ITensor4<T>;
+    (out: ITensor1<T> | null, a: ITensor1<T>, b: ITensor0<T>, c: ITensor0<T>): ITensor1<T>;
+    (out: ITensor1<T> | null, a: ITensor1<T>, b: ITensor0<T>, c: ITensor1<T>): ITensor1<T>;
+    (out: ITensor2<T> | null, a: ITensor1<T>, b: ITensor0<T>, c: ITensor2<T>): ITensor2<T>;
+    (out: ITensor3<T> | null, a: ITensor1<T>, b: ITensor0<T>, c: ITensor3<T>): ITensor3<T>;
+    (out: ITensor4<T> | null, a: ITensor1<T>, b: ITensor0<T>, c: ITensor4<T>): ITensor4<T>;
+    (out: ITensor1<T> | null, a: ITensor1<T>, b: ITensor1<T>, c: ITensor0<T>): ITensor1<T>;
+    (out: ITensor1<T> | null, a: ITensor1<T>, b: ITensor1<T>, c: ITensor1<T>): ITensor1<T>;
+    (out: ITensor2<T> | null, a: ITensor1<T>, b: ITensor1<T>, c: ITensor2<T>): ITensor2<T>;
+    (out: ITensor3<T> | null, a: ITensor1<T>, b: ITensor1<T>, c: ITensor3<T>): ITensor3<T>;
+    (out: ITensor4<T> | null, a: ITensor1<T>, b: ITensor1<T>, c: ITensor4<T>): ITensor4<T>;
+    (out: ITensor2<T> | null, a: ITensor1<T>, b: ITensor2<T>, c: ITensor0<T>): ITensor2<T>;
+    (out: ITensor2<T> | null, a: ITensor1<T>, b: ITensor2<T>, c: ITensor1<T>): ITensor2<T>;
+    (out: ITensor2<T> | null, a: ITensor1<T>, b: ITensor2<T>, c: ITensor2<T>): ITensor2<T>;
+    (out: ITensor3<T> | null, a: ITensor1<T>, b: ITensor2<T>, c: ITensor3<T>): ITensor3<T>;
+    (out: ITensor4<T> | null, a: ITensor1<T>, b: ITensor2<T>, c: ITensor4<T>): ITensor4<T>;
+    (out: ITensor3<T> | null, a: ITensor1<T>, b: ITensor3<T>, c: ITensor0<T>): ITensor3<T>;
+    (out: ITensor3<T> | null, a: ITensor1<T>, b: ITensor3<T>, c: ITensor1<T>): ITensor3<T>;
+    (out: ITensor3<T> | null, a: ITensor1<T>, b: ITensor3<T>, c: ITensor2<T>): ITensor3<T>;
+    (out: ITensor3<T> | null, a: ITensor1<T>, b: ITensor3<T>, c: ITensor3<T>): ITensor3<T>;
+    (out: ITensor4<T> | null, a: ITensor1<T>, b: ITensor3<T>, c: ITensor4<T>): ITensor4<T>;
+    (out: ITensor4<T> | null, a: ITensor1<T>, b: ITensor4<T>, c: ITensor0<T>): ITensor4<T>;
+    (out: ITensor4<T> | null, a: ITensor1<T>, b: ITensor4<T>, c: ITensor1<T>): ITensor4<T>;
+    (out: ITensor4<T> | null, a: ITensor1<T>, b: ITensor4<T>, c: ITensor2<T>): ITensor4<T>;
+    (out: ITensor4<T> | null, a: ITensor1<T>, b: ITensor4<T>, c: ITensor3<T>): ITensor4<T>;
+    (out: ITensor4<T> | null, a: ITensor1<T>, b: ITensor4<T>, c: ITensor4<T>): ITensor4<T>;
+    (out: ITensor2<T> | null, a: ITensor2<T>, b: ITensor0<T>, c: ITensor0<T>): ITensor2<T>;
+    (out: ITensor2<T> | null, a: ITensor2<T>, b: ITensor0<T>, c: ITensor1<T>): ITensor2<T>;
+    (out: ITensor2<T> | null, a: ITensor2<T>, b: ITensor0<T>, c: ITensor2<T>): ITensor2<T>;
+    (out: ITensor3<T> | null, a: ITensor2<T>, b: ITensor0<T>, c: ITensor3<T>): ITensor3<T>;
+    (out: ITensor4<T> | null, a: ITensor2<T>, b: ITensor0<T>, c: ITensor4<T>): ITensor4<T>;
+    (out: ITensor2<T> | null, a: ITensor2<T>, b: ITensor1<T>, c: ITensor0<T>): ITensor2<T>;
+    (out: ITensor2<T> | null, a: ITensor2<T>, b: ITensor1<T>, c: ITensor1<T>): ITensor2<T>;
+    (out: ITensor2<T> | null, a: ITensor2<T>, b: ITensor1<T>, c: ITensor2<T>): ITensor2<T>;
+    (out: ITensor3<T> | null, a: ITensor2<T>, b: ITensor1<T>, c: ITensor3<T>): ITensor3<T>;
+    (out: ITensor4<T> | null, a: ITensor2<T>, b: ITensor1<T>, c: ITensor4<T>): ITensor4<T>;
+    (out: ITensor2<T> | null, a: ITensor2<T>, b: ITensor2<T>, c: ITensor0<T>): ITensor2<T>;
+    (out: ITensor2<T> | null, a: ITensor2<T>, b: ITensor2<T>, c: ITensor1<T>): ITensor2<T>;
+    (out: ITensor2<T> | null, a: ITensor2<T>, b: ITensor2<T>, c: ITensor2<T>): ITensor2<T>;
+    (out: ITensor3<T> | null, a: ITensor2<T>, b: ITensor2<T>, c: ITensor3<T>): ITensor3<T>;
+    (out: ITensor4<T> | null, a: ITensor2<T>, b: ITensor2<T>, c: ITensor4<T>): ITensor4<T>;
+    (out: ITensor3<T> | null, a: ITensor2<T>, b: ITensor3<T>, c: ITensor0<T>): ITensor3<T>;
+    (out: ITensor3<T> | null, a: ITensor2<T>, b: ITensor3<T>, c: ITensor1<T>): ITensor3<T>;
+    (out: ITensor3<T> | null, a: ITensor2<T>, b: ITensor3<T>, c: ITensor2<T>): ITensor3<T>;
+    (out: ITensor3<T> | null, a: ITensor2<T>, b: ITensor3<T>, c: ITensor3<T>): ITensor3<T>;
+    (out: ITensor4<T> | null, a: ITensor2<T>, b: ITensor3<T>, c: ITensor4<T>): ITensor4<T>;
+    (out: ITensor4<T> | null, a: ITensor2<T>, b: ITensor4<T>, c: ITensor0<T>): ITensor4<T>;
+    (out: ITensor4<T> | null, a: ITensor2<T>, b: ITensor4<T>, c: ITensor1<T>): ITensor4<T>;
+    (out: ITensor4<T> | null, a: ITensor2<T>, b: ITensor4<T>, c: ITensor2<T>): ITensor4<T>;
+    (out: ITensor4<T> | null, a: ITensor2<T>, b: ITensor4<T>, c: ITensor3<T>): ITensor4<T>;
+    (out: ITensor4<T> | null, a: ITensor2<T>, b: ITensor4<T>, c: ITensor4<T>): ITensor4<T>;
+    (out: ITensor3<T> | null, a: ITensor3<T>, b: ITensor0<T>, c: ITensor0<T>): ITensor3<T>;
+    (out: ITensor3<T> | null, a: ITensor3<T>, b: ITensor0<T>, c: ITensor1<T>): ITensor3<T>;
+    (out: ITensor3<T> | null, a: ITensor3<T>, b: ITensor0<T>, c: ITensor2<T>): ITensor3<T>;
+    (out: ITensor3<T> | null, a: ITensor3<T>, b: ITensor0<T>, c: ITensor3<T>): ITensor3<T>;
+    (out: ITensor4<T> | null, a: ITensor3<T>, b: ITensor0<T>, c: ITensor4<T>): ITensor4<T>;
+    (out: ITensor3<T> | null, a: ITensor3<T>, b: ITensor1<T>, c: ITensor0<T>): ITensor3<T>;
+    (out: ITensor3<T> | null, a: ITensor3<T>, b: ITensor1<T>, c: ITensor1<T>): ITensor3<T>;
+    (out: ITensor3<T> | null, a: ITensor3<T>, b: ITensor1<T>, c: ITensor2<T>): ITensor3<T>;
+    (out: ITensor3<T> | null, a: ITensor3<T>, b: ITensor1<T>, c: ITensor3<T>): ITensor3<T>;
+    (out: ITensor4<T> | null, a: ITensor3<T>, b: ITensor1<T>, c: ITensor4<T>): ITensor4<T>;
+    (out: ITensor3<T> | null, a: ITensor3<T>, b: ITensor2<T>, c: ITensor0<T>): ITensor3<T>;
+    (out: ITensor3<T> | null, a: ITensor3<T>, b: ITensor2<T>, c: ITensor1<T>): ITensor3<T>;
+    (out: ITensor3<T> | null, a: ITensor3<T>, b: ITensor2<T>, c: ITensor2<T>): ITensor3<T>;
+    (out: ITensor3<T> | null, a: ITensor3<T>, b: ITensor2<T>, c: ITensor3<T>): ITensor3<T>;
+    (out: ITensor4<T> | null, a: ITensor3<T>, b: ITensor2<T>, c: ITensor4<T>): ITensor4<T>;
+    (out: ITensor3<T> | null, a: ITensor3<T>, b: ITensor3<T>, c: ITensor0<T>): ITensor3<T>;
+    (out: ITensor3<T> | null, a: ITensor3<T>, b: ITensor3<T>, c: ITensor1<T>): ITensor3<T>;
+    (out: ITensor3<T> | null, a: ITensor3<T>, b: ITensor3<T>, c: ITensor2<T>): ITensor3<T>;
+    (out: ITensor3<T> | null, a: ITensor3<T>, b: ITensor3<T>, c: ITensor3<T>): ITensor3<T>;
+    (out: ITensor4<T> | null, a: ITensor3<T>, b: ITensor3<T>, c: ITensor4<T>): ITensor4<T>;
+    (out: ITensor4<T> | null, a: ITensor3<T>, b: ITensor4<T>, c: ITensor0<T>): ITensor4<T>;
+    (out: ITensor4<T> | null, a: ITensor3<T>, b: ITensor4<T>, c: ITensor1<T>): ITensor4<T>;
+    (out: ITensor4<T> | null, a: ITensor3<T>, b: ITensor4<T>, c: ITensor2<T>): ITensor4<T>;
+    (out: ITensor4<T> | null, a: ITensor3<T>, b: ITensor4<T>, c: ITensor3<T>): ITensor4<T>;
+    (out: ITensor4<T> | null, a: ITensor3<T>, b: ITensor4<T>, c: ITensor4<T>): ITensor4<T>;
+    (out: ITensor4<T> | null, a: ITensor4<T>, b: ITensor0<T>, c: ITensor0<T>): ITensor4<T>;
+    (out: ITensor4<T> | null, a: ITensor4<T>, b: ITensor0<T>, c: ITensor1<T>): ITensor4<T>;
+    (out: ITensor4<T> | null, a: ITensor4<T>, b: ITensor0<T>, c: ITensor2<T>): ITensor4<T>;
+    (out: ITensor4<T> | null, a: ITensor4<T>, b: ITensor0<T>, c: ITensor3<T>): ITensor4<T>;
+    (out: ITensor4<T> | null, a: ITensor4<T>, b: ITensor0<T>, c: ITensor4<T>): ITensor4<T>;
+    (out: ITensor4<T> | null, a: ITensor4<T>, b: ITensor1<T>, c: ITensor0<T>): ITensor4<T>;
+    (out: ITensor4<T> | null, a: ITensor4<T>, b: ITensor1<T>, c: ITensor1<T>): ITensor4<T>;
+    (out: ITensor4<T> | null, a: ITensor4<T>, b: ITensor1<T>, c: ITensor2<T>): ITensor4<T>;
+    (out: ITensor4<T> | null, a: ITensor4<T>, b: ITensor1<T>, c: ITensor3<T>): ITensor4<T>;
+    (out: ITensor4<T> | null, a: ITensor4<T>, b: ITensor1<T>, c: ITensor4<T>): ITensor4<T>;
+    (out: ITensor4<T> | null, a: ITensor4<T>, b: ITensor2<T>, c: ITensor0<T>): ITensor4<T>;
+    (out: ITensor4<T> | null, a: ITensor4<T>, b: ITensor2<T>, c: ITensor1<T>): ITensor4<T>;
+    (out: ITensor4<T> | null, a: ITensor4<T>, b: ITensor2<T>, c: ITensor2<T>): ITensor4<T>;
+    (out: ITensor4<T> | null, a: ITensor4<T>, b: ITensor2<T>, c: ITensor3<T>): ITensor4<T>;
+    (out: ITensor4<T> | null, a: ITensor4<T>, b: ITensor2<T>, c: ITensor4<T>): ITensor4<T>;
+    (out: ITensor4<T> | null, a: ITensor4<T>, b: ITensor3<T>, c: ITensor0<T>): ITensor4<T>;
+    (out: ITensor4<T> | null, a: ITensor4<T>, b: ITensor3<T>, c: ITensor1<T>): ITensor4<T>;
+    (out: ITensor4<T> | null, a: ITensor4<T>, b: ITensor3<T>, c: ITensor2<T>): ITensor4<T>;
+    (out: ITensor4<T> | null, a: ITensor4<T>, b: ITensor3<T>, c: ITensor3<T>): ITensor4<T>;
+    (out: ITensor4<T> | null, a: ITensor4<T>, b: ITensor3<T>, c: ITensor4<T>): ITensor4<T>;
+    (out: ITensor4<T> | null, a: ITensor4<T>, b: ITensor4<T>, c: ITensor0<T>): ITensor4<T>;
+    (out: ITensor4<T> | null, a: ITensor4<T>, b: ITensor4<T>, c: ITensor1<T>): ITensor4<T>;
+    (out: ITensor4<T> | null, a: ITensor4<T>, b: ITensor4<T>, c: ITensor2<T>): ITensor4<T>;
+    (out: ITensor4<T> | null, a: ITensor4<T>, b: ITensor4<T>, c: ITensor3<T>): ITensor4<T>;
+    (out: ITensor4<T> | null, a: ITensor4<T>, b: ITensor4<T>, c: ITensor4<T>): ITensor4<T>;
 }
 export interface TensorOpN<A = number, B = A> {
-    (out: Tensor0<B>, n: A): Tensor0<B>;
-    (out: Tensor1<B>, n: A): Tensor1<B>;
-    (out: Tensor2<B>, n: A): Tensor2<B>;
-    (out: Tensor3<B>, n: A): Tensor3<B>;
-    (out: Tensor4<B>, n: A): Tensor4<B>;
+    (out: ITensor0<B>, n: A): ITensor0<B>;
+    (out: ITensor1<B>, n: A): ITensor1<B>;
+    (out: ITensor2<B>, n: A): ITensor2<B>;
+    (out: ITensor3<B>, n: A): ITensor3<B>;
+    (out: ITensor4<B>, n: A): ITensor4<B>;
 }
 export interface TensorOpTN<T = number> {
-    (out: Tensor0<T> | null, a: Tensor0<T>, n: T): Tensor0<T>;
-    (out: Tensor1<T> | null, a: Tensor1<T>, n: T): Tensor1<T>;
-    (out: Tensor2<T> | null, a: Tensor2<T>, n: T): Tensor2<T>;
-    (out: Tensor3<T> | null, a: Tensor3<T>, n: T): Tensor3<T>;
-    (out: Tensor4<T> | null, a: Tensor4<T>, n: T): Tensor4<T>;
+    (out: ITensor0<T> | null, a: ITensor0<T>, n: T): ITensor0<T>;
+    (out: ITensor1<T> | null, a: ITensor1<T>, n: T): ITensor1<T>;
+    (out: ITensor2<T> | null, a: ITensor2<T>, n: T): ITensor2<T>;
+    (out: ITensor3<T> | null, a: ITensor3<T>, n: T): ITensor3<T>;
+    (out: ITensor4<T> | null, a: ITensor4<T>, n: T): ITensor4<T>;
+}
+export interface TensorOpTNO<T = number> {
+    (out: ITensor0<T> | null, a: ITensor0<T>, n?: T): ITensor0<T>;
+    (out: ITensor1<T> | null, a: ITensor1<T>, n?: T): ITensor1<T>;
+    (out: ITensor2<T> | null, a: ITensor2<T>, n?: T): ITensor2<T>;
+    (out: ITensor3<T> | null, a: ITensor3<T>, n?: T): ITensor3<T>;
+    (out: ITensor4<T> | null, a: ITensor4<T>, n?: T): ITensor4<T>;
 }
 export interface TensorOpTNN<T = number> {
-    (out: Tensor0<T>, a: Tensor0<T>, n: T, m: T): Tensor0<T>;
-    (out: Tensor1<T>, a: Tensor1<T>, n: T, m: T): Tensor1<T>;
-    (out: Tensor2<T>, a: Tensor2<T>, n: T, m: T): Tensor2<T>;
-    (out: Tensor3<T>, a: Tensor3<T>, n: T, m: T): Tensor3<T>;
-    (out: Tensor4<T>, a: Tensor4<T>, n: T, m: T): Tensor4<T>;
+    (out: ITensor0<T>, a: ITensor0<T>, n: T, m: T): ITensor0<T>;
+    (out: ITensor1<T>, a: ITensor1<T>, n: T, m: T): ITensor1<T>;
+    (out: ITensor2<T>, a: ITensor2<T>, n: T, m: T): ITensor2<T>;
+    (out: ITensor3<T>, a: ITensor3<T>, n: T, m: T): ITensor3<T>;
+    (out: ITensor4<T>, a: ITensor4<T>, n: T, m: T): ITensor4<T>;
 }
 export type TensorOpRT<A, B, TA extends ITensor<A> = ITensor<A>> = (a: TA) => B;
 export type TensorOpRTT<A, B, TA extends ITensor<A> = ITensor<A>> = (a: TA, b: TA) => B;

package/broadcast.d.ts

@@ -18,7 +18,7 @@ import type { ITensor, Shape } from "./api.js";
  */
 export declare const broadcast: <T = number>(a: ITensor<T>, b: ITensor<T>) => {
     shape: Shape;
-    a: ITensor<T> | import("./tensor.js").Tensor4<T> | import("./tensor.js").Tensor3<T> | import("./tensor.js").Tensor2<T> | import("./tensor.js").Tensor0<T> | import("./tensor.js").Tensor1<T>;
-    b: ITensor<T> | import("./tensor.js").Tensor4<T> | import("./tensor.js").Tensor3<T> | import("./tensor.js").Tensor2<T> | import("./tensor.js").Tensor0<T> | import("./tensor.js").Tensor1<T>;
+    a: ITensor<T>;
+    b: ITensor<T>;
 };
 //# sourceMappingURL=broadcast.d.ts.map

package/cdf.d.ts

@@ -0,0 +1,25 @@
+import type { ITensor1 } from "./api.js";
+/**
+ * Computes the cumulative distribution of `a` and writes it to `out`. If `out`
+ * is null, mutates `a` in place.
+ *
+ * @remarks
+ * Reference:
+ *
+ * - https://en.wikipedia.org/wiki/Cumulative_distribution_function
+ *
+ * @example
+ * ```ts tangle:../export/cdf.ts
+ * import { cdf, tensor } from "@thi.ng/tensors";
+ *
+ * const a = tensor("num", [10], {data: [0,0,1,0,0,1,0,1,1,0]});
+ *
+ * console.log([...cdf(null, a)]);
+ * // [ 0, 0, 1, 1, 1, 2, 2, 3, 4, 4 ]
+ * ```
+ *
+ * @param out
+ * @param a
+ */
+export declare const cdf: (out: ITensor1 | null, a: ITensor1) => ITensor1;
+//# sourceMappingURL=cdf.d.ts.map

package/cdf.js

@@ -0,0 +1,25 @@
+import { ensureShape } from "./errors.js";
+const cdf = (out, a) => {
+  !out && (out = a);
+  ensureShape(out, a.shape);
+  const {
+    offset: oa,
+    shape: [sa],
+    stride: [ta],
+    data: adata
+  } = a;
+  const {
+    offset: oo,
+    stride: [to],
+    data: odata
+  } = out;
+  let total = 0;
+  for (let i = 0; i < sa; i++) {
+    total += adata[oa + i * ta];
+    odata[oo + i * to] = total;
+  }
+  return out;
+};
+export {
+  cdf
+};

package/convert.d.ts

@@ -44,5 +44,5 @@ export interface FloatBufferLike {
  *
  * @param buffer
  */
-export declare const fromFloatBuffer: ({ size: [sx, sy], stride: [tx, ty], data, format: { size }, }: FloatBufferLike) => import("./tensor.js").Tensor3<number> | import("./tensor.js").Tensor2<number>;
+export declare const fromFloatBuffer: ({ size: [sx, sy], stride: [tx, ty], data, format: { size }, }: FloatBufferLike) => import("./api.js").ITensor3<number> | import("./api.js").ITensor2<number>;
 //# sourceMappingURL=convert.d.ts.map

package/diagonal.d.ts

@@ -1,12 +1,11 @@
-import type { ITensor } from "./api.js";
-import { Tensor1 } from "./tensor.js";
+import type { ITensor, ITensor1 } from "./api.js";
 /**
  * Returns a 1D tensor view of the nD diagonal of the given tensor.
  *
  * @remarks
  * For 1D tensors this will merely by a shallow copy.
  */
-export declare const diagonal: <T>(a: ITensor<T>) => Tensor1<T>;
+export declare const diagonal: <T>(a: ITensor<T>) => ITensor1<T>;
 /**
  * Computes the trace of given tensor, i.e. the component sum of `diagonal(a)`.
  *