@babylonjs/loaders 9.20.0 → 9.20.1

package/glTF/2.0/Extensions/KHR_node_visibility.pure.js.map

@@ -1 +1 @@
-{"version":3,"file":"KHR_node_visibility.pure.js","sourceRoot":"","sources":["../../../../../../dev/loaders/src/glTF/2.0/Extensions/KHR_node_visibility.pure.ts"],"names":[],"mappings":"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","sourcesContent":["import { type GLTFLoader } from \"../glTFLoader.pure\";\r\nimport { type IGLTFLoaderExtension } from \"../glTFLoaderExtension\";\r\nimport { registerGLTFExtension, unregisterGLTFExtension } from \"../glTFLoaderExtensionRegistry\";\r\nimport { type AbstractMesh } from \"core/Meshes/abstractMesh\";\r\nimport { type INode } from \"../glTFLoaderInterfaces\";\r\nimport { AddObjectAccessorToKey } from \"./objectModelMapping\";\r\n\r\nconst NAME = \"KHR_node_visibility\";\r\n\r\n// object model extension for visibility\r\n\r\n/**\r\n * Loader extension for KHR_node_visibility\r\n */\r\n// eslint-disable-next-line @typescript-eslint/naming-convention\r\nexport class KHR_node_visibility implements IGLTFLoaderExtension {\r\n    /**\r\n     * The name of this extension.\r\n     */\r\n    public readonly name = NAME;\r\n\r\n    /**\r\n     * Defines whether this extension is enabled.\r\n     */\r\n    public enabled: boolean;\r\n\r\n    private _loader?: GLTFLoader;\r\n\r\n    /**\r\n     * @internal\r\n     */\r\n    constructor(loader: GLTFLoader) {\r\n        this._loader = loader;\r\n        this.enabled = loader.isExtensionUsed(NAME);\r\n    }\r\n\r\n    public onReady(): void {\r\n        if (!this._loader) {\r\n            return;\r\n        }\r\n\r\n        const nodes = this._loader.gltf.nodes;\r\n        if (nodes) {\r\n            for (const node of nodes) {\r\n                const babylonTransformNode = node._babylonTransformNode;\r\n                if (babylonTransformNode) {\r\n                    babylonTransformNode.inheritVisibility = true;\r\n                    if (node.extensions && node.extensions.KHR_node_visibility && node.extensions.KHR_node_visibility.visible === false) {\r\n                        babylonTransformNode.isVisible = false;\r\n                    }\r\n                }\r\n            }\r\n        }\r\n    }\r\n\r\n    public dispose() {\r\n        delete this._loader;\r\n    }\r\n}\r\n\r\nlet _Registered = false;\r\n/**\r\n * Registers the KHR_node_visibility glTF loader extension.\r\n * Safe to call multiple times; only the first call has an effect.\r\n */\r\n// eslint-disable-next-line @typescript-eslint/naming-convention\r\nexport function RegisterKHR_node_visibility(): void {\r\n    if (_Registered) {\r\n        return;\r\n    }\r\n    _Registered = true;\r\n\r\n    AddObjectAccessorToKey(\"/nodes/{}/extensions/KHR_node_visibility/visible\", {\r\n        get: (node: INode) => {\r\n            const tn = node._babylonTransformNode as any;\r\n            if (tn && tn.isVisible !== undefined) {\r\n                return tn.isVisible;\r\n            }\r\n            return true;\r\n        },\r\n        set: (value: boolean, node: INode) => {\r\n            node._primitiveBabylonMeshes?.forEach((mesh) => {\r\n                mesh.inheritVisibility = true;\r\n            });\r\n            if (node._babylonTransformNode) {\r\n                (node._babylonTransformNode as AbstractMesh).isVisible = value;\r\n            }\r\n            node._primitiveBabylonMeshes?.forEach((mesh) => {\r\n                mesh.isVisible = value;\r\n            });\r\n        },\r\n        getTarget: (node: INode) => node._babylonTransformNode,\r\n        getPropertyName: [() => \"isVisible\"],\r\n        type: \"boolean\",\r\n    });\r\n\r\n    unregisterGLTFExtension(NAME);\r\n\r\n    registerGLTFExtension(NAME, true, (loader) => new KHR_node_visibility(loader));\r\n}\r\n"]}
+{"version":3,"file":"KHR_node_visibility.pure.js","sourceRoot":"","sources":["../../../../../../dev/loaders/src/glTF/2.0/Extensions/KHR_node_visibility.pure.ts"],"names":[],"mappings":"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","sourcesContent":["import { type GLTFLoader } from \"../glTFLoader.pure\";\r\nimport { type IGLTFLoaderExtension } from \"../glTFLoaderExtension\";\r\nimport { registerGLTFExtension, unregisterGLTFExtension } from \"../glTFLoaderExtensionRegistry\";\r\nimport { type AbstractMesh } from \"core/Meshes/abstractMesh\";\r\nimport { type INode } from \"../glTFLoaderInterfaces\";\r\nimport { AddObjectAccessorToKey } from \"./objectModelMapping\";\r\n\r\nconst NAME = \"KHR_node_visibility\";\r\n\r\n// object model extension for visibility\r\n\r\n/**\r\n * Loader extension for KHR_node_visibility\r\n */\r\n// eslint-disable-next-line @typescript-eslint/naming-convention\r\nexport class KHR_node_visibility implements IGLTFLoaderExtension {\r\n    /**\r\n     * The name of this extension.\r\n     */\r\n    public readonly name = NAME;\r\n\r\n    /**\r\n     * Defines whether this extension is enabled.\r\n     */\r\n    public enabled: boolean;\r\n\r\n    private _loader?: GLTFLoader;\r\n\r\n    /**\r\n     * @internal\r\n     */\r\n    constructor(loader: GLTFLoader) {\r\n        this._loader = loader;\r\n        this.enabled = loader.isExtensionUsed(NAME);\r\n    }\r\n\r\n    public onReady(): void {\r\n        if (!this._loader) {\r\n            return;\r\n        }\r\n\r\n        const nodes = this._loader.gltf.nodes;\r\n        if (nodes) {\r\n            for (const node of nodes) {\r\n                const babylonTransformNode = node._babylonTransformNode;\r\n                if (babylonTransformNode) {\r\n                    babylonTransformNode.inheritVisibility = true;\r\n                    if (node.extensions && node.extensions.KHR_node_visibility && node.extensions.KHR_node_visibility.visible === false) {\r\n                        // Apply ``visible: false`` to the same set of meshes the\r\n                        // runtime ``pointer/set`` accessor writes to. The wrapping\r\n                        // ``babylonTransformNode`` is often a non-rendering\r\n                        // ``TransformNode``, so setting ``isVisible`` only there\r\n                        // leaves the primitive child meshes visible. Mirror the\r\n                        // accessor below so assets that author hidden defaults\r\n                        // (e.g. MagicBall.glb's FortuneWords) start hidden as intended.\r\n                        (babylonTransformNode as AbstractMesh).isVisible = false;\r\n                        node._primitiveBabylonMeshes?.forEach((mesh) => {\r\n                            mesh.inheritVisibility = true;\r\n                            mesh.isVisible = false;\r\n                        });\r\n                    }\r\n                }\r\n            }\r\n        }\r\n    }\r\n\r\n    public dispose() {\r\n        delete this._loader;\r\n    }\r\n}\r\n\r\nlet _Registered = false;\r\n/**\r\n * Registers the KHR_node_visibility glTF loader extension.\r\n * Safe to call multiple times; only the first call has an effect.\r\n */\r\n// eslint-disable-next-line @typescript-eslint/naming-convention\r\nexport function RegisterKHR_node_visibility(): void {\r\n    if (_Registered) {\r\n        return;\r\n    }\r\n    _Registered = true;\r\n\r\n    AddObjectAccessorToKey(\"/nodes/{}/extensions/KHR_node_visibility/visible\", {\r\n        get: (node: INode) => {\r\n            const tn = node._babylonTransformNode as any;\r\n            if (tn && tn.isVisible !== undefined) {\r\n                return tn.isVisible;\r\n            }\r\n            return true;\r\n        },\r\n        set: (value: boolean, node: INode) => {\r\n            node._primitiveBabylonMeshes?.forEach((mesh) => {\r\n                mesh.inheritVisibility = true;\r\n            });\r\n            if (node._babylonTransformNode) {\r\n                (node._babylonTransformNode as AbstractMesh).isVisible = value;\r\n            }\r\n            node._primitiveBabylonMeshes?.forEach((mesh) => {\r\n                mesh.isVisible = value;\r\n            });\r\n        },\r\n        getTarget: (node: INode) => node._babylonTransformNode,\r\n        getPropertyName: [() => \"isVisible\"],\r\n        type: \"boolean\",\r\n    });\r\n\r\n    unregisterGLTFExtension(NAME);\r\n\r\n    registerGLTFExtension(NAME, true, (loader) => new KHR_node_visibility(loader));\r\n}\r\n"]}

