@codexo/exojs 0.6.2 → 0.6.4

package/README.md

@@ -1,156 +1,156 @@
-# ExoJS
-
-ExoJS is a TypeScript-first 2D runtime for browser games and interactive apps. It is designed around explicit scene flow, practical rendering features, and predictable runtime behavior.
-
-## Project status
-
-ExoJS is **pre-1.0**. The public API is still under active design — scene graph, rendering pipeline, and resource lifecycle boundaries may change between minor versions. Pin exact versions in downstream experiments. `1.0.0` will mark the first stable API contract.
-
-## Why ExoJS
-
-- TypeScript-first API surface with strong runtime contracts
-- Scene and asset workflows built for real game loops
-- Modern rendering stack: WebGPU-first with WebGL2 fallback
-- Practical visuals: filters, masks, render passes, cache-as-bitmap
-- Gameplay tools: animated sprites, scene stacking, camera helpers, audio sprites
-- Performance visibility with built-in render stats and benchmark harness
-- Optional Rapier physics integration without forcing physics on every app
-
-## What Is Shipped Today
-
-- `Application`, `Scene`, and scene-manager lifecycle
-- Typed `Loader` with manifest/bundle workflow (`defineAssetManifest`, `registerManifest`, `loadBundle`)
-- Drawables: `Sprite`, `AnimatedSprite`, `Graphics`, `ParticleSystem`, `Text`, `Video`
-- Scene stacking (`overlay` / `modal` / `opaque`) with input routing and fade transitions
-- View/camera helpers (`follow`, bounds clamp, shake, zoom)
-- Rendering composition primitives (`RenderTexture`, `RenderTargetPass`, filter chains, visual masks, cache-as-bitmap)
-- Render stats (`submittedNodes`, `culledNodes`, `drawCalls`, `batches`, `renderPasses`, ...)
-- Optional Rapier adapter (`createRapierPhysicsWorld`)
-
-## Installation
-
-```bash
-npm install @codexo/exojs
-```
-
-ExoJS currently publishes an ESM-first package shape. Use `import` syntax with modern bundlers/runtime tooling.
-CommonJS `require()` usage is not part of the supported contract for this pre-1.0 line.
-
-## Quickstart
-
-```ts
-import { Application, Scene, Graphics, Color, type RenderBackend } from '@codexo/exojs';
-
-class HelloScene extends Scene {
-    private readonly box = new Graphics();
-
-    public constructor() {
-        super();
-
-        this.box.fillColor = Color.white;
-        this.box.drawRectangle(-32, -32, 64, 64);
-        this.box.setPosition(400, 300);
-
-        this.addChild(this.box);
-    }
-
-    public override update(delta: import('@codexo/exojs').Time): void {
-        this.box.rotation += delta.seconds * 45;
-    }
-
-    public override draw(backend: RenderBackend): void {
-        this.root.render(backend);
-    }
-}
-
-const canvas = document.querySelector('canvas');
-
-if (!canvas) {
-    throw new Error('Missing <canvas> element.');
-}
-
-const app = new Application({
-    canvas,
-    width: 800,
-    height: 600,
-    clearColor: Color.cornflowerBlue,
-});
-
-await app.start(new HelloScene());
-```
-
-## Next Steps
-
-- In-repo examples: [examples/README.md](examples/README.md)
-
-## WebGPU and WebGL2
-
-`Application` defaults to backend auto-selection:
-
-- prefers WebGPU when available
-- falls back to WebGL2 if WebGPU is unavailable or initialization fails
-
-You can force backend selection when needed:
-
-```ts
-new Application({ backend: { type: 'webgpu' } });
-new Application({ backend: { type: 'webgl2' } });
-new Application({ backend: { type: 'auto' } });
-```
-
-## Optional Rapier Physics
-
-Rapier integration is opt-in and loaded only when you use it.
-
-```ts
-import { createRapierPhysicsWorld } from '@codexo/exojs';
-
-const physics = await createRapierPhysicsWorld({ gravityY: 9.81 });
-```
-
-If Rapier is unavailable, creation fails with a clear setup error.
-
-### Physics scope policy
-
-ExoJS ships **one** physics adapter: Rapier. The integration is intentionally
-narrow:
-
-- Physics is **optional**. `@dimforge/rapier2d-compat` is a peer dependency
-  marked `optional`. Apps that do not call `createRapierPhysicsWorld` never
-  load it and never pay for it at runtime.
-- Rendering, application, and core scene code **do not** depend on physics.
-  The adapter binds Rapier bodies to scene nodes from the outside; the core
-  has no knowledge of physics.
-- ExoJS is **not** a physics-engine abstraction layer. There is no
-  `PhysicsWorld` interface that spans multiple backends, and no plan to
-  add one. If you need a different physics library, integrate it directly
-  in your app code without library involvement.
-- A second physics adapter (Box2D, Matter.js, Planck, etc.) is **not** on
-  the 1.0 roadmap and will not be accepted as a contribution. The honesty
-  rule that applies to rendering backends applies here too: one chosen
-  physics, not a fake-universal physics layer.
-
-For full integration details see [docs/physics/rapier-integration.md](docs/physics/rapier-integration.md).
-
-## Examples
-
-The runnable live site (Astro + Lit + Monaco preview) lives in [`examples/`](examples/README.md) and is deployed as the repository's GitHub Pages site at <https://exoridus.github.io/ExoJS/>.
-
-## Development
-
-```bash
-npm run typecheck
-npm run lint
-npm test
-npm run build
-npm run verify:package
-npm run perf:benchmark
-```
-
-Internal imports use the `@/*` path alias (mapped to `src/*`) — the same convention used by Vite, Next.js, and other modern TypeScript setups. Building the library requires TypeScript 6.
-
-## Links
-
-- Repository: <https://github.com/Exoridus/ExoJS>
-- Issues: <https://github.com/Exoridus/ExoJS/issues>
-- Changelog: [CHANGELOG.md](CHANGELOG.md)
+# ExoJS
+
+ExoJS is a TypeScript-first 2D runtime for browser games and interactive apps. It is designed around explicit scene flow, practical rendering features, and predictable runtime behavior.
+
+## Project status
+
+ExoJS is **pre-1.0**. The public API is still under active design — scene graph, rendering pipeline, and resource lifecycle boundaries may change between minor versions. Pin exact versions in downstream experiments. `1.0.0` will mark the first stable API contract.
+
+## Why ExoJS
+
+- TypeScript-first API surface with strong runtime contracts
+- Scene and asset workflows built for real game loops
+- Modern rendering stack: WebGPU-first with WebGL2 fallback
+- Practical visuals: filters, masks, render passes, cache-as-bitmap
+- Gameplay tools: animated sprites, scene stacking, camera helpers, audio sprites
+- Performance visibility with built-in render stats and benchmark harness
+- Optional Rapier physics integration without forcing physics on every app
+
+## What Is Shipped Today
+
+- `Application`, `Scene`, and scene-manager lifecycle
+- Typed `Loader` with manifest/bundle workflow (`defineAssetManifest`, `registerManifest`, `loadBundle`)
+- Drawables: `Sprite`, `AnimatedSprite`, `Graphics`, `ParticleSystem`, `Text`, `Video`
+- Scene stacking (`overlay` / `modal` / `opaque`) with input routing and fade transitions
+- View/camera helpers (`follow`, bounds clamp, shake, zoom)
+- Rendering composition primitives (`RenderTexture`, `RenderTargetPass`, filter chains, visual masks, cache-as-bitmap)
+- Render stats (`submittedNodes`, `culledNodes`, `drawCalls`, `batches`, `renderPasses`, ...)
+- Optional Rapier adapter (`createRapierPhysicsWorld`)
+
+## Installation
+
+```bash
+npm install @codexo/exojs
+```
+
+ExoJS currently publishes an ESM-first package shape. Use `import` syntax with modern bundlers/runtime tooling.
+CommonJS `require()` usage is not part of the supported contract for this pre-1.0 line.
+
+## Quickstart
+
+```ts
+import { Application, Scene, Graphics, Color, type RenderBackend } from '@codexo/exojs';
+
+class HelloScene extends Scene {
+    private readonly box = new Graphics();
+
+    public constructor() {
+        super();
+
+        this.box.fillColor = Color.white;
+        this.box.drawRectangle(-32, -32, 64, 64);
+        this.box.setPosition(400, 300);
+
+        this.addChild(this.box);
+    }
+
+    public override update(delta: import('@codexo/exojs').Time): void {
+        this.box.rotation += delta.seconds * 45;
+    }
+
+    public override draw(backend: RenderBackend): void {
+        this.root.render(backend);
+    }
+}
+
+const canvas = document.querySelector('canvas');
+
+if (!canvas) {
+    throw new Error('Missing <canvas> element.');
+}
+
+const app = new Application({
+    canvas,
+    width: 800,
+    height: 600,
+    clearColor: Color.cornflowerBlue,
+});
+
+await app.start(new HelloScene());
+```
+
+## Next Steps
+
+- In-repo examples: [examples/README.md](examples/README.md)
+
+## WebGPU and WebGL2
+
+`Application` defaults to backend auto-selection:
+
+- prefers WebGPU when available
+- falls back to WebGL2 if WebGPU is unavailable or initialization fails
+
+You can force backend selection when needed:
+
+```ts
+new Application({ backend: { type: 'webgpu' } });
+new Application({ backend: { type: 'webgl2' } });
+new Application({ backend: { type: 'auto' } });
+```
+
+## Optional Rapier Physics
+
+Rapier integration is opt-in and loaded only when you use it.
+
+```ts
+import { createRapierPhysicsWorld } from '@codexo/exojs';
+
+const physics = await createRapierPhysicsWorld({ gravityY: 9.81 });
+```
+
+If Rapier is unavailable, creation fails with a clear setup error.
+
+### Physics scope policy
+
+ExoJS ships **one** physics adapter: Rapier. The integration is intentionally
+narrow:
+
+- Physics is **optional**. `@dimforge/rapier2d-compat` is a peer dependency
+  marked `optional`. Apps that do not call `createRapierPhysicsWorld` never
+  load it and never pay for it at runtime.
+- Rendering, application, and core scene code **do not** depend on physics.
+  The adapter binds Rapier bodies to scene nodes from the outside; the core
+  has no knowledge of physics.
+- ExoJS is **not** a physics-engine abstraction layer. There is no
+  `PhysicsWorld` interface that spans multiple backends, and no plan to
+  add one. If you need a different physics library, integrate it directly
+  in your app code without library involvement.
+- A second physics adapter (Box2D, Matter.js, Planck, etc.) is **not** on
+  the 1.0 roadmap and will not be accepted as a contribution. The honesty
+  rule that applies to rendering backends applies here too: one chosen
+  physics, not a fake-universal physics layer.
+
+For full integration details see [docs/physics/rapier-integration.md](docs/physics/rapier-integration.md).
+
+## Examples
+
+The runnable live site (Astro + Lit + Monaco preview) lives in [`examples/`](examples/README.md) and is deployed as the repository's GitHub Pages site at <https://exoridus.github.io/ExoJS/>.
+
+## Development
+
+```bash
+npm run typecheck
+npm run lint
+npm test
+npm run build
+npm run verify:package
+npm run perf:benchmark
+```
+
+Internal imports use the `@/*` path alias (mapped to `src/*`) — the same convention used by Vite, Next.js, and other modern TypeScript setups. Building the library requires TypeScript 6.
+
+## Links
+
+- Repository: <https://github.com/Exoridus/ExoJS>
+- Issues: <https://github.com/Exoridus/ExoJS/issues>
+- Changelog: [CHANGELOG.md](CHANGELOG.md)

