streamkit-pointcloud 0.1.0-alpha.0

package/dist/three/pointCloudLayer.js

@@ -0,0 +1,494 @@
+/**
+ * @streamkit/pointcloud - Three.js PointCloud Layer
+ *
+ * High-performance point cloud rendering layer for Three.js.
+ * Manages geometry, material, and lifecycle for point cloud visualization.
+ */
+import * as THREE from "three";
+import { hasMatchingColorCount, normalizeColorValue, } from "../core/validators.js";
+/** Default point size in world units */
+const DEFAULT_POINT_SIZE = 0.01;
+/** Default point color (white) */
+const DEFAULT_POINT_COLOR = 0xffffff;
+/** Default initial buffer capacity for append mode */
+const DEFAULT_BUFFER_CAPACITY = 100000;
+/** Growth factor when buffer needs expansion */
+const BUFFER_GROWTH_FACTOR = 2;
+/**
+ * Writes points directly into a Float32Array at the specified offset.
+ * @param target - Target array to write into
+ * @param points - Points to write
+ * @param startIndex - Starting point index in target
+ */
+function writePointsToArray(target, points, startIndex) {
+    const baseIdx = startIndex * 3;
+    for (let i = 0; i < points.length; i++) {
+        const point = points[i];
+        const idx = baseIdx + i * 3;
+        target[idx] = point.x;
+        target[idx + 1] = point.y;
+        target[idx + 2] = point.z;
+    }
+}
+/**
+ * Writes colors directly into a Float32Array at the specified offset (normalized).
+ * @param target - Target array to write into
+ * @param colors - Colors to write (0-255 range)
+ * @param startIndex - Starting point index in target
+ */
+function writeColorsToArray(target, colors, startIndex) {
+    const baseIdx = startIndex * 3;
+    for (let i = 0; i < colors.length; i++) {
+        const color = colors[i];
+        const idx = baseIdx + i * 3;
+        target[idx] = normalizeColorValue(color.r);
+        target[idx + 1] = normalizeColorValue(color.g);
+        target[idx + 2] = normalizeColorValue(color.b);
+    }
+}
+/**
+ * Converts PointCloudData points to a Float32Array for BufferGeometry.
+ * @param points - Array of points
+ * @param capacity - Optional pre-allocated capacity (for streaming)
+ * @returns Float32Array of positions
+ */
+function pointsToPositionArray(points, capacity) {
+    const size = capacity ?? points.length;
+    const array = new Float32Array(size * 3);
+    writePointsToArray(array, points, 0);
+    return array;
+}
+/**
+ * Converts PointCloudData colors to a Float32Array (normalized 0-1).
+ * @param colors - Array of colors (0-255 range)
+ * @param capacity - Optional pre-allocated capacity (for streaming)
+ * @returns Float32Array of normalized colors
+ */
+function colorsToColorArray(colors, capacity) {
+    const size = capacity ?? colors.length;
+    const array = new Float32Array(size * 3);
+    writeColorsToArray(array, colors, 0);
+    return array;
+}
+/**
+ * Creates a new BufferGeometry from PointCloudData.
+ * @param data - The point cloud data
+ * @returns Configured BufferGeometry
+ */
+function createGeometry(data) {
+    const geometry = new THREE.BufferGeometry();
+    // Set positions
+    const positions = pointsToPositionArray(data.points);
+    geometry.setAttribute("position", new THREE.BufferAttribute(positions, 3));
+    // Set colors if available and matching
+    if (data.colors && hasMatchingColorCount(data)) {
+        const colors = colorsToColorArray(data.colors);
+        geometry.setAttribute("color", new THREE.BufferAttribute(colors, 3));
+    }
+    // Compute bounding sphere for frustum culling
+    geometry.computeBoundingSphere();
+    return geometry;
+}
+/**
+ * Creates a PointsMaterial configured for the given data.
+ * @param data - The point cloud data
+ * @param defaultSize - Default point size
+ * @param defaultColor - Default point color
+ * @returns Configured PointsMaterial
+ */
+function createMaterial(data, defaultSize, defaultColor) {
+    const hasVertexColors = data.colors && hasMatchingColorCount(data);
+    const useUniformColor = data.color !== undefined && !hasVertexColors;
+    return new THREE.PointsMaterial({
+        size: data.size ?? defaultSize,
+        color: useUniformColor ? data.color : defaultColor,
+        vertexColors: hasVertexColors,
+        opacity: data.opacity ?? 1.0,
+        transparent: (data.opacity ?? 1.0) < 1.0,
+        sizeAttenuation: true, // Points get smaller with distance
+        depthWrite: true,
+        depthTest: true,
+    });
+}
+/**
+ * Updates an existing BufferGeometry with new data.
+ * Reuses buffers when possible for better performance.
+ * @param geometry - The geometry to update
+ * @param data - New point cloud data
+ * @returns True if geometry was updated in place, false if rebuild needed
+ */
+function updateGeometry(geometry, data) {
+    const positionAttr = geometry.getAttribute("position");
+    const colorAttr = geometry.getAttribute("color");
+    // Check if we can reuse the position buffer
+    const currentCount = positionAttr.count;
+    const newCount = data.points.length;
+    // If point count changed significantly, we need to rebuild
+    if (newCount !== currentCount) {
+        return false;
+    }
+    // Update positions in place
+    const positions = pointsToPositionArray(data.points);
+    positionAttr.array.set(positions);
+    positionAttr.needsUpdate = true;
+    // Update colors
+    if (data.colors && hasMatchingColorCount(data)) {
+        const colors = colorsToColorArray(data.colors);
+        if (colorAttr && colorAttr.count === newCount) {
+            // Update existing color buffer
+            colorAttr.array.set(colors);
+            colorAttr.needsUpdate = true;
+        }
+        else {
+            // Need to add color attribute
+            geometry.setAttribute("color", new THREE.BufferAttribute(colors, 3));
+        }
+    }
+    else if (colorAttr) {
+        // Remove color attribute if no longer needed
+        geometry.deleteAttribute?.("color");
+    }
+    // Update bounding sphere
+    geometry.computeBoundingSphere();
+    return true;
+}
+/**
+ * Updates material properties based on new data.
+ * @param material - The material to update
+ * @param data - New point cloud data
+ * @param defaultSize - Default point size
+ * @param defaultColor - Default point color
+ */
+function updateMaterial(material, data, defaultSize, defaultColor) {
+    const hasVertexColors = Boolean(data.colors && hasMatchingColorCount(data));
+    material.size = data.size ?? defaultSize;
+    material.vertexColors = hasVertexColors;
+    material.color.setHex(data.color ?? defaultColor);
+    material.opacity = data.opacity ?? 1.0;
+    material.transparent = material.opacity < 1.0;
+    material.needsUpdate = true;
+}
+/**
+ * Creates a PointCloud rendering layer for Three.js.
+ *
+ * This function returns a controller object that manages the lifecycle
+ * of a point cloud in a Three.js scene.
+ *
+ * @param options - Configuration options
+ * @returns PointCloudLayer controller
+ *
+ * @example
+ * ```typescript
+ * import * as THREE from 'three'
+ * import { createPointCloudLayer } from '@streamkit/pointcloud'
+ *import { ThreeBufferGeometryLike } from './three-types';
+
+ * const scene = new THREE.Scene()
+ * const layer = createPointCloudLayer({ scene })
+ *
+ * // Build initial point cloud
+ * layer.build({
+ *   points: [{ x: 0, y: 0, z: 0 }, { x: 1, y: 1, z: 1 }],
+ *   colors: [{ r: 255, g: 0, b: 0 }, { r: 0, g: 255, b: 0 }]
+ * })
+ *
+ * // Incremental append
+ * layer.update(newData, { mode: 'append' })
+ *
+ * // Partial update at offset
+ * layer.update(partialData, { mode: 'partial', offset: 100 })
+ *
+ * // Clean up when done
+ * layer.dispose()
+ * ```
+ */
+export function createPointCloudLayer(options) {
+    const { scene, defaultSize = DEFAULT_POINT_SIZE, defaultColor = DEFAULT_POINT_COLOR, } = options;
+    // Internal state
+    let geometry = null;
+    let material = null;
+    let points = null;
+    let isDisposed = false;
+    // Streaming state: tracks actual point count vs buffer capacity
+    let activePointCount = 0;
+    let bufferCapacity = 0;
+    let hasColors = false;
+    /**
+     * Validates that the layer has not been disposed.
+     */
+    function assertNotDisposed() {
+        if (isDisposed) {
+            throw new Error("PointCloudLayer has been disposed and cannot be used");
+        }
+    }
+    /**
+     * Removes the current point cloud from the scene without disposing resources.
+     */
+    function removeFromScene() {
+        if (points) {
+            scene.remove(points);
+        }
+    }
+    /**
+     * Disposes of geometry and material resources.
+     */
+    function disposeResources() {
+        if (geometry) {
+            geometry.dispose();
+            geometry = null;
+        }
+        if (material) {
+            material.dispose();
+            material = null;
+        }
+        points = null;
+        activePointCount = 0;
+        bufferCapacity = 0;
+        hasColors = false;
+    }
+    /**
+     * Creates geometry with pre-allocated buffers for streaming.
+     */
+    function createStreamingGeometry(data, capacity) {
+        const geo = new THREE.BufferGeometry();
+        const positions = pointsToPositionArray(data.points, capacity);
+        const posAttr = new THREE.BufferAttribute(positions, 3);
+        posAttr.setUsage(THREE.DynamicDrawUsage);
+        geo.setAttribute("position", posAttr);
+        if (data.colors && hasMatchingColorCount(data)) {
+            const colors = colorsToColorArray(data.colors, capacity);
+            const colorAttr = new THREE.BufferAttribute(colors, 3);
+            colorAttr.setUsage(THREE.DynamicDrawUsage);
+            geo.setAttribute("color", colorAttr);
+            hasColors = true;
+        }
+        // Set draw range to actual point count
+        geo.setDrawRange(0, data.points.length);
+        geo.computeBoundingSphere();
+        return geo;
+    }
+    /**
+     * Expands buffer capacity by creating new larger buffers.
+     */
+    function expandBuffers(requiredCapacity) {
+        if (!geometry)
+            return;
+        const newCapacity = Math.max(requiredCapacity, Math.ceil(bufferCapacity * BUFFER_GROWTH_FACTOR));
+        const oldPosAttr = geometry.getAttribute("position");
+        const newPositions = new Float32Array(newCapacity * 3);
+        newPositions.set(oldPosAttr.array.slice(0, activePointCount * 3));
+        const newPosAttr = new THREE.BufferAttribute(newPositions, 3);
+        newPosAttr.setUsage(THREE.DynamicDrawUsage);
+        geometry.setAttribute("position", newPosAttr);
+        if (hasColors) {
+            const oldColorAttr = geometry.getAttribute("color");
+            if (oldColorAttr) {
+                const newColors = new Float32Array(newCapacity * 3);
+                newColors.set(oldColorAttr.array.slice(0, activePointCount * 3));
+                const newColorAttr = new THREE.BufferAttribute(newColors, 3);
+                newColorAttr.setUsage(THREE.DynamicDrawUsage);
+                geometry.setAttribute("color", newColorAttr);
+            }
+        }
+        bufferCapacity = newCapacity;
+    }
+    /**
+     * Handles 'append' mode: adds new points to existing buffer.
+     */
+    function handleAppend(data, maxPoints) {
+        if (!geometry || !material) {
+            // First append: create with initial capacity
+            const initialCapacity = Math.max(DEFAULT_BUFFER_CAPACITY, data.points.length * BUFFER_GROWTH_FACTOR);
+            geometry = createStreamingGeometry(data, initialCapacity);
+            material = createMaterial(data, defaultSize, defaultColor);
+            points = new THREE.Points(geometry, material);
+            scene.add(points);
+            activePointCount = data.points.length;
+            bufferCapacity = initialCapacity;
+            return;
+        }
+        const newTotal = activePointCount + data.points.length;
+        // Check if we need to enforce maxPoints (ring buffer behavior)
+        if (maxPoints && newTotal > maxPoints) {
+            const overflow = newTotal - maxPoints;
+            const keepCount = activePointCount - overflow;
+            if (keepCount > 0) {
+                // Shift existing data to make room
+                const posAttr = geometry.getAttribute("position");
+                const posArray = posAttr.array;
+                posArray.copyWithin(0, overflow * 3, activePointCount * 3);
+                if (hasColors) {
+                    const colorAttr = geometry.getAttribute("color");
+                    if (colorAttr) {
+                        const colorArray = colorAttr.array;
+                        colorArray.copyWithin(0, overflow * 3, activePointCount * 3);
+                    }
+                }
+                activePointCount = keepCount;
+            }
+            else {
+                // New data exceeds maxPoints entirely, replace
+                activePointCount = 0;
+            }
+        }
+        const requiredCapacity = activePointCount + data.points.length;
+        // Expand buffers if needed
+        if (requiredCapacity > bufferCapacity) {
+            expandBuffers(requiredCapacity);
+        }
+        // Write new points at current end position
+        const posAttr = geometry.getAttribute("position");
+        writePointsToArray(posAttr.array, data.points, activePointCount);
+        posAttr.needsUpdate = true;
+        // Write new colors if provided
+        if (data.colors && hasMatchingColorCount(data)) {
+            let colorAttr = geometry.getAttribute("color");
+            if (!colorAttr && hasColors) {
+                const colors = new Float32Array(bufferCapacity * 3);
+                const newColorAttr = new THREE.BufferAttribute(colors, 3);
+                newColorAttr.setUsage(THREE.DynamicDrawUsage);
+                geometry.setAttribute("color", newColorAttr);
+                colorAttr = newColorAttr;
+            }
+            if (colorAttr) {
+                writeColorsToArray(colorAttr.array, data.colors, activePointCount);
+                colorAttr.needsUpdate = true;
+            }
+        }
+        activePointCount += data.points.length;
+        geometry.setDrawRange(0, activePointCount);
+        geometry.computeBoundingSphere();
+        updateMaterial(material, data, defaultSize, defaultColor);
+    }
+    /**
+     * Handles 'partial' mode: updates subset of points at offset.
+     */
+    function handlePartial(data, offset) {
+        if (!geometry || !material) {
+            console.warn("PointCloudLayer.update: No geometry to update partially. Use build() first.");
+            return;
+        }
+        // Validate offset
+        if (offset < 0) {
+            console.warn("PointCloudLayer.update: Invalid offset (negative)");
+            return;
+        }
+        if (offset >= activePointCount) {
+            console.warn("PointCloudLayer.update: Offset exceeds current point count");
+            return;
+        }
+        // Calculate how many points we can actually update
+        const maxUpdateCount = activePointCount - offset;
+        const updateCount = Math.min(data.points.length, maxUpdateCount);
+        if (updateCount === 0) {
+            return;
+        }
+        // Update positions
+        const posAttr = geometry.getAttribute("position");
+        const posArray = posAttr.array;
+        const baseIdx = offset * 3;
+        for (let i = 0; i < updateCount; i++) {
+            const point = data.points[i];
+            const idx = baseIdx + i * 3;
+            posArray[idx] = point.x;
+            posArray[idx + 1] = point.y;
+            posArray[idx + 2] = point.z;
+        }
+        posAttr.needsUpdate = true;
+        // Update colors if provided
+        if (data.colors && data.colors.length >= updateCount && hasColors) {
+            const colorAttr = geometry.getAttribute("color");
+            if (colorAttr) {
+                const colorArray = colorAttr.array;
+                for (let i = 0; i < updateCount; i++) {
+                    const color = data.colors[i];
+                    const idx = baseIdx + i * 3;
+                    colorArray[idx] = normalizeColorValue(color.r);
+                    colorArray[idx + 1] = normalizeColorValue(color.g);
+                    colorArray[idx + 2] = normalizeColorValue(color.b);
+                }
+                colorAttr.needsUpdate = true;
+            }
+        }
+        geometry.computeBoundingSphere();
+        updateMaterial(material, data, defaultSize, defaultColor);
+    }
+    /**
+     * Handles 'replace' mode: full geometry replacement.
+     */
+    function handleReplace(data) {
+        // Clean up existing resources
+        removeFromScene();
+        disposeResources();
+        // Create new geometry and material
+        geometry = createGeometry(data);
+        material = createMaterial(data, defaultSize, defaultColor);
+        // Track state
+        activePointCount = data.points.length;
+        bufferCapacity = data.points.length;
+        hasColors = Boolean(data.colors && hasMatchingColorCount(data));
+        // Create Points object and add to scene
+        points = new THREE.Points(geometry, material);
+        scene.add(points);
+    }
+    return {
+        build(data) {
+            assertNotDisposed();
+            if (!data.points || data.points.length === 0) {
+                console.warn("PointCloudLayer.build: No points provided");
+                return;
+            }
+            handleReplace(data);
+        },
+        update(data, options) {
+            assertNotDisposed();
+            if (!data.points || data.points.length === 0) {
+                console.warn("PointCloudLayer.update: No points provided");
+                return;
+            }
+            const mode = options?.mode ?? "replace";
+            switch (mode) {
+                case "append":
+                    handleAppend(data, options?.maxPoints);
+                    break;
+                case "partial":
+                    handlePartial(data, options?.offset ?? 0);
+                    break;
+                case "replace":
+                default:
+                    // If no existing geometry or point count differs, rebuild
+                    if (!geometry || !material || !points) {
+                        handleReplace(data);
+                    }
+                    else if (data.points.length === activePointCount) {
+                        // Try in-place update for same-size data
+                        const updated = updateGeometry(geometry, data);
+                        if (updated) {
+                            updateMaterial(material, data, defaultSize, defaultColor);
+                        }
+                        else {
+                            handleReplace(data);
+                        }
+                    }
+                    else {
+                        handleReplace(data);
+                    }
+                    break;
+            }
+        },
+        clear() {
+            assertNotDisposed();
+            removeFromScene();
+            disposeResources();
+        },
+        dispose() {
+            if (isDisposed) {
+                return;
+            }
+            removeFromScene();
+            disposeResources();
+            isDisposed = true;
+        },
+    };
+}
+//# sourceMappingURL=pointCloudLayer.js.map

