three-zoo 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Jango
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/InstanceAssembler.d.ts

@@ -0,0 +1,9 @@
+import { Object3D } from "three";
+interface IOptions {
+    container: Object3D;
+    filter?: (child: Object3D) => boolean;
+}
+export declare class InstanceAssembler {
+    static assemble(options: IOptions): void;
+}
+export {};

package/dist/InstanceAssembler.js

@@ -0,0 +1,39 @@
+import { InstancedMesh, Material, Mesh } from "three";
+export class InstanceAssembler {
+    static assemble(options) {
+        var _a;
+        const dictionary = new Map();
+        const instancedMeshes = [];
+        options.container.traverse((child) => {
+            var _a;
+            if (child instanceof Mesh &&
+                child.material instanceof Material &&
+                child.children.length === 0 &&
+                (!options.filter || options.filter(child))) {
+                const entry = (_a = dictionary.get(child.geometry)) !== null && _a !== void 0 ? _a : [];
+                dictionary.set(child.geometry, entry);
+                entry.push(child);
+            }
+        });
+        for (const [geometry, meshes] of dictionary) {
+            if (meshes.length < 2)
+                continue;
+            const sortedMeshes = meshes.sort((a, b) => a.name.localeCompare(b.name));
+            const defaultMesh = sortedMeshes[0];
+            const instancedMesh = new InstancedMesh(geometry, defaultMesh.material, sortedMeshes.length);
+            instancedMesh.name = defaultMesh.name;
+            for (let i = 0; i < sortedMeshes.length; i++) {
+                const mesh = sortedMeshes[i];
+                mesh.updateMatrix();
+                mesh.updateMatrixWorld(true);
+                instancedMesh.setMatrixAt(i, mesh.matrixWorld);
+            }
+            instancedMeshes.push(instancedMesh);
+            for (const mesh of sortedMeshes) {
+                (_a = mesh.parent) === null || _a === void 0 ? void 0 : _a.remove(mesh);
+            }
+        }
+        options.container.add(...instancedMeshes);
+    }
+}
+//# sourceMappingURL=InstanceAssembler.js.map

package/dist/InstanceAssembler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InstanceAssembler.js","sourceRoot":"","sources":["../src/InstanceAssembler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,aAAa,EAAE,QAAQ,EAAE,IAAI,EAAY,MAAM,OAAO,CAAC;AAOhF,MAAM,OAAO,iBAAiB;IACrB,MAAM,CAAC,QAAQ,CAAC,OAAiB;;QACtC,MAAM,UAAU,GAAG,IAAI,GAAG,EAA0B,CAAC;QACrD,MAAM,eAAe,GAAoB,EAAE,CAAC;QAE5C,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,KAAe,EAAE,EAAE;;YAC7C,IACE,KAAK,YAAY,IAAI;gBACrB,KAAK,CAAC,QAAQ,YAAY,QAAQ;gBAClC,KAAK,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;gBAC3B,CAAC,CAAC,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAC1C,CAAC;gBACD,MAAM,KAAK,GAAG,MAAA,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,mCAAI,EAAE,CAAC;gBACnD,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;gBACtC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACpB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,KAAK,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;YAC5C,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;gBAAE,SAAS;YAEhC,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;YACzE,MAAM,WAAW,GAAG,YAAY,CAAC,CAAC,CAAS,CAAC;YAE5C,MAAM,aAAa,GAAG,IAAI,aAAa,CACrC,QAAQ,EACR,WAAW,CAAC,QAAQ,EACpB,YAAY,CAAC,MAAM,CACpB,CAAC;YAEF,aAAa,CAAC,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC;YAEtC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,YAAY,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC7C,MAAM,IAAI,GAAG,YAAY,CAAC,CAAC,CAAS,CAAC;gBACrC,IAAI,CAAC,YAAY,EAAE,CAAC;gBACpB,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;gBAC7B,aAAa,CAAC,WAAW,CAAC,CAAC,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;YACjD,CAAC;YAED,eAAe,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YAEpC,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;gBAChC,MAAA,IAAI,CAAC,MAAM,0CAAE,MAAM,CAAC,IAAI,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;QAED,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,eAAe,CAAC,CAAC;IAC5C,CAAC;CACF"}

