@mml-io/3d-web-threejs 0.0.0-experimental-2a3c26b-20251217

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

@@ -0,0 +1,146 @@
+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 {};
+//# sourceMappingURL=InstancedMeshBVH.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"InstancedMeshBVH.d.ts","sourceRoot":"","sources":["../../../../../src/character/instancing/vendor/core/InstancedMeshBVH.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,14 @@
+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 {};
+//# sourceMappingURL=Capacity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Capacity.d.ts","sourceRoot":"","sources":["../../../../../../src/character/instancing/vendor/core/feature/Capacity.ts"],"names":[],"mappings":"AAIA,OAAO,QAAQ,mBAAmB,CAAC;IACjC,UAAU,cAAc;QACtB;;;;;WAKG;QACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QACtC,gBAAgB,CAAC,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;KAC9D;CACF"}

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

@@ -0,0 +1,38 @@
+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;
+    }
+}
+//# sourceMappingURL=FrustumCulling.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FrustumCulling.d.ts","sourceRoot":"","sources":["../../../../../../src/character/instancing/vendor/core/feature/FrustumCulling.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAA+C,MAAM,OAAO,CAAC;AAI5E,OAAO,EAAE,mBAAmB,EAAuB,MAAM,8BAA8B,CAAC;AAExF,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAOtC;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,IAAI,EAAE,mBAAmB,EAAE,KAAK,IAAI,CAAC;AAEvE;;;;;;;GAOG;AACH,MAAM,MAAM,sBAAsB,GAAG,CACnC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,MAAM,KACd,OAAO,CAAC;AAEb,OAAO,QAAQ,mBAAmB,CAAC;IACjC,UAAU,cAAc;QACtB;;;;WAIG;QACH,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAEhE,gBAAgB,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QACtD,gBAAgB,CAAC,gBAAgB,IAAI,IAAI,CAAC;QAC1C,gBAAgB,CAAC,gBAAgB,IAAI,IAAI,CAAC;QAC1C,gBAAgB,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QAClD,gBAAgB,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QAErD,gBAAgB,CAAC,iBAAiB,CAChC,aAAa,EAAE,aAAa,EAC5B,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,IAAI,CAAC;QACR,gBAAgB,CAAC,aAAa,CAC5B,aAAa,EAAE,aAAa,EAC5B,OAAO,EAAE,WAAW,EAAE,EACtB,WAAW,EAAE,OAAO,EACpB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,IAAI,CAAC;QACR,gBAAgB,CAAC,gBAAgB,CAC/B,aAAa,EAAE,aAAa,EAC5B,OAAO,EAAE,WAAW,EAAE,EACtB,WAAW,EAAE,OAAO,EACpB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,IAAI,CAAC;QACR,gBAAgB,CAAC,4BAA4B,CAC3C,MAAM,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAA;SAAE,EAAE,EAC9B,QAAQ,EAAE,MAAM,GACf,MAAM,CAAC;KACX;CACF"}

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

@@ -0,0 +1,50 @@
+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;
+    }
+}
+//# sourceMappingURL=Instances.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Instances.d.ts","sourceRoot":"","sources":["../../../../../../src/character/instancing/vendor/core/feature/Instances.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAKrD;;GAEG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,IAAI,eAAe,GAAG,CAAC,CAAC;AAC5C;;GAEG;AACH,MAAM,MAAM,oBAAoB,CAAC,CAAC,GAAG,eAAe,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;AAEhG,OAAO,QAAQ,mBAAmB,CAAC;IAEjC,UAAU,cAAc,CAAC,KAAK,GAAG,EAAE;QACjC;;;;WAIG;QACH,eAAe,CAAC,QAAQ,EAAE,oBAAoB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC;QACrE;;;;;WAKG;QACH,uBAAuB,CAAC,QAAQ,EAAE,oBAAoB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC;QAC7E;;;;;WAKG;QACH,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,oBAAoB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC;QACpF;;;;WAIG;QACH,eAAe,CAAC,GAAG,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QACxC;;;WAGG;QACH,cAAc,IAAI,IAAI,CAAC;QACvB,gBAAgB,CAAC,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,CAAC;QACnE,gBAAgB,CAAC,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,CAAC;QAC3E,gBAAgB,CAAC,aAAa,CAAC,QAAQ,EAAE,eAAe,GAAG,eAAe,CAAC;QAC3E,gBAAgB,CAAC,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QACrD,gBAAgB,CAAC,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAC;KACnF;CACF"}

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

