u-space 0.0.30 → 0.0.31

package/dist/modelDecodeProtocol-D1Apm9iG.cjs

@@ -0,0 +1 @@
+"use strict";function h(n){const r=n.nodes??[];if(r.length>1e5)throw new Error(`Decoded glTF contains ${r.length} nodes; the safe limit is 100000.`);const D=new Uint8Array(r.length);for(let e=0;e<r.length;e++){const d=r[e].children??[],c=new Set;for(const o of d){if(!Number.isInteger(o)||o<0||o>=r.length)throw new Error(`Decoded glTF node ${e} references invalid child ${o}.`);if(c.has(o))throw new Error(`Decoded glTF node ${e} repeats child ${o}.`);if(c.add(o),D[o]++,D[o]>1)throw new Error(`Decoded glTF node ${o} has multiple parents.`)}}const t=new Uint8Array(r.length),E=(e,d)=>{if(d>512)throw new Error("Decoded glTF node graph exceeds the safe depth of 512.");if(t[e]===1)throw new Error(`Decoded glTF node graph contains a cycle at ${e}.`);if(t[e]!==2){t[e]=1;for(const c of r[e].children??[])E(c,d+1);t[e]=2}};for(let e=0;e<r.length;e++)E(e,1);const s=n.scene??0,l=n.scenes?.[s];if(!l)throw new Error(`Decoded glTF references missing scene ${s}.`);const i=new Set;for(const e of l.nodes??[]){if(!Number.isInteger(e)||e<0||e>=r.length)throw new Error(`Decoded glTF scene ${s} references invalid node ${e}.`);if(i.has(e))throw new Error(`Decoded glTF scene ${s} repeats root node ${e}.`);if(i.add(e),D[e]>0)throw new Error(`Decoded glTF scene root ${e} is also referenced as a child.`)}}class a extends Error{name="UnsupportedModelDecodeError";constructor(r){super(r)}}exports.MODEL_DECODE_PROTOCOL_VERSION=3;exports.UnsupportedModelDecodeError=a;exports.validateDecodedGltfNodeGraph=h;

package/dist/modelDecodeProtocol-wDB7ksYw.js

@@ -0,0 +1,56 @@
+const h = 3;
+function a(n) {
+  const r = n.nodes ?? [];
+  if (r.length > 1e5)
+    throw new Error(
+      `Decoded glTF contains ${r.length} nodes; the safe limit is 100000.`
+    );
+  const D = new Uint8Array(r.length);
+  for (let e = 0; e < r.length; e++) {
+    const c = r[e].children ?? [], d = /* @__PURE__ */ new Set();
+    for (const o of c) {
+      if (!Number.isInteger(o) || o < 0 || o >= r.length)
+        throw new Error(`Decoded glTF node ${e} references invalid child ${o}.`);
+      if (d.has(o))
+        throw new Error(`Decoded glTF node ${e} repeats child ${o}.`);
+      if (d.add(o), D[o]++, D[o] > 1)
+        throw new Error(`Decoded glTF node ${o} has multiple parents.`);
+    }
+  }
+  const t = new Uint8Array(r.length), i = (e, c) => {
+    if (c > 512)
+      throw new Error(
+        "Decoded glTF node graph exceeds the safe depth of 512."
+      );
+    if (t[e] === 1)
+      throw new Error(`Decoded glTF node graph contains a cycle at ${e}.`);
+    if (t[e] !== 2) {
+      t[e] = 1;
+      for (const d of r[e].children ?? []) i(d, c + 1);
+      t[e] = 2;
+    }
+  };
+  for (let e = 0; e < r.length; e++) i(e, 1);
+  const s = n.scene ?? 0, l = n.scenes?.[s];
+  if (!l) throw new Error(`Decoded glTF references missing scene ${s}.`);
+  const E = /* @__PURE__ */ new Set();
+  for (const e of l.nodes ?? []) {
+    if (!Number.isInteger(e) || e < 0 || e >= r.length)
+      throw new Error(`Decoded glTF scene ${s} references invalid node ${e}.`);
+    if (E.has(e))
+      throw new Error(`Decoded glTF scene ${s} repeats root node ${e}.`);
+    if (E.add(e), D[e] > 0)
+      throw new Error(`Decoded glTF scene root ${e} is also referenced as a child.`);
+  }
+}
+class f extends Error {
+  name = "UnsupportedModelDecodeError";
+  constructor(r) {
+    super(r);
+  }
+}
+export {
+  h as M,
+  f as U,
+  a as v
+};

package/dist/src/loaders/ModelDecodeWorkerClient.d.ts

@@ -0,0 +1,31 @@
+import type { LoadingManager, Object3D } from 'three/webgpu';
+import { type DecodedGltfModelPacket, type ModelDecodeRequestOptions } from '../worker/modelDecodeProtocol';
+type DecodeLoadingManager = Pick<LoadingManager, 'resolveURL' | 'itemStart' | 'itemEnd' | 'itemError'>;
+export interface ModelDecodeWorkerClientOptions {
+    onFatal?(error: ModelDecodeWorkerUnavailableError): void;
+}
+export interface ModelDecodeWorkerLoadOptions extends ModelDecodeRequestOptions {
+    signal?: AbortSignal;
+    loadingManager?: DecodeLoadingManager;
+}
+export declare class ModelDecodeWorkerUnavailableError extends Error {
+    name: string;
+    constructor(message: string, options?: ErrorOptions);
+}
+/**
+ * Reuses transferred bitmap identities so equal textures keep one batch key.
+ * The lookup is an LRU: evicting an entry drops only this client's strong
+ * reference; existing Three.js textures continue to own and use the bitmap.
+ */
+export declare function reuseDecodedImageContent(packet: DecodedGltfModelPacket, imagesByContent: Map<string, ImageBitmap>, maxEntries?: number): string[];
+/** Render-Worker side client for the acknowledged model decoder Worker. */
+export declare class ModelDecodeWorkerClient {
+    #private;
+    readonly worker: Worker;
+    constructor(worker: Worker, options?: ModelDecodeWorkerClientOptions);
+    get disposed(): boolean;
+    supports(url: string): boolean;
+    loadAsync(url: string, options?: ModelDecodeWorkerLoadOptions): Promise<Object3D>;
+    dispose(): void;
+}
+export {};

