utilium 1.2.9 → 1.3.0

package/dist/cache.d.ts

@@ -37,20 +37,16 @@ export interface Region {
 export declare class Resource<ID> {
     /** The resource ID */
     readonly id: ID;
-    /** The full size of the resource */
-    size: number;
+    protected _size: number;
     protected readonly options: Options;
     /** Regions used to reduce unneeded allocations. Think of sparse arrays. */
     readonly regions: Region[];
+    /** The full size of the resource */
+    get size(): number;
+    set size(value: number);
     constructor(
     /** The resource ID */
-    id: ID, 
-    /** The full size of the resource */
-    size: number, options: Options, resources?: Map<ID, Resource<ID> | undefined>);
-    /**
-     * Ensure the full size of the resource is *at least* `newSize`
-     */
-    grow(newSize: number): void;
+    id: ID, _size: number, options: Options, resources?: Map<ID, Resource<ID> | undefined>);
     /** Combines adjacent regions and combines adjacent ranges within a region */
     collect(): void;
     /** Takes an initial range and finds the sub-ranges that are not in the cache */

package/dist/cache.js

@@ -6,29 +6,51 @@ import { extendBuffer } from './buffer.js';
  */
 export class Resource {
     id;
-    size;
+    _size;
     options;
     /** Regions used to reduce unneeded allocations. Think of sparse arrays. */
     regions = [];
+    /** The full size of the resource */
+    get size() {
+        return this._size;
+    }
+    set size(value) {
+        if (value >= this._size) {
+            this._size = value;
+            return;
+        }
+        this._size = value;
+        for (let i = this.regions.length - 1; i >= 0; i--) {
+            const region = this.regions[i];
+            if (region.offset >= value) {
+                this.regions.splice(i, 1);
+                continue;
+            }
+            const maxLength = value - region.offset;
+            if (region.data.byteLength > maxLength) {
+                region.data = region.data.subarray(0, maxLength);
+            }
+            region.ranges = region.ranges
+                .filter(range => range.start < value)
+                .map(range => {
+                if (range.end > value) {
+                    return { start: range.start, end: value };
+                }
+                return range;
+            });
+        }
+    }
     constructor(
     /** The resource ID */
-    id, 
-    /** The full size of the resource */
-    size, options, resources) {
+    id, _size, options, resources) {
         this.id = id;
-        this.size = size;
+        this._size = _size;
         this.options = options;
         options.sparse ??= true;
         if (!options.sparse)
-            this.regions.push({ offset: 0, data: new Uint8Array(size), ranges: [] });
+            this.regions.push({ offset: 0, data: new Uint8Array(_size), ranges: [] });
         resources?.set(id, this);
     }
-    /**
-     * Ensure the full size of the resource is *at least* `newSize`
-     */
-    grow(newSize) {
-        this.size = Math.max(this.size, newSize);
-    }
     /** Combines adjacent regions and combines adjacent ranges within a region */
     collect() {
         if (!this.options.sparse)
@@ -143,6 +165,7 @@ export class Resource {
             region.data.set(data, offset);
             region.ranges.push({ start: offset, end });
             region.ranges.sort((a, b) => a.start - b.start);
+            this.collect();
             return this;
         }
         // Find the correct index to insert the new region
@@ -155,6 +178,7 @@ export class Resource {
         else {
             this.regions.splice(insertIndex, 0, newRegion); // Insert before the first region with a greater offset
         }
+        this.collect();
         return this;
     }
 }

package/dist/internal/primitives.d.ts

@@ -3,12 +3,13 @@ type BitsToBytes = {
     '16': 2;
     '32': 4;
     '64': 8;
+    '128': 16;
 };
 export type Size<T extends string> = T extends `${'int' | 'uint' | 'float'}${infer bits}` ? (bits extends keyof BitsToBytes ? BitsToBytes[bits] : never) : never;
-export type Type = `${'int' | 'uint'}${8 | 16 | 32 | 64}` | `float${32 | 64}`;
+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 types: ("int8" | "int16" | "int32" | "int64" | "uint8" | "uint16" | "uint32" | "uint64" | "float32" | "float64")[];
-export declare const valids: ("int8" | "int16" | "int32" | "int64" | "uint8" | "uint16" | "uint32" | "uint64" | "float32" | "float64" | "Int8" | "Int16" | "Int32" | "Int64" | "Uint8" | "Uint16" | "Uint32" | "Uint64" | "Float32" | "Float64" | "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 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>;
@@ -21,4 +22,5 @@ export declare function isValid(type: {
 export declare function checkValid(type: {
     toString(): string;
 }): asserts type is Valid;
+export declare const mask64: bigint;
 export {};

package/dist/internal/primitives.js

@@ -1,7 +1,7 @@
 import { capitalize } from '../string.js';
-export const types = ['int8', 'uint8', 'int16', 'uint16', 'int32', 'uint32', 'int64', 'uint64', 'float32', 'float64'];
+export const types = ['int8', 'uint8', 'int16', 'uint16', 'int32', 'uint32', 'int64', 'uint64', 'int128', 'uint128', 'float32', 'float64', 'float128'];
 export const valids = [...types, ...types.map(t => capitalize(t)), 'char'];
-export const regex = /^(u?int|float)(8|16|32|64)$/i;
+export const regex = /^(u?int|float)(8|16|32|64|128)$/i;
 export function normalize(type) {
     return (type == 'char' ? 'uint8' : type.toLowerCase());
 }
@@ -16,3 +16,4 @@ export function checkValid(type) {
         throw new TypeError('Not a valid primitive type: ' + type);
     }
 }
+export const mask64 = BigInt('0xffffffffffffffff');

package/dist/requests.js

@@ -116,7 +116,7 @@ export async function set(url, data, options, init = {}) {
     const { offset = 0 } = options;
     if (!options.cacheOnly)
         await _fetch(new Request(url, init), { method: 'POST' }, true);
-    resource.add(data, offset).collect();
+    resource.add(data, offset);
 }
 /**
  * Make a DELETE request to remove the resource from the server and clear it from the cache.

package/dist/struct.js

@@ -88,8 +88,7 @@ export function serialize(instance) {
                 buffer.set(value ? serialize(value) : new Uint8Array(sizeof(type)), iOff);
                 continue;
             }
-            const Type = capitalize(type);
-            const fn = ('set' + Type);
+            const fn = `set${capitalize(type)}`;
             if (fn == 'setInt64') {
                 view.setBigInt64(iOff, BigInt(value), !options.bigEndian);
                 continue;
@@ -98,6 +97,21 @@ export function serialize(instance) {
                 view.setBigUint64(iOff, BigInt(value), !options.bigEndian);
                 continue;
             }
+            if (fn == 'setInt128') {
+                view.setBigUint64(iOff + (!options.bigEndian ? 0 : 8), value & primitive.mask64, !options.bigEndian);
+                view.setBigInt64(iOff + (!options.bigEndian ? 8 : 0), value >> BigInt(64), !options.bigEndian);
+                continue;
+            }
+            if (fn == 'setUint128') {
+                view.setBigUint64(iOff + (!options.bigEndian ? 0 : 8), value & primitive.mask64, !options.bigEndian);
+                view.setBigUint64(iOff + (!options.bigEndian ? 8 : 0), value >> BigInt(64), !options.bigEndian);
+                continue;
+            }
+            if (fn == 'setFloat128') {
+                view.setFloat64(iOff + (!options.bigEndian ? 0 : 8), Number(value), !options.bigEndian);
+                view.setBigUint64(iOff + (!options.bigEndian ? 8 : 0), BigInt(0), !options.bigEndian);
+                continue;
+            }
             view[fn](iOff, Number(value), !options.bigEndian);
         }
     }
@@ -132,8 +146,7 @@ export function deserialize(instance, _buffer) {
             if (length > 0) {
                 object ||= [];
             }
-            const Type = capitalize(type);
-            const fn = ('get' + Type);
+            const fn = `get${capitalize(type)}`;
             if (fn == 'getInt64') {
                 object[key] = view.getBigInt64(iOff, !options.bigEndian);
                 continue;
@@ -142,6 +155,22 @@ export function deserialize(instance, _buffer) {
                 object[key] = view.getBigUint64(iOff, !options.bigEndian);
                 continue;
             }
+            if (fn == 'getInt128') {
+                object[key] =
+                    (view.getBigInt64(iOff + (!options.bigEndian ? 8 : 0), !options.bigEndian) << BigInt(64)) |
+                        view.getBigUint64(iOff + (!options.bigEndian ? 0 : 8), !options.bigEndian);
+                continue;
+            }
+            if (fn == 'getUint128') {
+                object[key] =
+                    (view.getBigUint64(iOff + (!options.bigEndian ? 8 : 0), !options.bigEndian) << BigInt(64)) |
+                        view.getBigUint64(iOff + (!options.bigEndian ? 0 : 8), !options.bigEndian);
+                continue;
+            }
+            if (fn == 'getFloat128') {
+                object[key] = view.getFloat64(iOff + (!options.bigEndian ? 0 : 8), !options.bigEndian);
+                continue;
+            }
             object[key] = view[fn](iOff, !options.bigEndian);
         }
     }

package/package.json

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

package/src/cache.ts

@@ -45,27 +45,56 @@ export class Resource<ID> {
 	/** Regions used to reduce unneeded allocations. Think of sparse arrays. */
 	public readonly regions: Region[] = [];
 
+	/** The full size of the resource */
+	public get size() {
+		return this._size;
+	}
+
+	public set size(value: number) {
+		if (value >= this._size) {
+			this._size = value;
+			return;
+		}
+
+		this._size = value;
+
+		for (let i = this.regions.length - 1; i >= 0; i--) {
+			const region = this.regions[i];
+
+			if (region.offset >= value) {
+				this.regions.splice(i, 1);
+				continue;
+			}
+
+			const maxLength = value - region.offset;
+			if (region.data.byteLength > maxLength) {
+				region.data = region.data.subarray(0, maxLength);
+			}
+
+			region.ranges = region.ranges
+				.filter(range => range.start < value)
+				.map(range => {
+					if (range.end > value) {
+						return { start: range.start, end: value };
+					}
+					return range;
+				});
+		}
+	}
+
 	public constructor(
 		/** The resource ID */
 		public readonly id: ID,
-		/** The full size of the resource */
-		public size: number,
+		protected _size: number,
 		protected readonly options: Options,
 		resources?: Map<ID, Resource<ID> | undefined>
 	) {
 		options.sparse ??= true;
-		if (!options.sparse) this.regions.push({ offset: 0, data: new Uint8Array(size), ranges: [] });
+		if (!options.sparse) this.regions.push({ offset: 0, data: new Uint8Array(_size), ranges: [] });
 
 		resources?.set(id, this);
 	}
 
-	/**
-	 * Ensure the full size of the resource is *at least* `newSize`
-	 */
-	public grow(newSize: number) {
-		this.size = Math.max(this.size, newSize);
-	}
-
 	/** Combines adjacent regions and combines adjacent ranges within a region */
 	public collect(): void {
 		if (!this.options.sparse) return;
@@ -191,6 +220,7 @@ export class Resource<ID> {
 			region.ranges.push({ start: offset, end });
 			region.ranges.sort((a, b) => a.start - b.start);
 
+			this.collect();
 			return this;
 		}
 
@@ -205,6 +235,7 @@ export class Resource<ID> {
 			this.regions.splice(insertIndex, 0, newRegion); // Insert before the first region with a greater offset
 		}
 
+		this.collect();
 		return this;
 	}
 }

package/src/internal/primitives.ts

@@ -5,17 +5,20 @@ type BitsToBytes = {
 	'16': 2;
 	'32': 4;
 	'64': 8;
+	'128': 16;
 };
 
 export type Size<T extends string> = T extends `${'int' | 'uint' | 'float'}${infer bits}` ? (bits extends keyof BitsToBytes ? BitsToBytes[bits] : never) : never;
-export type Type = `${'int' | 'uint'}${8 | 16 | 32 | 64}` | `float${32 | 64}`;
-export type Valid = Type | Capitalize<Type> | 'char';
 
-export const types = ['int8', 'uint8', 'int16', 'uint16', 'int32', 'uint32', 'int64', 'uint64', 'float32', 'float64'] satisfies Type[];
+export const types = ['int8', 'uint8', 'int16', 'uint16', 'int32', 'uint32', 'int64', 'uint64', 'int128', 'uint128', 'float32', 'float64', 'float128'] as const;
+
+export type Type = (typeof types)[number];
+
+export type Valid = Type | Capitalize<Type> | 'char';
 
 export const valids = [...types, ...types.map(t => capitalize(t)), 'char'] satisfies Valid[];
 
-export const regex = /^(u?int|float)(8|16|32|64)$/i;
+export const regex = /^(u?int|float)(8|16|32|64|128)$/i;
 
 export type Normalize<T extends Valid> = T extends 'char' ? 'uint8' : Uncapitalize<T>;
 
@@ -36,3 +39,5 @@ export function checkValid(type: { toString(): string }): asserts type is Valid
 		throw new TypeError('Not a valid primitive type: ' + type);
 	}
 }
+
+export const mask64 = BigInt('0xffffffffffffffff');

package/src/requests.ts

@@ -201,7 +201,7 @@ export async function set(url: string, data: Uint8Array, options: SetOptions, in
 
 	if (!options.cacheOnly) await _fetch(new Request(url, init), { method: 'POST' }, true);
 
-	resource.add(data, offset).collect();
+	resource.add(data, offset);
 }
 
 /**

package/src/struct.ts

@@ -107,8 +107,8 @@ export function serialize(instance: unknown): Uint8Array {
 				continue;
 			}
 
-			const Type = capitalize(type);
-			const fn = ('set' + Type) as `set${typeof Type}`;
+			const fn = `set${capitalize(type)}` as const;
+
 			if (fn == 'setInt64') {
 				view.setBigInt64(iOff, BigInt(value), !options.bigEndian);
 				continue;
@@ -119,6 +119,24 @@ export function serialize(instance: unknown): Uint8Array {
 				continue;
 			}
 
+			if (fn == 'setInt128') {
+				view.setBigUint64(iOff + (!options.bigEndian ? 0 : 8), value & primitive.mask64, !options.bigEndian);
+				view.setBigInt64(iOff + (!options.bigEndian ? 8 : 0), value >> BigInt(64), !options.bigEndian);
+				continue;
+			}
+
+			if (fn == 'setUint128') {
+				view.setBigUint64(iOff + (!options.bigEndian ? 0 : 8), value & primitive.mask64, !options.bigEndian);
+				view.setBigUint64(iOff + (!options.bigEndian ? 8 : 0), value >> BigInt(64), !options.bigEndian);
+				continue;
+			}
+
+			if (fn == 'setFloat128') {
+				view.setFloat64(iOff + (!options.bigEndian ? 0 : 8), Number(value), !options.bigEndian);
+				view.setBigUint64(iOff + (!options.bigEndian ? 8 : 0), BigInt(0), !options.bigEndian);
+				continue;
+			}
+
 			view[fn](iOff, Number(value), !options.bigEndian);
 		}
 	}
@@ -163,8 +181,7 @@ export function deserialize(instance: unknown, _buffer: ArrayBufferLike | ArrayB
 				object ||= [];
 			}
 
-			const Type = capitalize(type);
-			const fn = ('get' + Type) as `get${typeof Type}`;
+			const fn = `get${capitalize(type)}` as const;
 			if (fn == 'getInt64') {
 				object[key] = view.getBigInt64(iOff, !options.bigEndian);
 				continue;
@@ -175,6 +192,25 @@ export function deserialize(instance: unknown, _buffer: ArrayBufferLike | ArrayB
 				continue;
 			}
 
+			if (fn == 'getInt128') {
+				object[key] =
+					(view.getBigInt64(iOff + (!options.bigEndian ? 8 : 0), !options.bigEndian) << BigInt(64)) |
+					view.getBigUint64(iOff + (!options.bigEndian ? 0 : 8), !options.bigEndian);
+				continue;
+			}
+
+			if (fn == 'getUint128') {
+				object[key] =
+					(view.getBigUint64(iOff + (!options.bigEndian ? 8 : 0), !options.bigEndian) << BigInt(64)) |
+					view.getBigUint64(iOff + (!options.bigEndian ? 0 : 8), !options.bigEndian);
+				continue;
+			}
+
+			if (fn == 'getFloat128') {
+				object[key] = view.getFloat64(iOff + (!options.bigEndian ? 0 : 8), !options.bigEndian);
+				continue;
+			}
+
 			object[key] = view[fn](iOff, !options.bigEndian);
 		}
 	}