@fps-games/engine 0.0.1-beta.2 → 0.0.1-beta.20

package/dist/asset-resource.d.ts

@@ -0,0 +1,45 @@
+import type { FpsGeneratedAssetCatalog } from './runtime-data-types.js';
+export type FpsAssetFormat = `.${string}`;
+export type FpsAssetResourceTransport = 'path-url' | 'http-url' | 'data-url' | 'blob-url';
+export interface FpsResolvedAssetResource {
+    readonly assetId: string | null;
+    readonly url: string;
+    readonly format: FpsAssetFormat;
+    readonly transport: FpsAssetResourceTransport;
+    readonly relativePath: string | null;
+    readonly originalFileName: string | null;
+}
+export interface FpsAssetResourceReference {
+    readonly assetId?: string | null;
+    readonly url?: string | null;
+}
+export type FpsAssetResourceResolutionCode = 'asset.resource.not-found' | 'asset.resource.format-missing' | 'asset.resource.format-unsupported' | 'asset.resource.invalid-reference';
+export interface FpsAssetResourceResolutionDiagnostic {
+    readonly code: FpsAssetResourceResolutionCode;
+    readonly assetId: string | null;
+    readonly format: FpsAssetFormat | null;
+    readonly transport: FpsAssetResourceTransport | null;
+    /** A safe bounded URL description. It never includes a data/blob payload. */
+    readonly urlSummary: string | null;
+}
+export type FpsAssetResourceResolution = Readonly<{
+    ok: true;
+    resource: FpsResolvedAssetResource;
+}> | Readonly<{
+    ok: false;
+    diagnostic: FpsAssetResourceResolutionDiagnostic;
+}>;
+export interface FpsAssetResourceResolver {
+    resolve(reference: FpsAssetResourceReference): FpsAssetResourceResolution;
+}
+export declare function createFpsAssetResourceResolver(catalog: FpsGeneratedAssetCatalog): FpsAssetResourceResolver;
+export declare function getFpsAssetFormat(value: unknown): FpsAssetFormat | null;
+export declare function isFpsAssetFormatSupported(format: FpsAssetFormat): boolean;
+export declare function getFpsAssetResourceTransport(url: string): FpsAssetResourceTransport;
+/**
+ * Vite `import x from "file.env?url"` often yields `file.env?import&url`.
+ * Fetching that URL returns a JS module, not asset bytes. Babylon/runtime
+ * loaders must receive the bytes URL. Version queries such as `?v=7` stay.
+ */
+export declare function normalizeFpsAssetBytesUrl(url: string): string;
+//# sourceMappingURL=asset-resource.d.ts.map

package/dist/asset-resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-resource.d.ts","sourceRoot":"","sources":["../src/asset-resource.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAiC,MAAM,yBAAyB,CAAC;AAEvG,MAAM,MAAM,cAAc,GAAG,IAAI,MAAM,EAAE,CAAC;AAC1C,MAAM,MAAM,yBAAyB,GAAG,UAAU,GAAG,UAAU,GAAG,UAAU,GAAG,UAAU,CAAC;AAE1F,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,yBAAyB,CAAC;IAC9C,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1C;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,MAAM,8BAA8B,GACtC,0BAA0B,GAC1B,+BAA+B,GAC/B,mCAAmC,GACnC,kCAAkC,CAAC;AAEvC,MAAM,WAAW,oCAAoC;IACnD,QAAQ,CAAC,IAAI,EAAE,8BAA8B,CAAC;IAC9C,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,SAAS,EAAE,yBAAyB,GAAG,IAAI,CAAC;IACrD,6EAA6E;IAC7E,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AAED,MAAM,MAAM,0BAA0B,GAClC,QAAQ,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,wBAAwB,CAAA;CAAE,CAAC,GAC1D,QAAQ,CAAC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,UAAU,EAAE,oCAAoC,CAAA;CAAE,CAAC,CAAC;AAE9E,MAAM,WAAW,wBAAwB;IACvC,OAAO,CAAC,SAAS,EAAE,yBAAyB,GAAG,0BAA0B,CAAC;CAC3E;AASD,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,wBAAwB,GAChC,wBAAwB,CAsC1B;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,GAAG,IAAI,CAQvE;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAEzE;AAED,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,MAAM,GAAG,yBAAyB,CAKnF;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAe7D"}