package/dist/src/loaders/ModelLoaderManager.d.ts

@@ -1,4 +1,4 @@
-import { FileLoader, type Object3D, type WebGPURenderer, type LoadingManager } from 'three/webgpu';
+import { FileLoader, LoadingManager, type Object3D, type WebGPURenderer } from 'three/webgpu';
 import { GLTFLoader } from 'three/addons/loaders/GLTFLoader.js';
 import { FBXLoader } from 'three/addons/loaders/FBXLoader.js';
 import { OBJLoader } from 'three/addons/loaders/OBJLoader.js';
@@ -10,6 +10,7 @@ import { SBMLoader } from './SBMLoader';
 import type { InteractionEventMap } from '../interactions';
 export interface LoadParameters {
     persistent?: boolean;
+    signal?: AbortSignal;
 }
 export declare class ModelLoaderManager {
     private static CACHE_NAME;
@@ -22,6 +23,15 @@ export declare class ModelLoaderManager {
     static fbxLoader: FBXLoader;
     static objLoader: OBJLoader;
     static stlLoader: STLLoader;
+    private static decodeWorkerClient;
+    /**
+     * Routes supported static glTF/GLB/SBMX models through a dedicated decoder
+     * Worker. ModelLoaderManager owns the supplied Worker and terminates it when
+     * replaced or cleared. The returned disposer only clears this specific
+     * Worker, so a late owner cleanup cannot terminate a newer replacement.
+     */
+    static setDecodeWorker(worker: Worker | null): () => void;
+    static get decodeWorkerEnabled(): boolean;
     static setLoadingManager(loadingManager: LoadingManager): void;
     /**
      * Set the renderer to enable KTX2 support and other renderer-dependent features.
@@ -36,5 +46,8 @@ export declare class ModelLoaderManager {
      */
     static setKTX2Path(path: string): void;
     static loadAsync(url: string, parameters?: LoadParameters): Promise<Object3D<InteractionEventMap>>;
-    private static getPersistentData;
+    private static configureGltfLoader;
+    private static createParseLoadingManager;
+    private static loadSourceBuffer;
+    private static throwIfAborted;
 }

package/dist/src/loaders/buildDecodedGltfModel.d.ts

@@ -0,0 +1,4 @@
+import { type Object3D } from 'three/webgpu';
+import { type DecodedGltfModelPacket } from '../worker/modelDecodeProtocol';
+/** Rebuilds a supported static glTF packet in the Worker that owns Three.js. */
+export declare function buildDecodedGltfModel(packet: DecodedGltfModelPacket): Object3D;

package/dist/src/loaders/index.d.ts

@@ -1,4 +1,5 @@
 export * from './ModelLoaderManager';
+export * from './ModelDecodeWorkerClient';
 export * from './TextureLoaderManager';
 export * from './SBMLoader';
 export * from './SBMXLoader';

package/dist/src/objects/Model.d.ts

@@ -5,6 +5,7 @@ export interface ModelParameters {
     url: string;
     cache?: boolean;
     persistent?: boolean;
+    signal?: AbortSignal;
 }
 export interface PlayAnimationOptions {
     loop?: boolean;

package/dist/src/worker/decodeGltfModel.d.ts

@@ -0,0 +1,10 @@
+import { type DecodedGltfModelPacket, type ModelDecodeRequestOptions } from './modelDecodeProtocol';
+export interface ModelDecodeResourceHandle {
+    url: string;
+    complete(error?: unknown): void;
+}
+export interface ModelDecodeResourceResolver {
+    resolve(url: string, signal: AbortSignal): Promise<ModelDecodeResourceHandle>;
+}
+export declare function decodeGltfModelPacket(url: string, source: ArrayBuffer, options?: ModelDecodeRequestOptions, signal?: AbortSignal, resourceResolver?: ModelDecodeResourceResolver): Promise<DecodedGltfModelPacket>;
+export declare function loadGltfModelPacket(url: string, options?: ModelDecodeRequestOptions, signal?: AbortSignal, resourceResolver?: ModelDecodeResourceResolver): Promise<DecodedGltfModelPacket>;

package/dist/src/worker/getTransferables.d.ts

@@ -0,0 +1 @@
+export declare function getTransferables(value: unknown): Transferable[];

package/dist/src/worker/index.d.ts

@@ -1,2 +1,3 @@
 export * from './protocol';
 export * from './OffscreenViewerHost';
+export * from './getTransferables';

package/dist/src/worker/installWorkerImageLoader.d.ts

@@ -1,5 +1,8 @@
+export { clampWorkerImageDimensions, createWorkerImageBitmap } from './workerImageUtils';
 /**
  * Makes Three.js TextureLoader/CubeTextureLoader usable in a Worker by loading
  * images with fetch() and createImageBitmap() instead of document.createElement('img').
+ * Images larger than WebGPU's portable 8192px limit are downscaled before
+ * decoding so they cannot invalidate the device's texture bindings.
  */
 export declare function installWorkerImageLoader(): void;

package/dist/src/worker/model-decoder.d.ts

@@ -0,0 +1,13 @@
+import { type ModelDecodeWorkerRequest, type ModelDecodeWorkerResponse } from './modelDecodeProtocol';
+export * from './modelDecodeProtocol';
+interface DecodeWorkerScope {
+    addEventListener(type: 'message', listener: (event: MessageEvent<ModelDecodeWorkerRequest>) => void): void;
+    postMessage(message: ModelDecodeWorkerResponse, transfer?: Transferable[]): void;
+    close(): void;
+}
+/**
+ * Installs a serial, acknowledged static glTF/SBMX decoder in the current
+ * dedicated Worker. Only one decoded packet may be in flight at a time so a
+ * large scene cannot fill the render Worker's message queue with model data.
+ */
+export declare function installModelDecodeWorker(scope?: DecodeWorkerScope): void;

package/dist/src/worker/modelDecodeProtocol.d.ts

@@ -0,0 +1,205 @@
+export declare const MODEL_DECODE_PROTOCOL_VERSION: 3;
+export interface SerializedModelDecodeError {
+    message: string;
+    name?: string;
+    stack?: string;
+}
+export interface ModelDecodeRequestOptions {
+    persistent?: boolean;
+    headers?: Record<string, string>;
+    credentials?: RequestCredentials;
+    /** Original absolute model URL used to resolve relative glTF dependencies. */
+    resourceBaseUrl?: string;
+}
+export interface GltfBufferDefinition {
+    byteLength: number;
+    uri?: string;
+    name?: string;
+}
+export interface GltfBufferViewDefinition {
+    buffer: number;
+    byteOffset?: number;
+    byteLength: number;
+    byteStride?: number;
+    target?: number;
+    name?: string;
+    extensions?: Record<string, unknown>;
+}
+export interface GltfAccessorDefinition {
+    bufferView?: number;
+    byteOffset?: number;
+    componentType: number;
+    normalized?: boolean;
+    count: number;
+    type: string;
+    min?: number[];
+    max?: number[];
+    sparse?: unknown;
+    name?: string;
+}
+export interface GltfTextureInfo {
+    index: number;
+    texCoord?: number;
+    scale?: number;
+    strength?: number;
+    extensions?: Record<string, unknown>;
+}
+export interface GltfMaterialDefinition {
+    name?: string;
+    pbrMetallicRoughness?: {
+        baseColorFactor?: number[];
+        baseColorTexture?: GltfTextureInfo;
+        metallicFactor?: number;
+        roughnessFactor?: number;
+        metallicRoughnessTexture?: GltfTextureInfo;
+    };
+    normalTexture?: GltfTextureInfo;
+    occlusionTexture?: GltfTextureInfo;
+    emissiveTexture?: GltfTextureInfo;
+    emissiveFactor?: number[];
+    alphaMode?: 'OPAQUE' | 'MASK' | 'BLEND';
+    alphaCutoff?: number;
+    doubleSided?: boolean;
+    extras?: unknown;
+    extensions?: Record<string, unknown>;
+}
+export interface GltfPrimitiveDefinition {
+    attributes: Record<string, number>;
+    indices?: number;
+    material?: number;
+    mode?: number;
+    targets?: unknown[];
+    extensions?: Record<string, unknown>;
+}
+export interface GltfMeshDefinition {
+    name?: string;
+    primitives: GltfPrimitiveDefinition[];
+    extras?: unknown;
+}
+export interface GltfNodeDefinition {
+    name?: string;
+    mesh?: number;
+    camera?: number;
+    children?: number[];
+    matrix?: number[];
+    translation?: number[];
+    rotation?: number[];
+    scale?: number[];
+    weights?: number[];
+    skin?: number;
+    extras?: unknown;
+    extensions?: Record<string, unknown>;
+}
+export interface GltfSceneDefinition {
+    name?: string;
+    nodes?: number[];
+    extras?: unknown;
+}
+export interface GltfImageDefinition {
+    name?: string;
+    uri?: string;
+    mimeType?: string;
+    bufferView?: number;
+}
+export interface GltfSamplerDefinition {
+    name?: string;
+    magFilter?: number;
+    minFilter?: number;
+    wrapS?: number;
+    wrapT?: number;
+}
+export interface GltfTextureDefinition {
+    name?: string;
+    sampler?: number;
+    source?: number;
+    extensions?: Record<string, unknown>;
+}
+export interface GltfDocument {
+    asset: {
+        version: string;
+        generator?: string;
+    };
+    scene?: number;
+    scenes?: GltfSceneDefinition[];
+    nodes?: GltfNodeDefinition[];
+    meshes?: GltfMeshDefinition[];
+    accessors?: GltfAccessorDefinition[];
+    bufferViews?: GltfBufferViewDefinition[];
+    buffers?: GltfBufferDefinition[];
+    materials?: GltfMaterialDefinition[];
+    textures?: GltfTextureDefinition[];
+    samplers?: GltfSamplerDefinition[];
+    images?: GltfImageDefinition[];
+    animations?: unknown[];
+    skins?: unknown[];
+    cameras?: unknown[];
+    extensionsUsed?: string[];
+    extensionsRequired?: string[];
+    extensions?: Record<string, unknown>;
+}
+export interface DecodedGltfModelPacket {
+    protocolVersion: typeof MODEL_DECODE_PROTOCOL_VERSION;
+    kind: 'gltf-static';
+    url: string;
+    document: GltfDocument;
+    buffers: ArrayBuffer[];
+    images: ImageBitmap[];
+    /** Stable content identities used to preserve material batching across models. */
+    imageKeys: string[];
+}
+/**
+ * Validates the parts of the glTF node graph that would otherwise make
+ * recursive Object3D reconstruction unsafe. glTF nodes form a forest: a node
+ * cannot be repeated under one parent, have multiple parents, or form cycles.
+ */
+export declare function validateDecodedGltfNodeGraph(document: GltfDocument): void;
+export type ModelDecodeWorkerRequest = {
+    type: 'decode';
+    id: number;
+    url: string;
+    options: ModelDecodeRequestOptions;
+} | {
+    type: 'cancel';
+    id: number;
+} | {
+    type: 'ack';
+    id: number;
+} | {
+    type: 'resource-resolved';
+    id: number;
+    resourceId: number;
+    url?: string;
+    error?: SerializedModelDecodeError;
+} | {
+    type: 'dispose';
+};
+export type ModelDecodeWorkerResponse = {
+    type: 'decoded';
+    id: number;
+    packet: DecodedGltfModelPacket;
+} | {
+    type: 'unsupported';
+    id: number;
+    reason: string;
+} | {
+    type: 'error';
+    id: number;
+    error: SerializedModelDecodeError;
+} | {
+    type: 'resolve-resource';
+    id: number;
+    resourceId: number;
+    url: string;
+} | {
+    type: 'resource-complete';
+    id: number;
+    resourceId: number;
+    ok: boolean;
+    error?: SerializedModelDecodeError;
+} | {
+    type: 'disposed';
+};
+export declare class UnsupportedModelDecodeError extends Error {
+    name: string;
+    constructor(message: string);
+}

package/dist/src/worker/workerImageUtils.d.ts

@@ -0,0 +1,8 @@
+interface ImageDimensions {
+    width: number;
+    height: number;
+}
+export declare const MAX_WORKER_TEXTURE_DIMENSION_2D = 8192;
+export declare function clampWorkerImageDimensions(width: number, height: number, maxDimension?: number): ImageDimensions | null;
+export declare function createWorkerImageBitmap(blob: Blob, options?: ImageBitmapOptions): Promise<ImageBitmap>;
+export {};

package/dist/worker/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const p=require("../protocol-IUAzx0lk.cjs"),n=["click","dblclick","contextmenu","pointerdown","pointerup","pointermove","pointercancel","wheel"];function a(i){const e=i,t=i,s=i;return{type:i.type,pointerId:t.pointerId,pointerType:t.pointerType,button:e.button,buttons:e.buttons,altKey:e.altKey,ctrlKey:e.ctrlKey,metaKey:e.metaKey,shiftKey:e.shiftKey,movementX:e.movementX,movementY:e.movementY,clientX:e.clientX,clientY:e.clientY,offsetX:e.offsetX,offsetY:e.offsetY,pageX:e.pageX,pageY:e.pageY,screenX:e.screenX,screenY:e.screenY,deltaX:s.deltaX,deltaY:s.deltaY,deltaZ:s.deltaZ,deltaMode:s.deltaMode}}function o(i){const e=new Error(i.message);return e.name=i.name??"WorkerError",i.stack&&(e.stack=i.stack),e}class r extends EventTarget{el;worker;canvas;#u;#f;#r=null;#i=new Map;#b=0;#t=!1;#e=!1;#n=null;#o=null;#a=null;#h=new Map;#s=0;#p=0;constructor(e){super(),this.el=e.el,this.worker=e.worker,this.canvas=e.canvas??document.createElement("canvas"),this.#u=e.pixelRatio,this.#f=e.terminateWorkerOnDispose??!0,this.canvas.style.width="100%",this.canvas.style.height="100%",this.canvas.style.display="block",this.canvas.style.touchAction="none",this.canvas.parentElement||this.el.appendChild(this.canvas)}static isSupported(){return typeof Worker<"u"&&typeof OffscreenCanvas<"u"&&typeof HTMLCanvasElement<"u"&&"transferControlToOffscreen"in HTMLCanvasElement.prototype}init(){if(this.#n)return this.#n;if(this.#e)return Promise.reject(new Error("OffscreenViewerHost has been disposed."));if(!r.isSupported())return Promise.reject(new Error("This browser does not support transferring a canvas to a Worker."));this.#n=new Promise((e,t)=>{this.#o=e,this.#a=t}),this.worker.addEventListener("message",this.#y),this.worker.addEventListener("error",this.#k),this.#z(),this.#C();try{const e=this.canvas.transferControlToOffscreen(),t={type:"init",canvas:e,size:this.#v()};this.worker.postMessage(t,[e])}catch(e){const t=e instanceof Error?e:new Error(String(e));this.#d(t),this.#l()}return this.#n}request(e,t){if(this.#e)return Promise.reject(new Error("OffscreenViewerHost has been disposed."));if(!this.#t)return Promise.reject(new Error("The Worker viewer has not initialized yet."));const s=++this.#b,h={type:"request",id:s,command:e,payload:t};return this.worker.postMessage(h),new Promise((c,l)=>{this.#i.set(s,{resolve:d=>c(d),reject:l})})}dispose(){const e=new Error("OffscreenViewerHost has been disposed.");if(!this.#d(e))return;const t={type:"dispose"};this.worker.postMessage(t),this.#p=window.setTimeout(this.#l,1e3)}#z(){for(const e of n)this.canvas.addEventListener(e,this.#m,{passive:e!=="wheel"&&e!=="contextmenu"})}#M(){for(const e of n)this.canvas.removeEventListener(e,this.#m)}#C(){this.#r=new ResizeObserver(this.#c),this.#r.observe(this.el),window.addEventListener("resize",this.#c)}#v(){const e=this.canvas.getBoundingClientRect();return{width:Math.max(1,e.width||this.el.clientWidth),height:Math.max(1,e.height||this.el.clientHeight),top:e.top,left:e.left,pixelRatio:this.#u??Math.min(window.devicePixelRatio,1.5)}}#c=()=>{if(!this.#t||this.#e)return;const e={type:"resize",size:this.#v()};this.worker.postMessage(e)};#m=e=>{(e.type==="wheel"||e.type==="contextmenu")&&e.preventDefault();const t=e;if(e.type==="pointerdown")try{this.canvas.setPointerCapture(t.pointerId)}catch{}if(e.type==="pointerup"||e.type==="pointercancel"){this.#w();try{this.canvas.hasPointerCapture(t.pointerId)&&this.canvas.releasePointerCapture(t.pointerId)}catch{}}const s=a(e);if(e.type==="pointermove"){this.#h.set(s.pointerId??-1,s),this.#s||(this.#s=requestAnimationFrame(this.#w));return}this.#E(s)};#w=()=>{this.#s=0;for(const e of this.#h.values())this.#E(e);this.#h.clear()};#E(e){if(!this.#t||this.#e)return;const t={type:"dom-event",event:e};this.worker.postMessage(t)}#y=e=>{const t=e.data;if(!(this.#e&&t.type!=="error"&&t.type!=="disposed"))switch(t.type){case"initialized":if(this.#e)break;this.#t=!0,this.#o?.(),this.#o=null,this.#a=null,this.#c(),this.dispatchEvent(new Event("initialized"));break;case"ready":this.dispatchEvent(new CustomEvent("ready",{detail:t.detail}));break;case"status":this.dispatchEvent(new CustomEvent("status",{detail:t.message}));break;case"stats":this.dispatchEvent(new CustomEvent("stats",{detail:t.stats}));break;case"event":this.dispatchEvent(new CustomEvent(t.eventType,{detail:t.detail}));break;case"response":{const s=this.#i.get(t.id);if(!s)break;this.#i.delete(t.id),t.error?s.reject(o(t.error)):s.resolve(t.result);break}case"error":{const s=o(t.error);this.#t||this.#g(s),this.dispatchEvent(new CustomEvent("error",{detail:s}));break}case"disposed":this.#d(new Error("The Worker viewer has been disposed.")),this.dispatchEvent(new Event("disposed")),this.#l();break}};#k=e=>{const t=e.error instanceof Error?e.error:new Error(e.message);this.#d(t),this.dispatchEvent(new CustomEvent("error",{detail:t})),this.#l()};#l=()=>{window.clearTimeout(this.#p),this.#p=0,this.worker.removeEventListener("message",this.#y),this.worker.removeEventListener("error",this.#k),this.#f&&this.worker.terminate()};#d(e){if(this.#e)return!1;this.#e=!0,this.#s&&cancelAnimationFrame(this.#s),this.#s=0,this.#h.clear(),this.#r?.disconnect(),this.#r=null,window.removeEventListener("resize",this.#c),this.#M(),this.#t||this.#g(e);for(const t of this.#i.values())t.reject(e);return this.#i.clear(),this.canvas.remove(),!0}#g(e){this.#a?.(e),this.#o=null,this.#a=null}}exports.serializeError=p.serializeError;exports.OffscreenViewerHost=r;exports.serializeDomEvent=a;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const p=require("../protocol-IUAzx0lk.cjs"),u=require("../getTransferables-C97JPUVf.cjs"),n=["click","dblclick","contextmenu","pointerdown","pointerup","pointermove","pointercancel","wheel"];function a(i){const e=i,t=i,s=i;return{type:i.type,pointerId:t.pointerId,pointerType:t.pointerType,button:e.button,buttons:e.buttons,altKey:e.altKey,ctrlKey:e.ctrlKey,metaKey:e.metaKey,shiftKey:e.shiftKey,movementX:e.movementX,movementY:e.movementY,clientX:e.clientX,clientY:e.clientY,offsetX:e.offsetX,offsetY:e.offsetY,pageX:e.pageX,pageY:e.pageY,screenX:e.screenX,screenY:e.screenY,deltaX:s.deltaX,deltaY:s.deltaY,deltaZ:s.deltaZ,deltaMode:s.deltaMode}}function o(i){const e=new Error(i.message);return e.name=i.name??"WorkerError",i.stack&&(e.stack=i.stack),e}class r extends EventTarget{el;worker;canvas;#u;#f;#r=null;#i=new Map;#b=0;#t=!1;#e=!1;#n=null;#o=null;#a=null;#h=new Map;#s=0;#p=0;constructor(e){super(),this.el=e.el,this.worker=e.worker,this.canvas=e.canvas??document.createElement("canvas"),this.#u=e.pixelRatio,this.#f=e.terminateWorkerOnDispose??!0,this.canvas.style.width="100%",this.canvas.style.height="100%",this.canvas.style.display="block",this.canvas.style.touchAction="none",this.canvas.parentElement||this.el.appendChild(this.canvas)}static isSupported(){return typeof Worker<"u"&&typeof OffscreenCanvas<"u"&&typeof HTMLCanvasElement<"u"&&"transferControlToOffscreen"in HTMLCanvasElement.prototype}init(){if(this.#n)return this.#n;if(this.#e)return Promise.reject(new Error("OffscreenViewerHost has been disposed."));if(!r.isSupported())return Promise.reject(new Error("This browser does not support transferring a canvas to a Worker."));this.#n=new Promise((e,t)=>{this.#o=e,this.#a=t}),this.worker.addEventListener("message",this.#y),this.worker.addEventListener("error",this.#g),this.#z(),this.#T();try{const e=this.canvas.transferControlToOffscreen(),t={type:"init",canvas:e,size:this.#v()};this.worker.postMessage(t,[e])}catch(e){const t=e instanceof Error?e:new Error(String(e));this.#d(t),this.#l()}return this.#n}request(e,t){if(this.#e)return Promise.reject(new Error("OffscreenViewerHost has been disposed."));if(!this.#t)return Promise.reject(new Error("The Worker viewer has not initialized yet."));const s=++this.#b,h={type:"request",id:s,command:e,payload:t};return this.worker.postMessage(h),new Promise((c,l)=>{this.#i.set(s,{resolve:d=>c(d),reject:l})})}dispose(){const e=new Error("OffscreenViewerHost has been disposed.");if(!this.#d(e))return;const t={type:"dispose"};this.worker.postMessage(t),this.#p=window.setTimeout(this.#l,1e3)}#z(){for(const e of n)this.canvas.addEventListener(e,this.#m,{passive:e!=="wheel"&&e!=="contextmenu"})}#M(){for(const e of n)this.canvas.removeEventListener(e,this.#m)}#T(){this.#r=new ResizeObserver(this.#c),this.#r.observe(this.el),window.addEventListener("resize",this.#c)}#v(){const e=this.canvas.getBoundingClientRect();return{width:Math.max(1,e.width||this.el.clientWidth),height:Math.max(1,e.height||this.el.clientHeight),top:e.top,left:e.left,pixelRatio:this.#u??Math.min(window.devicePixelRatio,1.5)}}#c=()=>{if(!this.#t||this.#e)return;const e={type:"resize",size:this.#v()};this.worker.postMessage(e)};#m=e=>{(e.type==="wheel"||e.type==="contextmenu")&&e.preventDefault();const t=e;if(e.type==="pointerdown")try{this.canvas.setPointerCapture(t.pointerId)}catch{}if(e.type==="pointerup"||e.type==="pointercancel"){this.#w();try{this.canvas.hasPointerCapture(t.pointerId)&&this.canvas.releasePointerCapture(t.pointerId)}catch{}}const s=a(e);if(e.type==="pointermove"){this.#h.set(s.pointerId??-1,s),this.#s||(this.#s=requestAnimationFrame(this.#w));return}this.#E(s)};#w=()=>{this.#s=0;for(const e of this.#h.values())this.#E(e);this.#h.clear()};#E(e){if(!this.#t||this.#e)return;const t={type:"dom-event",event:e};this.worker.postMessage(t)}#y=e=>{const t=e.data;if(!(this.#e&&t.type!=="error"&&t.type!=="disposed"))switch(t.type){case"initialized":if(this.#e)break;this.#t=!0,this.#o?.(),this.#o=null,this.#a=null,this.#c(),this.dispatchEvent(new Event("initialized"));break;case"ready":this.dispatchEvent(new CustomEvent("ready",{detail:t.detail}));break;case"status":this.dispatchEvent(new CustomEvent("status",{detail:t.message}));break;case"stats":this.dispatchEvent(new CustomEvent("stats",{detail:t.stats}));break;case"event":this.dispatchEvent(new CustomEvent(t.eventType,{detail:t.detail}));break;case"response":{const s=this.#i.get(t.id);if(!s)break;this.#i.delete(t.id),t.error?s.reject(o(t.error)):s.resolve(t.result);break}case"error":{const s=o(t.error);this.#t||this.#k(s),this.dispatchEvent(new CustomEvent("error",{detail:s}));break}case"disposed":this.#d(new Error("The Worker viewer has been disposed.")),this.dispatchEvent(new Event("disposed")),this.#l();break}};#g=e=>{const t=e.error instanceof Error?e.error:new Error(e.message);this.#d(t),this.dispatchEvent(new CustomEvent("error",{detail:t})),this.#l()};#l=()=>{window.clearTimeout(this.#p),this.#p=0,this.worker.removeEventListener("message",this.#y),this.worker.removeEventListener("error",this.#g),this.#f&&this.worker.terminate()};#d(e){if(this.#e)return!1;this.#e=!0,this.#s&&cancelAnimationFrame(this.#s),this.#s=0,this.#h.clear(),this.#r?.disconnect(),this.#r=null,window.removeEventListener("resize",this.#c),this.#M(),this.#t||this.#k(e);for(const t of this.#i.values())t.reject(e);return this.#i.clear(),this.canvas.remove(),!0}#k(e){this.#a?.(e),this.#o=null,this.#a=null}}exports.serializeError=p.serializeError;exports.getTransferables=u.getTransferables;exports.OffscreenViewerHost=r;exports.serializeDomEvent=a;

package/dist/worker/index.js

@@ -1,4 +1,5 @@
-import { s as f } from "../protocol-C-OMPz15.js";
+import { s as u } from "../protocol-C-OMPz15.js";
+import { g as m } from "../getTransferables-DrzSmiCR.js";
 const r = [
   "click",
   "dblclick",
@@ -45,8 +46,8 @@ class o extends EventTarget {
   el;
   worker;
   canvas;
-  #u;
   #f;
+  #u;
   #r = null;
   #i = /* @__PURE__ */ new Map();
   #b = 0;
@@ -59,7 +60,7 @@ class o extends EventTarget {
   #s = 0;
   #p = 0;
   constructor(e) {
-    super(), this.el = e.el, this.worker = e.worker, this.canvas = e.canvas ?? document.createElement("canvas"), this.#u = e.pixelRatio, this.#f = e.terminateWorkerOnDispose ?? !0, this.canvas.style.width = "100%", this.canvas.style.height = "100%", this.canvas.style.display = "block", this.canvas.style.touchAction = "none", this.canvas.parentElement || this.el.appendChild(this.canvas);
+    super(), this.el = e.el, this.worker = e.worker, this.canvas = e.canvas ?? document.createElement("canvas"), this.#f = e.pixelRatio, this.#u = e.terminateWorkerOnDispose ?? !0, this.canvas.style.width = "100%", this.canvas.style.height = "100%", this.canvas.style.display = "block", this.canvas.style.touchAction = "none", this.canvas.parentElement || this.el.appendChild(this.canvas);
   }
   static isSupported() {
     return typeof Worker < "u" && typeof OffscreenCanvas < "u" && typeof HTMLCanvasElement < "u" && "transferControlToOffscreen" in HTMLCanvasElement.prototype;
@@ -124,7 +125,7 @@ class o extends EventTarget {
       height: Math.max(1, e.height || this.el.clientHeight),
       top: e.top,
       left: e.left,
-      pixelRatio: this.#u ?? Math.min(window.devicePixelRatio, 1.5)
+      pixelRatio: this.#f ?? Math.min(window.devicePixelRatio, 1.5)
     };
   }
   #c = () => {
@@ -205,7 +206,7 @@ class o extends EventTarget {
     this.#d(t), this.dispatchEvent(new CustomEvent("error", { detail: t })), this.#l();
   };
   #l = () => {
-    window.clearTimeout(this.#p), this.#p = 0, this.worker.removeEventListener("message", this.#y), this.worker.removeEventListener("error", this.#k), this.#f && this.worker.terminate();
+    window.clearTimeout(this.#p), this.#p = 0, this.worker.removeEventListener("message", this.#y), this.worker.removeEventListener("error", this.#k), this.#u && this.worker.terminate();
   };
   #d(e) {
     if (this.#e) return !1;
@@ -219,6 +220,7 @@ class o extends EventTarget {
 }
 export {
   o as OffscreenViewerHost,
+  m as getTransferables,
   d as serializeDomEvent,
-  f as serializeError
+  u as serializeError
 };

package/dist/worker/model-decoder.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const T=require("../getTransferables-C97JPUVf.cjs"),A=require("../workerImageUtils-lmOMyTQN.cjs"),w=require("../modelDecodeProtocol-D1Apm9iG.cjs"),D="u-space-model-loader-cache",S="SBMG----",F=1179937895,C=1313821514,U=5130562,k=new TextDecoder;function g(e){throw new w.UnsupportedModelDecodeError(e)}async function v(e,r,s,o=e,i=!1){const n=e.startsWith("data:")||e.startsWith("blob:");let l=!i;if(i&&!n)try{const u=new URL(e),c=new URL(o);l=(u.protocol==="http:"||u.protocol==="https:")&&u.origin===c.origin}catch{l=!1}const h=await fetch(e,n?{signal:s}:{signal:s,headers:l?r.headers:void 0,credentials:l?r.credentials:"omit"});if(!h.ok)throw new Error(`Failed to load model resource ${e}: ${h.status} ${h.statusText}`);return h}async function M(e,r,s,o,i,n,l){const h=$(e,r),u=n?await n.resolve(h,i):{url:h,complete(){}};try{const c=await v(u.url,o,i,s,!0),t=await l(c);return u.complete(),t}catch(c){throw u.complete(c),c}}async function B(e,r,s){if(r.persistent!==!1&&typeof caches<"u"){let o;try{o=await caches.open(D);const n=await o.match(e);if(n)return n.arrayBuffer()}catch(n){if(s.aborted)throw n;console.warn(`[ModelDecodeWorker] Failed to read Cache Storage for ${e}:`,n)}const i=await v(e,r,s);if(o)try{await o.put(e,i.clone())}catch(n){if(s.aborted)throw n;console.warn(`[ModelDecodeWorker] Failed to write Cache Storage for ${e}:`,n)}return i.arrayBuffer()}return(await v(e,r,s)).arrayBuffer()}function R(e){if(e.byteLength<8||k.decode(new Uint8Array(e,0,8))!==S)return e;const s=new Uint8Array(e.byteLength-8),o=new Uint8Array(e,8);for(let i=0;i<o.length;i++){const n=o[i];s[i]=n>>4&15|n<<4&240}return s.buffer}function G(e){const r=new DataView(e);if(e.byteLength>=12&&r.getUint32(0,!0)===F){const s=r.getUint32(8,!0);if(s>e.byteLength)throw new Error(`Invalid GLB length: expected ${s}, received ${e.byteLength}.`);let o=12,i;const n=[];for(;o+8<=s;){const l=r.getUint32(o,!0),h=r.getUint32(o+4,!0);if(o+=8,o+l>s)throw new Error("Invalid GLB chunk length.");const u=e.slice(o,o+l);h===C?i=JSON.parse(k.decode(u).replace(/\u0000+$/u,"")):h===U&&n.push(u),o+=l}if(!i)throw new Error("GLB does not contain a JSON chunk.");return{document:i,binaryChunks:n}}return{document:JSON.parse(k.decode(e).replace(/^\uFEFF/u,"")),binaryChunks:[]}}function V(e){e.asset?.version?.startsWith("2")||g("Only glTF 2.x static models are supported by the decode worker."),(e.extensionsRequired?.length||e.extensionsUsed?.length)&&g("glTF extensions are not supported by the decode worker."),e.animations?.length&&g("Animated glTF models must use the regular loader."),e.skins?.length&&g("Skinned glTF models must use the regular loader."),e.cameras?.length&&g("glTF cameras must use the regular loader."),w.validateDecodedGltfNodeGraph(e);for(const r of e.accessors??[])r.sparse&&g("Sparse glTF accessors must use the regular loader."),r.bufferView===void 0&&g("Accessors without a bufferView must use the regular loader."),["SCALAR","VEC2","VEC3","VEC4"].includes(r.type)||g(`Accessor type ${r.type} must use the regular loader.`),[5120,5121,5122,5123,5125,5126].includes(r.componentType)||g(`Accessor component type ${r.componentType} must use the regular loader.`);for(const r of e.bufferViews??[])r.extensions&&Object.keys(r.extensions).length>0&&g("Compressed glTF buffer views must use the regular loader.");for(const r of e.nodes??[])(r.skin!==void 0||r.weights?.length||r.camera!==void 0)&&g("Skinned, morphed, or camera glTF nodes must use the regular loader."),r.extensions&&Object.keys(r.extensions).length>0&&g("Extended glTF nodes must use the regular loader.");for(const r of e.meshes??[])for(const s of r.primitives)(s.mode??4)!==4&&g("Only triangle glTF primitives are supported."),s.targets?.length&&g("Morph targets must use the regular loader."),s.extensions&&Object.keys(s.extensions).length>0&&g("Extended glTF primitives must use the regular loader.");for(const r of e.materials??[])r.extensions&&Object.keys(r.extensions).length>0&&g("Extended glTF materials must use the regular loader.");for(const r of e.textures??[])r.extensions&&Object.keys(r.extensions).length>0&&g("Extended glTF textures must use the regular loader.")}function $(e,r){return e.startsWith("data:")||e.startsWith("blob:")?e:new URL(e,r).href}async function _(e,r,s,o,i,n,l){const h=[...r],u=[];for(const c of e.buffers??[]){let t;if(c.uri)t=await M(c.uri,s,o,i,n,l,a=>a.arrayBuffer());else{const a=h.shift();if(!a)throw new Error("glTF buffer is missing its GLB binary chunk.");t=a}if(t.byteLength<c.byteLength)throw new Error(`glTF buffer is truncated: expected ${c.byteLength}, received ${t.byteLength}.`);u.push(t),Reflect.deleteProperty(c,"uri")}return u}function I(e,r,s,o){const i=e.bufferViews?.[s];if(!i)throw new Error(`glTF image references missing bufferView ${s}.`);const n=r[i.buffer];if(!n)throw new Error(`glTF image references missing buffer ${i.buffer}.`);const l=i.byteOffset??0;return new Blob([new Uint8Array(n,l,i.byteLength)],{type:o??"application/octet-stream"})}async function N(e,r,s,o,i,n,l){const h=[],u=[];try{for(const c of e.images??[]){let t;if(c.uri)t=await M(c.uri,s,o,i,n,l,f=>f.blob());else if(c.bufferView!==void 0)t=I(e,r,c.bufferView,c.mimeType);else throw new Error("glTF image is missing both uri and bufferView.");if(n.aborted)throw n.reason??new DOMException("Aborted","AbortError");const a=await globalThis.crypto.subtle.digest("SHA-256",await t.arrayBuffer());if(n.aborted)throw n.reason??new DOMException("Aborted","AbortError");const d=Array.from(new Uint8Array(a),f=>f.toString(16).padStart(2,"0")).join("");u.push(`${t.type}:${t.size}:${d}`),h.push(await A.createWorkerImageBitmap(t,{imageOrientation:"flipY"})),Reflect.deleteProperty(c,"uri")}return{images:h,imageKeys:u}}catch(c){throw h.forEach(t=>t.close()),c}}async function P(e,r,s={},o=new AbortController().signal,i){const n=R(r),{document:l,binaryChunks:h}=G(n);V(l);const u=s.resourceBaseUrl??e,c=await _(l,h,u,e,s,o,i),{images:t,imageKeys:a}=await N(l,c,u,e,s,o,i);return{protocolVersion:w.MODEL_DECODE_PROTOCOL_VERSION,kind:"gltf-static",url:e,document:l,buffers:c,images:t,imageKeys:a}}async function W(e,r={},s=new AbortController().signal,o){const i=await B(e,r,s);return P(e,i,r,s,o)}function L(e){return e instanceof Error?{message:e.message,name:e.name,stack:e.stack}:{message:String(e)}}function j(e=globalThis){const r=[],s=new Set;let o=null,i=!1,n=!1;const l=t=>new Promise(a=>{t.acknowledge=a}),h=(t,a)=>{for(const d of t.resources.values())d.cleanup(),d.reject(a);t.resources.clear()},u=t=>({async resolve(a,d){if(d.aborted)throw d.reason??new DOMException("Aborted","AbortError");const f=t.nextResourceId++,m=await new Promise((y,E)=>{const x=()=>{t.resources.delete(f),E(d.reason??new DOMException("Aborted","AbortError"))},b=()=>d.removeEventListener("abort",x);t.resources.set(f,{resolve(p){b(),t.resources.delete(f),y(p)},reject(p){b(),t.resources.delete(f),E(p)},cleanup:b}),d.addEventListener("abort",x,{once:!0});try{e.postMessage({type:"resolve-resource",id:t.id,resourceId:f,url:a})}catch(p){b(),t.resources.delete(f),E(p instanceof Error?p:new Error(String(p)))}});let O=!1;return{url:m,complete(y){O||(O=!0,e.postMessage({type:"resource-complete",id:t.id,resourceId:f,ok:y===void 0,error:y===void 0?void 0:L(y)}))}}}}),c=async()=>{if(!(i||n)){i=!0;try{for(;!n&&r.length>0;){const t=r.shift();if(s.delete(t.id))continue;const a={id:t.id,controller:new AbortController,nextResourceId:1,resources:new Map};o=a;try{const d=await W(t.url,t.options,a.controller.signal,u(a));if(s.delete(t.id)||n){d.images.forEach(f=>f.close());continue}try{e.postMessage({type:"decoded",id:t.id,packet:d},T.getTransferables(d))}catch(f){throw d.images.forEach(m=>m.close()),f}await l(a)}catch(d){const f=s.delete(t.id);if(a.controller.signal.aborted||f||n)continue;d instanceof w.UnsupportedModelDecodeError?e.postMessage({type:"unsupported",id:t.id,reason:d.message}):e.postMessage({type:"error",id:t.id,error:L(d)})}finally{h(a,new DOMException("Model decode request ended.","AbortError")),s.delete(t.id),o===a&&(o=null)}}}finally{i=!1,!n&&r.length>0&&c()}}};e.addEventListener("message",t=>{const a=t.data;if(a.type==="decode"){if(n)return;r.push(a),c();return}if(a.type==="cancel"){s.add(a.id),o?.id===a.id&&(o.controller.abort(),o.acknowledge?.());return}if(a.type==="ack"){o?.id===a.id&&o.acknowledge?.();return}if(a.type==="resource-resolved"){if(o?.id!==a.id)return;const d=o.resources.get(a.resourceId);if(!d)return;if(a.url!==void 0)d.resolve(a.url);else{const f=new Error(a.error?.message??"Failed to resolve model resource URL.");f.name=a.error?.name??"Error",f.stack=a.error?.stack,d.reject(f)}return}a.type==="dispose"&&(n=!0,r.length=0,o?.controller.abort(),o?.acknowledge?.(),e.postMessage({type:"disposed"}),e.close())})}exports.MODEL_DECODE_PROTOCOL_VERSION=w.MODEL_DECODE_PROTOCOL_VERSION;exports.UnsupportedModelDecodeError=w.UnsupportedModelDecodeError;exports.validateDecodedGltfNodeGraph=w.validateDecodedGltfNodeGraph;exports.installModelDecodeWorker=j;