package/glTF/2.0/Extensions/babylonScenePathToObjectConverter.d.ts

@@ -0,0 +1,126 @@
+import { type Scene } from "@babylonjs/core/scene.js";
+import { type TransformNode } from "@babylonjs/core/Meshes/transformNode.js";
+import { type AbstractMesh } from "@babylonjs/core/Meshes/abstractMesh.js";
+import { type Material } from "@babylonjs/core/Materials/material.js";
+import { type Vector3, Quaternion, type Matrix } from "@babylonjs/core/Maths/math.vector.js";
+import { type IObjectAccessor } from "@babylonjs/core/FlowGraph/typeDefinitions.js";
+import { type IObjectInfo, type IPathToObjectConverter } from "@babylonjs/core/ObjectModel/objectModelInterfaces.js";
+/**
+ * Root of the JSON-Pointer namespace under which Babylon-scene objects are
+ * addressed by KHR_interactivity refs that did not originate from the source
+ * glTF asset (e.g. refs emitted by engine-specific event blocks).
+ *
+ * Trailing `/` is intentional: it lets path-prefix dispatchers like
+ * {@link CompositePathToObjectConverter} match cleanly.
+ */
+export declare const BABYLON_SCENE_OBJECT_MODEL_PREFIX = "/extensions/BABYLON_scene_objects/";
+/**
+ * Shape of the Babylon-scene object model tree consumed by
+ * {@link BabylonScenePathToObjectConverter}. Mirrors `IGLTFObjectModelTree`
+ * but is rooted at scene-asset arrays (`transformNodes`, `meshes`, …) and
+ * keyed by Babylon `uniqueId`. Initially we only expose the property leaves
+ * needed to validate the seam end-to-end; future leaves can be added without
+ * any path-converter changes.
+ */
+export interface IBabylonSceneObjectModelTree {
+    /**
+     *
+     */
+    transformNodes: IBabylonObjectCollection<TransformNode>;
+    /**
+     *
+     */
+    meshes: IBabylonObjectCollection<AbstractMesh>;
+    /**
+     *
+     */
+    materials: IBabylonObjectCollection<Material>;
+}
+/**
+ * Generic per-collection node in the tree. `length` exposes a `.length`
+ * accessor (mirroring glTF). `__array__` is the per-instance leaf hit when a
+ * uniqueId index appears in the path.
+ */
+export interface IBabylonObjectCollection<TBabylon> {
+    /**
+     *
+     */
+    length: IObjectAccessor<TBabylon[], TBabylon[], number>;
+    /**
+     *
+     */
+    __array__: IBabylonObjectLeaves<TBabylon>;
+}
+/** Per-instance accessors. Add new properties here as they are needed. */
+export interface IBabylonObjectLeaves<TBabylon> {
+    /** Marks this position as a `getTarget` boundary so the resolver can hand back the instance itself. */
+    __target__?: boolean;
+    /**
+     *
+     */
+    name?: IObjectAccessor<TBabylon, TBabylon, string>;
+    /**
+     *
+     */
+    translation?: IObjectAccessor<TBabylon, TBabylon, Vector3>;
+    /**
+     *
+     */
+    rotation?: IObjectAccessor<TBabylon, TBabylon, Quaternion>;
+    /**
+     *
+     */
+    scale?: IObjectAccessor<TBabylon, TBabylon, Vector3>;
+    /**
+     *
+     */
+    matrix?: IObjectAccessor<TBabylon, TBabylon, Matrix>;
+    /**
+     *
+     */
+    globalMatrix?: IObjectAccessor<TBabylon, TBabylon, Matrix>;
+    /**
+     *
+     */
+    visible?: IObjectAccessor<TBabylon, TBabylon, boolean>;
+}
+/**
+ * Resolves JSON Pointer paths in the `/extensions/BABYLON_scene_objects/...`
+ * namespace to Babylon scene objects.
+ *
+ * The path layout is `/{root}/{collection}/{uniqueId}/{property}` where
+ * `{root}` is the literal `extensions/BABYLON_scene_objects` prefix and
+ * `{uniqueId}` is the Babylon `uniqueId` (stable per session) of the target
+ * instance. For example:
+ *
+ * - `/extensions/BABYLON_scene_objects/transformNodes/42/translation`
+ * - `/extensions/BABYLON_scene_objects/meshes/17/visible`
+ *
+ * Composite path dispatchers (see {@link CompositePathToObjectConverter})
+ * route paths starting with the prefix here; everything else continues to be
+ * resolved by the standard glTF converter.
+ */
+export declare class BabylonScenePathToObjectConverter implements IPathToObjectConverter<IObjectAccessor> {
+    private _scene;
+    private _tree;
+    constructor(_scene: Scene, _tree: IBabylonSceneObjectModelTree);
+    /**
+     * @param path the full JSON Pointer (must start with the Babylon prefix)
+     * @returns an object-info container holding the resolved instance and accessor
+     */
+    convert(path: string): IObjectInfo<IObjectAccessor>;
+    private _getCollectionArray;
+    private _lookupInstanceByUniqueId;
+    private _buildIdentityAccessor;
+}
+/**
+ * Builds the default Babylon-scene object-model tree.
+ *
+ * We deliberately start with a minimal set of properties: the goal of this
+ * tree is to prove the seam (refs in the BABYLON namespace resolving through
+ * the same `FlowGraphJsonPointerParserBlock` that the glTF refs use) without
+ * committing to a complete property surface in this PR. Add new leaves here
+ * as concrete event-source operations need them.
+ * @returns a fresh Babylon-scene object-model tree with the default property surface.
+ */
+export declare function CreateDefaultBabylonSceneObjectModelTree(): IBabylonSceneObjectModelTree;

