@mml-io/3d-web-client-core 0.24.2 → 0.26.0

package/build/character/instancing/vendor/core/InstancedMesh2.d.ts

@@ -1,361 +0,0 @@
-import { BindMode, Box3, BufferGeometry, Camera, Color, ColorRepresentation, DataTexture, InstancedBufferAttribute, Material, Matrix4, Mesh, Object3D, Object3DEventMap, Scene, Skeleton, Sphere, Vector3, WebGLProgramParametersWithUniforms, WebGLRenderer } from "three";
-import { ColorPartName } from "../../../CharacterModel";
-import { CustomSortCallback, OnFrustumEnterCallback } from "./feature/FrustumCulling";
-import { Entity } from "./feature/Instances";
-import { LODInfo } from "./feature/LOD";
-import { InstancedEntity } from "./InstancedEntity";
-import { BVHParams, InstancedMeshBVH } from "./InstancedMeshBVH";
-import { GLInstancedBufferAttribute } from "./utils/GLInstancedBufferAttribute";
-import { SquareDataTexture } from "./utils/SquareDataTexture";
-/**
- * Parameters for configuring an `InstancedMesh2` instance.
- */
-export interface InstancedMesh2Params {
-    /**
-     * Determines the maximum number of instances that buffers can hold.
-     * The buffers will be expanded automatically if necessary.
-     * @default 1000
-     */
-    capacity?: number;
-    /**
-     * Determines whether to create an array of `InstancedEntity` to easily manipulate instances at the cost of more memory.
-     * @default false
-     */
-    createEntities?: boolean;
-    /**
-     * Determines whether `InstancedEntity` can use the `rotation` property.
-     * If `true` `quaternion` and `rotation` will be synchronized, affecting performance.
-     * @default false
-     */
-    allowsEuler?: boolean;
-    /**
-     * WebGL renderer instance.
-     * If not provided, buffers will be initialized during the first render, resulting in no instances being rendered initially.
-     * @default null
-     */
-    renderer?: WebGLRenderer;
-}
-/**
- * Alternative `InstancedMesh` class to support additional features like frustum culling, fast raycasting, LOD and more.
- * @template TData Type for additional instance data.
- * @template TGeometry Type extending `BufferGeometry`.
- * @template TMaterial Type extending `Material` or an array of `Material`.
- * @template TEventMap Type extending `Object3DEventMap`.
- */
-export declare class InstancedMesh2<TData = {}, TGeometry extends BufferGeometry = BufferGeometry, TMaterial extends Material | Material[] = Material | Material[], TEventMap extends Object3DEventMap = Object3DEventMap> extends Mesh<TGeometry, TMaterial, TEventMap> {
-    /**
-     * The number of instances rendered in the last frame.
-     */
-    count: number;
-    /**
-     * @defaultValue `InstancedMesh2`
-     */
-    readonly type = "InstancedMesh2";
-    /**
-     * Indicates if this is an `InstancedMesh2`.
-     */
-    readonly isInstancedMesh2 = true;
-    /**
-     * An array of `Entity` representing individual instances.
-     * This array is only initialized if `createEntities` is set to `true` in the constructor parameters.
-     */
-    instances: Entity<TData>[] | null;
-    /**
-     * Attribute storing indices of the instances to be rendered.
-     */
-    instanceIndex: GLInstancedBufferAttribute | null;
-    /**
-     * Texture storing matrices for instances.
-     */
-    matricesTexture: SquareDataTexture;
-    /**
-     * Texture storing colors for instances.
-     */
-    colorsTexture: SquareDataTexture | null;
-    /**
-     * Texture storing multiple colors per instance for per-material coloring.
-     * Stores 8 colors per instance (hair, shirt_short, shirt_long, pants_short, pants_long, shoes, skin, lips)
-     * Each row stores 2 colors (8 floats), so we need 4 pixels per instance (4 * 2 = 8 colors)
-     */
-    materialColorsTexture: SquareDataTexture | null;
-    /**
-     * Texture storing morph target influences for instances.
-     */
-    morphTexture: DataTexture | null;
-    /**
-     * Texture storing bones for instances.
-     */
-    boneTexture: SquareDataTexture | null;
-    /**
-     * Texture storing custom uniforms per instance.
-     */
-    uniformsTexture: SquareDataTexture | null;
-    /**
-     * This bounding box encloses all instances, which can be calculated with `computeBoundingBox` method.
-     * Bounding box isn't computed by default. It needs to be explicitly computed, otherwise it's `null`.
-     */
-    boundingBox: Box3 | null;
-    /**
-     * This bounding sphere encloses all instances, which can be calculated with `computeBoundingSphere` method.
-     * Bounding sphere is computed during its first render. You may need to recompute it if an instance is transformed.
-     */
-    boundingSphere: Sphere | null;
-    /**
-     * BVH structure for optimized culling and intersection testing.
-     * It's possible to create the BVH using the `computeBVH` method. Once created it will be updated automatically.
-     */
-    bvh: InstancedMeshBVH | null;
-    /**
-     * Custom sort function for instances.
-     * It's possible to create the radix sort using the `createRadixSort` method.
-     * @default null
-     */
-    customSort: CustomSortCallback | null;
-    /**
-     * Flag indicating if raycasting should only consider the last frame frustum culled instances.
-     * This is ignored if the bvh has been created.
-     * @default false
-     */
-    raycastOnlyFrustum: boolean;
-    /**
-     * Array storing visibility and availability for instances.
-     * [visible0, active0, visible1, active1, ...]
-     */
-    readonly availabilityArray: boolean[];
-    /**
-     * Contains data for managing LOD, allowing different levels of detail for rendering and shadow casting.
-     */
-    LODinfo: LODInfo<TData> | null;
-    /**
-     * Flag indicating whether to automatically perform frustum culling before rendering.
-     * @default true
-     */
-    autoUpdate: boolean;
-    /**
-     * Either `AttachedBindMode` or `DetachedBindMode`. `AttachedBindMode` means the skinned mesh shares the same world space as the skeleton.
-     * This is not true when using `DetachedBindMode` which is useful when sharing a skeleton across multiple skinned meshes.
-     * @default `AttachedBindMode`
-     */
-    bindMode: BindMode;
-    /**
-     * The base matrix that is used for the bound bone transforms.
-     */
-    bindMatrix: Matrix4 | null;
-    /**
-     * The base matrix that is used for resetting the bound bone transforms.
-     */
-    bindMatrixInverse: Matrix4 | null;
-    /**
-     * Skeleton representing the bone hierarchy of the skinned mesh.
-     */
-    skeleton: Skeleton | null;
-    /**
-     * Callback function called if an instance is inside the frustum.
-     */
-    onFrustumEnter: OnFrustumEnterCallback | null;
-    /** @internal */ _renderer: WebGLRenderer | null;
-    /** @internal */ _instancesCount: number;
-    /** @internal */ _instancesArrayCount: number;
-    /** @internal */ _perObjectFrustumCulled: boolean;
-    /** @internal */ _sortObjects: boolean;
-    /** @internal */ _capacity: number;
-    /** @internal */ _indexArrayNeedsUpdate: boolean;
-    /** @internal */ _geometry: TGeometry;
-    /** @internal */ _parentLOD: InstancedMesh2;
-    protected readonly _allowsEuler: boolean;
-    protected readonly _tempInstance: InstancedEntity;
-    protected _useOpacity: boolean;
-    protected _currentMaterial: Material | null;
-    protected _customProgramCacheKeyBase: (() => string) | null;
-    protected _onBeforeCompileBase: ((parameters: WebGLProgramParametersWithUniforms, renderer: WebGLRenderer) => void) | null;
-    protected _propertiesGetBase: ((obj: unknown) => unknown) | null;
-    protected _propertiesGetMap: WeakMap<Material, (obj: unknown) => unknown>;
-    protected _properties: WeakMap<Material, unknown>;
-    protected _freeIds: number[];
-    protected _createEntities: boolean;
-    /** @internal */ isInstancedMesh: boolean;
-    /** @internal */ instanceMatrix: InstancedBufferAttribute;
-    /** @internal */ instanceColor: null;
-    /**
-     * The capacity of the instance buffers.
-     */
-    get capacity(): number;
-    /**
-     * The number of active instances.
-     */
-    get instancesCount(): number;
-    /**
-     * Determines if per-instance frustum culling is enabled.
-     * @default true
-     */
-    get perObjectFrustumCulled(): boolean;
-    set perObjectFrustumCulled(value: boolean);
-    /**
-     * Determines if objects should be sorted before rendering.
-     * @default false
-     */
-    get sortObjects(): boolean;
-    set sortObjects(value: boolean);
-    /**
-     * An instance of `BufferGeometry` (or derived classes), defining the object's structure.
-     */
-    get geometry(): TGeometry;
-    set geometry(value: TGeometry);
-    /** @internal */
-    constructor(geometry: TGeometry, material: TMaterial, params?: InstancedMesh2Params, LOD?: InstancedMesh2);
-    constructor(geometry: TGeometry, material: TMaterial, params?: InstancedMesh2Params);
-    onBeforeShadow(renderer: WebGLRenderer, scene: Scene, camera: Camera, shadowCamera: Camera, geometry: BufferGeometry, depthMaterial: Material, group: any): void;
-    onBeforeRender(renderer: WebGLRenderer, scene: Scene, camera: Camera, geometry: BufferGeometry, material: Material, group: any): void;
-    onAfterShadow(renderer: WebGLRenderer, scene: Scene, camera: Camera, shadowCamera: Camera, geometry: BufferGeometry, depthMaterial: Material, group: any): void;
-    onAfterRender(renderer: WebGLRenderer, scene: Scene, camera: Camera, geometry: BufferGeometry, material: Material, group: any): void;
-    protected isFirstGroup(materialIndex: number): boolean;
-    protected isLastGroup(materialIndex: number): boolean;
-    protected initIndexAttribute(): void;
-    protected initMatricesTexture(): void;
-    protected initColorsTexture(): void;
-    protected initMaterialColorsTexture(): void;
-    materialsNeedsUpdate(): void;
-    protected patchGeometry(geometry: TGeometry): void;
-    protected _customProgramCacheKey: () => string;
-    protected _onBeforeCompile: (shader: WebGLProgramParametersWithUniforms, renderer: WebGLRenderer) => void;
-    protected patchMaterial(renderer: WebGLRenderer, material: Material): void;
-    protected unpatchMaterial(renderer: WebGLRenderer, material: Material): void;
-    /**
-     * Creates and computes the BVH (Bounding Volume Hierarchy) for the instances.
-     * It's recommended to create it when all the instance matrices have been assigned.
-     * Once created it will be updated automatically.
-     * @param config Optional configuration parameters object. See `BVHParams` for details.
-     */
-    computeBVH(config?: BVHParams): void;
-    /**
-     * Disposes of the BVH structure.
-     */
-    disposeBVH(): void;
-    /**
-     * Sets the local transformation matrix for a specific instance.
-     * @param id The index of the instance.
-     * @param matrix A `Matrix4` representing the local transformation to apply to the instance.
-     */
-    setMatrixAt(id: number, matrix: Matrix4): void;
-    /**
-     * Gets the local transformation matrix of a specific instance.
-     * @param id The index of the instance.
-     * @param matrix Optional `Matrix4` to store the result.
-     * @returns The transformation matrix of the instance.
-     */
-    getMatrixAt(id: number, matrix?: Matrix4): Matrix4;
-    /**
-     * Retrieves the position of a specific instance.
-     * @param index The index of the instance.
-     * @param target Optional `Vector3` to store the result.
-     * @returns The position of the instance as a `Vector3`.
-     */
-    getPositionAt(index: number, target?: Vector3): Vector3;
-    /** @internal */
-    getPositionAndMaxScaleOnAxisAt(index: number, position: Vector3): number;
-    /** @internal */
-    applyMatrixAtToSphere(index: number, sphere: Sphere, center: Vector3, radius: number): void;
-    /**
-     * Sets the visibility of a specific instance.
-     * @param id The index of the instance.
-     * @param visible Whether the instance should be visible.
-     */
-    setVisibilityAt(id: number, visible: boolean): void;
-    /**
-     * Gets the visibility of a specific instance.
-     * @param id The index of the instance.
-     * @returns Whether the instance is visible.
-     */
-    getVisibilityAt(id: number): boolean;
-    /**
-     * Sets the availability of a specific instance.
-     * @param id The index of the instance.
-     * @param active Whether the instance is active (not deleted).
-     */
-    setActiveAt(id: number, active: boolean): void;
-    /**
-     * Gets the availability of a specific instance.
-     * @param id The index of the instance.
-     * @returns Whether the instance is active (not deleted).
-     */
-    getActiveAt(id: number): boolean;
-    /**
-     * Indicates if a specific instance is visible and active.
-     * @param id The index of the instance.
-     * @returns Whether the instance is visible and active.
-     */
-    getActiveAndVisibilityAt(id: number): boolean;
-    /**
-     * Set if a specific instance is visible and active.
-     * @param id The index of the instance.
-     * @param value Whether the instance is active and active (not deleted).
-     */
-    setActiveAndVisibilityAt(id: number, value: boolean): void;
-    /**
-     * Sets the color of a specific instance.
-     * @param id The index of the instance.
-     * @param color The color to assign to the instance.
-     */
-    setColorAt(id: number, color: ColorRepresentation): void;
-    /**
-     * Gets the color of a specific instance.
-     * @param id The index of the instance.
-     * @param color Optional `Color` to store the result.
-     * @returns The color of the instance.
-     */
-    getColorAt(id: number, color?: Color): Color;
-    /**
-     * Sets the opacity of a specific instance.
-     * @param id The index of the instance.
-     * @param value The opacity value to assign.
-     */
-    setOpacityAt(id: number, value: number): void;
-    /**
-     * Gets the opacity of a specific instance.
-     * @param id The index of the instance.
-     * @returns The opacity of the instance.
-     */
-    getOpacityAt(id: number): number;
-    /**
-     * Sets material-specific colors for an instance.
-     * @param id The index of the instance.
-     * @param materialColors Object containing colors for different materials.
-     */
-    setMaterialColorsAt(id: number, materialColors: Map<ColorPartName, Color>): void;
-    /**
-     * Gets material-specific colors for an instance.
-     * @param id The index of the instance.
-     * @returns Object containing colors for different materials.
-     */
-    getMaterialColorsAt(id: number): {
-        hair: Color;
-        shirt_short: Color;
-        shirt_long: Color;
-        pants_short: Color;
-        pants_long: Color;
-        shoes: Color;
-        skin: Color;
-        lips: Color;
-    } | null;
-    /**
-     * Copies `position`, `quaternion`, and `scale` of a specific instance to the specified target `Object3D`.
-     * @param id The index of the instance.
-     * @param target The `Object3D` where to copy transformation data.
-     */
-    copyTo(id: number, target: Object3D): void;
-    /**
-     * Computes the bounding box that encloses all instances, and updates the `boundingBox` attribute.
-     */
-    computeBoundingBox(): void;
-    /**
-     * Computes the bounding sphere that encloses all instances, and updates the `boundingSphere` attribute.
-     */
-    computeBoundingSphere(): void;
-    clone(recursive?: boolean): this;
-    copy(argSource: Object3D, recursive?: boolean): this;
-    /**
-     * Frees the GPU-related resources allocated.
-     */
-    dispose(): void;
-    updateMatrixWorld(force?: boolean): void;
-}

