@d5techs/3dgs-lib 1.0.1 → 1.1.0

package/dist/App.d.ts

@@ -17,7 +17,7 @@ import { MeshRenderer } from "./mesh/MeshRenderer";
 import { Mesh } from "./mesh/Mesh";
 import { GSSplatRenderer } from "./gs/GSSplatRenderer";
 import { GSSplatRendererMobile } from "./gs/GSSplatRendererMobile";
-import { BoundingBox } from "./gs/IGSSplatRenderer";
+import type { BoundingBox } from "./types";
 import { SplatTransformProxy, MeshGroupProxy, SplatBoundingBoxProvider } from "./interaction/GizmoManager";
 import { TransformableObject, GizmoMode } from "./core/gizmo/TransformGizmoV2";
 import { BoundingBoxProvider } from "./core/BoundingBoxRenderer";

package/dist/core/BoundingBoxRenderer.d.ts

@@ -1,19 +1,8 @@
 import { Renderer } from "./Renderer";
 import { Camera } from "./Camera";
-/**
- * BoundingBox 数据结构
- */
-export interface BoundingBox {
-    min: [number, number, number];
-    max: [number, number, number];
-}
-/**
- * BoundingBoxProvider - 包围盒数据提供者接口
- * 实现此接口的对象可以动态提供包围盒数据
- */
-export interface BoundingBoxProvider {
-    getBoundingBox(): BoundingBox | null;
-}
+import type { SimpleBoundingBox, BoundingBoxProvider } from "../types";
+export type { BoundingBoxProvider };
+export type BoundingBox = SimpleBoundingBox;
 /**
  * BoundingBoxRenderer - 包围盒线框渲染器
  * 用于显示选中对象的包围盒，支持动态跟随

package/dist/gs/GSSplatRenderer.d.ts

@@ -1,77 +1,35 @@
+/**
+ * GSSplatRenderer - 优化的 3D Gaussian Splatting 渲染器
+ *
+ * 基于 rfs-gsplat-render 的实现进行优化:
+ * 1. GPU Radix Sort - O(n) 稳定排序
+ * 2. Normalized Gaussian - 消除边缘雾化
+ * 3. ClipCorner 优化 - 减少 overdraw
+ * 4. MipSplatting 抗锯齿
+ * 5. 改进的视锥剔除
+ */
 import { Renderer } from "../core/Renderer";
 import { Camera } from "../core/Camera";
 import { SplatCPU } from "./PLYLoader";
 import { CompactSplatData } from "./PLYLoaderMobile";