package/glTF/2.0/Extensions/babylonScenePathToObjectConverter.js

@@ -0,0 +1,251 @@
+/* eslint-disable @typescript-eslint/naming-convention */
+import { Quaternion } from "@babylonjs/core/Maths/math.vector.js";
+/**
+ * Root of the JSON-Pointer namespace under which Babylon-scene objects are
+ * addressed by KHR_interactivity refs that did not originate from the source
+ * glTF asset (e.g. refs emitted by engine-specific event blocks).
+ *
+ * Trailing `/` is intentional: it lets path-prefix dispatchers like
+ * {@link CompositePathToObjectConverter} match cleanly.
+ */
+export const BABYLON_SCENE_OBJECT_MODEL_PREFIX = "/extensions/BABYLON_scene_objects/";
+/**
+ * Resolves JSON Pointer paths in the `/extensions/BABYLON_scene_objects/...`
+ * namespace to Babylon scene objects.
+ *
+ * The path layout is `/{root}/{collection}/{uniqueId}/{property}` where
+ * `{root}` is the literal `extensions/BABYLON_scene_objects` prefix and
+ * `{uniqueId}` is the Babylon `uniqueId` (stable per session) of the target
+ * instance. For example:
+ *
+ * - `/extensions/BABYLON_scene_objects/transformNodes/42/translation`
+ * - `/extensions/BABYLON_scene_objects/meshes/17/visible`
+ *
+ * Composite path dispatchers (see {@link CompositePathToObjectConverter})
+ * route paths starting with the prefix here; everything else continues to be
+ * resolved by the standard glTF converter.
+ */
+export class BabylonScenePathToObjectConverter {
+    constructor(_scene, _tree) {
+        this._scene = _scene;
+        this._tree = _tree;
+    }
+    /**
+     * @param path the full JSON Pointer (must start with the Babylon prefix)
+     * @returns an object-info container holding the resolved instance and accessor
+     */
+    convert(path) {
+        if (!path.startsWith(BABYLON_SCENE_OBJECT_MODEL_PREFIX)) {
+            throw new Error(`BabylonScenePathToObjectConverter: path "${path}" does not start with the expected prefix "${BABYLON_SCENE_OBJECT_MODEL_PREFIX}".`);
+        }
+        // Strip the namespace prefix and split. Ignore trailing empty segments
+        // so refs of the form "/extensions/BABYLON_scene_objects/transformNodes/42/" parse cleanly.
+        const tail = path.slice(BABYLON_SCENE_OBJECT_MODEL_PREFIX.length);
+        const parts = tail.split("/").filter((p) => p.length > 0);
+        if (parts.length === 0) {
+            throw new Error(`BabylonScenePathToObjectConverter: path "${path}" is missing a collection name.`);
+        }
+        const collectionName = parts[0];
+        const collection = this._tree[collectionName];
+        if (!collection) {
+            throw new Error(`BabylonScenePathToObjectConverter: unknown collection "${collectionName}" in path "${path}".`);
+        }
+        // Handle `<collection>.length` (no instance lookup).
+        if (parts.length === 2 && parts[1] === "length") {
+            const arr = this._getCollectionArray(collectionName);
+            return { object: arr, info: collection.length };
+        }
+        if (parts.length < 2) {
+            throw new Error(`BabylonScenePathToObjectConverter: path "${path}" is missing an instance id.`);
+        }
+        // parseInt would accept "12abc" as 12; require an all-digits id so a malformed path fails
+        // loudly instead of binding to the wrong instance.
+        if (!/^\d+$/.test(parts[1])) {
+            throw new Error(`BabylonScenePathToObjectConverter: invalid uniqueId "${parts[1]}" in path "${path}".`);
+        }
+        const uniqueId = parseInt(parts[1], 10);
+        if (!Number.isFinite(uniqueId) || uniqueId < 0) {
+            throw new Error(`BabylonScenePathToObjectConverter: invalid uniqueId "${parts[1]}" in path "${path}".`);
+        }
+        const instance = this._lookupInstanceByUniqueId(collectionName, uniqueId);
+        if (!instance) {
+            throw new Error(`BabylonScenePathToObjectConverter: no ${collectionName} instance found with uniqueId ${uniqueId} (path "${path}").`);
+        }
+        // No property after the id → the ref itself is just a handle to the instance.
+        // The accessor's `get` and `getTarget` both return the instance.
+        if (parts.length === 2) {
+            return {
+                object: instance,
+                info: this._buildIdentityAccessor(instance),
+            };
+        }
+        // Walk the leaf descriptors for the requested property path. We keep this
+        // very simple right now: only one segment after the id is supported, which
+        // covers every property the initial leaves expose. Nested paths can be
+        // added later by extending the walker.
+        if (parts.length > 3) {
+            throw new Error(`BabylonScenePathToObjectConverter: nested property paths are not yet supported (path "${path}").`);
+        }
+        const propertyName = parts[2];
+        const leaf = collection.__array__[propertyName];
+        if (!leaf || typeof leaf === "boolean") {
+            throw new Error(`BabylonScenePathToObjectConverter: property "${propertyName}" is not registered on ${collectionName} (path "${path}").`);
+        }
+        return {
+            object: instance,
+            info: leaf,
+        };
+    }
+    _getCollectionArray(collectionName) {
+        switch (collectionName) {
+            case "transformNodes":
+                return this._scene.transformNodes;
+            case "meshes":
+                return this._scene.meshes;
+            case "materials":
+                return this._scene.materials;
+            default:
+                return [];
+        }
+    }
+    _lookupInstanceByUniqueId(collectionName, uniqueId) {
+        switch (collectionName) {
+            case "transformNodes": {
+                const direct = this._scene.transformNodes.find((n) => n.uniqueId === uniqueId);
+                if (direct) {
+                    return direct;
+                }
+                // Meshes are also transform nodes; allow the same path to resolve them.
+                return this._scene.meshes.find((m) => m.uniqueId === uniqueId);
+            }
+            case "meshes":
+                return this._scene.meshes.find((m) => m.uniqueId === uniqueId);
+            case "materials":
+                return this._scene.materials.find((m) => m.uniqueId === uniqueId);
+            default:
+                return undefined;
+        }
+    }
+    _buildIdentityAccessor(instance) {
+        return {
+            type: "object",
+            get: () => instance,
+            getTarget: () => instance,
+            isReadOnly: true,
+        };
+    }
+}
+/**
+ * Builds the default Babylon-scene object-model tree.
+ *
+ * We deliberately start with a minimal set of properties: the goal of this
+ * tree is to prove the seam (refs in the BABYLON namespace resolving through
+ * the same `FlowGraphJsonPointerParserBlock` that the glTF refs use) without
+ * committing to a complete property surface in this PR. Add new leaves here
+ * as concrete event-source operations need them.
+ * @returns a fresh Babylon-scene object-model tree with the default property surface.
+ */
+export function CreateDefaultBabylonSceneObjectModelTree() {
+    return {
+        transformNodes: {
+            length: {
+                type: "number",
+                get: (arr) => arr.length,
+                getTarget: (arr) => arr,
+            },
+            __array__: {
+                __target__: true,
+                name: {
+                    type: "string",
+                    get: (n) => n.name,
+                    set: (v, n) => {
+                        n.name = v;
+                    },
+                    getTarget: (n) => n,
+                },
+                translation: {
+                    type: "Vector3",
+                    get: (n) => n.position,
+                    set: (v, n) => n.position.copyFrom(v),
+                    getTarget: (n) => n,
+                },
+                rotation: {
+                    type: "Quaternion",
+                    get: (n) => n.rotationQuaternion ?? Quaternion.RotationYawPitchRoll(n.rotation.y, n.rotation.x, n.rotation.z),
+                    set: (v, n) => {
+                        if (!n.rotationQuaternion) {
+                            n.rotationQuaternion = v.clone();
+                        }
+                        else {
+                            n.rotationQuaternion.copyFrom(v);
+                        }
+                    },
+                    getTarget: (n) => n,
+                },
+                scale: {
+                    type: "Vector3",
+                    get: (n) => n.scaling,
+                    set: (v, n) => n.scaling.copyFrom(v),
+                    getTarget: (n) => n,
+                },
+                matrix: {
+                    type: "Matrix",
+                    get: (n) => n.computeWorldMatrix(false),
+                    getTarget: (n) => n,
+                    isReadOnly: true,
+                },
+                globalMatrix: {
+                    type: "Matrix",
+                    get: (n) => n.computeWorldMatrix(true),
+                    getTarget: (n) => n,
+                    isReadOnly: true,
+                },
+            },
+        },
+        meshes: {
+            length: {
+                type: "number",
+                get: (arr) => arr.length,
+                getTarget: (arr) => arr,
+            },
+            __array__: {
+                __target__: true,
+                name: {
+                    type: "string",
+                    get: (m) => m.name,
+                    set: (v, m) => {
+                        m.name = v;
+                    },
+                    getTarget: (m) => m,
+                },
+                visible: {
+                    type: "boolean",
+                    get: (m) => m.isVisible,
+                    set: (v, m) => {
+                        m.isVisible = v;
+                    },
+                    getTarget: (m) => m,
+                },
+            },
+        },
+        materials: {
+            length: {
+                type: "number",
+                get: (arr) => arr.length,
+                getTarget: (arr) => arr,
+            },
+            __array__: {
+                __target__: true,
+                name: {
+                    type: "string",
+                    get: (m) => m.name,
+                    set: (v, m) => {
+                        m.name = v;
+                    },
+                    getTarget: (m) => m,
+                },
+            },
+        },
+    };
+}
+//# sourceMappingURL=babylonScenePathToObjectConverter.js.map

