utilium 1.3.0 → 1.3.2

package/dist/buffer.js

@@ -1,4 +1,4 @@
-/* eslint-disable @typescript-eslint/no-unsafe-call,@typescript-eslint/no-unused-expressions */
+/* eslint-disable @typescript-eslint/no-unused-expressions */
 /**
  * Grows a buffer if it isn't large enough
  * @returns The original buffer if resized successfully, or a newly created buffer

package/dist/checksum.d.ts

@@ -0,0 +1,5 @@
+/** Utilities for computing checksums */
+/**
+ * Computes the CRC32C checksum of a Uint8Array.
+ */
+export declare function crc32c(data: Uint8Array): number;

package/dist/checksum.js

@@ -0,0 +1,20 @@
+/** Utilities for computing checksums */
+// Precompute CRC32C table
+const crc32cTable = new Uint32Array(256);
+for (let i = 0; i < 256; i++) {
+    let value = i;
+    for (let j = 0; j < 8; j++) {
+        value = value & 1 ? 0x82f63b78 ^ (value >>> 1) : value >>> 1;
+    }
+    crc32cTable[i] = value;
+}
+/**
+ * Computes the CRC32C checksum of a Uint8Array.
+ */
+export function crc32c(data) {
+    let crc = 0xffffffff;
+    for (let i = 0; i < data.length; i++) {
+        crc = (crc >>> 8) ^ crc32cTable[(crc ^ data[i]) & 0xff];
+    }
+    return (crc ^ 0xffffffff) >>> 0;
+}

package/dist/objects.d.ts

@@ -32,3 +32,5 @@ export interface ConstMap<T extends Partial<Record<keyof any, any>>, K extends k
 export declare function map<const T extends Partial<Record<any, any>>>(items: T): Map<keyof T, T[keyof T]>;
 export declare function getByString(object: Record<string, any>, path: string, separator?: RegExp): Record<string, any>;
 export declare function setByString(object: Record<string, any>, path: string, value: unknown, separator?: RegExp): Record<string, any>;
+/** Binds a class member to the instance */
+export declare function bound(value: unknown, { name, addInitializer }: ClassMethodDecoratorContext): void;

package/dist/objects.js

