utilium 0.7.2 → 0.7.4

package/dist/internal/struct.d.ts

@@ -1,5 +1,5 @@
-import { ClassLike } from '../types.js';
-import * as primitive from './primitives.js';
+import type { ClassLike } from '../types.js';
+import type * as primitive from './primitives.js';
 export interface MemberInit {
     name: string;
     type: string | ClassLike;
@@ -45,6 +45,11 @@ export interface StaticLike<T extends Metadata = Metadata> extends ClassLike {
 export declare function isValidMetadata<T extends Metadata = Metadata>(arg: unknown): arg is DecoratorMetadata & {
     [metadata]: T;
 };
+/**
+ * Polyfill context.metadata
+ * @see https://github.com/microsoft/TypeScript/issues/53461
+ */
+export declare function _polyfill_contextMetadata(target: object): void;
 /**
  * Gets a reference to Symbol.metadata, even on platforms that do not expose it globally (like Node)
  */

package/dist/internal/struct.js

@@ -3,11 +3,35 @@ export const metadata = Symbol('struct');
 export function isValidMetadata(arg) {
     return arg != null && typeof arg == 'object' && metadata in arg;
 }
+/**
+ * Polyfill Symbol.metadata
+ * @see https://github.com/microsoft/TypeScript/issues/53461
+ */
+Symbol.metadata ??= Symbol.for('Symbol.metadata');
+/**
+ * Polyfill context.metadata
+ * @see https://github.com/microsoft/TypeScript/issues/53461
+ */
+export function _polyfill_contextMetadata(target) {
+    if (!Symbol?.metadata) {
+        return;
+    }
+    if (Symbol.metadata in target) {
+        return;
+    }
+    Object.defineProperty(target, Symbol.metadata, {
+        enumerable: true,
+        configurable: true,
+        writable: true,
+        value: Object.create(null),
+    });
+}
 /**
  * Gets a reference to Symbol.metadata, even on platforms that do not expose it globally (like Node)
  */
 export function symbol_metadata(arg) {
     const symbol_metadata = Symbol.metadata || Object.getOwnPropertySymbols(arg).find(s => s.description == 'Symbol.metadata');
+    _polyfill_contextMetadata(arg);
     if (!symbol_metadata) {
         throw new ReferenceError('Could not get a reference to Symbol.metadata');
     }
@@ -21,7 +45,7 @@ export function isInstance(arg) {
 }
 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');
+        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) {
@@ -29,6 +53,6 @@ export function isStruct(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');
+        throw new TypeError((typeof arg == 'function' ? arg.name : typeof arg == 'object' && arg ? arg.constructor.name : arg) + ' is not a struct');
     }
 }

package/dist/objects.d.ts

@@ -1,4 +1,4 @@
-import { UnionToTuple } from './types.js';
+import type { UnionToTuple } from './types.js';
 export declare function filterObject<O extends object, R extends object>(object: O, predicate: (key: keyof O, value: O[keyof O]) => boolean): R;
 export declare function pick<T extends object, K extends keyof T>(object: T, ...keys: readonly K[]): Pick<T, K>;
 export declare function pick<T extends object, K extends keyof T>(object: T, ...keys: readonly (readonly K[])[]): Pick<T, K>;

package/dist/struct.d.ts

@@ -1,6 +1,7 @@
 import * as primitive from './internal/primitives.js';
-import { DecoratorContext, InstanceLike, Options, Size, StaticLike, type MemberContext } from './internal/struct.js';
-import { ClassLike } from './types.js';
+import type { DecoratorContext, InstanceLike, Options, Size, StaticLike } from './internal/struct.js';
+import { type 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

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, init, isStatic, metadata, symbol_metadata } from './internal/struct.js';
 import { capitalize } from './string.js';
 export * as Struct from './internal/struct.js';
 /**
@@ -25,7 +25,6 @@ export function align(value, alignment) {
  * Decorates a class as a struct
  */
 export function struct(options = {}) {
-    // eslint-disable-next-line @typescript-eslint/no-unused-vars
     return function _decorateStruct(target, context) {
         context.metadata ??= {};
         context.metadata[init] ||= [];

package/package.json

@@ -1,25 +1,28 @@
 {
 	"name": "utilium",
-	"version": "0.7.2",
+	"version": "0.7.4",
 	"description": "Typescript utilies",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",
 	"type": "module",
 	"exports": {
 		".": "./dist/index.js",
-		"./*": "./dist/*"
+		"./*": "./dist/*",
+		"./eslint": "./eslint.shared.js",
+		"./source": "./src/*"
 	},
 	"files": [
 		"src",
 		"dist",
-		"tsconfig.json"
+		"tsconfig.json",
+		"scripts"
 	],
 	"scripts": {
 		"format:check": "prettier --check .",
 		"format": "prettier --write .",
-		"lint": "eslint src && tsc --noEmit",
+		"lint": "tsc --noEmit && eslint src",
 		"build": "tsc -p tsconfig.json",
-		"build:docs": "typedoc src/index.ts --out docs",
+		"build:docs": "typedoc",
 		"prepublishOnly": "npm run build"
 	},
 	"repository": {
@@ -33,13 +36,16 @@
 	},
 	"homepage": "https://github.com/james-pre/utilium#readme",
 	"devDependencies": {
+		"@eslint/js": "^9.12.0",
+		"@stylistic/eslint-plugin": "^2.9.0",
+		"@types/eslint__js": "^8.42.3",
 		"@types/node": "^20.12.7",
-		"@typescript-eslint/eslint-plugin": "^6.2.0",
-		"@typescript-eslint/parser": "^6.2.0",
-		"eslint": "^8.45.0",
+		"eslint": "^9.12.0",
+		"globals": "^15.10.0",
 		"prettier": "^3.2.5",
 		"typedoc": "^0.26.6",
-		"typescript": "^5.5.4"
+		"typescript": "^5.5.4",
+		"typescript-eslint": "^8.8.0"
 	},
 	"dependencies": {
 		"eventemitter3": "^5.0.1"

package/src/internal/struct.ts

@@ -1,5 +1,5 @@
-import { ClassLike } from '../types.js';
-import * as primitive from './primitives.js';
+import type { ClassLike } from '../types.js';
+import type * as primitive from './primitives.js';
 
 export interface MemberInit {
 	name: string;
@@ -62,11 +62,37 @@ export function isValidMetadata<T extends Metadata = Metadata>(
 	return arg != null && typeof arg == 'object' && metadata in arg;
 }
 
+/**
+ * Polyfill Symbol.metadata
+ * @see https://github.com/microsoft/TypeScript/issues/53461
+ */
+(Symbol as { metadata: symbol }).metadata ??= Symbol.for('Symbol.metadata');
+
+/**
+ * Polyfill context.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;
+	}
+	Object.defineProperty(target, Symbol.metadata, {
+		enumerable: true,
+		configurable: true,
+		writable: true,
+		value: Object.create(null),
+	});
+}
+
 /**
  * Gets a reference to Symbol.metadata, even on platforms that do not expose it globally (like Node)
  */
 export function symbol_metadata(arg: ClassLike): typeof Symbol.metadata {
 	const symbol_metadata = Symbol.metadata || Object.getOwnPropertySymbols(arg).find(s => s.description == 'Symbol.metadata');
+	_polyfill_contextMetadata(arg);
 	if (!symbol_metadata) {
 		throw new ReferenceError('Could not get a reference to Symbol.metadata');
 	}
@@ -92,7 +118,7 @@ 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> {
 	if (!isInstance(arg)) {
-		throw new TypeError((typeof arg == 'function' ? arg.name : 'object' && arg ? arg.constructor.name : arg) + ' is not a struct instance');
+		throw new TypeError((typeof arg == 'function' ? arg.name : typeof arg == 'object' && arg ? arg.constructor.name : arg) + ' is not a struct instance');
 	}
 }
 
@@ -102,7 +128,7 @@ 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 : 'object' && arg ? arg.constructor.name : arg) + ' is not a struct');
+		throw new TypeError((typeof arg == 'function' ? arg.name : typeof arg == 'object' && arg ? arg.constructor.name : arg) + ' is not a struct');
 	}
 }
 

package/src/objects.ts

@@ -1,14 +1,14 @@
-import { UnionToTuple } from './types.js';
+import type { UnionToTuple } from './types.js';
 
 export function filterObject<O extends object, R extends object>(object: O, predicate: (key: keyof O, value: O[keyof O]) => boolean): R {
-	const entries = <[keyof O, O[keyof O]][]>Object.entries(object);
-	return <R>Object.fromEntries(entries.filter(([key, value]) => predicate(key, value)));
+	const entries = Object.entries(object) as [keyof O, O[keyof O]][];
+	return Object.fromEntries(entries.filter(([key, value]) => predicate(key, value))) as R;
 }
 
 export function pick<T extends object, K extends keyof T>(object: T, ...keys: readonly K[]): Pick<T, K>;
 export function pick<T extends object, K extends keyof T>(object: T, ...keys: readonly (readonly K[])[]): Pick<T, K>;
 export function pick<T extends object, K extends keyof T>(object: T, ...keys: readonly K[] | readonly (readonly K[])[]): Pick<T, K> {
-	const picked = <Pick<T, K>>{};
+	const picked = {} as Pick<T, K>;
 	for (const key of keys.flat() as K[]) {
 		picked[key] = object[key];
 	}

package/src/string.ts

@@ -1,9 +1,9 @@
 export function capitalize<T extends string>(value: T): Capitalize<T> {
-	return <Capitalize<T>>(value.at(0)!.toUpperCase() + value.slice(1));
+	return (value.at(0)!.toUpperCase() + value.slice(1)) as Capitalize<T>;
 }
 
 export function uncapitalize<T extends string>(value: T): Uncapitalize<T> {
-	return <Uncapitalize<T>>(value.at(0)!.toLowerCase() + value.slice(1));
+	return (value.at(0)!.toLowerCase() + value.slice(1)) as Uncapitalize<T>;
 }
 
 export type ConcatString<T extends string[]> = T extends [infer F extends string, ...infer R extends string[]] ? `${F}${ConcatString<R>}` : '';

package/src/struct.ts

@@ -1,22 +1,8 @@
 import * as primitive from './internal/primitives.js';
-import {
-	checkInstance,
-	checkStruct,
-	DecoratorContext,
-	init,
-	InstanceLike,
-	isStatic,
-	MemberInit,
-	Metadata,
-	metadata,
-	Options,
-	Size,
-	StaticLike,
-	symbol_metadata,
-	type MemberContext,
-} from './internal/struct.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 { capitalize } from './string.js';
-import { ClassLike } from './types.js';
+import type { ClassLike } from './types.js';
 export * as Struct from './internal/struct.js';
 
 /**
@@ -48,12 +34,11 @@ export function align(value: number, alignment: number): number {
  * Decorates a class as a struct
  */
 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 {
 		context.metadata ??= {};
 		context.metadata[init] ||= [];
 		let size = 0;
-		const members = new Map();
+		const members = new Map<string, Member>();
 		for (const _ of context.metadata[init]) {
 			const { name, type, length } = _;
 			if (!primitive.isValid(type) && !isStatic(type)) {
@@ -121,7 +106,7 @@ export function serialize(instance: unknown): Uint8Array {
 			}
 
 			const Type = capitalize(type);
-			const fn = <`set${typeof Type}`>('set' + Type);
+			const fn = ('set' + Type) as `set${typeof Type}`;
 			if (fn == 'setInt64') {
 				view.setBigInt64(iOff, BigInt(value), !options.bigEndian);
 				continue;
@@ -177,7 +162,7 @@ export function deserialize(instance: unknown, _buffer: ArrayBuffer | ArrayBuffe
 			}
 
 			const Type = capitalize(type);
-			const fn = <`get${typeof Type}`>('get' + Type);
+			const fn = ('get' + Type) as `get${typeof Type}`;
 			if (fn == 'getInt64') {
 				object[key] = view.getBigInt64(iOff, !options.bigEndian);
 				continue;

package/src/types.ts

@@ -28,7 +28,7 @@ export type ExtractProperties<T, P> = {
  * Extract the keys of T which are required
  * @see https://stackoverflow.com/a/55247867/17637456
  */
-// eslint-disable-next-line @typescript-eslint/ban-types
+// eslint-disable-next-line @typescript-eslint/no-empty-object-type
 export type RequiredKeys<T> = { [K in keyof T]-?: {} extends { [P in K]: T[K] } ? never : K }[keyof T];
 
 /**