@@ -0,0 +1,90 @@
+import { BufferGeometry, Material } from "three";
+import { InstancedMesh2 } from "../InstancedMesh2";
+/**
+ * Represents information about Level of Detail (LOD).
+ * @template TData Type for additional instance data.
+ */
+export interface LODInfo<TData = {}> {
+    /**
+     * Render settings for the LOD.
+     */
+    render: LODRenderList<TData>;
+    /**
+     * Shadow rendering settings for the LOD.
+     */
+    shadowRender: LODRenderList<TData>;
+    /**
+     * List of `InstancedMesh2` associated to LODs.
+     */
+    objects: InstancedMesh2<TData>[];
+}
+/**
+ * Represents a list of render levels for LOD.
+ * @template TData Type for additional instance data.
+ */
+export interface LODRenderList<TData = {}> {
+    /**
+     * Array of LOD levels.
+     */
+    levels: LODLevel<TData>[];
+    /**
+     * Array of instance counts per LOD level, used internally.
+     */
+    count: number[];
+}
+/**
+ * Represents a single LOD level.
+ * @template TData Type for additional instance data.
+ */
+export interface LODLevel<TData = {}> {
+    /**
+     * The squared distance at which this LOD level becomes active.
+     */
+    distance: number;
+    /**
+     * Hysteresis value to prevent LOD flickering when transitioning.
+     */
+    hysteresis: number;
+    /**
+     * The `InstancedMesh2` object associated with this LOD level.
+     */
+    object: InstancedMesh2<TData>;
+}
+declare module "../InstancedMesh2" {
+    interface InstancedMesh2 {
+        /**
+         * Retrieves the index of the LOD level for a given distance.
+         * @param levels The array of LOD levels.
+         * @param distance The squared distance from the camera to the object.
+         * @returns The index of the LOD level that should be used.
+         */
+        getObjectLODIndexForDistance(levels: LODLevel[], distance: number): number;
+        /**
+         * Sets the first LOD (using current geometry) distance and hysteresis.
+         * @param distance The distance for the first LOD.
+         * @param hysteresis The hysteresis value for the first LOD.
+         * @returns The current `InstancedMesh2` instance.
+         */
+        setFirstLODDistance(distance?: number, hysteresis?: number): this;
+        /**
+         * Adds a new LOD level with the given geometry, material, and distance.
+         * @param geometry The geometry for the LOD level.
+         * @param material The material for the LOD level.
+         * @param distance The distance for this LOD level.
+         * @param hysteresis The hysteresis value for this LOD level.
+         * @returns The current `InstancedMesh2` instance.
+         */
+        addLOD(geometry: BufferGeometry, material: Material | Material[], distance?: number, hysteresis?: number): this;
+        /**
+         * Adds a shadow-specific LOD level with the given geometry and distance.
+         * @param geometry The geometry for the shadow LOD.
+         * @param distance The distance for this LOD level.
+         * @param hysteresis The hysteresis value for this LOD level.
+         * @returns The current `InstancedMesh2` instance.
+         */
+        addShadowLOD(geometry: BufferGeometry, distance?: number, hysteresis?: number): this;
+        /** @internal */ addLevel(renderList: LODRenderList, geometry: BufferGeometry, material: Material | Material[], distance: number, hysteresis: number): InstancedMesh2;
+        /** @internal */ patchLevel(obj: InstancedMesh2): void;
+    }
+}
+//# sourceMappingURL=LOD.d.ts.map

package/build/character/instancing/vendor/core/feature/LOD.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LOD.d.ts","sourceRoot":"","sources":["../../../../../../src/character/instancing/vendor/core/feature/LOD.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAkB,MAAM,OAAO,CAAC;AAEjE,OAAO,EAAE,cAAc,EAAwB,MAAM,mBAAmB,CAAC;AAIzE;;;GAGG;AAEH,MAAM,WAAW,OAAO,CAAC,KAAK,GAAG,EAAE;IACjC;;OAEG;IACH,MAAM,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC;IAC7B;;OAEG;IACH,YAAY,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC;IACnC;;OAEG;IACH,OAAO,EAAE,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;CAClC;AAED;;;GAGG;AAEH,MAAM,WAAW,aAAa,CAAC,KAAK,GAAG,EAAE;IACvC;;OAEG;IACH,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;IAC1B;;OAEG;IACH,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;GAGG;AAEH,MAAM,WAAW,QAAQ,CAAC,KAAK,GAAG,EAAE;IAClC;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,MAAM,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC;CAC/B;AAED,OAAO,QAAQ,mBAAmB,CAAC;IAEjC,UAAU,cAAc;QACtB;;;;;WAKG;QACH,4BAA4B,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;QAC3E;;;;;WAKG;QACH,mBAAmB,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAClE;;;;;;;WAOG;QACH,MAAM,CACJ,QAAQ,EAAE,cAAc,EACxB,QAAQ,EAAE,QAAQ,GAAG,QAAQ,EAAE,EAC/B,QAAQ,CAAC,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,MAAM,GAClB,IAAI,CAAC;QACR;;;;;;WAMG;QACH,YAAY,CAAC,QAAQ,EAAE,cAAc,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACrF,gBAAgB,CAAC,QAAQ,CACvB,UAAU,EAAE,aAAa,EACzB,QAAQ,EAAE,cAAc,EACxB,QAAQ,EAAE,QAAQ,GAAG,QAAQ,EAAE,EAC/B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,cAAc,CAAC;QAClB,gBAAgB,CAAC,UAAU,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI,CAAC;KACxD;CACF"}

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

