lythreeframe 1.3.2 → 1.3.4

package/dist/index.d.ts

@@ -1,70 +1,72 @@
-export { AssetManager } from "./lythreeframe/AssetManagement/AssetManager";
-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";
-export { Controller } from "./lythreeframe/Frame/Controller";
-export type { HitResult, ComponentInteractionEvent, ComponentHoverEvent, ComponentPointerDownEvent, ActorInteractionEvent, ActorHoverEvent } from "./lythreeframe/Frame/Controller";
-export { Viewport } from "./lythreeframe/Frame/Viewport";
-export { World } from "./lythreeframe/Frame/World";
-export type { CameraParam, PerspectiveCameraParam, OrthographicCameraParam } from './lythreeframe/Frame/Parameters/CameraParameter';
-export { DefaultCameraParam, DefaultPerspectiveCameraParam, DefaultOrthographicCameraParam } from './lythreeframe/Frame/Parameters/CameraParameter';
-export type { AppParam, AppClass } from "./lythreeframe/Frame/Parameters/AppParameter";
-export { DefaultAppParam } from "./lythreeframe/Frame/Parameters/AppParameter";
-export type { ViewportParam } from './lythreeframe/Frame/Parameters/ViewportParameters';
-export { DefaultViewportParam } from './lythreeframe/Frame/Parameters/ViewportParameters';
-export type { WorldParam } from "./lythreeframe/Frame/Parameters/WorldParameter";
-export { DefaultWorldParam } from "./lythreeframe/Frame/Parameters/WorldParameter";
-export type { RendererParameters } from './lythreeframe/Frame/Parameters/RendererParameters';
-export { DefaultRendererParameters } from './lythreeframe/Frame/Parameters/RendererParameters';
-export { Actor } from "./lythreeframe/Object/Actor";
-export { DirectionalLightActor } from "./lythreeframe/Object/Actors/Light/DirectionalLightActor";
-export { AmbientLightActor } from './lythreeframe/Object/Actors/Light/AmbientLightActor';
-export { BoxActor } from "./lythreeframe/Object/Actors/Shape/BoxActor";
-export { SkyActor } from "./lythreeframe/Object/Actors/Sky/SkyActor";
-export { PlaneActor } from "./lythreeframe/Object/Actors/Shape/PlaneActor";
-export { LevelActor } from './lythreeframe/Object/Actors/Level/LevelActor';
-export { SceneComponent } from "./lythreeframe/Object/Components/SceneComponent";
-export { MeshComponent } from "./lythreeframe/Object/Components/Mesh/MeshComponent";
-export { BoxComponent } from "./lythreeframe/Object/Components/Mesh/Shape/BoxComponent";
-export { PlaneComponent } from "./lythreeframe/Object/Components/Mesh/Shape/PlaneComponent";
-export { SphereComponent } from "./lythreeframe/Object/Components/Mesh/Shape/SphereComponent";
-export { LevelComponent } from "./lythreeframe/Object/Components/Level/LevelComponent";
-export { DirectionalLightComponent } from "./lythreeframe/Object/Components/Light/DirectionalLight/DirectionalLightComponent";
-export { AmbientLightComponent } from './lythreeframe/Object/Components/Light/AmbientLight/AmbientLightComponent';
-export { LabelComponent } from "./lythreeframe/Object/Components/2D/2DComponent";
-export { SkyComponent } from "./lythreeframe/Object/Components/Sky/SkyComponent";
-export type { SkyComponentParam } from "./lythreeframe/Object/Components/Sky/SkyComponent";
-export { DefaultSkyParam } from "./lythreeframe/Object/Components/Sky/SkyComponent";
-export { DefaultPostProcessParam } from "./lythreeframe/PostProcess/PostProcessParam";
-export { PostProcessStepType } from "./lythreeframe/PostProcess/PostProcessParam";
-export type { PostProcessStepParam } from "./lythreeframe/PostProcess/PostProcessParam";
-export type { PostProcessParam } from "./lythreeframe/PostProcess/PostProcessParam";
-export { DefaultBloomParam } from "./lythreeframe/PostProcess/Param/Bloom";
-export type { BloomParam } from "./lythreeframe/PostProcess/Param/Bloom";
-export { DefaultDOFParam } from "./lythreeframe/PostProcess/Param/DOF";
-export type { DOFParam } from "./lythreeframe/PostProcess/Param/DOF";
-export { DefaultGTAOParam } from "./lythreeframe/PostProcess/Param/GTAO";
-export type { GTAOParam } from "./lythreeframe/PostProcess/Param/GTAO";
-export { DefaultOutlineParams } from "./lythreeframe/PostProcess/Param/Outline";
-export type { OutlineParams } from "./lythreeframe/PostProcess/Param/Outline";
-export { DefaultSSRParam } from "./lythreeframe/PostProcess/Param/SSR";
-export type { SSRParam } from "./lythreeframe/PostProcess/Param/SSR";
-export { DefaultAAParams } from "./lythreeframe/PostProcess/Param/AAParam";
-export type { AAParams } from "./lythreeframe/PostProcess/Param/AAParam";
-export { DefaultLensFlareParam } from "./lythreeframe/PostProcess/Param/LensFlare";
-export type { LensFlareParam } from "./lythreeframe/PostProcess/Param/LensFlare";
-export { PostProcessManager } from "./lythreeframe/Frame/Rendering/PostProcess";
-export { Orbital } from "./lythreeframe/Object/PawnV2/Oribital";
-export { FirstPerson } from "./lythreeframe/Object/PawnV2/FirstPerson";
-export type { ITransforming } from "./lythreeframe/Object/PawnV2/TransformControl";
-export type { TransformType } from "./lythreeframe/Object/PawnV2/TransformControl";
-export type { TransformGizmoOptions } from "./lythreeframe/Object/PawnV2/TransformControl";
-export { TransformGizmo } from "./lythreeframe/Object/PawnV2/TransformControl";
-export { ThreeObjectLibrary } from "./lythreeframe/Library/ResourceLibrary";
+export { AssetManager } from "./src/AssetManagement/AssetManager";
+export { TAssetPointer, ASSET_POINTER_KEY, EDITOR_ASSET_ID_KEY } from "./src/AssetManagement/AssetPointer/AssetPointer";
+export { TSmartPointer } from './src/Container/SmartPointer';
+export { MaterialAssetPointer } from "./src/AssetManagement/AssetPointer/Assets/MaterialAssetPointer";
+export { GeometryAssetPointer } from "./src/AssetManagement/AssetPointer/Assets/GeometryAssetPointer";
+export { TextureAssetPointer } from "./src/AssetManagement/AssetPointer/Assets/TextureAssetPointer";
+export { AssetCategory, AssetLoadState, ReferenceType, AssetType } from "./src/AssetManagement/AssetDefines";
+export type { AssetReference, AssetDescriptor } from "./src/AssetManagement/AssetDefines";
+export { AttachmentRules } from "./src/Defines";
+export { Delegate } from "./src/Delegate";
+export { ThreeJsApp } from "./src/ThreeJsApp";
+export { Controller } from "./src/Frame/Controller";
+export type { HitResult, ComponentInteractionEvent, ComponentHoverEvent, ComponentPointerDownEvent, ActorInteractionEvent, ActorHoverEvent } from "./src/Frame/Controller";
+export { Viewport } from "./src/Frame/Viewport";
+export { World } from "./src/Frame/World";
+export type { CameraParam, PerspectiveCameraParam, OrthographicCameraParam } from './src/Frame/Parameters/CameraParameter';
+export { DefaultCameraParam, DefaultPerspectiveCameraParam, DefaultOrthographicCameraParam } from './src/Frame/Parameters/CameraParameter';
+export type { AppParam, AppClass } from "./src/Frame/Parameters/AppParameter";
+export { DefaultAppParam } from "./src/Frame/Parameters/AppParameter";
+export type { ViewportParam } from './src/Frame/Parameters/ViewportParameters';
+export { DefaultViewportParam } from './src/Frame/Parameters/ViewportParameters';
+export type { WorldParam } from "./src/Frame/Parameters/WorldParameter";
+export { DefaultWorldParam } from "./src/Frame/Parameters/WorldParameter";
+export type { RendererParameters } from './src/Frame/Parameters/RendererParameters';
+export { DefaultRendererParameters } from './src/Frame/Parameters/RendererParameters';
+export { Actor } from "./src/Object/Actor";
+export { DirectionalLightActor } from "./src/Object/Actors/Light/DirectionalLightActor";
+export { AmbientLightActor } from './src/Object/Actors/Light/AmbientLightActor';
+export { BoxActor } from "./src/Object/Actors/Shape/BoxActor";
+export { SkyActor } from "./src/Object/Actors/Sky/SkyActor";
+export { PlaneActor } from "./src/Object/Actors/Shape/PlaneActor";
+export { LevelActor } from './src/Object/Actors/Level/LevelActor';
+export { SceneComponent } from "./src/Object/Components/SceneComponent";
+export { MeshComponent } from "./src/Object/Components/Mesh/MeshComponent";
+export { CustomMeshComponent } from "./src/Object/Components/Mesh/CustomMeshComponent";
+export type { CustomMeshData } from "./src/Object/Components/Mesh/CustomMeshComponent";
+export { BoxComponent } from "./src/Object/Components/Mesh/Shape/BoxComponent";
+export { PlaneComponent } from "./src/Object/Components/Mesh/Shape/PlaneComponent";
+export { SphereComponent } from "./src/Object/Components/Mesh/Shape/SphereComponent";
+export { LevelComponent } from "./src/Object/Components/Level/LevelComponent";
+export { DirectionalLightComponent } from "./src/Object/Components/Light/DirectionalLight/DirectionalLightComponent";
+export { AmbientLightComponent } from './src/Object/Components/Light/AmbientLight/AmbientLightComponent';
+export { LabelComponent } from "./src/Object/Components/2D/2DComponent";
+export { SkyComponent } from "./src/Object/Components/Sky/SkyComponent";
+export type { SkyComponentParam } from "./src/Object/Components/Sky/SkyComponent";
+export { DefaultSkyParam } from "./src/Object/Components/Sky/SkyComponent";
+export { DefaultPostProcessParam } from "./src/PostProcess/PostProcessParam";
+export { PostProcessStepType } from "./src/PostProcess/PostProcessParam";
+export type { PostProcessStepParam } from "./src/PostProcess/PostProcessParam";
+export type { PostProcessParam } from "./src/PostProcess/PostProcessParam";
+export { DefaultBloomParam } from "./src/PostProcess/Param/Bloom";
+export type { BloomParam } from "./src/PostProcess/Param/Bloom";
+export { DefaultDOFParam } from "./src/PostProcess/Param/DOF";
+export type { DOFParam } from "./src/PostProcess/Param/DOF";
+export { DefaultGTAOParam } from "./src/PostProcess/Param/GTAO";
+export type { GTAOParam } from "./src/PostProcess/Param/GTAO";
+export { DefaultOutlineParams } from "./src/PostProcess/Param/Outline";
+export type { OutlineParams } from "./src/PostProcess/Param/Outline";
+export { DefaultSSRParam } from "./src/PostProcess/Param/SSR";
+export type { SSRParam } from "./src/PostProcess/Param/SSR";
+export { DefaultAAParams } from "./src/PostProcess/Param/AAParam";
+export type { AAParams } from "./src/PostProcess/Param/AAParam";
+export { DefaultLensFlareParam } from "./src/PostProcess/Param/LensFlare";
+export type { LensFlareParam } from "./src/PostProcess/Param/LensFlare";
+export { PostProcessManager } from "./src/Frame/Rendering/PostProcess";
+export { Orbital } from "./src/Object/PawnV2/Oribital";
+export { FirstPerson } from "./src/Object/PawnV2/FirstPerson";
+export type { ITransforming } from "./src/Object/PawnV2/TransformControl";
+export type { TransformType } from "./src/Object/PawnV2/TransformControl";
+export type { TransformGizmoOptions } from "./src/Object/PawnV2/TransformControl";
+export { TransformGizmo } from "./src/Object/PawnV2/TransformControl";
+export { ThreeObjectLibrary } from "./src/Library/ResourceLibrary";

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

