utilium 1.8.0 → 1.10.0

package/dist/misc.d.ts

@@ -9,3 +9,13 @@ export declare function canary(error?: Error): () => void;
  * @see https://github.com/tc39/proposal-throw-expressions
  */
 export declare function _throw(e: unknown): never;
+interface MemoizeMetadata extends DecoratorMetadata {
+    memoized?: Record<PropertyKey, any>;
+}
+/**
+ * Decorator for memoizing the result of a getter.
+ */
+export declare function memoize<T, This>(get: () => T, context: ClassGetterDecoratorContext<This, T> & {
+    metadata?: MemoizeMetadata;
+}): (this: This) => T;
+export {};

package/dist/misc.js

@@ -46,3 +46,20 @@ export function canary(error = new Error()) {
 export function _throw(e) {
     throw e;
 }
+/**
+ * Decorator for memoizing the result of a getter.
+ */
+export function memoize(get, context) {
+    if (context.kind != 'getter')
+        throw new Error('@memoize can only be used on getters');
+    return function () {
+        context.metadata ??= {};
+        const { memoized = {} } = context.metadata;
+        if (context.name in memoized) {
+            console.log('Using cached value for', context.name, JSON.stringify(memoized[context.name]));
+            return memoized[context.name];
+        }
+        memoized[context.name] = get.call(this);
+        return memoized[context.name];
+    };
+}

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/package.json

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

package/src/misc.ts

@@ -52,3 +52,29 @@ export function canary(error: Error = new Error()) {
 export function _throw(e: unknown): never {
 	throw e;
 }
+
+interface MemoizeMetadata extends DecoratorMetadata {
+	memoized?: Record<PropertyKey, any>;
+}
+
+/**
+ * Decorator for memoizing the result of a getter.
+ */
+export function memoize<T, This>(
+	get: () => T,
+	context: ClassGetterDecoratorContext<This, T> & { metadata?: MemoizeMetadata }
+) {
+	if (context.kind != 'getter') throw new Error('@memoize can only be used on getters');
+
+	return function (this: This): T {
+		context.metadata ??= {};
+		const { memoized = {} } = context.metadata;
+
+		if (context.name in memoized) {
+			console.log('Using cached value for', context.name, JSON.stringify(memoized[context.name]));
+			return memoized[context.name];
+		}
+		memoized[context.name] = get.call(this);
+		return memoized[context.name];
+	};
+}

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;
+}