@fps-games/engine 0.0.1-beta.3 → 0.0.1-beta.5

package/dist/babylon/frame-pump.d.ts

@@ -0,0 +1,27 @@
+import type { Engine } from '@babylonjs/core/Engines/engine.js';
+import { type FpsFrameClock, type FpsFrameClockOptions, type FpsFrameContext } from '../frame.js';
+export interface CreateFpsBabylonFramePumpOptions {
+    readonly engine: Engine;
+    readonly onFrame: (frame: Readonly<FpsFrameContext>) => void;
+    readonly clock?: FpsFrameClock;
+    readonly clockOptions?: FpsFrameClockOptions;
+    readonly now?: () => number;
+}
+export interface FpsBabylonFramePump {
+    readonly clock: FpsFrameClock;
+    isRunning(): boolean;
+    isDisposed(): boolean;
+    start(): void;
+    stop(): void;
+    dispose(): void;
+}
+/**
+ * Owns only Babylon's outer runRenderLoop registration and frame timing.
+ *
+ * The callback remains the composition boundary: it can drive the shared
+ * Runtime Plugin scheduler, project gameplay, cleanup and Scene rendering in
+ * the order selected by the project. The pump does not introduce a competing
+ * phase scheduler and does not own the Engine or Scene.
+ */
+export declare function createFpsBabylonFramePump(options: CreateFpsBabylonFramePumpOptions): FpsBabylonFramePump;
+//# sourceMappingURL=frame-pump.d.ts.map

package/dist/babylon/frame-pump.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame-pump.d.ts","sourceRoot":"","sources":["../../src/babylon/frame-pump.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mCAAmC,CAAC;AAChE,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACrB,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,eAAe,CAAC,KAAK,IAAI,CAAC;IAC7D,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,YAAY,CAAC,EAAE,oBAAoB,CAAC;IAC7C,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,SAAS,IAAI,OAAO,CAAC;IACrB,UAAU,IAAI,OAAO,CAAC;IACtB,KAAK,IAAI,IAAI,CAAC;IACd,IAAI,IAAI,IAAI,CAAC;IACb,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,gCAAgC,GACxC,mBAAmB,CAqDrB"}

package/dist/babylon/frame-pump.js

@@ -0,0 +1,90 @@
+import { createFpsFrameClock, } from '../frame.js';
+/**
+ * Owns only Babylon's outer runRenderLoop registration and frame timing.
+ *
+ * The callback remains the composition boundary: it can drive the shared
+ * Runtime Plugin scheduler, project gameplay, cleanup and Scene rendering in
+ * the order selected by the project. The pump does not introduce a competing
+ * phase scheduler and does not own the Engine or Scene.
+ */
+export function createFpsBabylonFramePump(options) {
+    assertOptions(options);
+    if (options.clock && options.clockOptions) {
+        throw new Error('Babylon Frame Pump accepts either clock or clockOptions, not both.');
+    }
+    const clock = options.clock ?? createFpsFrameClock(options.clockOptions);
+    const now = options.now ?? readNowMs;
+    let running = false;
+    let disposed = false;
+    const renderLoop = () => {
+        if (!running)
+            return;
+        options.onFrame(clock.beginFrame(now()));
+    };
+    return Object.freeze({
+        clock,
+        isRunning() {
+            return running;
+        },
+        isDisposed() {
+            return disposed;
+        },
+        start() {
+            assertOpen(disposed);
+            if (running)
+                return;
+            clock.resetTime();
+            running = true;
+            try {
+                options.engine.runRenderLoop(renderLoop);
+            }
+            catch (error) {
+                running = false;
+                clock.resetTime();
+                throw error;
+            }
+        },
+        stop() {
+            if (!running)
+                return;
+            options.engine.stopRenderLoop(renderLoop);
+            running = false;
+            clock.resetTime();
+        },
+        dispose() {
+            if (disposed)
+                return;
+            if (running) {
+                options.engine.stopRenderLoop(renderLoop);
+                running = false;
+                clock.resetTime();
+            }
+            disposed = true;
+        },
+    });
+}
+function assertOptions(options) {
+    if (!options || typeof options !== 'object') {
+        throw new Error('Babylon Frame Pump options are required.');
+    }
+    if (!options.engine
+        || typeof options.engine.runRenderLoop !== 'function'
+        || typeof options.engine.stopRenderLoop !== 'function') {
+        throw new Error('Babylon Frame Pump requires an Engine.');
+    }
+    if (typeof options.onFrame !== 'function') {
+        throw new Error('Babylon Frame Pump onFrame callback is required.');
+    }
+    if (options.now !== undefined && typeof options.now !== 'function') {
+        throw new Error('Babylon Frame Pump now must be a function.');
+    }
+}
+function assertOpen(disposed) {
+    if (disposed)
+        throw new Error('Babylon Frame Pump is disposed.');
+}
+function readNowMs() {
+    const hostPerformance = globalThis.performance;
+    return hostPerformance ? hostPerformance.now() : Date.now();
+}
+//# sourceMappingURL=frame-pump.js.map