@@ -0,0 +1,19 @@
+import { Mesh } from "three";
+declare module "../InstancedMesh2" {
+    interface InstancedMesh2 {
+        /**
+         * Gets the morph target data for a specific instance.
+         * @param id The index of the instance.
+         * @param object Optional `Mesh` to store the morph target data.
+         * @returns The mesh object with updated morph target influences.
+         */
+        getMorphAt(id: number, object?: Mesh): Mesh;
+        /**
+         * Sets the morph target influences for a specific instance.
+         * @param id The index of the instance.
+         * @param object The `Mesh` containing the morph target influences to apply.
+         */
+        setMorphAt(id: number, object: Mesh): void;
+    }
+}
+//# sourceMappingURL=Morph.d.ts.map

package/build/character/instancing/vendor/core/feature/Morph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Morph.d.ts","sourceRoot":"","sources":["../../../../../../src/character/instancing/vendor/core/feature/Morph.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,IAAI,EAAa,MAAM,OAAO,CAAC;AAIhE,OAAO,QAAQ,mBAAmB,CAAC;IACjC,UAAU,cAAc;QACtB;;;;;WAKG;QACH,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;QAC5C;;;;WAIG;QACH,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,GAAG,IAAI,CAAC;KAC5C;CACF"}

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

@@ -0,0 +1,8 @@
+import { Intersection, Raycaster } from "three";
+declare module "../InstancedMesh2" {
+    interface InstancedMesh2 {
+        /** @internal */ raycastInstances(raycaster: Raycaster, result: Intersection[]): void;
+        /** @internal */ checkObjectIntersection(raycaster: Raycaster, objectIndex: number, result: Intersection[]): void;
+    }
+}
+//# sourceMappingURL=Raycasting.d.ts.map

package/build/character/instancing/vendor/core/feature/Raycasting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Raycasting.d.ts","sourceRoot":"","sources":["../../../../../../src/character/instancing/vendor/core/feature/Raycasting.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAsB,SAAS,EAAmB,MAAM,OAAO,CAAC;AAIrF,OAAO,QAAQ,mBAAmB,CAAC;IACjC,UAAU,cAAc;QACtB,gBAAgB,CAAC,gBAAgB,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC;QACtF,gBAAgB,CAAC,uBAAuB,CACtC,SAAS,EAAE,SAAS,EACpB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,YAAY,EAAE,GACrB,IAAI,CAAC;KACT;CACF"}

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

@@ -0,0 +1,20 @@
+import { Matrix4, Skeleton } from "three";
+declare module "../InstancedMesh2" {
+    interface InstancedMesh2 {
+        /**
+         * Initialize the skeleton of the instances.
+         * @param skeleton The skeleton to initialize.
+         * @param disableMatrixAutoUpdate Whether to disable the matrix auto update of the bones. Default is `true`.
+         */
+        initSkeleton(skeleton: Skeleton, disableMatrixAutoUpdate?: boolean): void;
+        /**
+         * Set the bones of the skeleton to the instance at the specified index.
+         * @param id The index of the instance.
+         * @param updateBonesMatrices Whether to update the matrices of the bones. Default is `true`.
+         * @param excludeBonesSet An optional set of bone names to exclude from updates, skipping their local matrix updates.
+         */
+        setBonesAt(id: number, updateBonesMatrices?: boolean): void;
+        /** internal */ multiplyBoneMatricesAt(instanceIndex: number, boneIndex: number, m1: Matrix4, m2: Matrix4): void;
+    }
+}
+//# sourceMappingURL=Skeleton.d.ts.map