package/glTF/2.0/Extensions/babylonScenePathToObjectConverter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"babylonScenePathToObjectConverter.js","sourceRoot":"","sources":["../../../../../../dev/loaders/src/glTF/2.0/Extensions/babylonScenePathToObjectConverter.ts"],"names":[],"mappings":"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","sourcesContent":["/* eslint-disable @typescript-eslint/naming-convention */\r\n\r\nimport { type Scene } from \"core/scene\";\r\nimport { type TransformNode } from \"core/Meshes/transformNode\";\r\nimport { type AbstractMesh } from \"core/Meshes/abstractMesh\";\r\nimport { type Material } from \"core/Materials/material\";\r\nimport { type Vector3, Quaternion, type Matrix } from \"core/Maths/math.vector\";\r\nimport { type IObjectAccessor } from \"core/FlowGraph/typeDefinitions\";\r\nimport { type IObjectInfo, type IPathToObjectConverter } from \"core/ObjectModel/objectModelInterfaces\";\r\n\r\n/**\r\n * Root of the JSON-Pointer namespace under which Babylon-scene objects are\r\n * addressed by KHR_interactivity refs that did not originate from the source\r\n * glTF asset (e.g. refs emitted by engine-specific event blocks).\r\n *\r\n * Trailing `/` is intentional: it lets path-prefix dispatchers like\r\n * {@link CompositePathToObjectConverter} match cleanly.\r\n */\r\nexport const BABYLON_SCENE_OBJECT_MODEL_PREFIX = \"/extensions/BABYLON_scene_objects/\";\r\n\r\n/**\r\n * Shape of the Babylon-scene object model tree consumed by\r\n * {@link BabylonScenePathToObjectConverter}. Mirrors `IGLTFObjectModelTree`\r\n * but is rooted at scene-asset arrays (`transformNodes`, `meshes`, …) and\r\n * keyed by Babylon `uniqueId`. Initially we only expose the property leaves\r\n * needed to validate the seam end-to-end; future leaves can be added without\r\n * any path-converter changes.\r\n */\r\nexport interface IBabylonSceneObjectModelTree {\r\n    /**\r\n     *\r\n     */\r\n    transformNodes: IBabylonObjectCollection<TransformNode>;\r\n    /**\r\n     *\r\n     */\r\n    meshes: IBabylonObjectCollection<AbstractMesh>;\r\n    /**\r\n     *\r\n     */\r\n    materials: IBabylonObjectCollection<Material>;\r\n}\r\n\r\n/**\r\n * Generic per-collection node in the tree. `length` exposes a `.length`\r\n * accessor (mirroring glTF). `__array__` is the per-instance leaf hit when a\r\n * uniqueId index appears in the path.\r\n */\r\nexport interface IBabylonObjectCollection<TBabylon> {\r\n    /**\r\n     *\r\n     */\r\n    length: IObjectAccessor<TBabylon[], TBabylon[], number>;\r\n    /**\r\n     *\r\n     */\r\n    __array__: IBabylonObjectLeaves<TBabylon>;\r\n}\r\n\r\n/** Per-instance accessors. Add new properties here as they are needed. */\r\nexport interface IBabylonObjectLeaves<TBabylon> {\r\n    /** Marks this position as a `getTarget` boundary so the resolver can hand back the instance itself. */\r\n    __target__?: boolean;\r\n    /**\r\n     *\r\n     */\r\n    name?: IObjectAccessor<TBabylon, TBabylon, string>;\r\n    /**\r\n     *\r\n     */\r\n    translation?: IObjectAccessor<TBabylon, TBabylon, Vector3>;\r\n    /**\r\n     *\r\n     */\r\n    rotation?: IObjectAccessor<TBabylon, TBabylon, Quaternion>;\r\n    /**\r\n     *\r\n     */\r\n    scale?: IObjectAccessor<TBabylon, TBabylon, Vector3>;\r\n    /**\r\n     *\r\n     */\r\n    matrix?: IObjectAccessor<TBabylon, TBabylon, Matrix>;\r\n    /**\r\n     *\r\n     */\r\n    globalMatrix?: IObjectAccessor<TBabylon, TBabylon, Matrix>;\r\n    /**\r\n     *\r\n     */\r\n    visible?: IObjectAccessor<TBabylon, TBabylon, boolean>;\r\n}\r\n\r\n/**\r\n * Type aliases used internally to keep the per-property accessor signatures\r\n * narrow without forcing every leaf to be re-typed at the use site.\r\n */\r\ntype AnyAccessor = IObjectAccessor<any, any, any>;\r\n\r\n/**\r\n * Resolves JSON Pointer paths in the `/extensions/BABYLON_scene_objects/...`\r\n * namespace to Babylon scene objects.\r\n *\r\n * The path layout is `/{root}/{collection}/{uniqueId}/{property}` where\r\n * `{root}` is the literal `extensions/BABYLON_scene_objects` prefix and\r\n * `{uniqueId}` is the Babylon `uniqueId` (stable per session) of the target\r\n * instance. For example:\r\n *\r\n * - `/extensions/BABYLON_scene_objects/transformNodes/42/translation`\r\n * - `/extensions/BABYLON_scene_objects/meshes/17/visible`\r\n *\r\n * Composite path dispatchers (see {@link CompositePathToObjectConverter})\r\n * route paths starting with the prefix here; everything else continues to be\r\n * resolved by the standard glTF converter.\r\n */\r\nexport class BabylonScenePathToObjectConverter implements IPathToObjectConverter<IObjectAccessor> {\r\n    public constructor(\r\n        private _scene: Scene,\r\n        private _tree: IBabylonSceneObjectModelTree\r\n    ) {}\r\n\r\n    /**\r\n     * @param path the full JSON Pointer (must start with the Babylon prefix)\r\n     * @returns an object-info container holding the resolved instance and accessor\r\n     */\r\n    public convert(path: string): IObjectInfo<IObjectAccessor> {\r\n        if (!path.startsWith(BABYLON_SCENE_OBJECT_MODEL_PREFIX)) {\r\n            throw new Error(`BabylonScenePathToObjectConverter: path \"${path}\" does not start with the expected prefix \"${BABYLON_SCENE_OBJECT_MODEL_PREFIX}\".`);\r\n        }\r\n\r\n        // Strip the namespace prefix and split. Ignore trailing empty segments\r\n        // so refs of the form \"/extensions/BABYLON_scene_objects/transformNodes/42/\" parse cleanly.\r\n        const tail = path.slice(BABYLON_SCENE_OBJECT_MODEL_PREFIX.length);\r\n        const parts = tail.split(\"/\").filter((p) => p.length > 0);\r\n        if (parts.length === 0) {\r\n            throw new Error(`BabylonScenePathToObjectConverter: path \"${path}\" is missing a collection name.`);\r\n        }\r\n\r\n        const collectionName = parts[0];\r\n        const collection = (this._tree as unknown as Record<string, IBabylonObjectCollection<any> | undefined>)[collectionName];\r\n        if (!collection) {\r\n            throw new Error(`BabylonScenePathToObjectConverter: unknown collection \"${collectionName}\" in path \"${path}\".`);\r\n        }\r\n\r\n        // Handle `<collection>.length` (no instance lookup).\r\n        if (parts.length === 2 && parts[1] === \"length\") {\r\n            const arr = this._getCollectionArray(collectionName);\r\n            return { object: arr, info: collection.length as AnyAccessor };\r\n        }\r\n\r\n        if (parts.length < 2) {\r\n            throw new Error(`BabylonScenePathToObjectConverter: path \"${path}\" is missing an instance id.`);\r\n        }\r\n\r\n        // parseInt would accept \"12abc\" as 12; require an all-digits id so a malformed path fails\r\n        // loudly instead of binding to the wrong instance.\r\n        if (!/^\\d+$/.test(parts[1])) {\r\n            throw new Error(`BabylonScenePathToObjectConverter: invalid uniqueId \"${parts[1]}\" in path \"${path}\".`);\r\n        }\r\n        const uniqueId = parseInt(parts[1], 10);\r\n        if (!Number.isFinite(uniqueId) || uniqueId < 0) {\r\n            throw new Error(`BabylonScenePathToObjectConverter: invalid uniqueId \"${parts[1]}\" in path \"${path}\".`);\r\n        }\r\n\r\n        const instance = this._lookupInstanceByUniqueId(collectionName, uniqueId);\r\n        if (!instance) {\r\n            throw new Error(`BabylonScenePathToObjectConverter: no ${collectionName} instance found with uniqueId ${uniqueId} (path \"${path}\").`);\r\n        }\r\n\r\n        // No property after the id → the ref itself is just a handle to the instance.\r\n        // The accessor's `get` and `getTarget` both return the instance.\r\n        if (parts.length === 2) {\r\n            return {\r\n                object: instance,\r\n                info: this._buildIdentityAccessor(instance),\r\n            };\r\n        }\r\n\r\n        // Walk the leaf descriptors for the requested property path. We keep this\r\n        // very simple right now: only one segment after the id is supported, which\r\n        // covers every property the initial leaves expose. Nested paths can be\r\n        // added later by extending the walker.\r\n        if (parts.length > 3) {\r\n            throw new Error(`BabylonScenePathToObjectConverter: nested property paths are not yet supported (path \"${path}\").`);\r\n        }\r\n        const propertyName = parts[2];\r\n        const leaf = (collection.__array__ as Record<string, IObjectAccessor<any, any, any> | boolean | undefined>)[propertyName];\r\n        if (!leaf || typeof leaf === \"boolean\") {\r\n            throw new Error(`BabylonScenePathToObjectConverter: property \"${propertyName}\" is not registered on ${collectionName} (path \"${path}\").`);\r\n        }\r\n\r\n        return {\r\n            object: instance,\r\n            info: leaf as AnyAccessor,\r\n        };\r\n    }\r\n\r\n    private _getCollectionArray(collectionName: string): readonly any[] {\r\n        switch (collectionName) {\r\n            case \"transformNodes\":\r\n                return this._scene.transformNodes;\r\n            case \"meshes\":\r\n                return this._scene.meshes;\r\n            case \"materials\":\r\n                return this._scene.materials;\r\n            default:\r\n                return [];\r\n        }\r\n    }\r\n\r\n    private _lookupInstanceByUniqueId(collectionName: string, uniqueId: number): unknown | undefined {\r\n        switch (collectionName) {\r\n            case \"transformNodes\": {\r\n                const direct = this._scene.transformNodes.find((n) => n.uniqueId === uniqueId);\r\n                if (direct) {\r\n                    return direct;\r\n                }\r\n                // Meshes are also transform nodes; allow the same path to resolve them.\r\n                return this._scene.meshes.find((m) => m.uniqueId === uniqueId);\r\n            }\r\n            case \"meshes\":\r\n                return this._scene.meshes.find((m) => m.uniqueId === uniqueId);\r\n            case \"materials\":\r\n                return this._scene.materials.find((m) => m.uniqueId === uniqueId);\r\n            default:\r\n                return undefined;\r\n        }\r\n    }\r\n\r\n    private _buildIdentityAccessor(instance: unknown): AnyAccessor {\r\n        return {\r\n            type: \"object\",\r\n            get: () => instance,\r\n            getTarget: () => instance,\r\n            isReadOnly: true,\r\n        };\r\n    }\r\n}\r\n\r\n/**\r\n * Builds the default Babylon-scene object-model tree.\r\n *\r\n * We deliberately start with a minimal set of properties: the goal of this\r\n * tree is to prove the seam (refs in the BABYLON namespace resolving through\r\n * the same `FlowGraphJsonPointerParserBlock` that the glTF refs use) without\r\n * committing to a complete property surface in this PR. Add new leaves here\r\n * as concrete event-source operations need them.\r\n * @returns a fresh Babylon-scene object-model tree with the default property surface.\r\n */\r\nexport function CreateDefaultBabylonSceneObjectModelTree(): IBabylonSceneObjectModelTree {\r\n    return {\r\n        transformNodes: {\r\n            length: {\r\n                type: \"number\",\r\n                get: (arr: TransformNode[]) => arr.length,\r\n                getTarget: (arr: TransformNode[]) => arr,\r\n            },\r\n            __array__: {\r\n                __target__: true,\r\n                name: {\r\n                    type: \"string\",\r\n                    get: (n: TransformNode) => n.name,\r\n                    set: (v: string, n: TransformNode) => {\r\n                        n.name = v;\r\n                    },\r\n                    getTarget: (n: TransformNode) => n,\r\n                },\r\n                translation: {\r\n                    type: \"Vector3\",\r\n                    get: (n: TransformNode) => n.position,\r\n                    set: (v: Vector3, n: TransformNode) => n.position.copyFrom(v),\r\n                    getTarget: (n: TransformNode) => n,\r\n                },\r\n                rotation: {\r\n                    type: \"Quaternion\",\r\n                    get: (n: TransformNode) => n.rotationQuaternion ?? Quaternion.RotationYawPitchRoll(n.rotation.y, n.rotation.x, n.rotation.z),\r\n                    set: (v: Quaternion, n: TransformNode) => {\r\n                        if (!n.rotationQuaternion) {\r\n                            n.rotationQuaternion = v.clone();\r\n                        } else {\r\n                            n.rotationQuaternion.copyFrom(v);\r\n                        }\r\n                    },\r\n                    getTarget: (n: TransformNode) => n,\r\n                },\r\n                scale: {\r\n                    type: \"Vector3\",\r\n                    get: (n: TransformNode) => n.scaling,\r\n                    set: (v: Vector3, n: TransformNode) => n.scaling.copyFrom(v),\r\n                    getTarget: (n: TransformNode) => n,\r\n                },\r\n                matrix: {\r\n                    type: \"Matrix\",\r\n                    get: (n: TransformNode) => n.computeWorldMatrix(false),\r\n                    getTarget: (n: TransformNode) => n,\r\n                    isReadOnly: true,\r\n                },\r\n                globalMatrix: {\r\n                    type: \"Matrix\",\r\n                    get: (n: TransformNode) => n.computeWorldMatrix(true),\r\n                    getTarget: (n: TransformNode) => n,\r\n                    isReadOnly: true,\r\n                },\r\n            },\r\n        },\r\n        meshes: {\r\n            length: {\r\n                type: \"number\",\r\n                get: (arr: AbstractMesh[]) => arr.length,\r\n                getTarget: (arr: AbstractMesh[]) => arr,\r\n            },\r\n            __array__: {\r\n                __target__: true,\r\n                name: {\r\n                    type: \"string\",\r\n                    get: (m: AbstractMesh) => m.name,\r\n                    set: (v: string, m: AbstractMesh) => {\r\n                        m.name = v;\r\n                    },\r\n                    getTarget: (m: AbstractMesh) => m,\r\n                },\r\n                visible: {\r\n                    type: \"boolean\",\r\n                    get: (m: AbstractMesh) => m.isVisible,\r\n                    set: (v: boolean, m: AbstractMesh) => {\r\n                        m.isVisible = v;\r\n                    },\r\n                    getTarget: (m: AbstractMesh) => m,\r\n                },\r\n            },\r\n        },\r\n        materials: {\r\n            length: {\r\n                type: \"number\",\r\n                get: (arr: Material[]) => arr.length,\r\n                getTarget: (arr: Material[]) => arr,\r\n            },\r\n            __array__: {\r\n                __target__: true,\r\n                name: {\r\n                    type: \"string\",\r\n                    get: (m: Material) => m.name,\r\n                    set: (v: string, m: Material) => {\r\n                        m.name = v;\r\n                    },\r\n                    getTarget: (m: Material) => m,\r\n                },\r\n            },\r\n        },\r\n    };\r\n}\r\n"]}

