@d5techs/3dgs-lib 1.0.0

package/dist/gs/PLYLoaderMobile.d.ts

@@ -0,0 +1,62 @@
+/**
+ * PLYLoaderMobile - 移动端优化的 PLY 加载器
+ *
+ * 优化点：
+ * 1. 直接输出 GPU buffer 格式，避免中间对象
+ * 2. 流式降采样，减少内存峰值
+ * 3. 可选跳过 SH 系数（移动端 L0 模式）
+ * 4. 使用 TypedArray 而非对象数组
+ * 5. 支持多种 PLY 数据类型
+ * 6. 确定性采样（基于文件内容的种子）
+ */
+/**
+ * 移动端加载配置
+ */
+export interface MobileLoadOptions {
+    /** 最大 splat 数量，超过则降采样 */
+    maxSplats?: number;
+    /** 是否加载 SH 系数（false 时只加载 DC 颜色） */
+    loadSH?: boolean;
+    /** 进度回调 */
+    onProgress?: (loaded: number, total: number) => void;
+    /** 随机种子（用于确定性采样，默认使用文件大小作为种子） */
+    seed?: number;
+}
+/**
+ * 紧凑 Splat 数据（用于移动端）
+ * 直接返回 Float32Array，而非对象数组
+ */
+export interface CompactSplatData {
+    /** splat 数量 */
+    count: number;
+    /** 位置数据 Float32Array [x,y,z, x,y,z, ...] */
+    positions: Float32Array;
+    /** 缩放数据 Float32Array [sx,sy,sz, sx,sy,sz, ...] */
+    scales: Float32Array;
+    /** 旋转四元数 Float32Array [w,x,y,z, w,x,y,z, ...] */
+    rotations: Float32Array;
+    /** DC 颜色 Float32Array [r,g,b, r,g,b, ...] */
+    colors: Float32Array;
+    /** 不透明度 Float32Array [a, a, ...] */
+    opacities: Float32Array;
+    /** SH 系数（可选）Float32Array，每个 splat 45 个系数 */
+    shCoeffs?: Float32Array;
+}
+/**
+ * 移动端优化的 PLY 加载器
+ * 直接输出紧凑格式，避免创建大量中间对象
+ */
+export declare function loadPLYMobile(url: string, options?: MobileLoadOptions): Promise<CompactSplatData>;
+/**
+ * 解析 PLY ArrayBuffer
+ * 可以直接传入 ArrayBuffer 进行解析，用于本地文件加载
+ */
+export declare function parsePLYBuffer(buffer: ArrayBuffer, options?: MobileLoadOptions): Promise<CompactSplatData>;
+/**
+ * 将 CompactSplatData 转换为 GPU buffer 格式
+ * 直接输出可以上传到 GPU 的 Float32Array
+ *
+ * @param data 紧凑 splat 数据
+ * @param includeFullSH 是否包含完整 SH 系数（256 字节/splat），否则只包含基本数据（64 字节/splat）
+ */
+export declare function compactDataToGPUBuffer(data: CompactSplatData, includeFullSH?: boolean): Float32Array;

package/dist/gs/SplatLoader.d.ts

@@ -0,0 +1,25 @@
+/**
+ * SplatLoader - 加载 .splat 格式的 3D Gaussian Splatting 文件
+ *
+ * .splat 格式是一种紧凑的 3DGS 数据格式：
+ * - 每个 splat 固定 32 字节，无文件头
+ * - 数据布局: position(12) + scale(12) + color(3) + opacity(1) + rotation(4)
+ * - 不包含高阶球谐系数，仅 DC 颜色
+ *
+ * 四元数顺序: [w, x, y, z]（与 PLYLoader 保持一致）
+ *
+ * 参考: supersplat/src/loaders/splat.ts
+ */
+import { SplatCPU } from "./PLYLoader";
+/**
+ * 加载并解析 .splat 文件
+ * @param url .splat 文件的 URL
+ * @returns SplatCPU 数组
+ */
+export declare function loadSplat(url: string): Promise<SplatCPU[]>;
+/**
+ * 从 ArrayBuffer 解析 splat 数据
+ * @param data 文件的 ArrayBuffer
+ * @returns SplatCPU 数组
+ */
+export declare function deserializeSplat(data: ArrayBufferLike): SplatCPU[];

package/dist/gs/TextureCompressor.d.ts

