adaptive-extender 0.9.13 → 0.10.1

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## 0.10.1 (02.06.2026)
+- Vitest vulnerability fixed.
+
+## 0.10.0 (20.05.2026)
+- Added `adaptive-extender/worker` package for Web Worker environments. Includes [promise](./src/worker/promise.ts) and [engine](./src/worker/engine.ts) modules.
+
 ## 0.9.13 (06.04.2026)
 - Added `Version` class for semantic versioning with `parse()`, `tryParse()` support.
 - Added `BigInt` portable support via `BigInt.import()` and `BigInt.export()`.

package/README.md

@@ -17,18 +17,20 @@ npm install adaptive-extender
 
 ## Packages
 
-| Package                  | Environment             |
-| :----------------------- | :---------------------- |
-| `adaptive-extender/core` | Browser, Node.js, Deno  |
-| `adaptive-extender/node` | Node.js (includes core) |
-| `adaptive-extender/web`  | Browser (includes core) |
+| Package                    | Environment                |
+| :------------------------- | :------------------------- |
+| `adaptive-extender/core`   | Browser, Node.js, Deno     |
+| `adaptive-extender/node`   | Node.js (includes core)    |
+| `adaptive-extender/web`    | Browser (includes core)    |
+| `adaptive-extender/worker` | Web Worker (includes core) |
 
 - - -
 
 ```typescript
 // Import once — extensions are active everywhere
 import "adaptive-extender/core";
-import "adaptive-extender/web"; // Browser only
+import "adaptive-extender/web";    // Browser only
+import "adaptive-extender/worker"; // Web Worker only
 ```
 
 ## Native Extensions

package/dist/worker/engine.d.ts