package/dist/Object3DToolbox.d.ts

@@ -0,0 +1,21 @@
+import { Box3, Material, Object3D, Vector3 } from "three";
+export declare class Object3DToolbox {
+    private static tempBox3;
+    private static tempVector3;
+    static getObjectByName(object: Object3D, name: string): Object3D | null;
+    static getMaterialByName(object: Object3D, name: string): Material | null;
+    static enumerateObjectsByType<T>(object: Object3D, type: new (...args: any[]) => T, callback: (instance: T) => void): void;
+    static enumerateMaterials(object: Object3D, callback: (material: Material) => void): void;
+    static calculateBounds(object: Object3D): {
+        readonly box: Box3;
+        readonly center: Vector3;
+        readonly size: Vector3;
+        readonly width: number;
+        readonly height: number;
+        readonly depth: number;
+        readonly localWidth: number;
+        readonly localHeight: number;
+        readonly localDepth: number;
+    };
+    static setShadowRecursive(object: Object3D, castShadow?: boolean, receiveShadow?: boolean): void;
+}

package/dist/Object3DToolbox.js

@@ -0,0 +1,118 @@
+import { Box3, Mesh, Vector3 } from "three";
+export class Object3DToolbox {
+    static getObjectByName(object, name) {
+        if (object.name === name)
+            return object;
+        for (const child of object.children) {
+            const result = Object3DToolbox.getObjectByName(child, name);
+            if (result)
+                return result;
+        }
+        return null;
+    }
+    static getMaterialByName(object, name) {
+        if (object instanceof Mesh) {
+            if (Array.isArray(object.material)) {
+                for (const material of object.material) {
+                    if (material.name === name)
+                        return material;
+                }
+            }
+            else if (object.material.name === name) {
+                return object.material;
+            }
+        }
+        for (const child of object.children) {
+            const material = Object3DToolbox.getMaterialByName(child, name);
+            if (material)
+                return material;
+        }
+        return null;
+    }
+    static enumerateObjectsByType(object, type, callback) {
+        if (object instanceof type) {
+            callback(object);
+        }
+        for (const child of object.children) {
+            Object3DToolbox.enumerateObjectsByType(child, type, callback);
+        }
+    }
+    static enumerateMaterials(object, callback) {
+        if (object instanceof Mesh) {
+            if (Array.isArray(object.material)) {
+                for (const material of object.material) {
+                    callback(material);
+                }
+            }
+            else {
+                callback(object.material);
+            }
+        }
+        for (const child of object.children) {
+            Object3DToolbox.enumerateMaterials(child, callback);
+        }
+    }
+    static calculateBounds(object) {
+        Object3DToolbox.tempBox3.setFromObject(object);
+        return {
+            get box() {
+                return Object3DToolbox.tempBox3.clone();
+            },
+            get center() {
+                return Object3DToolbox.tempBox3
+                    .getCenter(Object3DToolbox.tempVector3)
+                    .clone();
+            },
+            get size() {
+                return Object3DToolbox.tempBox3
+                    .getSize(Object3DToolbox.tempVector3)
+                    .clone();
+            },
+            get width() {
+                return Object3DToolbox.tempBox3.max.x - Object3DToolbox.tempBox3.min.x;
+            },
+            get height() {
+                return Object3DToolbox.tempBox3.max.y - Object3DToolbox.tempBox3.min.y;
+            },
+            get depth() {
+                return Object3DToolbox.tempBox3.max.z - Object3DToolbox.tempBox3.min.z;
+            },
+            get localWidth() {
+                const worldWidth = Object3DToolbox.tempBox3.max.x - Object3DToolbox.tempBox3.min.x;
+                if (!object.parent)
+                    return worldWidth;
+                object.parent.getWorldScale(Object3DToolbox.tempVector3);
+                return worldWidth / Object3DToolbox.tempVector3.x;
+            },
+            get localHeight() {
+                const worldHeight = Object3DToolbox.tempBox3.max.y - Object3DToolbox.tempBox3.min.y;
+                if (!object.parent)
+                    return worldHeight;
+                object.parent.getWorldScale(Object3DToolbox.tempVector3);
+                return worldHeight / Object3DToolbox.tempVector3.y;
+            },
+            get localDepth() {
+                const worldDepth = Object3DToolbox.tempBox3.max.z - Object3DToolbox.tempBox3.min.z;
+                if (!object.parent)
+                    return worldDepth;
+                object.parent.getWorldScale(Object3DToolbox.tempVector3);
+                return worldDepth / Object3DToolbox.tempVector3.z;
+            },
+        };
+    }
+    static setShadowRecursive(object, castShadow = true, receiveShadow = true) {
+        if ("isMesh" in object) {
+            object.castShadow = castShadow;
+            object.receiveShadow = receiveShadow;
+        }
+        object.traverse((child) => {
+            if ("isMesh" in child) {
+                child.castShadow = castShadow;
+                child.receiveShadow = receiveShadow;
+            }
+        });
+    }
+}
+Object3DToolbox.tempBox3 = new Box3();
+Object3DToolbox.tempVector3 = new Vector3();
+//# sourceMappingURL=Object3DToolbox.js.map