package/dist/esm/core/Application.d.ts

@@ -1,3 +1,4 @@
+import { Capabilities } from './capabilities';
 import { SceneManager } from './SceneManager';
 import { InputManager } from '@/input/InputManager';
 import { Loader } from '@/resources/Loader';
@@ -57,6 +58,7 @@ export declare class Application {
     private _frameRequest;
     private _backendType;
     private _backend;
+    private _capabilities;
     constructor(appSettings?: Partial<ApplicationOptions>);
     get status(): ApplicationStatus;
     get startupTime(): Time;
@@ -64,6 +66,12 @@ export declare class Application {
     get frameTime(): Time;
     get frameCount(): number;
     get backend(): RenderBackend;
+    /**
+     * Resolved capabilities for the host browser. Available after
+     * {@link Application.start} resolves; reading before that throws.
+     * For pre-start access use {@link Capabilities.ready} directly.
+     */
+    get capabilities(): Capabilities;
     start(scene: Scene): Promise<this>;
     update(): this;
     stop(): this;

package/dist/esm/core/Application.js

@@ -1,3 +1,4 @@
+import { Capabilities } from './capabilities.js';
 import { Clock } from './Clock.js';
 import { SceneManager } from './SceneManager.js';
 import { WebGl2Backend } from '../rendering/webgl2/WebGl2Backend.js';
@@ -59,6 +60,7 @@ class Application {
     _frameRequest = 0;
     _backendType;
     _backend;
+    _capabilities = null;
     constructor(appSettings) {
         this.options = {
             canvas: appSettings?.canvas ?? createDefaultCanvas(),
@@ -100,11 +102,26 @@ class Application {
     get backend() {
         return this._backend;
     }
+    /**
+     * Resolved capabilities for the host browser. Available after
+     * {@link Application.start} resolves; reading before that throws.
+     * For pre-start access use {@link Capabilities.ready} directly.
+     */
+    get capabilities() {
+        if (this._capabilities === null) {
+            throw new Error('Application.capabilities is unavailable before start() resolves. Use `await Capabilities.ready` for pre-start checks.');
+        }
+        return this._capabilities;
+    }
     async start(scene) {
         if (this._status === ApplicationStatus.Stopped) {
             this._status = ApplicationStatus.Loading;
+            // Kick off capability detection in parallel with renderer init —
+            // both are mostly-async startup work, no point serializing them.
+            const capabilitiesPromise = Capabilities.ready;
             try {
                 await this.initializeRenderManager();
+                this._capabilities = await capabilitiesPromise;
                 await this.sceneManager.setScene(scene);
                 this._frameRequest = requestAnimationFrame(this._updateHandler);
                 this._frameClock.restart();

package/dist/esm/core/Application.js.map

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

package/dist/esm/core/capabilities.d.ts

@@ -0,0 +1,38 @@
+export declare class Capabilities {
+    private static _readyPromise;
+    /**
+     * Lazy-cached Promise that resolves to a frozen Capabilities instance.
+     *
+     * The first read kicks off the async probes (currently just the WebGPU
+     * adapter request); every subsequent read returns the same Promise.
+     * Concurrent callers share the in-flight detection — no double work.
+     *
+     * Early-warmup pattern for callers who want to overlap detection with
+     * other startup work:
+     *
+     * ```ts
+     * void Capabilities.ready;          // fire-and-forget; starts probes now
+     * // ... unrelated bootstrap ...
+     * const caps = await Capabilities.ready;  // typically already resolved
+     * ```
+     */
+    static get ready(): Promise<Capabilities>;
+    readonly webgl2: boolean;
+    readonly webgpu: boolean;
+    readonly webgpuAdapter: GPUAdapter | null;
+    readonly webgpuVendor: string | null;
+    readonly webgpuArchitecture: string | null;
+    readonly pointer: boolean;
+    readonly keyboard: boolean;
+    readonly gamepad: boolean;
+    readonly touch: boolean;
+    readonly maxTouchPoints: number;
+    readonly audio: boolean;
+    readonly fullscreen: boolean;
+    readonly vibration: boolean;
+    readonly offscreenCanvas: boolean;
+    readonly webWorkers: boolean;
+    readonly devicePixelRatio: number;
+    private constructor();
+    private static _detect;
+}

package/dist/esm/core/capabilities.js

@@ -0,0 +1,198 @@
+/// <reference types="@webgpu/types" />
+// Browser-environment feature detection. Construction is private; the
+// only public entry is `Capabilities.ready`, a lazy-cached `Promise<Capabilities>`
+// that fires the (mostly) async probes on first access and returns the
+// same Promise for every subsequent call. Once it resolves, the returned
+// instance is frozen — every property is read once and never mutates.
+//
+// Synchronous callsites should keep the resolved instance in scope (e.g.,
+// `app.capabilities` after `await app.start(...)`); there is no global
+// sync mirror, by design.
+const hasWindow = typeof window !== 'undefined';
+const hasDocument = typeof document !== 'undefined';
+const hasNavigator = typeof navigator !== 'undefined';
+class Capabilities {
+    static _readyPromise = null;
+    /**
+     * Lazy-cached Promise that resolves to a frozen Capabilities instance.
+     *
+     * The first read kicks off the async probes (currently just the WebGPU
+     * adapter request); every subsequent read returns the same Promise.
+     * Concurrent callers share the in-flight detection — no double work.
+     *
+     * Early-warmup pattern for callers who want to overlap detection with
+     * other startup work:
+     *
+     * ```ts
+     * void Capabilities.ready;          // fire-and-forget; starts probes now
+     * // ... unrelated bootstrap ...
+     * const caps = await Capabilities.ready;  // typically already resolved
+     * ```
+     */
+    static get ready() {
+        if (Capabilities._readyPromise === null) {
+            Capabilities._readyPromise = Capabilities._detect();
+        }
+        return Capabilities._readyPromise;
+    }
+    webgl2;
+    webgpu;
+    webgpuAdapter;
+    webgpuVendor;
+    webgpuArchitecture;
+    pointer;
+    keyboard;
+    gamepad;
+    touch;
+    maxTouchPoints;
+    audio;
+    fullscreen;
+    vibration;
+    offscreenCanvas;
+    webWorkers;
+    devicePixelRatio;
+    constructor(values) {
+        this.webgl2 = values.webgl2;
+        this.webgpu = values.webgpu;
+        this.webgpuAdapter = values.webgpuAdapter;
+        this.webgpuVendor = values.webgpuVendor;
+        this.webgpuArchitecture = values.webgpuArchitecture;
+        this.pointer = values.pointer;
+        this.keyboard = values.keyboard;
+        this.gamepad = values.gamepad;
+        this.touch = values.touch;
+        this.maxTouchPoints = values.maxTouchPoints;
+        this.audio = values.audio;
+        this.fullscreen = values.fullscreen;
+        this.vibration = values.vibration;
+        this.offscreenCanvas = values.offscreenCanvas;
+        this.webWorkers = values.webWorkers;
+        this.devicePixelRatio = values.devicePixelRatio;
+        Object.freeze(this);
+    }
+    static async _detect() {
+        const [webgpuAdapter, webgpuInfo] = await probeWebGpu();
+        return new Capabilities({
+            webgl2: probeWebGl2(),
+            webgpu: probeWebGpuApiSurface(),
+            webgpuAdapter,
+            webgpuVendor: webgpuInfo?.vendor ?? null,
+            webgpuArchitecture: webgpuInfo?.architecture ?? null,
+            pointer: probePointer(),
+            keyboard: probeKeyboard(),
+            gamepad: probeGamepad(),
+            touch: probeTouchSupported(),
+            maxTouchPoints: probeMaxTouchPoints(),
+            audio: probeAudio(),
+            fullscreen: probeFullscreen(),
+            vibration: probeVibration(),
+            offscreenCanvas: probeOffscreenCanvas(),
+            webWorkers: probeWebWorkers(),
+            devicePixelRatio: hasWindow ? window.devicePixelRatio : 1,
+        });
+    }
+}
+// --- probes ---------------------------------------------------------------
+function probeWebGl2() {
+    if (!hasDocument)
+        return false;
+    try {
+        const canvas = document.createElement('canvas');
+        const gl = canvas.getContext('webgl2');
+        return gl !== null;
+    }
+    catch {
+        return false;
+    }
+}
+function probeWebGpuApiSurface() {
+    return hasNavigator && 'gpu' in navigator;
+}
+async function probeWebGpu() {
+    if (!probeWebGpuApiSurface())
+        return [null, null];
+    const gpu = navigator.gpu;
+    if (!gpu || typeof gpu.requestAdapter !== 'function')
+        return [null, null];
+    try {
+        const adapter = await gpu.requestAdapter();
+        if (!adapter)
+            return [null, null];
+        // Modern path: GPUAdapter.info is a sync property (Chrome 116+,
+        // Safari 18+). Older browsers exposed a deprecated async
+        // requestAdapterInfo() instead. Try the modern path first, fall
+        // back if needed.
+        const adapterAny = adapter;
+        if (adapterAny.info) {
+            return [adapter, adapterAny.info];
+        }
+        if (typeof adapterAny.requestAdapterInfo === 'function') {
+            try {
+                return [adapter, await adapterAny.requestAdapterInfo()];
+            }
+            catch {
+                return [adapter, null];
+            }
+        }
+        return [adapter, null];
+    }
+    catch {
+        return [null, null];
+    }
+}
+function probePointer() {
+    return hasWindow && 'PointerEvent' in window;
+}
+function probeKeyboard() {
+    return hasWindow && 'KeyboardEvent' in window;
+}
+function probeGamepad() {
+    return hasNavigator && typeof navigator.getGamepads === 'function';
+}
+function probeTouchSupported() {
+    if (!hasWindow)
+        return false;
+    if ('ontouchstart' in window)
+        return true;
+    if (probeMaxTouchPoints() > 0)
+        return true;
+    return false;
+}
+function probeMaxTouchPoints() {
+    if (!hasNavigator)
+        return 0;
+    const points = navigator.maxTouchPoints;
+    return typeof points === 'number' ? points : 0;
+}
+function probeAudio() {
+    if (!hasWindow)
+        return false;
+    const w = window;
+    return typeof w.AudioContext !== 'undefined' || typeof w.webkitAudioContext !== 'undefined';
+}
+function probeFullscreen() {
+    if (!hasDocument)
+        return false;
+    const el = document.documentElement;
+    return typeof el.requestFullscreen === 'function' || typeof el.webkitRequestFullscreen === 'function';
+}
+function probeVibration() {
+    return hasNavigator && typeof navigator.vibrate === 'function';
+}
+function probeOffscreenCanvas() {
+    // The browser global is verbatim `OffscreenCanvas`; eslint's
+    // strict-camelCase rule rejects the property name even though we
+    // can't rename a web standard.
+    // eslint-disable-next-line @typescript-eslint/naming-convention
+    return hasWindow && typeof window.OffscreenCanvas !== 'undefined';
+}
+function probeWebWorkers() {
+    // The browser global is verbatim `Worker`; eslint's strict-camelCase
+    // rule rejects the property name even though we can't rename a web
+    // standard.
+    // eslint-disable-next-line @typescript-eslint/naming-convention
+    return hasWindow && typeof window.Worker === 'function';
+}
+
+export { Capabilities };
+//# sourceMappingURL=capabilities.js.map

package/dist/esm/core/capabilities.js.map

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

package/dist/esm/core/index.d.ts

@@ -2,6 +2,7 @@ export * from './types';
 export * from './utils';
 export * from './Application';
 export * from './Bounds';
+export * from './capabilities';
 export * from './Clock';
 export * from './Color';
 export * from './Quadtree';