lythreeframe 2.0.8 → 2.0.10

package/dist/src/Frame/Parameters/ViewportParameters.d.ts

@@ -1,6 +1,6 @@
-import type { PostProcessParam } from 'lythreeframe/src/PostProcess/PostProcessParam';
 import { type WebGLRendererParameters } from 'three';
 import { type WebGPURendererParameters } from 'three/src/renderers/webgpu/WebGPURenderer.js';
+import { PostProcessParam } from '../../PostProcess/PostProcessParam';
 export declare enum RendererType {
     WebGPU = 0,
     WebGL = 1

package/dist/src/Frame/Rendering/PostProcess.d.ts

@@ -4,6 +4,14 @@ export declare class PostProcessManager {
     private postProcessParam;
     private postProcessing;
     private outlineObjects;
+    /**
+     * 永远留在描边选择列表中的占位对象：它是一个不在场景中的空 Mesh。
+     * OutlineNode 在 _updateSelectionCache 中会把它计入 _selectionCache（因为 isMesh
+     * 为真），从而保证选择列表永不为空；但它不在场景中，所有描边 pass 都不会
+     * 渲染它，因此不会产生任何可见描边。这样可彻底避免「清空选择 -> 空选过渡帧」
+     * 在 WebGPU 上（裸 renderer.clear() 无 active pass）导致的闪屏。
+     */
+    private _outlinePlaceholder;
     private effectUniforms;
     private outlinePass;
     private bloomPass;
@@ -27,6 +35,14 @@ export declare class PostProcessManager {
     private getStepParam;
     private updateAllUniforms;
     updateSteps(steps: PostProcessStepParam[]): void;
+    /**
+     * 确保描边选择列表中始终存在一个不会渲染出描边的占位对象。
+     * 占位对象是一个不在场景中的空 Mesh：OutlineNode 在 _updateSelectionCache 中
+     * 会把它计入 _selectionCache（因为 isMesh 为真），从而使选择永不为空；但它
+     * 不在场景中，所有描边 pass 都不会渲染它，因此不会产生任何可见描边。
+     * 这从机制上消除了「选择被清空时空选过渡帧」在 WebGPU 上导致的闪屏。
+     */
+    private ensureOutlinePlaceholder;
     addOutlineObject(obj: Object3D): void;
     setOutlineObjects(objects: Object3D[]): void;
     removeOutlineObject(obj: Object3D): void;

package/dist/src/Object/PawnV2/Oribital.d.ts

@@ -13,12 +13,20 @@ export declare class Orbital extends Pawn {
     maxAzimuthAngle: number;
     enableDamping: boolean;
     dampingFactor: number;
+    enableRotate: boolean;
+    enablePan: boolean;
+    enableZoom: boolean;
     private _isDragging;
     private _lastPointerPosition;
     private _targetPosition;
     private _targetQuaternion;
     private _targetDistance;
     private _focusTween;
+    private _touchGesture;
+    private _touches;
+    private _lastTouchDistance;
+    private _lastTouchPanCenter;
+    private _touchStartPositions;
     constructor(app: ThreeJsApp);
     possess(): void;
     getTargetCameraState(): {
@@ -33,6 +41,13 @@ export declare class Orbital extends Pawn {
     private onPointerUp;
     private setCameraDraggingState;
     private onWheel;
+    private onTouchStart;
+    private onTouchMove;
+    private onTouchEnd;
+    /** 应用旋转变换 */
+    private applyRotation;
+    /** 应用平移变换 */
+    private applyPan;
     tick(deltaTime: number): void;
     setPosition(position: Vector3): void;
     setPosition(x: number, y: number, z: number): void;

package/dist/src/ThreeJsApp.d.ts

@@ -20,10 +20,13 @@ export declare class ThreeJsApp {
     protected _world: World;
     protected _viewport: Viewport;
     protected _controller: Controller;
-    protected _assetManager: AssetManager;
+    /** AssetManager 可能会被延迟（动态 import）创建，故在就绪前保持 null */
+    protected _assetManager: AssetManager | null;
     protected _assetManagerReady: Promise<void>;
     protected _tickingFunctions: Array<(delta: number) => void>;
     protected _isTickPaused: boolean;
+    /** 销毁幂等标志：destroy() 可被组件卸载与页面卸载（beforeunload）两条路径重复触发 */
+    protected _destroyed: boolean;
     get onCameraChangedDelegate(): Delegate<[void]>;
     protected _onCameraChangedDelegate: Delegate<[void]>;
     constructor(appParam?: AppParam);
@@ -33,7 +36,19 @@ export declare class ThreeJsApp {
     setTickPaused(pause: boolean): void;
     addTickingFunction(func: (deltaTime: number) => void): void;
     removeTickingFunction(func: (deltaTime: number) => void): void;
-    destroy(): Promise<void>;
+    /**
+     * 销毁整个应用：controller / world / assetManager / viewport（含 renderer 与 GPU 设备）。
+     *
+     * 同步实现的原因：此前是 async 且首句 await this._assetManagerReady，
+     * 导致真正的清理被推迟到微任务；而页面刷新/关闭时 beforeunload 是同步 handler，
+     * 微任务不保证执行（_assetManagerReady 未就绪时甚至永不执行），
+     * 造成每次刷新残留一份 WebGPU 上下文。卸载路径无法等待 Promise，故整体改为同步。
+     *
+     * 幂等：重复调用安全（destroySync 与本方法共用 _destroyed 守卫）。
+     */
+    destroy(): void;
+    /** 释放 AssetManager；若其仍在异步就绪中，则在就绪后补一次释放（不阻塞调用方） */
+    private _disposeAssetManager;
     updateCamera(param: CameraParam): void;
     onWindowResize(width: number, height: number): void;
     renderAsImage(width?: number, height?: number): Promise<string>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lythreeframe",
-  "version": "2.0.8",
+  "version": "2.0.10",
   "description": "Three.js 封装",
   "main": "dist/bundle.cjs.js",
   "module": "dist/bundle.esm.js",