package/dist/Object3DToolbox.js.map

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

package/dist/SceneProcessor.d.ts

@@ -0,0 +1,13 @@
+import { Object3D } from "three";
+type IPattern = string | RegExp;
+interface IOptions {
+    asset: Object3D;
+    castShadowNames?: IPattern[];
+    receiveShadowNames?: IPattern[];
+    transparentMaterialNames?: IPattern[];
+}
+export declare class SceneProcessor {
+    static process(options: IOptions): Object3D[];
+    private static matchesAny;
+}
+export {};

package/dist/SceneProcessor.js

@@ -0,0 +1,25 @@
+import { FrontSide, Mesh } from "three";
+import { InstanceAssembler } from "./InstanceAssembler";
+import { Object3DToolbox } from "./Object3DToolbox";
+export class SceneProcessor {
+    static process(options) {
+        const container = options.asset.clone();
+        InstanceAssembler.assemble({ container: container });
+        Object3DToolbox.enumerateMaterials(container, (material) => {
+            material.transparent = SceneProcessor.matchesAny(material.name, options.transparentMaterialNames);
+            material.side = FrontSide;
+            material.forceSinglePass = true;
+            material.depthTest = true;
+            material.depthWrite = true;
+        });
+        Object3DToolbox.enumerateObjectsByType(container, Mesh, (child) => {
+            child.castShadow = SceneProcessor.matchesAny(child.name, options.castShadowNames);
+            child.receiveShadow = SceneProcessor.matchesAny(child.name, options.receiveShadowNames);
+        });
+        return container.children;
+    }
+    static matchesAny(value, patterns = []) {
+        return patterns.some((p) => typeof p === "string" ? value === p : p.test(value));
+    }
+}
+//# sourceMappingURL=SceneProcessor.js.map

package/dist/SceneProcessor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SceneProcessor.js","sourceRoot":"","sources":["../src/SceneProcessor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAY,IAAI,EAAY,MAAM,OAAO,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAWpD,MAAM,OAAO,cAAc;IAClB,MAAM,CAAC,OAAO,CAAC,OAAiB;QACrC,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACxC,iBAAiB,CAAC,QAAQ,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,CAAC;QAErD,eAAe,CAAC,kBAAkB,CAAC,SAAS,EAAE,CAAC,QAAkB,EAAE,EAAE;YACnE,QAAQ,CAAC,WAAW,GAAG,cAAc,CAAC,UAAU,CAC9C,QAAQ,CAAC,IAAI,EACb,OAAO,CAAC,wBAAwB,CACjC,CAAC;YACF,QAAQ,CAAC,IAAI,GAAG,SAAS,CAAC;YAC1B,QAAQ,CAAC,eAAe,GAAG,IAAI,CAAC;YAChC,QAAQ,CAAC,SAAS,GAAG,IAAI,CAAC;YAC1B,QAAQ,CAAC,UAAU,GAAG,IAAI,CAAC;QAC7B,CAAC,CAAC,CAAC;QAEH,eAAe,CAAC,sBAAsB,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,KAAW,EAAE,EAAE;YACtE,KAAK,CAAC,UAAU,GAAG,cAAc,CAAC,UAAU,CAC1C,KAAK,CAAC,IAAI,EACV,OAAO,CAAC,eAAe,CACxB,CAAC;YACF,KAAK,CAAC,aAAa,GAAG,cAAc,CAAC,UAAU,CAC7C,KAAK,CAAC,IAAI,EACV,OAAO,CAAC,kBAAkB,CAC3B,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,OAAO,SAAS,CAAC,QAAQ,CAAC;IAC5B,CAAC;IAEO,MAAM,CAAC,UAAU,CAAC,KAAa,EAAE,WAAuB,EAAE;QAChE,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CACzB,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CACpD,CAAC;IACJ,CAAC;CACF"}