package/build/character/instancing/vendor/core/feature/Skeleton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Skeleton.d.ts","sourceRoot":"","sources":["../../../../../../src/character/instancing/vendor/core/feature/Skeleton.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAK1C,OAAO,QAAQ,mBAAmB,CAAC;IACjC,UAAU,cAAc;QACtB;;;;WAIG;QACH,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,uBAAuB,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;QAC1E;;;;;WAKG;QACH,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,mBAAmB,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;QAC5D,eAAe,CAAC,sBAAsB,CACpC,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,OAAO,EACX,EAAE,EAAE,OAAO,GACV,IAAI,CAAC;KACT;CACF"}

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

@@ -0,0 +1,43 @@
+import { ChannelSize, UniformMap, UniformType, UniformValue, UniformValueObj } from "../utils/SquareDataTexture";
+type UniformSchema = {
+    [x: string]: UniformType;
+};
+type UniformSchemaShader = {
+    vertex?: UniformSchema;
+    fragment?: UniformSchema;
+};
+type UniformSchemaResult = {
+    channels: ChannelSize;
+    pixelsPerInstance: number;
+    uniformMap: UniformMap;
+    fetchInFragmentShader: boolean;
+};
+declare module "../InstancedMesh2" {
+    interface InstancedMesh2 {
+        /**
+         * Retrieves a uniform value for a specific instance.
+         * @param id The index of the instance.
+         * @param name The name of the uniform.
+         * @param target Optional target object to store the uniform value.
+         * @returns The uniform value for the specified instance.
+         */
+        getUniformAt(id: number, name: string, target?: UniformValueObj): UniformValue;
+        /**
+         * Sets a uniform value for a specific instance.
+         * @param id The index of the instance.
+         * @param name The name of the uniform.
+         * @param value The value to set for the uniform.
+         */
+        setUniformAt(id: number, name: string, value: UniformValue): void;
+        /**
+         * Initializes per-instance uniforms using a schema.
+         * @param schema The schema defining the uniforms.
+         */
+        initUniformsPerInstance(schema: UniformSchemaShader): void;
+        /** @internal */ getUniformSchemaResult(schema: UniformSchemaShader): UniformSchemaResult;
+        /** @internal */ getUniformOffset(size: number, tempOffset: number[]): number;
+        /** @internal */ getUniformSize(type: UniformType): number;
+    }
+}
+export {};
+//# sourceMappingURL=Uniforms.d.ts.map

package/build/character/instancing/vendor/core/feature/Uniforms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Uniforms.d.ts","sourceRoot":"","sources":["../../../../../../src/character/instancing/vendor/core/feature/Uniforms.ts"],"names":[],"mappings":"AACA,OAAO,EACL,WAAW,EAEX,UAAU,EAEV,WAAW,EACX,YAAY,EACZ,eAAe,EAChB,MAAM,4BAA4B,CAAC;AAEpC,KAAK,aAAa,GAAG;IAAE,CAAC,CAAC,EAAE,MAAM,GAAG,WAAW,CAAA;CAAE,CAAC;AAClD,KAAK,mBAAmB,GAAG;IAAE,MAAM,CAAC,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,EAAE,aAAa,CAAA;CAAE,CAAC;AAEhF,KAAK,mBAAmB,GAAG;IACzB,QAAQ,EAAE,WAAW,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,UAAU,CAAC;IACvB,qBAAqB,EAAE,OAAO,CAAC;CAChC,CAAC;AAEF,OAAO,QAAQ,mBAAmB,CAAC;IACjC,UAAU,cAAc;QACtB;;;;;;WAMG;QACH,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,eAAe,GAAG,YAAY,CAAC;QAC/E;;;;;WAKG;QACH,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;QAClE;;;WAGG;QACH,uBAAuB,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAAC;QAC3D,gBAAgB,CAAC,sBAAsB,CAAC,MAAM,EAAE,mBAAmB,GAAG,mBAAmB,CAAC;QAC1F,gBAAgB,CAAC,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;QAC9E,gBAAgB,CAAC,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAAC;KAC5D;CACF"}

package/build/character/instancing/vendor/core/utils/GLInstancedBufferAttribute.d.ts

