@thi.ng/api 8.11.33 → 8.12.1

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2025-07-30T22:32:35Z
+- **Last updated**: 2025-08-04T09:13:01Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.
@@ -11,6 +11,12 @@ 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.12.1](https://github.com/thi-ng/umbrella/tree/@thi.ng/api@8.12.1) (2025-08-04)
+
+#### 🚀 Features
+
+- add optional generics for typedarray types (TS5.9 induced) ([2af1b1e](https://github.com/thi-ng/umbrella/commit/2af1b1e))
+
 ### [8.11.3](https://github.com/thi-ng/umbrella/tree/@thi.ng/api@8.11.3) (2024-06-21)
 
 #### ♻️ Refactoring

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/api",
-  "version": "8.11.33",
+  "version": "8.12.1",
   "description": "Common, generic types, interfaces & mixins",
   "type": "module",
   "module": "./index.js",
@@ -43,8 +43,8 @@
   },
   "devDependencies": {
     "esbuild": "^0.25.8",
-    "typedoc": "^0.28.7",
-    "typescript": "^5.8.3"
+    "typedoc": "^0.28.9",
+    "typescript": "^5.9.2"
   },
   "keywords": [
     "constants",
@@ -233,5 +233,5 @@
   "thi.ng": {
     "tag": "none"
   },
-  "gitHead": "1df8a3a9061257ea73ccf1ab9cdf63c81a9f519f\n"
+  "gitHead": "0bcedf8d1dd4f30cd06bb2c668599628f2f0141e\n"
 }

package/typedarray.d.ts

@@ -1,11 +1,11 @@
 import type { Maybe } from "./null.js";
 export type ArrayLikeIterable<T> = ArrayLike<T> & Iterable<T>;
-export type NumericArray = number[] | TypedArray;
-export type TypedArray = Float32Array | Float64Array | Int8Array | Int16Array | Int32Array | Uint8Array | Uint8ClampedArray | Uint16Array | Uint32Array;
-export type BigTypedArray = BigInt64Array | BigUint64Array;
-export type FloatArray = Float32Array | Float64Array;
-export type IntArray = Int8Array | Int16Array | Int32Array;
-export type UIntArray = Uint8Array | Uint8ClampedArray | Uint16Array | Uint32Array;
+export type NumericArray<T extends ArrayBufferLike = ArrayBufferLike> = number[] | TypedArray<T>;
+export type TypedArray<T extends ArrayBufferLike = ArrayBufferLike> = FloatArray<T> | FloatArray<T> | IntArray<T> | UIntArray<T>;
+export type BigTypedArray<T extends ArrayBufferLike = ArrayBufferLike> = BigInt64Array<T> | BigUint64Array<T>;
+export type FloatArray<T extends ArrayBufferLike = ArrayBufferLike> = Float32Array<T> | Float64Array<T>;
+export type IntArray<T extends ArrayBufferLike = ArrayBufferLike> = Int8Array<T> | Int16Array<T> | Int32Array<T>;
+export type UIntArray<T extends ArrayBufferLike = ArrayBufferLike> = Uint8Array<T> | Uint8ClampedArray<T> | Uint16Array<T> | Uint32Array<T>;
 export type FloatArrayConstructor = Float32ArrayConstructor | Float64ArrayConstructor;
 export type IntArrayConstructor = Int8ArrayConstructor | Int16ArrayConstructor | Int32ArrayConstructor;
 export type UIntArrayConstructor = Uint8ArrayConstructor | Uint8ClampedArrayConstructor | Uint16ArrayConstructor | Uint32ArrayConstructor;
@@ -90,27 +90,27 @@ export declare const INT_ARRAY_CTORS: Record<IntType, IntArrayConstructor>;
 export declare const UINT_ARRAY_CTORS: Record<UintType, UIntArrayConstructor>;
 export declare const BIGINT_ARRAY_CTORS: Record<BigType, BigIntArrayConstructor>;
 export declare const TYPEDARRAY_CTORS: Record<Type, TypedArrayConstructor>;
-export interface TypedArrayTypeMap extends Record<Type | GLType, TypedArray> {
-    u8: Uint8Array;
-    u8c: Uint8ClampedArray;
-    i8: Int8Array;
-    u16: Uint16Array;
-    i16: Int16Array;
-    u32: Uint32Array;
-    i32: Int32Array;
-    f32: Float32Array;
-    f64: Float64Array;
-    [GLType.U8]: Uint8Array;
-    [GLType.I8]: Int8Array;
-    [GLType.U16]: Uint16Array;
-    [GLType.I16]: Int16Array;
-    [GLType.U32]: Uint32Array;
-    [GLType.I32]: Int32Array;
-    [GLType.F32]: Float32Array;
+export interface TypedArrayTypeMap<T extends ArrayBufferLike = ArrayBufferLike> extends Record<Type | GLType, TypedArray<T>> {
+    u8: Uint8Array<T>;
+    u8c: Uint8ClampedArray<T>;
+    i8: Int8Array<T>;
+    u16: Uint16Array<T>;
+    i16: Int16Array<T>;
+    u32: Uint32Array<T>;
+    i32: Int32Array<T>;
+    f32: Float32Array<T>;
+    f64: Float64Array<T>;
+    [GLType.U8]: Uint8Array<T>;
+    [GLType.I8]: Int8Array<T>;
+    [GLType.U16]: Uint16Array<T>;
+    [GLType.I16]: Int16Array<T>;
+    [GLType.U32]: Uint32Array<T>;
+    [GLType.I32]: Int32Array<T>;
+    [GLType.F32]: Float32Array<T>;
 }
-export interface BigTypedArrayTypeMap extends Record<BigType, BigTypedArray> {
-    i64: BigInt64Array;
-    u64: BigUint64Array;
+export interface BigTypedArrayTypeMap<T extends ArrayBufferLike = ArrayBufferLike> extends Record<BigType, BigTypedArray<T>> {
+    i64: BigInt64Array<T>;
+    u64: BigUint64Array<T>;
 }
 /**
  * Returns canonical {@link Type} value of `type` by first
@@ -172,11 +172,11 @@ export declare const sizeOf: (type: Type | BigType | GLType) => number;
  * @param type - array type enum
  */
 export declare function typedArray<T extends Type | GLType>(type: T, length: number): TypedArrayTypeMap[T];
-export declare function typedArray<T extends Type | GLType>(type: T, src: ArrayLike<number> | ArrayBufferLike): TypedArrayTypeMap[T];
-export declare function typedArray<T extends Type | GLType>(type: T, buf: ArrayBufferLike, byteOffset: number, length?: number): TypedArrayTypeMap[T];
-export declare function typedArray<T extends BigType>(type: T, length: number): BigTypedArrayTypeMap[T];
-export declare function typedArray<T extends BigType>(type: T, src: ArrayLike<bigint> | ArrayBufferLike): BigTypedArrayTypeMap[T];
-export declare function typedArray<T extends BigType>(type: T, buf: ArrayBufferLike, byteOffset: number, length?: number): BigTypedArrayTypeMap[T];
+export declare function typedArray<T extends Type | GLType, B extends ArrayBufferLike>(type: T, src: ArrayLike<number> | B): TypedArrayTypeMap<B>[T];
+export declare function typedArray<T extends Type | GLType, B extends ArrayBufferLike>(type: T, buf: B, byteOffset: number, length?: number): TypedArrayTypeMap<B>[T];
+export declare function typedArray<T extends BigType, B extends ArrayBufferLike>(type: T, length: number): BigTypedArrayTypeMap<B>[T];
+export declare function typedArray<T extends BigType, B extends ArrayBufferLike>(type: T, src: ArrayLike<bigint> | B): BigTypedArrayTypeMap<B>[T];
+export declare function typedArray<T extends BigType, B extends ArrayBufferLike>(type: T, buf: ArrayBufferLike, byteOffset: number, length?: number): BigTypedArrayTypeMap<B>[T];
 /**
  * Constructs a typed array for given `type` and populates it with given vector
  * values.