package/dist/Sun.d.ts

@@ -0,0 +1,21 @@
+import { Box3, DirectionalLight, Texture } from "three";
+export declare class Sun extends DirectionalLight {
+    private tempVector3D_0;
+    private tempVector3D_1;
+    private tempVector3D_2;
+    private tempVector3D_3;
+    private tempVector3D_4;
+    private tempVector3D_5;
+    private tempVector3D_6;
+    private tempVector3D_7;
+    private tempBox3;
+    private tempSpherical;
+    setShadowMapFromBox3(box3: Box3): void;
+    setDirectionFromHDR(texture: Texture, distance?: number): void;
+    get distance(): number;
+    set distance(value: number);
+    get elevation(): number;
+    set elevation(value: number);
+    get azimuth(): number;
+    set azimuth(value: number);
+}

package/dist/Sun.js

@@ -0,0 +1,96 @@
+import { AxesHelper, Box3, DirectionalLight, RGBAFormat, Spherical, Vector3, } from "three";
+export class Sun extends DirectionalLight {
+    constructor() {
+        super(...arguments);
+        this.tempVector3D_0 = new Vector3();
+        this.tempVector3D_1 = new Vector3();
+        this.tempVector3D_2 = new Vector3();
+        this.tempVector3D_3 = new Vector3();
+        this.tempVector3D_4 = new Vector3();
+        this.tempVector3D_5 = new Vector3();
+        this.tempVector3D_6 = new Vector3();
+        this.tempVector3D_7 = new Vector3();
+        this.tempBox3 = new Box3();
+        this.tempSpherical = new Spherical();
+    }
+    setShadowMapFromBox3(box3) {
+        const camera = this.shadow.camera;
+        this.target.updateWorldMatrix(true, false);
+        this.lookAt(this.target.getWorldPosition(this.tempVector3D_0));
+        this.updateWorldMatrix(true, false);
+        const points = [
+            this.tempVector3D_0.set(box3.min.x, box3.min.y, box3.min.z),
+            this.tempVector3D_1.set(box3.min.x, box3.min.y, box3.max.z),
+            this.tempVector3D_2.set(box3.min.x, box3.max.y, box3.min.z),
+            this.tempVector3D_3.set(box3.min.x, box3.max.y, box3.max.z),
+            this.tempVector3D_4.set(box3.max.x, box3.min.y, box3.min.z),
+            this.tempVector3D_5.set(box3.max.x, box3.min.y, box3.max.z),
+            this.tempVector3D_6.set(box3.max.x, box3.max.y, box3.min.z),
+            this.tempVector3D_7.set(box3.max.x, box3.max.y, box3.max.z),
+        ];
+        const inverseMatrix = this.matrixWorld.clone().invert();
+        for (const point of points) {
+            point.applyMatrix4(inverseMatrix);
+            const axesHelper = new AxesHelper(1);
+            axesHelper.position.copy(point);
+            this.add(axesHelper);
+        }
+        const newBox3 = this.tempBox3.setFromPoints(points);
+        camera.left = newBox3.min.x;
+        camera.bottom = newBox3.min.y;
+        camera.near = -newBox3.max.z;
+        camera.right = newBox3.max.x;
+        camera.top = newBox3.max.y;
+        camera.far = -newBox3.min.z;
+        camera.updateWorldMatrix(true, false);
+        camera.updateProjectionMatrix();
+    }
+    setDirectionFromHDR(texture, distance = 1) {
+        const data = texture.image.data;
+        const width = texture.image.width;
+        const height = texture.image.height;
+        let maxLuminance = 0;
+        let maxIndex = 0;
+        const step = texture.format === RGBAFormat ? 4 : 3;
+        for (let i = 0; i < data.length; i += step) {
+            const r = data[i];
+            const g = data[i + 1];
+            const b = data[i + 2];
+            const luminance = 0.2126 * r + 0.7152 * g + 0.0722 * b;
+            if (luminance > maxLuminance) {
+                maxLuminance = luminance;
+                maxIndex = i;
+            }
+        }
+        const pixelIndex = maxIndex / step;
+        const x = pixelIndex % width;
+        const y = Math.floor(pixelIndex / width);
+        const u = x / width;
+        const v = y / height;
+        const elevation = v * Math.PI;
+        const azimuth = u * -Math.PI * 2 - Math.PI / 2;
+        this.position.setFromSphericalCoords(distance, elevation, azimuth);
+    }
+    get distance() {
+        return this.position.length();
+    }
+    set distance(value) {
+        this.tempSpherical.setFromVector3(this.position);
+        this.position.setFromSphericalCoords(value, this.tempSpherical.phi, this.tempSpherical.theta);
+    }
+    get elevation() {
+        return this.tempSpherical.setFromVector3(this.position).phi;
+    }
+    set elevation(value) {
+        this.tempSpherical.setFromVector3(this.position);
+        this.position.setFromSphericalCoords(this.tempSpherical.radius, value, this.tempSpherical.theta);
+    }
+    get azimuth() {
+        return this.tempSpherical.setFromVector3(this.position).theta;
+    }
+    set azimuth(value) {
+        this.tempSpherical.setFromVector3(this.position);
+        this.position.setFromSphericalCoords(this.tempSpherical.radius, this.tempSpherical.phi, value);
+    }
+}
+//# sourceMappingURL=Sun.js.map