-import { BoundingBox as IBoundingBox, SHMode as ISHMode, RendererCapabilities, IGSSplatRendererWithCapabilities } from "./IGSSplatRenderer";
-/**
- * 性能等级
- */
-export declare enum PerformanceTier {
-    HIGH = "high",// 桌面高端 GPU
-    MEDIUM = "medium",// 桌面中端
-    LOW = "low"
-}
-/**
- * 移动端优化配置
- */
-export interface MobileOptimizationConfig {
-    maxVisibleSplats: number;
-    enableSorting: boolean;
-    sortEveryNFrames: number;
-    useCompactFormat: boolean;
-    pixelCullThreshold: number;
-    defaultSHMode: SHMode;
-}
-/**
- * SH 模式枚举
- * @deprecated 使用 IGSSplatRenderer 中的 SHMode
- */
-export declare enum SHMode {
-    L0 = 0,// 仅 DC 颜色 (高性能)
-    L1 = 1,// DC + L1 SH
-    L2 = 2,// DC + L1 + L2 SH
-    L3 = 3
-}
-/**
- * Bounding Box 结构
- * @deprecated 使用 IGSSplatRenderer 中的 BoundingBox
- */
-export interface BoundingBox {
-    min: [number, number, number];
-    max: [number, number, number];
-    center: [number, number, number];
-    radius: number;
-}
-export type { IBoundingBox as GSBoundingBox };
+import type { BoundingBox, Vec3Tuple } from "../types";
+import { SHMode, RendererCapabilities } from "../types";
+import type { IGSSplatRendererWithCapabilities } from "./IGSSplatRenderer";
+export { SHMode };
+export type { BoundingBox };
 /**
- * GSSplatRenderer - 3D Gaussian Splatting 渲染器
- * 使用 instanced quad 方式渲染 splats
- * 实现 IGSSplatRenderer 接口
- *
- * 优化功能：
- * - GPU 可见性剔除 (视锥/近平面/屏幕尺寸)
- * - DrawIndirect 避免 CPU submit 开销
- * - 仅对可见 splat 排序
- * - 移动端自动优化（降低排序频率、使用紧凑格式）
+ * GSSplatRendererV2 - 优化的渲染器
  */
 export declare class GSSplatRenderer implements IGSSplatRendererWithCapabilities {
     private renderer;
     private camera;
-    private pipelineL0;
-    private pipelineL1;
-    private pipelineL2;
-    private pipelineL3;
-    private pipelineL0Compact;
+    private pipeline;
     private bindGroupLayout;
-    private bindGroupLayoutCompact;
     private uniformBuffer;
     private splatBuffer;
     private splatCount;
     private bindGroup;
     private sorter;
-    private useDrawIndirect;
-    private isMobile;
-    private pixelCullThreshold;
     private shMode;
     private boundingBox;
     private position;
@@ -79,139 +37,31 @@ export declare class GSSplatRenderer implements IGSSplatRendererWithCapabilities
     private scale;
     private pivot;
     private modelMatrix;
-    private performanceTier;
-    private optimizationConfig;
-    private frameCount;
-    private useCompactFormat;
+    private pixelCullThreshold;
     constructor(renderer: Renderer, camera: Camera);
-    /**
-     * 设置位置
-     */
+    private createPipeline;
+    private createUniformBuffer;
     setPosition(x: number, y: number, z: number): void;
-    /**
-     * 获取位置
-     */
-    getPosition(): [number, number, number];
-    /**
-     * 设置旋转 (欧拉角, 弧度)
-     */
+    getPosition(): Vec3Tuple;
     setRotation(x: number, y: number, z: number): void;
-    /**
-     * 获取旋转
-     */
-    getRotation(): [number, number, number];
-    /**
-     * 设置缩放
-     */
+    getRotation(): Vec3Tuple;
     setScale(x: number, y: number, z: number): void;
-    /**
-     * 获取缩放
-     */
-    getScale(): [number, number, number];
-    /**
-     * 设置旋转/缩放中心点 (pivot)
-     */
+    getScale(): Vec3Tuple;
     setPivot(x: number, y: number, z: number): void;
-    /**
-     * 获取旋转/缩放中心点 (pivot)
-     */
-    getPivot(): [number, number, number];
-    /**
-     * 更新模型矩阵
-     * 变换顺序: T * Tp * R * S * Tp^-1
-     * 即: 先移到原点，缩放，旋转，再移回pivot，最后应用用户平移
-     */
+    getPivot(): Vec3Tuple;
     private updateModelMatrix;
-    /**
-     * 获取当前模型矩阵
-     */
     getModelMatrix(): Float32Array;
-    /**
-     * 获取当前性能等级
-     */
-    getPerformanceTier(): PerformanceTier;
-    /**
-     * 手动设置优化配置
-     */
-    setOptimizationConfig(config: Partial<MobileOptimizationConfig>): void;
-    /**
-     * 获取当前优化配置
-     */
-    getOptimizationConfig(): MobileOptimizationConfig;
-    /**
-     * 设置 SH 模式
-     * @param mode L0/L1/L2/L3
-     */
     setSHMode(mode: SHMode): void;
-    /**
-     * 获取当前 SH 模式
-     */
     getSHMode(): SHMode;
-    /**
-     * 设置是否启用 DrawIndirect (剔除优化)
-     * 启用后会在 GPU 上进行可见性剔除，仅绘制可见 splat
-     */
-    setUseDrawIndirect(enabled: boolean): void;
-    /**
-     * 设置像素剔除阈值
-     * 屏幕上小于此像素数的 splat 会被剔除
-     * @param threshold 像素阈值，默认 1.0
-     */
     setPixelCullThreshold(threshold: number): void;
-    /**
-     * 创建渲染管线 (L0/L1/L2/L3 四个版本)
-     */
-    private createPipelines;
-    /**
-     * 创建 uniform buffer
-     * 布局: view (64 bytes) + proj (64 bytes) + model (64 bytes) + cameraPos (12 bytes) + padding (4 bytes) + screenSize (8 bytes) + padding (8 bytes) = 224 bytes
-     */
-    private createUniformBuffer;
-    /**
-     * 设置 splat 数据
-     * @param splats CPU 端的 splat 数组
-     */
     setData(splats: SplatCPU[]): void;
-    /**
-     * 设置紧凑格式的 splat 数据（移动端优化）
-     * 直接接受 CompactSplatData，避免创建中间对象
-     * @param compactData 紧凑格式的 splat 数据
-     */
     setCompactData(compactData: CompactSplatData): void;
-    /**
-     * 从紧凑数据计算 bounding box
-     */
-    private computeBoundingBoxFromCompact;
-    /**
-     * 渲染 splats
-     * @param pass 渲染通道编码器
-     */
     render(pass: GPURenderPassEncoder): void;
-    /**
-     * 获取 splat 数量
-     */
     getSplatCount(): number;
-    /**
-     * 获取点云的 bounding box
-     * @returns BoundingBox 或 null（如果没有点云数据）
-     */
     getBoundingBox(): BoundingBox | null;
-    /**
-     * 计算点云的 bounding box
-     * @param splats splat 数组
-     * @returns BoundingBox
-     */
     private computeBoundingBox;
-    /**
-     * 是否支持指定的 SH 模式
-     */
-    supportsSHMode(mode: ISHMode): boolean;
-    /**
-     * 获取渲染器能力
-     */
+    private computeBoundingBoxFromCompact;
+    supportsSHMode(mode: SHMode): boolean;
     getCapabilities(): RendererCapabilities;
-    /**
-     * 销毁资源
-     */
     destroy(): void;
 }

