@daneren2005/shared-memory-objects 0.0.20 → 1.0.0

package/dist/src/memory-heap.d.ts

@@ -15,7 +15,6 @@ export default class MemoryHeap {
     getSharedAlloc(shared: SharedAllocatedMemory): AllocatedMemory | undefined;
     get currentUsed(): number;
     get totalAllocated(): number;
-    prettyMemory(): string;
     getSharedMemory(): MemoryHeapMemory;
 }
 type OnGrowBuffer = (newBuffer: GrowBufferData) => void;

package/dist/src/utils/atomic-math.d.ts

@@ -1,4 +1,4 @@
-export declare function addAtomicInt(array: Uint32Array | Int32Array, index: number, amount: number, max: number): void;
-export declare function subtractAtomicInt(array: Uint32Array | Int32Array, index: number, amount: number, min: number): void;
-export declare function addAtomicFloat32(array: Float32Array, index: number, amount: number, max: number): void;
-export declare function subtractAtomicFloat(array: Float32Array, index: number, amount: number, min: number): void;
+export declare function addAtomicInt(array: Uint32Array | Int32Array, index: number, amount: number, max: number): number;
+export declare function subtractAtomicInt(array: Uint32Array | Int32Array, index: number, amount: number, min: number): number;
+export declare function addAtomicFloat32(array: Float32Array, index: number, amount: number, max: number): number;
+export declare function subtractAtomicFloat(array: Float32Array, index: number, amount: number, min: number): number;

package/dist/src/utils/typedarray.d.ts

