utilium 1.5.0 → 1.6.0

package/dist/buffer.d.ts

@@ -13,3 +13,4 @@ export interface ArrayBufferViewConstructor {
  * @returns The original buffer if resized successfully, or a newly created buffer
  */
 export declare function extendBuffer<T extends ArrayBufferLike | ArrayBufferView>(buffer: T, newByteLength: number): T;
+export declare function toUint8Array(buffer: ArrayBufferLike | ArrayBufferView): Uint8Array;

package/dist/buffer.js

@@ -30,3 +30,10 @@ export function extendBuffer(buffer, newByteLength) {
         return newBuffer;
     }
 }
+export function toUint8Array(buffer) {
+    if (buffer instanceof Uint8Array)
+        return buffer;
+    if (!ArrayBuffer.isView(buffer))
+        return new Uint8Array(buffer);
+    return new Uint8Array(buffer.buffer, buffer.byteOffset, buffer.byteLength);
+}

package/dist/internal/primitives.d.ts

@@ -6,16 +6,16 @@ type BitsToBytes = {
     '128': 16;
 };
 export type Size<T extends string> = T extends `${'int' | 'uint' | 'float'}${infer bits}` ? bits extends keyof BitsToBytes ? BitsToBytes[bits] : never : never;
-export declare const types: readonly ["int8", "uint8", "int16", "uint16", "int32", "uint32", "int64", "uint64", "int128", "uint128", "float32", "float64", "float128"];
-export type Type = (typeof types)[number];
-export type Valid = Type | Capitalize<Type> | 'char';
-export declare const valids: ("int8" | "uint8" | "int16" | "uint16" | "int32" | "uint32" | "int64" | "uint64" | "int128" | "uint128" | "float32" | "float64" | "float128" | "Int8" | "Uint8" | "Int16" | "Uint16" | "Int32" | "Uint32" | "Int64" | "Uint64" | "Int128" | "Uint128" | "Float32" | "Float64" | "Float128" | "char")[];
+export declare const typeNames: readonly ["int8", "uint8", "int16", "uint16", "int32", "uint32", "int64", "uint64", "int128", "uint128", "float32", "float64", "float128"];
+export type Typename = (typeof typeNames)[number];
+export type Valid = Typename | Capitalize<Typename> | 'char';
+export declare const validNames: ("int8" | "uint8" | "int16" | "uint16" | "int32" | "uint32" | "int64" | "uint64" | "int128" | "uint128" | "float32" | "float64" | "float128" | "Int8" | "Uint8" | "Int16" | "Uint16" | "Int32" | "Uint32" | "Int64" | "Uint64" | "Int128" | "Uint128" | "Float32" | "Float64" | "Float128" | "char")[];
 export declare const regex: RegExp;
 export type Normalize<T extends Valid> = T extends 'char' ? 'uint8' : Uncapitalize<T>;
 export declare function normalize<T extends Valid>(type: T): Normalize<T>;
 export declare function isType(type: {
     toString(): string;
-}): type is Type;
+}): type is Typename;
 export declare function isValid(type: {
     toString(): string;
 }): type is Valid;

package/dist/internal/primitives.js

@@ -1,5 +1,5 @@
 import { capitalize } from '../string.js';
