@realsee/five-webgpu 1.0.0-alpha.12 → 1.0.0-alpha.14

package/five/texture/videoTextureBridge.d.ts

@@ -0,0 +1,152 @@
+import * as THREE from "three/webgpu";
+/**
+ * 视频纹理桥（WebGPU / WebGL 后端通用）。
+ *
+ * ## 为什么需要
+ *
+ * 把 `<video>` 直接交给 three 的 `VideoTexture` 上传，在部分「浏览器 × 后端」组合下得到的是黑色：
+ *
+ * - Safari 18（WebGPU）：`copyExternalImageToTexture(video)` 校验失败，纹理没有被写入；
+ * - 小米浏览器（WebGL，Chromium 内核）：`texImage2D(video)`、`drawImage(video)`、`createImageBitmap(video)`
+ *   全部读到黑色，只有 `new VideoFrame(video)` 能拿到画面。
+ *
+ * 没有任何一条上传路径在所有环境里都可靠，所以这里不按 UA 猜，而是**运行时探测**：
+ * 按优先级依次用小尺寸采样验证每条候选路径「真的有画面」，选第一条有画面的并锁定。
+ *
+ * ## 候选路径（按优先级）
+ *
+ * | 候选                   | 取帧                           | WebGPU 后端                    | WebGL 后端                |
+ * | ---------------------- | ------------------------------ | ------------------------------ | ------------------------- |
+ * | `videoFrame`           | `new VideoFrame(video)`        | importExternalTexture + blit   | texImage2D(VideoFrame)    |
+ * | `video`                | `<video>` 元素本身             | importExternalTexture + blit   | texImage2D(video)         |
+ * | `canvasFromVideoFrame` | VideoFrame → canvas2d.drawImage | three 上传 canvas              | three 上传 canvas         |
+ * | `canvasFromVideo`      | video → canvas2d.drawImage     | three 上传 canvas              | three 上传 canvas         |
+ *
+ * WebGPU 后端下前两条是「external texture → 全屏三角形 render pass → 自持中间纹理」，全程在 GPU 上，
+ * 没有 CPU 读写。后两条经过 canvas2d（有一定性能损耗），是前两条都不可用时的兜底。
+ *
+ * ## 探测与锁定
+ *
+ * - 探测只读一块 16x16（WebGL / canvas）或 64x16（WebGPU）的小采样，取各通道最大值，
+ *   `>= BRIGHT_THRESHOLD` 视为有画面；
+ * - 探测通过的第一条候选被锁定，之后不再探测；
+ * - 全部候选都是黑（视频本身可能就是黑场）时保持默认候选，退避重试，直到出现有画面的候选；
+ * - 视频 `src` 变化（`loadstart`）时解除锁定并重新探测；
+ * - 当前候选连续多帧抛错时，拉黑它并换下一条。
+ *
+ * ## 调用约定
+ *
+ * 由使用方在 `Object3D.onBeforeRender` 中调用 {@link VideoTextureBridge.update}，
+ * 然后把 {@link VideoTextureBridge.texture} 赋给材质。`onBeforeRender` 早于该对象的
+ * 节点构建与绑定更新，所以本帧绑定的一定是更新后的纹理。
+ */
+type CandidateId = 'videoFrame' | 'video' | 'canvasFromVideoFrame' | 'canvasFromVideo';
+declare class VideoTextureBridge {
+    /** 原始视频纹理：所有候选都不可用（或桥无法识别后端）时原样使用 */
+    readonly videoTexture: THREE.VideoTexture;
+    /**
+     * 诊断信息（只读，供排查用）。
+     * - `path`：`pending` 未见过 renderer / `webgpu` / `webgl` / `fallback` 全部候选失败、退回原 VideoTexture
+     * - `candidate`：当前候选；`locked`：是否已探测通过并锁定
+     * - `probe`：最近一次探测结果，如 `vf:210 video:0`（数字为采样最大值，`n/a` 不可用，`-1` 失败）
+     * - `updateCalls` update 调用次数（为 0 说明 onBeforeRender 没触发，即对象没被渲染）；
+     *   `skipNotReady` 因视频未就绪跳过的次数；`blitCount` 实际产出帧数；`rvfcCount` rVFC 回调次数；`fails` 产出失败次数
+     */
+    readonly debug: {
+        path: "pending" | "webgpu" | "webgl" | "fallback";
+        candidate: string;
+        locked: boolean;
+        probe: string;
+        updateCalls: number;
+        skipNotReady: number;
+        blitCount: number;
+        rvfcCount: number;
+        fails: number;
+        targetSize: string;
+        lastError: string;
+    };
+    private mode;
+    private device;
+    /** 所有候选都不可用后置位，永久退回原 VideoTexture */
+    private broken;
+    private disposed;
+    private current;
+    private locked;
+    /** 被拉黑的候选及其解除时间（performance.now() 时间戳）；到期后会重新参与探测 */
+    private readonly blacklist;
+    private probing;
+    private nextProbeAt;
+    private probeInterval;
+    private consecutiveFails;
+    /** 本轮连续失败的起点时间 */
+    private failingSince;
+    /** three 上传的输出纹理：image 在 VideoFrame / video / canvas 之间切换 */
+    private frameTexture;
+    private frameReady;
+    /** 挂在 frameTexture 上、需要在被替换时关闭的 VideoFrame */
+    private heldFrame;
+    private canvas;
+    private canvasContext;
+    /** WebGPU 的 blit 中间纹理及其 three 包装 */
+    private gpuTexture;
+    private externalTexture;
+    private externalReady;
+    private width;
+    private height;
+    private frameDirty;
+    private lastVideoTime;
+    private videoFrameCallbackId;
+    private glProbe;
+    private glProbeFailed;
+    private gpuProbe;
+    private probeCanvas;
+    /** 被 {@link forceCandidate} 强制指定后，不再自动探测 / 换源重探 */
+    private forced;
+    private readonly onSourceChange;
+    constructor(videoTexture: THREE.VideoTexture);
+    private get video();
+    private scheduleVideoFrameCallback;
+    /**
+     * 当前应被材质采样的纹理。
+     * 输出尚未就绪时返回 1x1 黑色占位（不会触发有问题的上传路径）；识别不了后端或全部失败时返回原 `VideoTexture`。
+     */
+    get texture(): THREE.Texture;
+    /**
+     * 有新视频帧时产出一次。应在 `onBeforeRender` 中调用，同一帧多次调用只会产出一次。
+     */
+    update(renderer: unknown): void;
+    /**
+     * 强制使用某条候选路径（仅用于诊断 / 测试），传 `null` 恢复自动探测。
+     * 强制期间不探测、换视频也不重探；候选连续失败时仍会被拉黑并换下一条。
+     */
+    forceCandidate(candidate: CandidateId | null): void;
+    private resolveMode;
+    private ensureFrameTexture;
+    private produce;
+    /** 把图像源交给 frameTexture，并关闭被替换掉的 VideoFrame */
+    private setFrame;
+    private drawCanvas;
+    private isBlacklisted;
+    private onProduceFailed;
+    private blit;
+    private ensureTarget;
+    private startProbe;
+    private runProbe;
+    private select;
+    private probeCandidate;
+    /** canvas2d 探测：把视频缩到 16x16 再读回 */
+    private probe2d;
+    /** WebGL 探测：用独立的小 WebGL2 上下文做 texImage2D → 绘制 → readPixels，行为与 three 的 WebGL 后端一致 */
+    private probeGL;
+    /** WebGPU 探测：external texture → 64x16 小目标 → 回读（异步） */
+    private probeGPU;
+    private releaseProbeResources;
+    private releaseOutputs;
+    dispose(): void;
+}
+/**
+ * 取得某个 `VideoTexture` 对应的桥（同一个 `VideoTexture` 共用一个）。
+ * `VideoTexture` 被 dispose 时桥一并释放，之后再取会新建。
+ */
+declare function getVideoTextureBridge(videoTexture: THREE.VideoTexture): VideoTextureBridge;
+export { VideoTextureBridge, getVideoTextureBridge, type CandidateId };