package/dist/babylon/frame-pump.js.map

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

package/dist/babylon/scene-renderer.d.ts

@@ -0,0 +1,20 @@
+import type { Scene } from '@babylonjs/core/scene.js';
+export type FpsBabylonNextFrameScheduler = (callback: () => void) => void;
+export interface CreateFpsBabylonSceneRendererOptions {
+    readonly scene: Scene;
+    readonly scheduleNextFrame?: FpsBabylonNextFrameScheduler;
+}
+export interface FpsBabylonSceneRenderer {
+    render(): void;
+    renderOnce(): Promise<void>;
+}
+/**
+ * Creates a non-owning Babylon Scene renderer shared by the continuous frame
+ * loop and one-shot warm-up paths.
+ *
+ * Project composition still decides when Gameplay updates run and when a
+ * frame is rendered. This resource does not create a render loop and does not
+ * own or dispose the Scene.
+ */
+export declare function createFpsBabylonSceneRenderer(options: CreateFpsBabylonSceneRendererOptions): FpsBabylonSceneRenderer;
+//# sourceMappingURL=scene-renderer.d.ts.map

package/dist/babylon/scene-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-renderer.d.ts","sourceRoot":"","sources":["../../src/babylon/scene-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAEtD,MAAM,MAAM,4BAA4B,GAAG,CAAC,QAAQ,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;AAE1E,MAAM,WAAW,oCAAoC;IACnD,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,iBAAiB,CAAC,EAAE,4BAA4B,CAAC;CAC3D;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,IAAI,IAAI,CAAC;IACf,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B;AAED;;;;;;;GAOG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,oCAAoC,GAC5C,uBAAuB,CAezB"}

package/dist/babylon/scene-renderer.js

@@ -0,0 +1,60 @@
+/**
+ * Creates a non-owning Babylon Scene renderer shared by the continuous frame
+ * loop and one-shot warm-up paths.
+ *
+ * Project composition still decides when Gameplay updates run and when a
+ * frame is rendered. This resource does not create a render loop and does not
+ * own or dispose the Scene.
+ */
+export function createFpsBabylonSceneRenderer(options) {
+    assertOptions(options);
+    const scheduleNextFrame = options.scheduleNextFrame ?? scheduleHostNextFrame;
+    const render = () => {
+        options.scene.render();
+    };
+    return Object.freeze({
+        render,
+        async renderOnce() {
+            await options.scene.whenReadyAsync(false);
+            await waitForNextFrame(scheduleNextFrame);
+            render();
+        },
+    });
+}
+function assertOptions(options) {
+    if (!options || typeof options !== 'object') {
+        throw new Error('Babylon Scene Renderer options are required.');
+    }
+    if (!options.scene
+        || typeof options.scene.render !== 'function'
+        || typeof options.scene.whenReadyAsync !== 'function') {
+        throw new Error('Babylon Scene Renderer requires a Scene.');
+    }
+    if (options.scheduleNextFrame !== undefined
+        && typeof options.scheduleNextFrame !== 'function') {
+        throw new Error('Babylon Scene Renderer scheduleNextFrame must be a function.');
+    }
+}
+function waitForNextFrame(schedule) {
+    return new Promise((resolve, reject) => {
+        try {
+            schedule(resolve);
+        }
+        catch (error) {
+            reject(error);
+        }
+    });
+}
+function scheduleHostNextFrame(callback) {
+    const host = globalThis;
+    if (typeof host.requestAnimationFrame === 'function') {
+        host.requestAnimationFrame(callback);
+        return;
+    }
+    if (typeof host.setTimeout === 'function') {
+        host.setTimeout(callback, 0);
+        return;
+    }
+    void Promise.resolve().then(callback);
+}
+//# sourceMappingURL=scene-renderer.js.map