package/build/character/instancing/vendor/core/InstancedMeshBVH.d.ts

@@ -1,145 +0,0 @@
-import { Box3, Matrix4, Raycaster, Sphere, Vector3 } from "three";
-import { MeshBVH } from "three-mesh-bvh";
-import { LODLevel } from "./feature/LOD";
-import { InstancedMesh2 } from "./InstancedMesh2";
-export type onFrustumIntersectionCallback<T, U> = (nodeIndex: number) => void;
-export type onFrustumIntersectionLODCallback<T, U> = (nodeIndex: number, level: number) => void;
-export type onIntersectionCallback<T> = (nodeIndex: number) => void;
-export type onIntersectionRayCallback<T> = (nodeIndex: number) => void;
-/**
- * Parameters for configuring the BVH (Bounding Volume Hierarchy).
- */
-export interface BVHParams {
-    /**
-     * Margin applied to accommodate animated or moving objects.
-     * Improves BVH update performance but slows down frustum culling and raycasting.
-     * For static objects, set to 0 to optimize culling and raycasting efficiency.
-     * @default 0
-     */
-    margin?: number;
-    /**
-     * Uses the geometry bounding sphere to compute instance bounding boxes.
-     * Otherwise it's calculated by applying the object's matrix to all 8 bounding box points.
-     * This is faster but less precise. Useful for moving objects.
-     * Only works if the geometry's bounding sphere is centered at the origin.
-     * @default false
-     */
-    getBBoxFromBSphere?: boolean;
-    /**
-     * Enables accurate frustum culling by checking intersections without applying margin to the bounding box.
-     * @default true
-     */
-    accurateCulling?: boolean;
-}
-interface SphereTarget {
-    centerX: number;
-    centerY: number;
-    centerZ: number;
-    maxScale: number;
-}
-/**
- * Class to manage BVH (Bounding Volume Hierarchy) for `InstancedMesh2`.
- * Provides methods for managing bounding volumes, frustum culling, raycasting, and bounding box computation.
- */
-export declare class InstancedMeshBVH {
-    /**
-     * The target `InstancedMesh2` object that the BVH is managing.
-     */
-    target: InstancedMesh2;
-    /**
-     * The geometry bounding box of the target.
-     */
-    geoBoundingBox: Box3;
-    /**
-     * The BVH instance used to organize bounding volumes.
-     */
-    bvh: MeshBVH | null;
-    /**
-     * A map that stores the BVH nodes for each instance.
-     */
-    nodesMap: Map<number, any>;
-    /**
-     * Enables accurate frustum culling by checking intersections without applying margin to the bounding box.
-     */
-    accurateCulling: boolean;
-    protected LODsMap: Map<LODLevel<{}>[], Float32Array<ArrayBufferLike>>;
-    protected _margin: number;
-    protected _origin: Float32Array;
-    protected _dir: Float32Array;
-    protected _boxArray: Float32Array | null;
-    protected _cameraPos: Float32Array;
-    protected _getBoxFromSphere: boolean;
-    protected _geoBoundingSphere: Sphere | null;
-    protected _sphereTarget: SphereTarget | null;
-    /**
-     * @param target The target `InstancedMesh2`.
-     * @param margin The margin applied for bounding box calculations (default is 0).
-     * @param getBBoxFromBSphere Flag to determine if instance bounding boxes should be computed from the geometry bounding sphere. Faster but less precise (default is false).
-     * @param accurateCulling Flag to enable accurate frustum culling without considering margin (default is true).
-     */
-    constructor(target: InstancedMesh2, margin?: number, getBBoxFromBSphere?: boolean, accurateCulling?: boolean);
-    /**
-     * Builds the BVH from the target mesh's instances using a top-down construction method.
-     * This approach is more efficient and accurate compared to incremental methods, which add one instance at a time.
-     * Note: Simplified implementation for three-mesh-bvh compatibility
-     */
-    create(): void;
-    /**
-     * Inserts an instance into the BVH.
-     * @param id The id of the instance to insert.
-     */
-    insert(id: number): void;
-    /**
-     * Inserts a range of instances into the BVH.
-     * @param ids An array of ids to insert.
-     */
-    insertRange(ids: number[]): void;
-    /**
-     * Moves an instance within the BVH.
-     * @param id The id of the instance to move.
-     */
-    move(id: number): void;
-    /**
-     * Deletes an instance from the BVH.
-     * @param id The id of the instance to delete.
-     */
-    delete(id: number): void;
-    /**
-     * Clears the BVH.
-     */
-    clear(): void;
-    /**
-     * Performs frustum culling to determine which instances are visible based on the provided projection matrix.
-     * @param projScreenMatrix The projection screen matrix for frustum culling.
-     * @param onFrustumIntersection Callback function invoked when an instance intersects the frustum.
-     * Note: Simplified implementation - BVH frustum culling disabled
-     */
-    frustumCulling(projScreenMatrix: Matrix4, onFrustumIntersection: onFrustumIntersectionCallback<object, number>): void;
-    /**
-     * Performs frustum culling with Level of Detail (LOD) consideration.
-     * @param projScreenMatrix The projection screen matrix for frustum culling.
-     * @param cameraPosition The camera's position used for LOD calculations.
-     * @param levels An array of LOD levels.
-     * @param onFrustumIntersection Callback function invoked when an instance intersects the frustum.
-     * Note: Simplified implementation - BVH LOD culling disabled
-     */
-    frustumCullingLOD(projScreenMatrix: Matrix4, cameraPosition: Vector3, levels: LODLevel[], onFrustumIntersection: onFrustumIntersectionLODCallback<object, number>): void;
-    /**
-     * Performs raycasting to check if a ray intersects any instances.
-     * @param raycaster The raycaster used for raycasting.
-     * @param onIntersection Callback function invoked when a ray intersects an instance.
-     * Note: Simplified implementation - BVH raycasting disabled
-     */
-    raycast(raycaster: Raycaster, onIntersection: onIntersectionRayCallback<number>): void;
-    /**
-     * Checks if a given box intersects with any instance bounding box.
-     * @param target The target bounding box.
-     * @param onIntersection Callback function invoked when an intersection occurs.
-     * @returns `True` if there is an intersection, otherwise `false`.
-     * Note: Simplified implementation - BVH box intersection disabled
-     */
-    intersectBox(target: Box3, onIntersection: onIntersectionCallback<number>): boolean;
-    protected getBox(id: number, array: Float32Array): Float32Array;
-    protected getSphereFromMatrix_centeredGeometry(id: number, array: Float32Array, target: SphereTarget): SphereTarget;
-}
-export {};

