@codexo/exojs 0.13.0 → 0.14.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@codexo/exojs",
   "description": "A TypeScript-first browser 2D runtime for games and interactive apps.",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "type": "module",
   "files": [
     "dist/esm/",
@@ -39,10 +39,10 @@
       "import": "./dist/esm/extensions/index.js",
       "default": "./dist/esm/extensions/index.js"
     },
-    "./rendering": {
-      "types": "./dist/esm/rendering.d.ts",
-      "import": "./dist/esm/rendering.js",
-      "default": "./dist/esm/rendering.js"
+    "./renderer-sdk": {
+      "types": "./dist/esm/renderer-sdk.d.ts",
+      "import": "./dist/esm/renderer-sdk.js",
+      "default": "./dist/esm/renderer-sdk.js"
     },
     "./debug": {
       "types": "./dist/esm/debug/index.d.ts",
@@ -73,9 +73,11 @@
     "url": "git+https://github.com/Exoridus/ExoJS.git"
   },
   "devDependencies": {
+    "@eslint-react/eslint-plugin": "^5.9.0",
     "@eslint/js": "^10.0.1",
     "@rollup/plugin-node-resolve": "^16.0.3",
     "@rollup/plugin-replace": "^6.0.3",
+    "@rollup/plugin-terser": "^1.0.0",
     "@rollup/plugin-typescript": "^12.3.0",
     "@types/css-font-loading-module": "0.0.14",
     "@types/jsdom": "^28.0.1",
@@ -83,9 +85,11 @@
     "@vitest/browser": "^4.1.7",
     "@vitest/browser-playwright": "^4.1.7",
     "@vitest/coverage-istanbul": "^4.1.7",
+    "@vitest/eslint-plugin": "^1.6.20",
     "@webgpu/types": "^0.1.69",
-    "eslint": "^10.4.1",
+    "eslint": "~10.4.1",
     "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-react-hooks": "^7.1.1",
     "eslint-plugin-security": "^4.0.0",
     "eslint-plugin-simple-import-sort": "^13.0.0",
     "eslint-plugin-unicorn": "^64.0.0",
@@ -96,14 +100,14 @@
     "jiti": "^2.7.0",
     "jsdom": "^29.1.1",
     "playwright": "^1.50.0",
-    "prettier": "3.8.3",
+    "prettier": "3.8.4",
     "rimraf": "^6.1.3",
     "rollup": "^4.60.3",
     "rollup-plugin-string": "^3.0.0",
     "tslib": "^2.8.1",
     "tsx": "^4.21.0",
-    "typescript": "^6.0.3",
-    "typescript-eslint": "^8.60.0",
+    "typescript": "~6.0.3",
+    "typescript-eslint": "~8.60.0",
     "vitest": "^4.1.7",
     "@codexo/exojs-config": "0.0.0"
   },
@@ -115,13 +119,17 @@
     "build:watch": "tsx node_modules/rollup/dist/bin/rollup -cw --environment EXOJS_ENV:development",
     "verify:exports": "tsx ./scripts/verify-exports.ts",
     "verify:package-policy": "tsx ./scripts/verify-package-policy.ts",
+    "verify:publint": "pnpm dlx publint@0.3.21 --strict . && pnpm --filter \"@codexo/exojs-particles\" --filter \"@codexo/exojs-tilemap\" --filter \"@codexo/exojs-tiled\" --filter \"@codexo/exojs-physics\" --filter \"@codexo/exojs-audio-fx\" exec pnpm dlx publint@0.3.21 --strict .",
     "verify:package": "pnpm build && pnpm verify:exports && pnpm pack",
     "verify:lockstep": "tsx ./scripts/verify-lockstep-versions.ts",
     "verify:release-matrix": "tsx ./scripts/verify-release-matrix.ts",
     "verify:create-exo-app": "tsx ./scripts/verify-create-exo-app.ts",
     "sync:example-capabilities": "tsx ./scripts/sync-example-capabilities.ts",
     "verify:release": "pnpm verify:lockstep && pnpm typecheck && pnpm typecheck:guides && pnpm typecheck:examples && pnpm lint:strict && pnpm format:check && pnpm test && pnpm verify:package && pnpm verify:create-exo-app && pnpm site:build",
+    "verify:quick": "pnpm typecheck && pnpm typecheck:guides && pnpm typecheck:examples && pnpm typecheck:packages && pnpm lint:all && pnpm format:check && pnpm docs:api:check",
+    "verify:ci": "pnpm verify:quick && pnpm test",
     "release": "tsx ./scripts/release.ts",
+    "release:cut": "tsx ./scripts/release/cut.ts",
     "release:prepare": "tsx ./scripts/release/run.ts prepare",
     "release:full-zip": "tsx ./scripts/release/run.ts full-zip",
     "release:publish": "tsx ./scripts/release/run.ts publish",
@@ -132,8 +140,10 @@
     "typecheck": "tsc --noEmit",
     "typecheck:examples": "tsc --noEmit -p tsconfig.examples.json",
     "typecheck:guides": "tsx scripts/extract-guide-snippets.ts && tsc --noEmit -p tsconfig.guides.json",
-    "lint": "eslint \"src/**/*.ts\" \"test/**/*.ts\" \"examples/**/*.js\"",
-    "lint:fix": "eslint --fix \"src/**/*.ts\" \"test/**/*.ts\" \"examples/**/*.js\"",
+    "typecheck:packages": "pnpm --filter \"@codexo/exojs-particles\" --filter \"@codexo/exojs-tilemap\" --filter \"@codexo/exojs-tiled\" --filter \"@codexo/exojs-physics\" --filter \"@codexo/exojs-audio-fx\" typecheck",
+    "lint": "eslint \"src/**/*.ts\" \"test/**/*.ts\" \"examples/**/*.js\" \"site/src/**/*.{ts,tsx}\"",
+    "lint:fix": "eslint --fix \"src/**/*.ts\" \"test/**/*.ts\" \"examples/**/*.js\" \"site/src/**/*.{ts,tsx}\"",
+    "site:lint": "eslint \"site/src/**/*.{ts,tsx}\"",
     "lint:packages": "eslint \"packages/exojs-*/src/**/*.ts\" \"packages/exojs-*/test/**/*.ts\"",
     "lint:all": "pnpm lint && pnpm lint:packages",
     "lint:strict": "eslint --max-warnings=0 \"src/**/*.ts\"",
@@ -142,9 +152,9 @@
     "lint:strict:fast:fix": "eslint --cache --cache-location .cache/eslintcache --fix --max-warnings=0 \"src/**/*.ts\"",
     "format": "prettier --write .",
     "format:check": "prettier --check .",
-    "test": "vitest run --project=exojs --project=exojs-particles --project=exojs-tilemap --project=exojs-tiled --project=rendering-perf",
+    "test": "vitest run --project=exojs --project=exojs-particles --project=exojs-tilemap --project=exojs-tiled --project=exojs-physics --project=exojs-audio-fx --project=rendering-perf",
     "test:core": "vitest run --project=exojs",
-    "test:coverage": "vitest run --coverage --project=exojs --project=exojs-particles --project=exojs-tilemap --project=exojs-tiled --project=rendering-perf",
+    "test:coverage": "vitest run --coverage --project=exojs --project=exojs-particles --project=exojs-tilemap --project=exojs-tiled --project=exojs-physics --project=exojs-audio-fx --project=rendering-perf",
     "test:watch": "vitest --project=exojs",
     "test:browser": "pnpm run test:browser:webgl && pnpm run test:browser:webgpu && pnpm run test:browser:webgl:firefox && pnpm run test:browser:webgpu:firefox",
     "test:browser:webgl": "vitest run --project=browser-webgl-chromium",
@@ -162,6 +172,7 @@
     "perf:renderers": "tsx test/perf/rendering/run-sweep.ts full",
     "perf:renderers:quick": "tsx test/perf/rendering/run-sweep.ts quick",
     "perf:renderers:browser": "vitest run --project=browser-webgl-chromium webgl2-renderer-perf",
+    "perf:renderers:alloc": "node --conditions=@codexo/source --import ./scripts/glsl-register.mjs --import tsx/esm test/perf/rendering/run-allocation.ts",
     "perf:bench:rendering": "tsx test/perf/rendering-benchmark.ts",
     "perf:bench:audio": "tsx test/perf/audio-benchmark.ts",
     "perf:bench:collision": "tsx test/perf/collision-benchmark.ts",

package/dist/esm/audio/AbstractMedia.d.ts

@@ -1,75 +0,0 @@
-import { Signal } from '#core/Signal';
-import type { PlaybackOptions } from '#core/types';
-import type { AudioBus } from './AudioBus';
-import type { Media } from './Media';
-/** Initial state passed to the {@link AbstractMedia} constructor by subclasses. */
-export interface AbstractMediaInitialState extends Omit<PlaybackOptions, 'time'> {
-    duration: number;
-}
-/**
- * Shared base for {@link Sound} and {@link Music}: holds playback
- * primitives (volume, loop, playbackRate, muted, currentTime), the
- * {@link AudioBus} routing slot, lifecycle Signals (`onStart`, `onStop`),
- * and ramp helpers ({@link AbstractMedia.fadeIn}, {@link AbstractMedia.fadeOut})
- * that operate on whatever `GainNode` the subclass exposes.
- *
- * Subclasses implement the abstract members to bind to either an
- * `AudioBufferSourceNode` (Sound) or `MediaElementAudioSourceNode` (Music).
- */
-export declare abstract class AbstractMedia implements Media {
-    readonly onStart: Signal<[]>;
-    readonly onStop: Signal<[]>;
-    protected readonly _duration: number;
-    protected _volume: number;
-    protected _playbackRate: number;
-    protected _loop: boolean;
-    protected _muted: boolean;
-    protected _bus: AudioBus | null;
-    abstract get paused(): boolean;
-    abstract set paused(paused: boolean);
-    abstract get analyserTarget(): AudioNode | null;
-    get bus(): AudioBus;
-    set bus(bus: AudioBus);
-    /** Returns the default bus for this media type. Subclasses override. */
-    protected abstract _defaultBus(): AudioBus;
-    protected abstract _disconnectFromBus(): void;
-    protected abstract _connectToBus(): void;
-    get duration(): number;
-    get volume(): number;
-    set volume(volume: number);
-    get loop(): boolean;
-    set loop(loop: boolean);
-    get playbackRate(): number;
-    set playbackRate(playbackRate: number);
-    get currentTime(): number;
-    set currentTime(currentTime: number);
-    get muted(): boolean;
-    set muted(muted: boolean);
-    get progress(): number;
-    get playing(): boolean;
-    set playing(playing: boolean);
-    protected constructor(initialState: AbstractMediaInitialState);
-    abstract play(options?: Partial<PlaybackOptions>): this;
-    abstract pause(options?: Partial<PlaybackOptions>): this;
-    abstract setVolume(volume: number): this;
-    abstract setLoop(loop: boolean): this;
-    abstract setPlaybackRate(playbackRate: number): this;
-    abstract getTime(): number;
-    abstract setTime(time: number): this;
-    abstract setMuted(muted: boolean): this;
-    protected abstract _getAudioSetup(): {
-        audioContext: AudioContext;
-        gainNode: GainNode;
-    } | null;
-    private _scheduledStopId;
-    private _clearScheduledStop;
-    fadeIn(durationMs: number): this;
-    fadeOut(durationMs: number, options?: {
-        stopAfter?: boolean;
-    }): this;
-    stop(options?: Partial<PlaybackOptions>): this;
-    toggle(options?: Partial<PlaybackOptions>): this;
-    applyOptions(options?: Partial<PlaybackOptions>): this;
-    destroy(): void;
-}
-//# sourceMappingURL=AbstractMedia.d.ts.map

package/dist/esm/audio/AbstractMedia.d.ts.map

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

package/dist/esm/audio/AbstractMedia.js

@@ -1,179 +0,0 @@
-import { Signal } from '../core/Signal.js';
-
-/**
- * Shared base for {@link Sound} and {@link Music}: holds playback
- * primitives (volume, loop, playbackRate, muted, currentTime), the
- * {@link AudioBus} routing slot, lifecycle Signals (`onStart`, `onStop`),
- * and ramp helpers ({@link AbstractMedia.fadeIn}, {@link AbstractMedia.fadeOut})
- * that operate on whatever `GainNode` the subclass exposes.
- *
- * Subclasses implement the abstract members to bind to either an
- * `AudioBufferSourceNode` (Sound) or `MediaElementAudioSourceNode` (Music).
- */
-class AbstractMedia {
-    onStart = new Signal();
-    onStop = new Signal();
-    _duration;
-    _volume;
-    _playbackRate;
-    _loop;
-    _muted;
-    _bus = null;
-    get bus() {
-        return this._bus ?? this._defaultBus();
-    }
-    set bus(bus) {
-        if (this._bus === bus)
-            return;
-        this._disconnectFromBus();
-        this._bus = bus;
-        this._connectToBus();
-    }
-    get duration() {
-        return this._duration;
-    }
-    get volume() {
-        return this._volume;
-    }
-    set volume(volume) {
-        this.setVolume(volume);
-    }
-    get loop() {
-        return this._loop;
-    }
-    set loop(loop) {
-        this.setLoop(loop);
-    }
-    get playbackRate() {
-        return this._playbackRate;
-    }
-    set playbackRate(playbackRate) {
-        this.setPlaybackRate(playbackRate);
-    }
-    get currentTime() {
-        return this.getTime();
-    }
-    set currentTime(currentTime) {
-        this.setTime(currentTime);
-    }
-    get muted() {
-        return this._muted;
-    }
-    set muted(muted) {
-        this.setMuted(muted);
-    }
-    get progress() {
-        const elapsed = this.currentTime;
-        const duration = this.duration;
-        return (elapsed % duration) / duration;
-    }
-    get playing() {
-        return !this.paused;
-    }
-    set playing(playing) {
-        if (playing) {
-            this.play();
-        }
-        else {
-            this.pause();
-        }
-    }
-    constructor(initialState) {
-        const { duration, volume, playbackRate, loop, muted } = initialState;
-        this._duration = duration;
-        this._volume = volume;
-        this._playbackRate = playbackRate;
-        this._loop = loop;
-        this._muted = muted;
-    }
-    _scheduledStopId = null;
-    _clearScheduledStop() {
-        if (this._scheduledStopId !== null) {
-            clearTimeout(this._scheduledStopId);
-            this._scheduledStopId = null;
-        }
-    }
-    fadeIn(durationMs) {
-        this._clearScheduledStop();
-        if (durationMs <= 0) {
-            if (this.paused)
-                this.play();
-            return this;
-        }
-        const setup = this._getAudioSetup();
-        if (!setup)
-            return this;
-        if (this.paused)
-            this.play();
-        const ctx = setup.audioContext;
-        const target = this.muted ? 0 : this._volume;
-        const node = setup.gainNode;
-        node.gain.cancelScheduledValues(ctx.currentTime);
-        node.gain.setValueAtTime(0, ctx.currentTime);
-        node.gain.linearRampToValueAtTime(target, ctx.currentTime + durationMs / 1000);
-        return this;
-    }
-    fadeOut(durationMs, options = {}) {
-        const stopAfter = options.stopAfter ?? true;
-        if (durationMs <= 0) {
-            if (stopAfter)
-                this.pause();
-            return this;
-        }
-        const setup = this._getAudioSetup();
-        if (!setup) {
-            if (stopAfter)
-                this.pause();
-            return this;
-        }
-        const ctx = setup.audioContext;
-        const node = setup.gainNode;
-        node.gain.cancelScheduledValues(ctx.currentTime);
-        node.gain.setValueAtTime(node.gain.value, ctx.currentTime);
-        node.gain.linearRampToValueAtTime(0, ctx.currentTime + durationMs / 1000);
-        if (stopAfter) {
-            this._clearScheduledStop();
-            this._scheduledStopId = setTimeout(() => {
-                this._scheduledStopId = null;
-                this.pause();
-            }, durationMs);
-        }
-        return this;
-    }
-    stop(options) {
-        this.pause(options);
-        this.currentTime = 0;
-        return this;
-    }
-    toggle(options) {
-        return this.paused ? this.play(options) : this.pause(options);
-    }
-    applyOptions(options = {}) {
-        const { volume, loop, playbackRate, time, muted } = options;
-        if (volume !== undefined) {
-            this.volume = volume;
-        }
-        if (loop !== undefined) {
-            this.loop = loop;
-        }
-        if (playbackRate !== undefined) {
-            this.playbackRate = playbackRate;
-        }
-        if (time !== undefined) {
-            this.currentTime = time;
-        }
-        if (muted !== undefined) {
-            this.muted = muted;
-        }
-        return this;
-    }
-    destroy() {
-        this._clearScheduledStop();
-        this.stop();
-        this.onStart.destroy();
-        this.onStop.destroy();
-    }
-}
-
-export { AbstractMedia };
-//# sourceMappingURL=AbstractMedia.js.map

package/dist/esm/audio/AbstractMedia.js.map

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

package/dist/esm/audio/AudioAnalyser.d.ts

@@ -1,128 +0,0 @@
-import type { AudioBus } from './AudioBus';
-import type { Music } from './Music';
-import type { Sound } from './Sound';
-export type AudioAnalyserSource = AudioBus | Sound | Music | MediaStream | AudioNode | null;
-/** Construction options for {@link AudioAnalyser}. */
-export interface AudioAnalyserOptions {
-    /** FFT window size; must be a power of two between 32 and 32768. Default 2048. */
-    fftSize?: number;
-    /** Time-domain smoothing constant in 0..1 applied between successive analyses. Default 0.8. */
-    smoothingTimeConstant?: number;
-    /** Minimum dBFS rendered by the byte-domain spectrum getters. Default -100. */
-    minDecibels?: number;
-    /** Maximum dBFS rendered by the byte-domain spectrum getters. Default -30. */
-    maxDecibels?: number;
-    /**
-     * Optional initial source. Equivalent to `analyser.source = value` after
-     * construction; provided for ergonomic one-shot construction. The setter
-     * remains usable for runtime source switches.
-     */
-    source?: AudioAnalyserSource;
-}
-/** Mapping options for {@link AudioAnalyser.getSpectrumMel} and {@link AudioAnalyser.getSpectrumLog}. */
-export interface SpectrumMappingOptions {
-    /** Number of output bands. Default 32. */
-    bands?: number;
-    /** Lower frequency bound in Hz. Default 20. */
-    fMin?: number;
-    /** Upper frequency bound in Hz. Default 20000 (clamped to nyquist at runtime). */
-    fMax?: number;
-}
-/**
- * Lightweight visualisation analyser backed by a Web Audio AnalyserNode.
- *
- * Accepts any of: AudioBus, Sound, Music, MediaStream, AudioNode, or null.
- * The tap is a parallel branch — it does not affect the source's main routing.
- *
- * Migration from 0.7.1: the old constructor was `new AudioAnalyser(media, options)`.
- * The new API is `new AudioAnalyser(options?); analyser.source = media`.
- */
-export declare class AudioAnalyser {
-    private _analyser;
-    private readonly _options;
-    private _source;
-    private _tapSource;
-    private _streamSource;
-    private _pendingSourceSetup;
-    private readonly _onAudioContextReady;
-    private _byteSpectrum;
-    private _floatSpectrum;
-    private _byteWaveform;
-    private _floatWaveform;
-    private _melCache;
-    private _logCache;
-    /**
-     * Create an `AudioAnalyser` with the given options. The underlying
-     * `AnalyserNode` is created immediately if the `AudioContext` is already
-     * running, or deferred until {@link onAudioContextReady} fires.
-     */
-    constructor(options?: AudioAnalyserOptions);
-    /**
-     * The currently tapped audio source, or `null` if none is set.
-     * Assigning a new value disconnects the previous tap and connects the new
-     * source as a parallel branch without affecting the source's main routing.
-     */
-    get source(): AudioAnalyserSource;
-    set source(value: AudioAnalyserSource);
-    get fftSize(): number;
-    /** Number of frequency bins available — half of `fftSize`. */
-    get frequencyBinCount(): number;
-    get smoothingTimeConstant(): number;
-    set smoothingTimeConstant(v: number);
-    get minDecibels(): number;
-    set minDecibels(v: number);
-    get maxDecibels(): number;
-    set maxDecibels(v: number);
-    /** Fill and return the byte frequency spectrum (0..255 per bin). */
-    getSpectrum(into?: Uint8Array<ArrayBuffer>): Uint8Array<ArrayBuffer>;
-    /** Fill and return the float frequency spectrum (dB per bin). */
-    getSpectrumFloat(into?: Float32Array<ArrayBuffer>): Float32Array<ArrayBuffer>;
-    /** Fill and return the byte time-domain waveform (0..255 per sample). */
-    getWaveform(into?: Uint8Array<ArrayBuffer>): Uint8Array<ArrayBuffer>;
-    /** Fill and return the float time-domain waveform (-1..1 per sample). */
-    getWaveformFloat(into?: Float32Array<ArrayBuffer>): Float32Array<ArrayBuffer>;
-    /**
-     * Return the mean energy of frequency bins in the given Hz range, normalised 0..1.
-     * Uses the byte spectrum (0..255), normalised by dividing by 255.
-     */
-    getBandEnergy(fromHz: number, toHz: number): number;
-    /** Return low (0-250 Hz), mid (250-2 kHz), and high (2 k-20 kHz) band energies (0..1 each). */
-    getLowMidHigh(): {
-        low: number;
-        mid: number;
-        high: number;
-    };
-    /** Return overall RMS energy across all bins, normalised 0..1. */
-    getRms(): number;
-    /**
-     * Mel-scaled spectrum, byte domain (0..255). Output length = `bands`.
-     * Each output bin is a triangular-weighted sum of the linear FFT bins
-     * underneath it, mel-spaced from `fMin` to `fMax`.
-     */
-    getSpectrumMel(into?: Uint8Array<ArrayBuffer>, options?: SpectrumMappingOptions): Uint8Array<ArrayBuffer>;
-    /** Mel-scaled spectrum, float domain (dBFS values). Output length = `bands`. */
-    getSpectrumMelFloat(into?: Float32Array<ArrayBuffer>, options?: SpectrumMappingOptions): Float32Array<ArrayBuffer>;
-    /**
-     * Log-scaled spectrum, byte domain (0..255). Output length = `bands`.
-     * Bins are spaced so each output covers an equal fraction of the
-     * `log2(fMax / fMin)` octave range — useful when you want a
-     * frequency-axis visualization where each octave gets the same width.
-     */
-    getSpectrumLog(into?: Uint8Array<ArrayBuffer>, options?: SpectrumMappingOptions): Uint8Array<ArrayBuffer>;
-    /** Log-scaled spectrum, float domain (dBFS values). Output length = `bands`. */
-    getSpectrumLogFloat(into?: Float32Array<ArrayBuffer>, options?: SpectrumMappingOptions): Float32Array<ArrayBuffer>;
-    /**
-     * Disconnect the analyser tap, release the internal `AnalyserNode`, and
-     * cancel any pending setup callbacks. Call when the analyser is no longer
-     * needed to avoid memory leaks.
-     */
-    destroy(): void;
-    private _getMelFilterbank;
-    private _getLogRanges;
-    private _setupAnalyser;
-    private _connectSource;
-    private _resolveToAudioNode;
-    private _deferConnectionViaBus;
-    private _disconnectTap;
-}
-//# sourceMappingURL=AudioAnalyser.d.ts.map

package/dist/esm/audio/AudioAnalyser.d.ts.map

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