@vctrl/hooks 0.18.0 → 0.22.0

package/CHANGELOG.md

@@ -1,5 +1,65 @@
 # Changelog
 
+## [0.22.0](https://github.com/Vectreal/vectreal-platform/compare/hooks-v0.21.0...hooks-v0.22.0) (2026-07-01)
+
+
+### Features
+
+* enhance @vctrl/core documentation and improve package structure ([f74b8c8](https://github.com/Vectreal/vectreal-platform/commit/f74b8c881b0dad4ef35da0013492adfd5bde0ed9))
+* enhance @vctrl/core documentation and improve package structure ([6599388](https://github.com/Vectreal/vectreal-platform/commit/65993883139d8fb0ab52839b14068276f482642a))
+* Implement shadow bake persistence and garbage collection ([003f962](https://github.com/Vectreal/vectreal-platform/commit/003f962bcaf773fe58015412536fd5eb9b8c3f68))
+* **optimization:** migrate to Supabase Edge Functions & Storage ([#554](https://github.com/Vectreal/vectreal-platform/issues/554)) ([420f94a](https://github.com/Vectreal/vectreal-platform/commit/420f94a5ee6c1cecf35b98d0bc9695922b2bf122))
+* **viewer:** add accumulative shadow baking features and related components ([08427b6](https://github.com/Vectreal/vectreal-platform/commit/08427b6f4ea0e9ae2ea8849de2f0dd8627b0af07))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @vctrl/core bumped to 0.22.0
+
+## [0.21.0](https://github.com/Vectreal/vectreal-platform/compare/hooks-v0.20.0...hooks-v0.21.0) (2026-05-21)
+
+
+### Features
+
+* add local Google Cloud Storage setup instructions and configura… ([#499](https://github.com/Vectreal/vectreal-platform/issues/499)) ([8448285](https://github.com/Vectreal/vectreal-platform/commit/84482854455dcd1993e96fcad1275116df16a4b2))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @vctrl/core bumped to 0.21.0
+
+## [0.20.0](https://github.com/Vectreal/vectreal-platform/compare/hooks-v0.19.0...hooks-v0.20.0) (2026-05-12)
+
+
+### Miscellaneous Chores
+
+* **hooks:** Synchronize vectreal-monorepo versions
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @vctrl/core bumped to 0.20.0
+
+## [0.19.0](https://github.com/Vectreal/vectreal-platform/compare/hooks-v0.18.0...hooks-v0.19.0) (2026-05-10)
+
+
+### Bug Fixes
+
+* eliminate Vite v8 build warnings — upgrade plugin-react to v6, suppress Node.js dynamic import noise ([#445](https://github.com/Vectreal/vectreal-platform/issues/445)) ([211e188](https://github.com/Vectreal/vectreal-platform/commit/211e188b00130486c38904fe2cff584261a6702f))
+
+
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @vctrl/core bumped to 0.19.0
+
 ## [0.18.0](https://github.com/Vectreal/vectreal-platform/compare/hooks-v0.17.0...hooks-v0.18.0) (2026-04-30)
 
 

package/README.md

@@ -120,7 +120,7 @@ export default function App() {
 
 ## `useOptimizeModel`
 
-Runs mesh simplification and texture compression using [glTF-Transform](https://gltf-transform.dev) in a Web Worker.
+Runs mesh simplification, deduplication, quantization, and normals optimization using [glTF-Transform](https://gltf-transform.dev) — geometry passes run in a Web Worker. Texture compression runs in the main thread via browser-native OffscreenCanvas encoding.
 
 ```tsx
 import { useOptimizeModel } from '@vctrl/hooks/use-optimize-model'
@@ -166,15 +166,15 @@ function Optimizer() {
 
 `useOptimizeModel` methods map directly to `@vctrl/core/model-optimizer` option types:
 
-| Method                 | Option fields                                                                                                                                                                                                                                        |
-| ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `simplifyOptimization` | `ratio?: number`, `error?: number`                                                                                                                                                                                                                   |
-| `dedupOptimization`    | `textures?: boolean`, `materials?: boolean`, `meshes?: boolean`, `accessors?: boolean`                                                                                                                                                               |
-| `quantizeOptimization` | `quantizePosition?: number`, `quantizeNormal?: number`, `quantizeColor?: number`, `quantizeTexcoord?: number`                                                                                                                                        |
-| `normalsOptimization`  | `overwrite?: boolean`                                                                                                                                                                                                                                |
-| `texturesOptimization` | `resize?: [number, number]`, `targetFormat?: 'webp' \| 'jpeg' \| 'png'`, `quality?: number`, `requestTimeoutMs?: number`, `maxTextureUploadBytes?: number`, `maxRetries?: number`, `maxConcurrentRequests?: number`, `serverOptions?: ServerOptions` |
+| Method                 | Option fields                                                                                                 |
+| ---------------------- | ------------------------------------------------------------------------------------------------------------- |
+| `simplifyOptimization` | `ratio?: number`, `error?: number`                                                                            |
+| `dedupOptimization`    | `textures?: boolean`, `materials?: boolean`, `meshes?: boolean`, `accessors?: boolean`                        |
+| `quantizeOptimization` | `quantizePosition?: number`, `quantizeNormal?: number`, `quantizeColor?: number`, `quantizeTexcoord?: number` |
+| `normalsOptimization`  | `overwrite?: boolean`                                                                                         |
+| `texturesOptimization` | `resize?: [number, number]`, `targetFormat?: 'webp' \| 'jpeg' \| 'png'`, `quality?: number`                   |
 
-`serverOptions` is provided by `@vctrl/core` and supports endpoint, API key, and headers.
+Texture compression runs browser-native via `OffscreenCanvas`. No server call is made.
 
 ---
 

package/chunk-CMqjfN_6.cjs

@@ -0,0 +1 @@
+var e=Object.create,t=Object.defineProperty,n=Object.getOwnPropertyDescriptor,r=Object.getOwnPropertyNames,i=Object.getPrototypeOf,a=Object.prototype.hasOwnProperty,o=(e,i,o,s)=>{if(i&&typeof i==`object`||typeof i==`function`)for(var c=r(i),l=0,u=c.length,d;l<u;l++)d=c[l],!a.call(e,d)&&d!==o&&t(e,d,{get:(e=>i[e]).bind(null,d),enumerable:!(s=n(i,d))||s.enumerable});return e},s=(n,r,a)=>(a=n==null?{}:e(i(n)),o(r||!n||!n.__esModule?t(a,`default`,{value:n,enumerable:!0}):a,n));Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return s}});

package/index.cjs.js

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`}),require(`./chunk-gGpyby2o.cjs`);const e=require(`./use-load-model-CH-WPQ_s.cjs`),t=require(`./use-export-model-CaijtW1c.cjs`),n=require(`./use-optimize-model-C-fzzKh6.cjs`);exports.reconstructGltfFiles=e.n,exports.useExportModel=t.t,exports.useLoadModel=e.t,exports.useOptimizeModel=n.t;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./use-load-model-B9M4cF4B.cjs"),t=require("./use-export-model-8JbUalyf.cjs"),n=require("./use-optimize-model-CPGezwrM.cjs");exports.reconstructGltfFiles=e.n,exports.useExportModel=t.t,exports.useLoadModel=e.t,exports.useOptimizeModel=n.t;

package/index.es.js

@@ -1,4 +1,4 @@
-import { n as e, t } from "./use-load-model-B6UXiFWh.js";
-import { t as n } from "./use-export-model-DzVKdqnY.js";
-import { t as r } from "./use-optimize-model-Cb3WMvDZ.js";
+import { n as e, t } from "./use-load-model-BDCy9n2U.js";
+import { t as n } from "./use-export-model-BXg6L_W5.js";
+import { t as r } from "./use-optimize-model-KAGxtv_k.js";
 export { e as reconstructGltfFiles, n as useExportModel, t as useLoadModel, r as useOptimizeModel };

package/package.json

@@ -1,68 +1,68 @@
 {
-	"version": "0.18.0",
-	"name": "@vctrl/hooks",
-	"description": "vctrl/hooks is a React hooks package designed to simplify 3D model loading and management within React applications. It's part of the vectreal-core ecosystem and is primarily used in the vctrl/viewer React component and the official website application.",
-	"bugs": {
-		"url": "https://github.com/vectreal/vectreal-platform/issues"
-	},
-	"homepage": "https://vectreal.com",
-	"keywords": [
-		"vectreal",
-		"react",
-		"3d",
-		"model",
-		"viewer",
-		"react-component",
-		"react-three-fiber",
-		"react-three-drei",
-		"threejs",
-		"react-three-gltf",
-		"gltf",
-		"glb",
-		"usdz",
-		"three-model-loading",
-		"model-viewer"
-	],
-	"repository": {
-		"type": "git",
-		"url": "git+https://github.com/vectreal/vectreal-platform.git"
-	},
-	"license": "AGPL-3.0-only",
-	"types": "./index.d.ts",
-	"main": "./index.cjs.js",
-	"module": "./index.es.js",
-	"type": "module",
-	"publishConfig": {
-		"access": "public"
-	},
-	"exports": {
-		"./use-load-model": {
-			"types": "./use-load-model/index.d.ts",
-			"import": "./use-load-model.es.js",
-			"require": "./use-load-model.cjs.js"
-		},
-		"./use-export-model": {
-			"types": "./use-export-model/index.d.ts",
-			"import": "./use-export-model.es.js",
-			"require": "./use-export-model.cjs.js"
-		},
-		"./use-optimize-model": {
-			"types": "./use-optimize-model/index.d.ts",
-			"import": "./use-optimize-model.es.js",
-			"require": "./use-optimize-model.cjs.js"
-		}
-	},
-	"peerDependencies": {
-		"react": "^18.0.0 || ^19.0.0",
-		"@gltf-transform/core": "^4.0.8",
-		"file-saver": "^2.0.5",
-		"@nx/vite": "22.5.0",
-		"@vitejs/plugin-react": "^4.3.4",
-		"vite": "^7.3.1",
-		"vite-plugin-dts": "4.5.3"
-	},
-	"dependencies": {
-		"@vctrl/core": "workspace:*",
-		"three": "^0.177.0"
-	}
-}
+  "version": "0.22.0",
+  "name": "@vctrl/hooks",
+  "description": "vctrl/hooks is a React hooks package designed to simplify 3D model loading and management within React applications. It's part of the vectreal-core ecosystem and is primarily used in the vctrl/viewer React component and the official website application.",
+  "bugs": {
+    "url": "https://github.com/vectreal/vectreal-platform/issues"
+  },
+  "homepage": "https://vectreal.com",
+  "keywords": [
+    "vectreal",
+    "react",
+    "3d",
+    "model",
+    "viewer",
+    "react-component",
+    "react-three-fiber",
+    "react-three-drei",
+    "threejs",
+    "react-three-gltf",
+    "gltf",
+    "glb",
+    "usdz",
+    "three-model-loading",
+    "model-viewer"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vectreal/vectreal-platform.git"
+  },
+  "license": "AGPL-3.0-only",
+  "types": "./index.d.ts",
+  "main": "./index.cjs.js",
+  "module": "./index.es.js",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./index.es.js",
+      "require": "./index.cjs.js"
+    },
+    "./use-load-model": {
+      "types": "./use-load-model/index.d.ts",
+      "import": "./use-load-model.es.js",
+      "require": "./use-load-model.cjs.js"
+    },
+    "./use-export-model": {
+      "types": "./use-export-model/index.d.ts",
+      "import": "./use-export-model.es.js",
+      "require": "./use-export-model.cjs.js"
+    },
+    "./use-optimize-model": {
+      "types": "./use-optimize-model/index.d.ts",
+      "import": "./use-optimize-model.es.js",
+      "require": "./use-optimize-model.cjs.js"
+    }
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0",
+    "three": "^0.177.0"
+  },
+  "dependencies": {
+    "@vctrl/core": "^0.22.0",
+    "file-saver": "^2.0.5"
+  }
+}

package/use-export-model-8JbUalyf.cjs

@@ -0,0 +1 @@
+const e=require("./chunk-CMqjfN_6.cjs");let t=require("react"),n=require("@vctrl/core/model-exporter"),r=require("file-saver");r=e.t(r,1);var i=(e,i)=>{let a=(0,t.useRef)(new n.ModelExporter);return{handleThreeGltfExport:(0,t.useCallback)(async(t,n)=>{let o=t?.model;if(!o){console.error(`Scene not initialized`);return}try{let i=a.current,s=t.name.replace(/\.[^/.]+$/,``);if(n){let e=await i.exportThreeJSGLB(o,{});if(!(e.data instanceof Uint8Array))throw Error(`Expected GLB export to return Uint8Array`);r.default.saveAs(new Blob([new Uint8Array(e.data)]),`${s}.glb`)}else{let e=await i.exportThreeJSGLTF(o),t=await i.createZIPArchive(e,s);r.default.saveAs(new Blob([new Uint8Array(t)]),`${s}.zip`)}e&&e()}catch(e){console.error(`Export failed:`,e),i&&i(e)}},[e,i]),handleDocumentGltfExport:(0,t.useCallback)(async function(t,n,o=!1,s=!0){try{let i=a.current,c=n?.name.replace(/\.[^/.]+$/,``)||`model`;if(o){let e=await i.exportDocumentGLB(t);r.default.saveAs(new Blob([new Uint8Array(e.data)]),`${c}.glb`)}else{let e=await i.exportDocumentGLTF(t);if(!s)return e;let n=await i.createZIPArchive(e,c);r.default.saveAs(new Blob([new Uint8Array(n)]),`${c}.zip`)}e&&e()}catch(e){console.error(`Export failed:`,e),i&&i(e)}},[i,e])}};Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return i}});

package/{use-export-model-DzVKdqnY.js → use-export-model-BXg6L_W5.js}

@@ -1,11 +1,11 @@
-import { t as e } from "./model-exporter-cvguDGnn.js";
-import { useCallback as t, useRef as n } from "react";
+import { useCallback as e, useRef as t } from "react";
+import { ModelExporter as n } from "@vctrl/core/model-exporter";
 import r from "file-saver";
 //#region packages/hooks/src/use-export-model/use-export-model.ts
 var i = (i, a) => {
-	let o = n(new e());
+	let o = t(new n());
 	return {
-		handleThreeGltfExport: t(async (e, t) => {
+		handleThreeGltfExport: e(async (e, t) => {
 			let n = e?.model;
 			if (!n) {
 				console.error("Scene not initialized");
@@ -26,7 +26,7 @@ var i = (i, a) => {
 				console.error("Export failed:", e), a && a(e);
 			}
 		}, [i, a]),
-		handleDocumentGltfExport: t(async function(e, t, n = !1, s = !0) {
+		handleDocumentGltfExport: e(async function(e, t, n = !1, s = !0) {
 			try {
 				let a = o.current, c = t?.name.replace(/\.[^/.]+$/, "") || "model";
 				if (n) {

package/use-export-model.cjs.js

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`}),require(`./chunk-gGpyby2o.cjs`);const e=require(`./use-export-model-CaijtW1c.cjs`);exports.useExportModel=e.t;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./use-export-model-8JbUalyf.cjs");exports.useExportModel=e.t;

package/use-export-model.es.js

@@ -1,2 +1,2 @@
-import { t as e } from "./use-export-model-DzVKdqnY.js";
+import { t as e } from "./use-export-model-BXg6L_W5.js";
 export { e as useExportModel };

package/use-load-model/error-helpers.d.ts

@@ -0,0 +1,5 @@
+import { StructuredLoadError } from './types';
+export declare const createStructuredLoadError: ({ code, message, recoverable, source, cause, context }: StructuredLoadError) => StructuredLoadError;
+export declare const toErrorMessage: (error: unknown) => string;
+export declare const normalizeLocalLoadError: (error: unknown, code: StructuredLoadError["code"], context?: Record<string, unknown>) => StructuredLoadError;
+export declare const normalizeServerLoadError: (error: unknown, sceneId: string) => StructuredLoadError;

package/use-load-model/file-loaders.d.ts

@@ -0,0 +1,12 @@
+import { ModelFileTypes, ModelLoader } from '../../../core/src/model-loader/index.ts';
+import { default as React } from 'react';
+import { Action, ModelFile } from './types';
+import { useOptimizeModel } from '../use-optimize-model';
+type Optimizer = ReturnType<typeof useOptimizeModel> | undefined;
+type Dispatch = React.Dispatch<Action>;
+export declare const loadBinaryModel: (file: File, fileType: ModelFileTypes, modelLoader: ModelLoader, optimizer: Optimizer, dispatch: Dispatch) => Promise<ModelFile | null>;
+export declare const loadGltfModel: (gltfFile: File, otherFiles: File[], modelLoader: ModelLoader, optimizer: Optimizer, dispatch: Dispatch, calculateReferencedBytesFromFiles: (gltfFile: File, otherFiles: File[]) => Promise<{
+    sourcePackageBytes: number;
+    textureBytes: number;
+}>) => Promise<ModelFile | null>;
+export {};

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

@@ -1,4 +1,4 @@
 export { default as useLoadModel } from './use-load-model';
-export { type EventHandler, type EventTypes, type InputFileOrDirectory, type LoadData, type ModelFile, type SceneDataLoadOptions, type SceneLoadOptions, type SceneLoadResult, type UseLoadModelReturn, type ServerSceneData } from './types';
+export { type EventHandler, type EventTypes, type InputFileOrDirectory, type LoadData, type ModelFile, type SceneDataLoadOptions, type SceneLoadOptions, type SceneLoadResult, type StructuredLoadError, type UseLoadModelReturn, type ViewerLoadErrorCode, type ServerSceneData } from './types';
 export { reconstructGltfFiles } from './utils/reconstruct-files';
 export * from './model-context';

package/use-load-model/optimizer-integration.d.ts

@@ -0,0 +1,16 @@
+import { ModelLoader } from '../../../core/src/model-loader/index.ts';
+import { default as React } from 'react';
+import { Action, ModelFile, OptimizerIntegrationReturn } from './types';
+import { useOptimizeModel } from '../use-optimize-model';
+/**
+ * Integrates the optimizer into the model loading process.
+ *
+ * Provides the `applyOptimization` method that:
+ * 1. Runs an optional optimization function
+ * 2. Exports the optimized model as GLB
+ * 3. Reloads it into Three.js
+ * 4. Updates the model state
+ *
+ * Returns `null` when no optimizer instance is provided.
+ */
+export declare function useOptimizerIntegration(instance: ReturnType<typeof useOptimizeModel> | undefined, dispatch: React.Dispatch<Action>, file: ModelFile | null, modelLoader: ModelLoader): OptimizerIntegrationReturn<boolean>;

package/use-load-model/scene-data-builder.d.ts

@@ -0,0 +1,3 @@
+import { ServerSceneData } from '../../../core/src/index.ts';
+export declare const collectReferencedUris: (gltfJson: unknown) => Set<string>;
+export declare const buildSceneDataFromLocalFiles: (gltfFile: File, assetFiles: File[]) => Promise<ServerSceneData>;

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

@@ -92,6 +92,15 @@ export type Action = {
  * Used for subscribing to various stages of the loading process.
  */
 export type EventTypes = 'multiple-models' | 'not-loaded-files' | 'load-start' | 'load-progress' | 'load-complete' | 'load-reset' | 'load-error' | 'server-load-start' | 'server-load-complete' | 'server-load-error';
+export type ViewerLoadErrorCode = 'unsupported_format' | 'binary_load_failed' | 'gltf_load_failed' | 'missing_assets' | 'server_load_failed' | 'not_found' | 'quota_exceeded' | 'unknown';
+export interface StructuredLoadError {
+    code: ViewerLoadErrorCode;
+    message: string;
+    recoverable: boolean;
+    source: 'local-upload' | 'server-load';
+    cause?: unknown;
+    context?: Record<string, unknown>;
+}
 /**
  * Maps event types to their corresponding data payloads.
  * Ensures type safety when handling events.
@@ -109,14 +118,14 @@ export type EventData = {
     'load-complete': LoadData['file'];
     /** No data for reset event */
     'load-reset': null;
-    /** Error object when loading fails */
-    'load-error': Error | unknown;
+    /** Normalized error payload when loading fails */
+    'load-error': StructuredLoadError | Error | unknown;
     /** Scene ID being loaded from server */
     'server-load-start': string;
     /** Complete scene load result */
     'server-load-complete': SceneLoadResult;
-    /** Error during server scene loading */
-    'server-load-error': Error | unknown;
+    /** Normalized error payload during server scene loading */
+    'server-load-error': StructuredLoadError | Error | unknown;
 };
 /**
  * Type-safe event handler function.

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

@@ -3,24 +3,13 @@ import { useOptimizeModel } from '../use-optimize-model';
 /**
  * Custom hook to load and manage 3D models with optional optimization integration.
  *
- * This hook provides a complete solution for loading 3D models (GLTF, GLB, USDZ) with
- * optional integration of model optimization capabilities. The return type is conditionally
- * typed based on whether an optimizer is provided.
+ * Supports GLTF, GLB, and USDZ formats via file upload or server-side scene loading.
+ * When an optimizer is provided, each load path initialises the optimizer so texture
+ * names and URIs are preserved for subsequent compression or simplification passes.
  *
  * **Type Safety:**
- * - When called with an optimizer: `optimizer` property is fully typed with optimization methods
- * - When called without an optimizer: `optimizer` property is typed as `null`
- *
- * @example
- * // With optimizer integration
- * const optimizer = useOptimizeModel()
- * const model = useLoadModel(optimizer)
- * model.optimizer.applyOptimization() // ✅ Fully typed
- *
- * @example
- * // Without optimizer
- * const model = useLoadModel()
- * model.optimizer // ✅ Typed as null
+ * - With optimizer: `optimizer` property is fully typed with optimization methods
+ * - Without optimizer: `optimizer` property is typed as `null`
  *
  * @template T - The type of the optimizer parameter (inferred automatically)
  * @param optimizer - Optional optimizer hook returned from useOptimizeModel

package/use-load-model-B9M4cF4B.cjs

@@ -0,0 +1 @@
+let e=require("@vctrl/core/model-loader"),t=require("react"),n=require("@vctrl/core");var r=({code:e,message:t,recoverable:n,source:r,cause:i,context:a})=>({code:e,message:t,recoverable:n,source:r,cause:i,context:a}),i=e=>e instanceof Error&&e.message?e.message:typeof e==`string`&&e.trim().length>0?e:`Unknown error`,a=(e,t,n)=>{let a=i(e);return r({code:a.includes(`missing required referenced assets`)?`missing_assets`:t,message:a,recoverable:!0,source:`local-upload`,cause:e,context:n})},o=(e,t)=>{let n=i(e),a=`server_load_failed`;return n.includes(`Server responded with 404`)?a=`not_found`:(n.includes(`Server responded with 402`)||n.includes(`Server responded with 403`))&&(a=`quota_exceeded`),r({code:a,message:n,recoverable:a!==`not_found`,source:`server-load`,cause:e,context:{sceneId:t}})},s={},c={emit(e,t){let n=s[e];console.debug(`Event emitted: ${e}`,t),n&&n.forEach(e=>e(t))},on(e,t){s[e]||(s[e]=[]),s[e].push(t)},off(e,t){let n=s[e];n&&(s[e]=n.filter(e=>e!==t))}},l=e=>{try{return(0,n.normalizeAssetUri)(e)}catch{return 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(e,t)=>{let r=JSON.parse(await e.text()),i=u(r),a={},o=new Map,s=new Map,c=new Set,d=async e=>{let t=s.get(e);if(t)return t;let n=new Uint8Array(await e.arrayBuffer());return s.set(e,n),n};for(let e of t){for(let t of(0,n.buildAssetLookupKeys)(e.name))o.set(t,e);if(e.webkitRelativePath)for(let t of(0,n.buildAssetLookupKeys)(e.webkitRelativePath))o.set(t,e)}let f=[];for(let e of i){let t=l(e),n=t.split(`/`).pop()||t,r=o.get(e)||o.get(t)||o.get(n);if(!r){f.push(e);continue}c.add(r);let i=await d(r);a[t]={data:Array.from(i),fileName:t,mimeType:r.type||`application/octet-stream`}}if(f.length>0)throw Error(`Scene payload is missing required referenced assets: ${f.slice(0,5).join(`, `)}`);for(let[e,n]of t.entries()){if(c.has(n))continue;let t=l(n.name),r=t.split(`/`).pop()||t,i=await d(n);a[`extra-${e}-${r}`]={data:Array.from(i),fileName:r,mimeType:n.type||`application/octet-stream`}}return{gltfJson:r,assetData:a}},f=async(t,n,r,i,o)=>{try{let a={model:(await r.loadToThreeJS(t)).scene,type:n,name:t.name};if(o({type:`set-file`,payload:a}),o({type:`set-file-loading`,payload:!1}),i&&n!==e.ModelFileTypes.usdz){let e=new Uint8Array(await t.arrayBuffer());await i.loadFromGlbBuffer(e)}return a}catch(e){return console.error(`Error loading binary model:`,e),o({type:`set-file-loading`,payload:!1}),c.emit(`load-error`,a(e,`binary_load_failed`,{fileName:t.name,fileType:n,fileSize:t.size})),null}},p=async(t,n,r,i,o,s)=>{try{let{sourcePackageBytes:a,textureBytes:c}=await s(t,n),l=await r.loadGLTFWithAssetsToThreeJS(t,n),u={model:l.scene,type:e.ModelFileTypes.gltf,name:t.name,sourcePackageBytes:a,sourceTextureBytes:c};if(o({type:`set-file`,payload:u}),o({type:`set-file-loading`,payload:!1}),i)try{let e=await d(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=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)),o({type:`set-file-loading`,payload:!1}),c.emit(`load-error`,a(e,`gltf_load_failed`,{fileName:t.name,fileSize:t.size,assetCount:n.length})),null}};function m(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`});r({type:`set-file`,payload:{model:(await a.loadToThreeJS(l)).scene,type:e.ModelFileTypes.glb,name:l.name}})}catch(e){console.error(`Optimization failed:`,e)}},[n,a,i,r]);if(!n)return null;let s=n.isReady,c=!!i?.model&&!s;return{...n,isReady:s,isPreparing:c,applyOptimization:o,reset:n?.reset,error:n?.error,loading:n?.loading}}var h={file:null,isFileLoading:!1,progress:0,supportedFileTypes:[e.ModelFileTypes.gltf,e.ModelFileTypes.glb,e.ModelFileTypes.usdz]};function g(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{...h};default:return e}}async function _(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}function v(e){let t=[];if(e.assetData&&typeof e.assetData==`object`)for(let[,r]of Object.entries(e.assetData)){let{fileName:e,mimeType:i}=r;if(e===n.PERSISTED_BAKE_FILENAME)continue;let a=(0,n.toSerializedAssetBytes)(r),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)}let r=JSON.stringify(e.gltfJson),i=new Blob([r],{type:`model/gltf+json`}),a=e.meta?.name,o=a?`${a}.gltf`:`scene.gltf`;return[new File([i],o,{type:`model/gltf+json`}),...t]}var y=(e,t)=>{let r=(0,n.normalizeAssetUri)(e),i=r.split(`/`).pop()||r;for(let e of t){let t=(0,n.buildAssetLookupKeys)(e.fileName);if(t.has(r)||t.has(i))return e.size}return 0},b=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 x(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}=b(r),s=Array.from(a).reduce((e,t)=>e+y(t,i),0),c=Array.from(o).reduce((e,t)=>e+y(t,i),0);return{sourcePackageBytes:e.size+s+c,textureBytes:c}}function S(e){let t=e.gltfJson,r=Object.values(e.assetData||{}).map(e=>({fileName:e.fileName,size:(0,n.getSerializedAssetByteSize)(e.data)})),i=new TextEncoder().encode(JSON.stringify(t)).byteLength,{bufferUris:a,imageUris:o}=b(t),s=Array.from(a).reduce((e,t)=>e+y(t,r),0),c=Array.from(o).reduce((e,t)=>e+y(t,r),0);return{sourcePackageBytes:i+s+c,textureBytes:c}}function C(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function w(e){let t=C(e.settings)?e.settings:{},r=(0,n.normalizeCameraSettings)(e.camera??t.camera);return{...t,bounds:e.bounds??t.bounds,camera:r,interactions:(0,n.normalizeSceneInteractions)(t.interactions,{camera:r}),controls:e.controls??t.controls,environment:e.environment??t.environment,shadows:e.shadows??t.shadows}}function T(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 E(e){for(let[t,r]of Object.entries(e)){if(!r||typeof r!=`object`)throw Error(`Scene payload contains invalid asset entry for ${t}`);if(typeof r.fileName!=`string`||r.fileName.trim().length===0)throw Error(`Scene payload asset ${t} is missing a valid fileName`);if(typeof r.mimeType!=`string`||r.mimeType.trim().length===0)throw Error(`Scene payload asset ${t} is missing a valid mimeType`);if(typeof r.data==`string`&&r.encoding===`base64`&&!(0,n.isValidBase64)(r.data))throw Error(`Scene payload asset ${r.fileName} has invalid base64 data`)}}function D(e,t){let r=T(e);if(r.size===0)return;let i=new Set;for(let e of Object.values(t))for(let t of(0,n.buildAssetLookupKeys)(e.fileName))i.add(t);let a=[];for(let e of r){let t=(0,n.normalizeAssetUri)(e),r=t.split(`/`).pop()||t;!i.has(e)&&!i.has(t)&&!i.has(r)&&a.push(e)}if(a.length>0)throw Error(`Scene payload is missing required referenced assets: ${a.slice(0,5).join(`, `)}`)}function O(e){if(!C(e.gltfJson))throw Error(`Scene payload is missing a valid glTF document`);let t=e.assetData??{};return E(t),D(e.gltfJson,t),{meta:e.meta,gltfJson:e.gltfJson,assetData:t,...w(e)}}function k(n){let r=(0,t.useRef)(!1),i=(0,t.useRef)(null),[a,s]=(0,t.useReducer)(g,h),l=(0,t.useMemo)(()=>{let t=new e.ModelLoader;return t.onProgress(e=>{s({type:`set-progress`,payload:e.progress}),e.progress!==100&&c.emit(`load-progress`,e.progress)}),t},[]),u=(0,t.useCallback)(e=>{s({type:`set-progress`,payload:e}),c.emit(`load-progress`,e)},[]),d=(0,t.useCallback)(()=>{s({type:`reset-state`}),c.emit(`load-reset`)},[]),y=(0,t.useCallback)((e,t)=>e.find(e=>e.name.endsWith(`.`+t)),[]),b=(0,t.useCallback)(async t=>{if(t.length===0)return;let a=y(t,e.ModelFileTypes.gltf),o=y(t,e.ModelFileTypes.glb),u=y(t,e.ModelFileTypes.usdz),d=[a,o,u].filter(Boolean);if(d.length>1){c.emit(`multiple-models`,d);return}let m=t.filter(e=>e!==a&&e!==o&&e!==u),h=()=>{r.current=!0,i.current&&(c.emit(`load-complete`,i.current),r.current=!1)};if(a){let e=await p(a,m,l,n,s,x);e&&(i.current=e),h()}else if(o){let t=await f(o,e.ModelFileTypes.glb,l,n,s);t&&(i.current=t),h()}else if(u){let t=await f(u,e.ModelFileTypes.usdz,l,n,s);t&&(i.current=t),h()}else c.emit(`not-loaded-files`,t),s({type:`set-file-loading`,payload:!1})},[y,l,n]),C=(0,t.useCallback)(async e=>{let t=[];c.emit(`load-start`),s({type:`reset-state`}),s({type:`set-file-loading`,payload:!0}),u(0),r.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 _(n);t.push(...e)}await b(t)},[b,u]),w=(0,t.useCallback)(async t=>{let{sceneData:r,sceneId:a}=t;u(40);let o=v(r),{sourcePackageBytes:c,textureBytes:d}=S(r);u(60);let f=o[0],p=o.slice(1),m={model:(await l.loadGLTFWithAssetsToThreeJS(f,p)).scene,type:e.ModelFileTypes.gltf,name:f.name,sourcePackageBytes:c,sourceTextureBytes:d};return s({type:`set-file`,payload:m}),s({type:`set-file-loading`,payload:!1}),i.current=m,n&&await n.loadFromServerSceneData(r),u(100),{file:m,sceneId:a,...r}},[l,n,u]),T=(0,t.useCallback)(async e=>{let{sceneId:t,serverOptions:n}=e;try{c.emit(`server-load-start`,t),s({type:`reset-state`}),s({type:`set-file-loading`,payload:!0}),u(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(),l=await w({sceneId:t,sceneData:O(o.data??o)});return c.emit(`server-load-complete`,l),l}catch(e){console.error(`Server scene loading failed:`,e),s({type:`set-file-loading`,payload:!1});let n=o(e,t);throw c.emit(`server-load-error`,n),n}},[w,u]),E=m(n,s,a.file,l);return{...a,on:c.on,off:c.off,load:C,loadFromData:w,loadFromServer:T,reset:d,optimizer:E}}Object.defineProperty(exports,"n",{enumerable:!0,get:function(){return v}}),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return k}});