package/dist/gs/GSSplatRendererMobile.d.ts

@@ -10,8 +10,10 @@
 import { Renderer } from "../core/Renderer";
 import { Camera } from "../core/Camera";
 import { CompactSplatData } from "./PLYLoaderMobile";
-import { BoundingBox, SHMode, RendererCapabilities, IGSSplatRendererWithCapabilities } from "./IGSSplatRenderer";
-export type { BoundingBox } from "./IGSSplatRenderer";
+import type { BoundingBox, Vec3Tuple } from "../types";
+import { SHMode, RendererCapabilities } from "../types";
+import type { IGSSplatRendererWithCapabilities } from "./IGSSplatRenderer";
+export type { BoundingBox };
 /**
  * GSSplatRendererMobile - 移动端优化渲染器
  * 实现 IGSSplatRenderer 接口
@@ -45,7 +47,7 @@ export declare class GSSplatRendererMobile implements IGSSplatRendererWithCapabi
     /**
      * 获取位置
      */
-    getPosition(): [number, number, number];
+    getPosition(): Vec3Tuple;
     /**
      * 设置旋转 (欧拉角, 弧度)
      */
@@ -53,7 +55,7 @@ export declare class GSSplatRendererMobile implements IGSSplatRendererWithCapabi
     /**
      * 获取旋转
      */
-    getRotation(): [number, number, number];
+    getRotation(): Vec3Tuple;
     /**
      * 设置缩放
      */
@@ -61,7 +63,7 @@ export declare class GSSplatRendererMobile implements IGSSplatRendererWithCapabi
     /**
      * 获取缩放
      */
-    getScale(): [number, number, number];
+    getScale(): Vec3Tuple;
     /**
      * 设置旋转/缩放中心点 (pivot)
      */
@@ -69,7 +71,7 @@ export declare class GSSplatRendererMobile implements IGSSplatRendererWithCapabi
     /**
      * 获取旋转/缩放中心点 (pivot)
      */