package/dist/babylon/scene-renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-renderer.js","sourceRoot":"","sources":["../../src/babylon/scene-renderer.ts"],"names":[],"mappings":"AAcA;;;;;;;GAOG;AACH,MAAM,UAAU,6BAA6B,CAC3C,OAA6C;IAE7C,aAAa,CAAC,OAAO,CAAC,CAAC;IACvB,MAAM,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,IAAI,qBAAqB,CAAC;IAC7E,MAAM,MAAM,GAAG,GAAS,EAAE;QACxB,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;IACzB,CAAC,CAAC;IAEF,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,MAAM;QACN,KAAK,CAAC,UAAU;YACd,MAAM,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;YAC1C,MAAM,gBAAgB,CAAC,iBAAiB,CAAC,CAAC;YAC1C,MAAM,EAAE,CAAC;QACX,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,SAAS,aAAa,CAAC,OAA6C;IAClE,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,KAAK;WACb,OAAO,OAAO,CAAC,KAAK,CAAC,MAAM,KAAK,UAAU;WAC1C,OAAO,OAAO,CAAC,KAAK,CAAC,cAAc,KAAK,UAAU,EAAE,CAAC;QACxD,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC9D,CAAC;IACD,IAAI,OAAO,CAAC,iBAAiB,KAAK,SAAS;WACtC,OAAO,OAAO,CAAC,iBAAiB,KAAK,UAAU,EAAE,CAAC;QACrD,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAClF,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CAAC,QAAsC;IAC9D,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC3C,IAAI,CAAC;YACH,QAAQ,CAAC,OAAO,CAAC,CAAC;QACpB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,qBAAqB,CAAC,QAAoB;IACjD,MAAM,IAAI,GAAG,UAGZ,CAAC;IACF,IAAI,OAAO,IAAI,CAAC,qBAAqB,KAAK,UAAU,EAAE,CAAC;QACrD,IAAI,CAAC,qBAAqB,CAAC,QAAQ,CAAC,CAAC;QACrC,OAAO;IACT,CAAC;IACD,IAAI,OAAO,IAAI,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;QAC1C,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;QAC7B,OAAO;IACT,CAAC;IACD,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AACxC,CAAC"}

package/dist/babylon.d.ts

@@ -1,4 +1,6 @@
 export declare const ENGINE_BABYLON_SUBPATH = "@fps-games/engine/babylon";
+export { createFpsBabylonFramePump, type CreateFpsBabylonFramePumpOptions, type FpsBabylonFramePump, } from './babylon/frame-pump.js';
+export { createFpsBabylonSceneRenderer, type CreateFpsBabylonSceneRendererOptions, type FpsBabylonNextFrameScheduler, type FpsBabylonSceneRenderer, } from './babylon/scene-renderer.js';
 export { applyFpsBabylonCameraProjection, createFpsBabylonCameraResource, resizeFpsBabylonCameraProjection, type CreateFpsBabylonCameraResourceOptions, type FpsBabylonCameraRegistration, type FpsBabylonCameraResource, } from './babylon/camera.js';
 export { createFpsBabylonLightingController, type FpsBabylonLightingApplyResult, type FpsBabylonLightingController, type FpsBabylonLightingMutation, type FpsBabylonRuntimeLight, } from './babylon/lighting-controller.js';
 //# sourceMappingURL=babylon.d.ts.map