package/glTF/2.0/Extensions/compositePathToObjectConverter.d.ts

@@ -0,0 +1,51 @@
+import { type IObjectInfo, type IPathToObjectConverter } from "@babylonjs/core/ObjectModel/objectModelInterfaces.js";
+/**
+ * Entry in the composite converter's prefix table. The first entry whose
+ * `prefix` matches the start of the path wins.
+ */
+export interface IPathConverterPrefixEntry<T> {
+    /** Path prefix to match, e.g. `"/extensions/BABYLON_scene_objects/"`. */
+    prefix: string;
+    /** Converter to delegate to when the path starts with `prefix`. */
+    converter: IPathToObjectConverter<T>;
+}
+/**
+ * Composite path-to-object converter that dispatches by path prefix.
+ *
+ * The KHR_interactivity object model lives at the top of the JSON tree
+ * (`/nodes/...`, `/materials/...`, `/extensions/...`) and is resolved by
+ * `GLTFPathToObjectConverter` (see `gltfPathToObjectConverter`).
+ *
+ * Babylon-specific extensions can register additional namespaces here
+ * (for example `/extensions/BABYLON_scene_objects/...` for refs that point
+ * at scene objects not described by the source glTF) without forcing every
+ * caller to know about them — `FlowGraphJsonPointerParserBlock` and the
+ * existing template substitution machinery treat any path uniformly.
+ *
+ * Prefix entries are tried in order; if none matches, the fallback converter
+ * is used. The fallback is typically the glTF converter, since standard
+ * KHR_interactivity pointer paths sit at the JSON root and have no shared
+ * prefix that would distinguish them from a missing namespace.
+ */
+export declare class CompositePathToObjectConverter<T> implements IPathToObjectConverter<T> {
+    private _prefixes;
+    private _fallback;
+    /**
+     * @param _prefixes prefix-keyed converter table, tried in order
+     * @param _fallback converter used when no prefix entry matches
+     */
+    constructor(_prefixes: IPathConverterPrefixEntry<T>[], _fallback: IPathToObjectConverter<T>);
+    /**
+     * Adds a new prefix entry at the front of the lookup list so it is tried
+     * before any entries registered earlier. Useful for late-registered
+     * loader extensions that want to override or augment a previously
+     * registered namespace.
+     * @param entry the entry to add
+     */
+    addPrefix(entry: IPathConverterPrefixEntry<T>): void;
+    /**
+     * @param path the JSON Pointer path to resolve
+     * @returns an object accessor for the resolved property
+     */
+    convert(path: string): IObjectInfo<T>;
+}

