maplibre-gl-lidar 0.1.0

package/dist/types/lib/layers/PointCloudManager.d.ts

@@ -0,0 +1,136 @@
+import { DeckOverlay } from '../core/DeckOverlay';
+import { PointCloudData } from '../loaders/types';
+import { ColorScheme, PointCloudBounds } from '../core/types';
+import { PointCloudLayerOptions, PickedPointInfo } from './types';
+/**
+ * Manages deck.gl PointCloudLayer instances for visualization.
+ */
+export declare class PointCloudManager {
+    private _deckOverlay;
+    private _pointClouds;
+    private _options;
+    private _colorProcessor;
+    constructor(deckOverlay: DeckOverlay, options?: Partial<PointCloudLayerOptions>);
+    /**
+     * Sets the hover callback.
+     *
+     * @param callback - Function called when a point is hovered
+     */
+    setOnHover(callback: ((info: PickedPointInfo | null) => void) | undefined): void;
+    /**
+     * Adds a point cloud to the visualization.
+     *
+     * @param id - Unique identifier for the point cloud
+     * @param data - Point cloud data (positions are already offsets from coordinateOrigin)
+     */
+    addPointCloud(id: string, data: PointCloudData): void;
+    /**
+     * Updates an existing point cloud with new data.
+     * Used for streaming/incremental loading where points are added over time.
+     *
+     * @param id - Unique identifier for the point cloud
+     * @param data - Updated point cloud data
+     */
+    updatePointCloud(id: string, data: PointCloudData): void;
+    /**
+     * Gets the current point count for a point cloud.
+     *
+     * @param id - Point cloud ID
+     * @returns Point count or 0 if not found
+     */
+    getPointCount(id: string): number;
+    /**
+     * Removes a point cloud from the visualization.
+     *
+     * @param id - ID of the point cloud to remove
+     */
+    removePointCloud(id: string): void;
+    /**
+     * Checks if a point cloud exists.
+     *
+     * @param id - Point cloud ID
+     * @returns True if exists
+     */
+    hasPointCloud(id: string): boolean;
+    /**
+     * Gets all point cloud IDs.
+     *
+     * @returns Array of point cloud IDs
+     */
+    getPointCloudIds(): string[];
+    /**
+     * Gets the bounds of a point cloud.
+     *
+     * @param id - Point cloud ID
+     * @returns Bounds or undefined if not found
+     */
+    getPointCloudBounds(id: string): PointCloudBounds | undefined;
+    /**
+     * Updates styling options for all point clouds.
+     *
+     * @param options - New style options
+     */
+    updateStyle(options: Partial<PointCloudLayerOptions>): void;
+    /**
+     * Sets the point size.
+     *
+     * @param size - Point size in pixels
+     */
+    setPointSize(size: number): void;
+    /**
+     * Sets the opacity.
+     *
+     * @param opacity - Opacity value (0-1)
+     */
+    setOpacity(opacity: number): void;
+    /**
+     * Sets the color scheme.
+     *
+     * @param scheme - Color scheme to apply
+     */
+    setColorScheme(scheme: ColorScheme): void;
+    /**
+     * Sets whether to use percentile range for elevation/intensity coloring.
+     *
+     * @param usePercentile - Whether to use percentile range (2-98%)
+     */
+    setUsePercentile(usePercentile: boolean): void;
+    /**
+     * Sets the elevation range filter.
+     *
+     * @param range - [min, max] elevation or null to disable
+     */
+    setElevationRange(range: [number, number] | null): void;
+    /**
+     * Sets whether points are pickable (enables hover/click interactions).
+     *
+     * @param pickable - Whether points should be pickable
+     */
+    setPickable(pickable: boolean): void;
+    /**
+     * Sets the Z offset for vertical adjustment.
+     *
+     * @param offset - Z offset in meters
+     */
+    setZOffset(offset: number): void;
+    /**
+     * Clears all point clouds.
+     */
+    clear(): void;
+    /**
+     * Gets the current options.
+     */
+    getOptions(): PointCloudLayerOptions;
+    /**
+     * Creates a deck.gl layer for a point cloud.
+     * Chunks large point clouds into multiple layers to avoid WebGL buffer limits.
+     * Uses coordinateOrigin + LNGLAT_OFFSETS to maintain Float32 precision.
+     * Applies elevation filter if set.
+     */
+    private _createLayer;
+    /**
+     * Updates all layers with current options.
+     */
+    private _updateAllLayers;
+}
+//# sourceMappingURL=PointCloudManager.d.ts.map