package/five/thirdparty/sha256.d.ts

@@ -0,0 +1,149 @@
+type Message = string | number[] | ArrayBuffer | Uint8Array;
+
+interface Hasher {
+  /**
+   * Update hash
+   *
+   * @param message The message you want to hash.
+   */
+  update(message: Message): Hasher;
+
+  /**
+   * Return hash in hex string.
+   */
+  hex(): string;
+
+  /**
+   * Return hash in hex string.
+   */
+  toString(): string;
+
+  /**
+   * Return hash in ArrayBuffer.
+   */
+  arrayBuffer(): ArrayBuffer;
+
+  /**
+   * Return hash in integer array.
+   */
+  digest(): number[];
+
+  /**
+   * Return hash in integer array.
+   */
+  array(): number[];
+}
+
+interface Hmac {
+  /**
+   * Computes a Hash-based message authentication code (HMAC) using a secret key
+   *
+   * @param secretKey The Secret Key
+   * @param message The message you want to hash.
+   */
+  (secretKey: Message, message: Message): string;
+
+  /**
+   * Create a hash object using a secret key.
+   *
+   * @param secretKey The Secret Key
+   */
+  create(secretKey: Message): Hasher;
+
+  /**
+   * Create a hash object and hash message using a secret key
+   *
+   * @param secretKey The Secret Key
+   * @param message The message you want to hash.
+   */
+  update(secretKey: Message, message: Message): Hasher;
+
+  /**
+   * Return hash in hex string.
+   *
+   * @param secretKey The Secret Key
+   * @param message The message you want to hash.
+   */
+  hex(secretKey: Message, message: Message): string;
+
+  /**
+   * Return hash in ArrayBuffer.
+   *
+   * @param secretKey The Secret Key
+   * @param message The message you want to hash.
+   */
+  arrayBuffer(secretKey: Message, message: Message): ArrayBuffer;
+
+  /**
+   * Return hash in integer array.
+   *
+   * @param secretKey The Secret Key
+   * @param message The message you want to hash.
+   */
+  digest(secretKey: Message, message: Message): number[];
+
+  /**
+   * Return hash in integer array.
+   *
+   * @param secretKey The Secret Key
+   * @param message The message you want to hash.
+   */
+  array(secretKey: Message, message: Message): number[];
+}
+
+interface Hash {
+  /**
+   * Hash and return hex string.
+   *
+   * @param message The message you want to hash.
+   */
+  (message: Message): string;
+
+  /**
+   * Create a hash object.
+   */
+  create(): Hasher;
+
+  /**
+   * Create a hash object and hash message.
+   *
+   * @param message The message you want to hash.
+   */
+  update(message: Message): Hasher;
+
+  /**
+   * Return hash in hex string.
+   *
+   * @param message The message you want to hash.
+   */
+  hex(message: Message): string;
+
+  /**
+   * Return hash in ArrayBuffer.
+   *
+   * @param message The message you want to hash.
+   */
+  arrayBuffer(message: Message): ArrayBuffer;
+
+  /**
+   * Return hash in integer array.
+   *
+   * @param message The message you want to hash.
+   */
+  digest(message: Message): number[];
+
+  /**
+   * Return hash in integer array.
+   *
+   * @param message The message you want to hash.
+   */
+  array(message: Message): number[];
+
+  /**
+   * HMAC interface
+   */
+  hmac: Hmac;
+}
+
+export var sha256: Hash;
+export var sha224: Hash;

package/five/utils/calculateThreeMouse.js

