@vctrl/hooks 0.25.0 → 1.0.0

package/use-load-model-CRDVzrPC.js

@@ -0,0 +1,635 @@
+import { ModelFileTypes as e, ModelLoader as t, isMissingAssetsError as n, isThreeSourceFormat as r, missingAssetsError as i, referenceIn as a, resolutionKey as o, selectionKey as s } from "@vctrl/core/model-loader";
+import { useCallback as c, useMemo as l, useRef as u, useState as d } from "react";
+import { IMPORTABLE_FORMAT_IDS as f, modelFormatForFileName as p } from "@vctrl/core/model-formats";
+import { PERSISTED_BAKE_FILENAME as m, buildAssetLookupKeys as h, getSerializedAssetByteSize as g, isValidBase64 as _, normalizeAssetUri as v, normalizeCameraSettings as y, normalizeSceneInteractions as b, toSerializedAssetBytes as x } from "@vctrl/core";
+//#region packages/hooks/src/use-load-model/error-helpers.ts
+var S = (e) => typeof e == "object" && !!e && "code" in e && "recoverable" in e && "source" in e, C = ({ code: e, message: t, recoverable: n, source: r, cause: i, context: a }) => ({
+	code: e,
+	message: t,
+	recoverable: n,
+	source: r,
+	cause: i,
+	context: a
+}), w = (e) => e instanceof Error && e.message ? e.message : typeof e == "string" && e.trim().length > 0 ? e : "Unknown error", T = (e, t, r) => S(e) ? e : C({
+	code: n(e) ? "missing_assets" : t,
+	message: w(e),
+	recoverable: !0,
+	source: "local-upload",
+	cause: e,
+	context: r
+}), E = (e, t) => {
+	if (S(e)) return e;
+	let r = w(e), i = n(e) ? "missing_assets" : "server_load_failed";
+	return r.includes("Server responded with 404") ? i = "not_found" : (r.includes("Server responded with 402") || r.includes("Server responded with 403")) && (i = "quota_exceeded"), C({
+		code: i,
+		message: r,
+		recoverable: i !== "not_found",
+		source: "server-load",
+		cause: e,
+		context: { sceneId: t }
+	});
+}, D = async (e, t) => {
+	try {
+		await e();
+		return;
+	} catch (e) {
+		console.warn("Optimizer ingest failed.", e);
+	}
+	if (t) try {
+		await t();
+	} catch (e) {
+		console.warn("Optimizer fallback import failed; optimization is unavailable for this model.", e);
+	}
+}, O = (e) => {
+	let t = /* @__PURE__ */ new Set(), n = e, r = Array.isArray(n.images) ? n.images : [];
+	for (let e of r) typeof e.uri == "string" && !e.uri.startsWith("data:") && t.add(e.uri);
+	let i = Array.isArray(n.buffers) ? n.buffers : [];
+	for (let e of i) typeof e.uri == "string" && !e.uri.startsWith("data:") && t.add(e.uri);
+	return t;
+}, k = async (e, t) => {
+	let n = JSON.parse(await e.text()), r = O(n), o = {}, c = /* @__PURE__ */ new Map(), l = /* @__PURE__ */ new Map(), u = /* @__PURE__ */ new Set(), d = async (e) => {
+		let t = l.get(e);
+		if (t) return t;
+		let n = new Uint8Array(await e.arrayBuffer());
+		return l.set(e, n), n;
+	};
+	for (let e of t) c.set(s(e), e);
+	let f = s(e), p = [];
+	for (let e of r) {
+		let t = v(e), n = a(c, e, f);
+		if (!n) {
+			p.push(e);
+			continue;
+		}
+		u.add(n);
+		let r = await d(n);
+		o[t] = {
+			data: Array.from(r),
+			fileName: t,
+			mimeType: n.type || "application/octet-stream"
+		};
+	}
+	if (p.length > 0) throw i(`Scene payload is missing required referenced assets: ${p.slice(0, 5).join(", ")}`);
+	for (let [e, n] of t.entries()) {
+		if (u.has(n)) continue;
+		let t = v(n.name), r = t.split("/").pop() || t, i = await d(n);
+		o[`extra-${e}-${r}`] = {
+			data: Array.from(i),
+			fileName: r,
+			mimeType: n.type || "application/octet-stream"
+		};
+	}
+	return {
+		gltfJson: n,
+		assetData: o
+	};
+};
+//#endregion
+//#region packages/hooks/src/use-load-model/utils/read-directory.ts
+async function ee(e) {
+	let t = [];
+	async function* n(e, t) {
+		let r = e;
+		for await (let [e, i] of r) i.kind === "file" ? yield te(await i.getFile(), `${t}${e}`) : i.kind === "directory" && (yield* n(i, `${t}${e}/`));
+	}
+	for await (let r of n(e, `${e.name}/`)) t.push(r);
+	return t;
+}
+function te(e, t) {
+	return Object.defineProperty(e, "webkitRelativePath", {
+		value: t,
+		configurable: !0,
+		enumerable: !0
+	}), e;
+}
+//#endregion
+//#region packages/hooks/src/use-load-model/utils/reconstruct-files.ts
+function A(e) {
+	let t = (e ?? "").replace(/[\\/]+/g, "_").replace(/^\.+/, "");
+	return t ? `${t}.gltf` : "scene.gltf";
+}
+function j(e) {
+	let t = [];
+	if (e.assetData && typeof e.assetData == "object") for (let [, n] of Object.entries(e.assetData)) {
+		let { fileName: e, mimeType: r } = n;
+		if (e === m) continue;
+		let i = x(n), a = new Uint8Array(i.byteLength);
+		a.set(i);
+		let o = new Blob([a], { type: r }), s = new File([o], e, { type: r });
+		t.push(s);
+	}
+	if (!e.gltfJson) throw Error("Cannot reconstruct glTF files: this scene has no glTF document.");
+	let n = JSON.stringify(e.gltfJson), r = new Blob([n], { type: "model/gltf+json" }), i = A(e.meta?.name);
+	return [new File([r], i, { type: "model/gltf+json" }), ...t];
+}
+//#endregion
+//#region packages/hooks/src/use-load-model/utils/calculate-referenced-bytes.ts
+var ne = (e) => {
+	let t = /* @__PURE__ */ new Map();
+	for (let n of Object.values(e.assetData || {})) t.set(o(n.fileName), g(n.data));
+	return (e) => a(t, e) ?? 0;
+}, re = (e, t) => {
+	let n = /* @__PURE__ */ new Map();
+	for (let e of t) n.set(s(e), e.size);
+	let r = s(e);
+	return (e) => a(n, e, r) ?? 0;
+}, M = (e) => {
+	let t = /* @__PURE__ */ new Set(), n = /* @__PURE__ */ new Set(), r = e, i = Array.isArray(r.images) ? r.images : [];
+	for (let e of i) typeof e.uri == "string" && !e.uri.startsWith("data:") && n.add(e.uri);
+	let a = Array.isArray(r.buffers) ? r.buffers : [];
+	for (let e of a) typeof e.uri == "string" && !e.uri.startsWith("data:") && t.add(e.uri);
+	return {
+		bufferUris: t,
+		imageUris: n
+	};
+};
+async function ie(e, t) {
+	let n = await e.text(), r;
+	try {
+		r = JSON.parse(n);
+	} catch {
+		return {
+			sourcePackageBytes: e.size,
+			textureBytes: 0
+		};
+	}
+	let i = re(e, t), { bufferUris: a, imageUris: o } = M(r), s = Array.from(a).reduce((e, t) => e + i(t), 0), c = Array.from(o).reduce((e, t) => e + i(t), 0);
+	return {
+		sourcePackageBytes: e.size + s + c,
+		textureBytes: c
+	};
+}
+function ae(e) {
+	let t = e.gltfJson;
+	if (!t) return {
+		sourcePackageBytes: 0,
+		textureBytes: 0
+	};
+	let n = ne(e), r = new TextEncoder().encode(JSON.stringify(t)).byteLength, { bufferUris: i, imageUris: a } = M(t), o = Array.from(i).reduce((e, t) => e + n(t), 0), s = Array.from(a).reduce((e, t) => e + n(t), 0);
+	return {
+		sourcePackageBytes: r + o + s,
+		textureBytes: s
+	};
+}
+//#endregion
+//#region packages/hooks/src/use-load-model/utils/resolve-scene-payload.ts
+function N(e) {
+	return typeof e == "object" && !!e && !Array.isArray(e);
+}
+function P(e) {
+	let t = N(e.settings) ? e.settings : {}, n = y(e.camera ?? t.camera);
+	return {
+		...t,
+		bounds: e.bounds ?? t.bounds,
+		camera: n,
+		interactions: b(t.interactions, { camera: n }),
+		controls: e.controls ?? t.controls,
+		environment: e.environment ?? t.environment,
+		shadows: e.shadows ?? t.shadows
+	};
+}
+function F(e) {
+	let t = /* @__PURE__ */ new Set(), n = e, r = Array.isArray(n.images) ? n.images : [];
+	for (let e of r) typeof e.uri == "string" && !e.uri.startsWith("data:") && t.add(e.uri);
+	let i = Array.isArray(n.buffers) ? n.buffers : [];
+	for (let e of i) typeof e.uri == "string" && !e.uri.startsWith("data:") && t.add(e.uri);
+	return t;
+}
+function I(e) {
+	for (let [t, n] of Object.entries(e)) {
+		if (!n || typeof n != "object") throw Error(`Scene payload contains invalid asset entry for ${t}`);
+		if (typeof n.fileName != "string" || n.fileName.trim().length === 0) throw Error(`Scene payload asset ${t} is missing a valid fileName`);
+		if (typeof n.mimeType != "string" || n.mimeType.trim().length === 0) throw Error(`Scene payload asset ${t} is missing a valid mimeType`);
+		if (typeof n.data == "string" && n.encoding === "base64" && !_(n.data)) throw Error(`Scene payload asset ${n.fileName} has invalid base64 data`);
+	}
+}
+function L(e, t) {
+	let n = F(e);
+	if (n.size === 0) return;
+	let r = /* @__PURE__ */ new Set();
+	for (let e of Object.values(t)) for (let t of h(e.fileName)) r.add(t);
+	let a = [];
+	for (let e of n) {
+		let t = v(e), n = t.split("/").pop() || t;
+		!r.has(e) && !r.has(t) && !r.has(n) && a.push(e);
+	}
+	if (a.length > 0) throw i(`Scene payload is missing required referenced assets: ${a.slice(0, 5).join(", ")}`);
+}
+function R(e) {
+	if (!N(e.gltfJson)) throw Error("Scene payload is missing a valid glTF document");
+	let t = e.assetData ?? {};
+	return I(t), L(e.gltfJson, t), {
+		meta: e.meta,
+		gltfJson: e.gltfJson,
+		assetData: t,
+		...P(e)
+	};
+}
+function z(e) {
+	let t = e.assetData ?? {};
+	return I(t), {
+		meta: e.meta,
+		gltfJson: null,
+		assetData: t,
+		...P(e)
+	};
+}
+//#endregion
+//#region packages/hooks/src/use-load-model/utils/fetch-manifest-assets.ts
+async function B(e, t = {}) {
+	let n = Object.entries(e);
+	if (n.length === 0) return t.onProgress?.(1), {};
+	let r = n.every(([, e]) => e.byteSize != null), i = r ? n.reduce((e, [, t]) => e + (t.byteSize ?? 0), 0) : 0, a = 0, o = 0, s = {}, c = new AbortController();
+	return await Promise.all(n.map(async ([e, l]) => {
+		try {
+			let u = await fetch(l.url, {
+				headers: t.headers,
+				credentials: "same-origin",
+				signal: c.signal
+			});
+			if (!u.ok) throw c.abort(), Error(`Failed to fetch scene asset ${l.fileName}: ${u.status}`);
+			let d = new Uint8Array(await u.arrayBuffer());
+			s[e] = {
+				data: d,
+				fileName: l.fileName,
+				mimeType: l.mimeType
+			}, o += 1, a += l.byteSize ?? 0, t.onProgress?.(r && i > 0 ? a / i : o / n.length);
+		} catch (e) {
+			throw c.abort(), e;
+		}
+	})), s;
+}
+//#endregion
+//#region packages/hooks/src/use-load-model/file-loaders.ts
+var V = (e) => {
+	let t = /* @__PURE__ */ new Map();
+	for (let n of e) {
+		let e = p(n.name);
+		!e?.canImport || t.has(e.id) || t.set(e.id, n);
+	}
+	return f.map((e) => t.get(e)).filter((e) => !!e);
+}, H = (e) => {
+	if (e.webkitRelativePath) return e;
+	let t = e.relativePath;
+	if (typeof t != "string") return e;
+	let n = t.replace(/^(\.?\/)+/, "");
+	return n.includes("/") && Object.defineProperty(e, "webkitRelativePath", {
+		value: n,
+		configurable: !0,
+		enumerable: !0
+	}), e;
+}, U = async (e) => {
+	let t = [];
+	for (let n of e) n instanceof File ? t.push(H(n)) : "kind" in n && n.kind === "directory" && t.push(...await ee(n));
+	return t;
+}, W = async (e, t) => {
+	let n = await U(e), i = V(n);
+	if (i.length > 1) throw C({
+		code: "multiple_models",
+		message: `Multiple models found: ${i.map((e) => e.name).join(", ")}`,
+		recoverable: !0,
+		source: "local-upload",
+		context: { fileNames: i.map((e) => e.name) }
+	});
+	if (i.length === 0) throw C({
+		code: "unsupported_format",
+		message: n.length ? `No supported model found in: ${n.map((e) => e.name).join(", ")}` : "No files to load",
+		recoverable: !0,
+		source: "local-upload",
+		context: { fileNames: n.map((e) => e.name) }
+	});
+	let a = i[0], o = p(a.name), s = o.isBundle ? n.filter((e) => e !== a) : [];
+	return o.isBundle && !r(o.id) ? K(a, s, t) : G(a, s, o.id, t);
+}, G = async (e, t, n, { modelLoader: r, optimizer: i, publish: a }) => {
+	let o, s;
+	try {
+		let i = await r.loadToThreeJS(e, t);
+		s = i.glbBytes, o = { file: {
+			model: i.scene,
+			animations: i.animations,
+			type: n,
+			name: e.name
+		} };
+	} catch (t) {
+		throw T(t, "binary_load_failed", {
+			fileName: e.name,
+			fileType: n,
+			fileSize: e.size
+		});
+	}
+	return a(o), i && await D(async () => {
+		let t = s ?? new Uint8Array(await e.arrayBuffer());
+		await i.loadFromGlbBuffer(t);
+	}), o;
+}, K = async (t, n, { modelLoader: r, optimizer: i, publish: o }) => {
+	let c;
+	try {
+		let { sourcePackageBytes: i, textureBytes: a } = await ie(t, n), o = await r.loadGLTFWithAssetsToThreeJS(t, n);
+		c = { file: {
+			model: o.scene,
+			animations: o.animations,
+			type: e.gltf,
+			name: t.name,
+			sourcePackageBytes: i,
+			sourceTextureBytes: a
+		} };
+	} catch (e) {
+		throw T(e, "gltf_load_failed", {
+			fileName: t.name,
+			fileSize: t.size,
+			assetCount: n.length
+		});
+	}
+	return o(c), i && await D(async () => {
+		try {
+			let e = await k(t, n);
+			await i.loadFromServerSceneData(e);
+		} catch (e) {
+			if (console.warn("Failed to initialize optimizer from source GLTF payload; trying direct asset load.", e), !("loadFromGLTFWithAssets" in i)) throw Error("loadFromGLTFWithAssets not available");
+			let r = new Uint8Array(await t.arrayBuffer()), o = /* @__PURE__ */ new Map();
+			for (let e of n) o.set(s(e), new Uint8Array(await e.arrayBuffer()));
+			let c = s(t), l = /* @__PURE__ */ new Map();
+			for (let e of O(JSON.parse(new TextDecoder().decode(r)))) {
+				let t = a(o, e, c);
+				t && l.set(e, t);
+			}
+			await i.loadFromGLTFWithAssets(r, l);
+		}
+	}, () => i.load(c.file.model)), c;
+};
+//#endregion
+//#region packages/hooks/src/use-load-model/optimizer-integration.ts
+function q(t, n, r, i) {
+	let a = c(async (a, o) => {
+		if (!t) {
+			console.warn("Optimizer is not available");
+			return;
+		}
+		try {
+			a && await a(o);
+			let s = await t.getModel();
+			if (!s) {
+				console.warn("No optimized model available after optimization");
+				return;
+			}
+			let c = s instanceof Uint8Array ? s.slice() : new Uint8Array(s).slice(), l = new File([c], r?.name || "optimized_model.glb", { type: "model/gltf-binary" }), u = await i.loadToThreeJS(l);
+			n({
+				model: u.scene,
+				animations: u.animations,
+				type: e.glb,
+				name: l.name
+			});
+		} catch (e) {
+			console.error("Optimization failed:", e);
+		}
+	}, [
+		t,
+		i,
+		r,
+		n
+	]);
+	return t ? {
+		...t,
+		isPreparing: !!r?.model && !t.isReady,
+		applyOptimization: a
+	} : null;
+}
+//#endregion
+//#region packages/hooks/src/use-load-model/scene-loaders.ts
+var oe = ({ sceneId: e, serverOptions: t }) => ({
+	endpoint: t?.endpoint ?? `/api/scenes/${e}`,
+	headers: t?.apiKey ? {
+		Authorization: `Bearer ${t.apiKey}`,
+		...t.headers
+	} : { ...t?.headers }
+}), J = "__vctrl_published_model__", se = async (t, n, r, { modelLoader: i, publish: a, onProgress: o }, s) => {
+	let c = await B({
+		...n.assetRefs ?? {},
+		[J]: r
+	}, {
+		headers: s,
+		onProgress: (e) => o(Math.round(e * 60))
+	}), l = c[J];
+	if (delete c[J], !l) throw C({
+		code: "missing_assets",
+		message: "This scene has no published model to load.",
+		recoverable: !1,
+		source: "server-load",
+		context: { sceneId: t }
+	});
+	let u = z({
+		...n,
+		assetData: c
+	});
+	o(70);
+	let d = x(l), f = new Uint8Array(d.byteLength);
+	f.set(d);
+	let p = new Blob([f], { type: r.mimeType }), m = await i.loadToThreeJS(new File([p], r.fileName, { type: r.mimeType })), h = {
+		file: {
+			model: m.scene,
+			animations: m.animations,
+			type: e.glb,
+			name: u.meta?.name || r.fileName,
+			sourcePackageBytes: r.byteSize ?? void 0
+		},
+		sceneId: t,
+		sceneData: u
+	};
+	return a(h), h;
+}, Y = async (t, n, r) => {
+	let { sceneId: i, sceneData: a, parseMode: o } = t, { modelLoader: s, optimizer: c, publish: l, onProgress: u } = n;
+	if (a.publishedModel) return se(i, a, a.publishedModel, n, r);
+	if (!a.gltfJson) throw C({
+		code: "missing_assets",
+		message: "This scene has no model data to load.",
+		recoverable: !1,
+		source: "server-load",
+		context: { sceneId: i }
+	});
+	let d = R(a.assetRefs && !a.assetData ? {
+		...a,
+		assetData: await B(a.assetRefs, {
+			headers: r,
+			onProgress: (e) => u(Math.round(e * 40))
+		})
+	} : a);
+	u(40);
+	let { sourcePackageBytes: f, textureBytes: p } = ae(d);
+	if (o === "direct" && d.gltfJson) {
+		let t = /* @__PURE__ */ new Map();
+		for (let e of Object.values(d.assetData ?? {})) e.fileName !== m && t.set(e.fileName, x(e));
+		u(60);
+		let n = await s.parseGLTFJsonToThreeJS(d.gltfJson, t), r = {
+			file: {
+				model: n.scene,
+				animations: n.animations,
+				type: e.gltf,
+				name: d.meta?.name || "scene",
+				sourcePackageBytes: f,
+				sourceTextureBytes: p
+			},
+			sceneId: i,
+			sceneData: d
+		};
+		return l(r), r;
+	}
+	let h = j(d);
+	u(60);
+	let g = h[0], _ = h.slice(1), v = await s.loadGLTFWithAssetsToThreeJS(g, _), y = {
+		file: {
+			model: v.scene,
+			animations: v.animations,
+			type: e.gltf,
+			name: g.name,
+			sourcePackageBytes: f,
+			sourceTextureBytes: p
+		},
+		sceneId: i,
+		sceneData: d
+	};
+	return l(y), c && await D(() => c.loadFromServerSceneData(d)), y;
+}, ce = async (e, t) => {
+	let { sceneId: n, parseMode: r } = e, { onProgress: i } = t, { endpoint: a, headers: o } = oe(e);
+	try {
+		return i(0), await Y({
+			kind: "scene-data",
+			sceneId: n,
+			sceneData: await ue(a, o) ?? await de(a, o, n),
+			parseMode: r
+		}, t, o);
+	} catch (e) {
+		throw E(e, n);
+	}
+}, le = /* @__PURE__ */ new Set([
+	401,
+	403,
+	404
+]);
+async function ue(e, t) {
+	try {
+		let n = await fetch(e, {
+			method: "GET",
+			headers: {
+				Accept: "application/json",
+				...t
+			}
+		});
+		if (le.has(n.status)) throw C({
+			code: n.status === 404 ? "not_found" : "server_load_failed",
+			message: `Server responded with ${n.status} ${n.statusText}`,
+			recoverable: !1,
+			source: "server-load",
+			context: {
+				endpoint: e,
+				status: n.status
+			}
+		});
+		if (!n.ok) return null;
+		let r = await n.json(), i = r.data ?? r;
+		return !i || typeof i != "object" ? null : i.publishedModel ? i : !i.gltfJson || !i.assetRefs && !i.assetData ? null : i;
+	} catch (e) {
+		if (S(e)) throw e;
+		return null;
+	}
+}
+async function de(e, t, n) {
+	let r = new FormData();
+	r.append("action", "get-scene-settings"), r.append("sceneId", n);
+	let i = await fetch(e, {
+		method: "POST",
+		headers: t,
+		body: r
+	});
+	if (!i.ok) throw Error(`Server responded with ${i.status} ${i.statusText}`);
+	let a = await i.json();
+	return a.data ?? a;
+}
+//#endregion
+//#region packages/hooks/src/use-load-model/state.ts
+var X = [...f], Z = {
+	status: "empty",
+	file: null,
+	error: null,
+	source: null,
+	progress: 0
+}, fe = (e, t = 0) => ({
+	status: "loading",
+	file: null,
+	error: null,
+	source: e,
+	progress: t
+}), Q = (e, t) => ({
+	status: "ready",
+	file: t.file,
+	error: null,
+	source: e,
+	progress: 100,
+	sceneId: t.sceneId,
+	sceneData: t.sceneData
+}), $ = (e, t) => ({
+	status: "error",
+	file: null,
+	error: t,
+	source: e,
+	progress: 0
+});
+//#endregion
+//#region packages/hooks/src/use-load-model/use-load-model.ts
+function pe(e) {
+	let [n, r] = d(Z), i = u(e);
+	i.current = e;
+	let a = u(0), o = l(() => {
+		let e = new t();
+		return e.onProgress((e) => {
+			r((t) => t.status === "loading" ? {
+				...t,
+				progress: e.progress
+			} : t);
+		}), e;
+	}, []), s = u(n);
+	s.current = n;
+	let f = u(null);
+	n.status === "ready" && (f.current = n);
+	let p = c(async (e, t) => {
+		let n = ++a.current, s = () => a.current === n, c = (e) => ({
+			...e,
+			stillCurrent: s
+		}), l = e.kind === "files" ? f.current : null, u = (e) => (s() && (e.status === "ready" && (f.current = e), r(e)), e), d = null, p = {
+			modelLoader: o,
+			optimizer: i.current,
+			publish: (n) => {
+				d = u(Q(e.kind, n)), s() && t?.onPublish?.(c(d));
+			},
+			onProgress: (e) => {
+				s() && r((t) => t.status === "loading" ? {
+					...t,
+					progress: e
+				} : t);
+			}
+		};
+		u(fe(e.kind));
+		try {
+			let t = e.kind === "files" ? await W(e.files, p) : e.kind === "scene-data" ? await Y(e, p) : await ce(e, p);
+			return c(d ?? u(Q(e.kind, t)));
+		} catch (t) {
+			let n = e.kind === "files" ? T(t, "unknown") : E(t, e.sceneId ?? "");
+			return console.error(`Model load failed (${e.kind}):`, n), u(l ?? $(e.kind, n)), c($(e.kind, n));
+		}
+	}, [o]), m = c(() => {
+		a.current += 1, f.current = null, r(Z);
+	}, []), h = q(e, c((e) => {
+		r((t) => t.status === "ready" ? {
+			...t,
+			file: e
+		} : t);
+	}, []), n.file, o);
+	return {
+		...n,
+		supportedFileTypes: X,
+		load: p,
+		reset: m,
+		optimizer: h
+	};
+}
+//#endregion
+export { B as n, j as r, pe as t };