package/build/character/instancing/vendor/core/feature/Capacity.d.ts

@@ -1,13 +0,0 @@
-declare module "../InstancedMesh2" {
-    interface InstancedMesh2 {
-        /**
-         * Resizes internal buffers to accommodate the specified capacity.
-         * This ensures that the buffers are large enough to handle the required number of instances.
-         * @param capacity The new capacity of the buffers.
-         * @returns The current `InstancedMesh2` instance.
-         */
-        resizeBuffers(capacity: number): this;
-        /** @internal */ setInstancesArrayCount(count: number): void;
-    }
-}
-export {};

package/build/character/instancing/vendor/core/feature/FrustumCulling.d.ts

@@ -1,37 +0,0 @@
-import { Camera } from "three";
-import { InstancedRenderItem } from "../utils/InstancedRenderList";
-import { LODRenderList } from "./LOD";
-/**
- * A custom sorting callback for render items.
- */
-export type CustomSortCallback = (list: InstancedRenderItem[]) => void;
-/**
- * Callback invoked when an instance is within the frustum.
- * @param index The index of the instance.
- * @param camera The camera used for rendering.
- * @param cameraLOD The camera used for LOD calculations (provided only if LODs are initialized).
- * @param LODindex The LOD level of the instance (provided only if LODs are initialized and `sortObjects` is false).
- * @returns True if the instance should be rendered, false otherwise.
- */
-export type OnFrustumEnterCallback = (index: number, camera: Camera, cameraLOD?: Camera, LODindex?: number) => boolean;
-declare module "../InstancedMesh2" {
-    interface InstancedMesh2 {
-        /**
-         * Performs frustum culling and manages LOD visibility.
-         * @param camera The main camera used for rendering.
-         * @param cameraLOD An optional camera for LOD calculations. Defaults to the main camera.
-         */
-        performFrustumCulling(camera: Camera, cameraLOD?: Camera): void;
-        /** @internal */ frustumCulling(camera: Camera): void;
-        /** @internal */ updateIndexArray(): void;
-        /** @internal */ updateRenderList(): void;
-        /** @internal */ BVHCulling(camera: Camera): void;
-        /** @internal */ linearCulling(camera: Camera): void;
-        /** @internal */ frustumCullingLOD(LODrenderList: LODRenderList, camera: Camera, cameraLOD: Camera): void;
-        /** @internal */ BVHCullingLOD(LODrenderList: LODRenderList, indexes: Uint32Array[], sortObjects: boolean, camera: Camera, cameraLOD: Camera): void;
-        /** @internal */ linearCullingLOD(LODrenderList: LODRenderList, indexes: Uint32Array[], sortObjects: boolean, camera: Camera, cameraLOD: Camera): void;
-        /** @internal */ getObjectLODIndexForDistance(levels: {
-            distance: number;
-        }[], distance: number): number;
-    }
-}