@@ -1,8 +1,8 @@
 /**
  * @license
  * @realsee/five-webgpu
- * Generated: 2026/10/29
- * Version: 1.0.0-alpha.12
+ * Generated: 2026/11/3
+ * Version: 1.0.0-alpha.14
  * License:
  * Realsee SDK License Agreement
 
@@ -335,4 +335,4 @@
  * writing and signed by Realsee. You and Realsee hereto confirm that this 
  * Agreement and all related documents shall be drafted in English.
 
-*/const e=require("../../_virtual/_rolldown/runtime.js");let t=require("three/webgpu");t=e.__toESM(t,1);function n(e,n,r){let{top:i,left:a,width:o,height:s}=n.getBoundingClientRect();return r&&(a+=o*r.left,i+=s*(1-r.bottom-r.height),o*=r.width,s*=r.height),new t.Vector2((e.x-a)/o*2-1,-(e.y-i)/s*2+1)}exports.calculateThreeMouse=n;
+*/const require_runtime=require("../../_virtual/_rolldown/runtime.js");let three_webgpu=require("three/webgpu");three_webgpu=require_runtime.__toESM(three_webgpu,1);function calculateThreeMouse(mouseXY,element,viewport){let{top,left,width,height}=element.getBoundingClientRect();return viewport&&(left+=width*viewport.left,top+=height*(1-viewport.bottom-viewport.height),width*=viewport.width,height*=viewport.height),new three_webgpu.Vector2((mouseXY.x-left)/width*2-1,-(mouseXY.y-top)/height*2+1)}exports.calculateThreeMouse=calculateThreeMouse;

package/five/utils/calculateThreeMouse.mjs

@@ -1,8 +1,8 @@
 /**
  * @license
  * @realsee/five-webgpu
- * Generated: 2026/10/29
- * Version: 1.0.0-alpha.12
+ * Generated: 2026/11/3
+ * Version: 1.0.0-alpha.14
  * License:
  * Realsee SDK License Agreement
 
@@ -335,4 +335,4 @@
  * writing and signed by Realsee. You and Realsee hereto confirm that this 
  * Agreement and all related documents shall be drafted in English.
 
-*/import*as e from"three/webgpu";function t(t,n,r){let{top:i,left:a,width:o,height:s}=n.getBoundingClientRect();return r&&(a+=o*r.left,i+=s*(1-r.bottom-r.height),o*=r.width,s*=r.height),new e.Vector2((t.x-a)/o*2-1,-(t.y-i)/s*2+1)}export{t as calculateThreeMouse};
+*/import*as THREE from"three/webgpu";function calculateThreeMouse(mouseXY,element,viewport){let{top,left,width,height}=element.getBoundingClientRect();return viewport&&(left+=width*viewport.left,top+=height*(1-viewport.bottom-viewport.height),width*=viewport.width,height*=viewport.height),new THREE.Vector2((mouseXY.x-left)/width*2-1,-(mouseXY.y-top)/height*2+1)}export{calculateThreeMouse};

package/five/utils/distance.js

@@ -1,8 +1,8 @@
 /**
  * @license
  * @realsee/five-webgpu
- * Generated: 2026/10/29
- * Version: 1.0.0-alpha.12
+ * Generated: 2026/11/3
+ * Version: 1.0.0-alpha.14
  * License:
  * Realsee SDK License Agreement
 
@@ -335,4 +335,4 @@
  * writing and signed by Realsee. You and Realsee hereto confirm that this 
  * Agreement and all related documents shall be drafted in English.
 
-*/function e(e,t){return Math.sqrt(Math.pow(e.x-t.x,2)+Math.pow(e.y-t.y,2)+(`z`in e?Math.pow(e.z-t.z,2):0))}exports.distance=e;
+*/function distance(p0,p1){return Math.sqrt(Math.pow(p0.x-p1.x,2)+Math.pow(p0.y-p1.y,2)+(`z`in p0?Math.pow(p0.z-p1.z,2):0))}exports.distance=distance;

package/five/utils/distance.mjs

@@ -1,8 +1,8 @@
 /**
  * @license
  * @realsee/five-webgpu
- * Generated: 2026/10/29
- * Version: 1.0.0-alpha.12
+ * Generated: 2026/11/3
+ * Version: 1.0.0-alpha.14
  * License:
  * Realsee SDK License Agreement
 
@@ -335,4 +335,4 @@
  * writing and signed by Realsee. You and Realsee hereto confirm that this 
  * Agreement and all related documents shall be drafted in English.
 
-*/function e(e,t){return Math.sqrt(Math.pow(e.x-t.x,2)+Math.pow(e.y-t.y,2)+(`z`in e?Math.pow(e.z-t.z,2):0))}export{e as distance};
+*/function distance(p0,p1){return Math.sqrt(Math.pow(p0.x-p1.x,2)+Math.pow(p0.y-p1.y,2)+(`z`in p0?Math.pow(p0.z-p1.z,2):0))}export{distance};

package/five/utils/isNil.js

@@ -1,8 +1,8 @@
 /**
  * @license
  * @realsee/five-webgpu
- * Generated: 2026/10/29
- * Version: 1.0.0-alpha.12
+ * Generated: 2026/11/3
+ * Version: 1.0.0-alpha.14
  * License:
  * Realsee SDK License Agreement
 
@@ -335,4 +335,4 @@
  * writing and signed by Realsee. You and Realsee hereto confirm that this 
  * Agreement and all related documents shall be drafted in English.
 
-*/function e(e){return e==null}exports.isNil=e;
+*/function isNil(object){return object==null}exports.isNil=isNil;

package/five/utils/isNil.mjs

@@ -1,8 +1,8 @@
 /**
  * @license
  * @realsee/five-webgpu
- * Generated: 2026/10/29
- * Version: 1.0.0-alpha.12
+ * Generated: 2026/11/3
+ * Version: 1.0.0-alpha.14
  * License:
  * Realsee SDK License Agreement
 
@@ -335,4 +335,4 @@
  * writing and signed by Realsee. You and Realsee hereto confirm that this 
  * Agreement and all related documents shall be drafted in English.
 
-*/function e(e){return e==null}export{e as isNil};
+*/function isNil(object){return object==null}export{isNil};

package/five/utils/memoryUsage.d.ts

