utilium 1.0.0 → 1.0.2

package/dist/internal/struct.d.ts

@@ -1,11 +1,13 @@
 import type { ClassLike } from '../types.js';
 import type * as primitive from './primitives.js';
+import './struct-symbols.js';
 export interface MemberInit {
     name: string;
     type: string | ClassLike;
     length?: number;
 }
-export declare const init: unique symbol;
+/** @deprecated */
+export declare const init: typeof Symbol.struct_init;
 /**
  * Options for struct initialization
  */
@@ -23,10 +25,11 @@ export interface Metadata {
     members: Map<string, Member>;
     size: number;
 }
-export declare const metadata: unique symbol;
+/** @deprecated */
+export declare const metadata: typeof Symbol.struct_metadata;
 export interface _DecoratorMetadata<T extends Metadata = Metadata> extends DecoratorMetadata {
-    [metadata]?: T;
-    [init]?: MemberInit[];
+    [Symbol.struct_metadata]?: T;
+    [Symbol.struct_init]?: MemberInit[];
 }
 export interface DecoratorContext<T extends Metadata = Metadata> {
     metadata: _DecoratorMetadata<T>;
@@ -34,7 +37,7 @@ export interface DecoratorContext<T extends Metadata = Metadata> {
 export type MemberContext = ClassMemberDecoratorContext & DecoratorContext;
 export interface Static<T extends Metadata = Metadata> {
     [Symbol.metadata]: DecoratorMetadata & {
-        [metadata]: T;
+        [Symbol.struct_metadata]: T;
     };
     new (): Instance<T>;
     prototype: Instance<T>;
@@ -43,7 +46,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 & {
-    [metadata]: T;
+    [Symbol.struct_metadata]: T;
 };
 /**
  * Polyfill context.metadata

package/dist/internal/struct.js

@@ -1,7 +1,14 @@
-export const init = Symbol('struct_init');
-export const metadata = Symbol('struct');
+import './struct-symbols.js';
+// @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;
 export function isValidMetadata(arg) {
-    return arg != null && typeof arg == 'object' && metadata in arg;
+    return arg != null && typeof arg == 'object' && Symbol.struct_metadata in arg;
 }
 /**
  * Polyfill Symbol.metadata

package/dist/struct.js

@@ -1,5 +1,5 @@
 import * as primitive from './internal/primitives.js';
-import { checkInstance, checkStruct, init, isStatic, metadata, symbol_metadata } from './internal/struct.js';
+import { checkInstance, checkStruct, isStatic, symbol_metadata } from './internal/struct.js';
 import { capitalize } from './string.js';
 export * as Struct from './internal/struct.js';
 /**
@@ -13,7 +13,7 @@ export function sizeof(type) {
     }
     checkStruct(type);
     const struct = isStatic(type) ? type : type.constructor;
-    return struct[symbol_metadata(struct)][metadata].size;
+    return struct[symbol_metadata(struct)][Symbol.struct_metadata].size;
 }
 /**
  * Aligns a number
@@ -27,10 +27,10 @@ export function align(value, alignment) {
 export function struct(options = {}) {
     return function _decorateStruct(target, context) {
         context.metadata ??= {};
-        context.metadata[init] ||= [];
+        context.metadata[Symbol.struct_init] ||= [];
         let size = 0;
         const members = new Map();
-        for (const _ of context.metadata[init]) {
+        for (const _ of context.metadata[Symbol.struct_init]) {
             const { name, type, length } = _;
             if (!primitive.isValid(type) && !isStatic(type)) {
                 throw new TypeError('Not a valid type: ' + type);
@@ -43,7 +43,7 @@ export function struct(options = {}) {
             size += sizeof(type) * (length || 1);
             size = align(size, options.align || 1);
         }
-        context.metadata[metadata] = { options, members, size };
+        context.metadata[Symbol.struct_metadata] = { options, members, size };
         return target;
     };
 }
@@ -61,8 +61,8 @@ export function member(type, length) {
             throw new ReferenceError('Invalid name for struct member');
         }
         context.metadata ??= {};
-        context.metadata[init] ||= [];
-        context.metadata[init].push({ name, type, length });
+        context.metadata[Symbol.struct_init] ||= [];
+        context.metadata[Symbol.struct_init].push({ name, type, length });
         return value;
     };
 }
@@ -71,7 +71,7 @@ export function member(type, length) {
  */
 export function serialize(instance) {
     checkInstance(instance);
-    const { options, members } = instance.constructor[symbol_metadata(instance.constructor)][metadata];
+    const { options, members } = instance.constructor[symbol_metadata(instance.constructor)][Symbol.struct_metadata];
     const buffer = new Uint8Array(sizeof(instance));
     const view = new DataView(buffer.buffer);
     for (const [name, { type, length, offset }] of members) {
@@ -106,7 +106,7 @@ export function serialize(instance) {
  */
 export function deserialize(instance, _buffer) {
     checkInstance(instance);
-    const { options, members } = instance.constructor[symbol_metadata(instance.constructor)][metadata];
+    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 view = new DataView(buffer.buffer.slice(buffer.byteOffset, buffer.byteOffset + buffer.byteLength));
     for (const [name, { type, offset, length }] of members) {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "utilium",
-	"version": "1.0.0",
+	"version": "1.0.2",
 	"description": "Typescript utilities",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",

package/src/internal/struct-symbols.d.ts

@@ -0,0 +1,4 @@
+interface SymbolConstructor {
+	readonly struct_init: unique symbol;
+	readonly struct_metadata: unique symbol;
+}

package/src/internal/struct.ts

@@ -1,5 +1,12 @@
 import type { ClassLike } from '../types.js';
 import type * as primitive from './primitives.js';
+import './struct-symbols.js';
+
+// @ts-expect-error 2322
+Symbol.struct_init ||= Symbol('struct_init');
+
+// @ts-expect-error 2322
+Symbol.struct_metadata ||= Symbol('struct_metadata');
 
 export interface MemberInit {
 	name: string;
@@ -7,7 +14,8 @@ export interface MemberInit {
 	length?: number;
 }
 
-export const init: unique symbol = Symbol('struct_init');
+/** @deprecated */
+export const init: typeof Symbol.struct_init = Symbol.struct_init;
 
 /**
  * Options for struct initialization
@@ -29,11 +37,12 @@ export interface Metadata {
 	size: number;
 }
 
-export const metadata: unique symbol = Symbol('struct');
+/** @deprecated */
+export const metadata: typeof Symbol.struct_metadata = Symbol.struct_metadata;
 
 export interface _DecoratorMetadata<T extends Metadata = Metadata> extends DecoratorMetadata {
-	[metadata]?: T;
-	[init]?: MemberInit[];
+	[Symbol.struct_metadata]?: T;
+	[Symbol.struct_init]?: MemberInit[];
 }
 
 export interface DecoratorContext<T extends Metadata = Metadata> {
@@ -44,7 +53,7 @@ export type MemberContext = ClassMemberDecoratorContext & DecoratorContext;
 
 export interface Static<T extends Metadata = Metadata> {
 	[Symbol.metadata]: DecoratorMetadata & {
-		[metadata]: T;
+		[Symbol.struct_metadata]: T;
 	};
 	new (): Instance<T>;
 	prototype: Instance<T>;
@@ -57,9 +66,9 @@ export interface StaticLike<T extends Metadata = Metadata> extends ClassLike {
 export function isValidMetadata<T extends Metadata = Metadata>(
 	arg: unknown
 ): arg is DecoratorMetadata & {
-	[metadata]: T;
+	[Symbol.struct_metadata]: T;
 } {
-	return arg != null && typeof arg == 'object' && metadata in arg;
+	return arg != null && typeof arg == 'object' && Symbol.struct_metadata in arg;
 }
 
 /**

package/src/struct.ts

@@ -1,6 +1,6 @@
 import * as primitive from './internal/primitives.js';
 import type { DecoratorContext, InstanceLike, Member, MemberInit, Metadata, Options, Size, StaticLike } from './internal/struct.js';
-import { checkInstance, checkStruct, init, isStatic, metadata, symbol_metadata, type MemberContext } from './internal/struct.js';
+import { checkInstance, checkStruct, isStatic, symbol_metadata, type MemberContext } from './internal/struct.js';
 import { capitalize } from './string.js';
 import type { ClassLike } from './types.js';
 export * as Struct from './internal/struct.js';
@@ -20,7 +20,7 @@ export function sizeof<T extends primitive.Valid | StaticLike | InstanceLike>(ty
 
 	const struct = isStatic(type) ? type : type.constructor;
 
-	return struct[symbol_metadata(struct)][metadata].size as Size<T>;
+	return struct[symbol_metadata(struct)][Symbol.struct_metadata].size as Size<T>;
 }
 
 /**
@@ -36,10 +36,10 @@ export function align(value: number, alignment: number): number {
 export function struct(options: Partial<Options> = {}) {
 	return function _decorateStruct<const T extends StaticLike>(target: T, context: ClassDecoratorContext & DecoratorContext): T {
 		context.metadata ??= {};
-		context.metadata[init] ||= [];
+		context.metadata[Symbol.struct_init] ||= [];
 		let size = 0;
 		const members = new Map<string, Member>();
-		for (const _ of context.metadata[init]) {
+		for (const _ of context.metadata[Symbol.struct_init]!) {
 			const { name, type, length } = _;
 			if (!primitive.isValid(type) && !isStatic(type)) {
 				throw new TypeError('Not a valid type: ' + type);
@@ -53,7 +53,7 @@ export function struct(options: Partial<Options> = {}) {
 			size = align(size, options.align || 1);
 		}
 
-		context.metadata[metadata] = { options, members, size } satisfies Metadata;
+		context.metadata[Symbol.struct_metadata] = { options, members, size } satisfies Metadata;
 		return target;
 	};
 }
@@ -74,8 +74,8 @@ export function member(type: primitive.Valid | ClassLike, length?: number) {
 		}
 
 		context.metadata ??= {};
-		context.metadata[init] ||= [];
-		context.metadata[init].push({ name, type, length } satisfies MemberInit);
+		context.metadata[Symbol.struct_init] ||= [];
+		context.metadata[Symbol.struct_init]!.push({ name, type, length } satisfies MemberInit);
 		return value;
 	};
 }
@@ -85,7 +85,7 @@ export function member(type: primitive.Valid | ClassLike, length?: number) {
  */
 export function serialize(instance: unknown): Uint8Array {
 	checkInstance(instance);
-	const { options, members } = instance.constructor[symbol_metadata(instance.constructor)][metadata];
+	const { options, members } = instance.constructor[symbol_metadata(instance.constructor)][Symbol.struct_metadata];
 
 	const buffer = new Uint8Array(sizeof(instance));
 	const view = new DataView(buffer.buffer);
@@ -129,7 +129,7 @@ export function serialize(instance: unknown): Uint8Array {
  */
 export function deserialize(instance: unknown, _buffer: ArrayBuffer | ArrayBufferView) {
 	checkInstance(instance);
-	const { options, members } = instance.constructor[symbol_metadata(instance.constructor)][metadata];
+	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);