@@ -0,0 +1,65 @@
+/**
+ * 资产类别 - 用于底层资产管理
+ */
+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,
+    texture = 3,
+    undefined = -1
+}

package/dist/src/AssetManagement/AssetManager.d.ts

@@ -0,0 +1,35 @@
+import { BufferGeometry, LoadingManager, Material, Mesh, Texture } from "three/webgpu";
+import { SceneComponent } from "../Object/Components/SceneComponent";
+import { TAssetPointer } from "./AssetPointer/AssetPointer";
+import { DRACOLoader, GLTF, GLTFLoader } from 'three/examples/jsm/Addons.js';
+import { Object3D } from "three/webgpu";
+import { ThreeJsApp } from "../ThreeJsApp";
+import { MaterialAssetPointer } from "./AssetPointer/Assets/MaterialAssetPointer";
+import { TextureAssetPointer } from "./AssetPointer/Assets/TextureAssetPointer";
+import { GeometryAssetPointer } from "./AssetPointer/Assets/GeometryAssetPointer";
+export declare class AssetManager {
+    protected geometryAssets: Map<string, GeometryAssetPointer>;
+    protected textureAssets: Map<string, TextureAssetPointer>;
+    protected materialAssets: Map<string, MaterialAssetPointer>;
+    protected dracoLoader: DRACOLoader | null;
+    protected readonly gltfLoader: GLTFLoader;
+    protected readonly loadingManager: LoadingManager;
+    protected app: ThreeJsApp;
+    constructor(app: ThreeJsApp);
+    get LoadingManager(): LoadingManager;
+    init(): Promise<void>;
+    setupDracoLoader(dracoPath: string): void;
+    convertThreeObjectToLYObject(parentLYComponent: SceneComponent, threejsObject: Object3D): SceneComponent | null;
+    collectResourcesAndReferences(object: Object3D): void;
+    checkMeshResource(mesh: Mesh): void;
+    loadGltfFromPathAsync(path: string): Promise<GLTF>;
+    loadGltfFromPath(path: string, onLoadFinished: (gltf: GLTF) => void): void;
+    loadGltfFromBuffer(data: ArrayBuffer | string, path: string, onLoadFinished: (gltf: GLTF) => void): void;
+    loadFile(filepath: string | undefined, onLoadFinished: (data: string | ArrayBuffer) => void): void;
+    addAsset(asset: BufferGeometry | Material | Texture, referenceCount?: number): TAssetPointer<BufferGeometry | Material | Texture> | undefined;
+    addMaterialAsset(asset: Material, referenceCount?: number): MaterialAssetPointer;
+    addTextureAsset(asset: Texture, referenceCount?: number): TextureAssetPointer;
+    addGeometryAsset(asset: BufferGeometry, referenceCount?: number): GeometryAssetPointer;
+    releaseAsset(asset: BufferGeometry | Material | Texture): void;
+    clearAssets(): void;
+}

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