package/dist/Sun.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./InstanceAssembler";
+export * from "./Object3DToolbox";
+export * from "./SceneProcessor";
+export * from "./Sun";

package/dist/index.js

@@ -0,0 +1,5 @@
+export * from "./InstanceAssembler";
+export * from "./Object3DToolbox";
+export * from "./SceneProcessor";
+export * from "./Sun";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,OAAO,CAAC"}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "three-zoo",
+  "version": "0.0.1",
+  "description": "zoo of tiny three js tools",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc"
+  },
+  "keywords": [],
+  "author": "jango",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jango-git/three-zoo.git"
+  },
+  "type": "module",
+  "dependencies": {},
+  "peerDependencies": {
+    "three": "^0.176.0"
+  },
+  "devDependencies": {
+    "@types/three": "^0.176.0",
+    "typescript": "^5.8.3"
+  }
+}

package/src/InstanceAssembler.ts

@@ -0,0 +1,56 @@
+import { BufferGeometry, InstancedMesh, Material, Mesh, Object3D } from "three";
+
+interface IOptions {
+  container: Object3D;
+  filter?: (child: Object3D) => boolean;
+}
+
+export class InstanceAssembler {
+  public static assemble(options: IOptions): void {
+    const dictionary = new Map<BufferGeometry, Mesh[]>();
+    const instancedMeshes: InstancedMesh[] = [];
+
+    options.container.traverse((child: Object3D) => {
+      if (
+        child instanceof Mesh &&
+        child.material instanceof Material &&
+        child.children.length === 0 &&
+        (!options.filter || options.filter(child))
+      ) {
+        const entry = dictionary.get(child.geometry) ?? [];
+        dictionary.set(child.geometry, entry);
+        entry.push(child);
+      }
+    });
+
+    for (const [geometry, meshes] of dictionary) {
+      if (meshes.length < 2) continue;
+
+      const sortedMeshes = meshes.sort((a, b) => a.name.localeCompare(b.name));
+      const defaultMesh = sortedMeshes[0] as Mesh;
+
+      const instancedMesh = new InstancedMesh(
+        geometry,
+        defaultMesh.material,
+        sortedMeshes.length,
+      );
+
+      instancedMesh.name = defaultMesh.name;
+
+      for (let i = 0; i < sortedMeshes.length; i++) {
+        const mesh = sortedMeshes[i] as Mesh;
+        mesh.updateMatrix();
+        mesh.updateMatrixWorld(true);
+        instancedMesh.setMatrixAt(i, mesh.matrixWorld);
+      }
+
+      instancedMeshes.push(instancedMesh);
+
+      for (const mesh of sortedMeshes) {
+        mesh.parent?.remove(mesh);
+      }
+    }
+
+    options.container.add(...instancedMeshes);
+  }
+}