@@ -1,279 +1,279 @@
-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 FloatArrayConstructor = Float32ArrayConstructor | Float64ArrayConstructor;
-export type IntArrayConstructor = Int8ArrayConstructor | Int16ArrayConstructor | Int32ArrayConstructor;
-export type UIntArrayConstructor = Uint8ArrayConstructor | Uint8ClampedArrayConstructor | Uint16ArrayConstructor | Uint32ArrayConstructor;
-export type BigIntArrayConstructor = BigInt64ArrayConstructor | BigUint64ArrayConstructor;
-export type TypedArrayConstructor = FloatArrayConstructor | IntArrayConstructor | UIntArrayConstructor;
-/**
- * Type IDs for typed array backed buffers and generally describing binary data
- * values.
- *
- * {@link GLType} {@link GL2TYPE} {@link TYPE2GL}
- */
-export type Type = 'u8' | 'u8c' | 'i8' | 'u16' | 'i16' | 'u32' | 'i32' | 'f32' | 'f64';
-export type BigType = 'i64' | 'u64';
-export type UintType = 'u8' | 'u8c' | 'u16' | 'u32';
-export type IntType = 'i8' | 'i16' | 'i32';
-export type FloatType = 'f32' | 'f64';
-/**
- * WebGL numeric type constants. Use {@link GL2TYPE} to convert, if needed.
- *
- * {@link Type}
- * {@link GL2TYPE}
- * {@link TYPE2GL}
- */
-export declare enum GLType {
-    I8 = 5120,
-    U8 = 5121,
-    I16 = 5122,
-    U16 = 5123,
-    I32 = 5124,
-    U32 = 5125,
-    F32 = 5126
-}
-/**
- * Conversion from {@link GLType} to {@link Type} enums.
- */
-export declare const GL2TYPE: Record<GLType, Type>;
-/**
- * Potentially lossy conversion from {@link Type} to {@link GLType} enums.
- *
- * Not all enums are mappable:
- *
- * - `F64` maps to `undefined`, since unsupported by WebGL
- * - `U8C` maps to "u8"
- */
-export declare const TYPE2GL: Record<Type, GLType | undefined>;
-/**
- * Size information (in bytes) for {@link Type} and {@link BigType}. Also see
- * {@link sizeOf}.
- */
-export declare const SIZEOF: {
-    u8: number;
-    u8c: number;
-    i8: number;
-    u16: number;
-    i16: number;
-    u32: number;
-    i32: number;
-    i64: number;
-    u64: number;
-    f32: number;
-    f64: number;
-};
-/**
- * Bit shift values to convert byte addresses into array indices for all
- * {@link Type}s and {@link BigType}s.
- */
-export declare const BIT_SHIFTS: {
-    i8: number;
-    u8: number;
-    u8c: number;
-    i16: number;
-    u16: number;
-    i32: number;
-    u32: number;
-    i64: number;
-    u64: number;
-    f32: number;
-    f64: number;
-};
-export declare const FLOAT_ARRAY_CTORS: Record<FloatType, FloatArrayConstructor>;
-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 BigTypedArrayTypeMap extends Record<BigType, BigTypedArray> {
-    i64: BigInt64Array;
-    u64: BigUint64Array;
-}
-/**
- * Returns canonical {@link Type} value of `type` by first
- * attempting to resolve it as {@link GLType} enum.
- *
- * @example
- * ```ts
- * asNativeType(GLType.F32) => "f32"
- * asNativeType("f32") => "f32"
- * ```
- *
- * @param type -
- */
-export declare const asNativeType: (type: GLType | Type) => Type;
-/**
- * Returns suitable {@link GLType} enum of `type`.
- *
- * @example
- * ```ts
- * asGLType("f32") => GLType.F32
- * asGLType(GLType.F32) => GLType.F32
- * ```
- *
- * @param type -
- */
-export declare const asGLType: (type: GLType | Type) => GLType;
-/**
- * Coerces given numeric args to integer values.
- */
-export declare const asInt: (...args: number[]) => number[];
-/**
- * Returns byte size for given {@link Type} ID or {@link GLType} enum.
- *
- * @param type -
- */
-export declare const sizeOf: (type: Type | BigType | GLType) => number;
-/**
- * Constructs new typed array of given {@link Type}, {@link GLType} or
- * {@link BigType}. Supports all arities of standard typed array ctors.
- *
- * @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];
-/**
- * Constructs a typed array for given `type` and populates it with given vector
- * values.
- *
- * @remarks
- * The size of the array will be `data.length * stride`, where `stride` is the
- * number of elements per item and defaulting to the size of the first data
- * item/vector given.
- *
- * @example
- * ```ts
- * // inferred stride=2 (2d vectors)
- * typedArrayOfVec("f32", [[1,2], [3,4], [-10,20]]);
- * // Float32Array(6) [ 1, 2, 3, 4, -10, 20 ]
- *
- * // with custom stride=4
- * typedArrayOfVec("f32", [[1,2], [3,4], [-10,20]], 4);
- * // Float32Array(12) [ 1, 2, 0, 0, 3,4, 0, 0, -10, 20, 0, 0 ]
- * ```
- *
- * @param type
- * @param data
- * @param stride
- */
-export declare function typedArrayOfVec<T extends Type | GLType>(type: T, data: Iterable<ArrayLike<number>>, stride?: number): TypedArrayTypeMap[T];
-export declare function typedArrayOfVec<T extends BigType>(type: T, data: Iterable<ArrayLike<bigint>>, stride?: number): BigTypedArrayTypeMap[T];
-/**
- * Takes an {@link NumericArray} and returns its corresponding {@link Type} ID.
- * Standard JS arrays will default to {@link "f64"}.
- *
- * @param x -
- */
-export declare const typedArrayType: (x: NumericArray) => Type;
-/**
- * Returns the smallest possible *unsigned* int type enum for given `x`.
- * E.g. if `x <= 256`, the function returns `"u8"`.
- *
- * @param x - value to classify
- */
-export declare const uintTypeForSize: (x: number) => UintType;
-/**
- * Returns the smallest possible *signed* int type enum for given `x`.
- * E.g. if `x >= -128 && x < 128`, the function returns `"i8"`.
- *
- * @param x - value to classify
- */
-export declare const intTypeForSize: (x: number) => IntType;
-/**
- * Returns suitable {@link UintType} for given bit size (`[0,32]` range)
- *
- * @param x -
- */
-export declare const uintTypeForBits: (x: number) => UintType;
-/**
- * Returns suitable {@link IntType} for given bit size (`[0,32]` range)
- *
- * @param x -
- */
-export declare const intTypeForBits: (x: number) => IntType;
-/**
- * Returns the next smaller {@link IntType} for given type (or the same type if
- * already the narrowest).
- *
- * @param t
- */
-export declare const narrowInt: (t: IntType | 'i64') => 'i8' | 'i16' | 'i32';
-/**
- * Returns the next larger {@link IntType} for given type (or the same type if
- * already the widest).
- *
- * @param t
- */
-export declare const widenInt: (t: IntType) => 'i16' | 'i32' | 'i64';
-/**
- * Returns the next smaller {@link UintType} for given type (or the same type if
- * already the narrowest).
- *
- * @remarks
- * If type is `u8c`, returns `u8`.
- *
- * @param t
- */
-export declare const narrowUint: (t: UintType | 'u64') => 'u8' | 'u16' | 'u32';
-/**
- * Returns the next larger {@link UintType} for given type (or the same type if
- * already the widest).
- *
- * @param t
- */
-export declare const widenUint: (t: UintType) => 'u16' | 'u32' | 'u64';
-/**
- * Returns the next smaller {@link FloatType} for given type (or the same type
- * if already the narrowest).
- *
- * @param t
- */
-export declare const narrowFloat: (t: FloatType) => string;
-/**
- * Returns the next larger {@link FloatType} for given type (or the same type if
- * already the widest).
- *
- * @param t
- */
-export declare const widenFloat: (t: FloatType) => string;
-/**
- * Returns the next smaller type (i.e. {@link IntType}, {@link UintType} or
- * {@link FloatType}) for given type (or the same type if already the smallest).
- *
- * @param t
- */
-export declare const narrowType: (t: Type | BigType) => string;
-/**
- * Returns the next larger type (i.e. {@link IntType}, {@link UintType} or
- * {@link FloatType}) for given type (or the same type if already the widest).
- *
- * @param t
- */
-export declare const widenType: (t: Type | BigType) => string;
+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 FloatArrayConstructor = Float32ArrayConstructor | Float64ArrayConstructor;
+export type IntArrayConstructor = Int8ArrayConstructor | Int16ArrayConstructor | Int32ArrayConstructor;
+export type UIntArrayConstructor = Uint8ArrayConstructor | Uint8ClampedArrayConstructor | Uint16ArrayConstructor | Uint32ArrayConstructor;
+export type BigIntArrayConstructor = BigInt64ArrayConstructor | BigUint64ArrayConstructor;
+export type TypedArrayConstructor = FloatArrayConstructor | IntArrayConstructor | UIntArrayConstructor;
+/**
+ * Type IDs for typed array backed buffers and generally describing binary data
+ * values.
+ *
+ * {@link GLType} {@link GL2TYPE} {@link TYPE2GL}
+ */
+export type Type = 'u8' | 'u8c' | 'i8' | 'u16' | 'i16' | 'u32' | 'i32' | 'f32' | 'f64';
+export type BigType = 'i64' | 'u64';
+export type UintType = 'u8' | 'u8c' | 'u16' | 'u32';
+export type IntType = 'i8' | 'i16' | 'i32';
+export type FloatType = 'f32' | 'f64';
+/**
+ * WebGL numeric type constants. Use {@link GL2TYPE} to convert, if needed.
+ *
+ * {@link Type}
+ * {@link GL2TYPE}
+ * {@link TYPE2GL}
+ */
+export declare enum GLType {
+    I8 = 5120,
+    U8 = 5121,
+    I16 = 5122,
+    U16 = 5123,
+    I32 = 5124,
+    U32 = 5125,
+    F32 = 5126
+}
+/**
+ * Conversion from {@link GLType} to {@link Type} enums.
+ */
+export declare const GL2TYPE: Record<GLType, Type>;
+/**
+ * Potentially lossy conversion from {@link Type} to {@link GLType} enums.
+ *
+ * Not all enums are mappable:
+ *
+ * - `F64` maps to `undefined`, since unsupported by WebGL
+ * - `U8C` maps to "u8"
+ */
+export declare const TYPE2GL: Record<Type, GLType | undefined>;
+/**
+ * Size information (in bytes) for {@link Type} and {@link BigType}. Also see
+ * {@link sizeOf}.
+ */
+export declare const SIZEOF: {
+    u8: number;
+    u8c: number;
+    i8: number;
+    u16: number;
+    i16: number;
+    u32: number;
+    i32: number;
+    i64: number;
+    u64: number;
+    f32: number;
+    f64: number;
+};
+/**
+ * Bit shift values to convert byte addresses into array indices for all
+ * {@link Type}s and {@link BigType}s.
+ */
+export declare const BIT_SHIFTS: {
+    i8: number;
+    u8: number;
+    u8c: number;
+    i16: number;
+    u16: number;
+    i32: number;
+    u32: number;
+    i64: number;
+    u64: number;
+    f32: number;
+    f64: number;
+};
+export declare const FLOAT_ARRAY_CTORS: Record<FloatType, FloatArrayConstructor>;
+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 BigTypedArrayTypeMap extends Record<BigType, BigTypedArray> {
+    i64: BigInt64Array;
+    u64: BigUint64Array;
+}
+/**
+ * Returns canonical {@link Type} value of `type` by first
+ * attempting to resolve it as {@link GLType} enum.
+ *
+ * @example
+ * ```ts
+ * asNativeType(GLType.F32) => "f32"
+ * asNativeType("f32") => "f32"
+ * ```
+ *
+ * @param type -
+ */
+export declare const asNativeType: (type: GLType | Type) => Type;
+/**
+ * Returns suitable {@link GLType} enum of `type`.
+ *
+ * @example
+ * ```ts
+ * asGLType("f32") => GLType.F32
+ * asGLType(GLType.F32) => GLType.F32
+ * ```
+ *
+ * @param type -
+ */
+export declare const asGLType: (type: GLType | Type) => GLType;
+/**
+ * Coerces given numeric args to integer values.
+ */
+export declare const asInt: (...args: number[]) => number[];
+/**
+ * Returns byte size for given {@link Type} ID or {@link GLType} enum.
+ *
+ * @param type -
+ */
+export declare const sizeOf: (type: Type | BigType | GLType) => number;
+/**
+ * Constructs new typed array of given {@link Type}, {@link GLType} or
+ * {@link BigType}. Supports all arities of standard typed array ctors.
+ *
+ * @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];
+/**
+ * Constructs a typed array for given `type` and populates it with given vector
+ * values.
+ *
+ * @remarks
+ * The size of the array will be `data.length * stride`, where `stride` is the
+ * number of elements per item and defaulting to the size of the first data
+ * item/vector given.
+ *
+ * @example
+ * ```ts
+ * // inferred stride=2 (2d vectors)
+ * typedArrayOfVec("f32", [[1,2], [3,4], [-10,20]]);
+ * // Float32Array(6) [ 1, 2, 3, 4, -10, 20 ]
+ *
+ * // with custom stride=4
+ * typedArrayOfVec("f32", [[1,2], [3,4], [-10,20]], 4);
+ * // Float32Array(12) [ 1, 2, 0, 0, 3,4, 0, 0, -10, 20, 0, 0 ]
+ * ```
+ *
+ * @param type
+ * @param data
+ * @param stride
+ */
+export declare function typedArrayOfVec<T extends Type | GLType>(type: T, data: Iterable<ArrayLike<number>>, stride?: number): TypedArrayTypeMap[T];
+export declare function typedArrayOfVec<T extends BigType>(type: T, data: Iterable<ArrayLike<bigint>>, stride?: number): BigTypedArrayTypeMap[T];
+/**
+ * Takes an {@link NumericArray} and returns its corresponding {@link Type} ID.
+ * Standard JS arrays will default to {@link "f64"}.
+ *
+ * @param x -
+ */
+export declare const typedArrayType: (x: NumericArray) => Type;
+/**
+ * Returns the smallest possible *unsigned* int type enum for given `x`.
+ * E.g. if `x <= 256`, the function returns `"u8"`.
+ *
+ * @param x - value to classify
+ */
+export declare const uintTypeForSize: (x: number) => UintType;
+/**
+ * Returns the smallest possible *signed* int type enum for given `x`.
+ * E.g. if `x >= -128 && x < 128`, the function returns `"i8"`.
+ *
+ * @param x - value to classify
+ */
+export declare const intTypeForSize: (x: number) => IntType;
+/**
+ * Returns suitable {@link UintType} for given bit size (`[0,32]` range)
+ *
+ * @param x -
+ */
+export declare const uintTypeForBits: (x: number) => UintType;
+/**
+ * Returns suitable {@link IntType} for given bit size (`[0,32]` range)
+ *
+ * @param x -
+ */
+export declare const intTypeForBits: (x: number) => IntType;
+/**
+ * Returns the next smaller {@link IntType} for given type (or the same type if
+ * already the narrowest).
+ *
+ * @param t
+ */
+export declare const narrowInt: (t: IntType | 'i64') => 'i8' | 'i16' | 'i32';
+/**
+ * Returns the next larger {@link IntType} for given type (or the same type if
+ * already the widest).
+ *
+ * @param t
+ */
+export declare const widenInt: (t: IntType) => 'i16' | 'i32' | 'i64';
+/**
+ * Returns the next smaller {@link UintType} for given type (or the same type if
+ * already the narrowest).
+ *
+ * @remarks
+ * If type is `u8c`, returns `u8`.
+ *
+ * @param t
+ */
+export declare const narrowUint: (t: UintType | 'u64') => 'u8' | 'u16' | 'u32';
+/**
+ * Returns the next larger {@link UintType} for given type (or the same type if
+ * already the widest).
+ *
+ * @param t
+ */
+export declare const widenUint: (t: UintType) => 'u16' | 'u32' | 'u64';
+/**
+ * Returns the next smaller {@link FloatType} for given type (or the same type
+ * if already the narrowest).
+ *
+ * @param t
+ */
+export declare const narrowFloat: (t: FloatType) => string;
+/**
+ * Returns the next larger {@link FloatType} for given type (or the same type if
+ * already the widest).
+ *
+ * @param t
+ */
+export declare const widenFloat: (t: FloatType) => string;
+/**
+ * Returns the next smaller type (i.e. {@link IntType}, {@link UintType} or
+ * {@link FloatType}) for given type (or the same type if already the smallest).
+ *
+ * @param t
+ */
+export declare const narrowType: (t: Type | BigType) => string;
+/**
+ * Returns the next larger type (i.e. {@link IntType}, {@link UintType} or
+ * {@link FloatType}) for given type (or the same type if already the widest).
+ *
+ * @param t
+ */
+export declare const widenType: (t: Type | BigType) => string;
 //# sourceMappingURL=typedarray.d.ts.map