maplibre-gl-lidar 0.1.0

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

@@ -0,0 +1,235 @@
+import { Map } from 'maplibre-gl';
+/**
+ * COPC loading mode options
+ */
+export type CopcLoadingMode = 'full' | 'dynamic';
+/**
+ * Color scheme options for point cloud visualization
+ */
+export type ColorSchemeType = 'elevation' | 'intensity' | 'classification' | 'rgb';
+/**
+ * Custom color scheme configuration
+ */
+export interface ColorSchemeConfig {
+    type: 'gradient' | 'categorical';
+    attribute: string;
+    colors?: string[];
+    domain?: [number, number];
+}
+/**
+ * Color scheme can be a preset string or custom configuration
+ */
+export type ColorScheme = ColorSchemeType | ColorSchemeConfig;
+/**
+ * Point cloud bounding box
+ */
+export interface PointCloudBounds {
+    minX: number;
+    maxX: number;
+    minY: number;
+    maxY: number;
+    minZ: number;
+    maxZ: number;
+}
+/**
+ * Information about a loaded point cloud
+ */
+export interface PointCloudInfo {
+    id: string;
+    name: string;
+    pointCount: number;
+    bounds: PointCloudBounds;
+    hasRGB: boolean;
+    hasIntensity: boolean;
+    hasClassification: boolean;
+    source: string;
+    /** WKT string describing the coordinate reference system */
+    wkt?: string;
+}
+/**
+ * Options for configuring the LidarControl
+ */
+export interface LidarControlOptions {
+    /**
+     * Whether the control panel should start collapsed
+     * @default true
+     */
+    collapsed?: boolean;
+    /**
+     * Position of the control on the map
+     * @default 'top-right'
+     */
+    position?: 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
+    /**
+     * Title displayed in the control header
+     * @default 'LiDAR Viewer'
+     */
+    title?: string;
+    /**
+     * Width of the control panel in pixels
+     * @default 320
+     */
+    panelWidth?: number;
+    /**
+     * Maximum height of the control panel in pixels.
+     * When content exceeds this height, a vertical scrollbar appears.
+     * @default 500
+     */
+    panelMaxHeight?: number;
+    /**
+     * Custom CSS class name for the control container
+     */
+    className?: string;
+    /**
+     * Point size in pixels
+     * @default 2
+     */
+    pointSize?: number;
+    /**
+     * Point cloud opacity (0-1)
+     * @default 1.0
+     */
+    opacity?: number;
+    /**
+     * Color scheme for visualization
+     * @default 'elevation'
+     */
+    colorScheme?: ColorScheme;
+    /**
+     * Whether to use percentile range (2-98%) for elevation/intensity coloring.
+     * When true, outliers are clipped for better color distribution.
+     * @default true
+     */
+    usePercentile?: boolean;
+    /**
+     * Maximum number of points to display
+     * @default 1000000
+     */
+    pointBudget?: number;
+    /**
+     * Elevation range filter [min, max] or null for no filter
+     * @default null
+     */
+    elevationRange?: [number, number] | null;
+    /**
+     * Whether points are pickable (enables hover/click interactions)
+     * @default false
+     */
+    pickable?: boolean;
+    /**
+     * Whether to automatically zoom to the data extent after loading
+     * @default true
+     */
+    autoZoom?: boolean;
+    /**
+     * List of attribute names to display in the pick point info panel.
+     * If not specified or empty, all available attributes will be shown.
+     * Example: ['GpsTime', 'ReturnNumber', 'Classification', 'Intensity']
+     * @default undefined (show all)
+     */
+    pickInfoFields?: string[];
+    /**
+     * Whether Z offset adjustment is enabled
+     * @default false
+     */
+    zOffsetEnabled?: boolean;
+    /**
+     * Z offset value in meters (shifts point cloud vertically)
+     * @default 0
+     */
+    zOffset?: number;
+    /**
+     * Loading mode for COPC files: 'full' loads entire file, 'dynamic' streams based on viewport
+     * @default 'full'
+     */
+    copcLoadingMode?: CopcLoadingMode;
+    /**
+     * Point budget for streaming mode (maximum points in memory)
+     * @default 5000000
+     */
+    streamingPointBudget?: number;
+    /**
+     * Maximum concurrent requests for streaming mode
+     * @default 4
+     */
+    streamingMaxConcurrentRequests?: number;
+    /**
+     * Debounce time for viewport changes in streaming mode (ms)
+     * @default 150
+     */
+    streamingViewportDebounceMs?: number;
+}
+/**
+ * Internal state of the LiDAR control
+ */
+export interface LidarState {
+    collapsed: boolean;
+    panelWidth: number;
+    panelMaxHeight: number;
+    pointClouds: PointCloudInfo[];
+    activePointCloudId: string | null;
+    pointSize: number;
+    opacity: number;
+    colorScheme: ColorScheme;
+    /** Whether to use percentile range (2-98%) for elevation/intensity coloring */
+    usePercentile: boolean;
+    elevationRange: [number, number] | null;
+    pointBudget: number;
+    pickable: boolean;
+    loading: boolean;
+    error: string | null;
+    /** List of attribute names to show in pick info, or undefined to show all */
+    pickInfoFields?: string[];
+    /** Whether Z offset adjustment is enabled */
+    zOffsetEnabled: boolean;
+    /** Z offset value in meters */
+    zOffset: number;
+    /** Whether streaming mode is active */
+    streamingActive?: boolean;
+    /** Current streaming progress */
+    streamingProgress?: {
+        loadedNodes: number;
+        loadedPoints: number;
+        queueSize: number;
+        isLoading: boolean;
+    };
+}
+/**
+ * Event types emitted by the LiDAR control
+ */
+export type LidarControlEvent = 'collapse' | 'expand' | 'statechange' | 'load' | 'loadstart' | 'loaderror' | 'unload' | 'stylechange' | 'streamingprogress' | 'streamingstart' | 'streamingstop' | 'budgetreached';
+/**
+ * Event data passed to event handlers
+ */
+export interface LidarEventData {
+    type: LidarControlEvent;
+    state: LidarState;
+    pointCloud?: PointCloudInfo;
+    error?: Error;
+}
+/**
+ * Event handler function type
+ */
+export type LidarControlEventHandler = (event: LidarEventData) => void;
+/**
+ * Props for the React wrapper component
+ */
+export interface LidarControlReactProps extends LidarControlOptions {
+    /**
+     * MapLibre GL map instance
+     */
+    map: Map;
+    /**
+     * Callback fired when the control state changes
+     */
+    onStateChange?: (state: LidarState) => void;
+    /**
+     * Callback fired when a point cloud is loaded
+     */
+    onLoad?: (pointCloud: PointCloudInfo) => void;
+    /**
+     * Callback fired when an error occurs
+     */
+    onError?: (error: Error) => void;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/types/lib/gui/DualRangeSlider.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Options for creating a dual-handle range slider
+ */
+export interface DualRangeSliderOptions {
+    label: string;
+    min: number;
+    max: number;
+    step: number;
+    valueLow: number;
+    valueHigh: number;
+    onChange: (low: number, high: number) => void;
+    formatValue?: (value: number) => string;
+}
+/**
+ * Creates a dual-handle range slider for selecting a range.
+ */
+export declare class DualRangeSlider {
+    private _options;
+    private _sliderLow?;
+    private _sliderHigh?;
+    private _valueDisplay?;
+    constructor(options: DualRangeSliderOptions);
+    /**
+     * Renders the dual slider element.
+     *
+     * @returns The slider container element
+     */
+    render(): HTMLElement;
+    /**
+     * Sets the slider range programmatically.
+     */
+    setRange(low: number, high: number): void;
+    /**
+     * Updates the min/max bounds of the slider.
+     */
+    setBounds(min: number, max: number): void;
+    /**
+     * Gets the current range values.
+     */
+    getRange(): [number, number];
+    /**
+     * Formats the range for display.
+     */
+    private _formatRange;
+}
+//# sourceMappingURL=DualRangeSlider.d.ts.map

package/dist/types/lib/gui/DualRangeSlider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DualRangeSlider.d.ts","sourceRoot":"","sources":["../../../../src/lib/gui/DualRangeSlider.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;CACzC;AAED;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,UAAU,CAAC,CAAmB;IACtC,OAAO,CAAC,WAAW,CAAC,CAAmB;IACvC,OAAO,CAAC,aAAa,CAAC,CAAc;gBAExB,OAAO,EAAE,sBAAsB;IAI3C;;;;OAIG;IACH,MAAM,IAAI,WAAW;IA+KrB;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAYzC;;OAEG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAazC;;OAEG;IACH,QAAQ,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC;IAM5B;;OAEG;IACH,OAAO,CAAC,YAAY;CAIrB"}

package/dist/types/lib/gui/FileInput.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Options for creating a file input
+ */
+export interface FileInputOptions {
+    accept?: string;
+    onChange: (file: File) => void;
+    label?: string;
+}
+/**
+ * Creates a styled file input with drag-and-drop support.
+ */
+export declare class FileInput {
+    private _options;
+    private _input?;
+    private _label?;
+    constructor(options: FileInputOptions);
+    /**
+     * Renders the file input element.
+     *
+     * @returns The file input container element
+     */
+    render(): HTMLElement;
+    /**
+     * Sets the label text.
+     *
+     * @param text - New label text
+     */
+    setLabel(text: string): void;
+    /**
+     * Resets the label to default.
+     */
+    resetLabel(): void;
+    /**
+     * Enables or disables the input.
+     *
+     * @param enabled - Whether to enable
+     */
+    setEnabled(enabled: boolean): void;
+    /**
+     * Checks if a file has a valid extension.
+     */
+    private _isValidFile;
+}
+//# sourceMappingURL=FileInput.d.ts.map

package/dist/types/lib/gui/FileInput.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileInput.d.ts","sourceRoot":"","sources":["../../../../src/lib/gui/FileInput.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAmB;IACnC,OAAO,CAAC,MAAM,CAAC,CAAmB;IAClC,OAAO,CAAC,MAAM,CAAC,CAAc;gBAEjB,OAAO,EAAE,gBAAgB;IAQrC;;;;OAIG;IACH,MAAM,IAAI,WAAW;IA6DrB;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAS5B;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;;;OAIG;IACH,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAUlC;;OAEG;IACH,OAAO,CAAC,YAAY;CAMrB"}

package/dist/types/lib/gui/PanelBuilder.d.ts

@@ -0,0 +1,117 @@
+import { LidarState, ColorScheme } from '../core/types';
+/**
+ * Callbacks for panel interactions
+ */
+export interface PanelBuilderCallbacks {
+    onFileSelect: (file: File) => void;
+    onUrlSubmit: (url: string) => void;
+    onPointSizeChange: (size: number) => void;
+    onOpacityChange: (opacity: number) => void;
+    onColorSchemeChange: (scheme: ColorScheme) => void;
+    onUsePercentileChange: (usePercentile: boolean) => void;
+    onElevationRangeChange: (range: [number, number] | null) => void;
+    onPickableChange: (pickable: boolean) => void;
+    onZOffsetEnabledChange: (enabled: boolean) => void;
+    onZOffsetChange: (offset: number) => void;
+    onUnload: (id: string) => void;
+    onZoomTo: (id: string) => void;
+}
+/**
+ * Builds and manages the LiDAR control panel UI.
+ */
+export declare class PanelBuilder {
+    private _callbacks;
+    private _state;
+    private _contentElement?;
+    private _fileInput?;
+    private _urlInput?;
+    private _loadButton?;
+    private _colorSelect?;
+    private _percentileCheckbox?;
+    private _percentileGroup?;
+    private _pointSizeSlider?;
+    private _opacitySlider?;
+    private _pointCloudsList?;
+    private _pickableCheckbox?;
+    private _elevationSlider?;
+    private _elevationCheckbox?;
+    private _zOffsetCheckbox?;
+    private _zOffsetSlider?;
+    private _zOffsetSliderContainer?;
+    private _loadingIndicator?;
+    private _errorMessage?;
+    constructor(callbacks: PanelBuilderCallbacks, initialState: LidarState);
+    /**
+     * Builds and returns the panel content.
+     *
+     * @returns The panel content element
+     */
+    build(): HTMLElement;
+    /**
+     * Updates the UI to reflect the current state.
+     *
+     * @param state - New state
+     */
+    updateState(state: LidarState): void;
+    /**
+     * Updates the loading progress display.
+     *
+     * @param progress - Progress value (0-100)
+     * @param message - Optional progress message
+     */
+    updateLoadingProgress(progress: number, message?: string): void;
+    /**
+     * Builds the file input section.
+     */
+    private _buildFileSection;
+    /**
+     * Builds the styling controls section.
+     */
+    private _buildStylingSection;
+    /**
+     * Builds the elevation filter controls with checkbox and dual slider.
+     */
+    private _buildElevationFilter;
+    /**
+     * Builds the Z offset control with checkbox and slider.
+     */
+    private _buildZOffsetControl;
+    /**
+     * Gets the elevation bounds from loaded point clouds.
+     */
+    private _getElevationBounds;
+    /**
+     * Builds the percentile checkbox control for elevation/intensity coloring.
+     */
+    private _buildPercentileCheckbox;
+    /**
+     * Updates the visibility of the percentile checkbox based on color scheme.
+     * Only shows for elevation and intensity color schemes.
+     */
+    private _updatePercentileVisibility;
+    /**
+     * Builds the pickable checkbox control.
+     */
+    private _buildPickableCheckbox;
+    /**
+     * Builds the loaded point clouds list.
+     */
+    private _buildPointCloudsList;
+    /**
+     * Updates the point clouds list display.
+     */
+    private _updatePointCloudsList;
+    /**
+     * Builds a single point cloud list item.
+     */
+    private _buildPointCloudItem;
+    /**
+     * Builds the loading indicator.
+     */
+    private _buildLoadingIndicator;
+    /**
+     * Builds the error message display.
+     */
+    private _buildErrorMessage;
+}
+//# sourceMappingURL=PanelBuilder.d.ts.map

package/dist/types/lib/gui/PanelBuilder.d.ts.map

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

package/dist/types/lib/gui/RangeSlider.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Options for creating a range slider
+ */
+export interface RangeSliderOptions {
+    label: string;
+    min: number;
+    max: number;
+    step: number;
+    value: number;
+    onChange: (value: number) => void;
+    formatValue?: (value: number) => string;
+}
+/**
+ * Creates a styled range slider with label and value display.
+ */
+export declare class RangeSlider {
+    private _options;
+    private _slider?;
+    private _valueDisplay?;
+    constructor(options: RangeSliderOptions);
+    /**
+     * Renders the slider element.
+     *
+     * @returns The slider container element
+     */
+    render(): HTMLElement;
+    /**
+     * Sets the slider value programmatically.
+     *
+     * @param value - New value
+     */
+    setValue(value: number): void;
+    /**
+     * Gets the current value.
+     *
+     * @returns Current slider value
+     */
+    getValue(): number;
+    /**
+     * Enables or disables the slider.
+     *
+     * @param enabled - Whether to enable
+     */
+    setEnabled(enabled: boolean): void;
+    /**
+     * Formats the value for display.
+     */
+    private _formatValue;
+}
+//# sourceMappingURL=RangeSlider.d.ts.map

package/dist/types/lib/gui/RangeSlider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RangeSlider.d.ts","sourceRoot":"","sources":["../../../../src/lib/gui/RangeSlider.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;CACzC;AAED;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,OAAO,CAAC,CAAmB;IACnC,OAAO,CAAC,aAAa,CAAC,CAAc;gBAExB,OAAO,EAAE,kBAAkB;IAIvC;;;;OAIG;IACH,MAAM,IAAI,WAAW;IAwCrB;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAS7B;;;;OAIG;IACH,QAAQ,IAAI,MAAM;IAIlB;;;;OAIG;IACH,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAMlC;;OAEG;IACH,OAAO,CAAC,YAAY;CAMrB"}

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

@@ -0,0 +1,7 @@
+export { PanelBuilder } from './PanelBuilder';
+export type { PanelBuilderCallbacks } from './PanelBuilder';
+export { RangeSlider } from './RangeSlider';
+export type { RangeSliderOptions } from './RangeSlider';
+export { FileInput } from './FileInput';
+export type { FileInputOptions } from './FileInput';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/gui/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC"}

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

@@ -0,0 +1,3 @@
+export { useLidarState } from './useLidarState';
+export { usePointCloud } from './usePointCloud';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/types/lib/hooks/useLidarState.d.ts

@@ -0,0 +1,52 @@
+import { LidarState, ColorScheme } from '../core/types';
+/**
+ * Custom hook for managing LiDAR state in React applications.
+ *
+ * This hook provides a simple way to track and update the state
+ * of a LidarControl from React components.
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const { state, setPointSize, setColorScheme, toggle } = useLidarState();
+ *
+ *   return (
+ *     <div>
+ *       <button onClick={toggle}>
+ *         {state.collapsed ? 'Expand' : 'Collapse'}
+ *       </button>
+ *       <button onClick={() => setColorScheme('intensity')}>
+ *         Show Intensity
+ *       </button>
+ *       <LidarControlReact
+ *         map={map}
+ *         collapsed={state.collapsed}
+ *         pointSize={state.pointSize}
+ *         colorScheme={state.colorScheme}
+ *         onStateChange={(newState) => setState(newState)}
+ *       />
+ *     </div>
+ *   );
+ * }
+ * ```
+ *
+ * @param initialState - Optional initial state values
+ * @returns Object containing state and update functions
+ */
+export declare function useLidarState(initialState?: Partial<LidarState>): {
+    state: LidarState;
+    setState: import('react').Dispatch<import('react').SetStateAction<LidarState>>;
+    setCollapsed: (collapsed: boolean) => void;
+    setPanelWidth: (panelWidth: number) => void;
+    setPointSize: (pointSize: number) => void;
+    setOpacity: (opacity: number) => void;
+    setColorScheme: (colorScheme: ColorScheme) => void;
+    setUsePercentile: (usePercentile: boolean) => void;
+    setElevationRange: (elevationRange: [number, number] | null) => void;
+    setPointBudget: (pointBudget: number) => void;
+    setZOffsetEnabled: (zOffsetEnabled: boolean) => void;
+    setZOffset: (zOffset: number) => void;
+    reset: () => void;
+    toggle: () => void;
+};
+//# sourceMappingURL=useLidarState.d.ts.map

package/dist/types/lib/hooks/useLidarState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLidarState.d.ts","sourceRoot":"","sources":["../../../../src/lib/hooks/useLidarState.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAwB7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,aAAa,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC;;;8BASjB,OAAO;gCAOL,MAAM;8BAOR,MAAM;0BAOV,MAAM;kCAOE,WAAW;sCAOP,OAAO;wCAOL,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;kCAO7B,MAAM;wCAOA,OAAO;0BAOrB,MAAM;;;EAkChD"}

package/dist/types/lib/hooks/usePointCloud.d.ts

@@ -0,0 +1,53 @@
+import { PointCloudData, LoaderOptions } from '../loaders/types';
+/**
+ * Result of the usePointCloud hook
+ */
+interface UsePointCloudResult {
+    /** The loaded point cloud data or null */
+    data: PointCloudData | null;
+    /** Whether loading is in progress */
+    loading: boolean;
+    /** Error if loading failed */
+    error: Error | null;
+    /** Loading progress (0-1) */
+    progress: number;
+    /** Function to load a point cloud */
+    load: (source: string | File | ArrayBuffer) => Promise<PointCloudData | null>;
+    /** Function to reset the state */
+    reset: () => void;
+}
+/**
+ * Custom hook for loading point cloud data in React applications.
+ *
+ * This hook provides a simple way to load point cloud files
+ * with loading state and error handling.
+ *
+ * @example
+ * ```tsx
+ * function PointCloudLoader() {
+ *   const { data, loading, error, load, reset } = usePointCloud();
+ *
+ *   const handleFile = async (file: File) => {
+ *     const result = await load(file);
+ *     if (result) {
+ *       console.log(`Loaded ${result.pointCount} points`);
+ *     }
+ *   };
+ *
+ *   return (
+ *     <div>
+ *       <input type="file" onChange={(e) => handleFile(e.target.files?.[0])} />
+ *       {loading && <p>Loading...</p>}
+ *       {error && <p>Error: {error.message}</p>}
+ *       {data && <p>Loaded {data.pointCount} points</p>}
+ *     </div>
+ *   );
+ * }
+ * ```
+ *
+ * @param options - Optional loader options
+ * @returns Object containing state and functions
+ */
+export declare function usePointCloud(options?: Partial<LoaderOptions>): UsePointCloudResult;
+export {};
+//# sourceMappingURL=usePointCloud.d.ts.map

package/dist/types/lib/hooks/usePointCloud.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePointCloud.d.ts","sourceRoot":"","sources":["../../../../src/lib/hooks/usePointCloud.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtE;;GAEG;AACH,UAAU,mBAAmB;IAC3B,0CAA0C;IAC1C,IAAI,EAAE,cAAc,GAAG,IAAI,CAAC;IAC5B,qCAAqC;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,8BAA8B;IAC9B,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,WAAW,KAAK,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAC9E,kCAAkC;IAClC,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,mBAAmB,CAoCnF"}