package/glTF/2.0/Extensions/compositePathToObjectConverter.js

@@ -0,0 +1,51 @@
+/**
+ * Composite path-to-object converter that dispatches by path prefix.
+ *
+ * The KHR_interactivity object model lives at the top of the JSON tree
+ * (`/nodes/...`, `/materials/...`, `/extensions/...`) and is resolved by
+ * `GLTFPathToObjectConverter` (see `gltfPathToObjectConverter`).
+ *
+ * Babylon-specific extensions can register additional namespaces here
+ * (for example `/extensions/BABYLON_scene_objects/...` for refs that point
+ * at scene objects not described by the source glTF) without forcing every
+ * caller to know about them — `FlowGraphJsonPointerParserBlock` and the
+ * existing template substitution machinery treat any path uniformly.
+ *
+ * Prefix entries are tried in order; if none matches, the fallback converter
+ * is used. The fallback is typically the glTF converter, since standard
+ * KHR_interactivity pointer paths sit at the JSON root and have no shared
+ * prefix that would distinguish them from a missing namespace.
+ */
+export class CompositePathToObjectConverter {
+    /**
+     * @param _prefixes prefix-keyed converter table, tried in order
+     * @param _fallback converter used when no prefix entry matches
+     */
+    constructor(_prefixes, _fallback) {
+        this._prefixes = _prefixes;
+        this._fallback = _fallback;
+    }
+    /**
+     * Adds a new prefix entry at the front of the lookup list so it is tried
+     * before any entries registered earlier. Useful for late-registered
+     * loader extensions that want to override or augment a previously
+     * registered namespace.
+     * @param entry the entry to add
+     */
+    addPrefix(entry) {
+        this._prefixes.unshift(entry);
+    }
+    /**
+     * @param path the JSON Pointer path to resolve
+     * @returns an object accessor for the resolved property
+     */
+    convert(path) {
+        for (const { prefix, converter } of this._prefixes) {
+            if (path.startsWith(prefix)) {
+                return converter.convert(path);
+            }
+        }
+        return this._fallback.convert(path);
+    }
+}
+//# sourceMappingURL=compositePathToObjectConverter.js.map