@@ -1,4 +1,4 @@
-import * as THREE from 'three';
+import * as THREE from 'three/webgpu';
 import { PBMGaussianSplattingObject } from '../model/objects/pbmGaussianSplattingObject';
 import { PBMPointCloud } from '../model/objects/pbmPointCloud';
 /**

package/five/utils/uuid.js

@@ -1,8 +1,8 @@
 /**
  * @license
  * @realsee/five-webgpu
- * Generated: 2026/10/29
- * Version: 1.0.0-alpha.12
+ * Generated: 2026/11/3
+ * Version: 1.0.0-alpha.14
  * License:
  * Realsee SDK License Agreement
 
@@ -335,4 +335,4 @@
  * writing and signed by Realsee. You and Realsee hereto confirm that this 
  * Agreement and all related documents shall be drafted in English.
 
-*/function e(){return((1+Math.random())*65536|0).toString(16).substring(1)}function t(){return(e()+e()+`-`+e()+`-4`+e().substr(0,3)+`-`+e()+`-`+e()+e()+e()).toLowerCase()}exports.uuid=t;
+*/function S4(){return((1+Math.random())*65536|0).toString(16).substring(1)}function createUuid(){return(S4()+S4()+`-`+S4()+`-4`+S4().substr(0,3)+`-`+S4()+`-`+S4()+S4()+S4()).toLowerCase()}exports.uuid=createUuid;

package/five/utils/uuid.mjs

@@ -1,8 +1,8 @@
 /**
  * @license
  * @realsee/five-webgpu
- * Generated: 2026/10/29
- * Version: 1.0.0-alpha.12
+ * Generated: 2026/11/3
+ * Version: 1.0.0-alpha.14
  * License:
  * Realsee SDK License Agreement
 
@@ -335,4 +335,4 @@
  * writing and signed by Realsee. You and Realsee hereto confirm that this 
  * Agreement and all related documents shall be drafted in English.
 
-*/function e(){return((1+Math.random())*65536|0).toString(16).substring(1)}function t(){return(e()+e()+`-`+e()+`-4`+e().substr(0,3)+`-`+e()+`-`+e()+e()+e()).toLowerCase()}export{t as uuid};
+*/function S4(){return((1+Math.random())*65536|0).toString(16).substring(1)}function createUuid(){return(S4()+S4()+`-`+S4()+`-4`+S4().substr(0,3)+`-`+S4()+`-`+S4()+S4()+S4()).toLowerCase()}export{createUuid as uuid};

package/five/work/work.d.ts

@@ -168,16 +168,10 @@ export interface WorkModel {
     layers: readonly WorkModelLayer[];
 }
 export interface Work {
-    /** 数据签发人 */
-    issuer: string;
     /** 编号 */
     workCode: string;
     /** 内部项目 id */
     projectId?: string;
-    /** 允许访问的安全域名 */
-    allowHosts: readonly string[];
-    /** 过期时间 */
-    expire: Date;
     /** 名称 */
     name: string;
     /** 根地址 */
@@ -230,7 +224,6 @@ export declare class Work {
     static parse: typeof parseWork;
     constructor(obj: Work | LoosePanoWork | LooseWork | (Work | LooseWork)[] | any, options: ParseOptions);
     getURL(source: string): string;
-    verifyURL(source: string): boolean;
     toJSON(): any;
 }
 export type ParseOptions = {

package/five/work/workJsonType.d.ts

@@ -1,6 +1,4 @@
 export interface WorkJson {
-    allow_hosts: string[];
-    expire_at: string;
     code: string;
     name?: string;
     project_id?: string;

package/gltf-loader/index.js

@@ -1,8 +1,8 @@
 /**
  * @license
  * @realsee/five-webgpu
- * Generated: 2026/10/29
- * Version: 1.0.0-alpha.12
+ * Generated: 2026/11/3
+ * Version: 1.0.0-alpha.14
  * License:
  * Realsee SDK License Agreement
 
@@ -335,4 +335,4 @@
  * writing and signed by Realsee. You and Realsee hereto confirm that this 
  * Agreement and all related documents shall be drafted in English.
 
-*/Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});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));let c=require("@realsee/five-webgpu"),l=require("three/webgpu");l=s(l,1);var u=class extends l.Group{constructor(e){super(),this.needsRender=!0,e&&e.children.length&&this.add(...e.children),this.mixer=new l.AnimationMixer(this)}clone(){let e=super.clone(!0);return e.mixer=new l.AnimationMixer(e),e.needsRender=!0,e}};function d(e){let t=new u(e.scene);return t.position.copy(e.scene.position),t.quaternion.copy(e.scene.quaternion),t.scale.copy(e.scene.scale),Object.assign(Object.assign({},e),{scene:t,scenes:[t]})}var f=class{static get version(){return`1.0.0-alpha.12`}load(e,t,n,r){(0,c.loadGltf)(e,{modelUpAxis:`Y`,upAxis:`Y`,onDownloadProgress(e,t,r){n&&n(new ProgressEvent(`progress`,{lengthComputable:typeof r==`number`,loaded:t==null?0:t,total:r==null?0:r}))}}).then(e=>{t(d(e))}).catch(e=>{r?r(new ErrorEvent(`error`,{error:e,message:e instanceof Error?e.message:String(e)})):console.error(e)})}};exports.GLTFLoader=f,exports.GLTFObject=u;
+*/Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var __create=Object.create,__defProp=Object.defineProperty,__getOwnPropDesc=Object.getOwnPropertyDescriptor,__getOwnPropNames=Object.getOwnPropertyNames,__getProtoOf=Object.getPrototypeOf,__hasOwnProp=Object.prototype.hasOwnProperty,__copyProps=(to,from,except,desc)=>{if(from&&typeof from==`object`||typeof from==`function`)for(var keys=__getOwnPropNames(from),i=0,n=keys.length,key;i<n;i++)key=keys[i],!__hasOwnProp.call(to,key)&&key!==except&&__defProp(to,key,{get:(k=>from[k]).bind(null,key),enumerable:!(desc=__getOwnPropDesc(from,key))||desc.enumerable});return to},__toESM=(mod,isNodeMode,target)=>(target=mod==null?{}:__create(__getProtoOf(mod)),__copyProps(isNodeMode||!mod||!mod.__esModule?__defProp(target,`default`,{value:mod,enumerable:!0}):target,mod));let _realsee_five_webgpu=require("@realsee/five-webgpu"),three_webgpu=require("three/webgpu");three_webgpu=__toESM(three_webgpu,1);var GLTFObject=class extends three_webgpu.Group{constructor(rootObject){super(),this.needsRender=!0,rootObject&&rootObject.children.length&&this.add(...rootObject.children),this.mixer=new three_webgpu.AnimationMixer(this)}clone(){let cloned=super.clone(!0);return cloned.mixer=new three_webgpu.AnimationMixer(cloned),cloned.needsRender=!0,cloned}};function createGLTF(result){let scene=new GLTFObject(result.scene);return scene.position.copy(result.scene.position),scene.quaternion.copy(result.scene.quaternion),scene.scale.copy(result.scene.scale),Object.assign(Object.assign({},result),{scene,scenes:[scene]})}var GLTFLoader=class{static get version(){return`1.0.0-alpha.14`}load(url,onLoad,onProgress,onError){(0,_realsee_five_webgpu.loadGltf)(url,{modelUpAxis:`Y`,upAxis:`Y`,onDownloadProgress(percent,loaded,total){onProgress&&onProgress(new ProgressEvent(`progress`,{lengthComputable:typeof total==`number`,loaded:loaded==null?0:loaded,total:total==null?0:total}))}}).then(result=>{onLoad(createGLTF(result))}).catch(error=>{onError?onError(new ErrorEvent(`error`,{error,message:error instanceof Error?error.message:String(error)})):console.error(error)})}};exports.GLTFLoader=GLTFLoader,exports.GLTFObject=GLTFObject;