package/src/Object3DToolbox.ts

@@ -0,0 +1,152 @@
+import { Box3, Material, Mesh, Object3D, Vector3 } from "three";
+
+export class Object3DToolbox {
+  private static tempBox3 = new Box3();
+  private static tempVector3 = new Vector3();
+
+  public static getObjectByName(
+    object: Object3D,
+    name: string,
+  ): Object3D | null {
+    if (object.name === name) return object;
+
+    for (const child of object.children) {
+      const result = Object3DToolbox.getObjectByName(child, name);
+      if (result) return result;
+    }
+
+    return null;
+  }
+
+  public static getMaterialByName(
+    object: Object3D,
+    name: string,
+  ): Material | null {
+    if (object instanceof Mesh) {
+      if (Array.isArray(object.material)) {
+        for (const material of object.material) {
+          if (material.name === name) return material;
+        }
+      } else if (object.material.name === name) {
+        return object.material;
+      }
+    }
+
+    for (const child of object.children) {
+      const material = Object3DToolbox.getMaterialByName(child, name);
+      if (material) return material;
+    }
+
+    return null;
+  }
+
+  public static enumerateObjectsByType<T>(
+    object: Object3D,
+    type: new (...args: any[]) => T,
+    callback: (instance: T) => void,
+  ): void {
+    if (object instanceof type) {
+      callback(object);
+    }
+
+    for (const child of object.children) {
+      Object3DToolbox.enumerateObjectsByType(child, type, callback);
+    }
+  }
+
+  public static enumerateMaterials(
+    object: Object3D,
+    callback: (material: Material) => void,
+  ): void {
+    if (object instanceof Mesh) {
+      if (Array.isArray(object.material)) {
+        for (const material of object.material) {
+          callback(material);
+        }
+      } else {
+        callback(object.material);
+      }
+    }
+
+    for (const child of object.children) {
+      Object3DToolbox.enumerateMaterials(child, callback);
+    }
+  }
+
+  public static calculateBounds(object: Object3D) {
+    Object3DToolbox.tempBox3.setFromObject(object);
+    return {
+      get box() {
+        return Object3DToolbox.tempBox3.clone();
+      },
+
+      get center() {
+        return Object3DToolbox.tempBox3
+          .getCenter(Object3DToolbox.tempVector3)
+          .clone();
+      },
+
+      get size() {
+        return Object3DToolbox.tempBox3
+          .getSize(Object3DToolbox.tempVector3)
+          .clone();
+      },
+
+      get width() {
+        return Object3DToolbox.tempBox3.max.x - Object3DToolbox.tempBox3.min.x;
+      },
+
+      get height() {
+        return Object3DToolbox.tempBox3.max.y - Object3DToolbox.tempBox3.min.y;
+      },
+
+      get depth() {
+        return Object3DToolbox.tempBox3.max.z - Object3DToolbox.tempBox3.min.z;
+      },
+
+      get localWidth() {
+        const worldWidth =
+          Object3DToolbox.tempBox3.max.x - Object3DToolbox.tempBox3.min.x;
+        if (!object.parent) return worldWidth;
+
+        object.parent.getWorldScale(Object3DToolbox.tempVector3);
+        return worldWidth / Object3DToolbox.tempVector3.x;
+      },
+
+      get localHeight() {
+        const worldHeight =
+          Object3DToolbox.tempBox3.max.y - Object3DToolbox.tempBox3.min.y;
+        if (!object.parent) return worldHeight;
+
+        object.parent.getWorldScale(Object3DToolbox.tempVector3);
+        return worldHeight / Object3DToolbox.tempVector3.y;
+      },
+
+      get localDepth() {
+        const worldDepth =
+          Object3DToolbox.tempBox3.max.z - Object3DToolbox.tempBox3.min.z;
+        if (!object.parent) return worldDepth;
+
+        object.parent.getWorldScale(Object3DToolbox.tempVector3);
+        return worldDepth / Object3DToolbox.tempVector3.z;
+      },
+    };
+  }
+
+  public static setShadowRecursive(
+    object: Object3D,
+    castShadow = true,
+    receiveShadow = true,
+  ) {
+    if ("isMesh" in object) {
+      (object as Mesh).castShadow = castShadow;
+      (object as Mesh).receiveShadow = receiveShadow;
+    }
+    object.traverse((child) => {
+      if ("isMesh" in child) {
+        (child as Mesh).castShadow = castShadow;
+        (child as Mesh).receiveShadow = receiveShadow;
+      }
+    });
+  }
+}