@@ -0,0 +1,57 @@
+/**
+ * TextureCompressor - 移动端纹理压缩工具
+ * 将 splat 数据压缩为纹理格式，大幅减少 GPU 内存占用
+ *
+ * 内存对比：
+ * - 原始 Storage Buffer: 256 bytes/splat
+ * - 纹理压缩: ~52 bytes/splat (约 5x 压缩)
+ *
+ * 数据布局（保证精度）：
+ * - positionTexture (RGBA32Float): x, y, z, unused - 16 bytes
+ * - scaleRotTexture1 (RGBA32Float): scale_x, scale_y, scale_z, rot_w - 16 bytes
+ * - scaleRotTexture2 (RGBA32Float): rot_x, rot_y, rot_z, unused - 16 bytes
+ * - colorTexture (RGBA8Unorm): r, g, b, opacity - 4 bytes
+ * 总计: 52 bytes/splat
+ *
+ * 注意：使用 RGBA32Float 替代 RGBA16Float 以保证 scale 和 rotation 的精度，
+ * 避免平面等细节渲染出现块状伪影。
+ */
+import { CompactSplatData } from "./PLYLoaderMobile";
+/**
+ * 压缩后的纹理数据
+ */
+export interface CompressedSplatTextures {
+    width: number;
+    height: number;
+    count: number;
+    positionTexture: GPUTexture;
+    scaleRotTexture1: GPUTexture;
+    scaleRotTexture2: GPUTexture;
+    colorTexture: GPUTexture;
+    boundingBox: {
+        min: [number, number, number];
+        max: [number, number, number];
+    };
+}
+/**
+ * 计算纹理尺寸
+ * 将 splat 数量映射到 2D 纹理尺寸
+ * @param count splat 数量
+ * @returns 纹理宽度和高度（向上取整到 4 的倍数）
+ */
+export declare function calculateTextureDimensions(count: number): {
+    width: number;
+    height: number;
+};
+/**
+ * 将 splat 数据压缩为纹理格式
+ * @param device GPU 设备
+ * @param data 紧凑格式的 splat 数据
+ * @returns 压缩后的纹理数据
+ */
+export declare function compressSplatsToTextures(device: GPUDevice, data: CompactSplatData): CompressedSplatTextures;
+/**
+ * 销毁压缩纹理资源
+ * @param textures 压缩纹理数据
+ */
+export declare function destroyCompressedTextures(textures: CompressedSplatTextures): void;

package/dist/index.d.ts

