utilium 1.7.17 → 1.9.0

package/dist/internal/struct.d.ts

@@ -2,11 +2,8 @@ import type { ClassLike } from '../types.js';
 import type * as primitive from './primitives.js';
 declare global {
     interface SymbolConstructor {
-        /** User-defined size */
         readonly size: unique symbol;
-        /** User-defined serialization */
         readonly serialize: unique symbol;
-        /** User-defined deserialization */
         readonly deserialize: unique symbol;
     }
 }
@@ -68,6 +65,7 @@ export interface Static<T extends Metadata = Metadata> {
 }
 export interface StaticLike<T extends Metadata = Metadata> extends ClassLike {
     [Symbol.metadata]?: _DecoratorMetadata<T> | null;
+    new (): unknown;
 }
 export declare function isValidMetadata<T extends Metadata = Metadata>(arg: unknown): arg is DecoratorMetadata & {
     struct: T;

package/dist/string.d.ts

@@ -15,3 +15,5 @@ export declare function encodeUTF8(input: string): Uint8Array;
  * Decodes a UTF-8 string from a buffer
  */
 export declare function decodeUTF8(input?: Uint8Array): string;
+export declare function encodeASCII(input: string): Uint8Array;
+export declare function decodeASCII(input: Uint8Array): string;

package/dist/string.js

@@ -18,3 +18,17 @@ const decoder = new TextDecoder();
 export function decodeUTF8(input) {
     return decoder.decode(input);
 }
+export function encodeASCII(input) {
+    const data = new Uint8Array(input.length);
+    for (let i = 0; i < input.length; i++) {
+        data[i] = input.charCodeAt(i);
+    }
+    return data;
+}
+export function decodeASCII(input) {
+    let output = '';
+    for (let i = 0; i < input.length; i++) {
+        output += String.fromCharCode(input[i]);
+    }
+    return output;
+}

package/dist/struct.js

@@ -229,8 +229,10 @@ export function deserialize(instance, _buffer) {
         for (let i = 0; i < Math.abs(length); i++) {
             let object = length != -1 ? instance[member.name] : instance;
             const key = length != -1 ? i : member.name;
+            const isNullish = object[key] === null || object[key] === undefined;
+            const needsAllocation = isNullish && isStatic(member.type) && member.type[Symbol.metadata].struct.isDynamic;
             offset = nextOffset;
-            if (!isInstance(object[key]))
+            if (!isInstance(object[key]) && !needsAllocation)
                 nextOffset += sizeof(member.type);
             if (typeof instance[member.name] == 'string') {
                 instance[member.name] =
@@ -240,7 +242,9 @@ export function deserialize(instance, _buffer) {
                 continue;
             }
             if (!primitive.isType(member.type)) {
-                if (object[key] === null || object[key] === undefined)
+                if (needsAllocation && isStatic(member.type))
+                    object[key] ??= new member.type();
+                else if (isNullish)
                     continue;
                 deserialize(object[key], new Uint8Array(buffer.subarray(offset)));
                 nextOffset += sizeof(object[key]);

package/package.json

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

package/src/internal/struct.ts

@@ -3,13 +3,8 @@ import type * as primitive from './primitives.js';
 
 declare global {
 	interface SymbolConstructor {
-		/** User-defined size */
 		readonly size: unique symbol;
-
-		/** User-defined serialization */
 		readonly serialize: unique symbol;
-
-		/** User-defined deserialization */
 		readonly deserialize: unique symbol;
 	}
 }
@@ -102,6 +97,7 @@ export interface Static<T extends Metadata = Metadata> {
 
 export interface StaticLike<T extends Metadata = Metadata> extends ClassLike {
 	[Symbol.metadata]?: _DecoratorMetadata<T> | null;
+	new (): unknown;
 }
 
 export function isValidMetadata<T extends Metadata = Metadata>(

package/src/string.ts

@@ -38,3 +38,19 @@ const decoder = new TextDecoder();
 export function decodeUTF8(input?: Uint8Array): string {
 	return decoder.decode(input);
 }
+
+export function encodeASCII(input: string): Uint8Array {
+	const data = new Uint8Array(input.length);
+	for (let i = 0; i < input.length; i++) {
+		data[i] = input.charCodeAt(i);
+	}
+	return data;
+}
+
+export function decodeASCII(input: Uint8Array): string {
+	let output = '';
+	for (let i = 0; i < input.length; i++) {
+		output += String.fromCharCode(input[i]);
+	}
+	return output;
+}

package/src/struct.ts

@@ -318,8 +318,12 @@ export function deserialize(instance: unknown, _buffer: ArrayBufferLike | ArrayB
 			let object = length != -1 ? instance[member.name] : instance;
 			const key = length != -1 ? i : member.name;
 
+			const isNullish = object[key] === null || object[key] === undefined;
+
+			const needsAllocation = isNullish && isStatic(member.type) && member.type[Symbol.metadata].struct.isDynamic;
+
 			offset = nextOffset;
-			if (!isInstance(object[key])) nextOffset += sizeof(member.type);
+			if (!isInstance(object[key]) && !needsAllocation) nextOffset += sizeof(member.type);
 
 			if (typeof instance[member.name] == 'string') {
 				instance[member.name] =
@@ -330,7 +334,8 @@ export function deserialize(instance: unknown, _buffer: ArrayBufferLike | ArrayB
 			}
 
 			if (!primitive.isType(member.type)) {
-				if (object[key] === null || object[key] === undefined) continue;
+				if (needsAllocation && isStatic(member.type)) object[key] ??= new member.type();
+				else if (isNullish) continue;
 
 				deserialize(object[key], new Uint8Array(buffer.subarray(offset)));
 				nextOffset += sizeof(object[key]);