package/dist/types/lib/layers/PointCloudManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PointCloudManager.d.ts","sourceRoot":"","sources":["../../../../src/lib/layers/PointCloudManager.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,KAAK,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAavE;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,YAAY,CAAc;IAClC,OAAO,CAAC,YAAY,CAAiC;IACrD,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,eAAe,CAAuB;gBAElC,WAAW,EAAE,WAAW,EAAE,OAAO,GAAE,OAAO,CAAC,sBAAsB,CAAM;IAgBnF;;;;OAIG;IACH,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,KAAK,IAAI,CAAC,GAAG,SAAS,GAAG,IAAI;IAIhF;;;;;OAKG;IACH,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,IAAI;IAYrD;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,GAAG,IAAI;IA6BxD;;;;;OAKG;IACH,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM;IAIjC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAalC;;;;;OAKG;IACH,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIlC;;;;OAIG;IACH,gBAAgB,IAAI,MAAM,EAAE;IAI5B;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAI7D;;;;OAIG;IACH,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,sBAAsB,CAAC,GAAG,IAAI;IAsB3D;;;;OAIG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIhC;;;;OAIG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIjC;;;;OAIG;IACH,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAIzC;;;;OAIG;IACH,gBAAgB,CAAC,aAAa,EAAE,OAAO,GAAG,IAAI;IAI9C;;;;OAIG;IACH,iBAAiB,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,GAAG,IAAI;IAIvD;;;;OAIG;IACH,WAAW,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI;IAIpC;;;;OAIG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIhC;;OAEG;IACH,KAAK,IAAI,IAAI;IAYb;;OAEG;IACH,UAAU,IAAI,sBAAsB;IAIpC;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IA6IpB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAKzB"}

package/dist/types/lib/layers/index.d.ts

@@ -0,0 +1,3 @@
+export { PointCloudManager } from './PointCloudManager';
+export type { PointCloudLayerOptions } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/lib/layers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/layers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC"}

package/dist/types/lib/layers/types.d.ts