package/build/character/instancing/vendor/core/feature/Instances.d.ts

@@ -1,49 +0,0 @@
-import { InstancedEntity } from "../InstancedEntity";
-/**
- * Represents an extended entity type with custom data.
- */
-export type Entity<T> = InstancedEntity & T;
-/**
- * A callback function used to update or initialize an entity.
- */
-export type UpdateEntityCallback<T = InstancedEntity> = (obj: Entity<T>, index: number) => void;
-declare module "../InstancedMesh2" {
-    interface InstancedMesh2<TData = {}> {
-        /**
-         * Updates instances by applying a callback function to each instance. It calls `updateMatrix` for each instance.
-         * @param onUpdate A callback function to update each entity.
-         * @returns The current `InstancedMesh2` instance.
-         */
-        updateInstances(onUpdate: UpdateEntityCallback<Entity<TData>>): this;
-        /**
-         * Updates instances position by applying a callback function to each instance. It calls `updateMatrixPosition` for each instance.
-         * This method updates only the position attributes of the matrix.
-         * @param onUpdate A callback function to update each entity.
-         * @returns The current `InstancedMesh2` instance.
-         */
-        updateInstancesPosition(onUpdate: UpdateEntityCallback<Entity<TData>>): this;
-        /**
-         * Adds new instances and optionally initializes them using a callback function.
-         * @param count The number of new instances to add.
-         * @param onCreation An optional callback to initialize each new entity.
-         * @returns The current `InstancedMesh2` instance.
-         */
-        addInstances(count: number, onCreation?: UpdateEntityCallback<Entity<TData>>): this;
-        /**
-         * Removes instances by their ids.
-         * @param ids The ids of the instances to remove.
-         * @returns The current `InstancedMesh2` instance.
-         */
-        removeInstances(...ids: number[]): this;
-        /**
-         * Clears all instances and resets the instance count.
-         * @returns The current `InstancedMesh2` instance.
-         */
-        clearInstances(): this;
-        /** @internal */ clearTempInstance(index: number): InstancedEntity;
-        /** @internal */ clearTempInstancePosition(index: number): InstancedEntity;
-        /** @internal */ clearInstance(instance: InstancedEntity): InstancedEntity;
-        /** @internal */ createEntities(start: number): this;
-        /** @internal */ addInstance(id: number, onCreation?: UpdateEntityCallback): void;
-    }
-}