@ifc-lite/renderer 1.1.6 → 1.2.0

package/dist/snap-detector.js

@@ -0,0 +1,291 @@
+import { Raycaster } from './raycaster';
+export var SnapType;
+(function (SnapType) {
+    SnapType["VERTEX"] = "vertex";
+    SnapType["EDGE"] = "edge";
+    SnapType["EDGE_MIDPOINT"] = "edge_midpoint";
+    SnapType["FACE"] = "face";
+    SnapType["FACE_CENTER"] = "face_center";
+})(SnapType || (SnapType = {}));
+export class SnapDetector {
+    raycaster = new Raycaster();
+    defaultOptions = {
+        snapToVertices: true,
+        snapToEdges: true,
+        snapToFaces: true,
+        snapRadius: 0.1, // 10cm in world units (meters)
+        screenSnapRadius: 20, // pixels
+    };
+    // Cache for processed mesh geometry (vertices and edges)
+    geometryCache = new Map();
+    /**
+     * Detect best snap target near cursor
+     */
+    detectSnapTarget(ray, meshes, intersection, camera, screenHeight, options = {}) {
+        const opts = { ...this.defaultOptions, ...options };
+        if (!intersection) {
+            return null;
+        }
+        const targets = [];
+        // Calculate world-space snap radius based on screen-space radius and distance
+        const distanceToCamera = this.distance(camera.position, intersection.point);
+        const worldSnapRadius = this.screenToWorldRadius(opts.screenSnapRadius, distanceToCamera, camera.fov, screenHeight);
+        // Only check the intersected mesh for snap targets (performance optimization)
+        // Checking all meshes was causing severe framerate drops with large models
+        const intersectedMesh = meshes[intersection.meshIndex];
+        if (intersectedMesh) {
+            // Detect vertices
+            if (opts.snapToVertices) {
+                targets.push(...this.findVertices(intersectedMesh, intersection.point, worldSnapRadius));
+            }
+            // Detect edges
+            if (opts.snapToEdges) {
+                targets.push(...this.findEdges(intersectedMesh, intersection.point, worldSnapRadius));
+            }
+            // Detect faces
+            if (opts.snapToFaces) {
+                targets.push(...this.findFaces(intersectedMesh, intersection, worldSnapRadius));
+            }
+        }
+        // Return best target
+        return this.getBestSnapTarget(targets, intersection.point);
+    }
+    /**
+     * Get or compute geometry cache for a mesh
+     */
+    getGeometryCache(mesh) {
+        const cached = this.geometryCache.get(mesh.expressId);
+        if (cached) {
+            return cached;
+        }
+        // Compute and cache vertices
+        const positions = mesh.positions;
+        // Validate input
+        if (!positions || positions.length === 0) {
+            const emptyCache = { vertices: [], edges: [] };
+            this.geometryCache.set(mesh.expressId, emptyCache);
+            return emptyCache;
+        }
+        const vertexMap = new Map();
+        for (let i = 0; i < positions.length; i += 3) {
+            const vertex = {
+                x: positions[i],
+                y: positions[i + 1],
+                z: positions[i + 2],
+            };
+            // Skip invalid vertices
+            if (!isFinite(vertex.x) || !isFinite(vertex.y) || !isFinite(vertex.z)) {
+                continue;
+            }
+            // Use reduced precision for deduplication
+            const key = `${vertex.x.toFixed(4)}_${vertex.y.toFixed(4)}_${vertex.z.toFixed(4)}`;
+            vertexMap.set(key, vertex);
+        }
+        const vertices = Array.from(vertexMap.values());
+        // Compute and cache edges
+        const edges = [];
+        const indices = mesh.indices;
+        if (indices) {
+            const edgeMap = new Map();
+            for (let i = 0; i < indices.length; i += 3) {
+                const triangleEdges = [
+                    [indices[i], indices[i + 1]],
+                    [indices[i + 1], indices[i + 2]],
+                    [indices[i + 2], indices[i]],
+                ];
+                for (const [idx0, idx1] of triangleEdges) {
+                    const i0 = idx0 * 3;
+                    const i1 = idx1 * 3;
+                    const v0 = {
+                        x: positions[i0],
+                        y: positions[i0 + 1],
+                        z: positions[i0 + 2],
+                    };
+                    const v1 = {
+                        x: positions[i1],
+                        y: positions[i1 + 1],
+                        z: positions[i1 + 2],
+                    };
+                    // Create canonical edge key (smaller index first)
+                    const key = idx0 < idx1 ? `${idx0}_${idx1}` : `${idx1}_${idx0}`;
+                    if (!edgeMap.has(key)) {
+                        edgeMap.set(key, { v0, v1, index: edgeMap.size });
+                    }
+                }
+            }
+            edges.push(...edgeMap.values());
+        }
+        const cache = { vertices, edges };
+        this.geometryCache.set(mesh.expressId, cache);
+        return cache;
+    }
+    /**
+     * Find vertices near point
+     */
+    findVertices(mesh, point, radius) {
+        const targets = [];
+        const cache = this.getGeometryCache(mesh);
+        // Find vertices within radius - ONLY when VERY close for smooth edge sliding
+        for (const vertex of cache.vertices) {
+            const dist = this.distance(vertex, point);
+            // Only snap to vertices when within 20% of snap radius (very tight) to avoid sticky behavior
+            if (dist < radius * 0.2) {
+                targets.push({
+                    type: SnapType.VERTEX,
+                    position: vertex,
+                    expressId: mesh.expressId,
+                    confidence: 0.95 - dist / (radius * 0.2), // Lower than edges, only wins when VERY close
+                });
+            }
+        }
+        return targets;
+    }
+    /**
+     * Find edges near point
+     */
+    findEdges(mesh, point, radius) {
+        const targets = [];
+        const cache = this.getGeometryCache(mesh);
+        // Use MUCH larger radius for edges - very forgiving, cursor "jumps" to edges
+        const edgeRadius = radius * 3.0; // Tripled for easy detection
+        // Find edges near point using cached data
+        for (const edge of cache.edges) {
+            const closestPoint = this.raycaster.closestPointOnSegment(point, edge.v0, edge.v1);
+            const dist = this.distance(closestPoint, point);
+            if (dist < edgeRadius) {
+                // Edge snap - ABSOLUTE HIGHEST priority for smooth sliding along edges
+                // Maximum confidence ensures edges ALWAYS win over vertices/faces
+                targets.push({
+                    type: SnapType.EDGE,
+                    position: closestPoint,
+                    expressId: mesh.expressId,
+                    confidence: 0.999 * (1.0 - dist / edgeRadius), // Nearly perfect priority for edges
+                    metadata: { vertices: [edge.v0, edge.v1], edgeIndex: edge.index },
+                });
+                // Edge midpoint snap - only when very close to midpoint
+                const midpoint = {
+                    x: (edge.v0.x + edge.v1.x) / 2,
+                    y: (edge.v0.y + edge.v1.y) / 2,
+                    z: (edge.v0.z + edge.v1.z) / 2,
+                };
+                const midDist = this.distance(midpoint, point);
+                // Only snap to midpoint when within 1/3 of snap radius
+                if (midDist < radius * 0.33) {
+                    targets.push({
+                        type: SnapType.EDGE_MIDPOINT,
+                        position: midpoint,
+                        expressId: mesh.expressId,
+                        confidence: 1.0 * (1.0 - midDist / (radius * 0.33)), // Very high when close
+                        metadata: { vertices: [edge.v0, edge.v1], edgeIndex: edge.index },
+                    });
+                }
+            }
+        }
+        return targets;
+    }
+    /**
+     * Clear geometry cache (call when meshes change)
+     */
+    clearCache() {
+        this.geometryCache.clear();
+    }
+    /**
+     * Find faces/planes near intersection
+     */
+    findFaces(mesh, intersection, radius) {
+        const targets = [];
+        // Add the intersected face
+        targets.push({
+            type: SnapType.FACE,
+            position: intersection.point,
+            normal: intersection.normal,
+            expressId: mesh.expressId,
+            confidence: 0.5, // Lower priority than vertices/edges
+            metadata: { faceIndex: intersection.triangleIndex },
+        });
+        // Calculate face center (centroid of triangle)
+        const positions = mesh.positions;
+        const indices = mesh.indices;
+        if (indices) {
+            const triIndex = intersection.triangleIndex * 3;
+            const i0 = indices[triIndex] * 3;
+            const i1 = indices[triIndex + 1] * 3;
+            const i2 = indices[triIndex + 2] * 3;
+            const v0 = {
+                x: positions[i0],
+                y: positions[i0 + 1],
+                z: positions[i0 + 2],
+            };
+            const v1 = {
+                x: positions[i1],
+                y: positions[i1 + 1],
+                z: positions[i1 + 2],
+            };
+            const v2 = {
+                x: positions[i2],
+                y: positions[i2 + 1],
+                z: positions[i2 + 2],
+            };
+            const center = {
+                x: (v0.x + v1.x + v2.x) / 3,
+                y: (v0.y + v1.y + v2.y) / 3,
+                z: (v0.z + v1.z + v2.z) / 3,
+            };
+            const dist = this.distance(center, intersection.point);
+            if (dist < radius) {
+                targets.push({
+                    type: SnapType.FACE_CENTER,
+                    position: center,
+                    normal: intersection.normal,
+                    expressId: mesh.expressId,
+                    confidence: 0.7 * (1.0 - dist / radius),
+                    metadata: { faceIndex: intersection.triangleIndex },
+                });
+            }
+        }
+        return targets;
+    }
+    /**
+     * Select best snap target based on confidence and priority
+     */
+    getBestSnapTarget(targets, cursorPoint) {
+        if (targets.length === 0)
+            return null;
+        // Priority order: vertex > edge_midpoint > edge > face_center > face
+        const priorityMap = {
+            [SnapType.VERTEX]: 5,
+            [SnapType.EDGE_MIDPOINT]: 4,
+            [SnapType.EDGE]: 3,
+            [SnapType.FACE_CENTER]: 2,
+            [SnapType.FACE]: 1,
+        };
+        // Sort by priority then confidence
+        targets.sort((a, b) => {
+            const priorityDiff = priorityMap[b.type] - priorityMap[a.type];
+            if (priorityDiff !== 0)
+                return priorityDiff;
+            return b.confidence - a.confidence;
+        });
+        return targets[0];
+    }
+    /**
+     * Convert screen-space radius to world-space radius
+     */
+    screenToWorldRadius(screenRadius, distance, fov, screenHeight) {
+        // Calculate world height at distance
+        const fovRadians = (fov * Math.PI) / 180;
+        const worldHeight = 2 * distance * Math.tan(fovRadians / 2);
+        // Convert screen pixels to world units
+        return (screenRadius / screenHeight) * worldHeight;
+    }
+    /**
+     * Vector utilities
+     */
+    distance(a, b) {
+        const dx = a.x - b.x;
+        const dy = a.y - b.y;
+        const dz = a.z - b.z;
+        return Math.sqrt(dx * dx + dy * dy + dz * dz);
+    }
+}
+//# sourceMappingURL=snap-detector.js.map

