lythreeframe 1.2.52 → 1.2.53

package/dist/index.d.ts

@@ -1,9 +1,11 @@
 export { AssetManager } from "./lythreeframe/AssetManagement/AssetManager";
-export { TAssetPointer } from "./lythreeframe/AssetManagement/AssetPointer/AssetPointer";
+export { TAssetPointer, ASSET_POINTER_KEY, EDITOR_ASSET_ID_KEY } from "./lythreeframe/AssetManagement/AssetPointer/AssetPointer";
 export { TSmartPointer } from './lythreeframe/Container/SmartPointer';
 export { MaterialAssetPointer } from "./lythreeframe/AssetManagement/AssetPointer/Assets/MaterialAssetPointer";
 export { GeometryAssetPointer } from "./lythreeframe/AssetManagement/AssetPointer/Assets/GeometryAssetPointer";
 export { TextureAssetPointer } from "./lythreeframe/AssetManagement/AssetPointer/Assets/TextureAssetPointer";
+export { AssetCategory, AssetLoadState, ReferenceType, AssetType } from "./lythreeframe/AssetManagement/AssetDefines";
+export type { AssetReference, AssetDescriptor } from "./lythreeframe/AssetManagement/AssetDefines";
 export { AttachmentRules } from "./lythreeframe/Defines";
 export { Delegate } from "./lythreeframe/Delegate";
 export { ThreeJsApp } from "./lythreeframe/ThreeJsApp";

package/dist/lythreeframe/AssetManagement/AssetDefines.d.ts

