@vctrl/hooks 0.16.2 → 0.17.0

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

@@ -0,0 +1,119 @@
+import { DedupOptions, NormalsOptions, QuantizeOptions, SimplifyOptions, TextureCompressOptions } from '../../../core/src/model-optimizer/index.ts';
+import { Object3D } from 'three';
+import { ServerSceneData } from '../../../core/src/index.ts';
+/**
+ * Custom React hook for optimizing 3D models using the ModelOptimizer from @vctrl/core.
+ *
+ * This hook provides a React-friendly interface to advanced model optimization capabilities,
+ * including mesh simplification, deduplication, quantization, normal optimization, and texture compression.
+ * It manages the optimization state and provides callbacks for each optimization operation.
+ *
+ * **Features:**
+ * - Mesh simplification using MeshoptSimplifier
+ * - Geometry deduplication to remove redundant data
+ * - Vertex attribute quantization to reduce file size
+ * - Normal vector optimization
+ * - Texture compression (server-side only)
+ * - Progress tracking and error handling
+ * - Optimization reports with before/after metrics
+ *
+ * @example
+ * const optimizer = useOptimizeModel()
+ *
+ * // Load a model
+ * await optimizer.load(threeJsScene)
+ *
+ * // Apply optimizations
+ * await optimizer.simplifyOptimization({ ratio: 0.5 })
+ * await optimizer.quantizeOptimization({ bits: 12 })
+ *
+ * // Get optimized model
+ * const optimizedBinary = await optimizer.getModel()
+ *
+ * @returns Object containing optimization methods, state, and report data
+ */
+declare const useOptimizeModel: () => {
+    /**
+     * Loads a Three.js Object3D model into the optimizer.
+     * Converts the scene to glTF format and generates an initial optimization report.
+     *
+     * @param model - The Three.js Object3D model to load
+     * @returns Promise that resolves when the model is loaded
+     */
+    load: (model: Object3D) => Promise<void>;
+    loadFromServerSceneData: (sceneData: ServerSceneData) => Promise<void>;
+    /**
+     * Retrieves the current model as a binary Uint8Array in glTF (.glb) format.
+     *
+     * @returns Promise that resolves with the model binary or null if no model is loaded
+     */
+    getModel: () => Promise<Uint8Array | null>;
+    isReady: boolean;
+    /**
+     * Exposes the underlying ModelOptimizer document instance for advanced use cases.
+     */
+    _getDocument: () => import('@gltf-transform/core').Document | null;
+    /**
+     * Resets the optimizer, clearing all model data, reports, and state.
+     */
+    reset: () => void;
+    /**
+     * Error object if any optimization operation failed, otherwise null.
+     */
+    error: Error | null;
+    /**
+     * Boolean indicating if an optimization operation is currently in progress.
+     */
+    loading: boolean;
+    /**
+     * Detailed optimization report containing metrics about the model
+     * (vertex count, triangle count, file size, etc.) before and after optimizations.
+     */
+    report: import('../../../core/src/index.ts').OptimizationReport | null;
+    /**
+     * Calculated optimization information including file size reduction percentages
+     * and comparative metrics.
+     */
+    info: import('./types').OptimizationInfo;
+    /**
+     * Simplifies the model by reducing polygon count using MeshoptSimplifier.
+     * Maintains visual quality while improving performance.
+     *
+     * @param options - Simplification options (ratio, error threshold)
+     * @returns Promise that resolves when simplification is complete
+     */
+    simplifyOptimization: (options?: SimplifyOptions) => Promise<void>;
+    /**
+     * Removes duplicate vertices, primitives, and other redundant data.
+     * Reduces file size without affecting visual appearance.
+     *
+     * @param options - Deduplication options
+     * @returns Promise that resolves when deduplication is complete
+     */
+    dedupOptimization: (options?: DedupOptions) => Promise<void>;
+    /**
+     * Quantizes vertex attributes to use fewer bits per value.
+     * Reduces file size with minimal visual quality loss.
+     *
+     * @param options - Quantization options (bit depth)
+     * @returns Promise that resolves when quantization is complete
+     */
+    quantizeOptimization: (options?: QuantizeOptions) => Promise<void>;
+    /**
+     * Optimizes normal vectors by removing, generating, or cleaning up normal data.
+     *
+     * @param options - Normal optimization options
+     * @returns Promise that resolves when optimization is complete
+     */
+    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.
+     *
+     * @param options - Texture compression options (format, quality)
+     * @returns Promise that resolves when compression is complete
+     * @throws Error if Sharp is not available
+     */
+    texturesOptimization: (options?: TextureCompressOptions) => Promise<void>;
+};
+export default useOptimizeModel;

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

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

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