@@ -0,0 +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> {
+    private readonly _uuid;
+    get uuid(): string;
+    constructor(value: T, referenceCount?: number);
+    /**
+     * 释放资源，清理 userData 并调用 Three.js 的 dispose
+     */
+    protected dispose(): void;
+}

package/dist/src/AssetManagement/AssetPointer/Assets/GeometryAssetPointer.d.ts

@@ -0,0 +1,5 @@
+import { TAssetPointer } from "../AssetPointer";
+import { BufferGeometry } from "three/webgpu";
+export declare class GeometryAssetPointer extends TAssetPointer<BufferGeometry> {
+    constructor(value: BufferGeometry, referenceCount?: number);
+}

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

@@ -0,0 +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;
+    /**
+     * 移除纹理属性
+     */
+    removeTexture(name: string): void;
+    /**
+     * 释放材质时同时释放所有关联的纹理引用
+     */
+    protected dispose(): void;
+}

package/dist/src/AssetManagement/AssetPointer/Assets/TextureAssetPointer.d.ts

@@ -0,0 +1,5 @@
+import { TAssetPointer } from "../AssetPointer";
+import { Texture } from "three/webgpu";
+export declare class TextureAssetPointer extends TAssetPointer<Texture> {
+    constructor(value: Texture, referenceCount?: number);
+}

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