package/glTF/2.0/Extensions/compositePathToObjectConverter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compositePathToObjectConverter.js","sourceRoot":"","sources":["../../../../../../dev/loaders/src/glTF/2.0/Extensions/compositePathToObjectConverter.ts"],"names":[],"mappings":"AAaA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,8BAA8B;IACvC;;;OAGG;IACH,YACY,SAAyC,EACzC,SAAoC;QADpC,cAAS,GAAT,SAAS,CAAgC;QACzC,cAAS,GAAT,SAAS,CAA2B;IAC7C,CAAC;IAEJ;;;;;;OAMG;IACI,SAAS,CAAC,KAAmC;QAChD,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IAED;;;OAGG;IACI,OAAO,CAAC,IAAY;QACvB,KAAK,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACjD,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC1B,OAAO,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACnC,CAAC;QACL,CAAC;QACD,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC;CACJ","sourcesContent":["import { type IObjectInfo, type IPathToObjectConverter } from \"core/ObjectModel/objectModelInterfaces\";\r\n\r\n/**\r\n * Entry in the composite converter's prefix table. The first entry whose\r\n * `prefix` matches the start of the path wins.\r\n */\r\nexport interface IPathConverterPrefixEntry<T> {\r\n    /** Path prefix to match, e.g. `\"/extensions/BABYLON_scene_objects/\"`. */\r\n    prefix: string;\r\n    /** Converter to delegate to when the path starts with `prefix`. */\r\n    converter: IPathToObjectConverter<T>;\r\n}\r\n\r\n/**\r\n * Composite path-to-object converter that dispatches by path prefix.\r\n *\r\n * The KHR_interactivity object model lives at the top of the JSON tree\r\n * (`/nodes/...`, `/materials/...`, `/extensions/...`) and is resolved by\r\n * `GLTFPathToObjectConverter` (see `gltfPathToObjectConverter`).\r\n *\r\n * Babylon-specific extensions can register additional namespaces here\r\n * (for example `/extensions/BABYLON_scene_objects/...` for refs that point\r\n * at scene objects not described by the source glTF) without forcing every\r\n * caller to know about them — `FlowGraphJsonPointerParserBlock` and the\r\n * existing template substitution machinery treat any path uniformly.\r\n *\r\n * Prefix entries are tried in order; if none matches, the fallback converter\r\n * is used. The fallback is typically the glTF converter, since standard\r\n * KHR_interactivity pointer paths sit at the JSON root and have no shared\r\n * prefix that would distinguish them from a missing namespace.\r\n */\r\nexport class CompositePathToObjectConverter<T> implements IPathToObjectConverter<T> {\r\n    /**\r\n     * @param _prefixes prefix-keyed converter table, tried in order\r\n     * @param _fallback converter used when no prefix entry matches\r\n     */\r\n    public constructor(\r\n        private _prefixes: IPathConverterPrefixEntry<T>[],\r\n        private _fallback: IPathToObjectConverter<T>\r\n    ) {}\r\n\r\n    /**\r\n     * Adds a new prefix entry at the front of the lookup list so it is tried\r\n     * before any entries registered earlier. Useful for late-registered\r\n     * loader extensions that want to override or augment a previously\r\n     * registered namespace.\r\n     * @param entry the entry to add\r\n     */\r\n    public addPrefix(entry: IPathConverterPrefixEntry<T>): void {\r\n        this._prefixes.unshift(entry);\r\n    }\r\n\r\n    /**\r\n     * @param path the JSON Pointer path to resolve\r\n     * @returns an object accessor for the resolved property\r\n     */\r\n    public convert(path: string): IObjectInfo<T> {\r\n        for (const { prefix, converter } of this._prefixes) {\r\n            if (path.startsWith(prefix)) {\r\n                return converter.convert(path);\r\n            }\r\n        }\r\n        return this._fallback.convert(path);\r\n    }\r\n}\r\n"]}