package/gltf-loader/index.mjs

@@ -1,8 +1,8 @@
 /**
  * @license
  * @realsee/five-webgpu
- * Generated: 2026/10/29
- * Version: 1.0.0-alpha.12
+ * Generated: 2026/11/3
+ * Version: 1.0.0-alpha.14
  * License:
  * Realsee SDK License Agreement
 
@@ -335,51 +335,4 @@
  * writing and signed by Realsee. You and Realsee hereto confirm that this 
  * Agreement and all related documents shall be drafted in English.
 
-*/import { loadGltf as e } from "@realsee/five-webgpu";
-import * as t from "three/webgpu";
-//#region build/gltf-loader/gltf-object.js
-var n = class extends t.Group {
-	constructor(e) {
-		super(), this.needsRender = !0, e && e.children.length && this.add(...e.children), this.mixer = new t.AnimationMixer(this);
-	}
-	clone() {
-		let e = super.clone(!0);
-		return e.mixer = new t.AnimationMixer(e), e.needsRender = !0, e;
-	}
-};
-//#endregion
-//#region build/gltf-loader/index.js
-function r(e) {
-	let t = new n(e.scene);
-	return t.position.copy(e.scene.position), t.quaternion.copy(e.scene.quaternion), t.scale.copy(e.scene.scale), Object.assign(Object.assign({}, e), {
-		scene: t,
-		scenes: [t]
-	});
-}
-var i = class {
-	static get version() {
-		return "1.0.0-alpha.12";
-	}
-	load(t, n, i, a) {
-		e(t, {
-			modelUpAxis: "Y",
-			upAxis: "Y",
-			onDownloadProgress(e, t, n) {
-				i && i(new ProgressEvent("progress", {
-					lengthComputable: typeof n == "number",
-					loaded: t == null ? 0 : t,
-					total: n == null ? 0 : n
-				}));
-			}
-		}).then((e) => {
-			n(r(e));
-		}).catch((e) => {
-			a ? a(new ErrorEvent("error", {
-				error: e,
-				message: e instanceof Error ? e.message : String(e)
-			})) : console.error(e);
-		});
-	}
-};
-//#endregion
-export { i as GLTFLoader, n as GLTFObject };
+*/import{loadGltf}from"@realsee/five-webgpu";import*as THREE from"three/webgpu";var GLTFObject=class extends THREE.Group{constructor(rootObject){super(),this.needsRender=!0,rootObject&&rootObject.children.length&&this.add(...rootObject.children),this.mixer=new THREE.AnimationMixer(this)}clone(){let cloned=super.clone(!0);return cloned.mixer=new THREE.AnimationMixer(cloned),cloned.needsRender=!0,cloned}};function createGLTF(result){let scene=new GLTFObject(result.scene);return scene.position.copy(result.scene.position),scene.quaternion.copy(result.scene.quaternion),scene.scale.copy(result.scene.scale),Object.assign(Object.assign({},result),{scene,scenes:[scene]})}var GLTFLoader=class{static get version(){return`1.0.0-alpha.14`}load(url,onLoad,onProgress,onError){loadGltf(url,{modelUpAxis:`Y`,upAxis:`Y`,onDownloadProgress(percent,loaded,total){onProgress&&onProgress(new ProgressEvent(`progress`,{lengthComputable:typeof total==`number`,loaded:loaded==null?0:loaded,total:total==null?0:total}))}}).then(result=>{onLoad(createGLTF(result))}).catch(error=>{onError?onError(new ErrorEvent(`error`,{error,message:error instanceof Error?error.message:String(error)})):console.error(error)})}};export{GLTFLoader,GLTFObject};

package/line/index.js

