manim-web 0.10.0 → 0.12.0

package/dist/OBJLoader-Clh2POv9.js

@@ -0,0 +1,287 @@
+import { Fr as e, Ft as t, Gn as n, In as r, Lt as i, Pr as a, Qn as o, U as s, Xi as c, dr as l, eo as u, ir as d, j as f, jn as p, qt as m } from "./three.core-1aHSpGwp.js";
+//#region node_modules/three/examples/jsm/loaders/OBJLoader.js
+var h = /^[og]\s*(.+)?/, g = /^mtllib /, _ = /^usemtl /, v = /^usemap /, y = /\s+/, b = new u(), x = new u(), S = new u(), C = new u(), w = new u(), T = new s();
+function E() {
+	let e = {
+		objects: [],
+		object: {},
+		vertices: [],
+		normals: [],
+		colors: [],
+		uvs: [],
+		materials: {},
+		materialLibraries: [],
+		startObject: function(e, t) {
+			if (this.object && this.object.fromDeclaration === !1) {
+				this.object.name = e, this.object.fromDeclaration = t !== !1;
+				return;
+			}
+			let n = this.object && typeof this.object.currentMaterial == "function" ? this.object.currentMaterial() : void 0;
+			if (this.object && typeof this.object._finalize == "function" && this.object._finalize(!0), this.object = {
+				name: e || "",
+				fromDeclaration: t !== !1,
+				geometry: {
+					vertices: [],
+					normals: [],
+					colors: [],
+					uvs: [],
+					hasUVIndices: !1
+				},
+				materials: [],
+				smooth: !0,
+				startMaterial: function(e, t) {
+					let n = this._finalize(!1);
+					n && (n.inherited || n.groupCount <= 0) && this.materials.splice(n.index, 1);
+					let r = {
+						index: this.materials.length,
+						name: e || "",
+						mtllib: Array.isArray(t) && t.length > 0 ? t[t.length - 1] : "",
+						smooth: n === void 0 ? this.smooth : n.smooth,
+						groupStart: n === void 0 ? 0 : n.groupEnd,
+						groupEnd: -1,
+						groupCount: -1,
+						inherited: !1,
+						clone: function(e) {
+							let t = {
+								index: typeof e == "number" ? e : this.index,
+								name: this.name,
+								mtllib: this.mtllib,
+								smooth: this.smooth,
+								groupStart: 0,
+								groupEnd: -1,
+								groupCount: -1,
+								inherited: !1
+							};
+							return t.clone = this.clone.bind(t), t;
+						}
+					};
+					return this.materials.push(r), r;
+				},
+				currentMaterial: function() {
+					if (this.materials.length > 0) return this.materials[this.materials.length - 1];
+				},
+				_finalize: function(e) {
+					let t = this.currentMaterial();
+					if (t && t.groupEnd === -1 && (t.groupEnd = this.geometry.vertices.length / 3, t.groupCount = t.groupEnd - t.groupStart, t.inherited = !1), e && this.materials.length > 1) for (let e = this.materials.length - 1; e >= 0; e--) this.materials[e].groupCount <= 0 && this.materials.splice(e, 1);
+					return e && this.materials.length === 0 && this.materials.push({
+						name: "",
+						smooth: this.smooth
+					}), t;
+				}
+			}, n && n.name && typeof n.clone == "function") {
+				let e = n.clone(0);
+				e.inherited = !0, this.object.materials.push(e);
+			}
+			this.objects.push(this.object);
+		},
+		finalize: function() {
+			this.object && typeof this.object._finalize == "function" && this.object._finalize(!0);
+		},
+		parseVertexIndex: function(e, t) {
+			let n = parseInt(e, 10);
+			return (n >= 0 ? n - 1 : n + t / 3) * 3;
+		},
+		parseNormalIndex: function(e, t) {
+			let n = parseInt(e, 10);
+			return (n >= 0 ? n - 1 : n + t / 3) * 3;
+		},
+		parseUVIndex: function(e, t) {
+			let n = parseInt(e, 10);
+			return (n >= 0 ? n - 1 : n + t / 2) * 2;
+		},
+		addVertex: function(e, t, n) {
+			let r = this.vertices, i = this.object.geometry.vertices;
+			i.push(r[e + 0], r[e + 1], r[e + 2]), i.push(r[t + 0], r[t + 1], r[t + 2]), i.push(r[n + 0], r[n + 1], r[n + 2]);
+		},
+		addVertexPoint: function(e) {
+			let t = this.vertices;
+			this.object.geometry.vertices.push(t[e + 0], t[e + 1], t[e + 2]);
+		},
+		addVertexLine: function(e) {
+			let t = this.vertices;
+			this.object.geometry.vertices.push(t[e + 0], t[e + 1], t[e + 2]);
+		},
+		addNormal: function(e, t, n) {
+			let r = this.normals, i = this.object.geometry.normals;
+			i.push(r[e + 0], r[e + 1], r[e + 2]), i.push(r[t + 0], r[t + 1], r[t + 2]), i.push(r[n + 0], r[n + 1], r[n + 2]);
+		},
+		addFaceNormal: function(e, t, n) {
+			let r = this.vertices, i = this.object.geometry.normals;
+			b.fromArray(r, e), x.fromArray(r, t), S.fromArray(r, n), w.subVectors(S, x), C.subVectors(b, x), w.cross(C), w.normalize(), i.push(w.x, w.y, w.z), i.push(w.x, w.y, w.z), i.push(w.x, w.y, w.z);
+		},
+		addColor: function(e, t, n) {
+			let r = this.colors, i = this.object.geometry.colors;
+			r[e] !== void 0 && i.push(r[e + 0], r[e + 1], r[e + 2]), r[t] !== void 0 && i.push(r[t + 0], r[t + 1], r[t + 2]), r[n] !== void 0 && i.push(r[n + 0], r[n + 1], r[n + 2]);
+		},
+		addUV: function(e, t, n) {
+			let r = this.uvs, i = this.object.geometry.uvs;
+			i.push(r[e + 0], r[e + 1]), i.push(r[t + 0], r[t + 1]), i.push(r[n + 0], r[n + 1]);
+		},
+		addDefaultUV: function() {
+			let e = this.object.geometry.uvs;
+			e.push(0, 0), e.push(0, 0), e.push(0, 0);
+		},
+		addUVLine: function(e) {
+			let t = this.uvs;
+			this.object.geometry.uvs.push(t[e + 0], t[e + 1]);
+		},
+		addFace: function(e, t, n, r, i, a, o, s, c) {
+			let l = this.vertices.length, u = this.parseVertexIndex(e, l), d = this.parseVertexIndex(t, l), f = this.parseVertexIndex(n, l);
+			if (this.addVertex(u, d, f), this.addColor(u, d, f), o !== void 0 && o !== "") {
+				let e = this.normals.length;
+				u = this.parseNormalIndex(o, e), d = this.parseNormalIndex(s, e), f = this.parseNormalIndex(c, e), this.addNormal(u, d, f);
+			} else this.addFaceNormal(u, d, f);
+			if (r !== void 0 && r !== "") {
+				let e = this.uvs.length;
+				u = this.parseUVIndex(r, e), d = this.parseUVIndex(i, e), f = this.parseUVIndex(a, e), this.addUV(u, d, f), this.object.geometry.hasUVIndices = !0;
+			} else this.addDefaultUV();
+		},
+		addPointGeometry: function(e) {
+			this.object.geometry.type = "Points";
+			let t = this.vertices.length;
+			for (let n = 0, r = e.length; n < r; n++) {
+				let r = this.parseVertexIndex(e[n], t);
+				this.addVertexPoint(r), this.addColor(r);
+			}
+		},
+		addLineGeometry: function(e, t) {
+			this.object.geometry.type = "Line";
+			let n = this.vertices.length, r = this.uvs.length;
+			for (let t = 0, r = e.length; t < r; t++) this.addVertexLine(this.parseVertexIndex(e[t], n));
+			for (let e = 0, n = t.length; e < n; e++) this.addUVLine(this.parseUVIndex(t[e], r));
+		}
+	};
+	return e.startObject("", !1), e;
+}
+var D = class extends n {
+	constructor(e) {
+		super(e), this.materials = null;
+	}
+	load(e, n, r, i) {
+		let a = this, o = new t(this.manager);
+		o.setPath(this.path), o.setRequestHeader(this.requestHeader), o.setWithCredentials(this.withCredentials), o.load(e, function(t) {
+			try {
+				n(a.parse(t));
+			} catch (t) {
+				i ? i(t) : console.error(t), a.manager.itemError(e);
+			}
+		}, r, i);
+	}
+	setMaterials(e) {
+		return this.materials = e, this;
+	}
+	parse(t) {
+		let n = new E();
+		t.indexOf("\r\n") !== -1 && (t = t.replace(/\r\n/g, "\n")), t.indexOf("\\\n") !== -1 && (t = t.replace(/\\\n/g, ""));
+		let s = t.split("\n"), u = [];
+		for (let e = 0, t = s.length; e < t; e++) {
+			let t = s[e].trimStart();
+			if (t.length === 0) continue;
+			let r = t.charAt(0);
+			if (r !== "#") if (r === "v") {
+				let e = t.split(y);
+				switch (e[0]) {
+					case "v":
+						n.vertices.push(parseFloat(e[1]), parseFloat(e[2]), parseFloat(e[3])), e.length >= 7 ? (T.setRGB(parseFloat(e[4]), parseFloat(e[5]), parseFloat(e[6]), c), n.colors.push(T.r, T.g, T.b)) : n.colors.push(void 0, void 0, void 0);
+						break;
+					case "vn":
+						n.normals.push(parseFloat(e[1]), parseFloat(e[2]), parseFloat(e[3]));
+						break;
+					case "vt":
+						n.uvs.push(parseFloat(e[1]), parseFloat(e[2]));
+						break;
+				}
+			} else if (r === "f") {
+				let e = t.slice(1).trim().split(y), r = [];
+				for (let t = 0, n = e.length; t < n; t++) {
+					let n = e[t];
+					if (n.length > 0) {
+						let e = n.split("/");
+						r.push(e);
+					}
+				}
+				let i = r[0];
+				for (let e = 1, t = r.length - 1; e < t; e++) {
+					let t = r[e], a = r[e + 1];
+					n.addFace(i[0], t[0], a[0], i[1], t[1], a[1], i[2], t[2], a[2]);
+				}
+			} else if (r === "l") {
+				let e = t.substring(1).trim().split(" "), r = [], i = [];
+				if (t.indexOf("/") === -1) r = e;
+				else for (let t = 0, n = e.length; t < n; t++) {
+					let n = e[t].split("/");
+					n[0] !== "" && r.push(n[0]), n[1] !== "" && i.push(n[1]);
+				}
+				n.addLineGeometry(r, i);
+			} else if (r === "p") {
+				let e = t.slice(1).trim().split(" ");
+				n.addPointGeometry(e);
+			} else if ((u = h.exec(t)) !== null) {
+				let e = (" " + u[0].slice(1).trim()).slice(1);
+				n.startObject(e);
+			} else if (_.test(t)) n.object.startMaterial(t.substring(7).trim(), n.materialLibraries);
+			else if (g.test(t)) n.materialLibraries.push(t.substring(7).trim());
+			else if (v.test(t)) console.warn("THREE.OBJLoader: Rendering identifier \"usemap\" not supported. Textures must be defined in MTL files.");
+			else if (r === "s") {
+				if (u = t.split(" "), u.length > 1) {
+					let e = u[1].trim().toLowerCase();
+					n.object.smooth = e !== "0" && e !== "off";
+				} else n.object.smooth = !0;
+				let e = n.object.currentMaterial();
+				e && (e.smooth = n.object.smooth);
+			} else {
+				if (t === "\0") continue;
+				console.warn("THREE.OBJLoader: Unexpected line: \"" + t + "\"");
+			}
+		}
+		n.finalize();
+		let b = new m();
+		if (b.materialLibraries = [].concat(n.materialLibraries), !(n.objects.length === 1 && n.objects[0].geometry.vertices.length === 0)) for (let t = 0, s = n.objects.length; t < s; t++) {
+			let s = n.objects[t], c = s.geometry, u = s.materials, m = c.type === "Line", h = c.type === "Points", g = !1;
+			if (c.vertices.length === 0) continue;
+			let _ = new f();
+			_.setAttribute("position", new i(c.vertices, 3)), c.normals.length > 0 && _.setAttribute("normal", new i(c.normals, 3)), c.colors.length > 0 && (g = !0, _.setAttribute("color", new i(c.colors, 3))), c.hasUVIndices === !0 && _.setAttribute("uv", new i(c.uvs, 2));
+			let v = [];
+			for (let t = 0, r = u.length; t < r; t++) {
+				let r = u[t], i = r.name + "_" + r.smooth + "_" + g, a = n.materials[i];
+				if (this.materials !== null) {
+					if (a = this.materials.create(r.name), m && a && !(a instanceof p)) {
+						let e = new p();
+						o.prototype.copy.call(e, a), e.color.copy(a.color), a = e;
+					} else if (h && a && !(a instanceof e)) {
+						let t = new e({
+							size: 10,
+							sizeAttenuation: !1
+						});
+						o.prototype.copy.call(t, a), t.color.copy(a.color), t.map = a.map, a = t;
+					}
+				}
+				a === void 0 && (a = m ? new p() : h ? new e({
+					size: 1,
+					sizeAttenuation: !1
+				}) : new l(), a.name = r.name, a.flatShading = !r.smooth, a.vertexColors = g, n.materials[i] = a), v.push(a);
+			}
+			let y;
+			if (v.length > 1) {
+				for (let e = 0, t = u.length; e < t; e++) {
+					let t = u[e];
+					_.addGroup(t.groupStart, t.groupCount, e);
+				}
+				y = m ? new r(_, v) : h ? new a(_, v) : new d(_, v);
+			} else y = m ? new r(_, v[0]) : h ? new a(_, v[0]) : new d(_, v[0]);
+			y.name = s.name, b.add(y);
+		}
+		else if (n.vertices.length > 0) {
+			let t = new e({
+				size: 1,
+				sizeAttenuation: !1
+			}), r = new f();
+			r.setAttribute("position", new i(n.vertices, 3)), n.colors.length > 0 && n.colors[0] !== void 0 && (r.setAttribute("color", new i(n.colors, 3)), t.vertexColors = !0);
+			let o = new a(r, t);
+			b.add(o);
+		}
+		return b;
+	}
+};
+//#endregion
+export { D as OBJLoader };