@@ -0,0 +1,83 @@
+import "../core/index.js";
+import { type Engine } from "../core/index.js";
+interface WebWorkersEngineEventMap {
+    "trigger": Event;
+    "change": Event;
+}
+export interface WebWorkersEngineOptions {
+    launch: boolean;
+}
+/**
+ * Represents the base class for web-workers-based engines.
+ */
+export declare abstract class WebWorkersEngine extends EventTarget implements Engine {
+    #private;
+    /**
+     * Gets a value indicating whether the engine is running.
+     */
+    get launched(): boolean;
+    /**
+     * Sets a value indicating whether the engine is running.
+     */
+    set launched(value: boolean);
+    /**
+     * Gets the target frame rate limit for the engine.
+     */
+    get limit(): number;
+    /**
+     * Sets the target frame rate limit for the engine.
+     */
+    set limit(value: number);
+    /**
+     * Gets the current frames per second (FPS) of the engine.
+     * @throws {ImplementationError} If the method is not implemented in a derived class.
+     */
+    get fps(): number;
+    /**
+     * Gets the time elapsed between the current and previous frame, in seconds.
+     * @throws {ImplementationError} If the method is not implemented in a derived class.
+     */
+    get delta(): number;
+    /**
+     * @throws {TypeError} If this constructor is called directly on the `WebWorkersEngine` class.
+     */
+    constructor();
+    /**
+     * @param options An object that specifies options for the engine.
+     * @throws {TypeError} If this constructor is called directly on the `WebWorkersEngine` class.
+     */
+    constructor(options: Partial<WebWorkersEngineOptions>);
+    addEventListener<K extends keyof WebWorkersEngineEventMap>(type: K, listener: (this: this, ev: WebWorkersEngineEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+    addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+    removeEventListener<K extends keyof WebWorkersEngineEventMap>(type: K, listener: (this: WebWorkersEngine, ev: WebWorkersEngineEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+    removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+}
+/**
+ * A variable frame rate engine.
+ */
+export declare class PreciseEngine extends WebWorkersEngine {
+    #private;
+    get fps(): number;
+    get delta(): number;
+    constructor();
+    /**
+     * @param options An object that specifies options for the engine.
+     */
+    constructor(options: Partial<WebWorkersEngineOptions>);
+}
+/**
+ * A fixed frame rate engine.
+ */
+export declare class StaticEngine extends WebWorkersEngine {
+    #private;
+    get limit(): number;
+    set limit(value: number);
+    get fps(): number;
+    get delta(): number;
+    constructor();
+    /**
+     * @param options An object that specifies options for the engine.
+     */
+    constructor(options: Partial<WebWorkersEngineOptions>);
+}
+export {};

package/dist/worker/engine.js

@@ -0,0 +1,144 @@
+"use strict";
+import "../core/index.js";
+import { ImplementationError } from "../core/index.js";
+const { trunc } = Math;
+/**
+ * Represents the base class for web-workers-based engines.
+ */
+export class WebWorkersEngine extends EventTarget {
+    #launched;
+    /**
+     * Gets a value indicating whether the engine is running.
+     */
+    get launched() {
+        return this.#launched;
+    }
+    /**
+     * Sets a value indicating whether the engine is running.
+     */
+    set launched(value) {
+        if (this.#launched === value)
+            return;
+        this.#launched = value;
+        this.dispatchEvent(new Event("change"));
+    }
+    #gap = 0;
+    /**
+     * Gets the target frame rate limit for the engine.
+     */
+    get limit() {
+        return 1000 / this.#gap;
+    }
+    /**
+     * Sets the target frame rate limit for the engine.
+     */
+    set limit(value) {
+        if (Number.isNaN(value))
+            return;
+        if (value <= 0)
+            return;
+        this.#gap = 1000 / value;
+    }
+    /**
+     * Gets the current frames per second (FPS) of the engine.
+     * @throws {ImplementationError} If the method is not implemented in a derived class.
+     */
+    get fps() {
+        throw new ImplementationError();
+    }
+    /**
+     * Gets the time elapsed between the current and previous frame, in seconds.
+     * @throws {ImplementationError} If the method is not implemented in a derived class.
+     */
+    get delta() {
+        throw new ImplementationError();
+    }
+    constructor(options = {}) {
+        super();
+        if (new.target === WebWorkersEngine)
+            throw new TypeError("Unable to create an instance of an abstract class");
+        const { launch } = options;
+        this.#launched = launch ?? false;
+    }
+    addEventListener(type, listener, options) {
+        return super.addEventListener(type, listener, options);
+    }
+    removeEventListener(type, listener, options) {
+        return super.removeEventListener(type, listener, options);
+    }
+}
+//#endregion
+//#region Precise engine
+/**
+ * A variable frame rate engine.
+ */
+export class PreciseEngine extends WebWorkersEngine {
+    #fps = 0;
+    get fps() {
+        return this.#fps;
+    }
+    get delta() {
+        return 1 / this.#fps;
+    }
+    #previous;
+    constructor(options = {}) {
+        super(options);
+        this.#previous = performance.now();
+        setTimeout(this.#callback, 1000 / this.limit);
+    }
+    ;
+    #callback = () => {
+        const current = performance.now();
+        const difference = current - this.#previous;
+        if (this.launched) {
+            this.#fps = (1000 / difference);
+            this.dispatchEvent(new Event("trigger"));
+        }
+        else {
+            this.#fps = 0;
+        }
+        this.#previous = current;
+        setTimeout(this.#callback, 1000 / this.limit);
+    };
+}
+//#endregion
+//#region Static engine
+/**
+ * A fixed frame rate engine.
+ */
+export class StaticEngine extends WebWorkersEngine {
+    get limit() {
+        return super.limit;
+    }
+    set limit(value) {
+        super.limit = value;
+        this.#fps = value;
+    }
+    #fps = 0;
+    get fps() {
+        return this.#fps;
+    }
+    get delta() {
+        return 1 / this.#fps;
+    }
+    #previous = 0;
+    constructor(options = {}) {
+        super(options);
+        super.limit = 120;
+        this.#previous = 0;
+        setTimeout(this.#callback);
+    }
+    #callback = () => {
+        const difference = performance.now() - this.#previous;
+        const delta = 1000 / this.limit;
+        const count = trunc(difference / delta);
+        this.#fps = (1000 * count) / difference;
+        for (let index = 0; index < count; index++) {
+            if (this.launched)
+                this.dispatchEvent(new Event("trigger"));
+            this.#previous += count * delta;
+        }
+        setTimeout(this.#callback);
+    };
+}
+//# sourceMappingURL=engine.js.map

package/dist/worker/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../../src/worker/engine.ts"],"names":[],"mappings":"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"}

package/dist/worker/index.d.ts

@@ -0,0 +1,3 @@
+export * from "../core/index.js";
+export * from "./promise.js";
+export * from "./engine.js";

package/dist/worker/index.js

@@ -0,0 +1,5 @@
+"use strict";
+export * from "../core/index.js";
+export * from "./promise.js";
+export * from "./engine.js";
+//# sourceMappingURL=index.js.map

package/dist/worker/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/worker/index.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC"}

package/dist/worker/promise.d.ts

@@ -0,0 +1,16 @@
+import "../core/index.js";
+import { type Promisable } from "../core/index.js";
+declare global {
+    export interface PromiseConstructor {
+        /**
+         * Creates a promise that resolves after the specified timeout.
+         * @param timeout The timeout in milliseconds.
+         */
+        asTimeout(timeout: number): Promise<void>;
+        /**
+         * Creates a promise that can be controlled with an abort signal.
+         * @param callback The callback to execute with an abort signal, resolve, and reject functions.
+         */
+        withSignal<T = void>(callback: (signal: AbortSignal, resolve: (value: Promisable<T>) => void, reject: (reason?: any) => void) => void): Promise<T>;
+    }
+}

package/dist/worker/promise.js

@@ -0,0 +1,24 @@
+"use strict";
+import "../core/index.js";
+import {} from "../core/index.js";
+Promise.asTimeout = async function (timeout) {
+    let index;
+    try {
+        return await new Promise((resolve) => {
+            index = setTimeout(resolve, timeout);
+        });
+    }
+    finally {
+        clearTimeout(index);
+    }
+};
+Promise.withSignal = async function (callback) {
+    const controller = new AbortController();
+    try {
+        return await new Promise((resolve, reject) => callback(controller.signal, resolve, reject));
+    }
+    finally {
+        controller.abort();
+    }
+};
+//# sourceMappingURL=promise.js.map

package/dist/worker/promise.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"promise.js","sourceRoot":"","sources":["../../src/worker/promise.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAmB,MAAM,kBAAkB,CAAC;AAkBnD,OAAO,CAAC,SAAS,GAAG,KAAK,WAAW,OAAe;IAClD,IAAI,KAAyB,CAAC;IAC9B,IAAI,CAAC;QACJ,OAAO,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YACpC,KAAK,GAAG,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACtC,CAAC,CAAC,CAAC;IACJ,CAAC;YAAS,CAAC;QACV,YAAY,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;AACF,CAAC,CAAC;AAEF,OAAO,CAAC,UAAU,GAAG,KAAK,WAAqB,QAAgH;IAC9J,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,IAAI,CAAC;QACJ,OAAO,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;IAC7F,CAAC;YAAS,CAAC;QACV,UAAU,CAAC,KAAK,EAAE,CAAC;IACpB,CAAC;AACF,CAAC,CAAC"}

package/package.json

@@ -1,44 +1,65 @@
 {
 	"name": "adaptive-extender",
-	"version": "0.9.13",
+	"version": "0.10.1",
 	"description": "Adaptive library for JS/TS development environments",
 	"type": "module",
 	"main": "./dist/core/index.js",
 	"types": "./dist/core/index.d.ts",
 	"typesVersions": {
 		"*": {
-			"core": [ "dist/core/index.d.ts" ],
-			"node": [ "dist/node/index.d.ts" ],
-			"web": [ "dist/web/index.d.ts" ]
+			"core": [
+				"dist/core/index.d.ts"
+			],
+			"node": [
+				"dist/node/index.d.ts"
+			],
+			"web": [
+				"dist/web/index.d.ts"
+			],
+			"worker": [
+				"dist/worker/index.d.ts"
+			]
 		}
 	},
 	"exports": {
 		".": {
+			"types": "./dist/core/index.d.ts",
 			"import": "./dist/core/index.js",
-			"require": "./dist/core/index.js",
-			"types": "./dist/core/index.d.ts"
+			"require": "./dist/core/index.js"
 		},
 		"./core": {
+			"types": "./dist/core/index.d.ts",
 			"import": "./dist/core/index.js",
-			"require": "./dist/core/index.js",
-			"types": "./dist/core/index.d.ts"
+			"require": "./dist/core/index.js"
 		},
 		"./node": {
+			"types": "./dist/node/index.d.ts",
 			"import": "./dist/node/index.js",
-			"require": "./dist/node/index.js",
-			"types": "./dist/node/index.d.ts"
+			"require": "./dist/node/index.js"
 		},
 		"./web": {
+			"types": "./dist/web/index.d.ts",
 			"import": "./dist/web/index.js",
-			"require": "./dist/web/index.js",
-			"types": "./dist/web/index.d.ts"
+			"require": "./dist/web/index.js"
+		},
+		"./worker": {
+			"types": "./dist/worker/index.d.ts",
+			"import": "./dist/worker/index.js",
+			"require": "./dist/worker/index.js"
 		}
 	},
 	"repository": {
 		"type": "git",
 		"url": "git+https://github.com/eccs0103/adaptive-extender.git"
 	},
-	"keywords": [ "javascript", "typescript", "extensions", "core", "dom", "node" ],
+	"keywords": [
+		"javascript",
+		"typescript",
+		"extensions",
+		"core",
+		"dom",
+		"node"
+	],
 	"author": "eccs0103",
 	"license": "Apache-2.0",
 	"bugs": {
@@ -49,15 +70,18 @@
 		"build:core": "tsc -p ./src/core/tsconfig.json",
 		"build:node": "tsc -p ./src/node/tsconfig.json",
 		"build:web": "tsc -p ./src/web/tsconfig.json",
-		"build": "npm run build:core && npm run build:node && npm run build:web",
-
+		"build:worker": "tsc -p ./src/worker/tsconfig.json",
+		"build": "npm run build:core && npm run build:node && npm run build:web && npm run build:worker",
 		"test": "vitest run",
 		"coverage": "vitest run --coverage"
 	},
 	"devDependencies": {
+		"@babel/plugin-proposal-decorators": "^7.29.7",
+		"@rolldown/plugin-babel": "^0.2.3",
 		"@types/jsdom": "^21.1.7",
+		"esbuild": "^0.28.0",
 		"jsdom": "^27.0.0",
-		"typescript": "^5.9.2",
-		"vitest": "^3.2.4"
+		"typescript": "^6.0.3",
+		"vitest": "^4.1.8"
 	}
 }