package/dist/babylon.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"babylon.d.ts","sourceRoot":"","sources":["../src/babylon.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,sBAAsB,8BAA8B,CAAC;AAElE,OAAO,EACL,+BAA+B,EAC/B,8BAA8B,EAC9B,gCAAgC,EAChC,KAAK,qCAAqC,EAC1C,KAAK,4BAA4B,EACjC,KAAK,wBAAwB,GAC9B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,kCAAkC,EAClC,KAAK,6BAA6B,EAClC,KAAK,4BAA4B,EACjC,KAAK,0BAA0B,EAC/B,KAAK,sBAAsB,GAC5B,MAAM,kCAAkC,CAAC"}
+{"version":3,"file":"babylon.d.ts","sourceRoot":"","sources":["../src/babylon.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,sBAAsB,8BAA8B,CAAC;AAElE,OAAO,EACL,yBAAyB,EACzB,KAAK,gCAAgC,EACrC,KAAK,mBAAmB,GACzB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,6BAA6B,EAC7B,KAAK,oCAAoC,EACzC,KAAK,4BAA4B,EACjC,KAAK,uBAAuB,GAC7B,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,+BAA+B,EAC/B,8BAA8B,EAC9B,gCAAgC,EAChC,KAAK,qCAAqC,EAC1C,KAAK,4BAA4B,EACjC,KAAK,wBAAwB,GAC9B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,kCAAkC,EAClC,KAAK,6BAA6B,EAClC,KAAK,4BAA4B,EACjC,KAAK,0BAA0B,EAC/B,KAAK,sBAAsB,GAC5B,MAAM,kCAAkC,CAAC"}

package/dist/babylon.js

@@ -1,4 +1,6 @@
 export const ENGINE_BABYLON_SUBPATH = '@fps-games/engine/babylon';
+export { createFpsBabylonFramePump, } from './babylon/frame-pump.js';
+export { createFpsBabylonSceneRenderer, } from './babylon/scene-renderer.js';
 export { applyFpsBabylonCameraProjection, createFpsBabylonCameraResource, resizeFpsBabylonCameraProjection, } from './babylon/camera.js';
 export { createFpsBabylonLightingController, } from './babylon/lighting-controller.js';
 //# sourceMappingURL=babylon.js.map

package/dist/babylon.js.map

@@ -1 +1 @@
-{"version":3,"file":"babylon.js","sourceRoot":"","sources":["../src/babylon.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,sBAAsB,GAAG,2BAA2B,CAAC;AAElE,OAAO,EACL,+BAA+B,EAC/B,8BAA8B,EAC9B,gCAAgC,GAIjC,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,kCAAkC,GAKnC,MAAM,kCAAkC,CAAC"}
+{"version":3,"file":"babylon.js","sourceRoot":"","sources":["../src/babylon.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,sBAAsB,GAAG,2BAA2B,CAAC;AAElE,OAAO,EACL,yBAAyB,GAG1B,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,6BAA6B,GAI9B,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,+BAA+B,EAC/B,8BAA8B,EAC9B,gCAAgC,GAIjC,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,kCAAkC,GAKnC,MAAM,kCAAkC,CAAC"}

package/dist/build-info.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 1,
   "packageName": "@fps-games/engine",
-  "version": "0.0.1-beta.3",
-  "gitSha": "266b82b05222646aaac1963e15c566d3a0eb0a63",
-  "distHash": "eb7df52fec11110e7935feb2119cf846e4f6a403e5373ddb5e1f58dc2363ced1",
-  "cacheKey": "0.0.1-beta.3-eb7df52fec11"
+  "version": "0.0.1-beta.5",
+  "gitSha": "34938b614fc42a6e355a593ea5a7027bbe66d084",
+  "distHash": "85346472fcce6e7e77f98a2cff925ab2e96d0eeecaf2fdd6a07f568ec29a1a8a",
+  "cacheKey": "0.0.1-beta.5-85346472fcce"
 }

package/dist/frame.d.ts

@@ -0,0 +1,32 @@
+export declare const FPS_FRAME_CLOCK_DEFAULT_MAX_DELTA_SECONDS = 0.1;
+/**
+ * Renderer-neutral timing emitted once by the outer Runtime frame pump.
+ *
+ * This is deliberately not a gameplay phase scheduler. Projects and Runtime
+ * Plugins decide how a frame is split into update phases and when rendering
+ * occurs.
+ */
+export interface FpsFrameContext {
+    readonly frame: number;
+    readonly nowMs: number;
+    readonly deltaSeconds: number;
+    readonly elapsedSeconds: number;
+}
+export interface FpsFrameClockOptions {
+    readonly maxDeltaSeconds?: number;
+}
+export interface FpsFrameClock {
+    readonly maxDeltaSeconds: number;
+    beginFrame(nowMs: number): Readonly<FpsFrameContext>;
+    resetTime(): void;
+    reset(): void;
+}
+/**
+ * Creates a monotonic, clamped Runtime frame clock.
+ *
+ * `resetTime()` prevents a stopped, hidden or paused interval from becoming a
+ * large delta while preserving the accumulated frame diagnostics. `reset()`
+ * starts a completely new frame timeline.
+ */
+export declare function createFpsFrameClock(options?: FpsFrameClockOptions): FpsFrameClock;
+//# sourceMappingURL=frame.d.ts.map

package/dist/frame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame.d.ts","sourceRoot":"","sources":["../src/frame.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,yCAAyC,MAAM,CAAC;AAE7D;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAAC,eAAe,CAAC,CAAC;IACrD,SAAS,IAAI,IAAI,CAAC;IAClB,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,GAAE,oBAAyB,GACjC,aAAa,CAsCf"}

package/dist/frame.js

@@ -0,0 +1,54 @@
+export const FPS_FRAME_CLOCK_DEFAULT_MAX_DELTA_SECONDS = 0.1;
+/**
+ * Creates a monotonic, clamped Runtime frame clock.
+ *
+ * `resetTime()` prevents a stopped, hidden or paused interval from becoming a
+ * large delta while preserving the accumulated frame diagnostics. `reset()`
+ * starts a completely new frame timeline.
+ */
+export function createFpsFrameClock(options = {}) {
+    const maxDeltaSeconds = readPositiveFinite(options.maxDeltaSeconds ?? FPS_FRAME_CLOCK_DEFAULT_MAX_DELTA_SECONDS, 'maxDeltaSeconds');
+    let frame = 0;
+    let elapsedSeconds = 0;
+    let previousNowMs = null;
+    return Object.freeze({
+        maxDeltaSeconds,
+        beginFrame(nowMs) {
+            const currentNowMs = readFinite(nowMs, 'nowMs');
+            const rawDeltaSeconds = previousNowMs === null
+                ? 0
+                : Math.max(0, (currentNowMs - previousNowMs) / 1000);
+            const deltaSeconds = Math.min(rawDeltaSeconds, maxDeltaSeconds);
+            previousNowMs = currentNowMs;
+            elapsedSeconds += deltaSeconds;
+            frame += 1;
+            return Object.freeze({
+                frame,
+                nowMs: currentNowMs,
+                deltaSeconds,
+                elapsedSeconds,
+            });
+        },
+        resetTime() {
+            previousNowMs = null;
+        },
+        reset() {
+            frame = 0;
+            elapsedSeconds = 0;
+            previousNowMs = null;
+        },
+    });
+}
+function readPositiveFinite(value, label) {
+    if (!Number.isFinite(value) || value <= 0) {
+        throw new Error(`Frame Clock ${label} must be a positive finite number.`);
+    }
+    return value;
+}
+function readFinite(value, label) {
+    if (!Number.isFinite(value)) {
+        throw new Error(`Frame Clock ${label} must be a finite number.`);
+    }
+    return value;
+}
+//# sourceMappingURL=frame.js.map

package/dist/frame.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame.js","sourceRoot":"","sources":["../src/frame.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,yCAAyC,GAAG,GAAG,CAAC;AA2B7D;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CACjC,UAAgC,EAAE;IAElC,MAAM,eAAe,GAAG,kBAAkB,CACxC,OAAO,CAAC,eAAe,IAAI,yCAAyC,EACpE,iBAAiB,CAClB,CAAC;IACF,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,cAAc,GAAG,CAAC,CAAC;IACvB,IAAI,aAAa,GAAkB,IAAI,CAAC;IAExC,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,eAAe;QACf,UAAU,CAAC,KAAa;YACtB,MAAM,YAAY,GAAG,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAChD,MAAM,eAAe,GAAG,aAAa,KAAK,IAAI;gBAC5C,CAAC,CAAC,CAAC;gBACH,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,YAAY,GAAG,aAAa,CAAC,GAAG,IAAI,CAAC,CAAC;YACvD,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,eAAe,CAAC,CAAC;YAEhE,aAAa,GAAG,YAAY,CAAC;YAC7B,cAAc,IAAI,YAAY,CAAC;YAC/B,KAAK,IAAI,CAAC,CAAC;YAEX,OAAO,MAAM,CAAC,MAAM,CAAC;gBACnB,KAAK;gBACL,KAAK,EAAE,YAAY;gBACnB,YAAY;gBACZ,cAAc;aACf,CAAC,CAAC;QACL,CAAC;QACD,SAAS;YACP,aAAa,GAAG,IAAI,CAAC;QACvB,CAAC;QACD,KAAK;YACH,KAAK,GAAG,CAAC,CAAC;YACV,cAAc,GAAG,CAAC,CAAC;YACnB,aAAa,GAAG,IAAI,CAAC;QACvB,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAa,EAAE,KAAa;IACtD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,eAAe,KAAK,oCAAoC,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,UAAU,CAAC,KAAa,EAAE,KAAa;IAC9C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,eAAe,KAAK,2BAA2B,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/index.d.ts

@@ -4,6 +4,7 @@ export interface FpsEngineRuntimeDataMarker {
     readonly schemaVersion: 1;
     readonly marker: typeof ENGINE_PACKAGE_MARKER;
 }
+export { FPS_FRAME_CLOCK_DEFAULT_MAX_DELTA_SECONDS, createFpsFrameClock, type FpsFrameClock, type FpsFrameClockOptions, type FpsFrameContext, } from './frame.js';
 export { FPS_CAMERA_PROJECTION_SCHEMA_VERSION, FpsCameraProjectionDataError, createFpsCameraProjectionSnapshot, type FpsCameraProjectionMode, type FpsCameraProjectionSnapshot, } from './camera.js';
 export { FPS_RUNTIME_LIGHT_COMPONENT_SCHEMA_VERSION, FpsRuntimeLightingDataError, createFpsRuntimeLightSnapshot, createFpsRuntimeStandardSystemLightingSnapshot, createFpsRuntimeSystemLightingSnapshot, normalizeFpsRuntimeLightDirection, type FpsRuntimeDirectionalLight, type FpsRuntimeHemisphericLight, type FpsRuntimeLight, type FpsRuntimeLightColorRgb, type FpsRuntimeLightNodeSnapshot, type FpsRuntimeLightVec3, type FpsRuntimeStandardSystemLightingSnapshot, type FpsRuntimeSystemLightingSnapshot, } from './lighting.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB,sBAAsB,CAAC;AACzD,eAAO,MAAM,2BAA2B,qBAAqB,CAAC;AAE9D,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,OAAO,qBAAqB,CAAC;CAC/C;AAED,OAAO,EACL,oCAAoC,EACpC,4BAA4B,EAC5B,iCAAiC,EACjC,KAAK,uBAAuB,EAC5B,KAAK,2BAA2B,GACjC,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,0CAA0C,EAC1C,2BAA2B,EAC3B,6BAA6B,EAC7B,8CAA8C,EAC9C,sCAAsC,EACtC,iCAAiC,EACjC,KAAK,0BAA0B,EAC/B,KAAK,0BAA0B,EAC/B,KAAK,eAAe,EACpB,KAAK,uBAAuB,EAC5B,KAAK,2BAA2B,EAChC,KAAK,mBAAmB,EACxB,KAAK,wCAAwC,EAC7C,KAAK,gCAAgC,GACtC,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB,sBAAsB,CAAC;AACzD,eAAO,MAAM,2BAA2B,qBAAqB,CAAC;AAE9D,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,aAAa,EAAE,CAAC,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,OAAO,qBAAqB,CAAC;CAC/C;AAED,OAAO,EACL,yCAAyC,EACzC,mBAAmB,EACnB,KAAK,aAAa,EAClB,KAAK,oBAAoB,EACzB,KAAK,eAAe,GACrB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,oCAAoC,EACpC,4BAA4B,EAC5B,iCAAiC,EACjC,KAAK,uBAAuB,EAC5B,KAAK,2BAA2B,GACjC,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,0CAA0C,EAC1C,2BAA2B,EAC3B,6BAA6B,EAC7B,8CAA8C,EAC9C,sCAAsC,EACtC,iCAAiC,EACjC,KAAK,0BAA0B,EAC/B,KAAK,0BAA0B,EAC/B,KAAK,eAAe,EACpB,KAAK,uBAAuB,EAC5B,KAAK,2BAA2B,EAChC,KAAK,mBAAmB,EACxB,KAAK,wCAAwC,EAC7C,KAAK,gCAAgC,GACtC,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -1,5 +1,6 @@
 export const ENGINE_PACKAGE_MARKER = '@fps-games/engine';
 export const ENGINE_IMPLEMENTATION_PHASE = 'domain-migration';
+export { FPS_FRAME_CLOCK_DEFAULT_MAX_DELTA_SECONDS, createFpsFrameClock, } from './frame.js';
 export { FPS_CAMERA_PROJECTION_SCHEMA_VERSION, FpsCameraProjectionDataError, createFpsCameraProjectionSnapshot, } from './camera.js';
 export { FPS_RUNTIME_LIGHT_COMPONENT_SCHEMA_VERSION, FpsRuntimeLightingDataError, createFpsRuntimeLightSnapshot, createFpsRuntimeStandardSystemLightingSnapshot, createFpsRuntimeSystemLightingSnapshot, normalizeFpsRuntimeLightDirection, } from './lighting.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qBAAqB,GAAG,mBAAmB,CAAC;AACzD,MAAM,CAAC,MAAM,2BAA2B,GAAG,kBAAkB,CAAC;AAO9D,OAAO,EACL,oCAAoC,EACpC,4BAA4B,EAC5B,iCAAiC,GAGlC,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,0CAA0C,EAC1C,2BAA2B,EAC3B,6BAA6B,EAC7B,8CAA8C,EAC9C,sCAAsC,EACtC,iCAAiC,GASlC,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qBAAqB,GAAG,mBAAmB,CAAC;AACzD,MAAM,CAAC,MAAM,2BAA2B,GAAG,kBAAkB,CAAC;AAO9D,OAAO,EACL,yCAAyC,EACzC,mBAAmB,GAIpB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,oCAAoC,EACpC,4BAA4B,EAC5B,iCAAiC,GAGlC,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,0CAA0C,EAC1C,2BAA2B,EAC3B,6BAA6B,EAC7B,8CAA8C,EAC9C,sCAAsC,EACtC,iCAAiC,GASlC,MAAM,eAAe,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fps-games/engine",
-  "version": "0.0.1-beta.3",
+  "version": "0.0.1-beta.5",
   "description": "Forge Play game engine Runtime Data and renderer backend product.",
   "type": "module",
   "main": "./dist/index.js",