-export const types = [
+export const typeNames = [
     'int8',
     'uint8',
     'int16',
@@ -14,7 +14,7 @@ export const types = [
     'float64',
     'float128',
 ];
-export const valids = [...types, ...types.map(t => capitalize(t)), 'char'];
+export const validNames = [...typeNames, ...typeNames.map(t => capitalize(t)), 'char'];
 export const regex = /^(u?int|float)(8|16|32|64|128)$/i;
 export function normalize(type) {
     return (type == 'char' ? 'uint8' : type.toLowerCase());

package/dist/internal/struct.d.ts

@@ -2,17 +2,25 @@ import type { ClassLike } from '../types.js';
 import type * as primitive from './primitives.js';
 declare global {
     interface SymbolConstructor {
-        readonly struct_init: unique symbol;
-        readonly struct_metadata: unique symbol;
+        /** User-defined size */
+        readonly size: unique symbol;
+        /** User-defined serialization */
+        readonly serialize: unique symbol;
+        /** User-defined deserialization */
+        readonly deserialize: unique symbol;
     }
 }
+export type TypeLike = UserDefined | Like | primitive.Valid;
+export type Type = UserDefined | Static | primitive.Typename;
+/**
+ * Member initialization data
+ * This is needed since class decorators are called *after* member decorators
+ */
 export interface MemberInit {
     name: string;
     type: string | ClassLike;
     length?: number;
 }
-/** @deprecated */
-export declare const init: typeof Symbol.struct_init;
 /**
  * Options for struct initialization
  */
@@ -22,7 +30,7 @@ export interface Options {
     isUnion: boolean;
 }
 export interface Member {
-    type: primitive.Type | Static;
+    type: Type;
     offset: number;
     length?: number;
 }
@@ -30,20 +38,18 @@ export interface Metadata {
     options: Partial<Options>;
     members: Map<string, Member>;
     size: number;
+    init?: MemberInit[];
 }
-/** @deprecated */
-export declare const metadata: typeof Symbol.struct_metadata;
-export interface _DecoratorMetadata<T extends Metadata = Metadata> extends DecoratorMetadata {
-    [Symbol.struct_metadata]?: T;
-    [Symbol.struct_init]?: MemberInit[];
-}
+type _DecoratorMetadata<T extends Metadata = Metadata> = DecoratorMetadata & {
+    struct?: Partial<T>;
+};
 export interface DecoratorContext<T extends Metadata = Metadata> {
     metadata: _DecoratorMetadata<T>;
 }
 export type MemberContext = ClassMemberDecoratorContext & DecoratorContext;
 export interface Static<T extends Metadata = Metadata> {
-    [Symbol.metadata]: DecoratorMetadata & {
-        [Symbol.struct_metadata]: T;
+    [Symbol.metadata]: {
+        struct: T;
     };
     new (): Instance<T>;
     prototype: Instance<T>;
@@ -52,7 +58,7 @@ export interface StaticLike<T extends Metadata = Metadata> extends ClassLike {
     [Symbol.metadata]?: _DecoratorMetadata<T> | null;
 }
 export declare function isValidMetadata<T extends Metadata = Metadata>(arg: unknown): arg is DecoratorMetadata & {
-    [Symbol.struct_metadata]: T;
+    struct: T;
 };
 /**
  * Polyfill context.metadata
@@ -74,5 +80,14 @@ export declare function isInstance<T extends Metadata = Metadata>(arg: unknown):
 export declare function checkInstance<T extends Metadata = Metadata>(arg: unknown): asserts arg is Instance<T> & Record<keyof any, any>;
 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 interface UserDefined {
+    readonly [Symbol.size]: number;
+    [Symbol.serialize](): Uint8Array;
+    [Symbol.deserialize](value: Uint8Array): void;
+}
+export declare function isUserDefined(arg: unknown): arg is UserDefined;
 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;
+export type Size<T extends TypeLike> = T extends {
+    readonly [Symbol.size]: infer S;
+} ? S : T extends primitive.Valid ? primitive.Size<T> : T extends Like<infer M> ? M['size'] : number;
+export {};

package/dist/internal/struct.js

@@ -1,13 +1,10 @@
-// @ts-expect-error 2322
-Symbol.struct_init ||= Symbol('struct_init');
-// @ts-expect-error 2322
-Symbol.struct_metadata ||= Symbol('struct_metadata');
-/** @deprecated */
-export const init = Symbol.struct_init;
-/** @deprecated */
-export const metadata = Symbol.struct_metadata;
+Object.assign(Symbol, {
+    size: Symbol('uSize'),
+    serialize: Symbol('uSerialize'),
+    deserialize: Symbol('uDeserialize'),
+});
 export function isValidMetadata(arg) {
-    return arg != null && typeof arg == 'object' && Symbol.struct_metadata in arg;
+    return arg != null && typeof arg == 'object' && 'struct' in arg;
 }
 /**
  * Polyfill Symbol.metadata
@@ -19,12 +16,8 @@ Symbol.metadata ??= Symbol.for('Symbol.metadata');
  * @see https://github.com/microsoft/TypeScript/issues/53461
  */
 export function _polyfill_contextMetadata(target) {
-    if (!Symbol?.metadata) {
+    if (!Symbol?.metadata || Symbol.metadata in target)
         return;
-    }
-    if (Symbol.metadata in target) {
-        return;
-    }
     Object.defineProperty(target, Symbol.metadata, {
         enumerable: true,
         configurable: true,
@@ -52,17 +45,24 @@ 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 : typeof arg == 'object' && arg ? arg.constructor.name : arg)
-            + ' is not a struct instance');
-    }
+    if (isInstance(arg))
+        return;
+    throw new TypeError((typeof arg == 'function' ? arg.name : typeof arg == '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 : typeof arg == 'object' && arg ? arg.constructor.name : arg)
-            + ' is not a struct');
-    }
+    if (isStruct(arg))
+        return;
+    throw new TypeError((typeof arg == 'function' ? arg.name : typeof arg == 'object' && arg ? arg.constructor.name : arg)
+        + ' is not a struct');
+}
+export function isUserDefined(arg) {
+    return (typeof arg == 'object'
+        && arg != null
+        && Symbol.size in arg
+        && Symbol.serialize in arg
+        && Symbol.deserialize in arg);
 }

package/dist/objects.d.ts

@@ -41,11 +41,10 @@ export type JSONValue = JSONPrimitive | JSONObject | JSONValue[];
 /**
  * An object `T` with all of its functions bound to a `This` value
  */
-type Bound<T extends object, This = any> = T & {
+export type Bound<T extends object, This = any> = T & {
     [k in keyof T]: T[k] extends (...args: any[]) => any ? (this: This, ...args: Parameters<T[k]>) => ReturnType<T[k]> : T[k];
 };
 /**
  * Binds a this value for all of the functions in an object (not recursive)
  */
 export declare function bindFunctions<T extends object, This = any>(fns: T, thisValue: This): Bound<T, This>;
-export {};

package/dist/struct.d.ts

@@ -1,12 +1,11 @@
 import * as primitive from './internal/primitives.js';
-import type { DecoratorContext, InstanceLike, Options, Size, StaticLike } from './internal/struct.js';
-import { type MemberContext } from './internal/struct.js';
+import type { DecoratorContext, InstanceLike, Options, Size, StaticLike, TypeLike, MemberContext } from './internal/struct.js';
 import type { ClassLike } from './types.js';
 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>;
+export declare function sizeof<T extends TypeLike>(type: T): Size<T>;
 /**
  * Returns the offset (in bytes) of a member in a struct.
  */

package/dist/struct.js

@@ -1,5 +1,6 @@
+import { toUint8Array } from './buffer.js';
 import * as primitive from './internal/primitives.js';
-import { checkInstance, checkStruct, isStatic, symbol_metadata } from './internal/struct.js';
+import { checkInstance, checkStruct, isStatic, isUserDefined, symbol_metadata } from './internal/struct.js';
 import { capitalize } from './string.js';
 export * as Struct from './internal/struct.js';
 /**
@@ -11,9 +12,12 @@ export function sizeof(type) {
         primitive.checkValid(type);
         return (+primitive.normalize(type).match(primitive.regex)[2] / 8);
     }
+    if (isUserDefined(type)) {
+        return type[Symbol.size];
+    }
     checkStruct(type);
     const struct = isStatic(type) ? type : type.constructor;
-    return struct[symbol_metadata(struct)][Symbol.struct_metadata].size;
+    return struct[symbol_metadata(struct)].struct.size;
 }
 /**
  * Returns the offset (in bytes) of a member in a struct.
@@ -21,7 +25,7 @@ export function sizeof(type) {
 export function offsetof(type, memberName) {
     checkStruct(type);
     const struct = isStatic(type) ? type : type.constructor;
-    const metadata = struct[symbol_metadata(struct)][Symbol.struct_metadata];
+    const metadata = struct[symbol_metadata(struct)].struct;
     const member = metadata.members.get(memberName);
     if (!member)
         throw new Error('Struct does not have member: ' + memberName);
@@ -39,11 +43,11 @@ export function align(value, alignment) {
 export function struct(options = {}) {
     return function _decorateStruct(target, context) {
         context.metadata ??= {};
-        context.metadata[Symbol.struct_init] ||= [];
+        context.metadata.struct ??= {};
+        context.metadata.struct.init ??= [];
         let size = 0;
         const members = new Map();
-        for (const _ of context.metadata[Symbol.struct_init]) {
-            const { name, type, length } = _;
+        for (const { name, type, length } of context.metadata.struct.init) {
             if (!primitive.isValid(type) && !isStatic(type)) {
                 throw new TypeError('Not a valid type: ' + type);
             }
@@ -56,7 +60,7 @@ export function struct(options = {}) {
             size = options.isUnion ? Math.max(size, memberSize) : size + memberSize;
             size = align(size, options.align || 1);
         }
-        context.metadata[Symbol.struct_metadata] = { options, members, size };
+        context.metadata.struct = { options, members, size };
         return target;
     };
 }
@@ -70,12 +74,12 @@ export function member(type, length) {
             console.warn('Symbol used for struct member name will be coerced to string: ' + name.toString());
             name = name.toString();
         }
-        if (!name) {
+        if (!name)
             throw new ReferenceError('Invalid name for struct member');
-        }
         context.metadata ??= {};
-        context.metadata[Symbol.struct_init] ||= [];
-        context.metadata[Symbol.struct_init].push({ name, type, length });
+        context.metadata.struct ??= {};
+        context.metadata.struct.init ??= [];
+        context.metadata.struct.init.push({ name, type, length });
         return value;
     };
 }
@@ -83,8 +87,10 @@ export function member(type, length) {
  * Serializes a struct into a Uint8Array
  */
 export function serialize(instance) {
+    if (isUserDefined(instance))
+        return instance[Symbol.serialize]();
     checkInstance(instance);
-    const { options, members } = instance.constructor[symbol_metadata(instance.constructor)][Symbol.struct_metadata];
+    const { options, members } = instance.constructor[symbol_metadata(instance.constructor)].struct;
     const buffer = new Uint8Array(sizeof(instance));
     const view = new DataView(buffer.buffer);
     // for unions we should write members in ascending last modified order, but we don't have that info.
@@ -132,9 +138,11 @@ export function serialize(instance) {
  * Deserializes a struct from a Uint8Array
  */
 export function deserialize(instance, _buffer) {
+    const buffer = toUint8Array(_buffer);
+    if (isUserDefined(instance))
+        return instance[Symbol.deserialize](buffer);
     checkInstance(instance);
-    const { options, members } = instance.constructor[symbol_metadata(instance.constructor)][Symbol.struct_metadata];
-    const buffer = _buffer instanceof Uint8Array ? _buffer : new Uint8Array('buffer' in _buffer ? _buffer.buffer : _buffer);
+    const { options, members } = instance.constructor[symbol_metadata(instance.constructor)].struct;
     const view = new DataView(buffer.buffer, buffer.byteOffset, buffer.byteLength);
     for (const [name, { type, offset, length }] of members) {
         for (let i = 0; i < (length || 1); i++) {
@@ -149,7 +157,7 @@ export function deserialize(instance, _buffer) {
                 if (object[key] === null || object[key] === undefined) {
                     continue;
                 }
-                deserialize(object[key], new Uint8Array(buffer.slice(iOff, iOff + sizeof(type))));
+                deserialize(object[key], new Uint8Array(buffer.subarray(iOff, iOff + sizeof(type))));
                 continue;
             }
             if (length > 0) {
@@ -198,4 +206,4 @@ function _member(type) {
  *
  * Instead of writing `@member(type)` you can write `@types.type`, or `@types.type(length)` for arrays
  */
-export const types = Object.fromEntries(primitive.valids.map(t => [t, _member(t)]));
+export const types = Object.fromEntries(primitive.validNames.map(t => [t, _member(t)]));

package/package.json

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

package/src/buffer.ts

@@ -49,3 +49,9 @@ export function extendBuffer<T extends ArrayBufferLike | ArrayBufferView>(buffer
 		return newBuffer;
 	}
 }
+
+export function toUint8Array(buffer: ArrayBufferLike | ArrayBufferView): Uint8Array {
+	if (buffer instanceof Uint8Array) return buffer;
+	if (!ArrayBuffer.isView(buffer)) return new Uint8Array(buffer);
+	return new Uint8Array(buffer.buffer, buffer.byteOffset, buffer.byteLength);
+}

package/src/internal/primitives.ts

@@ -14,7 +14,7 @@ export type Size<T extends string> = T extends `${'int' | 'uint' | 'float'}${inf
 		: never
 	: never;
 
-export const types = [
+export const typeNames = [
 	'int8',
 	'uint8',
 	'int16',
@@ -30,11 +30,11 @@ export const types = [
 	'float128',
 ] as const;
 
-export type Type = (typeof types)[number];
+export type Typename = (typeof typeNames)[number];
 
-export type Valid = Type | Capitalize<Type> | 'char';
+export type Valid = Typename | Capitalize<Typename> | 'char';
 
-export const valids = [...types, ...types.map(t => capitalize(t)), 'char'] satisfies Valid[];
+export const validNames = [...typeNames, ...typeNames.map(t => capitalize(t)), 'char'] satisfies Valid[];
 
 export const regex = /^(u?int|float)(8|16|32|64|128)$/i;
 
@@ -44,7 +44,7 @@ export function normalize<T extends Valid>(type: T): Normalize<T> {
 	return (type == 'char' ? 'uint8' : type.toLowerCase()) as Normalize<T>;
 }
 
-export function isType(type: { toString(): string }): type is Type {
+export function isType(type: { toString(): string }): type is Typename {
 	return regex.test(type.toString());
 }
 

package/src/internal/struct.ts

@@ -3,26 +3,37 @@ import type * as primitive from './primitives.js';
 
 declare global {
 	interface SymbolConstructor {
-		readonly struct_init: unique symbol;
-		readonly struct_metadata: unique symbol;
+		/** User-defined size */
+		readonly size: unique symbol;
+
+		/** User-defined serialization */
+		readonly serialize: unique symbol;
+
+		/** User-defined deserialization */
+		readonly deserialize: unique symbol;
 	}
 }
 
-// @ts-expect-error 2322
-Symbol.struct_init ||= Symbol('struct_init');
+Object.assign(Symbol, {
+	size: Symbol('uSize'),
+	serialize: Symbol('uSerialize'),
+	deserialize: Symbol('uDeserialize'),
+});
+
+export type TypeLike = UserDefined | Like | primitive.Valid;
 
-// @ts-expect-error 2322
-Symbol.struct_metadata ||= Symbol('struct_metadata');
+export type Type = UserDefined | Static | primitive.Typename;
 
+/**
+ * Member initialization data
+ * This is needed since class decorators are called *after* member decorators
+ */
 export interface MemberInit {
 	name: string;
 	type: string | ClassLike;
 	length?: number;
 }
 
-/** @deprecated */
-export const init: typeof Symbol.struct_init = Symbol.struct_init;
-
 /**
  * Options for struct initialization
  */
@@ -33,7 +44,7 @@ export interface Options {
 }
 
 export interface Member {
-	type: primitive.Type | Static;
+	type: Type;
 	offset: number;
 	length?: number;
 }
@@ -42,15 +53,12 @@ export interface Metadata {
 	options: Partial<Options>;
 	members: Map<string, Member>;
 	size: number;
+	init?: MemberInit[];
 }
 
-/** @deprecated */
-export const metadata: typeof Symbol.struct_metadata = Symbol.struct_metadata;
-
-export interface _DecoratorMetadata<T extends Metadata = Metadata> extends DecoratorMetadata {
-	[Symbol.struct_metadata]?: T;
-	[Symbol.struct_init]?: MemberInit[];
-}
+type _DecoratorMetadata<T extends Metadata = Metadata> = DecoratorMetadata & {
+	struct?: Partial<T>;
+};
 
 export interface DecoratorContext<T extends Metadata = Metadata> {
 	metadata: _DecoratorMetadata<T>;
@@ -59,9 +67,7 @@ export interface DecoratorContext<T extends Metadata = Metadata> {
 export type MemberContext = ClassMemberDecoratorContext & DecoratorContext;
 
 export interface Static<T extends Metadata = Metadata> {
-	[Symbol.metadata]: DecoratorMetadata & {
-		[Symbol.struct_metadata]: T;
-	};
+	[Symbol.metadata]: { struct: T };
 	new (): Instance<T>;
 	prototype: Instance<T>;
 }
@@ -73,9 +79,9 @@ export interface StaticLike<T extends Metadata = Metadata> extends ClassLike {
 export function isValidMetadata<T extends Metadata = Metadata>(
 	arg: unknown
 ): arg is DecoratorMetadata & {
-	[Symbol.struct_metadata]: T;
+	struct: T;
 } {
-	return arg != null && typeof arg == 'object' && Symbol.struct_metadata in arg;
+	return arg != null && typeof arg == 'object' && 'struct' in arg;
 }
 
 /**
@@ -89,12 +95,8 @@ export function isValidMetadata<T extends Metadata = Metadata>(
  * @see https://github.com/microsoft/TypeScript/issues/53461
  */
 export function _polyfill_contextMetadata(target: object): void {
-	if (!Symbol?.metadata) {
-		return;
-	}
-	if (Symbol.metadata in target) {
-		return;
-	}
+	if (!Symbol?.metadata || Symbol.metadata in target) return;
+
 	Object.defineProperty(target, Symbol.metadata, {
 		enumerable: true,
 		configurable: true,
@@ -140,12 +142,11 @@ export function isInstance<T extends Metadata = Metadata>(arg: unknown): arg is
 export function checkInstance<T extends Metadata = Metadata>(
 	arg: unknown
 ): asserts arg is Instance<T> & Record<keyof any, any> {
-	if (!isInstance(arg)) {
-		throw new TypeError(
-			(typeof arg == 'function' ? arg.name : typeof arg == 'object' && arg ? arg.constructor.name : arg)
-				+ ' is not a struct instance'
-		);
-	}
+	if (isInstance(arg)) return;
+	throw new TypeError(
+		(typeof arg == 'function' ? arg.name : typeof arg == '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> {
@@ -153,18 +154,35 @@ export function isStruct<T extends Metadata = Metadata>(arg: unknown): arg is In
 }
 
 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 : typeof arg == 'object' && arg ? arg.constructor.name : arg)
-				+ ' is not a struct'
-		);
-	}
+	if (isStruct(arg)) return;
+	throw new TypeError(
+		(typeof arg == 'function' ? arg.name : typeof arg == 'object' && arg ? arg.constructor.name : arg)
+			+ ' is not a struct'
+	);
+}
+
+export interface UserDefined {
+	readonly [Symbol.size]: number;
+	[Symbol.serialize](): Uint8Array;
+	[Symbol.deserialize](value: Uint8Array): void;
+}
+
+export function isUserDefined(arg: unknown): arg is UserDefined {
+	return (
+		typeof arg == 'object'
+		&& arg != null
+		&& Symbol.size in arg
+		&& Symbol.serialize in arg
+		&& Symbol.deserialize in arg
+	);
 }
 
 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;
+export type Size<T extends TypeLike> = T extends { readonly [Symbol.size]: infer S }
+	? S
+	: T extends primitive.Valid
+		? primitive.Size<T>
+		: T extends Like<infer M>
+			? M['size']
+			: number;

package/src/objects.ts

@@ -122,7 +122,7 @@ export type JSONValue = JSONPrimitive | JSONObject | JSONValue[];
 /**
  * An object `T` with all of its functions bound to a `This` value
  */
-type Bound<T extends object, This = any> = T & {
+export type Bound<T extends object, This = any> = T & {
 	[k in keyof T]: T[k] extends (...args: any[]) => any
 		? (this: This, ...args: Parameters<T[k]>) => ReturnType<T[k]>
 		: T[k];

package/src/struct.ts

@@ -1,3 +1,4 @@
+import { toUint8Array } from './buffer.js';
 import * as primitive from './internal/primitives.js';
 import type {
 	DecoratorContext,
@@ -8,8 +9,10 @@ import type {
 	Options,
 	Size,
 	StaticLike,
+	TypeLike,
+	MemberContext,
 } from './internal/struct.js';
-import { checkInstance, checkStruct, isStatic, symbol_metadata, type MemberContext } from './internal/struct.js';
+import { checkInstance, checkStruct, isStatic, isUserDefined, symbol_metadata } from './internal/struct.js';
 import { capitalize } from './string.js';
 import type { ClassLike } from './types.js';
 export * as Struct from './internal/struct.js';
@@ -17,7 +20,7 @@ export * as Struct from './internal/struct.js';
 /**
  * Gets the size in bytes of a type
  */
-export function sizeof<T extends primitive.Valid | StaticLike | InstanceLike>(type: T): Size<T> {
+export function sizeof<T extends TypeLike>(type: T): Size<T> {
 	// primitive
 	if (typeof type == 'string') {
 		primitive.checkValid(type);
@@ -25,11 +28,15 @@ export function sizeof<T extends primitive.Valid | StaticLike | InstanceLike>(ty
 		return (+primitive.normalize(type).match(primitive.regex)![2] / 8) as Size<T>;
 	}
 
+	if (isUserDefined(type)) {
+		return type[Symbol.size] as Size<T>;
+	}
+
 	checkStruct(type);
 
 	const struct = isStatic(type) ? type : type.constructor;
 
-	return struct[symbol_metadata(struct)][Symbol.struct_metadata].size as Size<T>;
+	return struct[symbol_metadata(struct)].struct.size as Size<T>;
 }
 
 /**
@@ -39,7 +46,7 @@ export function offsetof(type: StaticLike | InstanceLike, memberName: string): n
 	checkStruct(type);
 
 	const struct = isStatic(type) ? type : type.constructor;
-	const metadata = struct[symbol_metadata(struct)][Symbol.struct_metadata];
+	const metadata = struct[symbol_metadata(struct)].struct;
 
 	const member = metadata.members.get(memberName);
 	if (!member) throw new Error('Struct does not have member: ' + memberName);
@@ -62,11 +69,12 @@ export function struct(options: Partial<Options> = {}) {
 		context: ClassDecoratorContext & DecoratorContext
 	): T {
 		context.metadata ??= {};
-		context.metadata[Symbol.struct_init] ||= [];
+		context.metadata.struct ??= {};
+		context.metadata.struct.init ??= [];
+
 		let size = 0;
 		const members = new Map<string, Member>();
-		for (const _ of context.metadata[Symbol.struct_init]!) {
-			const { name, type, length } = _;
+		for (const { name, type, length } of context.metadata.struct.init) {
 			if (!primitive.isValid(type) && !isStatic(type)) {
 				throw new TypeError('Not a valid type: ' + type);
 			}
@@ -80,7 +88,7 @@ export function struct(options: Partial<Options> = {}) {
 			size = align(size, options.align || 1);
 		}
 
-		context.metadata[Symbol.struct_metadata] = { options, members, size } satisfies Metadata;
+		context.metadata.struct = { options, members, size } satisfies Metadata;
 		return target;
 	};
 }
@@ -96,13 +104,12 @@ export function member(type: primitive.Valid | ClassLike, length?: number) {
 			name = name.toString();
 		}
 
-		if (!name) {
-			throw new ReferenceError('Invalid name for struct member');
-		}
+		if (!name) throw new ReferenceError('Invalid name for struct member');
 
 		context.metadata ??= {};
-		context.metadata[Symbol.struct_init] ||= [];
-		context.metadata[Symbol.struct_init]!.push({ name, type, length } satisfies MemberInit);
+		context.metadata.struct ??= {};
+		context.metadata.struct.init ??= [];
+		context.metadata.struct.init.push({ name, type, length } satisfies MemberInit);
 		return value;
 	};
 }
@@ -111,8 +118,10 @@ export function member(type: primitive.Valid | ClassLike, length?: number) {
  * Serializes a struct into a Uint8Array
  */
 export function serialize(instance: unknown): Uint8Array {
+	if (isUserDefined(instance)) return instance[Symbol.serialize]();
+
 	checkInstance(instance);
-	const { options, members } = instance.constructor[symbol_metadata(instance.constructor)][Symbol.struct_metadata];
+	const { options, members } = instance.constructor[symbol_metadata(instance.constructor)].struct;
 
 	const buffer = new Uint8Array(sizeof(instance));
 	const view = new DataView(buffer.buffer);
@@ -173,11 +182,12 @@ export function serialize(instance: unknown): Uint8Array {
  * Deserializes a struct from a Uint8Array
  */
 export function deserialize(instance: unknown, _buffer: ArrayBufferLike | ArrayBufferView) {
-	checkInstance(instance);
-	const { options, members } = instance.constructor[symbol_metadata(instance.constructor)][Symbol.struct_metadata];
+	const buffer = toUint8Array(_buffer);
 
-	const buffer =
-		_buffer instanceof Uint8Array ? _buffer : new Uint8Array('buffer' in _buffer ? _buffer.buffer : _buffer);
+	if (isUserDefined(instance)) return instance[Symbol.deserialize](buffer);
+
+	checkInstance(instance);
+	const { options, members } = instance.constructor[symbol_metadata(instance.constructor)].struct;
 
 	const view = new DataView(buffer.buffer, buffer.byteOffset, buffer.byteLength);
 
@@ -197,7 +207,7 @@ export function deserialize(instance: unknown, _buffer: ArrayBufferLike | ArrayB
 				if (object[key] === null || object[key] === undefined) {
 					continue;
 				}
-				deserialize(object[key], new Uint8Array(buffer.slice(iOff, iOff + sizeof(type))));
+				deserialize(object[key], new Uint8Array(buffer.subarray(iOff, iOff + sizeof(type))));
 				continue;
 			}
 
@@ -261,6 +271,6 @@ function _member<T extends primitive.Valid>(type: T) {
  *
  * Instead of writing `@member(type)` you can write `@types.type`, or `@types.type(length)` for arrays
  */
-export const types = Object.fromEntries(primitive.valids.map(t => [t, _member(t)])) as {
+export const types = Object.fromEntries(primitive.validNames.map(t => [t, _member(t)])) as {
 	[K in primitive.Valid]: ReturnType<typeof _member<K>>;
 };