@@ -0,0 +1,43 @@
+import { GLBufferAttribute, TypedArray, WebGLRenderer } from "three";
+/**
+ * A class that extends `GLBufferAttribute` to handle instanced buffer attributes.
+ * This class was specifically created to allow updating instanced buffer attributes during the `onBeforeRender` callback,
+ * providing an efficient way to modify the buffer data dynamically before rendering.
+ */
+export declare class GLInstancedBufferAttribute extends GLBufferAttribute {
+    /**
+     * Indicates if this is an `isGLInstancedBufferAttribute`.
+     */
+    isGLInstancedBufferAttribute: boolean;
+    /**
+     * The number of meshes that share the same attribute data.
+     */
+    meshPerAttribute: number;
+    /**
+     * The data array that holds the attribute values.
+     */
+    array: TypedArray;
+    protected _cacheArray: TypedArray;
+    /** @internal */ _needsUpdate: boolean;
+    /** @internal */ isInstancedBufferAttribute: boolean;
+    /**
+     * @param gl The WebGL2RenderingContext used to create the buffer.
+     * @param type The type of data in the attribute.
+     * @param itemSize The number of elements per attribute.
+     * @param elementSize The size of individual elements in the array.
+     * @param array The data array that holds the attribute values.
+     * @param meshPerAttribute The number of meshes that share the same attribute data.
+     */
+    constructor(gl: WebGL2RenderingContext, type: GLenum, itemSize: number, elementSize: 1 | 2 | 4, array: TypedArray, meshPerAttribute?: number);
+    /**
+     * Updates the buffer data.
+     * This method is designed to be called during the `onBeforeRender` callback.
+     * It ensures that the attribute data is updated just before the rendering process begins.
+     * @param renderer The WebGLRenderer used to render the scene.
+     * @param count The number of elements to update in the buffer.
+     */
+    update(renderer: WebGLRenderer, count: number): void;
+    /** @internal */
+    clone(): this;
+}
+//# sourceMappingURL=GLInstancedBufferAttribute.d.ts.map

package/build/character/instancing/vendor/core/utils/GLInstancedBufferAttribute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GLInstancedBufferAttribute.d.ts","sourceRoot":"","sources":["../../../../../../src/character/instancing/vendor/core/utils/GLInstancedBufferAttribute.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAErE;;;;GAIG;AACH,qBAAa,0BAA2B,SAAQ,iBAAiB;IAC/D;;OAEG;IACI,4BAA4B,UAAQ;IAC3C;;OAEG;IACI,gBAAgB,EAAE,MAAM,CAAC;IAChC;;OAEG;IACI,KAAK,EAAE,UAAU,CAAC;IACzB,SAAS,CAAC,WAAW,EAAE,UAAU,CAAC;IAClC,gBAAgB,CAAC,YAAY,UAAS;IAGtC,gBAAgB,CAAC,0BAA0B,UAAQ;IAEnD;;;;;;;OAOG;gBAED,EAAE,EAAE,sBAAsB,EAC1B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,EACtB,KAAK,EAAE,UAAU,EACjB,gBAAgB,SAAI;IAatB;;;;;;OAMG;IACI,MAAM,CAAC,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAgB3D,gBAAgB;IACT,KAAK,IAAI,IAAI;CAIrB"}

package/build/character/instancing/vendor/core/utils/InstancedRenderList.d.ts

@@ -0,0 +1,26 @@
+export type InstancedRenderItem = {
+    index: number;
+    depth: number;
+    depthSort: number;
+};
+/**
+ * A class that creates and manages a list of render items, used to determine the rendering order based on depth.
+ */
+export declare class InstancedRenderList {
+    /**
+     * The main array that holds the list of render items for instanced rendering.
+     */
+    array: InstancedRenderItem[];
+    protected pool: InstancedRenderItem[];
+    /**
+     * Adds a new render item to the list.
+     * @param depth The depth value used for sorting or determining the rendering order.
+     * @param index The unique instance id of the render item.
+     */
+    push(depth: number, index: number): void;
+    /**
+     * Resets the render list by clearing the array.
+     */
+    reset(): void;
+}
+//# sourceMappingURL=InstancedRenderList.d.ts.map

package/build/character/instancing/vendor/core/utils/InstancedRenderList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InstancedRenderList.d.ts","sourceRoot":"","sources":["../../../../../../src/character/instancing/vendor/core/utils/InstancedRenderList.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtF;;GAEG;AACH,qBAAa,mBAAmB;IAC9B;;OAEG;IACI,KAAK,EAAE,mBAAmB,EAAE,CAAM;IACzC,SAAS,CAAC,IAAI,EAAE,mBAAmB,EAAE,CAAM;IAE3C;;;;OAIG;IACI,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAgB/C;;OAEG;IACI,KAAK,IAAI,IAAI;CAGrB"}