package/dist/three/pointCloudLayer.js.map

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

package/dist/three/three-types.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Minimal structural typings for Three.js objects
+ * We avoid importing THREE types to prevent duplicate type conflicts.
+ */
+export interface ThreeSceneLike {
+    add(object: any): void;
+    remove(object: any): void;
+}
+export interface ThreeBufferAttributeLike {
+    array: Float32Array;
+    count: number;
+    itemSize: number;
+    needsUpdate?: boolean;
+    setUsage?(usage: number): void;
+}
+export interface ThreeBufferGeometryLike {
+    getAttribute(name: string): ThreeBufferAttributeLike | undefined;
+    setAttribute(name: string, attr: ThreeBufferAttributeLike): void;
+    deleteAttribute?(name: string): void;
+    setDrawRange(start: number, count: number): void;
+    computeBoundingSphere(): void;
+    dispose(): void;
+}
+export interface ThreeMaterialLike {
+    size: number;
+    vertexColors: boolean;
+    opacity: number;
+    transparent: boolean;
+    needsUpdate: boolean;
+    color: {
+        setHex(hex: number): void;
+    };
+    dispose(): void;
+}
+export interface ThreePointsLike {
+    geometry: ThreeBufferGeometryLike;
+    material: ThreeMaterialLike;
+}
+//# sourceMappingURL=three-types.d.ts.map