@@ -1,3 +1,62 @@
+/**
+ * 资产类别 - 用于底层资产管理
+ */
+export declare enum AssetCategory {
+    Geometry = "geometry",
+    Material = "material",
+    Texture = "texture",
+    Actor = "actor",
+    ActorManager = "actorManager",
+    Level = "level",
+    HTML = "html",
+    Code = "code",
+    Undefined = "undefined"
+}
+/**
+ * 资产加载状态
+ */
+export declare enum AssetLoadState {
+    Unloaded = "unloaded",
+    Loading = "loading",
+    Loaded = "loaded",
+    Error = "error"
+}
+/**
+ * 引用者类型
+ */
+export declare enum ReferenceType {
+    Actor = "actor",
+    Component = "component",
+    Material = "material",
+    Level = "level",
+    AssetPointer = "assetPointer",
+    External = "external"
+}
+/**
+ * 资产引用信息
+ */
+export interface AssetReference {
+    /** 引用者的 UUID */
+    refererId: string;
+    /** 引用者类型 */
+    refererType: ReferenceType;
+    /** 属性路径 (如 "map", "normalMap") */
+    propertyPath?: string;
+}
+/**
+ * 资产描述符 - 用于序列化和延迟加载
+ */
+export interface AssetDescriptor {
+    uuid: string;
+    name: string;
+    category: AssetCategory;
+    thumbnail?: string;
+    packageName?: string;
+    contentPath?: string;
+}
+/**
+ * @deprecated 使用 AssetCategory 替代
+ */
 export declare enum AssetType {
     geometry = 1,
     material = 2,

package/dist/lythreeframe/AssetManagement/AssetPointer/AssetPointer.d.ts

@@ -1,9 +1,20 @@
 import { BufferGeometry, Material, Texture } from "three/webgpu";
 import { TSmartPointer } from "../../Container/SmartPointer";
+/**
+ * userData 键名常量
+ */
+export declare const ASSET_POINTER_KEY: "assetPointer";
+export declare const EDITOR_ASSET_ID_KEY: "editorAssetId";
+/**
+ * Three.js 资源的智能指针
+ * 管理 BufferGeometry、Material、Texture 的生命周期
+ */
 export declare abstract class TAssetPointer<T extends BufferGeometry | Texture | Material> extends TSmartPointer<T> {
-    get uuid(): string;
     private readonly _uuid;
+    get uuid(): string;
     constructor(value: T, referenceCount?: number);
-    release(): void;
-    forceRelease(): void;
+    /**
+     * 释放资源，清理 userData 并调用 Three.js 的 dispose
+     */
+    protected dispose(): void;
 }

package/dist/lythreeframe/AssetManagement/AssetPointer/Assets/MaterialAssetPointer.d.ts

@@ -1,11 +1,24 @@
 import { Material } from "three/webgpu";
 import { TAssetPointer } from "../AssetPointer";
 import { TextureAssetPointer } from "./TextureAssetPointer";
+/**
+ * 材质资产指针
+ * 管理材质及其关联的纹理引用
+ */
 export declare class MaterialAssetPointer extends TAssetPointer<Material> {
     protected textures: Map<string, TextureAssetPointer>;
     constructor(value: Material, usedTextures: Map<string, TextureAssetPointer>, referenceCount?: number);
     get texturePointers(): Map<string, TextureAssetPointer>;
+    /**
+     * 设置材质的纹理属性
+     */
     setTexture(name: string, texturePtr: TextureAssetPointer): void;
-    release(): void;
-    forceRelease(): void;
+    /**
+     * 移除纹理属性
+     */
+    removeTexture(name: string): void;
+    /**
+     * 释放材质时同时释放所有关联的纹理引用
+     */
+    protected dispose(): void;
 }

package/dist/lythreeframe/Container/SmartPointer.d.ts

@@ -3,8 +3,13 @@ export declare class TSmartPointer<T> {
     protected value: T | null;
     constructor(value: T, referenceCount?: number);
     getRefCount(): number;
+    isValid(): boolean;
     addRef(count?: number): void;
     release(): void;
     forceRelease(): void;
+    /**
+     * 子类覆盖此方法以执行清理逻辑
+     */
+    protected dispose(): void;
     getValue(): T | null;
 }

package/dist/lythreeframe/Frame/Controller.d.ts

@@ -3,40 +3,85 @@ import { Euler, Intersection, OrthographicCamera, PerspectiveCamera, Quaternion,
 import { World } from "./World";
 import { Viewport } from "./Viewport";
 import { Pawn } from "../Object/PawnV2/Pawn";
+import { SceneComponent } from "../Object/Components/SceneComponent";
 import { Delegate } from "../Delegate";
+/** 组件交互事件基类 */
+export interface ComponentInteractionEvent {
+    component: SceneComponent;
+    hit: Intersection;
+    /** 设置为 true 阻止组件自身的回调被调用 */
+    handled: boolean;
+}
+/** 组件悬停事件 */
+export interface ComponentHoverEvent {
+    component: SceneComponent;
+    hit: Intersection | null;
+    /** 设置为 true 阻止组件自身的 onHoveringBegin/End 被调用 */
+    handled: boolean;
+}
+/** 组件按下事件 */
+export interface ComponentPointerDownEvent {
+    component: SceneComponent;
+    hit: Intersection;
+    button: number;
+    /** 设置为 true 阻止默认处理 */
+    handled: boolean;
+}
 export declare class Controller {
-    private prepareClickComponent;
-    get camera(): PerspectiveCamera | OrthographicCamera;
-    get world(): World;
-    get viewPort(): Viewport;
-    get pawn(): Pawn;
-    get app(): ThreeJsApp;
     private _app;
     private _pawn;
     private raycaster;
+    private prepareClickComponent;
+    private prepareClickHit;
+    private hoveringComponent;
+    private _pointButtonIsDown;
+    private _onClickNothingDelegate;
+    private _onComponentClickDelegate;
+    private _onComponentDoubleClickDelegate;
+    private _onComponentHoverBeginDelegate;
+    private _onComponentHoverEndDelegate;
+    private _onComponentPointerDownDelegate;
+    private pointerPosition;
+    private pointerLeftDownPosition;
+    private readonly _tempVec2;
+    private readonly _raycastVec2;
+    private readonly doubleClickDelay;
+    private leftClickTimer;
     private onPointerMove;
     private onPointerEnter;
     private onPointerLeave;
     private onPointerUp;
     private onPointerDown;
-    private pointerPosition;
-    private readonly doubleClickDelay;
-    private leftClickTimer;
-    private pointerLeftDownPosition;
-    private hoveringComponent;
-    private _pointButtonIsDown;
+    get camera(): PerspectiveCamera | OrthographicCamera;
+    get world(): World;
+    get viewPort(): Viewport;
+    get app(): ThreeJsApp;
     get onClickNothingDelegate(): Delegate<[void]>;
-    private _onClickNothingDelegate;
+    get onComponentClickDelegate(): Delegate<[ComponentInteractionEvent]>;
+    get onComponentDoubleClickDelegate(): Delegate<[ComponentInteractionEvent]>;
+    get onComponentHoverBeginDelegate(): Delegate<[ComponentHoverEvent]>;
+    get onComponentHoverEndDelegate(): Delegate<[ComponentHoverEvent]>;
+    get onComponentPointerDownDelegate(): Delegate<[ComponentPointerDownEvent]>;
+    get pawn(): Pawn;
     constructor(app: ThreeJsApp);
-    updateCamera(): void;
     init(): void;
+    updateCamera(): void;
     tick(deltaTime: number): void;
     destroy(): void;
     onPointerMoveEvent(event: MouseEvent): void;
+    private clearHoveringComponent;
+    private fireHoverEvent;
     onPointerUpEvent(event: MouseEvent): void;
+    private handleFirstClick;
+    private handleDoubleClick;
+    private fireClickEvent;
+    private clearClickTimer;
     onPointerDownEvent(event: MouseEvent): void;
+    private firePointerDownEvent;
     onPointerEnterEvent(event: MouseEvent): void;
     onPointerLeaveEvent(event: MouseEvent): void;
+    private addCorePointerListeners;
+    private removeCorePointerListeners;
     getHitResultUnderCursor(): Intersection | null;
     getHitResultFromScreenPoint(x: number, y: number): Intersection | null;
     focusTo(targetPos: Vector3, targetQuat: Quaternion | Euler, distance: number, time: number, onGoing?: (() => void) | null, onFinished?: (() => void) | null): void;

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

@@ -0,0 +1,23 @@
+import { Camera, Object3D, PostProcessing, Scene, WebGPURenderer } from "three/webgpu";
+import { PostProcessParam, PostProcessStepParam } from '../../PostProcess/PostProcessParam';
+export declare class PostProcessManager {
+    private postProcessParam;
+    private postProcessing;
+    private outlineObjects;
+    private renderer;
+    private scene;
+    private camera;
+    private onDirtyCallback;
+    constructor(renderer: WebGPURenderer, scene: Scene, camera: Camera, postProcessParam: PostProcessParam, onDirtyCallback?: () => void);
+    get processing(): PostProcessing | null;
+    updateCamera(camera: Camera): void;
+    setup(): void;
+    updateSteps(steps: PostProcessStepParam[]): void;
+    addOutlineObject(obj: Object3D): void;
+    setOutlineObjects(objects: Object3D[]): void;
+    removeOutlineObject(obj: Object3D): void;
+    render(): boolean;
+    renderAsync(): Promise<boolean>;
+    destroy(): void;
+    private markDirty;
+}

package/dist/lythreeframe/Frame/Viewport.d.ts

@@ -1,4 +1,4 @@
-import { ShadowMapType, ToneMapping, WebGPURenderer, Object3D } from "three/webgpu";
+import { Object3D, ShadowMapType, ToneMapping, WebGPURenderer } from "three/webgpu";
 import { ThreeJsApp } from "../ThreeJsApp";
 import { PostProcessParam, PostProcessStepParam } from './../PostProcess/PostProcessParam';
 import { RendererParameters } from './Parameters/RendererParameters';
@@ -18,8 +18,7 @@ export declare class Viewport {
     private _canvasContainer;
     private isRenderStateDirty;
     private postProcessParam;
-    private postProcessing;
-    private outlineObjects;
+    private postProcessManager;
     constructor(app: ThreeJsApp, viewportParam: ViewportParam, rendererParam: RendererParameters, postProcessParam: PostProcessParam);
     protected createRenderer(rendererParam: RendererParameters): void;
     protected createLabelRenderer(): void;

package/package.json

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