@@ -18,7 +18,7 @@ export function assignWithDefaults(to, from, defaults = to) {
         try {
             to[key] = from[key] ?? defaults[key] ?? to[key];
         }
-        catch (e) {
+        catch {
             // Do nothing
         }
     }
@@ -28,7 +28,7 @@ export function isJSON(str) {
         JSON.parse(str);
         return true;
     }
-    catch (e) {
+    catch {
         return false;
     }
 }
@@ -56,3 +56,11 @@ export function setByString(object, path, value, separator = /[.[\]'"]/) {
         .filter(p => p)
         .reduce((o, p, i) => (o[p] = path.split(separator).filter(p => p).length === ++i ? value : o[p] || {}), object);
 }
+/** Binds a class member to the instance */
+// eslint-disable-next-line @typescript-eslint/unbound-method
+export function bound(value, { name, addInitializer }) {
+    addInitializer(function () {
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-call
+        this[name] = this[name].bind(this);
+    });
+}

package/dist/struct.d.ts

@@ -7,6 +7,10 @@ export * as Struct from './internal/struct.js';
  * Gets the size in bytes of a type
  */
 export declare function sizeof<T extends primitive.Valid | StaticLike | InstanceLike>(type: T): Size<T>;
+/**
+ * Returns the offset (in bytes) of a member in a struct.
+ */
+export declare function offsetof(type: StaticLike | InstanceLike, memberName: string): number;
 /**
  * Aligns a number
  */

package/dist/struct.js

@@ -15,6 +15,18 @@ export function sizeof(type) {
     const struct = isStatic(type) ? type : type.constructor;
     return struct[symbol_metadata(struct)][Symbol.struct_metadata].size;
 }
+/**
+ * Returns the offset (in bytes) of a member in a struct.
+ */
+export function offsetof(type, memberName) {
+    checkStruct(type);
+    const struct = isStatic(type) ? type : type.constructor;
+    const metadata = struct[symbol_metadata(struct)][Symbol.struct_metadata];
+    const member = metadata.members.get(memberName);
+    if (!member)
+        throw new Error('Struct does not have member: ' + memberName);
+    return member.offset;
+}
 /**
  * Aligns a number
  */

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "utilium",
-	"version": "1.3.0",
+	"version": "1.3.2",
 	"description": "Typescript utilities",
 	"funding": {
 		"type": "individual",

package/src/buffer.ts

@@ -1,4 +1,4 @@
-/* eslint-disable @typescript-eslint/no-unsafe-call,@typescript-eslint/no-unused-expressions */
+/* eslint-disable @typescript-eslint/no-unused-expressions */
 
 /**
  * A generic ArrayBufferView (typed array) constructor

package/src/checksum.ts

@@ -0,0 +1,22 @@
+/** Utilities for computing checksums */
+
+// Precompute CRC32C table
+const crc32cTable = new Uint32Array(256);
+for (let i = 0; i < 256; i++) {
+	let value = i;
+	for (let j = 0; j < 8; j++) {
+		value = value & 1 ? 0x82f63b78 ^ (value >>> 1) : value >>> 1;
+	}
+	crc32cTable[i] = value;
+}
+
+/**
+ * Computes the CRC32C checksum of a Uint8Array.
+ */
+export function crc32c(data: Uint8Array): number {
+	let crc = 0xffffffff;
+	for (let i = 0; i < data.length; i++) {
+		crc = (crc >>> 8) ^ crc32cTable[(crc ^ data[i]) & 0xff];
+	}
+	return (crc ^ 0xffffffff) >>> 0;
+}

package/src/objects.ts

@@ -26,7 +26,7 @@ export function assignWithDefaults<To extends Record<keyof any, any>, From exten
 	for (const key of keys) {
 		try {
 			to[key] = from[key] ?? defaults[key] ?? to[key];
-		} catch (e) {
+		} catch {
 			// Do nothing
 		}
 	}
@@ -46,7 +46,7 @@ export function isJSON(str: string) {
 	try {
 		JSON.parse(str);
 		return true;
-	} catch (e) {
+	} catch {
 		return false;
 	}
 }
@@ -89,3 +89,12 @@ export function setByString(object: Record<string, any>, path: string, value: un
 		.filter(p => p)
 		.reduce((o, p, i) => (o[p] = path.split(separator).filter(p => p).length === ++i ? value : o[p] || {}), object);
 }
+
+/** Binds a class member to the instance */
+// eslint-disable-next-line @typescript-eslint/unbound-method
+export function bound(value: unknown, { name, addInitializer }: ClassMethodDecoratorContext) {
+	addInitializer(function (this: any) {
+		// eslint-disable-next-line @typescript-eslint/no-unsafe-call
+		this[name] = this[name].bind(this);
+	});
+}

package/src/struct.ts

@@ -23,6 +23,20 @@ export function sizeof<T extends primitive.Valid | StaticLike | InstanceLike>(ty
 	return struct[symbol_metadata(struct)][Symbol.struct_metadata].size as Size<T>;
 }
 
+/**
+ * Returns the offset (in bytes) of a member in a struct.
+ */
+export function offsetof(type: StaticLike | InstanceLike, memberName: string): number {
+	checkStruct(type);
+
+	const struct = isStatic(type) ? type : type.constructor;
+	const metadata = struct[symbol_metadata(struct)][Symbol.struct_metadata];
+
+	const member = metadata.members.get(memberName);
+	if (!member) throw new Error('Struct does not have member: ' + memberName);
+	return member.offset;
+}
+
 /**
  * Aligns a number
  */