@@ -0,0 +1,17 @@
+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.
+ */
+export declare const optimizeTextures: (optimizer: ModelOptimizer, options?: TextureCompressOptions) => Promise<void>;

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

@@ -0,0 +1,8 @@
+/**
+ * Validates that the response contains the expected content type.
+ */
+export declare const validateResponseContentType: (response: Response) => void;
+/**
+ * Validates a server response and throws appropriate errors.
+ */
+export declare const validateServerResponse: (response: Response) => Promise<void>;

package/use-optimize-model-C-fzzKh6.cjs

@@ -0,0 +1 @@
+require(`./chunk-gGpyby2o.cjs`);const e=require(`./server-communication-yXZR8eso.cjs`);let t=require(`react`);var n={info:null,error:null,loading:!1,report:null},r=(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{...n};default:return e}};function i(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 a=e=>{let n=(0,t.useRef)(null),[r,a]=(0,t.useState)(!1),o=e.report;return(0,t.useEffect)(()=>{!r&&o&&(n.current=o,a(!0))},[r,o]),{info:(0,t.useMemo)(()=>{let e=i(n.current),t=i(o);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}}},[o]),reset:(0,t.useCallback)(()=>{n.current=null,a(!1)},[])}},o=e=>{let t=e.headers.get(`content-type`);if(!t)throw Error(`Missing content type from server response`);if(t.includes(`application/json`))throw Error(`Unexpected JSON success response from texture optimizer`);if(!t.startsWith(`image/`)&&!t.includes(`application/octet-stream`))throw Error(`Unexpected content type from server: ${t}`)},s=async e=>{if(e.ok){if(e.headers.get(`content-type`)?.includes(`application/json`)){let t=await e.json();throw Error(t.error||t.details||`Server returned error`)}o(e)}},c=2e4,l=2,u=50*1024*1024,d=4,f=new Set([408,425,429,500,502,503,504]),p=async e=>{await new Promise(t=>setTimeout(t,e))},m=e=>{let t=e.headers.get(`content-type`);return t&&t.split(`;`)[0]?.trim()||`application/octet-stream`},h=e=>{let t=e.headers.get(`X-Texture-File-Name`)||e.headers.get(`X-Texture-Name`);if(!t||t.trim().length===0)throw Error(`Optimized texture response is missing a canonical file name`);return t.trim()},g=async(e,t,n,r,i)=>{let a=0;for(;;){let o=new AbortController,s=setTimeout(()=>o.abort(),r);try{let r=await fetch(e,{method:`POST`,headers:t,body:n,signal:o.signal});if(!r.ok&&f.has(r.status)&&a<i){a+=1,await p(200*a+Math.floor(Math.random()*120));continue}return r}catch(e){if(a>=i)throw e;a+=1,await p(200*a+Math.floor(Math.random()*120))}finally{clearTimeout(s)}}},_=async(t,n,r,i)=>{let a=t.getTexturePayload(n.index),o=r.maxTextureUploadBytes??u;if(a.image.byteLength>o)throw Error(`Texture ${n.index} payload (${a.image.byteLength} bytes) exceeds maxTextureUploadBytes (${o} bytes). Increase maxTextureUploadBytes to allow optimizing larger source textures.`);let d=new Uint8Array(a.image.byteLength);d.set(a.image);let f=d.buffer,{serverOptions:p,..._}=r,v=e.t.createRequestHeaders(i,{"Content-Type":`application/octet-stream`,"X-Texture-Index":String(n.index),"X-Texture-Name":a.fileName,"X-Texture-File-Name":a.fileName,"X-Texture-Mime-Type":a.mimeType,"X-Optimize-Options":JSON.stringify(_)}),y=await g(i.endpoint,v,f,r.requestTimeoutMs??c,r.maxRetries??l);y.ok||await e.t.handleServerResponseError(y),await s(y);let b=Number.parseInt(y.headers.get(`X-Texture-Index`)||``,10);if(!Number.isFinite(b)||b!==n.index)throw Error(`Texture identity mismatch. Expected ${n.index}, received ${y.headers.get(`X-Texture-Index`)}`);let x=new Uint8Array(await y.arrayBuffer());if(x.byteLength===0)throw Error(`Empty optimized payload for texture ${n.index}`);let S=h(y);t.replaceTexturePayload(n.index,x,m(y),S)},v=async(t,n)=>{let r=e.t.createDefaultServerOptions(n.serverOptions),i=t.listTextureDescriptors(),a=[],o=0,s=n.maxConcurrentRequests??d;try{for(let e=0;e<i.length;e+=s){let c=i.slice(e,e+s),l=await Promise.allSettled(c.map(async e=>(await _(t,e,n,r),e.index)));for(let[e,t]of l.entries()){if(t.status===`fulfilled`){o+=1;continue}a.push({index:c[e].index,reason:t.reason instanceof Error?t.reason.message:String(t.reason)})}}if(o>0&&t.addAppliedOptimization(`texture compression`),a.length>0){let e=a.map(e=>`#${e.index}: ${e.reason}`).join(`; `),t=o===0?`Texture optimization failed for all textures.`:`Texture optimization failed for ${a.length} of ${i.length} textures.`;throw Error(`${t} ${e}`)}}catch(e){throw console.error(`Server-side texture compression failed:`,e),Error(`Server-side texture compression failed: ${e}. Client-side texture compression is not supported in browser environments.`,{cause:e})}},y=()=>{throw console.warn(`Client-side texture compression is not supported in browser environments. Please enable server-side compression by setting serverOptions.enabled = true.`),Error(`Texture compression requires server-side processing. Enable serverOptions.enabled = true in your options.`)},b=e=>e?.serverOptions?.enabled??!1,x=async(e,t)=>{e.hasModel()&&(b(t)&&t?await v(e,t):y())},S=()=>{let[i,o]=(0,t.useReducer)(r,n),{report:s,error:c,loading:l}=i,{info:u,reset:d}=a(i),f=(0,t.useRef)(new e.c);(0,t.useEffect)(()=>{let e=f.current;return()=>{e.reset()}},[]);let p=(0,t.useCallback)(async e=>{o({type:`LOAD_START`});try{let t=f.current;await t.loadFromThreeJS(e),o({type:`LOAD_SUCCESS`,payload:{report:await t.getReport()}})}catch(e){o({type:`LOAD_ERROR`,payload:e}),console.error(`Error loading model:`,e)}},[]),m=(0,t.useCallback)(async t=>{o({type:`LOAD_START`});try{let n=f.current,r={};for(let n of Object.values(t.assetData??{}))r[n.fileName]=e.o(n);let i={json:t.gltfJson,resources:r};await n.loadFromJSON(i),o({type:`LOAD_SUCCESS`,payload:{report:await n.getReport()}})}catch(e){throw o({type:`LOAD_ERROR`,payload:e}),console.error(`Error loading server scene into optimizer:`,e),e}},[]),h=(0,t.useCallback)(async e=>{if(f.current.hasModel())try{await f.current.simplify(e),o({type:`LOAD_SUCCESS`,payload:{report:await f.current.getReport()}})}catch(e){console.error(`Simplification failed:`,e)}},[]),g=(0,t.useCallback)(async e=>{if(f.current.hasModel())try{await f.current.deduplicate(e),o({type:`LOAD_SUCCESS`,payload:{report:await f.current.getReport()}})}catch(e){console.error(`Deduplication failed:`,e)}},[]),_=(0,t.useCallback)(async e=>{if(f.current.hasModel())try{await f.current.quantize(e),o({type:`LOAD_SUCCESS`,payload:{report:await f.current.getReport()}})}catch(e){console.error(`Quantization failed:`,e)}},[]),v=(0,t.useCallback)(async e=>{if(f.current.hasModel())try{await f.current.optimizeNormals(e),o({type:`LOAD_SUCCESS`,payload:{report:await f.current.getReport()}})}catch(e){console.error(`Normals optimization failed:`,e)}},[]),y=(0,t.useCallback)(async e=>{try{await x(f.current,e),o({type:`LOAD_SUCCESS`,payload:{report:await f.current.getReport()}})}catch(e){throw console.error(`Texture optimization failed:`,e),e}},[]),b=(0,t.useCallback)(async()=>{if(!f.current.hasModel())return null;try{return await f.current.export()}catch(e){return console.error(`Error getting model binary:`,e),null}},[]),S=(0,t.useCallback)(()=>f.current.hasModel()?f.current.document:null,[]);return{load:p,loadFromServerSceneData:m,getModel:b,isReady:!!S()&&!l,_getDocument:S,reset:(0,t.useCallback)(()=>{f.current.reset(),o({type:`RESET`}),d()},[d]),error:c,loading:l,report:s,info:u,simplifyOptimization:h,dedupOptimization:g,quantizeOptimization:_,normalsOptimization:v,texturesOptimization:y}};Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return S}});