@@ -0,0 +1,15 @@
+export declare class TSmartPointer<T> {
+    protected referenceCount: number;
+    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/src/Defines.d.ts

@@ -0,0 +1,4 @@
+export declare enum AttachmentRules {
+    KeepWorld = 1,
+    KeepRelative = 2
+}

package/dist/src/Delegate.d.ts

@@ -0,0 +1,8 @@
+export declare class Delegate<T extends any[]> {
+    private functions;
+    constructor();
+    broadcast(...args: T): void;
+    add(func: (...args: T) => void): void;
+    remove(func: (...args: T) => void): void;
+    clear(): void;
+}

package/dist/src/Factory/CameraFactory.d.ts

@@ -0,0 +1,6 @@
+import { OrthographicCamera, PerspectiveCamera } from "three/webgpu";
+import { CameraParam } from "../Frame/Parameters/CameraParameter";
+export declare class CameraFactory {
+    static createCamera(param: CameraParam): PerspectiveCamera | OrthographicCamera;
+    static updataCamera(param: CameraParam, camera: PerspectiveCamera | OrthographicCamera): PerspectiveCamera | OrthographicCamera;
+}

package/dist/src/Factory/RendererFactory.d.ts

@@ -0,0 +1,2 @@
+export declare class RendererFactory {
+}

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

@@ -0,0 +1,130 @@
+import { ThreeJsApp } from "../ThreeJsApp";
+import { Euler, Intersection, OrthographicCamera, PerspectiveCamera, Quaternion, Raycaster, Vector2, Vector3 } from "three/webgpu";
+import { World } from "./World";
+import { Viewport } from "./Viewport";
+import { Pawn } from "../Object/PawnV2/Pawn";
+import { SceneComponent } from "../Object/Components/SceneComponent";
+import { Actor } from "../Object/Actor";
+import { Delegate } from "../Delegate";
+export interface HitResult {
+    component: SceneComponent;
+    hit: Intersection;
+}
+/** 组件交互事件 */
+export interface ComponentInteractionEvent {
+    component: SceneComponent;
+    hit: Intersection;
+    handled: boolean;
+    ctrlKey: boolean;
+    shiftKey: boolean;
+    altKey: boolean;
+}
+/** 组件悬停事件 */
+export interface ComponentHoverEvent {
+    component: SceneComponent;
+    hit: Intersection | null;
+    handled: boolean;
+}
+/** 组件按下事件 */
+export interface ComponentPointerDownEvent {
+    component: SceneComponent;
+    hit: Intersection;
+    button: number;
+    handled: boolean;
+}
+/** Actor 交互事件 */
+export interface ActorInteractionEvent {
+    actor: Actor;
+    component: SceneComponent;
+    hit: Intersection;
+    handled: boolean;
+    ctrlKey: boolean;
+    shiftKey: boolean;
+    altKey: boolean;
+}
+/** Actor 悬停事件 */
+export interface ActorHoverEvent {
+    actor: Actor;
+    component: SceneComponent;
+    hit: Intersection | null;
+    handled: boolean;
+}
+export declare class Controller {
+    protected _app: ThreeJsApp;
+    protected _pawn: Pawn | null;
+    protected raycaster: Raycaster;
+    protected hoveringComponent: SceneComponent | null;
+    protected hoveringActor: Actor | null;
+    protected prepareClickComponent: SceneComponent | null;
+    protected prepareClickHit: Intersection | null;
+    protected prepareClickModifiers: {
+        ctrlKey: boolean;
+        shiftKey: boolean;
+        altKey: boolean;
+    };
+    protected _pointButtonIsDown: Set<number>;
+    protected _onComponentClickDelegate: Delegate<[ComponentInteractionEvent]>;
+    protected _onComponentDoubleClickDelegate: Delegate<[ComponentInteractionEvent]>;
+    protected _onComponentHoverBeginDelegate: Delegate<[ComponentHoverEvent]>;
+    protected _onComponentHoverEndDelegate: Delegate<[ComponentHoverEvent]>;
+    protected _onComponentPointerDownDelegate: Delegate<[ComponentPointerDownEvent]>;
+    protected _onActorClickDelegate: Delegate<[ActorInteractionEvent]>;
+    protected _onActorDoubleClickDelegate: Delegate<[ActorInteractionEvent]>;
+    protected _onActorHoverBeginDelegate: Delegate<[ActorHoverEvent]>;
+    protected _onActorHoverEndDelegate: Delegate<[ActorHoverEvent]>;
+    protected _onClickNothingDelegate: Delegate<[void]>;
+    protected pointerPosition: Vector2;
+    protected pointerLeftDownPosition: Vector2;
+    protected readonly _tempVec2: Vector2;
+    protected readonly _raycastVec2: Vector2;
+    protected readonly doubleClickDelay: number;
+    protected leftClickTimer: number | null;
+    protected onPointerMove: (event: MouseEvent) => void;
+    protected onPointerEnter: (event: MouseEvent) => void;
+    protected onPointerLeave: (event: MouseEvent) => void;
+    protected onPointerUp: (event: MouseEvent) => void;
+    protected onPointerDown: (event: MouseEvent) => void;
+    get camera(): PerspectiveCamera | OrthographicCamera;
+    get world(): World;
+    get viewPort(): Viewport;
+    get app(): ThreeJsApp;
+    get pawn(): Pawn;
+    get onComponentClickDelegate(): Delegate<[ComponentInteractionEvent]>;
+    get onComponentDoubleClickDelegate(): Delegate<[ComponentInteractionEvent]>;
+    get onComponentHoverBeginDelegate(): Delegate<[ComponentHoverEvent]>;
+    get onComponentHoverEndDelegate(): Delegate<[ComponentHoverEvent]>;
+    get onComponentPointerDownDelegate(): Delegate<[ComponentPointerDownEvent]>;
+    get onActorClickDelegate(): Delegate<[ActorInteractionEvent]>;
+    get onActorDoubleClickDelegate(): Delegate<[ActorInteractionEvent]>;
+    get onActorHoverBeginDelegate(): Delegate<[ActorHoverEvent]>;
+    get onActorHoverEndDelegate(): Delegate<[ActorHoverEvent]>;
+    get onClickNothingDelegate(): Delegate<[void]>;
+    constructor(app: ThreeJsApp);
+    init(): void;
+    updateCamera(): void;
+    tick(deltaTime: number): void;
+    destroy(): void;
+    protected onPointerMoveEvent(event: MouseEvent): void;
+    protected clearHovering(): void;
+    protected onPointerUpEvent(event: MouseEvent): void;
+    protected handleFirstClick(): void;
+    protected handleDoubleClick(): void;
+    protected onPointerDownEvent(event: MouseEvent): void;
+    protected onPointerEnterEvent(_event: MouseEvent): void;
+    protected onPointerLeaveEvent(_event: MouseEvent): void;
+    protected fireComponentHoverBegin(component: SceneComponent, hit: Intersection): void;
+    protected fireComponentHoverEnd(component: SceneComponent): void;
+    protected fireComponentClick(component: SceneComponent, hit: Intersection, isDoubleClick: boolean): void;
+    protected firePointerDownEvent(component: SceneComponent, hit: Intersection, button: number): void;
+    protected fireActorHoverBegin(actor: Actor, component: SceneComponent, hit: Intersection): void;
+    protected fireActorHoverEnd(actor: Actor, component: SceneComponent): void;
+    protected fireActorClick(actor: Actor, component: SceneComponent, hit: Intersection, isDoubleClick: boolean): void;
+    protected fireClickEvents(component: SceneComponent, hit: Intersection, isDoubleClick: boolean): void;
+    protected clearClickTimer(): void;
+    protected addCorePointerListeners(): void;
+    protected removeCorePointerListeners(): void;
+    getHitResultUnderCursor(): HitResult | null;
+    getHitResultFromScreenPoint(x: number, y: number): HitResult | null;
+    getAllHitResultFromScreenPoint(x: number, y: number): HitResult[];
+    focusTo(targetPos: Vector3, targetQuat: Quaternion | Euler, distance: number, time: number, onGoing?: (() => void) | null, onFinished?: (() => void) | null): void;
+}

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

@@ -0,0 +1,25 @@
+import { CameraParam } from "./CameraParameter";
+import { WorldParam } from "./WorldParameter";
+import { Controller } from "../Controller";
+import { World } from "../World";
+import { Viewport } from "../Viewport";
+import { ViewportParam } from "./ViewportParameters";
+import { AssetManager } from "../../AssetManagement/AssetManager";
+import { PostProcessParam } from "../../PostProcess/PostProcessParam";
+import { RendererParameters } from "./RendererParameters";
+export interface AppClass {
+    assetManagerClass: typeof AssetManager;
+    controllerClass: typeof Controller;
+    worldClass: typeof World;
+    viewportClass: typeof Viewport;
+}
+export interface AppParam {
+    renderParam?: RendererParameters;
+    cameraParam?: CameraParam;
+    postProcessParam?: PostProcessParam;
+    worldParam?: WorldParam;
+    viewportParam: ViewportParam;
+    classes?: AppClass;
+    isRenderEveryFrame?: boolean;
+}
+export declare const DefaultAppParam: AppParam;

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

@@ -0,0 +1,22 @@
+export interface CameraParam {
+    type: "Perspective" | "Orthographic";
+}
+export interface PerspectiveCameraParam extends CameraParam {
+    type: "Perspective";
+    fov: number;
+    aspect: number;
+    near: number;
+    far: number;
+}
+export interface OrthographicCameraParam extends CameraParam {
+    type: "Orthographic";
+    left: number;
+    right: number;
+    top: number;
+    bottom: number;
+    near: number;
+    far: number;
+}
+export declare const DefaultPerspectiveCameraParam: PerspectiveCameraParam;
+export declare const DefaultOrthographicCameraParam: OrthographicCameraParam;
+export declare const DefaultCameraParam: CameraParam;

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

@@ -0,0 +1,17 @@
+import { ShadowMapType, TextureDataType, ToneMapping } from "three/webgpu";
+export interface RendererParameters {
+    logarithmicDepthBuffer?: boolean | undefined;
+    alpha?: boolean | undefined;
+    depth?: boolean | undefined;
+    stencil?: boolean | undefined;
+    antialias?: boolean | undefined;
+    samples?: number | undefined;
+    forceWebGL?: boolean | undefined;
+    outputBufferType?: TextureDataType | undefined;
+    toneMapping: ToneMapping;
+    toneMappingExposure: number;
+    shadowMapEnabled: boolean;
+    shadowMapType: ShadowMapType | null;
+}
+export declare const DefaultRendererParameters: RendererParameters;
+export declare const RendererParametersNeedsRebuild: never[];

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

@@ -0,0 +1,6 @@
+export interface ViewportParam {
+    elementId: string | null;
+    isLabelRendererNeeded: boolean;
+    isUILayerNeeded: boolean;
+}
+export declare const DefaultViewportParam: ViewportParam;

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

@@ -0,0 +1,5 @@
+import { LevelActor } from "../../Object/Actors/Level/LevelActor";
+export interface WorldParam {
+    levelActorClass: typeof LevelActor;
+}
+export declare const DefaultWorldParam: WorldParam;

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

@@ -0,0 +1,45 @@
+import { Camera, Data3DTexture, Object3D, PostProcessing, Scene, WebGPURenderer } from "three/webgpu";
+import { PostProcessParam, PostProcessStepParam } from '../../PostProcess/PostProcessParam';
+export declare class PostProcessManager {
+    private postProcessParam;
+    private postProcessing;
+    private outlineObjects;
+    private effectUniforms;
+    private outlinePass;
+    private bloomPass;
+    private dofPass;
+    private gtaoPass;
+    private traaPass;
+    private lensflarePass;
+    private lut3dTexture;
+    private renderer;
+    protected scene: Scene;
+    protected camera: Camera;
+    private onDirtyCallback;
+    constructor(renderer: WebGPURenderer, scene: Scene, camera: Camera, postProcessParam: PostProcessParam, onDirtyCallback?: () => void);
+    get processing(): PostProcessing | null;
+    updateCamera(camera: Camera): void;
+    setup(): void;
+    private buildPipeline;
+    /** Hook for subclasses to modify the final output node. Override to add custom effects. */
+    protected onBuildFinalNode(node: any): any;
+    private createEffectUniforms;
+    private getStepParam;
+    private updateAllUniforms;
+    updateSteps(steps: PostProcessStepParam[]): void;
+    addOutlineObject(obj: Object3D): void;
+    setOutlineObjects(objects: Object3D[]): void;
+    removeOutlineObject(obj: Object3D): void;
+    /**
+     * 设置 3D LUT 纹理
+     * @param lutTexture 3D LUT 纹理，传 null 清除
+     */
+    setLUT3DTexture(lutTexture: Data3DTexture | null): void;
+    /**
+     * 获取当前 3D LUT 纹理
+     */
+    getLUT3DTexture(): Data3DTexture | null;
+    render(): boolean;
+    destroy(): void;
+    private markDirty;
+}