package/use-load-model-CZCi6bPM.cjs

@@ -0,0 +1 @@
+let e=require("@vctrl/core/model-loader"),t=require("react"),n=require("@vctrl/core/model-formats"),r=require("@vctrl/core");var i=e=>typeof e==`object`&&!!e&&`code`in e&&`recoverable`in e&&`source`in e,a=({code:e,message:t,recoverable:n,source:r,cause:i,context:a})=>({code:e,message:t,recoverable:n,source:r,cause:i,context:a}),o=e=>e instanceof Error&&e.message?e.message:typeof e==`string`&&e.trim().length>0?e:`Unknown error`,s=(t,n,r)=>i(t)?t:a({code:(0,e.isMissingAssetsError)(t)?`missing_assets`:n,message:o(t),recoverable:!0,source:`local-upload`,cause:t,context:r}),c=(t,n)=>{if(i(t))return t;let r=o(t),s=(0,e.isMissingAssetsError)(t)?`missing_assets`:`server_load_failed`;return r.includes(`Server responded with 404`)?s=`not_found`:(r.includes(`Server responded with 402`)||r.includes(`Server responded with 403`))&&(s=`quota_exceeded`),a({code:s,message:r,recoverable:s!==`not_found`,source:`server-load`,cause:t,context:{sceneId:n}})},l=async(e,t)=>{try{await e();return}catch(e){console.warn(`Optimizer ingest failed.`,e)}if(t)try{await t()}catch(e){console.warn(`Optimizer fallback import failed; optimization is unavailable for this model.`,e)}},u=e=>{let t=new Set,n=e,r=Array.isArray(n.images)?n.images:[];for(let e of r)typeof e.uri==`string`&&!e.uri.startsWith(`data:`)&&t.add(e.uri);let i=Array.isArray(n.buffers)?n.buffers:[];for(let e of i)typeof e.uri==`string`&&!e.uri.startsWith(`data:`)&&t.add(e.uri);return t},d=async(t,n)=>{let i=JSON.parse(await t.text()),a=u(i),o={},s=new Map,c=new Map,l=new Set,d=async e=>{let t=c.get(e);if(t)return t;let n=new Uint8Array(await e.arrayBuffer());return c.set(e,n),n};for(let t of n)s.set((0,e.selectionKey)(t),t);let f=(0,e.selectionKey)(t),p=[];for(let t of a){let n=(0,r.normalizeAssetUri)(t),i=(0,e.referenceIn)(s,t,f);if(!i){p.push(t);continue}l.add(i);let a=await d(i);o[n]={data:Array.from(a),fileName:n,mimeType:i.type||`application/octet-stream`}}if(p.length>0)throw(0,e.missingAssetsError)(`Scene payload is missing required referenced assets: ${p.slice(0,5).join(`, `)}`);for(let[e,t]of n.entries()){if(l.has(t))continue;let n=(0,r.normalizeAssetUri)(t.name),i=n.split(`/`).pop()||n,a=await d(t);o[`extra-${e}-${i}`]={data:Array.from(a),fileName:i,mimeType:t.type||`application/octet-stream`}}return{gltfJson:i,assetData:o}};async function f(e){let t=[];async function*n(e,t){let r=e;for await(let[e,i]of r)i.kind===`file`?yield p(await i.getFile(),`${t}${e}`):i.kind===`directory`&&(yield*n(i,`${t}${e}/`))}for await(let r of n(e,`${e.name}/`))t.push(r);return t}function p(e,t){return Object.defineProperty(e,"webkitRelativePath",{value:t,configurable:!0,enumerable:!0}),e}function m(e){let t=(e??``).replace(/[\\/]+/g,`_`).replace(/^\.+/,``);return t?`${t}.gltf`:`scene.gltf`}function h(e){let t=[];if(e.assetData&&typeof e.assetData==`object`)for(let[,n]of Object.entries(e.assetData)){let{fileName:e,mimeType:i}=n;if(e===r.PERSISTED_BAKE_FILENAME)continue;let a=(0,r.toSerializedAssetBytes)(n),o=new Uint8Array(a.byteLength);o.set(a);let s=new Blob([o],{type:i}),c=new File([s],e,{type:i});t.push(c)}if(!e.gltfJson)throw Error(`Cannot reconstruct glTF files: this scene has no glTF document.`);let n=JSON.stringify(e.gltfJson),i=new Blob([n],{type:`model/gltf+json`}),a=m(e.meta?.name);return[new File([i],a,{type:`model/gltf+json`}),...t]}var g=t=>{let n=new Map;for(let i of Object.values(t.assetData||{}))n.set((0,e.resolutionKey)(i.fileName),(0,r.getSerializedAssetByteSize)(i.data));return t=>(0,e.referenceIn)(n,t)??0},_=(t,n)=>{let r=new Map;for(let t of n)r.set((0,e.selectionKey)(t),t.size);let i=(0,e.selectionKey)(t);return t=>(0,e.referenceIn)(r,t,i)??0},v=e=>{let t=new Set,n=new Set,r=e,i=Array.isArray(r.images)?r.images:[];for(let e of i)typeof e.uri==`string`&&!e.uri.startsWith(`data:`)&&n.add(e.uri);let a=Array.isArray(r.buffers)?r.buffers:[];for(let e of a)typeof e.uri==`string`&&!e.uri.startsWith(`data:`)&&t.add(e.uri);return{bufferUris:t,imageUris:n}};async function y(e,t){let n=await e.text(),r;try{r=JSON.parse(n)}catch{return{sourcePackageBytes:e.size,textureBytes:0}}let i=_(e,t),{bufferUris:a,imageUris:o}=v(r),s=Array.from(a).reduce((e,t)=>e+i(t),0),c=Array.from(o).reduce((e,t)=>e+i(t),0);return{sourcePackageBytes:e.size+s+c,textureBytes:c}}function b(e){let t=e.gltfJson;if(!t)return{sourcePackageBytes:0,textureBytes:0};let n=g(e),r=new TextEncoder().encode(JSON.stringify(t)).byteLength,{bufferUris:i,imageUris:a}=v(t),o=Array.from(i).reduce((e,t)=>e+n(t),0),s=Array.from(a).reduce((e,t)=>e+n(t),0);return{sourcePackageBytes:r+o+s,textureBytes:s}}function x(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function S(e){let t=x(e.settings)?e.settings:{},n=(0,r.normalizeCameraSettings)(e.camera??t.camera);return{...t,bounds:e.bounds??t.bounds,camera:n,interactions:(0,r.normalizeSceneInteractions)(t.interactions,{camera:n}),controls:e.controls??t.controls,environment:e.environment??t.environment,shadows:e.shadows??t.shadows}}function C(e){let t=new Set,n=e,r=Array.isArray(n.images)?n.images:[];for(let e of r)typeof e.uri==`string`&&!e.uri.startsWith(`data:`)&&t.add(e.uri);let i=Array.isArray(n.buffers)?n.buffers:[];for(let e of i)typeof e.uri==`string`&&!e.uri.startsWith(`data:`)&&t.add(e.uri);return t}function w(e){for(let[t,n]of Object.entries(e)){if(!n||typeof n!=`object`)throw Error(`Scene payload contains invalid asset entry for ${t}`);if(typeof n.fileName!=`string`||n.fileName.trim().length===0)throw Error(`Scene payload asset ${t} is missing a valid fileName`);if(typeof n.mimeType!=`string`||n.mimeType.trim().length===0)throw Error(`Scene payload asset ${t} is missing a valid mimeType`);if(typeof n.data==`string`&&n.encoding===`base64`&&!(0,r.isValidBase64)(n.data))throw Error(`Scene payload asset ${n.fileName} has invalid base64 data`)}}function T(t,n){let i=C(t);if(i.size===0)return;let a=new Set;for(let e of Object.values(n))for(let t of(0,r.buildAssetLookupKeys)(e.fileName))a.add(t);let o=[];for(let e of i){let t=(0,r.normalizeAssetUri)(e),n=t.split(`/`).pop()||t;!a.has(e)&&!a.has(t)&&!a.has(n)&&o.push(e)}if(o.length>0)throw(0,e.missingAssetsError)(`Scene payload is missing required referenced assets: ${o.slice(0,5).join(`, `)}`)}function E(e){if(!x(e.gltfJson))throw Error(`Scene payload is missing a valid glTF document`);let t=e.assetData??{};return w(t),T(e.gltfJson,t),{meta:e.meta,gltfJson:e.gltfJson,assetData:t,...S(e)}}function D(e){let t=e.assetData??{};return w(t),{meta:e.meta,gltfJson:null,assetData:t,...S(e)}}async function O(e,t={}){let n=Object.entries(e);if(n.length===0)return t.onProgress?.(1),{};let r=n.every(([,e])=>e.byteSize!=null),i=r?n.reduce((e,[,t])=>e+(t.byteSize??0),0):0,a=0,o=0,s={},c=new AbortController;return await Promise.all(n.map(async([e,l])=>{try{let u=await fetch(l.url,{headers:t.headers,credentials:`same-origin`,signal:c.signal});if(!u.ok)throw c.abort(),Error(`Failed to fetch scene asset ${l.fileName}: ${u.status}`);let d=new Uint8Array(await u.arrayBuffer());s[e]={data:d,fileName:l.fileName,mimeType:l.mimeType},o+=1,a+=l.byteSize??0,t.onProgress?.(r&&i>0?a/i:o/n.length)}catch(e){throw c.abort(),e}})),s}var k=e=>{let t=new Map;for(let r of e){let e=(0,n.modelFormatForFileName)(r.name);!e?.canImport||t.has(e.id)||t.set(e.id,r)}return n.IMPORTABLE_FORMAT_IDS.map(e=>t.get(e)).filter(e=>!!e)},A=e=>{if(e.webkitRelativePath)return e;let t=e.relativePath;if(typeof t!=`string`)return e;let n=t.replace(/^(\.?\/)+/,``);return n.includes(`/`)&&Object.defineProperty(e,"webkitRelativePath",{value:n,configurable:!0,enumerable:!0}),e},j=async e=>{let t=[];for(let n of e)n instanceof File?t.push(A(n)):`kind`in n&&n.kind===`directory`&&t.push(...await f(n));return t},M=async(t,r)=>{let i=await j(t),o=k(i);if(o.length>1)throw a({code:`multiple_models`,message:`Multiple models found: ${o.map(e=>e.name).join(`, `)}`,recoverable:!0,source:`local-upload`,context:{fileNames:o.map(e=>e.name)}});if(o.length===0)throw a({code:`unsupported_format`,message:i.length?`No supported model found in: ${i.map(e=>e.name).join(`, `)}`:`No files to load`,recoverable:!0,source:`local-upload`,context:{fileNames:i.map(e=>e.name)}});let s=o[0],c=(0,n.modelFormatForFileName)(s.name),l=c.isBundle?i.filter(e=>e!==s):[];return c.isBundle&&!(0,e.isThreeSourceFormat)(c.id)?P(s,l,r):N(s,l,c.id,r)},N=async(e,t,n,{modelLoader:r,optimizer:i,publish:a})=>{let o,c;try{let i=await r.loadToThreeJS(e,t);c=i.glbBytes,o={file:{model:i.scene,animations:i.animations,type:n,name:e.name}}}catch(t){throw s(t,`binary_load_failed`,{fileName:e.name,fileType:n,fileSize:e.size})}return a(o),i&&await l(async()=>{let t=c??new Uint8Array(await e.arrayBuffer());await i.loadFromGlbBuffer(t)}),o},P=async(t,n,{modelLoader:r,optimizer:i,publish:a})=>{let o;try{let{sourcePackageBytes:i,textureBytes:a}=await y(t,n),s=await r.loadGLTFWithAssetsToThreeJS(t,n);o={file:{model:s.scene,animations:s.animations,type:e.ModelFileTypes.gltf,name:t.name,sourcePackageBytes:i,sourceTextureBytes:a}}}catch(e){throw s(e,`gltf_load_failed`,{fileName:t.name,fileSize:t.size,assetCount:n.length})}return a(o),i&&await l(async()=>{try{let e=await d(t,n);await i.loadFromServerSceneData(e)}catch(r){if(console.warn(`Failed to initialize optimizer from source GLTF payload; trying direct asset load.`,r),!(`loadFromGLTFWithAssets`in i))throw Error(`loadFromGLTFWithAssets not available`);let a=new Uint8Array(await t.arrayBuffer()),o=new Map;for(let t of n)o.set((0,e.selectionKey)(t),new Uint8Array(await t.arrayBuffer()));let s=(0,e.selectionKey)(t),c=new Map;for(let t of u(JSON.parse(new TextDecoder().decode(a)))){let n=(0,e.referenceIn)(o,t,s);n&&c.set(t,n)}await i.loadFromGLTFWithAssets(a,c)}},()=>i.load(o.file.model)),o};function F(n,r,i,a){let o=(0,t.useCallback)(async(t,o)=>{if(!n){console.warn(`Optimizer is not available`);return}try{t&&await t(o);let s=await n.getModel();if(!s){console.warn(`No optimized model available after optimization`);return}let c=s instanceof Uint8Array?s.slice():new Uint8Array(s).slice(),l=new File([c],i?.name||`optimized_model.glb`,{type:`model/gltf-binary`}),u=await a.loadToThreeJS(l);r({model:u.scene,animations:u.animations,type:e.ModelFileTypes.glb,name:l.name})}catch(e){console.error(`Optimization failed:`,e)}},[n,a,i,r]);return n?{...n,isPreparing:!!i?.model&&!n.isReady,applyOptimization:o}:null}var I=({sceneId:e,serverOptions:t})=>({endpoint:t?.endpoint??`/api/scenes/${e}`,headers:t?.apiKey?{Authorization:`Bearer ${t.apiKey}`,...t.headers}:{...t?.headers}}),L=`__vctrl_published_model__`,R=async(t,n,i,{modelLoader:o,publish:s,onProgress:c},l)=>{let u=await O({...n.assetRefs??{},[L]:i},{headers:l,onProgress:e=>c(Math.round(e*60))}),d=u[L];if(delete u[L],!d)throw a({code:`missing_assets`,message:`This scene has no published model to load.`,recoverable:!1,source:`server-load`,context:{sceneId:t}});let f=D({...n,assetData:u});c(70);let p=(0,r.toSerializedAssetBytes)(d),m=new Uint8Array(p.byteLength);m.set(p);let h=new Blob([m],{type:i.mimeType}),g=await o.loadToThreeJS(new File([h],i.fileName,{type:i.mimeType})),_={file:{model:g.scene,animations:g.animations,type:e.ModelFileTypes.glb,name:f.meta?.name||i.fileName,sourcePackageBytes:i.byteSize??void 0},sceneId:t,sceneData:f};return s(_),_},z=async(t,n,i)=>{let{sceneId:o,sceneData:s,parseMode:c}=t,{modelLoader:u,optimizer:d,publish:f,onProgress:p}=n;if(s.publishedModel)return R(o,s,s.publishedModel,n,i);if(!s.gltfJson)throw a({code:`missing_assets`,message:`This scene has no model data to load.`,recoverable:!1,source:`server-load`,context:{sceneId:o}});let m=E(s.assetRefs&&!s.assetData?{...s,assetData:await O(s.assetRefs,{headers:i,onProgress:e=>p(Math.round(e*40))})}:s);p(40);let{sourcePackageBytes:g,textureBytes:_}=b(m);if(c===`direct`&&m.gltfJson){let t=new Map;for(let e of Object.values(m.assetData??{}))e.fileName!==r.PERSISTED_BAKE_FILENAME&&t.set(e.fileName,(0,r.toSerializedAssetBytes)(e));p(60);let n=await u.parseGLTFJsonToThreeJS(m.gltfJson,t),i={file:{model:n.scene,animations:n.animations,type:e.ModelFileTypes.gltf,name:m.meta?.name||`scene`,sourcePackageBytes:g,sourceTextureBytes:_},sceneId:o,sceneData:m};return f(i),i}let v=h(m);p(60);let y=v[0],x=v.slice(1),S=await u.loadGLTFWithAssetsToThreeJS(y,x),C={file:{model:S.scene,animations:S.animations,type:e.ModelFileTypes.gltf,name:y.name,sourcePackageBytes:g,sourceTextureBytes:_},sceneId:o,sceneData:m};return f(C),d&&await l(()=>d.loadFromServerSceneData(m)),C},B=async(e,t)=>{let{sceneId:n,parseMode:r}=e,{onProgress:i}=t,{endpoint:a,headers:o}=I(e);try{return i(0),await z({kind:`scene-data`,sceneId:n,sceneData:await H(a,o)??await U(a,o,n),parseMode:r},t,o)}catch(e){throw c(e,n)}},V=new Set([401,403,404]);async function H(e,t){try{let n=await fetch(e,{method:`GET`,headers:{Accept:`application/json`,...t}});if(V.has(n.status))throw a({code:n.status===404?`not_found`:`server_load_failed`,message:`Server responded with ${n.status} ${n.statusText}`,recoverable:!1,source:`server-load`,context:{endpoint:e,status:n.status}});if(!n.ok)return null;let r=await n.json(),i=r.data??r;return!i||typeof i!=`object`?null:i.publishedModel?i:!i.gltfJson||!i.assetRefs&&!i.assetData?null:i}catch(e){if(i(e))throw e;return null}}async function U(e,t,n){let r=new FormData;r.append(`action`,`get-scene-settings`),r.append(`sceneId`,n);let i=await fetch(e,{method:`POST`,headers:t,body:r});if(!i.ok)throw Error(`Server responded with ${i.status} ${i.statusText}`);let a=await i.json();return a.data??a}var W=[...n.IMPORTABLE_FORMAT_IDS],G={status:`empty`,file:null,error:null,source:null,progress:0},K=(e,t=0)=>({status:`loading`,file:null,error:null,source:e,progress:t}),q=(e,t)=>({status:`ready`,file:t.file,error:null,source:e,progress:100,sceneId:t.sceneId,sceneData:t.sceneData}),J=(e,t)=>({status:`error`,file:null,error:t,source:e,progress:0});function Y(n){let[r,i]=(0,t.useState)(G),a=(0,t.useRef)(n);a.current=n;let o=(0,t.useRef)(0),l=(0,t.useMemo)(()=>{let t=new e.ModelLoader;return t.onProgress(e=>{i(t=>t.status===`loading`?{...t,progress:e.progress}:t)}),t},[]),u=(0,t.useRef)(r);u.current=r;let d=(0,t.useRef)(null);r.status===`ready`&&(d.current=r);let f=(0,t.useCallback)(async(e,t)=>{let n=++o.current,r=()=>o.current===n,u=e=>({...e,stillCurrent:r}),f=e.kind===`files`?d.current:null,p=e=>(r()&&(e.status===`ready`&&(d.current=e),i(e)),e),m=null,h={modelLoader:l,optimizer:a.current,publish:n=>{m=p(q(e.kind,n)),r()&&t?.onPublish?.(u(m))},onProgress:e=>{r()&&i(t=>t.status===`loading`?{...t,progress:e}:t)}};p(K(e.kind));try{let t=e.kind===`files`?await M(e.files,h):e.kind===`scene-data`?await z(e,h):await B(e,h);return u(m??p(q(e.kind,t)))}catch(t){let n=e.kind===`files`?s(t,`unknown`):c(t,e.sceneId??``);return console.error(`Model load failed (${e.kind}):`,n),p(f??J(e.kind,n)),u(J(e.kind,n))}},[l]),p=(0,t.useCallback)(()=>{o.current+=1,d.current=null,i(G)},[]),m=F(n,(0,t.useCallback)(e=>{i(t=>t.status===`ready`?{...t,file:e}:t)},[]),r.file,l);return{...r,supportedFileTypes:W,load:f,reset:p,optimizer:m}}Object.defineProperty(exports,"n",{enumerable:!0,get:function(){return O}}),Object.defineProperty(exports,"r",{enumerable:!0,get:function(){return h}}),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return Y}});