package/src/SceneProcessor.ts

@@ -0,0 +1,49 @@
+import { FrontSide, Material, Mesh, Object3D } from "three";
+import { InstanceAssembler } from "./InstanceAssembler";
+import { Object3DToolbox } from "./Object3DToolbox";
+
+type IPattern = string | RegExp;
+
+interface IOptions {
+  asset: Object3D;
+  castShadowNames?: IPattern[];
+  receiveShadowNames?: IPattern[];
+  transparentMaterialNames?: IPattern[];
+}
+
+export class SceneProcessor {
+  public static process(options: IOptions): Object3D[] {
+    const container = options.asset.clone();
+    InstanceAssembler.assemble({ container: container });
+
+    Object3DToolbox.enumerateMaterials(container, (material: Material) => {
+      material.transparent = SceneProcessor.matchesAny(
+        material.name,
+        options.transparentMaterialNames,
+      );
+      material.side = FrontSide;
+      material.forceSinglePass = true;
+      material.depthTest = true;
+      material.depthWrite = true;
+    });
+
+    Object3DToolbox.enumerateObjectsByType(container, Mesh, (child: Mesh) => {
+      child.castShadow = SceneProcessor.matchesAny(
+        child.name,
+        options.castShadowNames,
+      );
+      child.receiveShadow = SceneProcessor.matchesAny(
+        child.name,
+        options.receiveShadowNames,
+      );
+    });
+
+    return container.children;
+  }
+
+  private static matchesAny(value: string, patterns: IPattern[] = []): boolean {
+    return patterns.some((p) =>
+      typeof p === "string" ? value === p : p.test(value),
+    );
+  }
+}

package/src/Sun.ts