@@ -0,0 +1,44 @@
+/**
+ * WebGPU 3D 渲染引擎
+ * 库入口文件 - 导出所有公共 API
+ */
+export { Renderer } from './core/Renderer';
+export { Camera } from './core/Camera';
+export { OrbitControls } from './core/OrbitControls';
+export { ViewportGizmo } from './core/ViewportGizmo';
+export { BoundingBoxRenderer } from './core/BoundingBoxRenderer';
+export type { BoundingBox as SelectionBoundingBox, BoundingBoxProvider } from './core/BoundingBoxRenderer';
+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 { 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 { 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 { GSSplatSorter } from './gs/GSSplatSorter';
+export type { SorterOptions, CullingOptions, ScreenInfo } from './gs/GSSplatSorter';
+export { GSSplatRendererMobile } from './gs/GSSplatRendererMobile';
+export { GSSplatSorterMobile } from './gs/GSSplatSorterMobile';
+export type { SorterOptions as MobileSorterOptions, CullingOptions as MobileCullingOptions } from './gs/GSSplatSorterMobile';
+export { compressSplatsToTextures, destroyCompressedTextures, calculateTextureDimensions } from './gs/TextureCompressor';
+export type { CompressedSplatTextures } from './gs/TextureCompressor';
+export { SceneManager } from './scene/SceneManager';
+export type { SceneObjectType, SceneObjectInfo } from './scene/SceneManager';
+export { GizmoManager, SplatTransformProxy as GizmoSplatTransformProxy, MeshGroupProxy as GizmoMeshGroupProxy, SplatBoundingBoxProvider as GizmoSplatBoundingBoxProvider } from './interaction/GizmoManager';
+export { App, SplatTransformProxy, MeshGroupProxy, SplatBoundingBoxProvider } from './App';
+export type { ProgressCallback } from './App';
+export type { TransformableObject } from './core/gizmo/TransformGizmoV2';
+export { TransformGizmoV2, GizmoMode } from './core/gizmo/TransformGizmoV2';
+export type { GizmoTheme, TransformGizmoConfig, GizmoSpace } from './core/gizmo/TransformGizmoV2';

package/dist/interaction/GizmoManager.d.ts

@@ -0,0 +1,132 @@
+/**
+ * GizmoManager - Gizmo 交互管理器
+ *
+ * 负责管理所有 Gizmo 相关的交互：
+ * - TransformGizmo（变换控制）
+ * - ViewportGizmo（视口坐标轴）
+ * - BoundingBoxRenderer（选中对象包围盒）
+ */
+import { Renderer } from "../core/Renderer";
+import { Camera } from "../core/Camera";
+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;
+}
+/**
+ * GizmoManager - Gizmo 交互管理器
+ */
+export declare class GizmoManager {
+    private renderer;
+    private camera;
+    private canvas;
+    private controls;
+    private viewportGizmo;
+    private transformGizmo;
+    private boundingBoxRenderer;
+    private boundOnClick;
+    private boundOnPointerMove;
+    private boundOnPointerDown;
+    private boundOnPointerUp;
+    constructor(renderer: Renderer, camera: Camera, canvas: HTMLCanvasElement, controls: OrbitControls);
+    /**
+     * 设置事件监听器
+     */
+    private setupEventListeners;
+    private onCanvasClick;
+    private onPointerMove;
+    private onPointerDown;
+    private onPointerUp;
+    /**
+     * 渲染所有 Gizmo
+     */
+    render(pass: GPURenderPassEncoder): void;
+    /**
+     * 获取变换 Gizmo
+     */
+    getTransformGizmo(): TransformGizmoV2;
+    /**
+     * 设置 Gizmo 模式
+     */
+    setGizmoMode(mode: GizmoMode): void;
+    /**
+     * 设置 Gizmo 目标对象
+     */
+    setGizmoTarget(object: TransformableObject | null): void;
+    /**
+     * 获取视口 Gizmo
+     */
+    getViewportGizmo(): ViewportGizmo;
+    /**
+     * 获取包围盒渲染器
+     */
+    getBoundingBoxRenderer(): BoundingBoxRenderer;
+    /**
+     * 设置选中对象的包围盒（静态模式）
+     */
+    setSelectionBoundingBox(box: RendererBoundingBox | null): void;
+    /**
+     * 设置选中对象的包围盒提供者（动态模式）
+     */
+    setSelectionBoundingBoxProvider(provider: BoundingBoxProvider | null): void;
+    /**
+     * 清除选中对象的包围盒
+     */
+    clearSelectionBoundingBox(): void;
+    /**
+     * 创建 Splat 变换代理
+     */
+    createSplatTransformProxy(renderer: IGSSplatRenderer): SplatTransformProxy | null;
+    /**
+     * 创建 Mesh 组变换代理
+     */
+    createMeshGroupProxy(meshes: Mesh[]): MeshGroupProxy | null;
+    /**
+     * 创建 Splat 包围盒提供者
+     */
+    createSplatBoundingBoxProvider(renderer: IGSSplatRenderer): SplatBoundingBoxProvider;
+    /**
+     * 销毁
+     */
+    destroy(): void;
+}

package/dist/loaders/GLBLoader.d.ts

@@ -0,0 +1,67 @@
+import { Mesh } from '../mesh/Mesh';
+/**
+ * 材质数据
+ */
+export interface MaterialData {
+    baseColorFactor: [number, number, number, number];
+    baseColorTexture: GPUTexture | null;
+    metallicFactor: number;
+    roughnessFactor: number;
+    doubleSided: boolean;
+}
+/**
+ * 加载后的 Mesh 数据（包含材质）
+ */
+export interface LoadedMesh {
+    mesh: Mesh;
+    material: MaterialData;
+}
+/**
+ * GLBLoader - GLB 文件加载器
+ * 解析 GLB 文件并生成 Mesh[]，支持贴图
+ */
+export declare class GLBLoader {
+    private device;
+    private textureCache;
+    constructor(device: GPUDevice);
+    /**
+     * 加载 GLB 文件
+     */
+    load(url: string): Promise<LoadedMesh[]>;
+    /**
+     * 解析 GLB 二进制数据
+     */
+    private parse;
+    /**
+     * 解析所有网格
+     */
+    private parseMeshes;
+    /**
+     * 解析单个图元
+     */
+    private parsePrimitive;
+    /**
+     * 解析材质
+     */
+    private parseMaterial;
+    /**
+     * 加载纹理
+     */
+    private loadTexture;
+    /**
+     * 计算顶点数据的 bounding box
+     */
+    private computeBoundingBox;
+    /**
+     * 获取访问器数据 - 修复字节对齐问题
+     */
+    private getAccessorData;
+    /**
+     * 创建测试立方体（用于调试）
+     */
+    createTestCube(): LoadedMesh;
+    /**
+     * 创建测试球体
+     */
+    createTestSphere(radius?: number, segments?: number, rings?: number): LoadedMesh;
+}

package/dist/loaders/MTLParser.d.ts

@@ -0,0 +1,65 @@
+/**
+ * MTLParser - MTL 材质文件解析器
+ * 解析 MTL 文件文本内容，提取材质数据
+ */
+/**
+ * 解析后的材质数据
+ */
+export interface ParsedMaterial {
+    name: string;
+    diffuseColor: [number, number, number];
+    diffuseTexture: string | null;
+    opacity: number;
+}
+/**
+ * MTL 文本解析器
+ */
+export declare class MTLParser {
+    private currentMaterial;
+    private materials;
+    /**
+     * 解析 MTL 文本内容
+     * @param text MTL 文件文本
+     * @returns 材质名称到材质数据的映射
+     */
+    parse(text: string): Map<string, ParsedMaterial>;
+    /**
+     * 重置解析器状态
+     */
+    private reset;
+    /**
+     * 解析单行
+     */
+    private parseLine;
+    /**
+     * 解析新材质定义 (newmtl name)
+     */
+    private parseNewMaterial;
+    /**
+     * 解析漫反射颜色 (Kd r g b)
+     */
+    private parseDiffuseColor;
+    /**
+     * 解析漫反射纹理路径 (map_Kd path)
+     */
+    private parseDiffuseTexture;
+    /**
+     * 解析透明度 (d factor)
+     * d = 1.0 表示完全不透明，d = 0.0 表示完全透明
+     */
+    private parseOpacity;
+    /**
+     * 解析透明度 (Tr factor)
+     * Tr = 0.0 表示完全不透明，Tr = 1.0 表示完全透明
+     * 与 d 相反，所以 opacity = 1 - Tr
+     */
+    private parseTransparency;
+    /**
+     * 创建默认材质
+     */
+    private createDefaultMaterial;
+    /**
+     * 完成当前材质并添加到映射
+     */
+    private finalizeCurrentMaterial;
+}

package/dist/loaders/OBJLoader.d.ts

@@ -0,0 +1,68 @@
+/**
+ * OBJLoader - OBJ 文件加载器
+ * 解析 OBJ 文件并生成 Mesh[]，支持 MTL 材质
+ */
+import { LoadedMesh } from './GLBLoader';
+/**
+ * OBJLoader - OBJ 文件加载器
+ * 解析 OBJ 文件并生成 LoadedMesh[]
+ */
+export declare class OBJLoader {
+    private device;
+    private textureCache;
+    constructor(device: GPUDevice);
+    /**
+     * 加载 OBJ 文件
+     * @param url OBJ 文件 URL
+     * @returns 加载后的网格数组
+     *
+     * Requirements: 2.1, 2.2, 2.3
+     */
+    load(url: string): Promise<LoadedMesh[]>;
+    /**
+     * 从文本解析 OBJ（用于直接传入内容）
+     * @param text OBJ 文本内容
+     * @param baseUrl 基础 URL（用于加载 MTL 和纹理）
+     * @returns 加载后的网格数组
+     *
+     * Requirements: 2.1, 2.3
+     */
+    parseFromText(text: string, baseUrl?: string): Promise<LoadedMesh[]>;
+    /**
+     * 提取 MTL 文件引用
+     */
+    private extractMTLReference;
+    /**
+     * 加载 MTL 材质文件
+     * Requirement 4.1, 4.4: 加载 MTL 文件，失败时使用默认材质
+     */
+    private loadMTL;
+    /**
+     * 创建 LoadedMesh 数组
+     */
+    private createMeshes;
+    /**
+     * 创建单个 Mesh
+     */
+    private createMesh;
+    /**
+     * 生成平面法线（当 OBJ 缺少法线数据时）
+     * Requirement 3.2: 从面几何计算平面法线
+     */
+    private generateFlatNormals;
+    /**
+     * 计算顶点数据的 bounding box
+     * Requirement 3.5: 计算并存储 bounding box 信息
+     */
+    private computeBoundingBox;
+    /**
+     * 创建材质数据
+     * Requirement 4.3: 将材质关联到网格
+     */
+    private createMaterial;
+    /**
+     * 加载纹理
+     * Requirement 4.5, 6.3: 加载纹理，失败时使用 null
+     */
+    private loadTexture;
+}

package/dist/loaders/OBJParser.d.ts

@@ -0,0 +1,115 @@
+/**
+ * OBJParser - OBJ 文件文本解析器
+ * 解析 OBJ 文件文本内容，提取几何数据
+ */
+/**
+ * 解析后的 OBJ 数据结构
+ */
+export interface ParsedOBJData {
+    objects: ParsedObject[];
+}
+/**
+ * 单个对象/组的数据
+ */
+export interface ParsedObject {
+    name: string;
+    positions: number[];
+    normals: number[];
+    uvs: number[];
+    indices: number[];
+    materialName: string | null;
+}
+/**
+ * OBJ 文本解析器
+ */
+export declare class OBJParser {
+    private positions;
+    private uvs;
+    private normals;
+    private currentObject;
+    private objects;
+    private currentMaterial;
+    private vertexMap;
+    private vertexCount;
+    private warnedDirectives;
+    /**
+     * 解析 OBJ 文本内容
+     * @param text OBJ 文件文本
+     * @returns 解析后的数据结构
+     */
+    parse(text: string): ParsedOBJData;
+    /**
+     * 重置解析器状态
+     */
+    private reset;
+    /**
+     * 警告不支持的指令（仅首次出现时警告）
+     * @param directive 指令名称
+     * @param lineNum 行号
+     */
+    private warnUnsupportedDirective;
+    /**
+     * 解析单行
+     */
+    private parseLine;
+    /**
+     * 解析顶点位置 (v x y z [w])
+     */
+    private parseVertex;
+    /**
+     * 解析纹理坐标 (vt u [v] [w])
+     */
+    private parseTextureCoord;
+    /**
+     * 解析法线 (vn x y z)
+     */
+    private parseNormal;
+    /**
+     * 解析面 (f v1 v2 v3 ...)
+     * 支持四种格式:
+     * - f v v v (仅顶点)
+     * - f v/vt v/vt v/vt (顶点/纹理)
+     * - f v/vt/vn v/vt/vn v/vt/vn (顶点/纹理/法线)
+     * - f v//vn v//vn v//vn (顶点//法线)
+     */
+    private parseFace;
+    /**
+     * 解析面顶点索引
+     * 支持格式: v, v/vt, v/vt/vn, v//vn
+     */
+    private parseFaceVertex;
+    /**
+     * 解析索引，支持负索引
+     * 负索引表示相对于当前顶点数的偏移（-1 表示最后一个顶点）
+     */
+    private resolveIndex;
+    /**
+     * 添加三角形到当前对象
+     */
+    private addTriangle;
+    /**
+     * 添加顶点到当前对象，返回索引
+     * 使用顶点去重，相同的顶点组合只添加一次
+     */
+    private addVertex;
+    /**
+     * 解析对象或组 (o name / g name)
+     */
+    private parseObjectOrGroup;
+    /**
+     * 解析材质引用 (usemtl name)
+     */
+    private parseUseMaterial;
+    /**
+     * 确保存在当前对象
+     */
+    private ensureCurrentObject;
+    /**
+     * 创建新对象
+     */
+    private createNewObject;
+    /**
+     * 完成当前对象并添加到列表
+     */
+    private finalizeCurrentObject;
+}

package/dist/mesh/Mesh.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Bounding Box 结构（与 GSSplatRenderer 共享接口）
+ */
+export interface MeshBoundingBox {
+    min: [number, number, number];
+    max: [number, number, number];
+    center: [number, number, number];
+    radius: number;
+}
+/**
+ * Mesh - 网格数据结构
+ * 存储 GPUBuffer + 变换属性
+ */
+export declare class Mesh {
+    vertexBuffer: GPUBuffer;
+    indexBuffer: GPUBuffer | null;
+    vertexCount: number;
+    indexCount: number;
+    modelMatrix: Float32Array;
+    hasUV: boolean;
+    indexFormat: 'uint16' | 'uint32';
+    position: Float32Array;
+    rotation: Float32Array;
+    scale: Float32Array;
+    private localBoundingBox;
+    constructor(vertexBuffer: GPUBuffer, vertexCount: number, indexBuffer?: GPUBuffer | null, indexCount?: number, boundingBox?: MeshBoundingBox);
+    /**
+     * 获取顶点 stride（字节数）
+     */
+    getVertexStride(): number;
+    /**
+     * 设置本地 bounding box
+     */
+    setBoundingBox(bbox: MeshBoundingBox): void;
+    /**
+     * 获取本地 bounding box
+     */
+    getLocalBoundingBox(): MeshBoundingBox | null;
+    /**
+     * 获取世界空间的 bounding box（考虑完整变换：缩放、旋转、平移）
+     */
+    getWorldBoundingBox(): MeshBoundingBox | null;
+    setPosition(x: number, y: number, z: number): void;
+    getPosition(): [number, number, number];
+    setRotation(rx: number, ry: number, rz: number): void;
+    getRotation(): [number, number, number];
+    setScale(sx: number, sy: number, sz: number): void;
+    getScale(): [number, number, number];
+    updateModelMatrix(): void;
+    resetTransform(): void;
+    destroy(): void;
+}