package/use-optimize-model-Cb3WMvDZ.js

@@ -0,0 +1,299 @@
+import { c as e, o as t, t as n } from "./server-communication-Bj6ZxFw2.js";
+import { useCallback as r, useEffect as i, useMemo as a, useReducer as o, useRef as s, useState as c } from "react";
+//#region packages/hooks/src/use-optimize-model/state.ts
+var l = {
+	info: null,
+	error: null,
+	loading: !1,
+	report: null
+}, u = (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 { ...l };
+		default: return e;
+	}
+};
+//#endregion
+//#region packages/hooks/src/use-optimize-model/use-calc-optimization-info.ts
+function d(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 f = (e) => {
+	let t = s(null), [n, o] = c(!1), l = e.report;
+	return i(() => {
+		!n && l && (t.current = l, o(!0));
+	}, [n, l]), {
+		info: a(() => {
+			let e = d(t.current), n = d(l);
+			return {
+				initial: {
+					verticesCount: e.verticesCount,
+					primitivesCount: e.primitivesCount,
+					meshesCount: e.meshesCount,
+					texturesCount: e.textureAssetCount,
+					sceneBytes: e.sceneBytes
+				},
+				optimized: {
+					verticesCount: n.verticesCount,
+					primitivesCount: n.primitivesCount,
+					meshesCount: n.meshesCount,
+					texturesCount: n.textureAssetCount,
+					sceneBytes: n.sceneBytes
+				},
+				improvement: {
+					verticesCount: e.verticesCount - n.verticesCount,
+					primitivesCount: e.primitivesCount - n.primitivesCount,
+					meshesCount: e.meshesCount - n.meshesCount,
+					texturesCount: e.textureAssetCount - n.textureAssetCount,
+					sceneBytes: e.sceneBytes - n.sceneBytes
+				}
+			};
+		}, [l]),
+		reset: r(() => {
+			t.current = null, o(!1);
+		}, [])
+	};
+}, p = (e) => {
+	let t = e.headers.get("content-type");
+	if (!t) throw Error("Missing content type from server response");
+	if (t.includes("application/json")) throw Error("Unexpected JSON success response from texture optimizer");
+	if (!t.startsWith("image/") && !t.includes("application/octet-stream")) throw Error(`Unexpected content type from server: ${t}`);
+}, m = async (e) => {
+	if (e.ok) {
+		if (e.headers.get("content-type")?.includes("application/json")) {
+			let t = await e.json();
+			throw Error(t.error || t.details || "Server returned error");
+		}
+		p(e);
+	}
+}, h = 2e4, g = 2, _ = 50 * 1024 * 1024, v = 4, y = new Set([
+	408,
+	425,
+	429,
+	500,
+	502,
+	503,
+	504
+]), b = async (e) => {
+	await new Promise((t) => setTimeout(t, e));
+}, x = (e) => {
+	let t = e.headers.get("content-type");
+	return t && t.split(";")[0]?.trim() || "application/octet-stream";
+}, S = (e) => {
+	let t = e.headers.get("X-Texture-File-Name") || e.headers.get("X-Texture-Name");
+	if (!t || t.trim().length === 0) throw Error("Optimized texture response is missing a canonical file name");
+	return t.trim();
+}, C = async (e, t, n, r, i) => {
+	let a = 0;
+	for (;;) {
+		let o = new AbortController(), s = setTimeout(() => o.abort(), r);
+		try {
+			let r = await fetch(e, {
+				method: "POST",
+				headers: t,
+				body: n,
+				signal: o.signal
+			});
+			if (!r.ok && y.has(r.status) && a < i) {
+				a += 1, await b(200 * a + Math.floor(Math.random() * 120));
+				continue;
+			}
+			return r;
+		} catch (e) {
+			if (a >= i) throw e;
+			a += 1, await b(200 * a + Math.floor(Math.random() * 120));
+		} finally {
+			clearTimeout(s);
+		}
+	}
+}, w = async (e, t, r, i) => {
+	let a = e.getTexturePayload(t.index), o = r.maxTextureUploadBytes ?? _;
+	if (a.image.byteLength > o) throw Error(`Texture ${t.index} payload (${a.image.byteLength} bytes) exceeds maxTextureUploadBytes (${o} bytes). Increase maxTextureUploadBytes to allow optimizing larger source textures.`);
+	let s = new Uint8Array(a.image.byteLength);
+	s.set(a.image);
+	let c = s.buffer, { serverOptions: l, ...u } = r, d = n.createRequestHeaders(i, {
+		"Content-Type": "application/octet-stream",
+		"X-Texture-Index": String(t.index),
+		"X-Texture-Name": a.fileName,
+		"X-Texture-File-Name": a.fileName,
+		"X-Texture-Mime-Type": a.mimeType,
+		"X-Optimize-Options": JSON.stringify(u)
+	}), f = await C(i.endpoint, d, c, r.requestTimeoutMs ?? h, r.maxRetries ?? g);
+	f.ok || await n.handleServerResponseError(f), await m(f);
+	let p = Number.parseInt(f.headers.get("X-Texture-Index") || "", 10);
+	if (!Number.isFinite(p) || p !== t.index) throw Error(`Texture identity mismatch. Expected ${t.index}, received ${f.headers.get("X-Texture-Index")}`);
+	let v = new Uint8Array(await f.arrayBuffer());
+	if (v.byteLength === 0) throw Error(`Empty optimized payload for texture ${t.index}`);
+	let y = S(f);
+	e.replaceTexturePayload(t.index, v, x(f), y);
+}, T = async (e, t) => {
+	let r = n.createDefaultServerOptions(t.serverOptions), i = e.listTextureDescriptors(), a = [], o = 0, s = t.maxConcurrentRequests ?? v;
+	try {
+		for (let n = 0; n < i.length; n += s) {
+			let c = i.slice(n, n + s), l = await Promise.allSettled(c.map(async (n) => (await w(e, n, t, r), n.index)));
+			for (let [e, t] of l.entries()) {
+				if (t.status === "fulfilled") {
+					o += 1;
+					continue;
+				}
+				a.push({
+					index: c[e].index,
+					reason: t.reason instanceof Error ? t.reason.message : String(t.reason)
+				});
+			}
+		}
+		if (o > 0 && e.addAppliedOptimization("texture compression"), a.length > 0) {
+			let e = a.map((e) => `#${e.index}: ${e.reason}`).join("; "), t = o === 0 ? "Texture optimization failed for all textures." : `Texture optimization failed for ${a.length} of ${i.length} textures.`;
+			throw Error(`${t} ${e}`);
+		}
+	} catch (e) {
+		throw console.error("Server-side texture compression failed:", e), Error(`Server-side texture compression failed: ${e}. Client-side texture compression is not supported in browser environments.`, { cause: e });
+	}
+}, E = () => {
+	throw console.warn("Client-side texture compression is not supported in browser environments. Please enable server-side compression by setting serverOptions.enabled = true."), Error("Texture compression requires server-side processing. Enable serverOptions.enabled = true in your options.");
+}, D = (e) => e?.serverOptions?.enabled ?? !1, O = async (e, t) => {
+	e.hasModel() && (D(t) && t ? await T(e, t) : E());
+}, k = () => {
+	let [n, a] = o(u, l), { report: c, error: d, loading: p } = n, { info: m, reset: h } = f(n), g = s(new e());
+	i(() => {
+		let e = g.current;
+		return () => {
+			e.reset();
+		};
+	}, []);
+	let _ = r(async (e) => {
+		a({ type: "LOAD_START" });
+		try {
+			let t = g.current;
+			await t.loadFromThreeJS(e), a({
+				type: "LOAD_SUCCESS",
+				payload: { report: await t.getReport() }
+			});
+		} catch (e) {
+			a({
+				type: "LOAD_ERROR",
+				payload: e
+			}), console.error("Error loading model:", e);
+		}
+	}, []), v = r(async (e) => {
+		a({ type: "LOAD_START" });
+		try {
+			let n = g.current, r = {};
+			for (let n of Object.values(e.assetData ?? {})) r[n.fileName] = t(n);
+			let i = {
+				json: e.gltfJson,
+				resources: r
+			};
+			await n.loadFromJSON(i), a({
+				type: "LOAD_SUCCESS",
+				payload: { report: await n.getReport() }
+			});
+		} catch (e) {
+			throw a({
+				type: "LOAD_ERROR",
+				payload: e
+			}), console.error("Error loading server scene into optimizer:", e), e;
+		}
+	}, []), y = r(async (e) => {
+		if (g.current.hasModel()) try {
+			await g.current.simplify(e), a({
+				type: "LOAD_SUCCESS",
+				payload: { report: await g.current.getReport() }
+			});
+		} catch (e) {
+			console.error("Simplification failed:", e);
+		}
+	}, []), b = r(async (e) => {
+		if (g.current.hasModel()) try {
+			await g.current.deduplicate(e), a({
+				type: "LOAD_SUCCESS",
+				payload: { report: await g.current.getReport() }
+			});
+		} catch (e) {
+			console.error("Deduplication failed:", e);
+		}
+	}, []), x = r(async (e) => {
+		if (g.current.hasModel()) try {
+			await g.current.quantize(e), a({
+				type: "LOAD_SUCCESS",
+				payload: { report: await g.current.getReport() }
+			});
+		} catch (e) {
+			console.error("Quantization failed:", e);
+		}
+	}, []), S = r(async (e) => {
+		if (g.current.hasModel()) try {
+			await g.current.optimizeNormals(e), a({
+				type: "LOAD_SUCCESS",
+				payload: { report: await g.current.getReport() }
+			});
+		} catch (e) {
+			console.error("Normals optimization failed:", e);
+		}
+	}, []), C = r(async (e) => {
+		try {
+			await O(g.current, e), a({
+				type: "LOAD_SUCCESS",
+				payload: { report: await g.current.getReport() }
+			});
+		} catch (e) {
+			throw console.error("Texture optimization failed:", e), e;
+		}
+	}, []), w = r(async () => {
+		if (!g.current.hasModel()) return null;
+		try {
+			return await g.current.export();
+		} catch (e) {
+			return console.error("Error getting model binary:", e), null;
+		}
+	}, []), T = r(() => g.current.hasModel() ? g.current.document : null, []);
+	return {
+		load: _,
+		loadFromServerSceneData: v,
+		getModel: w,
+		isReady: !!T() && !p,
+		_getDocument: T,
+		reset: r(() => {
+			g.current.reset(), a({ type: "RESET" }), h();
+		}, [h]),
+		error: d,
+		loading: p,
+		report: c,
+		info: m,
+		simplifyOptimization: y,
+		dedupOptimization: b,
+		quantizeOptimization: x,
+		normalsOptimization: S,
+		texturesOptimization: C
+	};
+};
+//#endregion
+export { k as t };

package/use-optimize-model.cjs.js

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`}),require(`./chunk-gGpyby2o.cjs`);const e=require(`./use-optimize-model-C-fzzKh6.cjs`);exports.useOptimizeModel=e.t;

package/use-optimize-model.es.js

@@ -0,0 +1,2 @@
+import { t as e } from "./use-optimize-model-Cb3WMvDZ.js";
+export { e as useOptimizeModel };

package/utils/server-communication.d.ts

@@ -0,0 +1,122 @@
+import { ServerOptions, TextureBinaryPayload, TextureCompressOptions } from '../../../core/src/index.ts';
+/**
+ * Configuration for a server request.
+ */
+export interface ServerRequestConfig {
+    /** Server endpoint URL or path */
+    endpoint: string;
+    /** HTTP method (GET, POST, etc.) */
+    method?: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+    /** Request body (FormData, JSON, or other) */
+    body?: FormData | Record<string, unknown> | string;
+    /** Optional server options (headers, auth, etc.) */
+    serverOptions?: ServerOptions;
+    /** Content type for JSON bodies (default: 'application/json') */
+    contentType?: string;
+}
+/**
+ * Unified server communication service for handling HTTP requests.
+ * Provides a consistent interface for API calls with built-in error handling,
+ * authentication, and response parsing.
+ *
+ * @example
+ * ```typescript
+ * // Simple GET request
+ * const data = await ServerCommunicationService.request<SceneData>({
+ *   endpoint: '/api/load-scene',
+ *   method: 'GET'
+ * })
+ *
+ * // POST with FormData
+ * const formData = new FormData()
+ * formData.append('model', file)
+ * const result = await ServerCommunicationService.request({
+ *   endpoint: '/api/optimize',
+ *   method: 'POST',
+ *   body: formData,
+ *   serverOptions: { apiKey: 'secret' }
+ * })
+ *
+ * // POST with JSON
+ * const response = await ServerCommunicationService.request({
+ *   endpoint: '/api/save',
+ *   method: 'POST',
+ *   body: { sceneId: '123', settings: {...} },
+ *   serverOptions: { headers: { 'X-Custom': 'value' } }
+ * })
+ * ```
+ */
+export declare class ServerCommunicationService {
+    private static extractApiData;
+    /**
+     * Creates default server options with required endpoint.
+     * Merges provided options with defaults.
+     */
+    static createDefaultServerOptions(serverOptions?: ServerOptions): ServerOptions & Required<Pick<ServerOptions, 'endpoint'>>;
+    /**
+     * Creates request headers for server communication.
+     * Includes authentication token if apiKey is provided.
+     */
+    static createRequestHeaders(serverOptions?: ServerOptions, additionalHeaders?: HeadersInit): HeadersInit;
+    /**
+     * Extracts error message from a failed response.
+     * Attempts to parse JSON error data, falls back to text.
+     */
+    static extractErrorMessage(response: Response): Promise<string>;
+    /**
+     * Handles server response errors and throws appropriate errors.
+     */
+    static handleServerResponseError(response: Response): Promise<never>;
+    /**
+     * Prepares FormData for a single texture optimization request.
+     */
+    static prepareTextureOptimizationFormData(texture: TextureBinaryPayload, options?: TextureCompressOptions): FormData;
+    /**
+     * Performs a generic HTTP request with error handling.
+     * Returns parsed response data.
+     *
+     * @template T - Expected response data type
+     * @param config - Request configuration
+     * @returns Promise resolving to parsed response data
+     * @throws Error if request fails or response is not ok
+     */
+    static request<T = unknown>(config: ServerRequestConfig): Promise<T>;
+    /**
+     * Performs a GET request.
+     * Convenience method for common GET operations.
+     */
+    static get<T = unknown>(endpoint: string, serverOptions?: ServerOptions): Promise<T>;
+    /**
+     * Performs a POST request with JSON body.
+     * Convenience method for common POST operations.
+     */
+    static post<T = unknown>(endpoint: string, body: Record<string, unknown>, serverOptions?: ServerOptions): Promise<T>;
+    /**
+     * Performs a POST request with FormData body.
+     * Convenience method for file uploads.
+     */
+    static postFormData<T = unknown>(endpoint: string, formData: FormData, serverOptions?: ServerOptions): Promise<T>;
+    /**
+     * Fetches scene data from the server.
+     * Specialized method for loading 3D scenes with their associated settings.
+     *
+     * This method handles the vectreal-platform API format which uses:
+     * - FormData with 'action' and 'sceneId' parameters
+     * - POST request to the scene-settings endpoint
+     * - Returns scene data including GLTF JSON and asset data
+     *
+     * @param sceneId - The unique identifier of the scene to load
+     * @param serverOptions - Optional server configuration (endpoint, auth, headers)
+     * @returns Promise resolving to the scene data
+     * @throws Error if the request fails or scene doesn't exist
+     *
+     * @example
+     * ```typescript
+     * const sceneData = await ServerCommunicationService.loadScene('abc-123', {
+     *   endpoint: '/api/scenes/abc-123',
+     *   apiKey: 'optional-auth-token'
+     * })
+     * ```
+     */
+    static loadScene<T = unknown>(sceneId: string, serverOptions?: ServerOptions): Promise<T>;
+}

package/project.json

@@ -1,55 +0,0 @@
-{
-	"name": "vctrl/hooks",
-	"$schema": "../../node_modules/nx/schemas/project-schema.json",
-	"sourceRoot": "packages/hooks/src",
-	"projectType": "library",
-	"tags": [],
-	"targets": {
-		"lint": {
-			"executor": "@nx/eslint:lint",
-			"outputs": ["{options.outputFile}"],
-			"options": {
-				"fix": true,
-				"lintFilePatterns": [
-					"packages/hooks/**/*.{ts,tsx,js,jsx}",
-					"packages/hooks/package.json"
-				]
-			}
-		},
-		"publish": {
-			"dependsOn": ["copy-md"],
-			"executor": "nx:run-commands",
-			"outputs": [],
-			"options": {
-				"command": "npm publish --access public",
-				"cwd": "build/packages/vctrl/hooks"
-			}
-		},
-		"copy-md": {
-			"dependsOn": ["build"],
-			"executor": "nx:run-commands",
-			"outputs": [],
-			"options": {
-				"commands": [
-					"rsync -rat packages/hooks/*.md build/packages/vctrl/hooks/"
-				]
-			}
-		},
-		"build": {
-			"executor": "@nx/vite:build",
-			"outputs": ["{options.outputPath}"],
-			"options": {
-				"outputPath": "build/packages/vctrl/hooks",
-				"configFile": "packages/hooks/vite.config.ts"
-			}
-		},
-		"build-ci": {
-			"executor": "@nx/vite:build",
-			"outputs": ["{options.outputPath}"],
-			"options": {
-				"outputPath": "build/packages/vctrl/hooks",
-				"configFile": "packages/hooks/vite.config.ts"
-			}
-		}
-	}
-}