package/dist/OBJLoader-kkTsEhJf.js

@@ -0,0 +1,287 @@
+import { BufferGeometry as e, Color as t, FileLoader as n, Float32BufferAttribute as r, Group as i, LineBasicMaterial as a, LineSegments as o, Loader as s, Material as c, Mesh as l, MeshPhongMaterial as u, Points as d, PointsMaterial as f, SRGBColorSpace as p, Vector3 as m } from "three";
+//#region node_modules/three/examples/jsm/loaders/OBJLoader.js
+var h = /^[og]\s*(.+)?/, g = /^mtllib /, _ = /^usemtl /, v = /^usemap /, y = /\s+/, b = new m(), x = new m(), S = new m(), C = new m(), w = new m(), T = new t();
+function E() {
+	let e = {
+		objects: [],
+		object: {},
+		vertices: [],
+		normals: [],
+		colors: [],
+		uvs: [],
+		materials: {},
+		materialLibraries: [],
+		startObject: function(e, t) {
+			if (this.object && this.object.fromDeclaration === !1) {
+				this.object.name = e, this.object.fromDeclaration = t !== !1;
+				return;
+			}
+			let n = this.object && typeof this.object.currentMaterial == "function" ? this.object.currentMaterial() : void 0;
+			if (this.object && typeof this.object._finalize == "function" && this.object._finalize(!0), this.object = {
+				name: e || "",
+				fromDeclaration: t !== !1,
+				geometry: {
+					vertices: [],
+					normals: [],
+					colors: [],
+					uvs: [],
+					hasUVIndices: !1
+				},
+				materials: [],
+				smooth: !0,
+				startMaterial: function(e, t) {
+					let n = this._finalize(!1);
+					n && (n.inherited || n.groupCount <= 0) && this.materials.splice(n.index, 1);
+					let r = {
+						index: this.materials.length,
+						name: e || "",
+						mtllib: Array.isArray(t) && t.length > 0 ? t[t.length - 1] : "",
+						smooth: n === void 0 ? this.smooth : n.smooth,
+						groupStart: n === void 0 ? 0 : n.groupEnd,
+						groupEnd: -1,
+						groupCount: -1,
+						inherited: !1,
+						clone: function(e) {
+							let t = {
+								index: typeof e == "number" ? e : this.index,
+								name: this.name,
+								mtllib: this.mtllib,
+								smooth: this.smooth,
+								groupStart: 0,
+								groupEnd: -1,
+								groupCount: -1,
+								inherited: !1
+							};
+							return t.clone = this.clone.bind(t), t;
+						}
+					};
+					return this.materials.push(r), r;
+				},
+				currentMaterial: function() {
+					if (this.materials.length > 0) return this.materials[this.materials.length - 1];
+				},
+				_finalize: function(e) {
+					let t = this.currentMaterial();
+					if (t && t.groupEnd === -1 && (t.groupEnd = this.geometry.vertices.length / 3, t.groupCount = t.groupEnd - t.groupStart, t.inherited = !1), e && this.materials.length > 1) for (let e = this.materials.length - 1; e >= 0; e--) this.materials[e].groupCount <= 0 && this.materials.splice(e, 1);
+					return e && this.materials.length === 0 && this.materials.push({
+						name: "",
+						smooth: this.smooth
+					}), t;
+				}
+			}, n && n.name && typeof n.clone == "function") {
+				let e = n.clone(0);
+				e.inherited = !0, this.object.materials.push(e);
+			}
+			this.objects.push(this.object);
+		},
+		finalize: function() {
+			this.object && typeof this.object._finalize == "function" && this.object._finalize(!0);
+		},
+		parseVertexIndex: function(e, t) {
+			let n = parseInt(e, 10);
+			return (n >= 0 ? n - 1 : n + t / 3) * 3;
+		},
+		parseNormalIndex: function(e, t) {
+			let n = parseInt(e, 10);
+			return (n >= 0 ? n - 1 : n + t / 3) * 3;
+		},
+		parseUVIndex: function(e, t) {
+			let n = parseInt(e, 10);
+			return (n >= 0 ? n - 1 : n + t / 2) * 2;
+		},
+		addVertex: function(e, t, n) {
+			let r = this.vertices, i = this.object.geometry.vertices;
+			i.push(r[e + 0], r[e + 1], r[e + 2]), i.push(r[t + 0], r[t + 1], r[t + 2]), i.push(r[n + 0], r[n + 1], r[n + 2]);
+		},
+		addVertexPoint: function(e) {
+			let t = this.vertices;
+			this.object.geometry.vertices.push(t[e + 0], t[e + 1], t[e + 2]);
+		},
+		addVertexLine: function(e) {
+			let t = this.vertices;
+			this.object.geometry.vertices.push(t[e + 0], t[e + 1], t[e + 2]);
+		},
+		addNormal: function(e, t, n) {
+			let r = this.normals, i = this.object.geometry.normals;
+			i.push(r[e + 0], r[e + 1], r[e + 2]), i.push(r[t + 0], r[t + 1], r[t + 2]), i.push(r[n + 0], r[n + 1], r[n + 2]);
+		},
+		addFaceNormal: function(e, t, n) {
+			let r = this.vertices, i = this.object.geometry.normals;
+			b.fromArray(r, e), x.fromArray(r, t), S.fromArray(r, n), w.subVectors(S, x), C.subVectors(b, x), w.cross(C), w.normalize(), i.push(w.x, w.y, w.z), i.push(w.x, w.y, w.z), i.push(w.x, w.y, w.z);
+		},
+		addColor: function(e, t, n) {
+			let r = this.colors, i = this.object.geometry.colors;
+			r[e] !== void 0 && i.push(r[e + 0], r[e + 1], r[e + 2]), r[t] !== void 0 && i.push(r[t + 0], r[t + 1], r[t + 2]), r[n] !== void 0 && i.push(r[n + 0], r[n + 1], r[n + 2]);
+		},
+		addUV: function(e, t, n) {
+			let r = this.uvs, i = this.object.geometry.uvs;
+			i.push(r[e + 0], r[e + 1]), i.push(r[t + 0], r[t + 1]), i.push(r[n + 0], r[n + 1]);
+		},
+		addDefaultUV: function() {
+			let e = this.object.geometry.uvs;
+			e.push(0, 0), e.push(0, 0), e.push(0, 0);
+		},
+		addUVLine: function(e) {
+			let t = this.uvs;
+			this.object.geometry.uvs.push(t[e + 0], t[e + 1]);
+		},
+		addFace: function(e, t, n, r, i, a, o, s, c) {
+			let l = this.vertices.length, u = this.parseVertexIndex(e, l), d = this.parseVertexIndex(t, l), f = this.parseVertexIndex(n, l);
+			if (this.addVertex(u, d, f), this.addColor(u, d, f), o !== void 0 && o !== "") {
+				let e = this.normals.length;
+				u = this.parseNormalIndex(o, e), d = this.parseNormalIndex(s, e), f = this.parseNormalIndex(c, e), this.addNormal(u, d, f);
+			} else this.addFaceNormal(u, d, f);
+			if (r !== void 0 && r !== "") {
+				let e = this.uvs.length;
+				u = this.parseUVIndex(r, e), d = this.parseUVIndex(i, e), f = this.parseUVIndex(a, e), this.addUV(u, d, f), this.object.geometry.hasUVIndices = !0;
+			} else this.addDefaultUV();
+		},
+		addPointGeometry: function(e) {
+			this.object.geometry.type = "Points";
+			let t = this.vertices.length;
+			for (let n = 0, r = e.length; n < r; n++) {
+				let r = this.parseVertexIndex(e[n], t);
+				this.addVertexPoint(r), this.addColor(r);
+			}
+		},
+		addLineGeometry: function(e, t) {
+			this.object.geometry.type = "Line";
+			let n = this.vertices.length, r = this.uvs.length;
+			for (let t = 0, r = e.length; t < r; t++) this.addVertexLine(this.parseVertexIndex(e[t], n));
+			for (let e = 0, n = t.length; e < n; e++) this.addUVLine(this.parseUVIndex(t[e], r));
+		}
+	};
+	return e.startObject("", !1), e;
+}
+var D = class extends s {
+	constructor(e) {
+		super(e), this.materials = null;
+	}
+	load(e, t, r, i) {
+		let a = this, o = new n(this.manager);
+		o.setPath(this.path), o.setRequestHeader(this.requestHeader), o.setWithCredentials(this.withCredentials), o.load(e, function(n) {
+			try {
+				t(a.parse(n));
+			} catch (t) {
+				i ? i(t) : console.error(t), a.manager.itemError(e);
+			}
+		}, r, i);
+	}
+	setMaterials(e) {
+		return this.materials = e, this;
+	}
+	parse(t) {
+		let n = new E();
+		t.indexOf("\r\n") !== -1 && (t = t.replace(/\r\n/g, "\n")), t.indexOf("\\\n") !== -1 && (t = t.replace(/\\\n/g, ""));
+		let s = t.split("\n"), m = [];
+		for (let e = 0, t = s.length; e < t; e++) {
+			let t = s[e].trimStart();
+			if (t.length === 0) continue;
+			let r = t.charAt(0);
+			if (r !== "#") if (r === "v") {
+				let e = t.split(y);
+				switch (e[0]) {
+					case "v":
+						n.vertices.push(parseFloat(e[1]), parseFloat(e[2]), parseFloat(e[3])), e.length >= 7 ? (T.setRGB(parseFloat(e[4]), parseFloat(e[5]), parseFloat(e[6]), p), n.colors.push(T.r, T.g, T.b)) : n.colors.push(void 0, void 0, void 0);
+						break;
+					case "vn":
+						n.normals.push(parseFloat(e[1]), parseFloat(e[2]), parseFloat(e[3]));
+						break;
+					case "vt":
+						n.uvs.push(parseFloat(e[1]), parseFloat(e[2]));
+						break;
+				}
+			} else if (r === "f") {
+				let e = t.slice(1).trim().split(y), r = [];
+				for (let t = 0, n = e.length; t < n; t++) {
+					let n = e[t];
+					if (n.length > 0) {
+						let e = n.split("/");
+						r.push(e);
+					}
+				}
+				let i = r[0];
+				for (let e = 1, t = r.length - 1; e < t; e++) {
+					let t = r[e], a = r[e + 1];
+					n.addFace(i[0], t[0], a[0], i[1], t[1], a[1], i[2], t[2], a[2]);
+				}
+			} else if (r === "l") {
+				let e = t.substring(1).trim().split(" "), r = [], i = [];
+				if (t.indexOf("/") === -1) r = e;
+				else for (let t = 0, n = e.length; t < n; t++) {
+					let n = e[t].split("/");
+					n[0] !== "" && r.push(n[0]), n[1] !== "" && i.push(n[1]);
+				}
+				n.addLineGeometry(r, i);
+			} else if (r === "p") {
+				let e = t.slice(1).trim().split(" ");
+				n.addPointGeometry(e);
+			} else if ((m = h.exec(t)) !== null) {
+				let e = (" " + m[0].slice(1).trim()).slice(1);
+				n.startObject(e);
+			} else if (_.test(t)) n.object.startMaterial(t.substring(7).trim(), n.materialLibraries);
+			else if (g.test(t)) n.materialLibraries.push(t.substring(7).trim());
+			else if (v.test(t)) console.warn("THREE.OBJLoader: Rendering identifier \"usemap\" not supported. Textures must be defined in MTL files.");
+			else if (r === "s") {
+				if (m = t.split(" "), m.length > 1) {
+					let e = m[1].trim().toLowerCase();
+					n.object.smooth = e !== "0" && e !== "off";
+				} else n.object.smooth = !0;
+				let e = n.object.currentMaterial();
+				e && (e.smooth = n.object.smooth);
+			} else {
+				if (t === "\0") continue;
+				console.warn("THREE.OBJLoader: Unexpected line: \"" + t + "\"");
+			}
+		}
+		n.finalize();
+		let b = new i();
+		if (b.materialLibraries = [].concat(n.materialLibraries), !(n.objects.length === 1 && n.objects[0].geometry.vertices.length === 0)) for (let t = 0, i = n.objects.length; t < i; t++) {
+			let i = n.objects[t], s = i.geometry, p = i.materials, m = s.type === "Line", h = s.type === "Points", g = !1;
+			if (s.vertices.length === 0) continue;
+			let _ = new e();
+			_.setAttribute("position", new r(s.vertices, 3)), s.normals.length > 0 && _.setAttribute("normal", new r(s.normals, 3)), s.colors.length > 0 && (g = !0, _.setAttribute("color", new r(s.colors, 3))), s.hasUVIndices === !0 && _.setAttribute("uv", new r(s.uvs, 2));
+			let v = [];
+			for (let e = 0, t = p.length; e < t; e++) {
+				let t = p[e], r = t.name + "_" + t.smooth + "_" + g, i = n.materials[r];
+				if (this.materials !== null) {
+					if (i = this.materials.create(t.name), m && i && !(i instanceof a)) {
+						let e = new a();
+						c.prototype.copy.call(e, i), e.color.copy(i.color), i = e;
+					} else if (h && i && !(i instanceof f)) {
+						let e = new f({
+							size: 10,
+							sizeAttenuation: !1
+						});
+						c.prototype.copy.call(e, i), e.color.copy(i.color), e.map = i.map, i = e;
+					}
+				}
+				i === void 0 && (i = m ? new a() : h ? new f({
+					size: 1,
+					sizeAttenuation: !1
+				}) : new u(), i.name = t.name, i.flatShading = !t.smooth, i.vertexColors = g, n.materials[r] = i), v.push(i);
+			}
+			let y;
+			if (v.length > 1) {
+				for (let e = 0, t = p.length; e < t; e++) {
+					let t = p[e];
+					_.addGroup(t.groupStart, t.groupCount, e);
+				}
+				y = m ? new o(_, v) : h ? new d(_, v) : new l(_, v);
+			} else y = m ? new o(_, v[0]) : h ? new d(_, v[0]) : new l(_, v[0]);
+			y.name = i.name, b.add(y);
+		}
+		else if (n.vertices.length > 0) {
+			let t = new f({
+				size: 1,
+				sizeAttenuation: !1
+			}), i = new e();
+			i.setAttribute("position", new r(n.vertices, 3)), n.colors.length > 0 && n.colors[0] !== void 0 && (i.setAttribute("color", new r(n.colors, 3)), t.vertexColors = !0);
+			let a = new d(i, t);
+			b.add(a);
+		}
+		return b;
+	}
+};
+//#endregion
+export { D as OBJLoader };