-    getPivot(): [number, number, number];
+    getPivot(): Vec3Tuple;
     /**
      * 更新模型矩阵
      * 变换顺序: T * Tp * R * S * Tp^-1

package/dist/gs/GSSplatSorter.d.ts

@@ -1,18 +1,12 @@
 /**
- * GSSplatSorter - GPU Counting Sort 深度排序器
+ * GSSplatSorter - GPU Radix Sort 深度排序器
  *
- * 基于 PlayCanvas 的排序算法实现，使用 Counting Sort
- * 时间复杂度 O(n)，远比 Bitonic Sort O(n log²n) 更快
+ * 基于 rfs-gsplat-render 的 3-Pass Radix Sort 架构实现:
+ * - 4 个 pass (8-bit 增量，总共 32 位)
+ * - 每个 pass 包含: Upsweep -> Spine -> Downsweep
+ * - 稳定排序，解决远距离闪烁问题
  *
- * 流程：
- * 1. 剔除 + 计算深度 + 统计计数
- * 2. 前缀和计算偏移
- * 3. 散射到最终位置
- *
- * iOS 兼容性：
- * - iOS WebGPU 对大型原子数组支持有限
- * - 默认使用 65536 个桶（桌面/Android）
- * - iOS 使用 4096 个桶（减少原子操作压力）
+ * 参考: rfs-gsplat-render/assets/shaders/radix_sort.wgsl
  */
 /**
  * 屏幕尺寸信息
@@ -28,48 +22,61 @@ export interface CullingOptions {
     nearPlane: number;
     farPlane: number;
     pixelThreshold: number;
+    frustumDilation?: number;
 }
 /**
  * 排序器配置选项
  */
 export interface SorterOptions {
-    /** 深度桶数量（必须是 2 的幂次），默认根据平台自动选择 */
+    /** 暂时保留，Radix Sort 不使用桶配置 */
     numBuckets?: number;
 }
 /**
- * GSSplatSorter - GPU Counting Sort 排序器
+ * GSSplatSorter - GPU Radix Sort 排序器
+ * 基于 rfs-gsplat-render 的 3-Pass Radix Sort 实现
  */
 export declare class GSSplatSorter {
     private device;
     private splatCount;
     private cullingParamsBuffer;
-    private countersBuffer;
-    private visibleIndicesBuffer;
     private depthKeysBuffer;
-    private bucketCountsBuffer;
-    private bucketOffsetsBuffer;
-    private bucketPositionsBuffer;
+    private visibleIndicesBuffer;
+    private indirectBuffer;
+    private globalHistogramBuffer;
+    private partitionHistogramBuffer;
+    private keysTempBuffer;
+    private valuesTempBuffer;
+    private sortParamsBuffers;
     private sortedIndicesBuffer;
-    private drawIndirectBuffer;
-    private resetCountersPipeline;
-    private resetBucketCountsPipeline;
-    private cullAndCountPipeline;
-    private updateDrawIndirectPipeline;
-    private prefixSumPipeline;
-    private resetBucketPositionsPipeline;
-    private scatterPipeline;
+    private initIndirectPipeline;
+    private projectCullPipeline;
     private cullingBindGroupLayout;
     private cullingBindGroup;
-    private prefixSumBindGroupLayout;
-    private prefixSumBindGroup;
-    private scatterBindGroupLayout;
-    private scatterBindGroup;
-    private readonly WORKGROUP_SIZE;
-    private readonly numBuckets;
+    private upsweepPipeline;
+    private spinePipeline;
+    private downsweepPipeline;
+    private upsweepBindGroupLayout;
+    private spineBindGroupLayout;
+    private downsweepBindGroupLayout;
+    private upsweepBindGroups;
+    private spineBindGroups;
+    private downsweepBindGroups;
+    private numPartitions;
     private screenWidth;
     private screenHeight;
     private cullingOptions;
-    constructor(device: GPUDevice, splatCount: number, splatBuffer: GPUBuffer, cameraBuffer: GPUBuffer, options?: SorterOptions);
+    constructor(device: GPUDevice, splatCount: number, splatBuffer: GPUBuffer, cameraBuffer: GPUBuffer, _options?: SorterOptions);
+    /**
+     * 创建 Radix Sort 的 bind groups
+     * 4 个 pass，使用 ping-pong buffers
+     *
+     * Ping-pong 模式:
+     * - Pass 0: depthKeys/visibleIndices -> keysTempBuffer/valuesTempBuffer
+     * - Pass 1: keysTempBuffer/valuesTempBuffer -> depthKeys/visibleIndices
+     * - Pass 2: depthKeys/visibleIndices -> keysTempBuffer/valuesTempBuffer
+     * - Pass 3: keysTempBuffer/valuesTempBuffer -> (depthKeys)/sortedIndicesBuffer
+     */
+    private createRadixSortBindGroups;
     /**
      * 设置屏幕尺寸
      */
@@ -81,9 +88,6 @@ export declare class GSSplatSorter {
     /**
      * 执行剔除和排序
      * 每帧调用
-     *
-     * 优化：合并所有 compute pass 到单次 GPU 提交
-     * WebGPU 保证同一 command buffer 中的命令按顺序执行
      */
     sort(): void;
     /**

package/dist/gs/IGSSplatRenderer.d.ts

@@ -3,26 +3,12 @@
  *
  * 桌面端和移动端渲染器都实现此接口，消除平台判断代码
  */
-import { CompactSplatData } from "./PLYLoaderMobile";
-import { SplatCPU } from "./PLYLoader";
-/**
- * Bounding Box 结构
- */
-export interface BoundingBox {
-    min: [number, number, number];
-    max: [number, number, number];
-    center: [number, number, number];
-    radius: number;
-}
-/**
- * SH 模式枚举
- */
-export declare enum SHMode {
-    L0 = 0,// 仅 DC 颜色（最快）
-    L1 = 1,// DC + L1 SH
-    L2 = 2,// DC + L1 + L2 SH
-    L3 = 3
-}
+import type { CompactSplatData } from "./PLYLoaderMobile";
+import type { SplatCPU } from "./PLYLoader";
+import type { BoundingBox, Vec3Tuple } from "../types";
+import { SHMode, RendererCapabilities } from "../types";
+export type { BoundingBox, Vec3Tuple, RendererCapabilities };
+export { SHMode };
 /**
  * 3D Gaussian Splatting 渲染器接口
  */
@@ -47,7 +33,7 @@ export interface IGSSplatRenderer {
     /**
      * 获取位置
      */
-    getPosition(): [number, number, number];
+    getPosition(): Vec3Tuple;
     /**
      * 设置旋转（欧拉角，弧度）
      */
@@ -55,7 +41,7 @@ export interface IGSSplatRenderer {
     /**
      * 获取旋转
      */
-    getRotation(): [number, number, number];
+    getRotation(): Vec3Tuple;
     /**
      * 设置缩放
      */
@@ -63,7 +49,7 @@ export interface IGSSplatRenderer {
     /**
      * 获取缩放
      */
-    getScale(): [number, number, number];
+    getScale(): Vec3Tuple;
     /**
      * 设置旋转/缩放中心点（pivot）
      */
@@ -71,7 +57,7 @@ export interface IGSSplatRenderer {
     /**
      * 获取旋转/缩放中心点（pivot）
      */
-    getPivot(): [number, number, number];
+    getPivot(): Vec3Tuple;
     /**
      * 获取模型矩阵
      */
@@ -102,19 +88,6 @@ export interface IGSSplatRenderer {
      */
     destroy(): void;
 }
-/**
- * 渲染器能力描述
- */
-export interface RendererCapabilities {
-    /** 支持的最高 SH 模式 */
-    maxSHMode: SHMode;
-    /** 是否支持原始 SplatCPU 数据 */
-    supportsRawData: boolean;
-    /** 是否为移动端优化版本 */
-    isMobileOptimized: boolean;
-    /** 最大支持的 splat 数量（0 表示无限制） */
-    maxSplatCount: number;
-}
 /**
  * 获取渲染器能力（可选方法）
  */

package/dist/index.d.ts

@@ -2,6 +2,9 @@
  * WebGPU 3D 渲染引擎
  * 库入口文件 - 导出所有公共 API
  */
+export type { Vec3Tuple, Vec4Tuple, BoundingBox, SimpleBoundingBox, Transform, TransformableObject as ITransformableObject, BoundingBoxProvider as IBoundingBoxProvider, MaterialData, RendererCapabilities, } from './types';
+export { SHMode, DEFAULT_MATERIAL, DEFAULT_OBJ_MATERIAL } from './types';
+export { isMobileDevice, getRecommendedDPR, isWebGPUSupported, computeBoundingBox, mergeBoundingBoxes, createBoundingBoxFromMinMax, transformBoundingBox, loadTextureFromURL, loadTextureFromBlob, loadTextureFromBuffer, createTextureFromImageBitmap, TextureCache, } from './utils';
 export { Renderer } from './core/Renderer';
 export { Camera } from './core/Camera';
 export { OrbitControls } from './core/OrbitControls';
@@ -12,21 +15,20 @@ export { Mesh } from './mesh/Mesh';
 export type { MeshBoundingBox } from './mesh/Mesh';
 export { MeshRenderer } from './mesh/MeshRenderer';
 export { GLBLoader } from './loaders/GLBLoader';
-export type { MaterialData, LoadedMesh } from './loaders/GLBLoader';
+export type { LoadedMesh } from './loaders/GLBLoader';
 export { OBJLoader } from './loaders/OBJLoader';
 export { OBJParser } from './loaders/OBJParser';
 export type { ParsedOBJData, ParsedObject } from './loaders/OBJParser';
 export { MTLParser } from './loaders/MTLParser';
 export type { ParsedMaterial } from './loaders/MTLParser';
-export type { IGSSplatRenderer, IGSSplatRendererWithCapabilities, RendererCapabilities, BoundingBox, SHMode } from './gs/IGSSplatRenderer';
+export type { IGSSplatRenderer, IGSSplatRendererWithCapabilities, } from './gs/IGSSplatRenderer';
 export { loadPLY } from './gs/PLYLoader';
 export type { SplatCPU } from './gs/PLYLoader';
 export { loadPLYMobile, parsePLYBuffer, compactDataToGPUBuffer } from './gs/PLYLoaderMobile';
 export type { MobileLoadOptions, CompactSplatData } from './gs/PLYLoaderMobile';
 export { loadSplat, deserializeSplat } from './gs/SplatLoader';
-export { GSSplatRenderer, PerformanceTier } from './gs/GSSplatRenderer';
-export { SHMode as GSSHMode } from './gs/GSSplatRenderer';
-export type { MobileOptimizationConfig } from './gs/GSSplatRenderer';
+export { GSSplatRenderer, SHMode as GSSHMode } from './gs/GSSplatRenderer';
+export type { BoundingBox as GSSplatBoundingBox } from './gs/GSSplatRenderer';
 export { GSSplatSorter } from './gs/GSSplatSorter';
 export type { SorterOptions, CullingOptions, ScreenInfo } from './gs/GSSplatSorter';
 export { GSSplatRendererMobile } from './gs/GSSplatRendererMobile';
@@ -36,8 +38,9 @@ export { compressSplatsToTextures, destroyCompressedTextures, calculateTextureDi
 export type { CompressedSplatTextures } from './gs/TextureCompressor';
 export { SceneManager } from './scene/SceneManager';
 export type { SceneObjectType, SceneObjectInfo } from './scene/SceneManager';
+export { SplatTransformProxy, MeshGroupProxy, SplatBoundingBoxProvider, } from './scene/proxies';
 export { GizmoManager, SplatTransformProxy as GizmoSplatTransformProxy, MeshGroupProxy as GizmoMeshGroupProxy, SplatBoundingBoxProvider as GizmoSplatBoundingBoxProvider } from './interaction/GizmoManager';
-export { App, SplatTransformProxy, MeshGroupProxy, SplatBoundingBoxProvider } from './App';
+export { App } from './App';
 export type { ProgressCallback } from './App';
 export type { TransformableObject } from './core/gizmo/TransformGizmoV2';
 export { TransformGizmoV2, GizmoMode } from './core/gizmo/TransformGizmoV2';

package/dist/interaction/GizmoManager.d.ts

@@ -12,47 +12,10 @@ import { OrbitControls } from "../core/OrbitControls";
 import { ViewportGizmo } from "../core/ViewportGizmo";
 import { TransformGizmoV2, TransformableObject, GizmoMode } from "../core/gizmo/TransformGizmoV2";
 import { BoundingBoxRenderer, BoundingBox as RendererBoundingBox, BoundingBoxProvider } from "../core/BoundingBoxRenderer";
-import { IGSSplatRenderer } from "../gs/IGSSplatRenderer";
-import { Mesh } from "../mesh/Mesh";
-/**
- * SplatTransformProxy - PLY/Splat 变换代理对象
- * 实现类似 Mesh 的接口，让 TransformGizmo 可以操作 PLY 模型
- */
-export declare class SplatTransformProxy implements TransformableObject {
-    position: [number, number, number];
-    rotation: [number, number, number];
-    scale: [number, number, number];
-    private renderer;
-    private center;
-    constructor(renderer: IGSSplatRenderer, center: [number, number, number]);
-    setPosition(x: number, y: number, z: number): void;
-    setRotation(x: number, y: number, z: number): void;
-    setScale(x: number, y: number, z: number): void;
-}
-/**
- * MeshGroupProxy - 多 Mesh 组变换代理对象
- * 让 TransformGizmo 可以同时操作多个 Mesh
- */
-export declare class MeshGroupProxy implements TransformableObject {
-    position: [number, number, number];
-    rotation: [number, number, number];
-    scale: [number, number, number];
-    private meshes;
-    constructor(meshes: Mesh[]);
-    setPosition(x: number, y: number, z: number): void;
-    setRotation(x: number, y: number, z: number): void;
-    setScale(x: number, y: number, z: number): void;
-    getBoundingBox(): RendererBoundingBox | null;
-}
-/**
- * SplatBoundingBoxProvider - PLY/Splat 包围盒提供者
- * 动态获取 PLY 的包围盒（考虑变换）
- */
-export declare class SplatBoundingBoxProvider implements BoundingBoxProvider {
-    private renderer;
-    constructor(renderer: IGSSplatRenderer);
-    getBoundingBox(): RendererBoundingBox | null;
-}
+import type { IGSSplatRenderer } from "../gs/IGSSplatRenderer";
+import type { Mesh } from "../mesh/Mesh";
+import { SplatTransformProxy, MeshGroupProxy, SplatBoundingBoxProvider } from "../scene/proxies";
+export { SplatTransformProxy, MeshGroupProxy, SplatBoundingBoxProvider };
 /**
  * GizmoManager - Gizmo 交互管理器
  */

package/dist/loaders/GLBLoader.d.ts

@@ -1,14 +1,6 @@
 import { Mesh } from '../mesh/Mesh';
-/**
- * 材质数据
- */
-export interface MaterialData {
-    baseColorFactor: [number, number, number, number];
-    baseColorTexture: GPUTexture | null;
-    metallicFactor: number;
-    roughnessFactor: number;
-    doubleSided: boolean;
-}
+import type { MaterialData } from '../types';
+export type { MaterialData };
 /**
  * 加载后的 Mesh 数据（包含材质）
  */
@@ -51,7 +43,7 @@ export declare class GLBLoader {
     /**
      * 计算顶点数据的 bounding box
      */
-    private computeBoundingBox;
+    private computeBoundingBoxFromPositions;
     /**
      * 获取访问器数据 - 修复字节对齐问题
      */

package/dist/loaders/OBJLoader.d.ts

@@ -54,7 +54,7 @@ export declare class OBJLoader {
      * 计算顶点数据的 bounding box
      * Requirement 3.5: 计算并存储 bounding box 信息
      */
-    private computeBoundingBox;
+    private computeBoundingBoxFromPositions;
     /**
      * 创建材质数据
      * Requirement 4.3: 将材质关联到网格