@thi.ng/api 8.11.1 → 8.11.3

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2024-04-23T07:02:17Z
+- **Last updated**: 2024-06-21T19:34:38Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.
@@ -9,6 +9,13 @@ 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.
 
+### [8.11.3](https://github.com/thi-ng/umbrella/tree/@thi.ng/api@8.11.3) (2024-06-21)
+
+#### ♻️ Refactoring
+
+- rename various rest args to be more semantically meaningful ([8088a56](https://github.com/thi-ng/umbrella/commit/8088a56))
+- enforce uniform naming convention of internal functions ([56992b2](https://github.com/thi-ng/umbrella/commit/56992b2))
+
 ## [8.11.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/api@8.11.0) (2024-04-20)
 
 #### 🚀 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 192 standalone projects, maintained as part
+> This is one of 193 standalone projects, maintained as part
 > of the [@thi.ng/umbrella](https://github.com/thi-ng/umbrella/) monorepo
 > and anti-framework.
 >

package/fn.d.ts

@@ -42,24 +42,24 @@ export type Fn9<A, B, C, D, E, F, G, H, I, J> = (a: A, b: B, c: C, d: D, e: E, f
  * A 10-arg function from A,B,C,D,E,F,G,H,I,J to K.
  */
 export type Fn10<A, B, C, D, E, F, G, H, I, J, K> = (a: A, b: B, c: C, d: D, e: E, f: F, g: G, h: H, i: I, j: J) => K;
-export type FnO<A, B> = (a: A, ...xs: any[]) => B;
-export type FnO2<A, B, C> = (a: A, b: B, ...xs: any[]) => C;
-export type FnO3<A, B, C, D> = (a: A, b: B, c: C, ...xs: any[]) => D;
-export type FnO4<A, B, C, D, E> = (a: A, b: B, c: C, d: D, ...xs: any[]) => E;
-export type FnO5<A, B, C, D, E, F> = (a: A, b: B, c: C, d: D, e: E, ...xs: any[]) => F;
-export type FnO6<A, B, C, D, E, F, G> = (a: A, b: B, c: C, d: D, e: E, f: F, ...xs: any[]) => G;
-export type FnO7<A, B, C, D, E, F, G, H> = (a: A, b: B, c: C, d: D, e: E, f: F, g: G, ...xs: any[]) => H;
-export type FnO8<A, B, C, D, E, F, G, H, I> = (a: A, b: B, c: C, d: D, e: E, f: F, g: G, h: H, ...xs: any[]) => I;
-export type FnO9<A, B, C, D, E, F, G, H, I, J> = (a: A, b: B, c: C, d: D, e: E, f: F, g: G, h: H, i: I, ...xs: any[]) => J;
-export type FnO10<A, B, C, D, E, F, G, H, I, J, K> = (a: A, b: B, c: C, d: D, e: E, f: F, g: G, h: H, i: I, j: J, ...xs: any[]) => K;
+export type FnO<A, B> = (a: A, ...args: any[]) => B;
+export type FnO2<A, B, C> = (a: A, b: B, ...args: any[]) => C;
+export type FnO3<A, B, C, D> = (a: A, b: B, c: C, ...args: any[]) => D;
+export type FnO4<A, B, C, D, E> = (a: A, b: B, c: C, d: D, ...args: any[]) => E;
+export type FnO5<A, B, C, D, E, F> = (a: A, b: B, c: C, d: D, e: E, ...args: any[]) => F;
+export type FnO6<A, B, C, D, E, F, G> = (a: A, b: B, c: C, d: D, e: E, f: F, ...args: any[]) => G;
+export type FnO7<A, B, C, D, E, F, G, H> = (a: A, b: B, c: C, d: D, e: E, f: F, g: G, ...args: any[]) => H;
+export type FnO8<A, B, C, D, E, F, G, H, I> = (a: A, b: B, c: C, d: D, e: E, f: F, g: G, h: H, ...args: any[]) => I;
+export type FnO9<A, B, C, D, E, F, G, H, I, J> = (a: A, b: B, c: C, d: D, e: E, f: F, g: G, h: H, i: I, ...args: any[]) => J;
+export type FnO10<A, B, C, D, E, F, G, H, I, J, K> = (a: A, b: B, c: C, d: D, e: E, f: F, g: G, h: H, i: I, j: J, ...args: any[]) => K;
 /**
  * An untyped vararg arg function to type T.
  */
-export type FnAny<T> = (...xs: any[]) => T;
+export type FnAny<T> = (...args: any[]) => T;
 /**
  * A typed vararg arg function from A to B.
  */
-export type FnAnyT<A, B> = (...xs: A[]) => B;
+export type FnAnyT<A, B> = (...args: A[]) => B;
 /**
  * 1-arg function with arg of type A and return type B (defaults
  * to A)

package/hiccup.d.ts

@@ -7,8 +7,8 @@ export interface IToHiccup {
      *
      * @param ctx - user context object
      * @param attribs - user attribs
-     * @param xs - additional args
+     * @param args - additional args
      */
-    toHiccup(ctx?: any, attribs?: any, ...xs: any[]): any;
+    toHiccup(ctx?: any, attribs?: any, ...args: any[]): any;
 }
 //# sourceMappingURL=hiccup.d.ts.map

package/mixins/igrid.js

@@ -56,7 +56,7 @@ const IGrid2DMixin = mixin({
 });
 const IGrid3DMixin = mixin({
   order() {
-    return strideOrder(this.stride);
+    return __strideOrder(this.stride);
   },
   includes(x, y, z) {
     const size = this.size;
@@ -85,7 +85,7 @@ const IGrid3DMixin = mixin({
 });
 const IGrid4DMixin = mixin({
   order() {
-    return strideOrder(this.stride);
+    return __strideOrder(this.stride);
   },
   includes(x, y, z, w) {
     const size = this.size;
@@ -112,7 +112,7 @@ const IGrid4DMixin = mixin({
     return true;
   }
 });
-const strideOrder = (strides) => [...strides].map((x, i) => [x, i]).sort((a, b) => Math.abs(b[0]) - Math.abs(a[0])).map((x) => x[1]);
+const __strideOrder = (strides) => [...strides].map((x, i) => [x, i]).sort((a, b) => Math.abs(b[0]) - Math.abs(a[0])).map((x) => x[1]);
 export {
   IGrid1DMixin,
   IGrid2DMixin,

package/mixins/inotify.js

@@ -1,8 +1,7 @@
 import { EVENT_ALL } from "../api.js";
 import { mixin } from "../mixin.js";
 const inotify_dispatch = (listeners, e) => {
-  if (!listeners)
-    return false;
+  if (!listeners) return false;
   for (let i = 0, n = listeners.length, l; i < n; i++) {
     l = listeners[i];
     l[0].call(l[1], e);
@@ -24,8 +23,7 @@ const INotifyMixin = mixin({
   },
   removeListener(id, fn, scope) {
     let listeners;
-    if (!(listeners = this._listeners))
-      return false;
+    if (!(listeners = this._listeners)) return false;
     const l = listeners[id];
     if (l) {
       const idx = this.__listener(l, fn, scope);
@@ -39,8 +37,7 @@ const INotifyMixin = mixin({
   },
   notify(e) {
     let listeners;
-    if (!(listeners = this._listeners))
-      return false;
+    if (!(listeners = this._listeners)) return false;
     e.target === void 0 && (e.target = this);
     const res = inotify_dispatch(listeners[e.id], e);
     return inotify_dispatch(listeners[EVENT_ALL], e) || res;

package/mixins/iwatch.js

@@ -9,8 +9,7 @@ const IWatchMixin = mixin({
     return true;
   },
   removeWatch(id) {
-    if (!this._watches)
-      return;
+    if (!this._watches) return;
     if (this._watches[id]) {
       delete this._watches[id];
       return true;
@@ -18,8 +17,7 @@ const IWatchMixin = mixin({
     return false;
   },
   notifyWatches(oldState, newState) {
-    if (!this._watches)
-      return;
+    if (!this._watches) return;
     const w = this._watches;
     for (let id in w) {
       w[id](id, oldState, newState);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/api",
-  "version": "8.11.1",
+  "version": "8.11.3",
   "description": "Common, generic types, interfaces & mixins",
   "type": "module",
   "module": "./index.js",
@@ -10,7 +10,7 @@
     "type": "git",
     "url": "https://github.com/thi-ng/umbrella.git"
   },
-  "homepage": "https://github.com/thi-ng/umbrella/tree/develop/packages/api#readme",
+  "homepage": "https://thi.ng/api",
   "funding": [
     {
       "type": "github",
@@ -39,10 +39,10 @@
     "tool:tangle": "../../node_modules/.bin/tangle src/**/*.ts"
   },
   "devDependencies": {
-    "@microsoft/api-extractor": "^7.43.0",
-    "esbuild": "^0.20.2",
-    "typedoc": "^0.25.12",
-    "typescript": "^5.4.3"
+    "@microsoft/api-extractor": "^7.47.0",
+    "esbuild": "^0.21.5",
+    "typedoc": "^0.25.13",
+    "typescript": "^5.5.2"
   },
   "keywords": [
     "assert",
@@ -228,5 +228,5 @@
       "default": "./watch.js"
     }
   },
-  "gitHead": "5dd66c18a3862a3af69a5b2f49563f7cbdd960c2\n"
+  "gitHead": "154c95cf9d6bab32174498ec3b5b5d87e42be7f9\n"
 }

package/typedarray.js

@@ -88,14 +88,13 @@ const asGLType = (type) => {
 };
 const asInt = (...args) => args.map((x) => x | 0);
 const sizeOf = (type) => SIZEOF[type] || SIZEOF[asNativeType(type)];
-function typedArray(type, ...xs) {
+function typedArray(type, ...args) {
   const ctor = BIGINT_ARRAY_CTORS[type];
-  return new (ctor || TYPEDARRAY_CTORS[asNativeType(type)])(...xs);
+  return new (ctor || TYPEDARRAY_CTORS[asNativeType(type)])(...args);
 }
 function typedArrayOfVec(type, data, stride) {
   const $data = Array.isArray(data) ? data : [...data];
-  if (stride === void 0)
-    stride = $data[0].length;
+  if (stride === void 0) stride = $data[0].length;
   const num = $data.length;
   const res = typedArray(type, num * stride);
   for (let i = 0, j = 0; i < num; i++, j += stride) {
@@ -104,11 +103,9 @@ function typedArrayOfVec(type, data, stride) {
   return res;
 }
 const typedArrayType = (x) => {
-  if (Array.isArray(x))
-    return "f64";
+  if (Array.isArray(x)) return "f64";
   for (let id in TYPEDARRAY_CTORS) {
-    if (x instanceof TYPEDARRAY_CTORS[id])
-      return id;
+    if (x instanceof TYPEDARRAY_CTORS[id]) return id;
   }
   return "f64";
 };