package/dist/audio/Voiceover.d.ts

@@ -0,0 +1,95 @@
+import { AddSoundOptions, AudioTrack } from '../core/AudioManager';
+import { Bookmark } from './bookmarks';
+import { SpeechOptions, SpeechSynthesizer } from './speechSynthesizer';
+/**
+ * Tracks one narration segment: lets a callback wait for a bookmark or for the
+ * whole narration to finish. One tracker is created per `voiceover` call.
+ */
+export interface VoiceoverTracker {
+    /** The spoken text, with bookmark markers already removed. */
+    readonly text: string;
+    /** Every bookmark found in the transcript, in order. */
+    readonly bookmarks: ReadonlyArray<Bookmark>;
+    /** Resolves when the narration finishes (or fails, or is cancelled). */
+    readonly finished: Promise<void>;
+    /** The failure message if the narration errored, else `null`. */
+    readonly error: string | null;
+    /**
+     * Resolve when the narration reaches `mark`. Resolves immediately if the
+     * mark was already reached, and resolves on finish if the mark never arrives
+     * (so an animation beat never hangs).
+     */
+    waitForMark(mark: string): Promise<void>;
+    /** Resolve when the narration finishes. Same promise as {@link finished}. */
+    waitForFinish(): Promise<void>;
+    /** Whether the narration has already reached `mark`. */
+    markReached(mark: string): boolean;
+}
+/** Options for a `Voiceover` instance or a single `voiceover` call. */
+export interface VoiceoverOptions extends SpeechOptions {
+    /** A synthesizer that overrides the injected / default one for this scope. */
+    synthesizer?: SpeechSynthesizer;
+}
+/** A callback that runs animations while the narration plays. */
+export type VoiceoverCallback = (tracker: VoiceoverTracker) => void | Promise<void>;
+/** The scheduler a pre-recorded voiceover plays through (AudioManager satisfies it). */
+export interface VoiceoverAudioScheduler {
+    /** Schedule a clip on the timeline. */
+    addSound(url: string, options?: AddSoundOptions): Promise<AudioTrack>;
+    /** Start playback of the scheduled timeline. */
+    play(): void;
+}
+/** Options for a pre-recorded voiceover. */
+export interface VoiceoverAudioOptions {
+    /** URL of the narration audio clip. */
+    url: string;
+    /** The scheduler that plays the clip (usually a scene's `audioManager`). */
+    audioManager: VoiceoverAudioScheduler;
+    /** Map of bookmark name to time in seconds from the clip start. */
+    bookmarks?: Record<string, number>;
+    /** When to start the clip on the scheduler timeline (seconds). Default 0. */
+    time?: number;
+    /** Narration length in seconds. Falls back to the scheduled track duration. */
+    duration?: number;
+    /** Playback gain in [0, 1]. */
+    gain?: number;
+}
+/**
+ * Narrates text and syncs animation beats to the narration.
+ *
+ * One instance can be reused for a whole scene; each `voiceover` call is one
+ * narration segment with its own tracker.
+ */
+export declare class Voiceover {
+    private readonly _options;
+    private _activeHandle;
+    constructor(options?: VoiceoverOptions);
+    /**
+     * Speak `text` and run `callback` while it plays.
+     *
+     * The narration and the callback run together. Any `<bookmark mark="..."/>`
+     * markers in `text` are stripped before speaking and exposed through the
+     * tracker. The returned promise resolves after the narration finishes.
+     *
+     * @param text - Narration, optionally with bookmark markers.
+     * @param callback - Runs animations; may await `tracker.waitForMark`.
+     * @param options - Per-call speech options (merged over the instance options).
+     * @returns The tracker for this narration segment.
+     */
+    voiceover(text: string, callback?: VoiceoverCallback, options?: VoiceoverOptions): Promise<VoiceoverTracker>;
+    /**
+     * Play a pre-recorded narration clip through the given scheduler and sync
+     * animation beats to explicit bookmark times.
+     *
+     * Scheduling is delegated to the {@link VoiceoverAudioScheduler} (normally a
+     * scene's `audioManager`); this method never duplicates audio scheduling.
+     *
+     * @param options - Clip URL, scheduler, bookmark times and timing.
+     * @param callback - Runs animations; may await `tracker.waitForMark`.
+     * @returns The tracker for this narration segment.
+     */
+    voiceoverAudio(options: VoiceoverAudioOptions, callback?: VoiceoverCallback): Promise<VoiceoverTracker>;
+    /** Cancel the narration currently in flight, if any. */
+    cancel(): void;
+}
+//# sourceMappingURL=Voiceover.d.ts.map

