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

package/dist/babylon/renderer/asset-container-instantiation.js

@@ -0,0 +1,287 @@
+import { collectBabylonMaterialOwnerCandidates } from './material-owner-candidates.js';
+const sourceBlueprintByContainer = new WeakMap();
+/**
+ * Delegates to Babylon's normal AssetContainer instantiation while retaining
+ * source identity that Babylon does not copy onto newly created InstancedMesh nodes.
+ */
+export function instantiateBabylonAssetContainerWithMaterialOwnerEvidence(container, options) {
+    const sourceBlueprint = getAssetContainerSourceBlueprint(container);
+    const sourceRoots = sourceBlueprint.roots;
+    const runtimeSourceNames = new Map();
+    const entries = container.instantiateModelsToScene(sourceName => {
+        const runtimeName = options.nameFunction(sourceName);
+        let sourceNames = runtimeSourceNames.get(runtimeName);
+        if (!sourceNames) {
+            sourceNames = new Set();
+            runtimeSourceNames.set(runtimeName, sourceNames);
+        }
+        sourceNames.add(sourceName);
+        return runtimeName;
+    }, options.cloneMaterials ?? false, options.instantiateOptions);
+    const instantiatedRoots = uniqueObjects(entries.rootNodes ?? []);
+    const sourceNameByRuntimeNode = new WeakMap();
+    const evidenceByRuntimeNode = new WeakMap();
+    const counts = {
+        mappedNodeCount: 0,
+        preservedEvidenceCount: 0,
+        ambiguousGroupCount: 0,
+        unmatchedSourceNodeCount: 0,
+        unmatchedInstantiatedNodeCount: 0,
+    };
+    const readRuntimeSourceName = (node) => {
+        if (!isObject(node))
+            return null;
+        for (const value of [node.name, node.id]) {
+            if (typeof value !== 'string')
+                continue;
+            const names = runtimeSourceNames.get(value);
+            if (names?.size === 1)
+                return [...names][0] ?? null;
+        }
+        return null;
+    };
+    const runtimeStructure = createNodeStructureIdentity(instantiatedRoots, readRuntimeSourceName, sourceBlueprint.structureInterner, (runtimeNode, sourceName) => {
+        if (sourceName)
+            sourceNameByRuntimeNode.set(runtimeNode, sourceName);
+    });
+    matchNodeGroups(sourceRoots, instantiatedRoots, sourceBlueprint.structureIdByNode, runtimeStructure.structureIdByNode, sourceBlueprint.sourceNameByNode, sourceBlueprint.childrenByNode, runtimeStructure.childrenByNode, (sourceNode, runtimeNode, sourceName) => {
+        if (!isObject(runtimeNode))
+            return;
+        sourceNameByRuntimeNode.set(runtimeNode, sourceName);
+        counts.mappedNodeCount += 1;
+        const evidence = sourceBlueprint.evidenceByNode.get(sourceNode);
+        if (evidence) {
+            evidenceByRuntimeNode.set(runtimeNode, evidence);
+            counts.preservedEvidenceCount += 1;
+        }
+    }, counts);
+    const sourceNodeCount = sourceBlueprint.nodeCount;
+    const instantiatedNodeCount = runtimeStructure.nodeCount;
+    const diagnostic = Object.freeze({
+        status: counts.ambiguousGroupCount === 0
+            && counts.unmatchedSourceNodeCount === 0
+            && counts.unmatchedInstantiatedNodeCount === 0
+            ? 'complete'
+            : 'partial',
+        sourceNodeCount,
+        instantiatedNodeCount,
+        ...counts,
+    });
+    return {
+        entries,
+        identity: Object.freeze({
+            readSourceName(node) {
+                return isObject(node)
+                    ? sourceNameByRuntimeNode.get(node) ?? sourceBlueprint.sourceNameByNode.get(node) ?? null
+                    : null;
+            },
+            readInstanceOwnerEvidence(node) {
+                return isObject(node) ? evidenceByRuntimeNode.get(node) ?? null : null;
+            },
+        }),
+        diagnostic,
+    };
+}
+function getAssetContainerSourceBlueprint(container) {
+    const cached = sourceBlueprintByContainer.get(container);
+    if (cached)
+        return cached;
+    const roots = collectAssetContainerSourceRoots(container);
+    const sourceNameByNode = new WeakMap();
+    const structureInterner = {
+        ids: new Map(),
+        nextId: 1,
+    };
+    const structure = createNodeStructureIdentity(roots, readSourceNodeName, structureInterner, (node, sourceName) => {
+        if (sourceName)
+            sourceNameByNode.set(node, sourceName);
+    });
+    const blueprint = {
+        roots,
+        evidenceByNode: collectSourceMaterialOwnerEvidence(roots),
+        sourceNameByNode,
+        structureIdByNode: structure.structureIdByNode,
+        childrenByNode: structure.childrenByNode,
+        structureInterner,
+        nodeCount: structure.nodeCount,
+    };
+    sourceBlueprintByContainer.set(container, blueprint);
+    return blueprint;
+}
+function collectAssetContainerSourceRoots(container) {
+    const nodes = uniqueObjects([
+        ...(container.transformNodes ?? []),
+        ...(container.meshes ?? []),
+    ]);
+    const nodeSet = new Set(nodes);
+    return nodes.filter(node => !isObject(node?.parent) || !nodeSet.has(node.parent));
+}
+function collectSourceMaterialOwnerEvidence(roots) {
+    const evidenceByNode = new WeakMap();
+    for (const root of roots) {
+        for (const candidate of collectBabylonMaterialOwnerCandidates(root)) {
+            const node = candidate.target.runtimeNode;
+            if (!isObject(node))
+                continue;
+            const evidence = freezePointerEvidence(candidate);
+            if (evidence)
+                evidenceByNode.set(node, evidence);
+        }
+    }
+    return evidenceByNode;
+}
+function freezePointerEvidence(evidence) {
+    if (!hasPointerEvidence(evidence))
+        return null;
+    return Object.freeze({
+        ...(isFiniteIndex(evidence.nodeIndex) ? { nodeIndex: evidence.nodeIndex } : {}),
+        ...(evidence.nodeIndexPath?.length
+            ? { nodeIndexPath: Object.freeze([...evidence.nodeIndexPath]) }
+            : {}),
+        ...(isFiniteIndex(evidence.meshIndex) ? { meshIndex: evidence.meshIndex } : {}),
+        ...(isFiniteIndex(evidence.primitiveIndex) ? { primitiveIndex: evidence.primitiveIndex } : {}),
+        ...(evidence.materialIndices?.length
+            ? { materialIndices: Object.freeze([...new Set(evidence.materialIndices)].sort((a, b) => a - b)) }
+            : {}),
+        hasPointerEvidence: true,
+        ...(evidence.pointerAmbiguous ? { pointerAmbiguous: true } : {}),
+        ...(evidence.pointerConflict ? { pointerConflict: true } : {}),
+    });
+}
+function matchNodeGroups(sourceNodes, runtimeNodes, sourceStructureIdByNode, runtimeStructureIdByNode, sourceNameByNode, sourceChildrenByNode, runtimeChildrenByNode, onMatch, counts) {
+    const sourceGroups = groupNodesByStructureId(sourceNodes, sourceStructureIdByNode);
+    const runtimeGroups = groupNodesByStructureId(runtimeNodes, runtimeStructureIdByNode);
+    const structureIds = new Set([...sourceGroups.keys(), ...runtimeGroups.keys()]);
+    for (const structureId of structureIds) {
+        const sourceGroup = sourceGroups.get(structureId) ?? [];
+        const runtimeGroup = runtimeGroups.get(structureId) ?? [];
+        if (sourceGroup.length !== 1 || runtimeGroup.length !== 1) {
+            if (sourceGroup.length > 1 || runtimeGroup.length > 1)
+                counts.ambiguousGroupCount += 1;
+            counts.unmatchedSourceNodeCount += sourceGroup.length;
+            counts.unmatchedInstantiatedNodeCount += runtimeGroup.length;
+            continue;
+        }
+        const sourceNode = sourceGroup[0];
+        const runtimeNode = runtimeGroup[0];
+        const sourceName = isObject(sourceNode) ? sourceNameByNode.get(sourceNode) ?? null : null;
+        if (!sourceName || !isObject(sourceNode) || !isObject(runtimeNode)) {
+            counts.unmatchedSourceNodeCount += 1;
+            counts.unmatchedInstantiatedNodeCount += 1;
+            continue;
+        }
+        onMatch(sourceNode, runtimeNode, sourceName);
+        matchNodeGroups(sourceChildrenByNode.get(sourceNode) ?? [], runtimeChildrenByNode.get(runtimeNode) ?? [], sourceStructureIdByNode, runtimeStructureIdByNode, sourceNameByNode, sourceChildrenByNode, runtimeChildrenByNode, onMatch, counts);
+    }
+}
+function groupNodesByStructureId(nodes, structureIdByNode) {
+    const groups = new Map();
+    for (const node of uniqueObjects(nodes)) {
+        const structureId = structureIdByNode.get(node);
+        if (structureId === undefined)
+            continue;
+        const group = groups.get(structureId) ?? [];
+        group.push(node);
+        groups.set(structureId, group);
+    }
+    return groups;
+}
+function createNodeStructureIdentity(roots, readSourceName, interner, onVisit) {
+    const structureIdByNode = new WeakMap();
+    const childrenByNode = new WeakMap();
+    const visiting = new Set();
+    let nodeCount = 0;
+    const visit = (node) => {
+        if (!isObject(node))
+            return 0;
+        const cached = structureIdByNode.get(node);
+        if (cached !== undefined)
+            return cached;
+        if (visiting.has(node)) {
+            throw new Error('Babylon AssetContainer node hierarchy must be acyclic.');
+        }
+        visiting.add(node);
+        const children = uniqueObjects(readNodeChildren(node));
+        childrenByNode.set(node, children);
+        const childStructureIds = children
+            .map(visit)
+            .sort((left, right) => left - right);
+        const sourceName = readSourceName(node);
+        const structureKey = JSON.stringify([
+            sourceName,
+            isMeshLike(node) ? 'mesh' : 'node',
+            readNodeTransformFingerprint(node),
+            childStructureIds,
+        ]);
+        let structureId = interner.ids.get(structureKey);
+        if (structureId === undefined) {
+            structureId = interner.nextId;
+            interner.nextId += 1;
+            interner.ids.set(structureKey, structureId);
+        }
+        visiting.delete(node);
+        structureIdByNode.set(node, structureId);
+        nodeCount += 1;
+        onVisit?.(node, sourceName);
+        return structureId;
+    };
+    for (const root of uniqueObjects(roots))
+        visit(root);
+    return { structureIdByNode, childrenByNode, nodeCount };
+}
+function readNodeTransformFingerprint(node) {
+    if (!isObject(node))
+        return null;
+    return {
+        position: readNumericTuple(node.position, ['x', 'y', 'z']),
+        rotation: readNumericTuple(node.rotation, ['x', 'y', 'z']),
+        rotationQuaternion: readNumericTuple(node.rotationQuaternion, ['x', 'y', 'z', 'w']),
+        scaling: readNumericTuple(node.scaling, ['x', 'y', 'z']),
+    };
+}
+function readNumericTuple(value, keys) {
+    if (!isObject(value))
+        return null;
+    const tuple = keys.map(key => value[key]);
+    if (!tuple.every(item => typeof item === 'number' && Number.isFinite(item)))
+        return null;
+    return tuple.map(item => Object.is(item, -0) ? 0 : item);
+}
+function readSourceNodeName(node) {
+    if (!isObject(node))
+        return null;
+    for (const value of [node.name, node.id]) {
+        if (typeof value === 'string' && value.trim())
+            return value;
+    }
+    return null;
+}
+function readNodeChildren(node) {
+    if (!isObject(node) || typeof node.getChildren !== 'function')
+        return [];
+    const children = node.getChildren();
+    return Array.isArray(children) ? children : [];
+}
+function uniqueObjects(values) {
+    return [...new Set(values.filter(isObject))];
+}
+function isMeshLike(node) {
+    return isObject(node) && typeof node.getTotalVertices === 'function';
+}
+function hasPointerEvidence(evidence) {
+    return evidence.hasPointerEvidence === true
+        || evidence.pointerConflict === true
+        || evidence.pointerAmbiguous === true
+        || isFiniteIndex(evidence.nodeIndex)
+        || !!evidence.nodeIndexPath?.length
+        || isFiniteIndex(evidence.meshIndex)
+        || isFiniteIndex(evidence.primitiveIndex)
+        || !!evidence.materialIndices?.length;
+}
+function isFiniteIndex(value) {
+    return typeof value === 'number' && Number.isInteger(value) && value >= 0;
+}
+function isObject(value) {
+    return !!value && typeof value === 'object';
+}
+//# sourceMappingURL=asset-container-instantiation.js.map

package/dist/babylon/renderer/asset-container-instantiation.js.map

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

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"}