package/dist/asset-resource.js

@@ -0,0 +1,147 @@
+const FPS_SUPPORTED_ASSET_FORMATS = new Set([
+    '.glb', '.gltf',
+    '.png', '.jpg', '.jpeg', '.webp',
+    '.env', '.hdr', '.dds', '.ktx', '.ktx2',
+    '.mp3', '.wav', '.ogg', '.flac', '.aac', '.m4a',
+]);
+export function createFpsAssetResourceResolver(catalog) {
+    const entries = new Map();
+    for (const [catalogAssetId, input] of Object.entries(catalog)) {
+        const entry = normalizeCatalogEntry(catalogAssetId, input);
+        if (entries.has(entry.assetId))
+            throw new Error(`Duplicate generated asset catalog id: ${entry.assetId}`);
+        entries.set(entry.assetId, entry);
+    }
+    return Object.freeze({
+        resolve(reference) {
+            const assetId = normalizeOptionalString(reference.assetId);
+            const url = normalizeOptionalString(reference.url);
+            if (assetId) {
+                const entry = entries.get(assetId);
+                if (!entry)
+                    return failed('asset.resource.not-found', assetId, null, null, url);
+                const bytesUrl = normalizeFpsAssetBytesUrl(entry.url);
+                return resolved({
+                    assetId: entry.assetId,
+                    url: bytesUrl,
+                    format: entry.format,
+                    transport: getFpsAssetResourceTransport(bytesUrl),
+                    relativePath: entry.relativePath,
+                    originalFileName: entry.originalFileName ?? null,
+                });
+            }
+            if (!url)
+                return failed('asset.resource.invalid-reference', null, null, null, null);
+            const bytesUrl = normalizeFpsAssetBytesUrl(url);
+            const transport = getFpsAssetResourceTransport(bytesUrl);
+            if (transport === 'data-url' || transport === 'blob-url') {
+                return failed('asset.resource.format-missing', null, null, transport, bytesUrl);
+            }
+            const format = getFpsAssetFormat(bytesUrl);
+            if (!format)
+                return failed('asset.resource.format-missing', null, null, transport, bytesUrl);
+            if (!isFpsAssetFormatSupported(format)) {
+                return failed('asset.resource.format-unsupported', null, format, transport, bytesUrl);
+            }
+            return resolved({ assetId: null, url: bytesUrl, format, transport, relativePath: null, originalFileName: null });
+        },
+    });
+}
+export function getFpsAssetFormat(value) {
+    const normalized = String(value ?? '').trim().toLowerCase();
+    if (/^\.[a-z0-9]+$/.test(normalized))
+        return normalized;
+    const path = normalized.split(/[?#]/, 1)[0] ?? '';
+    const fileName = path.slice(path.lastIndexOf('/') + 1);
+    const dot = fileName.lastIndexOf('.');
+    if (dot <= 0 || dot === fileName.length - 1)
+        return null;
+    return fileName.slice(dot);
+}
+export function isFpsAssetFormatSupported(format) {
+    return FPS_SUPPORTED_ASSET_FORMATS.has(format);
+}
+export function getFpsAssetResourceTransport(url) {
+    if (/^data:/i.test(url))
+        return 'data-url';
+    if (/^blob:/i.test(url))
+        return 'blob-url';
+    if (/^https?:/i.test(url))
+        return 'http-url';
+    return 'path-url';
+}
+/**
+ * Vite `import x from "file.env?url"` often yields `file.env?import&url`.
+ * Fetching that URL returns a JS module, not asset bytes. Babylon/runtime
+ * loaders must receive the bytes URL. Version queries such as `?v=7` stay.
+ */
+export function normalizeFpsAssetBytesUrl(url) {
+    const trimmed = url.trim();
+    if (!trimmed || /^data:/i.test(trimmed) || /^blob:/i.test(trimmed))
+        return trimmed;
+    const hashIndex = trimmed.indexOf('#');
+    const withoutHash = hashIndex === -1 ? trimmed : trimmed.slice(0, hashIndex);
+    const hash = hashIndex === -1 ? '' : trimmed.slice(hashIndex);
+    const queryIndex = withoutHash.indexOf('?');
+    if (queryIndex === -1)
+        return trimmed;
+    const pathname = withoutHash.slice(0, queryIndex);
+    const params = new URLSearchParams(withoutHash.slice(queryIndex + 1));
+    if (!params.has('import') || !params.has('url'))
+        return trimmed;
+    params.delete('import');
+    params.delete('url');
+    const rest = params.toString();
+    return rest ? `${pathname}?${rest}${hash}` : `${pathname}${hash}`;
+}
+function normalizeCatalogEntry(catalogAssetId, input) {
+    const assetId = normalizeRequiredString(input?.assetId, `Generated asset catalog entry ${catalogAssetId} assetId`);
+    if (assetId !== catalogAssetId)
+        throw new Error(`Generated asset catalog key/id mismatch: ${catalogAssetId}`);
+    const url = normalizeRequiredString(input.url, `Generated asset catalog entry ${assetId} url`);
+    const relativePath = normalizeRequiredString(input.relativePath, `Generated asset catalog entry ${assetId} relativePath`);
+    const format = normalizeFormat(input.format, `Generated asset catalog entry ${assetId} format`);
+    const derivedFormat = getFpsAssetFormat(relativePath);
+    if (derivedFormat !== format)
+        throw new Error(`Generated asset catalog entry ${assetId} format must match relativePath.`);
+    if (!isFpsAssetFormatSupported(format))
+        throw new Error(`Generated asset catalog entry ${assetId} has unsupported format: ${format}`);
+    const originalFileName = normalizeOptionalString(input.originalFileName);
+    return Object.freeze({ assetId, url, format, relativePath, ...(originalFileName ? { originalFileName } : {}) });
+}
+function normalizeFormat(value, label) {
+    const format = getFpsAssetFormat(String(value ?? ''));
+    if (!format || format !== String(value).trim().toLowerCase())
+        throw new Error(`${label} must be a normalized file extension.`);
+    return format;
+}
+function normalizeRequiredString(value, label) {
+    const result = normalizeOptionalString(value);
+    if (!result)
+        throw new Error(`${label} is required.`);
+    return result;
+}
+function normalizeOptionalString(value) {
+    if (typeof value !== 'string')
+        return null;
+    const result = value.trim();
+    return result || null;
+}
+function resolved(resource) {
+    return Object.freeze({ ok: true, resource: Object.freeze(resource) });
+}
+function failed(code, assetId, format, transport, url) {
+    return Object.freeze({ ok: false, diagnostic: Object.freeze({
+            code, assetId, format, transport, urlSummary: summarizeUrl(url),
+        }) });
+}
+function summarizeUrl(url) {
+    if (!url)
+        return null;
+    if (/^data:/i.test(url))
+        return 'data:<redacted>';
+    if (/^blob:/i.test(url))
+        return 'blob:<redacted>';
+    return url.length <= 160 ? url : `${url.slice(0, 157)}...`;
+}
+//# sourceMappingURL=asset-resource.js.map

package/dist/asset-resource.js.map

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

package/dist/babylon/camera.d.ts

@@ -0,0 +1,25 @@
+import { Camera } from '@babylonjs/core/Cameras/camera.js';
+import type { Scene } from '@babylonjs/core/scene.js';
+import { type FpsCameraProjectionSnapshot } from '../camera.js';
+export interface FpsBabylonCameraRegistration {
+    dispose(): void;
+}
+export interface FpsBabylonCameraResource<TCamera extends Camera = Camera> {
+    readonly camera: TCamera;
+    isDisposed(): boolean;
+    dispose(): void;
+}
+export interface CreateFpsBabylonCameraResourceOptions<TCamera extends Camera> {
+    readonly scene: Scene;
+    readonly camera: TCamera;
+    readonly registration?: FpsBabylonCameraRegistration | null;
+}
+/**
+ * Transfers an already-created Camera and its renderer registration to one
+ * retryable owner. Project policy still decides camera type, active-camera
+ * routing and when the resource is created.
+ */
+export declare function createFpsBabylonCameraResource<TCamera extends Camera>(options: CreateFpsBabylonCameraResourceOptions<TCamera>): FpsBabylonCameraResource<TCamera>;
+export declare function applyFpsBabylonCameraProjection(camera: Camera, value: unknown, path?: string): Readonly<FpsCameraProjectionSnapshot>;
+export declare function resizeFpsBabylonCameraProjection(camera: Camera, value: unknown, path?: string): Readonly<FpsCameraProjectionSnapshot>;
+//# sourceMappingURL=camera.d.ts.map

package/dist/babylon/camera.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"camera.d.ts","sourceRoot":"","sources":["../../src/babylon/camera.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mCAAmC,CAAC;AAC3D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAEL,KAAK,2BAA2B,EACjC,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,4BAA4B;IAC3C,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,wBAAwB,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM;IACvE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,UAAU,IAAI,OAAO,CAAC;IACtB,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,qCAAqC,CAAC,OAAO,SAAS,MAAM;IAC3E,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,YAAY,CAAC,EAAE,4BAA4B,GAAG,IAAI,CAAC;CAC7D;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAAC,OAAO,SAAS,MAAM,EACnE,OAAO,EAAE,qCAAqC,CAAC,OAAO,CAAC,GACtD,wBAAwB,CAAC,OAAO,CAAC,CAuCnC;AAED,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,EACd,IAAI,SAAuB,GAC1B,QAAQ,CAAC,2BAA2B,CAAC,CAuBvC;AAED,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,EACd,IAAI,SAAuB,GAC1B,QAAQ,CAAC,2BAA2B,CAAC,CAkBvC"}

package/dist/babylon/camera.js

@@ -0,0 +1,149 @@
+import { Camera } from '@babylonjs/core/Cameras/camera.js';
+import { createFpsCameraProjectionSnapshot, } from '../camera.js';
+/**
+ * Transfers an already-created Camera and its renderer registration to one
+ * retryable owner. Project policy still decides camera type, active-camera
+ * routing and when the resource is created.
+ */
+export function createFpsBabylonCameraResource(options) {
+    const { camera, scene } = options;
+    if (!camera || typeof camera.getScene !== 'function' || camera.getScene() !== scene) {
+        throw Object.assign(new Error('Babylon Camera resource belongs to a different Scene.'), { code: 'camera.resource.sceneMismatch' });
+    }
+    if (camera.isDisposed()) {
+        throw Object.assign(new Error('Babylon Camera resource is already disposed.'), { code: 'camera.resource.alreadyDisposed' });
+    }
+    if (options.registration && typeof options.registration.dispose !== 'function') {
+        throw Object.assign(new Error('Babylon Camera registration must provide dispose().'), { code: 'camera.resource.registrationInvalid' });
+    }
+    let registration = options.registration ?? null;
+    let disposed = false;
+    return Object.freeze({
+        camera,
+        isDisposed() {
+            return disposed;
+        },
+        dispose() {
+            if (disposed)
+                return;
+            if (registration) {
+                registration.dispose();
+                registration = null;
+            }
+            camera.dispose();
+            disposed = true;
+        },
+    });
+}
+export function applyFpsBabylonCameraProjection(camera, value, path = '$.cameraProjection') {
+    const snapshot = createFpsCameraProjectionSnapshot(value, path);
+    const previous = captureProjectionState(camera);
+    try {
+        camera.minZ = snapshot.minZ;
+        camera.maxZ = snapshot.maxZ;
+        camera.fov = snapshot.fov;
+        camera.mode = snapshot.projection === 'perspective'
+            ? Camera.PERSPECTIVE_CAMERA
+            : Camera.ORTHOGRAPHIC_CAMERA;
+        applyOrthographicExtents(camera, snapshot);
+        camera.getProjectionMatrix(true);
+        return snapshot;
+    }
+    catch (error) {
+        const cleanupErrors = [];
+        try {
+            restoreProjectionState(camera, previous);
+            camera.getProjectionMatrix(true);
+        }
+        catch (cleanupError) {
+            cleanupErrors.push(cleanupError);
+        }
+        throw addFailureMetadata(error, 'Babylon Camera projection apply failed.', cleanupErrors);
+    }
+}
+export function resizeFpsBabylonCameraProjection(camera, value, path = '$.cameraProjection') {
+    const snapshot = createFpsCameraProjectionSnapshot(value, path);
+    if (snapshot.projection !== 'orthographic')
+        return snapshot;
+    const previous = captureOrthographicExtents(camera);
+    try {
+        applyOrthographicExtents(camera, snapshot);
+        camera.getProjectionMatrix(true);
+        return snapshot;
+    }
+    catch (error) {
+        const cleanupErrors = [];
+        try {
+            restoreOrthographicExtents(camera, previous);
+            camera.getProjectionMatrix(true);
+        }
+        catch (cleanupError) {
+            cleanupErrors.push(cleanupError);
+        }
+        throw addFailureMetadata(error, 'Babylon Camera projection resize failed.', cleanupErrors);
+    }
+}
+function applyOrthographicExtents(camera, snapshot) {
+    if (snapshot.projection !== 'orthographic')
+        return;
+    const engine = camera.getScene().getEngine();
+    const width = readPositiveDimension(engine.getRenderWidth());
+    const height = readPositiveDimension(engine.getRenderHeight());
+    const halfHeight = snapshot.orthoSize;
+    const halfWidth = halfHeight * (width / height);
+    camera.orthoLeft = -halfWidth;
+    camera.orthoRight = halfWidth;
+    camera.orthoBottom = -halfHeight;
+    camera.orthoTop = halfHeight;
+}
+function captureProjectionState(camera) {
+    return {
+        mode: camera.mode,
+        fov: camera.fov,
+        minZ: camera.minZ,
+        maxZ: camera.maxZ,
+        ...captureOrthographicExtents(camera),
+    };
+}
+function restoreProjectionState(camera, state) {
+    camera.mode = state.mode;
+    camera.fov = state.fov;
+    camera.minZ = state.minZ;
+    camera.maxZ = state.maxZ;
+    restoreOrthographicExtents(camera, state);
+}
+function captureOrthographicExtents(camera) {
+    return {
+        orthoLeft: camera.orthoLeft,
+        orthoRight: camera.orthoRight,
+        orthoTop: camera.orthoTop,
+        orthoBottom: camera.orthoBottom,
+    };
+}
+function restoreOrthographicExtents(camera, state) {
+    camera.orthoLeft = state.orthoLeft;
+    camera.orthoRight = state.orthoRight;
+    camera.orthoTop = state.orthoTop;
+    camera.orthoBottom = state.orthoBottom;
+}
+function readPositiveDimension(value) {
+    return Number.isFinite(value) && value > 0 ? value : 1;
+}
+function addFailureMetadata(failure, fallbackMessage, cleanupErrors) {
+    if (cleanupErrors.length === 0)
+        return failure;
+    if (failure && (typeof failure === 'object' || typeof failure === 'function')) {
+        try {
+            Object.assign(failure, { cleanupErrors: Object.freeze([...cleanupErrors]) });
+            return failure;
+        }
+        catch {
+            // Fall through to a wrapper when the original error is immutable.
+        }
+    }
+    return Object.assign(new Error(fallbackMessage), {
+        cause: failure,
+        cleanupErrors: Object.freeze([...cleanupErrors]),
+    });
+}
+//# sourceMappingURL=camera.js.map

package/dist/babylon/camera.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"camera.js","sourceRoot":"","sources":["../../src/babylon/camera.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mCAAmC,CAAC;AAE3D,OAAO,EACL,iCAAiC,GAElC,MAAM,cAAc,CAAC;AAkBtB;;;;GAIG;AACH,MAAM,UAAU,8BAA8B,CAC5C,OAAuD;IAEvD,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;IAClC,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,UAAU,IAAI,MAAM,CAAC,QAAQ,EAAE,KAAK,KAAK,EAAE,CAAC;QACpF,MAAM,MAAM,CAAC,MAAM,CACjB,IAAI,KAAK,CAAC,uDAAuD,CAAC,EAClE,EAAE,IAAI,EAAE,+BAA+B,EAAE,CAC1C,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,CAAC,UAAU,EAAE,EAAE,CAAC;QACxB,MAAM,MAAM,CAAC,MAAM,CACjB,IAAI,KAAK,CAAC,8CAA8C,CAAC,EACzD,EAAE,IAAI,EAAE,iCAAiC,EAAE,CAC5C,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,CAAC,YAAY,IAAI,OAAO,OAAO,CAAC,YAAY,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;QAC/E,MAAM,MAAM,CAAC,MAAM,CACjB,IAAI,KAAK,CAAC,qDAAqD,CAAC,EAChE,EAAE,IAAI,EAAE,qCAAqC,EAAE,CAChD,CAAC;IACJ,CAAC;IAED,IAAI,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,IAAI,CAAC;IAChD,IAAI,QAAQ,GAAG,KAAK,CAAC;IAErB,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,MAAM;QACN,UAAU;YACR,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,OAAO;YACL,IAAI,QAAQ;gBAAE,OAAO;YACrB,IAAI,YAAY,EAAE,CAAC;gBACjB,YAAY,CAAC,OAAO,EAAE,CAAC;gBACvB,YAAY,GAAG,IAAI,CAAC;YACtB,CAAC;YACD,MAAM,CAAC,OAAO,EAAE,CAAC;YACjB,QAAQ,GAAG,IAAI,CAAC;QAClB,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,+BAA+B,CAC7C,MAAc,EACd,KAAc,EACd,IAAI,GAAG,oBAAoB;IAE3B,MAAM,QAAQ,GAAG,iCAAiC,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAChE,MAAM,QAAQ,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAChD,IAAI,CAAC;QACH,MAAM,CAAC,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;QAC5B,MAAM,CAAC,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;QAC5B,MAAM,CAAC,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC;QAC1B,MAAM,CAAC,IAAI,GAAG,QAAQ,CAAC,UAAU,KAAK,aAAa;YACjD,CAAC,CAAC,MAAM,CAAC,kBAAkB;YAC3B,CAAC,CAAC,MAAM,CAAC,mBAAmB,CAAC;QAC/B,wBAAwB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAC3C,MAAM,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;QACjC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,aAAa,GAAc,EAAE,CAAC;QACpC,IAAI,CAAC;YACH,sBAAsB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YACzC,MAAM,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;QACnC,CAAC;QAAC,OAAO,YAAY,EAAE,CAAC;YACtB,aAAa,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACnC,CAAC;QACD,MAAM,kBAAkB,CAAC,KAAK,EAAE,yCAAyC,EAAE,aAAa,CAAC,CAAC;IAC5F,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gCAAgC,CAC9C,MAAc,EACd,KAAc,EACd,IAAI,GAAG,oBAAoB;IAE3B,MAAM,QAAQ,GAAG,iCAAiC,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAChE,IAAI,QAAQ,CAAC,UAAU,KAAK,cAAc;QAAE,OAAO,QAAQ,CAAC;IAC5D,MAAM,QAAQ,GAAG,0BAA0B,CAAC,MAAM,CAAC,CAAC;IACpD,IAAI,CAAC;QACH,wBAAwB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAC3C,MAAM,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;QACjC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,aAAa,GAAc,EAAE,CAAC;QACpC,IAAI,CAAC;YACH,0BAA0B,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YAC7C,MAAM,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;QACnC,CAAC;QAAC,OAAO,YAAY,EAAE,CAAC;YACtB,aAAa,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACnC,CAAC;QACD,MAAM,kBAAkB,CAAC,KAAK,EAAE,0CAA0C,EAAE,aAAa,CAAC,CAAC;IAC7F,CAAC;AACH,CAAC;AAkBD,SAAS,wBAAwB,CAC/B,MAAc,EACd,QAA+C;IAE/C,IAAI,QAAQ,CAAC,UAAU,KAAK,cAAc;QAAE,OAAO;IACnD,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,CAAC;IAC7C,MAAM,KAAK,GAAG,qBAAqB,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC;IAC7D,MAAM,MAAM,GAAG,qBAAqB,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC,CAAC;IAC/D,MAAM,UAAU,GAAG,QAAQ,CAAC,SAAS,CAAC;IACtC,MAAM,SAAS,GAAG,UAAU,GAAG,CAAC,KAAK,GAAG,MAAM,CAAC,CAAC;IAChD,MAAM,CAAC,SAAS,GAAG,CAAC,SAAS,CAAC;IAC9B,MAAM,CAAC,UAAU,GAAG,SAAS,CAAC;IAC9B,MAAM,CAAC,WAAW,GAAG,CAAC,UAAU,CAAC;IACjC,MAAM,CAAC,QAAQ,GAAG,UAAU,CAAC;AAC/B,CAAC;AAED,SAAS,sBAAsB,CAAC,MAAc;IAC5C,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,GAAG,0BAA0B,CAAC,MAAM,CAAC;KACtC,CAAC;AACJ,CAAC;AAED,SAAS,sBAAsB,CAC7B,MAAc,EACd,KAAmC;IAEnC,MAAM,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;IACzB,MAAM,CAAC,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC;IACvB,MAAM,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;IACzB,MAAM,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;IACzB,0BAA0B,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAC5C,CAAC;AAED,SAAS,0BAA0B,CAAC,MAAc;IAChD,OAAO;QACL,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,WAAW,EAAE,MAAM,CAAC,WAAW;KAChC,CAAC;AACJ,CAAC;AAED,SAAS,0BAA0B,CACjC,MAAc,EACd,KAAuC;IAEvC,MAAM,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;IACnC,MAAM,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;IACrC,MAAM,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;IACjC,MAAM,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;AACzC,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAa;IAC1C,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AACzD,CAAC;AAED,SAAS,kBAAkB,CACzB,OAAgB,EAChB,eAAuB,EACvB,aAAiC;IAEjC,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC;IAC/C,IAAI,OAAO,IAAI,CAAC,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,OAAO,KAAK,UAAU,CAAC,EAAE,CAAC;QAC9E,IAAI,CAAC;YACH,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC;YAC7E,OAAO,OAAO,CAAC;QACjB,CAAC;QAAC,MAAM,CAAC;YACP,kEAAkE;QACpE,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,eAAe,CAAC,EAAE;QAC/C,KAAK,EAAE,OAAO;QACd,aAAa,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC;KACjD,CAAC,CAAC;AACL,CAAC"}

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/game-world-plugin-lifecycle.d.ts

@@ -0,0 +1,26 @@
+import type { FpsGeneratedAssetCatalog, FpsRuntimeData } from '../runtime-data-types.js';
+import type { FpsDiagnostic, FpsPluginEnvironmentModule } from '@fps-games/plugin-sdk';
+import { type FpsPluginHost } from '@fps-games/plugin-sdk/host';
+import { type FpsRuntimeFrameInput, type FpsRuntimeFrameSchedulerSnapshot } from '@fps-games/plugin-sdk/runtime';
+import { type FpsBabylonRendererContext, type FpsBabylonRendererService } from './renderer-controller.js';
+export interface FpsBabylonGameWorldPluginLifecycleOptions {
+    readonly runtimeModule: FpsPluginEnvironmentModule;
+    readonly rendererModule: FpsPluginEnvironmentModule;
+    readonly runtimeData: FpsRuntimeData;
+    readonly assetCatalog: FpsGeneratedAssetCatalog;
+    readonly apiVersion: number;
+    readonly report?: (diagnostic: FpsDiagnostic) => void;
+}
+export interface FpsBabylonGameWorldPluginLifecycle {
+    readonly runtimeHost: FpsPluginHost | null;
+    readonly rendererHost: FpsPluginHost | null;
+    readonly renderer: FpsBabylonRendererService | null;
+    startRuntime(): Promise<void>;
+    advanceFrame(input: FpsRuntimeFrameInput): void;
+    inspectFrames(): FpsRuntimeFrameSchedulerSnapshot | null;
+    attachRenderer(context: FpsBabylonRendererContext): Promise<FpsBabylonRendererService>;
+    detachRenderer(): Promise<void>;
+    dispose(): Promise<void>;
+}
+export declare function createFpsBabylonGameWorldPluginLifecycle(options: FpsBabylonGameWorldPluginLifecycleOptions): FpsBabylonGameWorldPluginLifecycle;
+//# sourceMappingURL=game-world-plugin-lifecycle.d.ts.map

package/dist/babylon/game-world-plugin-lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"game-world-plugin-lifecycle.d.ts","sourceRoot":"","sources":["../../src/babylon/game-world-plugin-lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAEzF,OAAO,KAAK,EACV,aAAa,EACb,0BAA0B,EAC3B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAEL,KAAK,aAAa,EACnB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAGL,KAAK,oBAAoB,EAEzB,KAAK,gCAAgC,EACtC,MAAM,+BAA+B,CAAC;AAQvC,OAAO,EACL,KAAK,yBAAyB,EAC9B,KAAK,yBAAyB,EAC/B,MAAM,0BAA0B,CAAC;AAElC,MAAM,WAAW,yCAAyC;IACxD,QAAQ,CAAC,aAAa,EAAE,0BAA0B,CAAC;IACnD,QAAQ,CAAC,cAAc,EAAE,0BAA0B,CAAC;IACpD,QAAQ,CAAC,WAAW,EAAE,cAAc,CAAC;IACrC,QAAQ,CAAC,YAAY,EAAE,wBAAwB,CAAC;IAChD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,UAAU,EAAE,aAAa,KAAK,IAAI,CAAC;CACvD;AAED,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,WAAW,EAAE,aAAa,GAAG,IAAI,CAAC;IAC3C,QAAQ,CAAC,YAAY,EAAE,aAAa,GAAG,IAAI,CAAC;IAC5C,QAAQ,CAAC,QAAQ,EAAE,yBAAyB,GAAG,IAAI,CAAC;IACpD,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,YAAY,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAChD,aAAa,IAAI,gCAAgC,GAAG,IAAI,CAAC;IACzD,cAAc,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAAC;IACvF,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAID,wBAAgB,wCAAwC,CACtD,OAAO,EAAE,yCAAyC,GACjD,kCAAkC,CAkPpC"}