package/dist/audio/Voiceover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Voiceover.d.ts","sourceRoot":"","sources":["../../src/audio/Voiceover.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAExE,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACvB,MAAM,qBAAqB,CAAC;AAM7B;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,wDAAwD;IACxD,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC5C,wEAAwE;IACxE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,iEAAiE;IACjE,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B;;;;OAIG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,6EAA6E;IAC7E,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,wDAAwD;IACxD,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CACpC;AAyGD,uEAAuE;AACvE,MAAM,WAAW,gBAAiB,SAAQ,aAAa;IACrD,8EAA8E;IAC9E,WAAW,CAAC,EAAE,iBAAiB,CAAC;CACjC;AAED,iEAAiE;AACjE,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEpF,wFAAwF;AACxF,MAAM,WAAW,uBAAuB;IACtC,uCAAuC;IACvC,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACtE,gDAAgD;IAChD,IAAI,IAAI,IAAI,CAAC;CACd;AAED,4CAA4C;AAC5C,MAAM,WAAW,qBAAqB;IACpC,uCAAuC;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,4EAA4E;IAC5E,YAAY,EAAE,uBAAuB,CAAC;IACtC,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,6EAA6E;IAC7E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAiBD;;;;;GAKG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmB;IAC5C,OAAO,CAAC,aAAa,CAAmC;gBAE5C,OAAO,GAAE,gBAAqB;IAI1C;;;;;;;;;;;OAWG;IACG,SAAS,CACb,IAAI,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,iBAAiB,EAC5B,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,gBAAgB,CAAC;IA4B5B;;;;;;;;;;OAUG;IACG,cAAc,CAClB,OAAO,EAAE,qBAAqB,EAC9B,QAAQ,CAAC,EAAE,iBAAiB,GAC3B,OAAO,CAAC,gBAAgB,CAAC;IA0B5B,wDAAwD;IACxD,MAAM,IAAI,IAAI;CAMf"}