@@ -0,0 +1,137 @@
+import {
+  AxesHelper,
+  Box3,
+  DirectionalLight,
+  RGBAFormat,
+  Spherical,
+  Texture,
+  Vector3,
+} from "three";
+
+export class Sun extends DirectionalLight {
+  private tempVector3D_0 = new Vector3();
+  private tempVector3D_1 = new Vector3();
+  private tempVector3D_2 = new Vector3();
+  private tempVector3D_3 = new Vector3();
+  private tempVector3D_4 = new Vector3();
+  private tempVector3D_5 = new Vector3();
+  private tempVector3D_6 = new Vector3();
+  private tempVector3D_7 = new Vector3();
+
+  private tempBox3 = new Box3();
+  private tempSpherical = new Spherical();
+
+  public setShadowMapFromBox3(box3: Box3): void {
+    const camera = this.shadow.camera;
+
+    this.target.updateWorldMatrix(true, false);
+    this.lookAt(this.target.getWorldPosition(this.tempVector3D_0));
+
+    this.updateWorldMatrix(true, false);
+
+    const points: Vector3[] = [
+      this.tempVector3D_0.set(box3.min.x, box3.min.y, box3.min.z),
+      this.tempVector3D_1.set(box3.min.x, box3.min.y, box3.max.z),
+      this.tempVector3D_2.set(box3.min.x, box3.max.y, box3.min.z),
+      this.tempVector3D_3.set(box3.min.x, box3.max.y, box3.max.z),
+      this.tempVector3D_4.set(box3.max.x, box3.min.y, box3.min.z),
+      this.tempVector3D_5.set(box3.max.x, box3.min.y, box3.max.z),
+      this.tempVector3D_6.set(box3.max.x, box3.max.y, box3.min.z),
+      this.tempVector3D_7.set(box3.max.x, box3.max.y, box3.max.z),
+    ];
+
+    const inverseMatrix = this.matrixWorld.clone().invert();
+
+    for (const point of points) {
+      point.applyMatrix4(inverseMatrix);
+      const axesHelper = new AxesHelper(1);
+      axesHelper.position.copy(point);
+      this.add(axesHelper);
+    }
+
+    const newBox3 = this.tempBox3.setFromPoints(points);
+
+    camera.left = newBox3.min.x;
+    camera.bottom = newBox3.min.y;
+    camera.near = -newBox3.max.z;
+
+    camera.right = newBox3.max.x;
+    camera.top = newBox3.max.y;
+    camera.far = -newBox3.min.z;
+
+    camera.updateWorldMatrix(true, false);
+    camera.updateProjectionMatrix();
+  }
+
+  public setDirectionFromHDR(texture: Texture, distance: number = 1) {
+    const data = texture.image.data;
+    const width = texture.image.width;
+    const height = texture.image.height;
+
+    let maxLuminance = 0;
+    let maxIndex = 0;
+
+    const step = texture.format === RGBAFormat ? 4 : 3;
+    for (let i = 0; i < data.length; i += step) {
+      const r = data[i];
+      const g = data[i + 1];
+      const b = data[i + 2];
+      const luminance = 0.2126 * r + 0.7152 * g + 0.0722 * b;
+      if (luminance > maxLuminance) {
+        maxLuminance = luminance;
+        maxIndex = i;
+      }
+    }
+
+    const pixelIndex = maxIndex / step;
+    const x = pixelIndex % width;
+    const y = Math.floor(pixelIndex / width);
+
+    const u = x / width;
+    const v = y / height;
+
+    const elevation = v * Math.PI;
+    const azimuth = u * -Math.PI * 2 - Math.PI / 2;
+
+    this.position.setFromSphericalCoords(distance, elevation, azimuth);
+  }
+
+  public get distance() {
+    return this.position.length();
+  }
+
+  public set distance(value: number) {
+    this.tempSpherical.setFromVector3(this.position);
+    this.position.setFromSphericalCoords(
+      value,
+      this.tempSpherical.phi,
+      this.tempSpherical.theta,
+    );
+  }
+
+  public get elevation() {
+    return this.tempSpherical.setFromVector3(this.position).phi;
+  }
+
+  public set elevation(value) {
+    this.tempSpherical.setFromVector3(this.position);
+    this.position.setFromSphericalCoords(
+      this.tempSpherical.radius,
+      value,
+      this.tempSpherical.theta,
+    );
+  }
+
+  public get azimuth() {
+    return this.tempSpherical.setFromVector3(this.position).theta;
+  }
+
+  public set azimuth(value) {
+    this.tempSpherical.setFromVector3(this.position);
+    this.position.setFromSphericalCoords(
+      this.tempSpherical.radius,
+      this.tempSpherical.phi,
+      value,
+    );
+  }
+}

package/src/index.ts

@@ -0,0 +1,4 @@
+export * from "./InstanceAssembler";
+export * from "./Object3DToolbox";
+export * from "./SceneProcessor";
+export * from "./Sun";

package/tsconfig.json

@@ -0,0 +1,21 @@
+{
+  "compilerOptions": {
+    "target": "ES6",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "strict": true,
+    "noImplicitAny": true,
+    "strictNullChecks": true,
+    "strictFunctionTypes": true,
+    "strictBindCallApply": true,
+    "noImplicitThis": true,
+    "alwaysStrict": true,
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true,
+    "skipLibCheck": false,
+    "outDir": "./dist",
+    "declaration": true,
+    "sourceMap": true
+  },
+  "include": ["src/**/*"]
+}