@byloth/core 2.2.6 → 2.2.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@byloth/core",
-  "version": "2.2.6",
+  "version": "2.2.8",
   "description": "An unopinionated collection of useful functions and classes that I use widely in all my projects. 🔧",
   "keywords": [
     "Core",
@@ -49,16 +49,16 @@
   },
   "types": "src/index.ts",
   "devDependencies": {
-    "@byloth/eslint-config-typescript": "^4.0.0",
-    "@eslint/compat": "^2.0.3",
-    "@types/node": "^22.19.15",
-    "@vitest/coverage-v8": "^4.1.2",
-    "eslint": "^10.1.0",
+    "@byloth/eslint-config-typescript": "^4.0.1",
+    "@eslint/compat": "^2.1.0",
+    "@types/node": "^24.12.3",
+    "@vitest/coverage-v8": "^4.1.5",
+    "eslint": "^10.3.0",
     "husky": "^9.1.7",
-    "jsdom": "^29.0.1",
-    "typescript": "^6.0.2",
-    "vite": "^8.0.3",
-    "vitest": "^4.1.2"
+    "jsdom": "^29.1.1",
+    "typescript": "^6.0.3",
+    "vite": "^8.0.11",
+    "vitest": "^4.1.5"
   },
   "scripts": {
     "dev": "vite",

package/src/index.ts

@@ -1,4 +1,4 @@
-export const VERSION = "2.2.6";
+export const VERSION = "2.2.8";
 
 export type { Constructor, Interval, Timeout, ValueOf } from "./core/types.js";
 

package/src/models/callbacks/switchable-callback.ts

@@ -4,6 +4,12 @@ import CallableObject from "./callable-object.js";
 import type { Callback } from "./types.js";
 
 const Disabler = () => { /* ... */ };
+const NotImplemented = () =>
+{
+    throw new NotImplementedException(
+        "The `SwitchableCallback` has no callback defined yet. Did you forget to call the `register` method?"
+    );
+};
 
 /**
  * A class representing a callback that can be switched between multiple implementations.
@@ -123,14 +129,7 @@ export default class SwitchableCallback<T extends Callback<any[], any> = Callbac
         else
         {
             key = "";
-
-            callback = ((() =>
-            {
-                throw new NotImplementedException(
-                    "The `SwitchableCallback` has no callback defined yet. " +
-                    "Did you forget to call the `register` method?"
-                );
-            }) as unknown) as T;
+            callback = (NotImplemented as unknown) as T;
         }
 
         this._key = key;
@@ -318,5 +317,63 @@ export default class SwitchableCallback<T extends Callback<any[], any> = Callbac
         }
     }
 
+    /**
+     * Resets the callback to its initial state, unregistering all the implementations at once.
+     *
+     * After calling this method, the callback will behave as if it had just been constructed:
+     * a {@link NotImplementedException} will be thrown when invoked before registering a new implementation.
+     *
+     * This will also re-enable the object, restoring the {@link SwitchableCallback.isEnabled} state to `true`.
+     *
+     * ---
+     *
+     * @example
+     * ```ts
+     * onPointerMove.reset();
+     * ```
+     */
+    public reset(): void;
+
+    /**
+     * Resets the callback to its initial state, unregistering all the previous
+     * implementations at once and setting the given one as the new default.
+     *
+     * After calling this method, the callback will behave as if it had just
+     * been constructed with the specified implementation enabled by default.
+     *
+     * This will also re-enable the object, restoring the {@link SwitchableCallback.isEnabled} state to `true`.
+     *
+     * ---
+     *
+     * @example
+     * ```ts
+     * onPointerMove.reset((evt) => { [...] });
+     * ```
+     *
+     * ---
+     *
+     * @param callback The callback that will be executed when the object is invoked as a function by default.
+     * @param key The key that is associated by default to the given callback. Default is `default`.
+     */
+    public reset(callback: T, key?: string): void;
+    public reset(callback?: T, key = "default"): void
+    {
+        this._callbacks.clear();
+        this._isEnabled = true;
+
+        if (callback)
+        {
+            this._callbacks.set(key, callback);
+        }
+        else
+        {
+            key = "";
+            callback = (NotImplemented as unknown) as T;
+        }
+
+        this._key = key;
+        this._callback = callback;
+    }
+
     public override readonly [Symbol.toStringTag]: string = "SwitchableCallback";
 }