@@ -1,8 +1,8 @@
 /**
  * @license
  * @realsee/five-webgpu
- * Generated: 2026/10/29
- * Version: 1.0.0-alpha.12
+ * Generated: 2026/11/3
+ * Version: 1.0.0-alpha.14
  * License:
  * Realsee SDK License Agreement
 
@@ -335,4 +335,4 @@
  * writing and signed by Realsee. You and Realsee hereto confirm that this 
  * Agreement and all related documents shall be drafted in English.
 
-*/Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});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));let c=require("three/webgpu");c=s(c,1);let l=require("three/addons/lines/webgpu/Line2.js"),u=require("three/addons/lines/webgpu/LineSegments2.js"),d=require("three/addons/lines/LineGeometry.js"),f=require("three/addons/lines/LineSegmentsGeometry.js");var p=14467195,m=8,h=2,g=20,_=null;function v(e,t){t instanceof c.Vector3?e.color.setRGB(t.x,t.y,t.z):e.color.set(t)}var y=class extends c.Object3D{static get version(){return`1.0.0-alpha.12`}constructor(e=new c.Vector3,t=new c.Vector3){super(),this.type=`FiveLine`,this.needsRender=!0;let n=new d.LineGeometry,r=new c.Line2NodeMaterial({color:p,linewidth:h,dashed:!1});r.scale=g,this.line=new l.Line2(n,r);let i=new c.BufferGeometry,a=new c.PointsMaterial({color:p,size:m,map:_||(_=new c.TextureLoader().load(`data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAAAAXNSR0IArs4c6QAAAAZiS0dEAAAAAAAA+UO7fwAAAAlwSFlzAAALEwAACxMBAJqcGAAAAAd0SU1FB9sHDgwCEMBJZu0AAAAdaVRYdENvbW1lbnQAAAAAAENyZWF0ZWQgd2l0aCBHSU1QZC5lBwAABM5JREFUWMO1V0tPG2cUPZ4Hxh6DazIOrjFNqJs0FIMqWFgWQkatsmvVbtggKlSVRVf5AWz4AWz4AUSKEChll19QJYSXkECuhFxsHjEhxCYm+DWGMZ5HF72DJq4bAzFXurI0M/I5997v3u9cC65vTJVn2lX/xHINQOYSBLTLEuIuCWw4Z3IGAEvf6ASmVHjNzHCXBG4A0AjACsAOwEbO0nsFQBnAGYASAIl+ZRMR7SolMEdsByD09fV5R0ZGgg8ePPjW5/N1iqLYpuu6RZblciKR2I9Go69evnwZnZ+fjwI4IS8AKBIRzeQfJWCANwKwh0KhtrGxsYehUOin1tbW+zzP23ietzY2NnIAoGmaLsuyUiqVyvl8XtrY2NiamZn589mzZxsAUgCOAeQAnFI2tI+VxIjaAeDzoaGh7xYWFuZOTk6OZVk+12uYqqq6JEnn0Wg0OT4+/geAXwGEAdwDIFJQXC1wO4DWR48e/RCPxxclSSroVzRFUbSDg4P848ePFwH8DuAhkWih83TRQWxFOXgAwvDwcOfo6OhvXV1d39tsNtuVBwTDWBwOh1UUxVsMw1hXVlbSdCgNV43uYSvrHg6H24aHh38eHBz85TrgF9FYLHA4HLzH43FvbW2d7u/vG+dANp8FpqIlbd3d3V8Fg8EfBUFw4BONZVmL3+9vHhkZCQL4AoAHgJPK8G+yzC0XDofdoVAo5PP5vkadTBAEtr+/39ff3x8gAp/RPOEqx2qjx+NpvXv3bk9DQ0NDvQgwDIOWlhZrMBj8kgi0UJdxRgYMArzL5XJ7vd57qLPZ7Xamp6fnNgBXtQxcjFuHw+Hyer3t9SYgCAITCAScAJoBNNEY/08GOFVVrfVMv7kMNDntFD1vjIAPrlRN0xjckOm6biFQ3jwNPwDMZrOnqVTqfb3Bi8Wivru7W/VCYkwPlKOjo0IikXh7EwQikYgE4Nw0CfXKDCipVCoTj8df3QABbW1tLUc6oUgkFPMkVACUNjc337148eKvw8PDbJ2jP1taWkoCyNDVXDSECmNSK4qiKNLq6urW8+fPI/UicHx8rD59+jSVy+WOAKSJhKENwFItLtoxk8mwsixzHR0dHe3t7c5PAU+n09rs7OzJkydPYqVSaQfANoDXALIk31S2smU1TWMPDg7K5XKZ7+3t9TudTut1U7+wsFCcmJiIpdPpbQBxADsAknQWymYCOukBHYCuKApisdhpMpnURFEU79y503TVyKenpzOTk5M7e3t7MQKPV0Zv1gNm+awB0MvlshqLxfLb29uyJElWURSbXC4XXyvqxcXFs6mpqeTc3Nzu3t7e3wQcA7BPZ8Cov1pNlJplmQtAG8MwHV6v95tAINA5MDBwPxAIuLu6upr8fr/VAN3c3JQjkcjZ+vp6fnl5+d2bN29SuVzuNYAEpf01CdRChUL+X1VskHACuA3Ay3Fcu9vt7nA6nZ7m5uYWQRCaNE3jVVW15PP580KhIGUymWw2m00DOAJwSP4WwPtq4LX2Ao6USxNlQyS/RcQcdLGwlNIz6vEMAaZpNzCk2Pll94LK/cDYimxERiBwG10sxjgvEZBE0UpE6vxj+0Ct5bTaXthgEhRmja8QWNkkPGsuIpfdjpkK+cZUWTC0KredVmtD/gdlSl6EG4AMvQAAAABJRU5ErkJggg==`)),sizeAttenuation:!1,transparent:!0});this.points=new c.Points(i,a),this.points.renderOrder=11,this.points.frustumCulled=!1,this.setPoints(e,t),this.add(this.line,this.points)}setPoints(e,t){let n=[].concat(e.toArray(),t.toArray());this.updatePointsPositions(n),this.updateLinePositions(n),this.needsRender=!0}updatePointsPositions(e){let t=this.points.geometry,n=t.getAttribute(`position`);n&&n.array.length===e.length?(n.array.set(e),n.needsUpdate=!0):t.setAttribute(`position`,new c.BufferAttribute(new Float32Array(e),3))}updateLinePositions(e){let t=this.line.geometry,n=t.getAttribute(`instanceStart`);if(!n||n.data.array.length!==e.length){t.setPositions(e),this.line.computeLineDistances();return}let r=n.data;r.array.set(e),r.needsUpdate=!0,t.computeBoundingBox(),t.computeBoundingSphere(),this.updateLineDistances()}updateLineDistances(){let e=this.line.geometry,t=e.getAttribute(`instanceDistanceStart`);if(!t){this.line.computeLineDistances();return}let n=e.getAttribute(`instanceStart`),r=e.getAttribute(`instanceEnd`),i=n.count,a=t.data,o=a.array,s=new c.Vector3,l=new c.Vector3;for(let e=0,t=0;e<i;e++,t+=2)s.fromBufferAttribute(n,e),l.fromBufferAttribute(r,e),o[t]=t===0?0:o[t-1],o[t+1]=o[t]+s.distanceTo(l);a.needsUpdate=!0}getPoints(){let e=this.points.geometry.attributes.position.array;return[new c.Vector3(e[0],e[1],e[2]),new c.Vector3(e[3],e[4],e[5])]}setMaterial(e){let t=this.line.material;for(let n in e){if(!Object.prototype.hasOwnProperty.call(e,n))continue;let r=e[n];if(n===`color`)v(t,r);else if(n===`dashed`)t.dashed=r;else if(n===`dashScale`)t.scale=r;else if(n===`resolution`){let e=r;this.setResolution(e.x,e.y)}else t[n]=r}this.needsRender=!0}setResolution(e,t){let n=this.line._resolution;n&&(n.x!==e||n.y!==t)&&(n.set(e,t),this.needsRender=!0)}};Object.assign(y.prototype,{isFiveLine:!0}),exports.Line=y,exports.LineGeometry=d.LineGeometry,exports.LineSegmentsGeometry=f.LineSegmentsGeometry,exports.THREE_Line2=l.Line2,exports.THREE_LineSegments2=u.LineSegments2;
+*/Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var __create=Object.create,__defProp=Object.defineProperty,__getOwnPropDesc=Object.getOwnPropertyDescriptor,__getOwnPropNames=Object.getOwnPropertyNames,__getProtoOf=Object.getPrototypeOf,__hasOwnProp=Object.prototype.hasOwnProperty,__copyProps=(to,from,except,desc)=>{if(from&&typeof from==`object`||typeof from==`function`)for(var keys=__getOwnPropNames(from),i=0,n=keys.length,key;i<n;i++)key=keys[i],!__hasOwnProp.call(to,key)&&key!==except&&__defProp(to,key,{get:(k=>from[k]).bind(null,key),enumerable:!(desc=__getOwnPropDesc(from,key))||desc.enumerable});return to},__toESM=(mod,isNodeMode,target)=>(target=mod==null?{}:__create(__getProtoOf(mod)),__copyProps(isNodeMode||!mod||!mod.__esModule?__defProp(target,`default`,{value:mod,enumerable:!0}):target,mod));let three_webgpu=require("three/webgpu");three_webgpu=__toESM(three_webgpu,1);let three_addons_lines_webgpu_Line2_js=require("three/addons/lines/webgpu/Line2.js"),three_addons_lines_webgpu_LineSegments2_js=require("three/addons/lines/webgpu/LineSegments2.js"),three_addons_lines_LineGeometry_js=require("three/addons/lines/LineGeometry.js"),three_addons_lines_LineSegmentsGeometry_js=require("three/addons/lines/LineSegmentsGeometry.js");var DEFAULT_COLOR=14467195,POINT_SIZE=8,DEFAULT_LINEWIDTH=2,DEFAULT_DASHSCALE=20,sharedCircleTexture=null;function applyColor(material,value){value instanceof three_webgpu.Vector3?material.color.setRGB(value.x,value.y,value.z):material.color.set(value)}var FiveLine=class extends three_webgpu.Object3D{static get version(){return`1.0.0-alpha.14`}constructor(vector0=new three_webgpu.Vector3,vector1=new three_webgpu.Vector3){super(),this.type=`FiveLine`,this.needsRender=!0;let lineGeometry=new three_addons_lines_LineGeometry_js.LineGeometry,lineMaterial=new three_webgpu.Line2NodeMaterial({color:DEFAULT_COLOR,linewidth:DEFAULT_LINEWIDTH,dashed:!1});lineMaterial.scale=DEFAULT_DASHSCALE,this.line=new three_addons_lines_webgpu_Line2_js.Line2(lineGeometry,lineMaterial);let pointsGeometry=new three_webgpu.BufferGeometry,pointsMaterial=new three_webgpu.PointsMaterial({color:DEFAULT_COLOR,size:POINT_SIZE,map:sharedCircleTexture||(sharedCircleTexture=new three_webgpu.TextureLoader().load(`data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAAAAXNSR0IArs4c6QAAAAZiS0dEAAAAAAAA+UO7fwAAAAlwSFlzAAALEwAACxMBAJqcGAAAAAd0SU1FB9sHDgwCEMBJZu0AAAAdaVRYdENvbW1lbnQAAAAAAENyZWF0ZWQgd2l0aCBHSU1QZC5lBwAABM5JREFUWMO1V0tPG2cUPZ4Hxh6DazIOrjFNqJs0FIMqWFgWQkatsmvVbtggKlSVRVf5AWz4AWz4AUSKEChll19QJYSXkECuhFxsHjEhxCYm+DWGMZ5HF72DJq4bAzFXurI0M/I5997v3u9cC65vTJVn2lX/xHINQOYSBLTLEuIuCWw4Z3IGAEvf6ASmVHjNzHCXBG4A0AjACsAOwEbO0nsFQBnAGYASAIl+ZRMR7SolMEdsByD09fV5R0ZGgg8ePPjW5/N1iqLYpuu6RZblciKR2I9Go69evnwZnZ+fjwI4IS8AKBIRzeQfJWCANwKwh0KhtrGxsYehUOin1tbW+zzP23ietzY2NnIAoGmaLsuyUiqVyvl8XtrY2NiamZn589mzZxsAUgCOAeQAnFI2tI+VxIjaAeDzoaGh7xYWFuZOTk6OZVk+12uYqqq6JEnn0Wg0OT4+/geAXwGEAdwDIFJQXC1wO4DWR48e/RCPxxclSSroVzRFUbSDg4P848ePFwH8DuAhkWih83TRQWxFOXgAwvDwcOfo6OhvXV1d39tsNtuVBwTDWBwOh1UUxVsMw1hXVlbSdCgNV43uYSvrHg6H24aHh38eHBz85TrgF9FYLHA4HLzH43FvbW2d7u/vG+dANp8FpqIlbd3d3V8Fg8EfBUFw4BONZVmL3+9vHhkZCQL4AoAHgJPK8G+yzC0XDofdoVAo5PP5vkadTBAEtr+/39ff3x8gAp/RPOEqx2qjx+NpvXv3bk9DQ0NDvQgwDIOWlhZrMBj8kgi0UJdxRgYMArzL5XJ7vd57qLPZ7Xamp6fnNgBXtQxcjFuHw+Hyer3t9SYgCAITCAScAJoBNNEY/08GOFVVrfVMv7kMNDntFD1vjIAPrlRN0xjckOm6biFQ3jwNPwDMZrOnqVTqfb3Bi8Wivru7W/VCYkwPlKOjo0IikXh7EwQikYgE4Nw0CfXKDCipVCoTj8df3QABbW1tLUc6oUgkFPMkVACUNjc337148eKvw8PDbJ2jP1taWkoCyNDVXDSECmNSK4qiKNLq6urW8+fPI/UicHx8rD59+jSVy+WOAKSJhKENwFItLtoxk8mwsixzHR0dHe3t7c5PAU+n09rs7OzJkydPYqVSaQfANoDXALIk31S2smU1TWMPDg7K5XKZ7+3t9TudTut1U7+wsFCcmJiIpdPpbQBxADsAknQWymYCOukBHYCuKApisdhpMpnURFEU79y503TVyKenpzOTk5M7e3t7MQKPV0Zv1gNm+awB0MvlshqLxfLb29uyJElWURSbXC4XXyvqxcXFs6mpqeTc3Nzu3t7e3wQcA7BPZ8Cov1pNlJplmQtAG8MwHV6v95tAINA5MDBwPxAIuLu6upr8fr/VAN3c3JQjkcjZ+vp6fnl5+d2bN29SuVzuNYAEpf01CdRChUL+X1VskHACuA3Ay3Fcu9vt7nA6nZ7m5uYWQRCaNE3jVVW15PP580KhIGUymWw2m00DOAJwSP4WwPtq4LX2Ao6USxNlQyS/RcQcdLGwlNIz6vEMAaZpNzCk2Pll94LK/cDYimxERiBwG10sxjgvEZBE0UpE6vxj+0Ct5bTaXthgEhRmja8QWNkkPGsuIpfdjpkK+cZUWTC0KredVmtD/gdlSl6EG4AMvQAAAABJRU5ErkJggg==`)),sizeAttenuation:!1,transparent:!0});this.points=new three_webgpu.Points(pointsGeometry,pointsMaterial),this.points.renderOrder=11,this.points.frustumCulled=!1,this.setPoints(vector0,vector1),this.add(this.line,this.points)}setPoints(vector0,vector1){let positions=[].concat(vector0.toArray(),vector1.toArray());this.updatePointsPositions(positions),this.updateLinePositions(positions),this.needsRender=!0}updatePointsPositions(positions){let geometry=this.points.geometry,existing=geometry.getAttribute(`position`);existing&&existing.array.length===positions.length?(existing.array.set(positions),existing.needsUpdate=!0):geometry.setAttribute(`position`,new three_webgpu.BufferAttribute(new Float32Array(positions),3))}updateLinePositions(positions){let geometry=this.line.geometry,instanceStart=geometry.getAttribute(`instanceStart`);if(!instanceStart||instanceStart.data.array.length!==positions.length){geometry.setPositions(positions),this.line.computeLineDistances();return}let buffer=instanceStart.data;buffer.array.set(positions),buffer.needsUpdate=!0,geometry.computeBoundingBox(),geometry.computeBoundingSphere(),this.updateLineDistances()}updateLineDistances(){let geometry=this.line.geometry,instanceDistance=geometry.getAttribute(`instanceDistanceStart`);if(!instanceDistance){this.line.computeLineDistances();return}let instanceStart=geometry.getAttribute(`instanceStart`),instanceEnd=geometry.getAttribute(`instanceEnd`),count=instanceStart.count,buffer=instanceDistance.data,array=buffer.array,start=new three_webgpu.Vector3,end=new three_webgpu.Vector3;for(let i=0,j=0;i<count;i++,j+=2)start.fromBufferAttribute(instanceStart,i),end.fromBufferAttribute(instanceEnd,i),array[j]=j===0?0:array[j-1],array[j+1]=array[j]+start.distanceTo(end);buffer.needsUpdate=!0}getPoints(){let array=this.points.geometry.attributes.position.array;return[new three_webgpu.Vector3(array[0],array[1],array[2]),new three_webgpu.Vector3(array[3],array[4],array[5])]}setMaterial(map){let lineMaterial=this.line.material;for(let name in map){if(!Object.prototype.hasOwnProperty.call(map,name))continue;let value=map[name];if(name===`color`)applyColor(lineMaterial,value);else if(name===`dashed`)lineMaterial.dashed=value;else if(name===`dashScale`)lineMaterial.scale=value;else if(name===`resolution`){let resolution=value;this.setResolution(resolution.x,resolution.y)}else lineMaterial[name]=value}this.needsRender=!0}setResolution(width,height){let resolution=this.line._resolution;resolution&&(resolution.x!==width||resolution.y!==height)&&(resolution.set(width,height),this.needsRender=!0)}};Object.assign(FiveLine.prototype,{isFiveLine:!0}),exports.Line=FiveLine,exports.LineGeometry=three_addons_lines_LineGeometry_js.LineGeometry,exports.LineSegmentsGeometry=three_addons_lines_LineSegmentsGeometry_js.LineSegmentsGeometry,exports.THREE_Line2=three_addons_lines_webgpu_Line2_js.Line2,exports.THREE_LineSegments2=three_addons_lines_webgpu_LineSegments2_js.LineSegments2;