package/dist/three/three-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"three-types.d.ts","sourceRoot":"","sources":["../../src/three/three-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,MAAM,EAAE,GAAG,GAAG,IAAI,CAAC;IACvB,MAAM,CAAC,MAAM,EAAE,GAAG,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,YAAY,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,uBAAuB;IACtC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,wBAAwB,GAAG,SAAS,CAAC;IACjE,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,wBAAwB,GAAG,IAAI,CAAC;IACjE,eAAe,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACjD,qBAAqB,IAAI,IAAI,CAAC;IAC9B,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,OAAO,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,KAAK,EAAE;QACL,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;KAC3B,CAAC;IACF,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,uBAAuB,CAAC;IAClC,QAAQ,EAAE,iBAAiB,CAAC;CAC7B"}

package/dist/three/three-types.js

@@ -0,0 +1,6 @@
+/**
+ * Minimal structural typings for Three.js objects
+ * We avoid importing THREE types to prevent duplicate type conflicts.
+ */
+export {};
+//# sourceMappingURL=three-types.js.map

package/dist/three/three-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"three-types.js","sourceRoot":"","sources":["../../src/three/three-types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/types.d.ts

@@ -0,0 +1,97 @@
+/**
+ * @streamkit/pointcloud - Core Type Definitions
+ *
+ * Stable, runtime-agnostic types for PointCloud data.
+ * These types intentionally avoid importing Three.js typings
+ * to prevent duplicate type conflicts.
+ */
+/**
+ * Represents a single point in 3D space.
+ */
+export interface PointCloudPoint {
+    x: number;
+    y: number;
+    z: number;
+}
+/**
+ * Represents an RGB color with values in the 0-255 range.
+ */
+export interface PointCloudColor {
+    r: number;
+    g: number;
+    b: number;
+}
+/**
+ * Core data structure for PointCloud data.
+ *
+ * This is the primary data exchange format used throughout the library.
+ * It is designed to be serializable and network-friendly.
+ */
+export interface PointCloudData {
+    /** Array of 3D points */
+    points: PointCloudPoint[];
+    /** Optional per-vertex colors (0-255 range) */
+    colors?: PointCloudColor[];
+    /** Point size override for rendering */
+    size?: number;
+    /** Uniform color override (hex format, e.g., 0xff0000) */
+    color?: number;
+    /** Opacity value (0-1) */
+    opacity?: number;
+}
+/**
+ * Minimal structural contract for a Three.js Scene.
+ * The consumer provides a real THREE.Scene at runtime.
+ */
+export interface ThreeSceneLike {
+    add(object: any): void;
+    remove(object: any): void;
+}
+/**
+ * Options for creating a PointCloud layer.
+ */
+export interface PointCloudLayerOptions {
+    /** Scene-like object to render into (typically THREE.Scene) */
+    scene: ThreeSceneLike;
+    /** Default point size when not specified in data */
+    defaultSize?: number;
+    /** Default color when not specified in data (hex format) */
+    defaultColor?: number;
+}
+/**
+ * Interface for the PointCloud layer controller.
+ */
+export interface PointCloudLayer {
+    build(data: PointCloudData): void;
+    update(data: PointCloudData, options?: PointCloudUpdateOptions): void;
+    clear(): void;
+    dispose(): void;
+}
+/**
+ * Options for the Draco decoder.
+ */
+export interface DracoDecoderOptions {
+    /** Path to Draco decoder WASM/JS files */
+    decoderPath?: string;
+}
+/**
+ * A timestamped frame of point cloud data.
+ */
+export interface PointCloudFrame {
+    frameId: number;
+    timestamp: number;
+    data: PointCloudData;
+}
+/**
+ * Update mode for incremental point cloud operations.
+ */
+export type PointCloudUpdateMode = "replace" | "append" | "partial";
+/**
+ * Options for incremental point cloud updates.
+ */
+export interface PointCloudUpdateOptions {
+    mode: PointCloudUpdateMode;
+    offset?: number;
+    maxPoints?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,yBAAyB;IACzB,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,+CAA+C;IAC/C,MAAM,CAAC,EAAE,eAAe,EAAE,CAAC;IAC3B,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAMD;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,MAAM,EAAE,GAAG,GAAG,IAAI,CAAC;IACvB,MAAM,CAAC,MAAM,EAAE,GAAG,GAAG,IAAI,CAAC;CAC3B;AAMD;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,+DAA+D;IAC/D,KAAK,EAAE,cAAc,CAAC;IACtB,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4DAA4D;IAC5D,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAAC;IAClC,MAAM,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,uBAAuB,GAAG,IAAI,CAAC;IACtE,KAAK,IAAI,IAAI,CAAC;IACd,OAAO,IAAI,IAAI,CAAC;CACjB;AAMD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAMD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,cAAc,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEpE;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}