@thi.ng/tensors 0.5.0 → 0.6.1

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2025-05-28T12:02:39Z
+- **Last updated**: 2025-06-09T17:24:08Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.
@@ -11,6 +11,14 @@ See [Conventional Commits](https://conventionalcommits.org/) for commit guidelin
 **Note:** Unlisted _patch_ versions only involve non-code or otherwise excluded changes
 and/or version bumps of transitive dependencies.
 
+## [0.6.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/tensors@0.6.0) (2025-06-05)
+
+#### 🚀 Features
+
+- update defOpRT()/defOpRTT() ([8099abc](https://github.com/thi-ng/umbrella/commit/8099abc))
+  - add optional `complete` fn to produce/transform final result (reducer like)
+- add mean() tensor op ([2f15d21](https://github.com/thi-ng/umbrella/commit/2f15d21))
+
 ## [0.5.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/tensors@0.5.0) (2025-05-28)
 
 #### 🚀 Features

package/README.md

@@ -7,7 +7,7 @@
 [![Mastodon Follow](https://img.shields.io/mastodon/follow/109331703950160316?domain=https%3A%2F%2Fmastodon.thi.ng&style=social)](https://mastodon.thi.ng/@toxi)
 
 > [!NOTE]
-> This is one of 208 standalone projects, maintained as part
+> This is one of 209 standalone projects, maintained as part
 > of the [@thi.ng/umbrella](https://github.com/thi-ng/umbrella/) monorepo
 > and anti-framework.
 >
@@ -218,7 +218,7 @@ For Node.js REPL:
 const ten = await import("@thi.ng/tensors");
 ```
 
-Package sizes (brotli'd, pre-treeshake): ESM: 9.40 KB
+Package sizes (brotli'd, pre-treeshake): ESM: 9.48 KB
 
 ## Dependencies
 

package/defoprt.d.ts

@@ -1,12 +1,12 @@
-import type { Fn0 } from "@thi.ng/api";
-import type { TensorData, TensorOpRT } from "./api.js";
+import type { ITensor, TensorData, TensorOpRT } from "./api.js";
 /**
  * Higher order tensor reduction op factory. Takes given reduction `rfn` and
- * `init` function to produce an initial result. Returns a {@link TensorOpRT}
- * applying the given function component-wise.
+ * `init` function to produce an initial result and optional `complete` to
+ * produce the final result. Returns a {@link TensorOpRT} applying the given
+ * function component-wise.
  *
  * @param rfn
  * @param init
  */
-export declare const defOpRT: <A = number, B = A>(rfn: (acc: B, data: TensorData<A>, i: number) => B, init: Fn0<B>) => import("./api.js").MultiTensorOpImpl<TensorOpRT<A, B>>;
+export declare const defOpRT: <A = number, B = A>(rfn: (acc: B, data: TensorData<A>, i: number) => B, init: () => B, complete?: (acc: B, a: ITensor<A>) => B) => import("./api.js").MultiTensorOpImpl<TensorOpRT<A, B>>;
 //# sourceMappingURL=defoprt.d.ts.map

package/defoprt.js

@@ -1,5 +1,6 @@
+import { identity } from "@thi.ng/api/fn";
 import { top } from "./top.js";
-const defOpRT = (rfn, init) => {
+const defOpRT = (rfn, init, complete = identity) => {
   const f1 = (a) => {
     const {
       data,
@@ -11,7 +12,7 @@ const defOpRT = (rfn, init) => {
     for (let x = 0; x < sx; x++) {
       res = rfn(res, data, offset + x * tx);
     }
-    return res;
+    return complete(res, a);
   };
   const f2 = (a) => {
     const {
@@ -28,7 +29,7 @@ const defOpRT = (rfn, init) => {
         res = rfn(res, data, ox + y * ty);
       }
     }
-    return res;
+    return complete(res, a);
   };
   const f3 = (a) => {
     const {
@@ -48,7 +49,7 @@ const defOpRT = (rfn, init) => {
         }
       }
     }
-    return res;
+    return complete(res, a);
   };
   const f4 = (a) => {
     const {
@@ -71,7 +72,7 @@ const defOpRT = (rfn, init) => {
         }
       }
     }
-    return res;
+    return complete(res, a);
   };
   return top(
     0,

package/defoprtt.d.ts

@@ -1,14 +1,15 @@
-import type { Fn0 } from "@thi.ng/api";
-import type { TensorData, TensorOpRTT } from "./api.js";
+import type { ITensor, TensorData, TensorOpRTT } from "./api.js";
 /**
  * Higher order tensor reduction op factory. Takes given reduction `rfn` and
- * `init` function to produce an initial result. Returns a {@link TensorOpRTT}
- * applying the given function componentwise, by default with broadcasting rules
- * (see {@link broadcast} for details).
+ * `init` function to produce an initial result and optional `complete` to
+ * produce the final result. Returns a {@link TensorOpRTT} applying the given
+ * function componentwise, by default with broadcasting rules (see
+ * {@link broadcast} for details).
  *
  * @param rfn
  * @param init
+ * @param complete
  * @param useBroadcast
  */
-export declare const defOpRTT: <A = number, B = A>(rfn: (acc: B, adata: TensorData<A>, bdata: TensorData<A>, ia: number, ib: number) => B, init: Fn0<B>, useBroadcast?: boolean) => TensorOpRTT<A, B>;
+export declare const defOpRTT: <A = number, B = A>(rfn: (acc: B, adata: TensorData<A>, bdata: TensorData<A>, ia: number, ib: number) => B, init: () => B, complete?: (acc: B, a: ITensor<A>, b: ITensor<A>) => B, useBroadcast?: boolean) => TensorOpRTT<A, B>;
 //# sourceMappingURL=defoprtt.d.ts.map

package/defoprtt.js

@@ -1,5 +1,6 @@
+import { identity } from "@thi.ng/api/fn";
 import { broadcast } from "./broadcast.js";
-const defOpRTT = (rfn, init, useBroadcast = true) => {
+const defOpRTT = (rfn, init, complete = identity, useBroadcast = true) => {
   const f1 = (a, b) => {
     const {
       data: adata,
@@ -16,7 +17,7 @@ const defOpRTT = (rfn, init, useBroadcast = true) => {
     for (let x = 0; x < sx; x++) {
       res = rfn(res, adata, bdata, oa + x * txa, ob + x * txb);
     }
-    return res;
+    return complete(res, a, b);
   };
   const f2 = (a, b) => {
     const {
@@ -39,7 +40,7 @@ const defOpRTT = (rfn, init, useBroadcast = true) => {
         res = rfn(res, adata, bdata, oax + y * tya, obx + y * tyb);
       }
     }
-    return res;
+    return complete(res, a, b);
   };
   const f3 = (a, b) => {
     const {
@@ -66,7 +67,7 @@ const defOpRTT = (rfn, init, useBroadcast = true) => {
         }
       }
     }
-    return res;
+    return complete(res, a, b);
   };
   const f4 = (a, b) => {
     const {
@@ -103,7 +104,7 @@ const defOpRTT = (rfn, init, useBroadcast = true) => {
         }
       }
     }
-    return res;
+    return complete(res, a, b);
   };
   const impls = [, f1, f2, f3, f4];
   const wrapper = useBroadcast ? (a, b) => {

package/index.d.ts

@@ -34,6 +34,7 @@ export * from "./mag.js";
 export * from "./magsq.js";
 export * from "./max.js";
 export * from "./maxn.js";
+export * from "./mean.js";
 export * from "./min.js";
 export * from "./minn.js";
 export * from "./mul.js";

package/index.js

@@ -34,6 +34,7 @@ export * from "./mag.js";
 export * from "./magsq.js";
 export * from "./max.js";
 export * from "./maxn.js";
+export * from "./mean.js";
 export * from "./min.js";
 export * from "./minn.js";
 export * from "./mul.js";

package/mean.d.ts

@@ -0,0 +1,8 @@
+import type { ITensor } from "./api.js";
+/**
+ * Computes the mean value of given nD tensor, aka `sum(a) / a.length`.
+ *
+ * @param a - input tensor
+ */
+export declare const mean: (a: ITensor) => number;
+//# sourceMappingURL=mean.d.ts.map

package/mean.js

@@ -0,0 +1,5 @@
+import { sum } from "./sum.js";
+const mean = (a) => sum(a) / a.length;
+export {
+  mean
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/tensors",
-  "version": "0.5.0",
+  "version": "0.6.1",
   "description": "1D/2D/3D/4D tensors with extensible polymorphic operations and customizable storage",
   "type": "module",
   "module": "./index.js",
@@ -39,15 +39,15 @@
     "tool:tangle": "../../node_modules/.bin/tangle src/**/*.ts"
   },
   "dependencies": {
-    "@thi.ng/api": "^8.11.28",
-    "@thi.ng/arrays": "^2.11.1",
-    "@thi.ng/checks": "^3.7.8",
-    "@thi.ng/equiv": "^2.1.84",
-    "@thi.ng/errors": "^2.5.34",
-    "@thi.ng/math": "^5.11.28",
-    "@thi.ng/random": "^4.1.19",
-    "@thi.ng/strings": "^3.9.13",
-    "@thi.ng/vectors": "^8.2.1"
+    "@thi.ng/api": "^8.11.29",
+    "@thi.ng/arrays": "^2.11.2",
+    "@thi.ng/checks": "^3.7.9",
+    "@thi.ng/equiv": "^2.1.85",
+    "@thi.ng/errors": "^2.5.35",
+    "@thi.ng/math": "^5.11.29",
+    "@thi.ng/random": "^4.1.20",
+    "@thi.ng/strings": "^3.9.14",
+    "@thi.ng/vectors": "^8.3.0"
   },
   "devDependencies": {
     "esbuild": "^0.25.5",
@@ -218,6 +218,9 @@
     "./maxn": {
       "default": "./maxn.js"
     },
+    "./mean": {
+      "default": "./mean.js"
+    },
     "./min": {
       "default": "./min.js"
     },
@@ -322,5 +325,5 @@
     "status": "alpha",
     "year": 2018
   },
-  "gitHead": "61c3833b7ef7d044621454b5ea4af885d39f065e\n"
+  "gitHead": "93cdcd8db4d4669561a7f0ebc47697bdbfd04214\n"
 }

package/swap.js

@@ -7,6 +7,7 @@ const $swap = defOpRTT(
   },
   () => {
   },
+  void 0,
   false
 );
 const swap = (a, b) => $swap(a, b);