@@ -0,0 +1,71 @@
+import { ColorScheme } from '../core/types';
+/**
+ * Information about a picked point
+ */
+export interface PickedPointInfo {
+    /** Point index within the point cloud */
+    index: number;
+    /** Longitude coordinate */
+    longitude: number;
+    /** Latitude coordinate */
+    latitude: number;
+    /** Elevation in meters */
+    elevation: number;
+    /** Intensity value (0-1) if available */
+    intensity?: number;
+    /** Classification code if available */
+    classification?: number;
+    /** Red color component (0-255) if available */
+    red?: number;
+    /** Green color component (0-255) if available */
+    green?: number;
+    /** Blue color component (0-255) if available */
+    blue?: number;
+    /** Dynamic map of all extra attributes available for this point */
+    attributes?: Record<string, number>;
+    /** Screen X coordinate */
+    x: number;
+    /** Screen Y coordinate */
+    y: number;
+}
+/**
+ * Options for configuring point cloud layer styling
+ */
+export interface PointCloudLayerOptions {
+    /**
+     * Point size in pixels
+     */
+    pointSize: number;
+    /**
+     * Opacity (0-1)
+     */
+    opacity: number;
+    /**
+     * Color scheme for visualization
+     */
+    colorScheme: ColorScheme;
+    /**
+     * Whether to use percentile range (2-98%) for elevation/intensity coloring
+     * @default true
+     */
+    usePercentile: boolean;
+    /**
+     * Elevation range filter [min, max] or null for no filter
+     */
+    elevationRange: [number, number] | null;
+    /**
+     * Whether points are pickable (enables hover/click interactions)
+     * @default false
+     */
+    pickable: boolean;
+    /**
+     * Z offset in meters (shifts point cloud vertically)
+     * @default 0
+     */
+    zOffset: number;
+    /**
+     * Callback when a point is hovered (requires pickable: true)
+     */
+    onHover?: (info: PickedPointInfo | null) => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types/lib/layers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/lib/layers/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+CAA+C;IAC/C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,0BAA0B;IAC1B,CAAC,EAAE,MAAM,CAAC;IACV,0BAA0B;IAC1B,CAAC,EAAE,MAAM,CAAC;CACX;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,WAAW,EAAE,WAAW,CAAC;IAEzB;;;OAGG;IACH,aAAa,EAAE,OAAO,CAAC;IAEvB;;OAEG;IACH,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IAExC;;;OAGG;IACH,QAAQ,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,KAAK,IAAI,CAAC;CAClD"}

package/dist/types/lib/loaders/CopcStreamingLoader.d.ts

@@ -0,0 +1,217 @@
+import { CachedNode, StreamingLoaderOptions, ViewportInfo, StreamingLoaderEvent, StreamingLoaderEventHandler } from './streaming-types';
+import { PointCloudData } from './types';
+import { PointCloudBounds } from '../core/types';
+/**
+ * Source type for streaming loader - can be URL, File, or ArrayBuffer
+ */
+export type StreamingSource = string | File | ArrayBuffer;
+/**
+ * Streams COPC point cloud data on-demand based on viewport.
+ * Implements center-first priority loading and respects point budget.
+ * Supports both URL and local file (File/ArrayBuffer) sources.
+ */
+export declare class CopcStreamingLoader {
+    private _originalSource;
+    private _source;
+    private _copc;
+    private _lazPerf;
+    private _options;
+    private _hierarchyPages;
+    private _loadedHierarchyKeys;
+    private _rootHierarchyPage;
+    private _nodeCache;
+    private _positions;
+    private _colors;
+    private _intensities;
+    private _classifications;
+    private _extraAttributes;
+    private _coordinateOrigin;
+    private _bounds;
+    private _loadingQueue;
+    private _activeRequests;
+    private _totalLoadedPoints;
+    private _totalLoadedNodes;
+    private _isInitialized;
+    private _transformer;
+    private _verticalUnitFactor;
+    private _needsTransform;
+    private _hasColor;
+    private _totalPointsInFile;
+    private _octreeCube;
+    private _spacing;
+    private _availableDimensions;
+    private _dimensionsDetected;
+    private _eventHandlers;
+    private _pendingLayerUpdate;
+    private _updateBatchTimeout;
+    private _onPointsLoaded?;
+    /**
+     * Creates a new CopcStreamingLoader instance.
+     *
+     * @param source - URL string, File object, or ArrayBuffer
+     * @param options - Streaming options
+     */
+    constructor(source: StreamingSource, options?: StreamingLoaderOptions);
+    /**
+     * Initializes the COPC file - reads header and root hierarchy.
+     * Must be called before any loading operations.
+     *
+     * @returns Initial info about the point cloud
+     */
+    initialize(): Promise<{
+        bounds: PointCloudBounds;
+        totalPoints: number;
+        hasRGB: boolean;
+        spacing: number;
+    }>;
+    /**
+     * Pre-allocates buffers for the point budget.
+     */
+    private _allocateBuffers;
+    /**
+     * Gets the octree spacing value (useful for ViewportManager).
+     */
+    getSpacing(): number;
+    /**
+     * Parses a node key string to array format.
+     *
+     * @param key - Node key in format "depth-x-y-z"
+     * @returns NodeKey array [depth, x, y, z]
+     */
+    private _parseNodeKey;
+    /**
+     * Calculates the bounding box of an octree node.
+     *
+     * @param key - Node key [depth, x, y, z]
+     * @returns Node bounds in source CRS and WGS84
+     */
+    private _calculateNodeBounds;
+    /**
+     * Checks if a node's bounds intersect the viewport.
+     * Adds a buffer around viewport to catch edge/corner nodes.
+     *
+     * @param nodeBounds - Node bounds in WGS84
+     * @param viewport - Current viewport info
+     * @returns True if bounds intersect
+     */
+    private _boundsIntersectsViewport;
+    /**
+     * Calculates node priority based on distance from viewport center.
+     * Lower values = higher priority (closer to center).
+     *
+     * @param nodeBounds - Node bounds in WGS84
+     * @param viewport - Current viewport info
+     * @returns Priority value (distance from center)
+     */
+    private _calculateNodePriority;
+    /**
+     * Ensures the hierarchy page containing a node key is loaded.
+     *
+     * @param nodeKey - Node key to ensure hierarchy for
+     */
+    private _ensureHierarchyLoaded;
+    /**
+     * Recursively loads hierarchy pages.
+     *
+     * @param page - Hierarchy page to load
+     */
+    private _loadHierarchyRecursive;
+    /**
+     * Finds nodes that intersect the viewport and should be loaded.
+     * Implements center-first priority and LOD selection.
+     * Loads nodes at ALL depths up to targetDepth to ensure full coverage
+     * (parent nodes fill gaps where child nodes don't exist in sparse octrees).
+     *
+     * @param viewport - Current viewport information
+     * @returns Sorted array of nodes to load (by priority)
+     */
+    selectNodesForViewport(viewport: ViewportInfo): Promise<CachedNode[]>;
+    /**
+     * Queues a node for loading.
+     *
+     * @param node - Node to queue
+     */
+    queueNode(node: CachedNode): void;
+    /**
+     * Loads nodes from the queue, respecting point budget and concurrency limits.
+     */
+    loadQueuedNodes(): Promise<void>;
+    /**
+     * Loads a single node's point data.
+     *
+     * @param node - Node to load
+     */
+    private _loadNode;
+    /**
+     * Extracts point data from a view into the buffers.
+     *
+     * @param view - Point data view from copc.js
+     * @param node - Node being loaded
+     * @param startIndex - Starting index in buffers
+     */
+    private _extractPointData;
+    /**
+     * Schedules a batched layer update.
+     */
+    private _scheduleLayerUpdate;
+    /**
+     * Performs the layer update callback.
+     */
+    private _performLayerUpdate;
+    /**
+     * Sets the callback for when points are loaded.
+     *
+     * @param callback - Function to call with updated point cloud data
+     */
+    setOnPointsLoaded(callback: (data: PointCloudData) => void): void;
+    /**
+     * Gets the current loaded point cloud data for rendering.
+     *
+     * @returns Current loaded data
+     */
+    getLoadedPointCloudData(): PointCloudData;
+    /**
+     * Gets the current streaming progress.
+     *
+     * @returns Progress event data
+     */
+    private _getProgressEvent;
+    /**
+     * Registers an event handler.
+     *
+     * @param event - Event type
+     * @param handler - Handler function
+     */
+    on(event: StreamingLoaderEvent, handler: StreamingLoaderEventHandler): void;
+    /**
+     * Removes an event handler.
+     *
+     * @param event - Event type
+     * @param handler - Handler function
+     */
+    off(event: StreamingLoaderEvent, handler: StreamingLoaderEventHandler): void;
+    /**
+     * Emits an event to all registered handlers.
+     *
+     * @param event - Event type
+     * @param data - Event data
+     */
+    private _emit;
+    /**
+     * Gets the total number of loaded points.
+     */
+    getLoadedPointCount(): number;
+    /**
+     * Gets the total number of loaded nodes.
+     */
+    getLoadedNodeCount(): number;
+    /**
+     * Checks if the loader is currently loading.
+     */
+    isLoading(): boolean;
+    /**
+     * Destroys the streaming loader and cleans up resources.
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=CopcStreamingLoader.d.ts.map

package/dist/types/lib/loaders/CopcStreamingLoader.d.ts.map

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

package/dist/types/lib/loaders/PointCloudLoader.d.ts

@@ -0,0 +1,61 @@
+import { PointCloudData } from './types';
+/**
+ * Loads and parses LiDAR point cloud files (LAS, LAZ, COPC).
+ * Uses copc.js for COPC/LAZ files with LAS 1.4 support.
+ */
+export declare class PointCloudLoader {
+    /**
+     * Creates a new PointCloudLoader instance.
+     */
+    constructor();
+    private _onProgress?;
+    /**
+     * Loads a point cloud from a URL, File, or ArrayBuffer.
+     *
+     * @param source - URL string, File object, or ArrayBuffer
+     * @param onProgress - Optional progress callback (progress: 0-100, message: string)
+     * @returns Normalized point cloud data
+     */
+    load(source: string | File | ArrayBuffer, onProgress?: (progress: number, message: string) => void): Promise<PointCloudData>;
+    /**
+     * Reports progress to the callback if set.
+     */
+    private _reportProgress;
+    /**
+     * Yields to the event loop to allow UI updates.
+     */
+    private _yieldToUI;
+    /**
+     * Loads a COPC file from a URL using the copc.js library.
+     * Falls back to loaders.gl for unsupported LAS versions (e.g., 1.3).
+     */
+    private _loadCopcFromUrl;
+    /**
+     * Loads a COPC file from an ArrayBuffer using the copc.js library.
+     * Falls back to loaders.gl for unsupported LAS versions (e.g., 1.3).
+     */
+    private _loadCopcFromBuffer;
+    /**
+     * Loads a regular LAS 1.2/1.4 file using copc.js Las module.
+     */
+    private _loadRegularLasFromBuffer;
+    /**
+     * Loads a point cloud using loaders.gl (fallback for LAS 1.0/1.1/1.3).
+     */
+    private _loadWithLoadersGL;
+    /**
+     * Loads a point cloud from URL using loaders.gl (fallback for unsupported LAS versions).
+     */
+    private _loadUrlWithLoadersGL;
+    /**
+     * Recursively loads all hierarchy pages from a COPC file.
+     * @param source - URL string or Getter function
+     * @param info - COPC info containing root hierarchy page
+     */
+    private _loadFullHierarchy;
+    /**
+     * Process COPC data and extract point cloud information.
+     */
+    private _processCopcData;
+}
+//# sourceMappingURL=PointCloudLoader.d.ts.map

package/dist/types/lib/loaders/PointCloudLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PointCloudLoader.d.ts","sourceRoot":"","sources":["../../../../src/lib/loaders/PointCloudLoader.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAwC,MAAM,SAAS,CAAC;AA+JpF;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B;;OAEG;;IAKH,OAAO,CAAC,WAAW,CAAC,CAA8C;IAElE;;;;;;OAMG;IACG,IAAI,CACR,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,WAAW,EACnC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,GACvD,OAAO,CAAC,cAAc,CAAC;IAyB1B;;OAEG;IACH,OAAO,CAAC,eAAe;IAMvB;;OAEG;YACW,UAAU;IAIxB;;;OAGG;YACW,gBAAgB;IA+C9B;;;OAGG;YACW,mBAAmB;IAoDjC;;OAEG;YACW,yBAAyB;IAsLvC;;OAEG;YACW,kBAAkB;IAmNhC;;OAEG;YACW,qBAAqB;IAcnC;;;;OAIG;YACW,kBAAkB;IA6BhC;;OAEG;YACW,gBAAgB;CAgP/B"}

package/dist/types/lib/loaders/index.d.ts

@@ -0,0 +1,5 @@
+export { PointCloudLoader } from './PointCloudLoader';
+export { CopcStreamingLoader } from './CopcStreamingLoader';
+export type { PointCloudData, LoaderOptions } from './types';
+export type { CopcLoadingMode, StreamingLoaderOptions, StreamingProgressEvent, ViewportInfo, CachedNode, NodeKey, NodeState, StreamingLoaderEvent, StreamingLoaderEventHandler, StreamingLoadOptions, } from './streaming-types';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/lib/loaders/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/loaders/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7D,YAAY,EACV,eAAe,EACf,sBAAsB,EACtB,sBAAsB,EACtB,YAAY,EACZ,UAAU,EACV,OAAO,EACP,SAAS,EACT,oBAAoB,EACpB,2BAA2B,EAC3B,oBAAoB,GACrB,MAAM,mBAAmB,CAAC"}

package/dist/types/lib/loaders/streaming-types.d.ts

@@ -0,0 +1,122 @@
+import { PointCloudBounds } from '../core/types';
+/**
+ * COPC loading mode options
+ */
+export type CopcLoadingMode = 'full' | 'dynamic';
+/**
+ * Represents an octree node key in COPC format
+ * Format: [depth, x, y, z]
+ */
+export type NodeKey = [number, number, number, number];
+/**
+ * Streaming loader options
+ */
+export interface StreamingLoaderOptions {
+    /**
+     * Maximum number of points to keep in memory
+     * @default 5_000_000
+     */
+    pointBudget?: number;
+    /**
+     * Maximum concurrent node requests
+     * @default 4
+     */
+    maxConcurrentRequests?: number;
+    /**
+     * Debounce time for viewport changes in ms
+     * @default 150
+     */
+    viewportDebounceMs?: number;
+    /**
+     * Minimum zoom level to start loading high-detail nodes
+     * @default 10
+     */
+    minDetailZoom?: number;
+    /**
+     * Maximum octree depth to load
+     * @default 20
+     */
+    maxOctreeDepth?: number;
+}
+/**
+ * State of a node in the streaming cache
+ */
+export type NodeState = 'pending' | 'loading' | 'loaded' | 'error';
+/**
+ * Cached node data
+ */
+export interface CachedNode {
+    /** String format key: "depth-x-y-z" */
+    key: string;
+    /** Array format key: [depth, x, y, z] */
+    keyArray: NodeKey;
+    /** Current state of the node */
+    state: NodeState;
+    /** Number of points in this node */
+    pointCount: number;
+    /** Offset in the COPC file for point data */
+    pointDataOffset: number;
+    /** Length of point data in bytes */
+    pointDataLength: number;
+    /** Bounding box in source CRS */
+    bounds: PointCloudBounds;
+    /** Bounding box in WGS84 (for viewport intersection) */
+    boundsWgs84: PointCloudBounds;
+    /** Distance from viewport center (for priority queue) - lower = higher priority */
+    priority?: number;
+    /** Points array slice start index in the main buffer */
+    bufferStartIndex?: number;
+    /** Error message if state is 'error' */
+    error?: string;
+}
+/**
+ * Viewport information for node selection
+ */
+export interface ViewportInfo {
+    /** Viewport bounds in WGS84 [west, south, east, north] */
+    bounds: [number, number, number, number];
+    /** Viewport center in WGS84 [lng, lat] */
+    center: [number, number];
+    /** Current zoom level */
+    zoom: number;
+    /** Current pitch (tilt angle in degrees) */
+    pitch: number;
+    /** Target octree depth based on zoom and pitch */
+    targetDepth: number;
+}
+/**
+ * Streaming progress event data
+ */
+export interface StreamingProgressEvent {
+    /** Total nodes in viewport */
+    totalNodesInView: number;
+    /** Nodes currently loaded */
+    loadedNodes: number;
+    /** Points currently loaded */
+    loadedPoints: number;
+    /** Point budget limit */
+    pointBudget: number;
+    /** Whether loading is in progress */
+    isLoading: boolean;
+    /** Current loading queue size */
+    queueSize: number;
+}
+/**
+ * Events emitted by the streaming loader
+ */
+export type StreamingLoaderEvent = 'progress' | 'nodeloaded' | 'viewportchange' | 'budgetreached' | 'error';
+/**
+ * Event handler for streaming loader events
+ */
+export type StreamingLoaderEventHandler = (event: StreamingLoaderEvent, data: StreamingProgressEvent | CachedNode | Error) => void;
+/**
+ * Load options that can be passed to loadPointCloud for streaming
+ */
+export interface StreamingLoadOptions extends StreamingLoaderOptions {
+    /**
+     * Loading mode: 'full' for complete load, 'dynamic' for viewport-based streaming
+     * @default 'full'
+     */
+    loadingMode?: CopcLoadingMode;
+}
+//# sourceMappingURL=streaming-types.d.ts.map

package/dist/types/lib/loaders/streaming-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming-types.d.ts","sourceRoot":"","sources":["../../../../src/lib/loaders/streaming-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,SAAS,CAAC;AAEjD;;;GAGG;AACH,MAAM,MAAM,OAAO,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAE/B;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,uCAAuC;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,yCAAyC;IACzC,QAAQ,EAAE,OAAO,CAAC;IAClB,gCAAgC;IAChC,KAAK,EAAE,SAAS,CAAC;IACjB,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,eAAe,EAAE,MAAM,CAAC;IACxB,oCAAoC;IACpC,eAAe,EAAE,MAAM,CAAC;IACxB,iCAAiC;IACjC,MAAM,EAAE,gBAAgB,CAAC;IACzB,wDAAwD;IACxD,WAAW,EAAE,gBAAgB,CAAC;IAC9B,mFAAmF;IACnF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,0DAA0D;IAC1D,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,0CAA0C;IAC1C,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzB,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,8BAA8B;IAC9B,gBAAgB,EAAE,MAAM,CAAC;IACzB,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,yBAAyB;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,qCAAqC;IACrC,SAAS,EAAE,OAAO,CAAC;IACnB,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAC5B,UAAU,GACV,YAAY,GACZ,gBAAgB,GAChB,eAAe,GACf,OAAO,CAAC;AAEZ;;GAEG;AACH,MAAM,MAAM,2BAA2B,GAAG,CACxC,KAAK,EAAE,oBAAoB,EAC3B,IAAI,EAAE,sBAAsB,GAAG,UAAU,GAAG,KAAK,KAC9C,IAAI,CAAC;AAEV;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,sBAAsB;IAClE;;;OAGG;IACH,WAAW,CAAC,EAAE,eAAe,CAAC;CAC/B"}