package/use-load-model.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./rolldown-runtime-BocRIvOZ.cjs"),t=require("./use-load-model-CZCi6bPM.cjs");let n=require("react");n=e.t(n,1);let r=require("react/jsx-runtime");var i=(0,n.createContext)(void 0),a=(0,n.createContext)(void 0),o=({children:e,optimizer:n})=>{let o=t.t(n);return n?(0,r.jsx)(i.Provider,{value:o,children:e}):(0,r.jsx)(a.Provider,{value:o,children:e})};function s(e){let t=(0,n.useContext)(i),r=(0,n.useContext)(a),o=t??r;if(!o)throw Error(`useModelContext must be used within a ModelProvider`);return o}exports.ModelProvider=o,exports.fetchManifestAssetData=t.n,exports.reconstructGltfFiles=t.r,exports.useLoadModel=t.t,exports.useModelContext=s;

package/use-load-model.es.js

@@ -1,4 +1,4 @@
-import { n as e, r as t, t as n } from "./use-load-model-C88r8-HE.js";
+import { n as e, r as t, t as n } from "./use-load-model-CRDVzrPC.js";
 import { createContext as r, useContext as i } from "react";
 import { jsx as a } from "react/jsx-runtime";
 //#region packages/hooks/src/use-load-model/model-context.tsx

package/use-optimize-model/index.d.ts

@@ -1,2 +1,3 @@
 export { default as useOptimizeModel } from './use-optimize-model';
+export { createBrowserTextureEncoder } from './utils';
 export * from './types';

package/use-optimize-model/types.d.ts

@@ -13,10 +13,12 @@ export interface OptimizationInfo {
 }
 /**
  * Interface representing the state of the model optimizer.
+ *
+ * `OptimizationInfo` is not part of it: it is derived from `report` on every
+ * render by `useCalcOptimizationInfo`, never stored.
  */
 export interface OptimizationState {
     report: OptimizationReport | null;
-    info: OptimizationInfo | null;
     error: Error | null;
     loading: boolean;
 }