@vctrl/hooks 0.17.0 → 0.22.0

package/use-load-model-BDCy9n2U.js

@@ -0,0 +1,504 @@
+import { ModelFileTypes as e, ModelLoader as t } from "@vctrl/core/model-loader";
+import { useCallback as n, useMemo as r, useReducer as i, useRef as a } from "react";
+import { PERSISTED_BAKE_FILENAME as o, buildAssetLookupKeys as s, getSerializedAssetByteSize as c, isValidBase64 as l, normalizeAssetUri as u, normalizeCameraSettings as d, normalizeSceneInteractions as f, toSerializedAssetBytes as p } from "@vctrl/core";
+//#region packages/hooks/src/use-load-model/error-helpers.ts
+var m = ({ code: e, message: t, recoverable: n, source: r, cause: i, context: a }) => ({
+	code: e,
+	message: t,
+	recoverable: n,
+	source: r,
+	cause: i,
+	context: a
+}), h = (e) => e instanceof Error && e.message ? e.message : typeof e == "string" && e.trim().length > 0 ? e : "Unknown error", g = (e, t, n) => {
+	let r = h(e);
+	return m({
+		code: r.includes("missing required referenced assets") ? "missing_assets" : t,
+		message: r,
+		recoverable: !0,
+		source: "local-upload",
+		cause: e,
+		context: n
+	});
+}, _ = (e, t) => {
+	let n = h(e), r = "server_load_failed";
+	return n.includes("Server responded with 404") ? r = "not_found" : (n.includes("Server responded with 402") || n.includes("Server responded with 403")) && (r = "quota_exceeded"), m({
+		code: r,
+		message: n,
+		recoverable: r !== "not_found",
+		source: "server-load",
+		cause: e,
+		context: { sceneId: t }
+	});
+}, v = {}, y = {
+	emit(e, t) {
+		let n = v[e];
+		console.debug(`Event emitted: ${e}`, t), n && n.forEach((e) => e(t));
+	},
+	on(e, t) {
+		v[e] || (v[e] = []), v[e].push(t);
+	},
+	off(e, t) {
+		let n = v[e];
+		n && (v[e] = n.filter((e) => e !== t));
+	}
+}, b = (e) => {
+	try {
+		return u(e);
+	} catch {
+		return e;
+	}
+}, x = (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;
+}, S = async (e, t) => {
+	let n = JSON.parse(await e.text()), r = x(n), i = {}, a = /* @__PURE__ */ new Map(), o = /* @__PURE__ */ new Map(), c = /* @__PURE__ */ new Set(), l = async (e) => {
+		let t = o.get(e);
+		if (t) return t;
+		let n = new Uint8Array(await e.arrayBuffer());
+		return o.set(e, n), n;
+	};
+	for (let e of t) {
+		for (let t of s(e.name)) a.set(t, e);
+		if (e.webkitRelativePath) for (let t of s(e.webkitRelativePath)) a.set(t, e);
+	}
+	let u = [];
+	for (let e of r) {
+		let t = b(e), n = t.split("/").pop() || t, r = a.get(e) || a.get(t) || a.get(n);
+		if (!r) {
+			u.push(e);
+			continue;
+		}
+		c.add(r);
+		let o = await l(r);
+		i[t] = {
+			data: Array.from(o),
+			fileName: t,
+			mimeType: r.type || "application/octet-stream"
+		};
+	}
+	if (u.length > 0) throw Error(`Scene payload is missing required referenced assets: ${u.slice(0, 5).join(", ")}`);
+	for (let [e, n] of t.entries()) {
+		if (c.has(n)) continue;
+		let t = b(n.name), r = t.split("/").pop() || t, a = await l(n);
+		i[`extra-${e}-${r}`] = {
+			data: Array.from(a),
+			fileName: r,
+			mimeType: n.type || "application/octet-stream"
+		};
+	}
+	return {
+		gltfJson: n,
+		assetData: i
+	};
+}, C = async (t, n, r, i, a) => {
+	try {
+		let o = {
+			model: (await r.loadToThreeJS(t)).scene,
+			type: n,
+			name: t.name
+		};
+		if (a({
+			type: "set-file",
+			payload: o
+		}), a({
+			type: "set-file-loading",
+			payload: !1
+		}), i && n !== e.usdz) {
+			let e = new Uint8Array(await t.arrayBuffer());
+			await i.loadFromGlbBuffer(e);
+		}
+		return o;
+	} catch (e) {
+		return console.error("Error loading binary model:", e), a({
+			type: "set-file-loading",
+			payload: !1
+		}), y.emit("load-error", g(e, "binary_load_failed", {
+			fileName: t.name,
+			fileType: n,
+			fileSize: t.size
+		})), null;
+	}
+}, w = async (t, n, r, i, a, o) => {
+	try {
+		let { sourcePackageBytes: s, textureBytes: c } = await o(t, n), l = await r.loadGLTFWithAssetsToThreeJS(t, n), u = {
+			model: l.scene,
+			type: e.gltf,
+			name: t.name,
+			sourcePackageBytes: s,
+			sourceTextureBytes: c
+		};
+		if (a({
+			type: "set-file",
+			payload: u
+		}), a({
+			type: "set-file-loading",
+			payload: !1
+		}), i) try {
+			let e = await S(t, n);
+			await i.loadFromServerSceneData(e);
+		} catch (e) {
+			console.warn("Failed to initialize optimizer from source GLTF payload; trying direct asset load.", e);
+			try {
+				if ("loadFromGLTFWithAssets" in i) {
+					let e = new Uint8Array(await t.arrayBuffer()), r = /* @__PURE__ */ new Map();
+					for (let e of n) {
+						let t = new Uint8Array(await e.arrayBuffer());
+						r.set(e.name, t), e.webkitRelativePath && r.set(e.webkitRelativePath, t);
+					}
+					await i.loadFromGLTFWithAssets(e, r);
+				} else throw Error("loadFromGLTFWithAssets not available");
+			} catch (e) {
+				console.warn("Direct asset load also failed; falling back to Three.js scene import. Texture names may be generic.", e), await i.load(l.scene);
+			}
+		}
+		return u;
+	} catch (e) {
+		return console.error("Error loading GLTF model:", e), console.error("GLTF file:", t.name), console.error("Asset files:", n.map((e) => e.name)), a({
+			type: "set-file-loading",
+			payload: !1
+		}), y.emit("load-error", g(e, "gltf_load_failed", {
+			fileName: t.name,
+			fileSize: t.size,
+			assetCount: n.length
+		})), null;
+	}
+};
+//#endregion
+//#region packages/hooks/src/use-load-model/optimizer-integration.ts
+function T(t, r, i, a) {
+	let o = n(async (n, o) => {
+		if (!t) {
+			console.warn("Optimizer is not available");
+			return;
+		}
+		try {
+			n && await n(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], i?.name || "optimized_model.glb", { type: "model/gltf-binary" });
+			r({
+				type: "set-file",
+				payload: {
+					model: (await a.loadToThreeJS(l)).scene,
+					type: e.glb,
+					name: l.name
+				}
+			});
+		} catch (e) {
+			console.error("Optimization failed:", e);
+		}
+	}, [
+		t,
+		a,
+		i,
+		r
+	]);
+	if (!t) return null;
+	let s = t.isReady, c = !!i?.model && !s;
+	return {
+		...t,
+		isReady: s,
+		isPreparing: c,
+		applyOptimization: o,
+		reset: t?.reset,
+		error: t?.error,
+		loading: t?.loading
+	};
+}
+//#endregion
+//#region packages/hooks/src/use-load-model/state.ts
+var E = {
+	file: null,
+	isFileLoading: !1,
+	progress: 0,
+	supportedFileTypes: [
+		e.gltf,
+		e.glb,
+		e.usdz
+	]
+};
+function D(e, t) {
+	switch (t.type) {
+		case "set-file": return {
+			...e,
+			file: t.payload
+		};
+		case "set-file-loading": return {
+			...e,
+			isFileLoading: t.payload
+		};
+		case "set-progress": return {
+			...e,
+			progress: t.payload
+		};
+		case "reset-state": return { ...E };
+		default: return e;
+	}
+}
+//#endregion
+//#region packages/hooks/src/use-load-model/utils/read-directory.ts
+async function O(e) {
+	let t = [];
+	async function* n(e) {
+		let t = e;
+		for await (let [, e] of t) e.kind === "file" ? yield await e.getFile() : e.kind === "directory" && (yield* n(e));
+	}
+	for await (let r of n(e)) t.push(r);
+	return t;
+}
+//#endregion
+//#region packages/hooks/src/use-load-model/utils/reconstruct-files.ts
+function k(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 === o) continue;
+		let i = p(n), a = new Uint8Array(i.byteLength);
+		a.set(i);
+		let s = new Blob([a], { type: r }), c = new File([s], e, { type: r });
+		t.push(c);
+	}
+	let n = JSON.stringify(e.gltfJson), r = new Blob([n], { type: "model/gltf+json" }), i = e.meta?.name, a = i ? `${i}.gltf` : "scene.gltf";
+	return [new File([r], a, { type: "model/gltf+json" }), ...t];
+}
+//#endregion
+//#region packages/hooks/src/use-load-model/utils/calculate-referenced-bytes.ts
+var A = (e, t) => {
+	let n = u(e), r = n.split("/").pop() || n;
+	for (let e of t) {
+		let t = s(e.fileName);
+		if (t.has(n) || t.has(r)) return e.size;
+	}
+	return 0;
+}, j = (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 M(e, t) {
+	let n = await e.text(), r;
+	try {
+		r = JSON.parse(n);
+	} catch {
+		return {
+			sourcePackageBytes: e.size,
+			textureBytes: 0
+		};
+	}
+	let i = t.map((e) => ({
+		fileName: e.name,
+		size: e.size
+	})), { bufferUris: a, imageUris: o } = j(r), s = Array.from(a).reduce((e, t) => e + A(t, i), 0), c = Array.from(o).reduce((e, t) => e + A(t, i), 0);
+	return {
+		sourcePackageBytes: e.size + s + c,
+		textureBytes: c
+	};
+}
+function N(e) {
+	let t = e.gltfJson, n = Object.values(e.assetData || {}).map((e) => ({
+		fileName: e.fileName,
+		size: c(e.data)
+	})), r = new TextEncoder().encode(JSON.stringify(t)).byteLength, { bufferUris: i, imageUris: a } = j(t), o = Array.from(i).reduce((e, t) => e + A(t, n), 0), s = Array.from(a).reduce((e, t) => e + A(t, n), 0);
+	return {
+		sourcePackageBytes: r + o + s,
+		textureBytes: s
+	};
+}
+//#endregion
+//#region packages/hooks/src/use-load-model/utils/resolve-scene-payload.ts
+function P(e) {
+	return typeof e == "object" && !!e && !Array.isArray(e);
+}
+function F(e) {
+	let t = P(e.settings) ? e.settings : {}, n = d(e.camera ?? t.camera);
+	return {
+		...t,
+		bounds: e.bounds ?? t.bounds,
+		camera: n,
+		interactions: f(t.interactions, { camera: n }),
+		controls: e.controls ?? t.controls,
+		environment: e.environment ?? t.environment,
+		shadows: e.shadows ?? t.shadows
+	};
+}
+function I(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 L(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" && !l(n.data)) throw Error(`Scene payload asset ${n.fileName} has invalid base64 data`);
+	}
+}
+function R(e, t) {
+	let n = I(e);
+	if (n.size === 0) return;
+	let r = /* @__PURE__ */ new Set();
+	for (let e of Object.values(t)) for (let t of s(e.fileName)) r.add(t);
+	let i = [];
+	for (let e of n) {
+		let t = u(e), n = t.split("/").pop() || t;
+		!r.has(e) && !r.has(t) && !r.has(n) && i.push(e);
+	}
+	if (i.length > 0) throw Error(`Scene payload is missing required referenced assets: ${i.slice(0, 5).join(", ")}`);
+}
+function z(e) {
+	if (!P(e.gltfJson)) throw Error("Scene payload is missing a valid glTF document");
+	let t = e.assetData ?? {};
+	return L(t), R(e.gltfJson, t), {
+		meta: e.meta,
+		gltfJson: e.gltfJson,
+		assetData: t,
+		...F(e)
+	};
+}
+//#endregion
+//#region packages/hooks/src/use-load-model/use-load-model.ts
+function B(o) {
+	let s = a(!1), c = a(null), [l, u] = i(D, E), d = r(() => {
+		let e = new t();
+		return e.onProgress((e) => {
+			u({
+				type: "set-progress",
+				payload: e.progress
+			}), e.progress !== 100 && y.emit("load-progress", e.progress);
+		}), e;
+	}, []), f = n((e) => {
+		u({
+			type: "set-progress",
+			payload: e
+		}), y.emit("load-progress", e);
+	}, []), p = n(() => {
+		u({ type: "reset-state" }), y.emit("load-reset");
+	}, []), m = n((e, t) => e.find((e) => e.name.endsWith("." + t)), []), h = n(async (t) => {
+		if (t.length === 0) return;
+		let n = m(t, e.gltf), r = m(t, e.glb), i = m(t, e.usdz), a = [
+			n,
+			r,
+			i
+		].filter(Boolean);
+		if (a.length > 1) {
+			y.emit("multiple-models", a);
+			return;
+		}
+		let l = t.filter((e) => e !== n && e !== r && e !== i), f = () => {
+			s.current = !0, c.current && (y.emit("load-complete", c.current), s.current = !1);
+		};
+		if (n) {
+			let e = await w(n, l, d, o, u, M);
+			e && (c.current = e), f();
+		} else if (r) {
+			let t = await C(r, e.glb, d, o, u);
+			t && (c.current = t), f();
+		} else if (i) {
+			let t = await C(i, e.usdz, d, o, u);
+			t && (c.current = t), f();
+		} else y.emit("not-loaded-files", t), u({
+			type: "set-file-loading",
+			payload: !1
+		});
+	}, [
+		m,
+		d,
+		o
+	]), g = n(async (e) => {
+		let t = [];
+		y.emit("load-start"), u({ type: "reset-state" }), u({
+			type: "set-file-loading",
+			payload: !0
+		}), f(0), s.current = !1;
+		for (let n of e) if (n instanceof File) t.push(n);
+		else if ("kind" in n && n.kind === "directory") {
+			let e = await O(n);
+			t.push(...e);
+		}
+		await h(t);
+	}, [h, f]), v = n(async (t) => {
+		let { sceneData: n, sceneId: r } = t;
+		f(40);
+		let i = k(n), { sourcePackageBytes: a, textureBytes: s } = N(n);
+		f(60);
+		let l = i[0], p = i.slice(1), m = {
+			model: (await d.loadGLTFWithAssetsToThreeJS(l, p)).scene,
+			type: e.gltf,
+			name: l.name,
+			sourcePackageBytes: a,
+			sourceTextureBytes: s
+		};
+		return u({
+			type: "set-file",
+			payload: m
+		}), u({
+			type: "set-file-loading",
+			payload: !1
+		}), c.current = m, o && await o.loadFromServerSceneData(n), f(100), {
+			file: m,
+			sceneId: r,
+			...n
+		};
+	}, [
+		d,
+		o,
+		f
+	]), b = n(async (e) => {
+		let { sceneId: t, serverOptions: n } = e;
+		try {
+			y.emit("server-load-start", t), u({ type: "reset-state" }), u({
+				type: "set-file-loading",
+				payload: !0
+			}), f(0);
+			let e = new FormData();
+			e.append("action", "get-scene-settings"), e.append("sceneId", t);
+			let r = n?.endpoint ?? `/api/scenes/${t}`, i = n?.apiKey ? {
+				Authorization: `Bearer ${n.apiKey}`,
+				...n.headers
+			} : { ...n?.headers }, a = await fetch(r, {
+				method: "POST",
+				headers: i,
+				body: e
+			});
+			if (!a.ok) throw Error(`Server responded with ${a.status} ${a.statusText}`);
+			let o = await a.json(), s = await v({
+				sceneId: t,
+				sceneData: z(o.data ?? o)
+			});
+			return y.emit("server-load-complete", s), s;
+		} catch (e) {
+			console.error("Server scene loading failed:", e), u({
+				type: "set-file-loading",
+				payload: !1
+			});
+			let n = _(e, t);
+			throw y.emit("server-load-error", n), n;
+		}
+	}, [v, f]), x = T(o, u, l.file, d);
+	return {
+		...l,
+		on: y.on,
+		off: y.off,
+		load: g,
+		loadFromData: v,
+		loadFromServer: b,
+		reset: p,
+		optimizer: x
+	};
+}
+//#endregion
+export { k as n, B as t };

package/use-load-model.cjs.js

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./chunk-gGpyby2o.cjs`),t=require(`./use-load-model-CH-WPQ_s.cjs`);let n=require(`react`);n=e.a(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.reconstructGltfFiles=t.n,exports.useLoadModel=t.t,exports.useModelContext=s;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./chunk-CMqjfN_6.cjs"),t=require("./use-load-model-B9M4cF4B.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.reconstructGltfFiles=t.n,exports.useLoadModel=t.t,exports.useModelContext=s;

package/use-load-model.es.js

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

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

@@ -13,22 +13,22 @@ import { ServerSceneData } from '../../../core/src/index.ts';
  * - Geometry deduplication to remove redundant data
  * - Vertex attribute quantization to reduce file size
  * - Normal vector optimization
- * - Texture compression (server-side only)
+ * - Texture compression (browser-native via OffscreenCanvas)
  * - Progress tracking and error handling
  * - Optimization reports with before/after metrics
  *
  * @example
  * const optimizer = useOptimizeModel()
  *
- * // Load a model
- * await optimizer.load(threeJsScene)
+ * // Load a GLB into the optimizer
+ * await optimizer.loadFromGlbBuffer(glbBytes)
  *
- * // Apply optimizations
- * await optimizer.simplifyOptimization({ ratio: 0.5 })
- * await optimizer.quantizeOptimization({ bits: 12 })
+ * // Geometry optimizations run via Web Worker (use-optimization-process.ts)
+ * // Texture compression runs browser-native via texturesOptimization()
+ * await optimizer.texturesOptimization({ targetFormat: 'webp', quality: 0.8 })
  *
- * // Get optimized model
- * const optimizedBinary = await optimizer.getModel()
+ * // Sync result back to the Three.js viewer
+ * await optimizer.applyOptimization()
  *
  * @returns Object containing optimization methods, state, and report data
  */
@@ -42,6 +42,8 @@ declare const useOptimizeModel: () => {
      */
     load: (model: Object3D) => Promise<void>;
     loadFromServerSceneData: (sceneData: ServerSceneData) => Promise<void>;
+    loadFromGlbBuffer: (buffer: Uint8Array) => Promise<void>;
+    loadFromGLTFWithAssets: (gltfBytes: Uint8Array, assets: Map<string, Uint8Array>) => Promise<void>;
     /**
      * Retrieves the current model as a binary Uint8Array in glTF (.glb) format.
      *
@@ -107,12 +109,12 @@ declare const useOptimizeModel: () => {
      */
     normalsOptimization: (options?: NormalsOptions) => Promise<void>;
     /**
-     * Compresses textures using advanced formats (requires server-side processing).
-     * Note: Only works in Node.js environments with Sharp library available.
+     * Compresses textures using browser-native OffscreenCanvas encoding.
+     * No server call is made. Works in any modern browser context.
      *
-     * @param options - Texture compression options (format, quality)
+     * @param options - Texture compression options (targetFormat, quality, resize)
      * @returns Promise that resolves when compression is complete
-     * @throws Error if Sharp is not available
+     * @throws Error if OffscreenCanvas is unavailable or encoding fails
      */
     texturesOptimization: (options?: TextureCompressOptions) => Promise<void>;
 };

package/use-optimize-model/utils/browser-texture-encoder.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Creates a sharp-constructor-compatible browser encoder.
+ *
+ * The returned function matches the sharp API surface that gltf-transform uses:
+ * `encoder(buffer)` → instance with `.resize()`, `.webp/jpeg/png()`,
+ * `.toBuffer()`, and `.metadata()`.
+ *
+ * Pass the result directly to `TextureCompressOptions.encoder`:
+ * ```ts
+ * await optimizer.compressTextures({
+ *   encoder: createBrowserTextureEncoder(),
+ *   targetFormat: 'webp',
+ *   quality: 80,
+ * })
+ * ```
+ */
+export declare function createBrowserTextureEncoder(): (inputBuffer: Uint8Array | ArrayBuffer) => {
+    resize(w?: number, h?: number, _opts?: unknown): /*elided*/ any;
+    webp(opts?: {
+        quality?: number;
+    }): /*elided*/ any;
+    jpeg(opts?: {
+        quality?: number;
+    }): /*elided*/ any;
+    png(_opts?: unknown): /*elided*/ any;
+    /**
+     * sharp-compatible `.toFormat(format, opts)` — gltf-transform calls this
+     * instead of `.webp()` / `.jpeg()` / `.png()` directly.
+     */
+    toFormat(format: string, opts?: {
+        quality?: number;
+        lossless?: boolean;
+        nearLossless?: boolean;
+    }): /*elided*/ any;
+    toBuffer(): Promise<Uint8Array>;
+    metadata(): Promise<{
+        width: number;
+        height: number;
+        format: string;
+    }>;
+};

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

@@ -1,2 +1,2 @@
-export { optimizeTextures, performClientSideTextureOptimization, performServerSideTextureOptimization, shouldUseServerOptimization } from './texture-optimization';
-export { validateResponseContentType, validateServerResponse } from './validation';
+export { optimizeTextures } from './texture-optimization';
+export { createBrowserTextureEncoder } from './browser-texture-encoder';

package/use-optimize-model/utils/texture-optimization.d.ts

@@ -1,17 +1,7 @@
 import { ModelOptimizer, TextureCompressOptions } from '../../../../core/src/model-optimizer/index.ts';
 /**
- * Performs server-side texture optimization.
- */
-export declare const performServerSideTextureOptimization: (optimizer: ModelOptimizer, options: TextureCompressOptions) => Promise<void>;
-/**
- * Handles client-side texture optimization (throws error as not supported in browser).
- */
-export declare const performClientSideTextureOptimization: () => never;
-/**
- * Determines if server-side optimization should be used.
- */
-export declare const shouldUseServerOptimization: (options?: TextureCompressOptions) => boolean;
-/**
- * Main texture optimization function that orchestrates the process.
+ * Performs client-side texture compression using the browser-native encoder.
+ * Delegates directly to optimizer.compressTextures() with the OffscreenCanvas
+ * encoder injected — no network round-trip required.
  */
 export declare const optimizeTextures: (optimizer: ModelOptimizer, options?: TextureCompressOptions) => Promise<void>;

package/use-optimize-model-CPGezwrM.cjs

@@ -0,0 +1 @@
+let e=require("react"),t=require("@vctrl/core"),n=require("@vctrl/core/model-optimizer");var r={info:null,error:null,loading:!1,report:null},i=(e,t)=>{switch(t.type){case`LOAD_START`:return{...e,loading:!0,error:null};case`LOAD_SUCCESS`:return{...e,loading:!1,report:t.payload.report};case`LOAD_ERROR`:return{...e,loading:!1,error:t.payload};case`RESET`:return{...r};default:return e}};function a(e){return e?{verticesCount:e.stats.vertices.after??0,primitivesCount:e.stats.triangles.after??0,meshesCount:e.stats.meshes.after??0,textureAssetCount:e.stats.texturesCount.after??0,materialsCount:e.stats.materials.after??0,sceneBytes:e.optimizedSize??0}:{verticesCount:0,primitivesCount:0,meshesCount:0,textureAssetCount:0,materialsCount:0,sceneBytes:0}}var o=t=>{let[n,r]=(0,e.useState)(null),i=t.report;return(0,e.useEffect)(()=>{!n&&i&&r(i)},[n,i]),{info:(0,e.useMemo)(()=>{let e=a(n),t=a(i);return{initial:{verticesCount:e.verticesCount,primitivesCount:e.primitivesCount,meshesCount:e.meshesCount,texturesCount:e.textureAssetCount,sceneBytes:e.sceneBytes},optimized:{verticesCount:t.verticesCount,primitivesCount:t.primitivesCount,meshesCount:t.meshesCount,texturesCount:t.textureAssetCount,sceneBytes:t.sceneBytes},improvement:{verticesCount:e.verticesCount-t.verticesCount,primitivesCount:e.primitivesCount-t.primitivesCount,meshesCount:e.meshesCount-t.meshesCount,texturesCount:e.textureAssetCount-t.textureAssetCount,sceneBytes:e.sceneBytes-t.sceneBytes}}},[i,n]),reset:(0,e.useCallback)(()=>{r(null)},[])}};async function s(e,t){let n=new Blob([e]),r=await createImageBitmap(n),{width:i,height:a}=r;if(t.maxWidth||t.maxHeight){let e=t.maxWidth?t.maxWidth/i:1/0,n=t.maxHeight?t.maxHeight/a:1/0,r=Math.min(e,n,1);r<1&&(i=Math.round(i*r),a=Math.round(a*r))}let o=new OffscreenCanvas(i,a),s=o.getContext(`2d`);if(!s)throw r.close(),Error(`OffscreenCanvas 2D context unavailable`);s.drawImage(r,0,0,i,a),r.close();let c=t.format===`webp`?`image/webp`:t.format===`jpeg`?`image/jpeg`:`image/png`,l=await o.convertToBlob({type:c,quality:t.quality/100});return new Uint8Array(await l.arrayBuffer())}function c(){return function(e){let t=e instanceof Uint8Array?e:new Uint8Array(e),n=`webp`,r=80,i,a,o={resize(e,t,n){return i=e,a=t,o},webp(e){return n=`webp`,typeof e?.quality==`number`&&(r=e.quality),o},jpeg(e){return n=`jpeg`,typeof e?.quality==`number`&&(r=e.quality),o},png(e){return n=`png`,o},toFormat(e,t){return(e===`webp`||e===`jpeg`||e===`png`)&&(n=e),typeof t?.quality==`number`&&(r=t.quality),o},async toBuffer(){return s(t,{format:n,quality:r,maxWidth:i,maxHeight:a})},async metadata(){let e=new Blob([t]),n=await createImageBitmap(e),r={width:n.width,height:n.height,format:`unknown`};return n.close(),r}};return o}}var l=async(e,t)=>{e.hasModel()&&await e.compressTextures({...t,encoder:c()})},u=()=>{let[a,s]=(0,e.useReducer)(i,r),{report:c,error:u,loading:d}=a,{info:f,reset:p}=o(a),m=(0,e.useRef)(new n.ModelOptimizer);(0,e.useEffect)(()=>{let e=m.current;return()=>{e.reset()}},[]);let h=(0,e.useCallback)(async e=>{s({type:`LOAD_START`});try{let t=m.current;await t.loadFromThreeJS(e),s({type:`LOAD_SUCCESS`,payload:{report:await t.getReport()}})}catch(e){s({type:`LOAD_ERROR`,payload:e}),console.error(`Error loading model:`,e)}},[]),g=(0,e.useCallback)(async e=>{s({type:`LOAD_START`});try{let n=m.current,r=new Map;for(let n of Object.values(e.assetData??{}))for(let e of(0,t.buildAssetLookupKeys)(n.fileName))r.set(e,n);let i={},a=e.gltfJson,o=[...(a.images??[]).map(e=>e.uri).filter(e=>!!e&&!e.startsWith(`data:`)),...(a.buffers??[]).map(e=>e.uri).filter(e=>!!e&&!e.startsWith(`data:`))];for(let e of o){let n=(0,t.normalizeAssetUri)(e),a=n.split(`/`).pop()||n,o=r.get(e)??r.get(n)??r.get(a);o&&(i[e]=(0,t.toSerializedAssetBytes)(o))}let c={json:e.gltfJson,resources:i};await n.loadFromJSON(c),s({type:`LOAD_SUCCESS`,payload:{report:await n.getReport()}})}catch(e){throw s({type:`LOAD_ERROR`,payload:e}),console.error(`Error loading server scene into optimizer:`,e),e}},[]),_=(0,e.useCallback)(async e=>{s({type:`LOAD_START`});try{await m.current.loadFromBuffer(e),s({type:`LOAD_SUCCESS`,payload:{report:await m.current.getReport()}})}catch(e){throw s({type:`LOAD_ERROR`,payload:e}),console.error(`Error loading GLB buffer into optimizer:`,e),e}},[]),v=(0,e.useCallback)(async(e,t)=>{s({type:`LOAD_START`});try{await m.current.loadFromGLTFWithAssets(e,t),s({type:`LOAD_SUCCESS`,payload:{report:await m.current.getReport()}})}catch(e){throw s({type:`LOAD_ERROR`,payload:e}),console.error(`Error loading GLTF with assets into optimizer:`,e),e}},[]),y=(0,e.useCallback)(async e=>{if(m.current.hasModel())try{await m.current.simplify(e),s({type:`LOAD_SUCCESS`,payload:{report:await m.current.getReport()}})}catch(e){console.error(`Simplification failed:`,e)}},[]),b=(0,e.useCallback)(async e=>{if(m.current.hasModel())try{await m.current.deduplicate(e),s({type:`LOAD_SUCCESS`,payload:{report:await m.current.getReport()}})}catch(e){console.error(`Deduplication failed:`,e)}},[]),x=(0,e.useCallback)(async e=>{if(m.current.hasModel())try{await m.current.quantize(e),s({type:`LOAD_SUCCESS`,payload:{report:await m.current.getReport()}})}catch(e){console.error(`Quantization failed:`,e)}},[]),S=(0,e.useCallback)(async e=>{if(m.current.hasModel())try{await m.current.optimizeNormals(e),s({type:`LOAD_SUCCESS`,payload:{report:await m.current.getReport()}})}catch(e){console.error(`Normals optimization failed:`,e)}},[]),C=(0,e.useCallback)(async e=>{try{await l(m.current,e),s({type:`LOAD_SUCCESS`,payload:{report:await m.current.getReport()}})}catch(e){throw console.error(`Texture optimization failed:`,e),e}},[]),w=(0,e.useCallback)(async()=>{if(!m.current.hasModel())return null;try{return await m.current.export()}catch(e){return console.error(`Error getting model binary:`,e),null}},[]),T=(0,e.useCallback)(()=>m.current.hasModel()?m.current.document:null,[]);return{load:h,loadFromServerSceneData:g,loadFromGlbBuffer:_,loadFromGLTFWithAssets:v,getModel:w,isReady:!!T()&&!d,_getDocument:T,reset:(0,e.useCallback)(()=>{m.current.reset(),s({type:`RESET`}),p()},[p]),error:u,loading:d,report:c,info:f,simplifyOptimization:y,dedupOptimization:b,quantizeOptimization:x,normalsOptimization:S,texturesOptimization:C}};Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return u}});