@vctrl/hooks 0.22.0 → 0.23.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,504 +0,0 @@
1
- import { ModelFileTypes as e, ModelLoader as t } from "@vctrl/core/model-loader";
2
- import { useCallback as n, useMemo as r, useReducer as i, useRef as a } from "react";
3
- 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";
4
- //#region packages/hooks/src/use-load-model/error-helpers.ts
5
- var m = ({ code: e, message: t, recoverable: n, source: r, cause: i, context: a }) => ({
6
- code: e,
7
- message: t,
8
- recoverable: n,
9
- source: r,
10
- cause: i,
11
- context: a
12
- }), h = (e) => e instanceof Error && e.message ? e.message : typeof e == "string" && e.trim().length > 0 ? e : "Unknown error", g = (e, t, n) => {
13
- let r = h(e);
14
- return m({
15
- code: r.includes("missing required referenced assets") ? "missing_assets" : t,
16
- message: r,
17
- recoverable: !0,
18
- source: "local-upload",
19
- cause: e,
20
- context: n
21
- });
22
- }, _ = (e, t) => {
23
- let n = h(e), r = "server_load_failed";
24
- 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({
25
- code: r,
26
- message: n,
27
- recoverable: r !== "not_found",
28
- source: "server-load",
29
- cause: e,
30
- context: { sceneId: t }
31
- });
32
- }, v = {}, y = {
33
- emit(e, t) {
34
- let n = v[e];
35
- console.debug(`Event emitted: ${e}`, t), n && n.forEach((e) => e(t));
36
- },
37
- on(e, t) {
38
- v[e] || (v[e] = []), v[e].push(t);
39
- },
40
- off(e, t) {
41
- let n = v[e];
42
- n && (v[e] = n.filter((e) => e !== t));
43
- }
44
- }, b = (e) => {
45
- try {
46
- return u(e);
47
- } catch {
48
- return e;
49
- }
50
- }, x = (e) => {
51
- let t = /* @__PURE__ */ new Set(), n = e, r = Array.isArray(n.images) ? n.images : [];
52
- for (let e of r) typeof e.uri == "string" && !e.uri.startsWith("data:") && t.add(e.uri);
53
- let i = Array.isArray(n.buffers) ? n.buffers : [];
54
- for (let e of i) typeof e.uri == "string" && !e.uri.startsWith("data:") && t.add(e.uri);
55
- return t;
56
- }, S = async (e, t) => {
57
- 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) => {
58
- let t = o.get(e);
59
- if (t) return t;
60
- let n = new Uint8Array(await e.arrayBuffer());
61
- return o.set(e, n), n;
62
- };
63
- for (let e of t) {
64
- for (let t of s(e.name)) a.set(t, e);
65
- if (e.webkitRelativePath) for (let t of s(e.webkitRelativePath)) a.set(t, e);
66
- }
67
- let u = [];
68
- for (let e of r) {
69
- let t = b(e), n = t.split("/").pop() || t, r = a.get(e) || a.get(t) || a.get(n);
70
- if (!r) {
71
- u.push(e);
72
- continue;
73
- }
74
- c.add(r);
75
- let o = await l(r);
76
- i[t] = {
77
- data: Array.from(o),
78
- fileName: t,
79
- mimeType: r.type || "application/octet-stream"
80
- };
81
- }
82
- if (u.length > 0) throw Error(`Scene payload is missing required referenced assets: ${u.slice(0, 5).join(", ")}`);
83
- for (let [e, n] of t.entries()) {
84
- if (c.has(n)) continue;
85
- let t = b(n.name), r = t.split("/").pop() || t, a = await l(n);
86
- i[`extra-${e}-${r}`] = {
87
- data: Array.from(a),
88
- fileName: r,
89
- mimeType: n.type || "application/octet-stream"
90
- };
91
- }
92
- return {
93
- gltfJson: n,
94
- assetData: i
95
- };
96
- }, C = async (t, n, r, i, a) => {
97
- try {
98
- let o = {
99
- model: (await r.loadToThreeJS(t)).scene,
100
- type: n,
101
- name: t.name
102
- };
103
- if (a({
104
- type: "set-file",
105
- payload: o
106
- }), a({
107
- type: "set-file-loading",
108
- payload: !1
109
- }), i && n !== e.usdz) {
110
- let e = new Uint8Array(await t.arrayBuffer());
111
- await i.loadFromGlbBuffer(e);
112
- }
113
- return o;
114
- } catch (e) {
115
- return console.error("Error loading binary model:", e), a({
116
- type: "set-file-loading",
117
- payload: !1
118
- }), y.emit("load-error", g(e, "binary_load_failed", {
119
- fileName: t.name,
120
- fileType: n,
121
- fileSize: t.size
122
- })), null;
123
- }
124
- }, w = async (t, n, r, i, a, o) => {
125
- try {
126
- let { sourcePackageBytes: s, textureBytes: c } = await o(t, n), l = await r.loadGLTFWithAssetsToThreeJS(t, n), u = {
127
- model: l.scene,
128
- type: e.gltf,
129
- name: t.name,
130
- sourcePackageBytes: s,
131
- sourceTextureBytes: c
132
- };
133
- if (a({
134
- type: "set-file",
135
- payload: u
136
- }), a({
137
- type: "set-file-loading",
138
- payload: !1
139
- }), i) try {
140
- let e = await S(t, n);
141
- await i.loadFromServerSceneData(e);
142
- } catch (e) {
143
- console.warn("Failed to initialize optimizer from source GLTF payload; trying direct asset load.", e);
144
- try {
145
- if ("loadFromGLTFWithAssets" in i) {
146
- let e = new Uint8Array(await t.arrayBuffer()), r = /* @__PURE__ */ new Map();
147
- for (let e of n) {
148
- let t = new Uint8Array(await e.arrayBuffer());
149
- r.set(e.name, t), e.webkitRelativePath && r.set(e.webkitRelativePath, t);
150
- }
151
- await i.loadFromGLTFWithAssets(e, r);
152
- } else throw Error("loadFromGLTFWithAssets not available");
153
- } catch (e) {
154
- 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);
155
- }
156
- }
157
- return u;
158
- } catch (e) {
159
- return console.error("Error loading GLTF model:", e), console.error("GLTF file:", t.name), console.error("Asset files:", n.map((e) => e.name)), a({
160
- type: "set-file-loading",
161
- payload: !1
162
- }), y.emit("load-error", g(e, "gltf_load_failed", {
163
- fileName: t.name,
164
- fileSize: t.size,
165
- assetCount: n.length
166
- })), null;
167
- }
168
- };
169
- //#endregion
170
- //#region packages/hooks/src/use-load-model/optimizer-integration.ts
171
- function T(t, r, i, a) {
172
- let o = n(async (n, o) => {
173
- if (!t) {
174
- console.warn("Optimizer is not available");
175
- return;
176
- }
177
- try {
178
- n && await n(o);
179
- let s = await t.getModel();
180
- if (!s) {
181
- console.warn("No optimized model available after optimization");
182
- return;
183
- }
184
- let c = s instanceof Uint8Array ? s.slice() : new Uint8Array(s).slice(), l = new File([c], i?.name || "optimized_model.glb", { type: "model/gltf-binary" });
185
- r({
186
- type: "set-file",
187
- payload: {
188
- model: (await a.loadToThreeJS(l)).scene,
189
- type: e.glb,
190
- name: l.name
191
- }
192
- });
193
- } catch (e) {
194
- console.error("Optimization failed:", e);
195
- }
196
- }, [
197
- t,
198
- a,
199
- i,
200
- r
201
- ]);
202
- if (!t) return null;
203
- let s = t.isReady, c = !!i?.model && !s;
204
- return {
205
- ...t,
206
- isReady: s,
207
- isPreparing: c,
208
- applyOptimization: o,
209
- reset: t?.reset,
210
- error: t?.error,
211
- loading: t?.loading
212
- };
213
- }
214
- //#endregion
215
- //#region packages/hooks/src/use-load-model/state.ts
216
- var E = {
217
- file: null,
218
- isFileLoading: !1,
219
- progress: 0,
220
- supportedFileTypes: [
221
- e.gltf,
222
- e.glb,
223
- e.usdz
224
- ]
225
- };
226
- function D(e, t) {
227
- switch (t.type) {
228
- case "set-file": return {
229
- ...e,
230
- file: t.payload
231
- };
232
- case "set-file-loading": return {
233
- ...e,
234
- isFileLoading: t.payload
235
- };
236
- case "set-progress": return {
237
- ...e,
238
- progress: t.payload
239
- };
240
- case "reset-state": return { ...E };
241
- default: return e;
242
- }
243
- }
244
- //#endregion
245
- //#region packages/hooks/src/use-load-model/utils/read-directory.ts
246
- async function O(e) {
247
- let t = [];
248
- async function* n(e) {
249
- let t = e;
250
- for await (let [, e] of t) e.kind === "file" ? yield await e.getFile() : e.kind === "directory" && (yield* n(e));
251
- }
252
- for await (let r of n(e)) t.push(r);
253
- return t;
254
- }
255
- //#endregion
256
- //#region packages/hooks/src/use-load-model/utils/reconstruct-files.ts
257
- function k(e) {
258
- let t = [];
259
- if (e.assetData && typeof e.assetData == "object") for (let [, n] of Object.entries(e.assetData)) {
260
- let { fileName: e, mimeType: r } = n;
261
- if (e === o) continue;
262
- let i = p(n), a = new Uint8Array(i.byteLength);
263
- a.set(i);
264
- let s = new Blob([a], { type: r }), c = new File([s], e, { type: r });
265
- t.push(c);
266
- }
267
- let n = JSON.stringify(e.gltfJson), r = new Blob([n], { type: "model/gltf+json" }), i = e.meta?.name, a = i ? `${i}.gltf` : "scene.gltf";
268
- return [new File([r], a, { type: "model/gltf+json" }), ...t];
269
- }
270
- //#endregion
271
- //#region packages/hooks/src/use-load-model/utils/calculate-referenced-bytes.ts
272
- var A = (e, t) => {
273
- let n = u(e), r = n.split("/").pop() || n;
274
- for (let e of t) {
275
- let t = s(e.fileName);
276
- if (t.has(n) || t.has(r)) return e.size;
277
- }
278
- return 0;
279
- }, j = (e) => {
280
- let t = /* @__PURE__ */ new Set(), n = /* @__PURE__ */ new Set(), r = e, i = Array.isArray(r.images) ? r.images : [];
281
- for (let e of i) typeof e.uri == "string" && !e.uri.startsWith("data:") && n.add(e.uri);
282
- let a = Array.isArray(r.buffers) ? r.buffers : [];
283
- for (let e of a) typeof e.uri == "string" && !e.uri.startsWith("data:") && t.add(e.uri);
284
- return {
285
- bufferUris: t,
286
- imageUris: n
287
- };
288
- };
289
- async function M(e, t) {
290
- let n = await e.text(), r;
291
- try {
292
- r = JSON.parse(n);
293
- } catch {
294
- return {
295
- sourcePackageBytes: e.size,
296
- textureBytes: 0
297
- };
298
- }
299
- let i = t.map((e) => ({
300
- fileName: e.name,
301
- size: e.size
302
- })), { 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);
303
- return {
304
- sourcePackageBytes: e.size + s + c,
305
- textureBytes: c
306
- };
307
- }
308
- function N(e) {
309
- let t = e.gltfJson, n = Object.values(e.assetData || {}).map((e) => ({
310
- fileName: e.fileName,
311
- size: c(e.data)
312
- })), 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);
313
- return {
314
- sourcePackageBytes: r + o + s,
315
- textureBytes: s
316
- };
317
- }
318
- //#endregion
319
- //#region packages/hooks/src/use-load-model/utils/resolve-scene-payload.ts
320
- function P(e) {
321
- return typeof e == "object" && !!e && !Array.isArray(e);
322
- }
323
- function F(e) {
324
- let t = P(e.settings) ? e.settings : {}, n = d(e.camera ?? t.camera);
325
- return {
326
- ...t,
327
- bounds: e.bounds ?? t.bounds,
328
- camera: n,
329
- interactions: f(t.interactions, { camera: n }),
330
- controls: e.controls ?? t.controls,
331
- environment: e.environment ?? t.environment,
332
- shadows: e.shadows ?? t.shadows
333
- };
334
- }
335
- function I(e) {
336
- let t = /* @__PURE__ */ new Set(), n = e, r = Array.isArray(n.images) ? n.images : [];
337
- for (let e of r) typeof e.uri == "string" && !e.uri.startsWith("data:") && t.add(e.uri);
338
- let i = Array.isArray(n.buffers) ? n.buffers : [];
339
- for (let e of i) typeof e.uri == "string" && !e.uri.startsWith("data:") && t.add(e.uri);
340
- return t;
341
- }
342
- function L(e) {
343
- for (let [t, n] of Object.entries(e)) {
344
- if (!n || typeof n != "object") throw Error(`Scene payload contains invalid asset entry for ${t}`);
345
- if (typeof n.fileName != "string" || n.fileName.trim().length === 0) throw Error(`Scene payload asset ${t} is missing a valid fileName`);
346
- if (typeof n.mimeType != "string" || n.mimeType.trim().length === 0) throw Error(`Scene payload asset ${t} is missing a valid mimeType`);
347
- if (typeof n.data == "string" && n.encoding === "base64" && !l(n.data)) throw Error(`Scene payload asset ${n.fileName} has invalid base64 data`);
348
- }
349
- }
350
- function R(e, t) {
351
- let n = I(e);
352
- if (n.size === 0) return;
353
- let r = /* @__PURE__ */ new Set();
354
- for (let e of Object.values(t)) for (let t of s(e.fileName)) r.add(t);
355
- let i = [];
356
- for (let e of n) {
357
- let t = u(e), n = t.split("/").pop() || t;
358
- !r.has(e) && !r.has(t) && !r.has(n) && i.push(e);
359
- }
360
- if (i.length > 0) throw Error(`Scene payload is missing required referenced assets: ${i.slice(0, 5).join(", ")}`);
361
- }
362
- function z(e) {
363
- if (!P(e.gltfJson)) throw Error("Scene payload is missing a valid glTF document");
364
- let t = e.assetData ?? {};
365
- return L(t), R(e.gltfJson, t), {
366
- meta: e.meta,
367
- gltfJson: e.gltfJson,
368
- assetData: t,
369
- ...F(e)
370
- };
371
- }
372
- //#endregion
373
- //#region packages/hooks/src/use-load-model/use-load-model.ts
374
- function B(o) {
375
- let s = a(!1), c = a(null), [l, u] = i(D, E), d = r(() => {
376
- let e = new t();
377
- return e.onProgress((e) => {
378
- u({
379
- type: "set-progress",
380
- payload: e.progress
381
- }), e.progress !== 100 && y.emit("load-progress", e.progress);
382
- }), e;
383
- }, []), f = n((e) => {
384
- u({
385
- type: "set-progress",
386
- payload: e
387
- }), y.emit("load-progress", e);
388
- }, []), p = n(() => {
389
- u({ type: "reset-state" }), y.emit("load-reset");
390
- }, []), m = n((e, t) => e.find((e) => e.name.endsWith("." + t)), []), h = n(async (t) => {
391
- if (t.length === 0) return;
392
- let n = m(t, e.gltf), r = m(t, e.glb), i = m(t, e.usdz), a = [
393
- n,
394
- r,
395
- i
396
- ].filter(Boolean);
397
- if (a.length > 1) {
398
- y.emit("multiple-models", a);
399
- return;
400
- }
401
- let l = t.filter((e) => e !== n && e !== r && e !== i), f = () => {
402
- s.current = !0, c.current && (y.emit("load-complete", c.current), s.current = !1);
403
- };
404
- if (n) {
405
- let e = await w(n, l, d, o, u, M);
406
- e && (c.current = e), f();
407
- } else if (r) {
408
- let t = await C(r, e.glb, d, o, u);
409
- t && (c.current = t), f();
410
- } else if (i) {
411
- let t = await C(i, e.usdz, d, o, u);
412
- t && (c.current = t), f();
413
- } else y.emit("not-loaded-files", t), u({
414
- type: "set-file-loading",
415
- payload: !1
416
- });
417
- }, [
418
- m,
419
- d,
420
- o
421
- ]), g = n(async (e) => {
422
- let t = [];
423
- y.emit("load-start"), u({ type: "reset-state" }), u({
424
- type: "set-file-loading",
425
- payload: !0
426
- }), f(0), s.current = !1;
427
- for (let n of e) if (n instanceof File) t.push(n);
428
- else if ("kind" in n && n.kind === "directory") {
429
- let e = await O(n);
430
- t.push(...e);
431
- }
432
- await h(t);
433
- }, [h, f]), v = n(async (t) => {
434
- let { sceneData: n, sceneId: r } = t;
435
- f(40);
436
- let i = k(n), { sourcePackageBytes: a, textureBytes: s } = N(n);
437
- f(60);
438
- let l = i[0], p = i.slice(1), m = {
439
- model: (await d.loadGLTFWithAssetsToThreeJS(l, p)).scene,
440
- type: e.gltf,
441
- name: l.name,
442
- sourcePackageBytes: a,
443
- sourceTextureBytes: s
444
- };
445
- return u({
446
- type: "set-file",
447
- payload: m
448
- }), u({
449
- type: "set-file-loading",
450
- payload: !1
451
- }), c.current = m, o && await o.loadFromServerSceneData(n), f(100), {
452
- file: m,
453
- sceneId: r,
454
- ...n
455
- };
456
- }, [
457
- d,
458
- o,
459
- f
460
- ]), b = n(async (e) => {
461
- let { sceneId: t, serverOptions: n } = e;
462
- try {
463
- y.emit("server-load-start", t), u({ type: "reset-state" }), u({
464
- type: "set-file-loading",
465
- payload: !0
466
- }), f(0);
467
- let e = new FormData();
468
- e.append("action", "get-scene-settings"), e.append("sceneId", t);
469
- let r = n?.endpoint ?? `/api/scenes/${t}`, i = n?.apiKey ? {
470
- Authorization: `Bearer ${n.apiKey}`,
471
- ...n.headers
472
- } : { ...n?.headers }, a = await fetch(r, {
473
- method: "POST",
474
- headers: i,
475
- body: e
476
- });
477
- if (!a.ok) throw Error(`Server responded with ${a.status} ${a.statusText}`);
478
- let o = await a.json(), s = await v({
479
- sceneId: t,
480
- sceneData: z(o.data ?? o)
481
- });
482
- return y.emit("server-load-complete", s), s;
483
- } catch (e) {
484
- console.error("Server scene loading failed:", e), u({
485
- type: "set-file-loading",
486
- payload: !1
487
- });
488
- let n = _(e, t);
489
- throw y.emit("server-load-error", n), n;
490
- }
491
- }, [v, f]), x = T(o, u, l.file, d);
492
- return {
493
- ...l,
494
- on: y.on,
495
- off: y.off,
496
- load: g,
497
- loadFromData: v,
498
- loadFromServer: b,
499
- reset: p,
500
- optimizer: x
501
- };
502
- }
503
- //#endregion
504
- export { k as n, B as t };