@fps-games/engine 0.0.1-beta.4 → 0.0.1-beta.8

package/dist/asset-resource.d.ts

@@ -0,0 +1,39 @@
+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;
+//# 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,CAoC1B;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"}

package/dist/asset-resource.js

@@ -0,0 +1,121 @@
+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);
+                return resolved({
+                    assetId: entry.assetId,
+                    url: entry.url,
+                    format: entry.format,
+                    transport: getFpsAssetResourceTransport(entry.url),
+                    relativePath: entry.relativePath,
+                    originalFileName: entry.originalFileName ?? null,
+                });
+            }
+            if (!url)
+                return failed('asset.resource.invalid-reference', null, null, null, null);
+            const transport = getFpsAssetResourceTransport(url);
+            if (transport === 'data-url' || transport === 'blob-url') {
+                return failed('asset.resource.format-missing', null, null, transport, url);
+            }
+            const format = getFpsAssetFormat(url);
+            if (!format)
+                return failed('asset.resource.format-missing', null, null, transport, url);
+            if (!isFpsAssetFormatSupported(format)) {
+                return failed('asset.resource.format-unsupported', null, format, transport, url);
+            }
+            return resolved({ assetId: null, url, 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';
+}
+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/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"}

package/dist/babylon/game-world-plugin-lifecycle.js

@@ -0,0 +1,257 @@
+import { createFpsRuntimeDataSnapshot } from '../runtime-data.js';
+import { createFpsPluginHostFromEnvironmentModule, } from '@fps-games/plugin-sdk/host';
+import { createFpsRuntimeFrameScheduler, FPS_RUNTIME_FRAME_SCHEDULER, } from '@fps-games/plugin-sdk/runtime';
+import { FPS_ASSET_CATALOG_SOURCE, FPS_BABYLON_RENDERER_CONTEXT, FPS_BABYLON_RENDERER_DATA, FPS_BABYLON_RENDERER_SERVICE, FPS_RUNTIME_DATA, } from './plugin-contract.js';
+import {} from './renderer-controller.js';
+export function createFpsBabylonGameWorldPluginLifecycle(options) {
+    assertEnvironmentModule(options.runtimeModule, 'runtime');
+    assertEnvironmentModule(options.rendererModule, 'renderer');
+    const runtimeData = createFpsRuntimeDataSnapshot(options.runtimeData);
+    let runtimeHost = null;
+    let runtimeFrames = null;
+    let rendererHost = null;
+    let renderer = null;
+    let rendererScene = null;
+    let rendererOwnershipOpen = false;
+    let operationInProgress = null;
+    const run = (operation, callback) => {
+        if (operationInProgress) {
+            return Promise.reject(new Error(`GameWorld Plugin lifecycle cannot ${operation} while ${operationInProgress} is in progress.`));
+        }
+        operationInProgress = operation;
+        return callback().finally(() => { operationInProgress = null; });
+    };
+    const clearRuntimeHostIfDisposed = (host) => {
+        if (runtimeHost !== host || host.state !== 'disposed')
+            return;
+        runtimeHost = null;
+        runtimeFrames?.driver.dispose();
+        runtimeFrames = null;
+    };
+    const clearRendererHostIfDisposed = (host) => {
+        if (rendererHost !== host || host.state !== 'disposed')
+            return;
+        rendererHost = null;
+        renderer = null;
+        rendererScene = null;
+        rendererOwnershipOpen = false;
+    };
+    const cleanupFailedStart = async (host, clear, primaryError) => {
+        const cleanupErrors = [];
+        if (host.state !== 'disposed') {
+            try {
+                await host.dispose();
+            }
+            catch (error) {
+                cleanupErrors.push(error);
+            }
+        }
+        clear(host);
+        if (cleanupErrors.length > 0 && primaryError && typeof primaryError === 'object') {
+            try {
+                Object.assign(primaryError, { cleanupErrors: Object.freeze(cleanupErrors) });
+            }
+            catch { /* Preserve the primary failure even when it cannot be annotated. */ }
+        }
+        throw primaryError;
+    };
+    const startRuntime = () => run('start-runtime', async () => {
+        if (runtimeHost?.state === 'started')
+            return;
+        if (runtimeHost) {
+            throw new Error(`GameWorld Runtime Host is retained in ${runtimeHost.state}; dispose it before restarting.`);
+        }
+        const frames = createFpsRuntimeFrameScheduler({ report: options.report });
+        let host;
+        try {
+            host = createFpsPluginHostFromEnvironmentModule({
+                module: options.runtimeModule,
+                apiVersion: options.apiVersion,
+                scope: 'project',
+                initialServices: [
+                    { token: FPS_RUNTIME_DATA, value: runtimeData },
+                    {
+                        token: FPS_ASSET_CATALOG_SOURCE,
+                        value: Object.freeze({ catalog: options.assetCatalog }),
+                    },
+                    { token: FPS_RUNTIME_FRAME_SCHEDULER, value: frames.scheduler },
+                ],
+                report: options.report,
+            });
+        }
+        catch (error) {
+            frames.driver.dispose();
+            throw error;
+        }
+        runtimeHost = host;
+        runtimeFrames = frames;
+        try {
+            await host.start();
+        }
+        catch (error) {
+            return cleanupFailedStart(host, clearRuntimeHostIfDisposed, error);
+        }
+    });
+    const advanceFrame = (input) => {
+        if (operationInProgress) {
+            throw new Error(`GameWorld Runtime frames cannot advance while ${operationInProgress} is in progress.`);
+        }
+        if (runtimeHost?.state !== 'started' || !runtimeFrames) {
+            throw new Error(`GameWorld Runtime frames require a started Host, got: ${runtimeHost?.state ?? 'absent'}.`);
+        }
+        runtimeFrames.driver.advance(input);
+    };
+    const attachRenderer = (context) => run('attach-renderer', async () => {
+        if (runtimeHost?.state !== 'started') {
+            throw new Error('GameWorld Runtime Host must be started before attaching the Renderer Host.');
+        }
+        if (rendererHost?.state === 'started' && renderer) {
+            if (rendererScene !== context.scene) {
+                throw new Error('GameWorld Renderer Host is already attached to a different Scene.');
+            }
+            return renderer;
+        }
+        if (rendererHost) {
+            throw new Error(`GameWorld Renderer Host is retained in ${rendererHost.state}; detach it before restarting.`);
+        }
+        const host = createFpsPluginHostFromEnvironmentModule({
+            module: options.rendererModule,
+            apiVersion: options.apiVersion,
+            scope: 'application',
+            initialServices: [
+                { token: FPS_BABYLON_RENDERER_CONTEXT, value: context },
+                { token: FPS_BABYLON_RENDERER_DATA, value: runtimeData },
+                {
+                    token: FPS_ASSET_CATALOG_SOURCE,
+                    value: Object.freeze({ catalog: options.assetCatalog }),
+                },
+            ],
+            report: options.report,
+        });
+        rendererHost = host;
+        rendererScene = context.scene;
+        try {
+            await host.start();
+            const rendererController = host.services.get(FPS_BABYLON_RENDERER_SERVICE);
+            rendererOwnershipOpen = true;
+            const shadows = Object.freeze({
+                registerRuntimeShadowObjects: (input) => {
+                    assertRendererOwnershipOpen(rendererOwnershipOpen);
+                    return rendererController.shadows.registerRuntimeShadowObjects(input);
+                },
+                registerActivitySource: (input) => {
+                    assertRendererOwnershipOpen(rendererOwnershipOpen);
+                    return rendererController.shadows.registerActivitySource(input);
+                },
+                getRuntimeSnapshot: () => rendererController.shadows.getRuntimeSnapshot(),
+                getEvidence: () => rendererController.shadows.getEvidence(),
+                getAppearance: () => rendererController.shadows.getAppearance(),
+                previewAppearance: (input) => {
+                    assertRendererOwnershipOpen(rendererOwnershipOpen);
+                    return rendererController.shadows.previewAppearance(input);
+                },
+            });
+            const cameras = Object.freeze({
+                register: (camera) => {
+                    assertRendererOwnershipOpen(rendererOwnershipOpen);
+                    const registration = rendererController.cameras.register(camera);
+                    let registrationOpen = true;
+                    return Object.freeze({
+                        dispose() {
+                            if (!registrationOpen)
+                                return;
+                            registration.dispose();
+                            registrationOpen = false;
+                        },
+                    });
+                },
+            });
+            const lighting = Object.freeze({
+                previewDirectionalLight: (input) => {
+                    assertRendererOwnershipOpen(rendererOwnershipOpen);
+                    rendererController.lighting.previewDirectionalLight(input);
+                },
+            });
+            const rendering = Object.freeze({
+                getEnvironmentAppearance: () => rendererController.rendering.getEnvironmentAppearance(),
+                previewEnvironmentAppearance: (input) => {
+                    assertRendererOwnershipOpen(rendererOwnershipOpen);
+                    return rendererController.rendering.previewEnvironmentAppearance(input);
+                },
+            });
+            renderer = Object.freeze({ cameras, lighting, rendering, shadows });
+            return renderer;
+        }
+        catch (error) {
+            return cleanupFailedStart(host, clearRendererHostIfDisposed, error);
+        }
+    });
+    const detachRenderer = () => run('detach-renderer', async () => {
+        const host = rendererHost;
+        if (!host)
+            return;
+        rendererOwnershipOpen = false;
+        try {
+            await host.dispose();
+        }
+        finally {
+            clearRendererHostIfDisposed(host);
+        }
+    });
+    const dispose = () => run('dispose', async () => {
+        const errors = [];
+        const currentRendererHost = rendererHost;
+        if (currentRendererHost) {
+            rendererOwnershipOpen = false;
+            try {
+                await currentRendererHost.dispose();
+            }
+            catch (error) {
+                errors.push(error);
+            }
+            finally {
+                clearRendererHostIfDisposed(currentRendererHost);
+            }
+        }
+        const currentRuntimeHost = runtimeHost;
+        if (currentRuntimeHost) {
+            try {
+                await currentRuntimeHost.dispose();
+            }
+            catch (error) {
+                errors.push(error);
+            }
+            finally {
+                clearRuntimeHostIfDisposed(currentRuntimeHost);
+            }
+        }
+        if (errors.length === 1)
+            throw errors[0];
+        if (errors.length > 1) {
+            throw Object.assign(new Error('GameWorld Plugin lifecycle disposal failed.'), {
+                cleanupErrors: Object.freeze(errors),
+            });
+        }
+    });
+    return Object.freeze({
+        get runtimeHost() { return runtimeHost; },
+        get rendererHost() { return rendererHost; },
+        get renderer() { return renderer; },
+        startRuntime,
+        advanceFrame,
+        inspectFrames: () => runtimeFrames?.scheduler.snapshot() ?? null,
+        attachRenderer,
+        detachRenderer,
+        dispose,
+    });
+}
+function assertRendererOwnershipOpen(open) {
+    if (!open)
+        throw new Error('Babylon renderer service is disposed.');
+}
+function assertEnvironmentModule(module, expectedEnvironment) {
+    if (module.environment !== expectedEnvironment) {
+        throw new Error(`Expected a ${expectedEnvironment} Plugin environment module, received ${module.environment}.`);
+    }
+}
+//# sourceMappingURL=game-world-plugin-lifecycle.js.map

package/dist/babylon/game-world-plugin-lifecycle.js.map

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

package/dist/babylon/plugin-contract.d.ts

@@ -0,0 +1,15 @@
+import type { FpsAssetResourceResolver } from '../asset-resource.js';
+import type { FpsGeneratedAssetCatalog, FpsRuntimeData } from '../runtime-data-types.js';
+import type { FpsBabylonRendererContext, FpsBabylonRendererHostController } from './renderer-controller.js';
+export declare const FPS_BABYLON_RENDERER_PLUGIN_ID: "fps.renderer.babylon";
+export type FpsBabylonRendererPluginConfig = Readonly<Record<string, never>>;
+export interface FpsAssetCatalogSource {
+    readonly catalog: FpsGeneratedAssetCatalog;
+}
+export declare const FPS_RUNTIME_DATA: import("@fps-games/plugin-sdk").FpsServiceToken<FpsRuntimeData<import("../runtime-data-types.js").FpsRuntimeAsset, import("../runtime-data-types.js").FpsRuntimeSceneNode>>;
+export declare const FPS_ASSET_CATALOG_SOURCE: import("@fps-games/plugin-sdk").FpsServiceToken<FpsAssetCatalogSource>;
+export declare const FPS_ASSET_RESOURCE_RESOLVER: import("@fps-games/plugin-sdk").FpsServiceToken<FpsAssetResourceResolver>;
+export declare const FPS_BABYLON_RENDERER_CONTEXT: import("@fps-games/plugin-sdk").FpsServiceToken<FpsBabylonRendererContext>;
+export declare const FPS_BABYLON_RENDERER_DATA: import("@fps-games/plugin-sdk").FpsServiceToken<FpsRuntimeData<import("../runtime-data-types.js").FpsRuntimeAsset, import("../runtime-data-types.js").FpsRuntimeSceneNode>>;
+export declare const FPS_BABYLON_RENDERER_SERVICE: import("@fps-games/plugin-sdk").FpsServiceToken<FpsBabylonRendererHostController>;
+//# sourceMappingURL=plugin-contract.d.ts.map

package/dist/babylon/plugin-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-contract.d.ts","sourceRoot":"","sources":["../../src/babylon/plugin-contract.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,KAAK,EAAE,wBAAwB,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AACzF,OAAO,KAAK,EACV,yBAAyB,EACzB,gCAAgC,EACjC,MAAM,0BAA0B,CAAC;AAElC,eAAO,MAAM,8BAA8B,EAAG,sBAA+B,CAAC;AAC9E,MAAM,MAAM,8BAA8B,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;AAE7E,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,EAAE,wBAAwB,CAAC;CAC5C;AAED,eAAO,MAAM,gBAAgB,6KAA4D,CAAC;AAC1F,eAAO,MAAM,wBAAwB,wEAEpC,CAAC;AACF,eAAO,MAAM,2BAA2B,2EAEvC,CAAC;AACF,eAAO,MAAM,4BAA4B,4EAExC,CAAC;AACF,eAAO,MAAM,yBAAyB,6KAErC,CAAC;AACF,eAAO,MAAM,4BAA4B,mFAExC,CAAC"}

package/dist/babylon/plugin-contract.js

@@ -0,0 +1,9 @@
+import { defineFpsServiceToken } from '@fps-games/plugin-sdk';
+export const FPS_BABYLON_RENDERER_PLUGIN_ID = 'fps.renderer.babylon';
+export const FPS_RUNTIME_DATA = defineFpsServiceToken('fps.runtime.data');
+export const FPS_ASSET_CATALOG_SOURCE = defineFpsServiceToken('fps.asset.catalog.source');
+export const FPS_ASSET_RESOURCE_RESOLVER = defineFpsServiceToken('fps.asset.resource.resolver');
+export const FPS_BABYLON_RENDERER_CONTEXT = defineFpsServiceToken('fps.renderer.babylon.context');
+export const FPS_BABYLON_RENDERER_DATA = defineFpsServiceToken('fps.renderer.babylon.runtime-data');
+export const FPS_BABYLON_RENDERER_SERVICE = defineFpsServiceToken('fps.renderer.babylon.service');
+//# sourceMappingURL=plugin-contract.js.map

package/dist/babylon/plugin-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-contract.js","sourceRoot":"","sources":["../../src/babylon/plugin-contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAQ9D,MAAM,CAAC,MAAM,8BAA8B,GAAG,sBAA+B,CAAC;AAO9E,MAAM,CAAC,MAAM,gBAAgB,GAAG,qBAAqB,CAAiB,kBAAkB,CAAC,CAAC;AAC1F,MAAM,CAAC,MAAM,wBAAwB,GAAG,qBAAqB,CAC3D,0BAA0B,CAC3B,CAAC;AACF,MAAM,CAAC,MAAM,2BAA2B,GAAG,qBAAqB,CAC9D,6BAA6B,CAC9B,CAAC;AACF,MAAM,CAAC,MAAM,4BAA4B,GAAG,qBAAqB,CAC/D,8BAA8B,CAC/B,CAAC;AACF,MAAM,CAAC,MAAM,yBAAyB,GAAG,qBAAqB,CAC5D,mCAAmC,CACpC,CAAC;AACF,MAAM,CAAC,MAAM,4BAA4B,GAAG,qBAAqB,CAC/D,8BAA8B,CAC/B,CAAC"}

package/dist/babylon/renderer/brdf-texture-settlement.d.ts

@@ -0,0 +1,7 @@
+import type { Scene } from '@babylonjs/core/scene.js';
+export interface BabylonBrdfTextureSettlementOptions {
+    readonly pollIntervalMs?: number;
+    readonly timeoutMs?: number;
+}
+export declare function waitForBabylonSceneBrdfTextures(scene: Scene, options?: BabylonBrdfTextureSettlementOptions): Promise<void>;
+//# sourceMappingURL=brdf-texture-settlement.d.ts.map

package/dist/babylon/renderer/brdf-texture-settlement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brdf-texture-settlement.d.ts","sourceRoot":"","sources":["../../../src/babylon/renderer/brdf-texture-settlement.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAYtD,MAAM,WAAW,mCAAmC;IAClD,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAKD,wBAAsB,+BAA+B,CACnD,KAAK,EAAE,KAAK,EACZ,OAAO,GAAE,mCAAwC,GAChD,OAAO,CAAC,IAAI,CAAC,CAgBf"}

package/dist/babylon/renderer/brdf-texture-settlement.js

@@ -0,0 +1,29 @@
+const DEFAULT_POLL_INTERVAL_MS = 1;
+const DEFAULT_TIMEOUT_MS = 10_000;
+export async function waitForBabylonSceneBrdfTextures(scene, options = {}) {
+    const pollIntervalMs = Math.max(0, options.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS);
+    const timeoutMs = Math.max(0, options.timeoutMs ?? DEFAULT_TIMEOUT_MS);
+    const deadline = Date.now() + timeoutMs;
+    while (hasPendingBrdfTexture(scene)) {
+        if (Date.now() >= deadline) {
+            throw Object.assign(new Error('Babylon Scene BRDF texture preprocessing did not settle before lifecycle cleanup.'), { code: 'babylon.brdf-texture.settle-timeout' });
+        }
+        await new Promise(resolve => {
+            globalThis.setTimeout(resolve, pollIntervalMs);
+        });
+    }
+}
+function hasPendingBrdfTexture(scene) {
+    const sceneWithBrdfTextures = scene;
+    return [
+        sceneWithBrdfTextures.environmentBRDFTexture,
+        sceneWithBrdfTextures.environmentFuzzBRDFTexture,
+    ].some(texture => {
+        if (!texture)
+            return false;
+        if (texture.getScene?.() === null)
+            return false;
+        return !texture.isReady();
+    });
+}
+//# sourceMappingURL=brdf-texture-settlement.js.map

package/dist/babylon/renderer/brdf-texture-settlement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brdf-texture-settlement.js","sourceRoot":"","sources":["../../../src/babylon/renderer/brdf-texture-settlement.ts"],"names":[],"mappings":"AAiBA,MAAM,wBAAwB,GAAG,CAAC,CAAC;AACnC,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAElC,MAAM,CAAC,KAAK,UAAU,+BAA+B,CACnD,KAAY,EACZ,UAA+C,EAAE;IAEjD,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,cAAc,IAAI,wBAAwB,CAAC,CAAC;IACvF,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,SAAS,IAAI,kBAAkB,CAAC,CAAC;IACvE,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;IAExC,OAAO,qBAAqB,CAAC,KAAK,CAAC,EAAE,CAAC;QACpC,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,QAAQ,EAAE,CAAC;YAC3B,MAAM,MAAM,CAAC,MAAM,CACjB,IAAI,KAAK,CAAC,mFAAmF,CAAC,EAC9F,EAAE,IAAI,EAAE,qCAAqC,EAAE,CAChD,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,OAAO,CAAO,OAAO,CAAC,EAAE;YAChC,UAAU,CAAC,UAAU,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QACjD,CAAC,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAY;IACzC,MAAM,qBAAqB,GAAG,KAAgD,CAAC;IAC/E,OAAO;QACL,qBAAqB,CAAC,sBAAsB;QAC5C,qBAAqB,CAAC,0BAA0B;KACjD,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE;QACf,IAAI,CAAC,OAAO;YAAE,OAAO,KAAK,CAAC;QAC3B,IAAI,OAAO,CAAC,QAAQ,EAAE,EAAE,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QAChD,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;IAC5B,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/babylon/renderer/environment/environment-texture-controller.d.ts

@@ -0,0 +1,7 @@
+import '@babylonjs/core/Materials/Textures/baseTexture.polynomial.js';
+import type { Scene } from '@babylonjs/core/scene.js';
+import { type BabylonEnvironmentTextureController, type BabylonEnvironmentTextureControllerOptions } from './types.js';
+export type BabylonEnvironmentTextureControllerCleanup = () => readonly unknown[];
+export declare function readBabylonEnvironmentTextureControllerCleanup(error: unknown): BabylonEnvironmentTextureControllerCleanup | null;
+export declare function createBabylonEnvironmentTextureController(scene: Scene, options?: BabylonEnvironmentTextureControllerOptions): BabylonEnvironmentTextureController;
+//# sourceMappingURL=environment-texture-controller.d.ts.map

package/dist/babylon/renderer/environment/environment-texture-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment-texture-controller.d.ts","sourceRoot":"","sources":["../../../../src/babylon/renderer/environment/environment-texture-controller.ts"],"names":[],"mappings":"AAGA,OAAO,8DAA8D,CAAC;AACtE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAEtD,OAAO,EACL,KAAK,mCAAmC,EACxC,KAAK,0CAA0C,EAIhD,MAAM,YAAY,CAAC;AAQpB,MAAM,MAAM,0CAA0C,GAAG,MAAM,SAAS,OAAO,EAAE,CAAC;AAElF,wBAAgB,8CAA8C,CAC5D,KAAK,EAAE,OAAO,GACb,0CAA0C,GAAG,IAAI,CAOnD;AAED,wBAAgB,yCAAyC,CACvD,KAAK,EAAE,KAAK,EACZ,OAAO,GAAE,0CAA+C,GACvD,mCAAmC,CAKrC"}