package/dist/snap-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snap-detector.js","sourceRoot":"","sources":["../src/snap-detector.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -92,4 +92,13 @@ export interface RenderOptions {
     sectionPlane?: SectionPlane;
     isStreaming?: boolean;
 }
+/**
+ * Options for GPU picking/selection
+ * Filters out hidden/invisible elements so users can select what's visible
+ */
+export interface PickOptions {
+    isStreaming?: boolean;
+    hiddenIds?: Set<number>;
+    isolatedIds?: Set<number> | null;
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,MAAM,WAAW,IAAI;IACnB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,IAAI;IACnB,CAAC,EAAE,YAAY,CAAC;CACjB;AAED,MAAM,WAAW,MAAM;IACrB,QAAQ,EAAE,IAAI,CAAC;IACf,MAAM,EAAE,IAAI,CAAC;IACb,EAAE,EAAE,IAAI,CAAC;IACT,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,IAAI;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,SAAS,CAAC;IACxB,WAAW,EAAE,SAAS,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,IAAI,CAAC;IAChB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAEpB,aAAa,CAAC,EAAE,SAAS,CAAC;IAC1B,SAAS,CAAC,EAAE,YAAY,CAAC;IAEzB,MAAM,CAAC,EAAE;QAAE,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC;CAC3E;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,SAAS,CAAC;IACxB,WAAW,EAAE,SAAS,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,SAAS,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IAEtB,wBAAwB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE9C,SAAS,CAAC,EAAE,YAAY,CAAC;IAEzB,MAAM,CAAC,EAAE;QAAE,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC;CAC3E;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,SAAS,CAAC;IACxB,WAAW,EAAE,SAAS,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,CAAC,EAAE,YAAY,CAAC;IACzB,aAAa,CAAC,EAAE,SAAS,CAAC;IAE1B,MAAM,CAAC,EAAE;QAAE,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC;CAC3E;AAGD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9C,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,YAAY,CAAC,EAAE,OAAO,mBAAmB,EAAE,YAAY,CAAC;IAExD,SAAS,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACxB,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAE1B,YAAY,CAAC,EAAE,YAAY,CAAC;IAE5B,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/zero-copy-uploader.d.ts

@@ -0,0 +1,145 @@
+/**
+ * Zero-Copy GPU Uploader - uploads geometry directly from WASM memory to WebGPU
+ *
+ * This module provides efficient GPU buffer creation and upload from WASM memory.
+ * It eliminates intermediate JavaScript copies by using TypedArray views directly
+ * into WASM linear memory.
+ *
+ * Performance benefits:
+ * - 60-70% reduction in peak RAM usage
+ * - 40-50% faster geometry-to-GPU pipeline
+ * - Reduced GC pressure
+ */
+/**
+ * WASM memory interface for zero-copy access
+ */
+export interface WasmMemoryHandle {
+    buffer: ArrayBuffer;
+}
+/**
+ * GPU-ready geometry with pointer access
+ */
+export interface GpuGeometryData {
+    vertexDataPtr: number;
+    vertexDataLen: number;
+    vertexDataByteLength: number;
+    indicesPtr: number;
+    indicesLen: number;
+    indicesByteLength: number;
+    meshCount: number;
+    totalVertexCount: number;
+    totalTriangleCount: number;
+    getMeshMetadata(index: number): {
+        expressId: number;
+        vertexOffset: number;
+        vertexCount: number;
+        indexOffset: number;
+        indexCount: number;
+        color: number[];
+    } | undefined;
+    free(): void;
+}
+/**
+ * GPU-ready instanced geometry with pointer access
+ */
+export interface GpuInstancedGeometryData {
+    geometryId: bigint;
+    vertexDataPtr: number;
+    vertexDataLen: number;
+    vertexDataByteLength: number;
+    indicesPtr: number;
+    indicesLen: number;
+    indicesByteLength: number;
+    instanceDataPtr: number;
+    instanceDataLen: number;
+    instanceDataByteLength: number;
+    instanceExpressIdsPtr: number;
+    instanceCount: number;
+    vertexCount: number;
+    triangleCount: number;
+}
+/**
+ * Mesh metadata for draw calls and selection
+ */
+export interface ZeroCopyMeshMetadata {
+    expressId: number;
+    vertexOffset: number;
+    vertexCount: number;
+    indexOffset: number;
+    indexCount: number;
+    color: [number, number, number, number];
+}
+/**
+ * Result of uploading a geometry batch
+ */
+export interface ZeroCopyUploadResult {
+    vertexBuffer: GPUBuffer;
+    indexBuffer: GPUBuffer;
+    meshMetadata: ZeroCopyMeshMetadata[];
+    stats: {
+        meshCount: number;
+        vertexCount: number;
+        triangleCount: number;
+        uploadTimeMs: number;
+    };
+}
+/**
+ * Result of uploading instanced geometry
+ */
+export interface ZeroCopyInstancedUploadResult {
+    geometryId: bigint;
+    vertexBuffer: GPUBuffer;
+    indexBuffer: GPUBuffer;
+    instanceBuffer: GPUBuffer;
+    indexCount: number;
+    instanceCount: number;
+    expressIds: number[];
+}
+/**
+ * Zero-copy GPU uploader for direct WASM-to-GPU data transfer
+ */
+export declare class ZeroCopyGpuUploader {
+    private device;
+    private wasmMemory;
+    private cachedBuffer;
+    constructor(device: GPUDevice, wasmMemory: WasmMemoryHandle);
+    /**
+     * Get current WASM memory buffer (may change if memory grows)
+     */
+    private getBuffer;
+    /**
+     * Create Float32Array view into WASM memory (zero-copy)
+     */
+    private createFloat32View;
+    /**
+     * Create Uint32Array view into WASM memory (zero-copy)
+     */
+    private createUint32View;
+    /**
+     * Upload GPU geometry with zero-copy from WASM memory
+     *
+     * IMPORTANT: Call this synchronously - don't await between getting
+     * the geometry and calling this method!
+     *
+     * @param geometry GPU-ready geometry from WASM
+     * @returns Upload result with GPU buffers and metadata
+     */
+    uploadGeometry(geometry: GpuGeometryData): ZeroCopyUploadResult;
+    /**
+     * Upload instanced geometry with zero-copy from WASM memory
+     */
+    uploadInstancedGeometry(geometry: GpuInstancedGeometryData): ZeroCopyInstancedUploadResult;
+    /**
+     * Upload geometry and immediately free WASM memory
+     *
+     * Convenience method that handles the upload-then-free pattern
+     */
+    uploadAndFree(geometry: GpuGeometryData): ZeroCopyUploadResult;
+}
+/**
+ * Create a zero-copy uploader from a GPU device and WASM API
+ */
+export declare function createZeroCopyUploader(device: GPUDevice, wasmApi: {
+    getMemory(): WasmMemoryHandle;
+}): ZeroCopyGpuUploader;
+//# sourceMappingURL=zero-copy-uploader.d.ts.map

package/dist/zero-copy-uploader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zero-copy-uploader.d.ts","sourceRoot":"","sources":["../src/zero-copy-uploader.ts"],"names":[],"mappings":"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"}

package/dist/zero-copy-uploader.js

@@ -0,0 +1,146 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+/**
+ * Zero-copy GPU uploader for direct WASM-to-GPU data transfer
+ */
+export class ZeroCopyGpuUploader {
+    device;
+    wasmMemory;
+    cachedBuffer = null;
+    constructor(device, wasmMemory) {
+        this.device = device;
+        this.wasmMemory = wasmMemory;
+    }
+    /**
+     * Get current WASM memory buffer (may change if memory grows)
+     */
+    getBuffer() {
+        const currentBuffer = this.wasmMemory.buffer;
+        if (this.cachedBuffer !== currentBuffer) {
+            this.cachedBuffer = currentBuffer;
+        }
+        return currentBuffer;
+    }
+    /**
+     * Create Float32Array view into WASM memory (zero-copy)
+     */
+    createFloat32View(byteOffset, length) {
+        return new Float32Array(this.getBuffer(), byteOffset, length);
+    }
+    /**
+     * Create Uint32Array view into WASM memory (zero-copy)
+     */
+    createUint32View(byteOffset, length) {
+        return new Uint32Array(this.getBuffer(), byteOffset, length);
+    }
+    /**
+     * Upload GPU geometry with zero-copy from WASM memory
+     *
+     * IMPORTANT: Call this synchronously - don't await between getting
+     * the geometry and calling this method!
+     *
+     * @param geometry GPU-ready geometry from WASM
+     * @returns Upload result with GPU buffers and metadata
+     */
+    uploadGeometry(geometry) {
+        const startTime = performance.now();
+        // Create zero-copy views into WASM memory
+        const vertexView = this.createFloat32View(geometry.vertexDataPtr, geometry.vertexDataLen);
+        const indexView = this.createUint32View(geometry.indicesPtr, geometry.indicesLen);
+        // Create GPU buffers
+        const vertexBuffer = this.device.createBuffer({
+            size: geometry.vertexDataByteLength,
+            usage: GPUBufferUsage.VERTEX | GPUBufferUsage.COPY_DST,
+        });
+        const indexBuffer = this.device.createBuffer({
+            size: geometry.indicesByteLength,
+            usage: GPUBufferUsage.INDEX | GPUBufferUsage.COPY_DST,
+        });
+        // Upload directly from WASM memory (single copy to GPU)
+        this.device.queue.writeBuffer(vertexBuffer, 0, vertexView);
+        this.device.queue.writeBuffer(indexBuffer, 0, indexView);
+        // Extract mesh metadata
+        const meshMetadata = [];
+        for (let i = 0; i < geometry.meshCount; i++) {
+            const meta = geometry.getMeshMetadata(i);
+            if (meta) {
+                meshMetadata.push({
+                    expressId: meta.expressId,
+                    vertexOffset: meta.vertexOffset,
+                    vertexCount: meta.vertexCount,
+                    indexOffset: meta.indexOffset,
+                    indexCount: meta.indexCount,
+                    color: meta.color,
+                });
+            }
+        }
+        const uploadTimeMs = performance.now() - startTime;
+        return {
+            vertexBuffer,
+            indexBuffer,
+            meshMetadata,
+            stats: {
+                meshCount: geometry.meshCount,
+                vertexCount: geometry.totalVertexCount,
+                triangleCount: geometry.totalTriangleCount,
+                uploadTimeMs,
+            },
+        };
+    }
+    /**
+     * Upload instanced geometry with zero-copy from WASM memory
+     */
+    uploadInstancedGeometry(geometry) {
+        // Create zero-copy views
+        const vertexView = this.createFloat32View(geometry.vertexDataPtr, geometry.vertexDataLen);
+        const indexView = this.createUint32View(geometry.indicesPtr, geometry.indicesLen);
+        const instanceView = this.createFloat32View(geometry.instanceDataPtr, geometry.instanceDataLen);
+        const expressIdsView = this.createUint32View(geometry.instanceExpressIdsPtr, geometry.instanceCount);
+        // Create GPU buffers
+        const vertexBuffer = this.device.createBuffer({
+            size: geometry.vertexDataByteLength,
+            usage: GPUBufferUsage.VERTEX | GPUBufferUsage.COPY_DST,
+        });
+        const indexBuffer = this.device.createBuffer({
+            size: geometry.indicesByteLength,
+            usage: GPUBufferUsage.INDEX | GPUBufferUsage.COPY_DST,
+        });
+        const instanceBuffer = this.device.createBuffer({
+            size: geometry.instanceDataByteLength,
+            usage: GPUBufferUsage.STORAGE | GPUBufferUsage.COPY_DST,
+        });
+        // Upload directly from WASM memory
+        this.device.queue.writeBuffer(vertexBuffer, 0, vertexView);
+        this.device.queue.writeBuffer(indexBuffer, 0, indexView);
+        this.device.queue.writeBuffer(instanceBuffer, 0, instanceView);
+        // Copy express IDs (small array)
+        const expressIds = Array.from(expressIdsView);
+        return {
+            geometryId: geometry.geometryId,
+            vertexBuffer,
+            indexBuffer,
+            instanceBuffer,
+            indexCount: geometry.indicesLen,
+            instanceCount: geometry.instanceCount,
+            expressIds,
+        };
+    }
+    /**
+     * Upload geometry and immediately free WASM memory
+     *
+     * Convenience method that handles the upload-then-free pattern
+     */
+    uploadAndFree(geometry) {
+        const result = this.uploadGeometry(geometry);
+        geometry.free();
+        return result;
+    }
+}
+/**
+ * Create a zero-copy uploader from a GPU device and WASM API
+ */
+export function createZeroCopyUploader(device, wasmApi) {
+    return new ZeroCopyGpuUploader(device, wasmApi.getMemory());
+}
+//# sourceMappingURL=zero-copy-uploader.js.map

package/dist/zero-copy-uploader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zero-copy-uploader.js","sourceRoot":"","sources":["../src/zero-copy-uploader.ts"],"names":[],"mappings":"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"}