utilium 0.6.3 → 0.7.1

package/dist/internal/primitives.d.ts

@@ -18,4 +18,7 @@ export declare function isType(type: {
 export declare function isValid(type: {
     toString(): string;
 }): type is Valid;
+export declare function checkValid(type: {
+    toString(): string;
+}): asserts type is Valid;
 export {};

package/dist/internal/primitives.js

@@ -11,3 +11,8 @@ export function isType(type) {
 export function isValid(type) {
     return type == 'char' || regex.test(type.toString().toLowerCase());
 }
+export function checkValid(type) {
+    if (!isValid(type)) {
+        throw new TypeError('Not a valid primitive type: ' + type);
+    }
+}

package/dist/internal/struct.d.ts

@@ -57,6 +57,8 @@ export interface InstanceLike<T extends Metadata = Metadata> {
     constructor: StaticLike<T>;
 }
 export declare function isInstance<T extends Metadata = Metadata>(arg: unknown): arg is Instance<T>;
+export declare function checkInstance<T extends Metadata = Metadata>(arg: unknown): asserts arg is Instance<T>;
 export declare function isStruct<T extends Metadata = Metadata>(arg: unknown): arg is Instance<T> | Static<T>;
+export declare function checkStruct<T extends Metadata = Metadata>(arg: unknown): asserts arg is Instance<T> | Static<T>;
 export type Like<T extends Metadata = Metadata> = InstanceLike<T> | StaticLike<T>;
 export type Size<T extends primitive.Valid | StaticLike | InstanceLike> = T extends primitive.Valid ? primitive.Size<T> : T extends Like<infer M> ? M['size'] : number;

package/dist/internal/struct.js

@@ -19,6 +19,16 @@ export function isStatic(arg) {
 export function isInstance(arg) {
     return arg != null && typeof arg == 'object' && isStatic(arg.constructor);
 }
+export function checkInstance(arg) {
+    if (!isInstance(arg)) {
+        throw new TypeError((typeof arg == 'function' ? arg.name : 'object' && arg ? arg.constructor.name : arg) + ' is not a struct instance');
+    }
+}
 export function isStruct(arg) {
     return isInstance(arg) || isStatic(arg);
 }
+export function checkStruct(arg) {
+    if (!isStruct(arg)) {
+        throw new TypeError((typeof arg == 'function' ? arg.name : 'object' && arg ? arg.constructor.name : arg) + ' is not a struct');
+    }
+}

package/dist/list.d.ts

@@ -1,10 +1,11 @@
 import { EventEmitter } from 'eventemitter3';
-export declare class List<T> extends EventEmitter<'update'> implements Set<T>, RelativeIndexable<T> {
+export declare class List<T> extends EventEmitter<'update'> implements RelativeIndexable<T> {
     readonly [Symbol.toStringTag] = "List";
     constructor(values?: readonly T[] | Iterable<T> | null);
     protected data: Set<T>;
-    array(): T[];
-    json(): string;
+    toSet(): Set<T>;
+    toArray(): T[];
+    toJSON(): string;
     toString(): string;
     set(index: number, value: T): void;
     deleteAt(index: number): void;
@@ -16,14 +17,6 @@ export declare class List<T> extends EventEmitter<'update'> implements Set<T>, R
     add(value: T): this;
     clear(): void;
     delete(value: T): boolean;
-    union<U>(other: ReadonlySetLike<U>): List<T | U>;
-    intersection<U>(other: ReadonlySetLike<U>): List<T & U>;
-    difference<U>(other: ReadonlySetLike<U>): List<T>;
-    symmetricDifference<U>(other: ReadonlySetLike<U>): List<T | U>;
-    isSubsetOf(other: ReadonlySetLike<unknown>): boolean;
-    isSupersetOf(other: ReadonlySetLike<unknown>): boolean;
-    isDisjointFrom(other: ReadonlySetLike<unknown>): boolean;
-    forEach(callbackfn: (value: T, value2: T, list: List<T>) => void, thisArg?: any): void;
     has(value: T): boolean;
     get size(): number;
     entries(): IterableIterator<[T, T]>;

package/dist/list.js

@@ -8,10 +8,13 @@ export class List extends EventEmitter {
         }
     }
     data = new Set();
-    array() {
+    toSet() {
+        return new Set(this.data);
+    }
+    toArray() {
         return [...this.data];
     }
-    json() {
+    toJSON() {
         return JSON.stringify([...this.data]);
     }
     toString() {
@@ -80,31 +83,6 @@ export class List extends EventEmitter {
         this.emit('update');
         return success;
     }
-    union(other) {
-        return new List(this.data.union(other));
-    }
-    intersection(other) {
-        return new List(this.data.intersection(other));
-    }
-    difference(other) {
-        return new List(this.data.difference(other));
-    }
-    symmetricDifference(other) {
-        return new List(this.data.symmetricDifference(other));
-    }
-    isSubsetOf(other) {
-        return this.data.isSubsetOf(other);
-    }
-    isSupersetOf(other) {
-        return this.data.isSupersetOf(other);
-    }
-    isDisjointFrom(other) {
-        return this.data.isDisjointFrom(other);
-    }
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    forEach(callbackfn, thisArg) {
-        this.data.forEach((v1, v2) => callbackfn.call(thisArg, v1, v2, this));
-    }
     has(value) {
         return this.data.has(value);
     }

package/dist/struct.js

@@ -1,5 +1,5 @@
 import * as primitive from './internal/primitives.js';
-import { symbol_metadata, init, isInstance, isStatic, isStruct, metadata, } from './internal/struct.js';
+import { checkInstance, checkStruct, init, isStatic, metadata, symbol_metadata, } from './internal/struct.js';
 import { capitalize } from './string.js';
 export * as Struct from './internal/struct.js';
 /**
@@ -8,14 +8,10 @@ export * as Struct from './internal/struct.js';
 export function sizeof(type) {
     // primitive
     if (typeof type == 'string') {
-        if (!primitive.isValid(type)) {
-            throw new TypeError('Invalid primitive type: ' + type);
-        }
+        primitive.checkValid(type);
         return (+primitive.normalize(type).match(primitive.regex)[2] / 8);
     }
-    if (!isStruct(type)) {
-        throw new TypeError('Not a struct');
-    }
+    checkStruct(type);
     const struct = isStatic(type) ? type : type.constructor;
     return struct[symbol_metadata(struct)][metadata].size;
 }
@@ -30,7 +26,7 @@ export function align(value, alignment) {
  */
 export function struct(options = {}) {
     // eslint-disable-next-line @typescript-eslint/no-unused-vars
-    return function __decorateStruct(target, context) {
+    return function _decorateStruct(target, context) {
         context.metadata ??= {};
         context.metadata[init] ||= [];
         let size = 0;
@@ -75,9 +71,7 @@ export function member(type, length) {
  * Serializes a struct into a Uint8Array
  */
 export function serialize(instance) {
-    if (!isInstance(instance)) {
-        throw new TypeError('Can not serialize, not a struct instance');
-    }
+    checkInstance(instance);
     const { options, members } = instance.constructor[symbol_metadata(instance.constructor)][metadata];
     const buffer = new Uint8Array(sizeof(instance));
     const view = new DataView(buffer.buffer);
@@ -112,12 +106,10 @@ export function serialize(instance) {
  * Deserializes a struct from a Uint8Array
  */
 export function deserialize(instance, _buffer) {
-    if (!isInstance(instance)) {
-        throw new TypeError('Can not deserialize, not a struct instance');
-    }
+    checkInstance(instance);
     const { options, members } = instance.constructor[symbol_metadata(instance.constructor)][metadata];
-    const buffer = new Uint8Array('buffer' in _buffer ? _buffer.buffer : _buffer);
-    const view = new DataView(buffer.buffer);
+    const buffer = _buffer instanceof Uint8Array ? _buffer : new Uint8Array('buffer' in _buffer ? _buffer.buffer : _buffer);
+    const view = new DataView(buffer.buffer.slice(buffer.byteOffset, buffer.byteOffset + buffer.byteLength));
     for (const [name, { type, offset, length }] of members) {
         for (let i = 0; i < (length || 1); i++) {
             // @ts-expect-error 7053

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "utilium",
-	"version": "0.6.3",
+	"version": "0.7.1",
 	"description": "Typescript utilies",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",

package/src/internal/primitives.ts

@@ -30,3 +30,9 @@ export function isType(type: { toString(): string }): type is Type {
 export function isValid(type: { toString(): string }): type is Valid {
 	return type == 'char' || regex.test(type.toString().toLowerCase());
 }
+
+export function checkValid(type: { toString(): string }): asserts type is Valid {
+	if (!isValid(type)) {
+		throw new TypeError('Not a valid primitive type: ' + type);
+	}
+}

package/src/internal/struct.ts

@@ -90,10 +90,22 @@ export function isInstance<T extends Metadata = Metadata>(arg: unknown): arg is
 	return arg != null && typeof arg == 'object' && isStatic(arg.constructor);
 }
 
+export function checkInstance<T extends Metadata = Metadata>(arg: unknown): asserts arg is Instance<T> {
+	if (!isInstance(arg)) {
+		throw new TypeError((typeof arg == 'function' ? arg.name : 'object' && arg ? arg.constructor.name : arg) + ' is not a struct instance');
+	}
+}
+
 export function isStruct<T extends Metadata = Metadata>(arg: unknown): arg is Instance<T> | Static<T> {
 	return isInstance(arg) || isStatic(arg);
 }
 
+export function checkStruct<T extends Metadata = Metadata>(arg: unknown): asserts arg is Instance<T> | Static<T> {
+	if (!isStruct(arg)) {
+		throw new TypeError((typeof arg == 'function' ? arg.name : 'object' && arg ? arg.constructor.name : arg) + ' is not a struct');
+	}
+}
+
 export type Like<T extends Metadata = Metadata> = InstanceLike<T> | StaticLike<T>;
 
 export type Size<T extends primitive.Valid | StaticLike | InstanceLike> = T extends primitive.Valid ? primitive.Size<T> : T extends Like<infer M> ? M['size'] : number;

package/src/list.ts

@@ -1,6 +1,6 @@
 import { EventEmitter } from 'eventemitter3';
 
-export class List<T> extends EventEmitter<'update'> implements Set<T>, RelativeIndexable<T> {
+export class List<T> extends EventEmitter<'update'> implements RelativeIndexable<T> {
 	public readonly [Symbol.toStringTag] = 'List';
 
 	public constructor(values?: readonly T[] | Iterable<T> | null) {
@@ -12,11 +12,15 @@ export class List<T> extends EventEmitter<'update'> implements Set<T>, RelativeI
 
 	protected data = new Set<T>();
 
-	public array(): T[] {
+	public toSet(): Set<T> {
+		return new Set(this.data);
+	}
+
+	public toArray(): T[] {
 		return [...this.data];
 	}
 
-	public json() {
+	public toJSON() {
 		return JSON.stringify([...this.data]);
 	}
 
@@ -103,39 +107,6 @@ export class List<T> extends EventEmitter<'update'> implements Set<T>, RelativeI
 		return success;
 	}
 
-	public union<U>(other: ReadonlySetLike<U>): List<T | U> {
-		return new List(this.data.union(other));
-	}
-
-	public intersection<U>(other: ReadonlySetLike<U>): List<T & U> {
-		return new List(this.data.intersection(other));
-	}
-
-	public difference<U>(other: ReadonlySetLike<U>): List<T> {
-		return new List(this.data.difference(other));
-	}
-
-	public symmetricDifference<U>(other: ReadonlySetLike<U>): List<T | U> {
-		return new List(this.data.symmetricDifference(other));
-	}
-
-	public isSubsetOf(other: ReadonlySetLike<unknown>): boolean {
-		return this.data.isSubsetOf(other);
-	}
-
-	public isSupersetOf(other: ReadonlySetLike<unknown>): boolean {
-		return this.data.isSupersetOf(other);
-	}
-
-	public isDisjointFrom(other: ReadonlySetLike<unknown>): boolean {
-		return this.data.isDisjointFrom(other);
-	}
-
-	// eslint-disable-next-line @typescript-eslint/no-explicit-any
-	public forEach(callbackfn: (value: T, value2: T, list: List<T>) => void, thisArg?: any): void {
-		this.data.forEach((v1, v2) => callbackfn.call(thisArg, v1, v2, this));
-	}
-
 	public has(value: T): boolean {
 		return this.data.has(value);
 	}

package/src/struct.ts

@@ -1,18 +1,18 @@
 import * as primitive from './internal/primitives.js';
 import {
+	checkInstance,
+	checkStruct,
 	DecoratorContext,
+	init,
 	InstanceLike,
+	isStatic,
 	MemberInit,
 	Metadata,
+	metadata,
 	Options,
 	Size,
 	StaticLike,
 	symbol_metadata,
-	init,
-	isInstance,
-	isStatic,
-	isStruct,
-	metadata,
 	type MemberContext,
 } from './internal/struct.js';
 import { capitalize } from './string.js';
@@ -25,16 +25,12 @@ export * as Struct from './internal/struct.js';
 export function sizeof<T extends primitive.Valid | StaticLike | InstanceLike>(type: T): Size<T> {
 	// primitive
 	if (typeof type == 'string') {
-		if (!primitive.isValid(type)) {
-			throw new TypeError('Invalid primitive type: ' + type);
-		}
+		primitive.checkValid(type);
 
 		return (+primitive.normalize(type).match(primitive.regex)![2] / 8) as Size<T>;
 	}
 
-	if (!isStruct(type)) {
-		throw new TypeError('Not a struct');
-	}
+	checkStruct(type);
 
 	const struct = isStatic(type) ? type : type.constructor;
 
@@ -53,7 +49,7 @@ export function align(value: number, alignment: number): number {
  */
 export function struct(options: Partial<Options> = {}) {
 	// eslint-disable-next-line @typescript-eslint/no-unused-vars
-	return function __decorateStruct<const T extends StaticLike>(target: T, context: ClassDecoratorContext & DecoratorContext): T {
+	return function _decorateStruct<const T extends StaticLike>(target: T, context: ClassDecoratorContext & DecoratorContext): T {
 		context.metadata ??= {};
 		context.metadata[init] ||= [];
 		let size = 0;
@@ -103,9 +99,7 @@ export function member(type: primitive.Valid | ClassLike, length?: number) {
  * Serializes a struct into a Uint8Array
  */
 export function serialize(instance: unknown): Uint8Array {
-	if (!isInstance(instance)) {
-		throw new TypeError('Can not serialize, not a struct instance');
-	}
+	checkInstance(instance);
 	const { options, members } = instance.constructor[symbol_metadata(instance.constructor)][metadata];
 
 	const buffer = new Uint8Array(sizeof(instance));
@@ -149,14 +143,12 @@ export function serialize(instance: unknown): Uint8Array {
  * Deserializes a struct from a Uint8Array
  */
 export function deserialize(instance: unknown, _buffer: ArrayBuffer | ArrayBufferView) {
-	if (!isInstance(instance)) {
-		throw new TypeError('Can not deserialize, not a struct instance');
-	}
+	checkInstance(instance);
 	const { options, members } = instance.constructor[symbol_metadata(instance.constructor)][metadata];
 
-	const buffer = new Uint8Array('buffer' in _buffer ? _buffer.buffer : _buffer);
+	const buffer = _buffer instanceof Uint8Array ? _buffer : new Uint8Array('buffer' in _buffer ? _buffer.buffer : _buffer);
 
-	const view = new DataView(buffer.buffer);
+	const view = new DataView(buffer.buffer.slice(buffer.byteOffset, buffer.byteOffset + buffer.byteLength));
 
 	for (const [name, { type, offset, length }] of members) {
 		for (let i = 0; i < (length || 1); i++) {