maplibre-gl-lidar 0.1.0

package/dist/react.cjs

@@ -0,0 +1,179 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const react = require("react");
+const LidarControl = require("./LidarControl-CQjIl4U5.cjs");
+function LidarControlReact({
+  map,
+  onStateChange,
+  onLoad,
+  onError,
+  ...options
+}) {
+  const controlRef = react.useRef(null);
+  react.useEffect(() => {
+    if (!map) return;
+    const control = new LidarControl.LidarControl(options);
+    controlRef.current = control;
+    if (onStateChange) {
+      control.on("statechange", (event) => {
+        onStateChange(event.state);
+      });
+    }
+    if (onLoad) {
+      control.on("load", (event) => {
+        if (event.pointCloud) {
+          onLoad(event.pointCloud);
+        }
+      });
+    }
+    if (onError) {
+      control.on("loaderror", (event) => {
+        if (event.error) {
+          onError(event.error);
+        }
+      });
+    }
+    map.addControl(control, options.position || "top-right");
+    return () => {
+      if (map.hasControl(control)) {
+        map.removeControl(control);
+      }
+      controlRef.current = null;
+    };
+  }, [map]);
+  react.useEffect(() => {
+    if (controlRef.current) {
+      const currentState = controlRef.current.getState();
+      if (options.collapsed !== void 0 && options.collapsed !== currentState.collapsed) {
+        if (options.collapsed) {
+          controlRef.current.collapse();
+        } else {
+          controlRef.current.expand();
+        }
+      }
+      if (options.pointSize !== void 0 && options.pointSize !== currentState.pointSize) {
+        controlRef.current.setPointSize(options.pointSize);
+      }
+      if (options.opacity !== void 0 && options.opacity !== currentState.opacity) {
+        controlRef.current.setOpacity(options.opacity);
+      }
+      if (options.colorScheme !== void 0 && options.colorScheme !== currentState.colorScheme) {
+        controlRef.current.setColorScheme(options.colorScheme);
+      }
+    }
+  }, [options.collapsed, options.pointSize, options.opacity, options.colorScheme]);
+  return null;
+}
+const DEFAULT_STATE = {
+  collapsed: true,
+  panelWidth: 365,
+  panelMaxHeight: 600,
+  pointClouds: [],
+  activePointCloudId: null,
+  pointSize: 2,
+  opacity: 1,
+  colorScheme: "elevation",
+  usePercentile: true,
+  elevationRange: null,
+  pointBudget: 1e6,
+  pickable: false,
+  loading: false,
+  error: null,
+  zOffsetEnabled: false,
+  zOffset: 0
+};
+function useLidarState(initialState) {
+  const [state, setState] = react.useState({
+    ...DEFAULT_STATE,
+    ...initialState
+  });
+  const setCollapsed = react.useCallback((collapsed) => {
+    setState((prev) => ({ ...prev, collapsed }));
+  }, []);
+  const setPanelWidth = react.useCallback((panelWidth) => {
+    setState((prev) => ({ ...prev, panelWidth }));
+  }, []);
+  const setPointSize = react.useCallback((pointSize) => {
+    setState((prev) => ({ ...prev, pointSize }));
+  }, []);
+  const setOpacity = react.useCallback((opacity) => {
+    setState((prev) => ({ ...prev, opacity }));
+  }, []);
+  const setColorScheme = react.useCallback((colorScheme) => {
+    setState((prev) => ({ ...prev, colorScheme }));
+  }, []);
+  const setUsePercentile = react.useCallback((usePercentile) => {
+    setState((prev) => ({ ...prev, usePercentile }));
+  }, []);
+  const setElevationRange = react.useCallback((elevationRange) => {
+    setState((prev) => ({ ...prev, elevationRange }));
+  }, []);
+  const setPointBudget = react.useCallback((pointBudget) => {
+    setState((prev) => ({ ...prev, pointBudget }));
+  }, []);
+  const setZOffsetEnabled = react.useCallback((zOffsetEnabled) => {
+    setState((prev) => ({ ...prev, zOffsetEnabled }));
+  }, []);
+  const setZOffset = react.useCallback((zOffset) => {
+    setState((prev) => ({ ...prev, zOffset }));
+  }, []);
+  const reset = react.useCallback(() => {
+    setState({ ...DEFAULT_STATE, ...initialState });
+  }, [initialState]);
+  const toggle = react.useCallback(() => {
+    setState((prev) => ({ ...prev, collapsed: !prev.collapsed }));
+  }, []);
+  return {
+    state,
+    setState,
+    setCollapsed,
+    setPanelWidth,
+    setPointSize,
+    setOpacity,
+    setColorScheme,
+    setUsePercentile,
+    setElevationRange,
+    setPointBudget,
+    setZOffsetEnabled,
+    setZOffset,
+    reset,
+    toggle
+  };
+}
+function usePointCloud(options) {
+  const [data, setData] = react.useState(null);
+  const [loading, setLoading] = react.useState(false);
+  const [error, setError] = react.useState(null);
+  const [progress, setProgress] = react.useState(0);
+  const load = react.useCallback(
+    async (source) => {
+      setLoading(true);
+      setError(null);
+      setProgress(0);
+      try {
+        const loader = new LidarControl.PointCloudLoader();
+        const result = await loader.load(source);
+        setData(result);
+        return result;
+      } catch (err) {
+        const e = err instanceof Error ? err : new Error(String(err));
+        setError(e);
+        return null;
+      } finally {
+        setLoading(false);
+      }
+    },
+    [options]
+  );
+  const reset = react.useCallback(() => {
+    setData(null);
+    setLoading(false);
+    setError(null);
+    setProgress(0);
+  }, []);
+  return { data, loading, error, progress, load, reset };
+}
+exports.LidarControlReact = LidarControlReact;
+exports.useLidarState = useLidarState;
+exports.usePointCloud = usePointCloud;
+//# sourceMappingURL=react.cjs.map

package/dist/react.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.cjs","sources":["../src/lib/core/LidarControlReact.tsx","../src/lib/hooks/useLidarState.ts","../src/lib/hooks/usePointCloud.ts"],"sourcesContent":["import { useEffect, useRef } from 'react';\nimport { LidarControl } from './LidarControl';\nimport type { LidarControlReactProps } from './types';\n\n/**\n * React wrapper component for LidarControl.\n *\n * This component manages the lifecycle of a LidarControl instance,\n * adding it to the map on mount and removing it on unmount.\n *\n * @example\n * ```tsx\n * import { LidarControlReact } from 'maplibre-gl-lidar/react';\n *\n * function MyMap() {\n *   const [map, setMap] = useState<Map | null>(null);\n *\n *   return (\n *     <>\n *       <div ref={mapContainer} />\n *       {map && (\n *         <LidarControlReact\n *           map={map}\n *           title=\"LiDAR Viewer\"\n *           collapsed={false}\n *           onLoad={(pc) => console.log('Loaded:', pc)}\n *         />\n *       )}\n *     </>\n *   );\n * }\n * ```\n *\n * @param props - Component props including map instance and control options\n * @returns null - This component renders nothing directly\n */\nexport function LidarControlReact({\n  map,\n  onStateChange,\n  onLoad,\n  onError,\n  ...options\n}: LidarControlReactProps): null {\n  const controlRef = useRef<LidarControl | null>(null);\n\n  useEffect(() => {\n    if (!map) return;\n\n    // Create the control instance\n    const control = new LidarControl(options);\n    controlRef.current = control;\n\n    // Register event handlers\n    if (onStateChange) {\n      control.on('statechange', (event) => {\n        onStateChange(event.state);\n      });\n    }\n\n    if (onLoad) {\n      control.on('load', (event) => {\n        if (event.pointCloud) {\n          onLoad(event.pointCloud);\n        }\n      });\n    }\n\n    if (onError) {\n      control.on('loaderror', (event) => {\n        if (event.error) {\n          onError(event.error);\n        }\n      });\n    }\n\n    // Add control to map\n    map.addControl(control, options.position || 'top-right');\n\n    // Cleanup on unmount\n    return () => {\n      if (map.hasControl(control)) {\n        map.removeControl(control);\n      }\n      controlRef.current = null;\n    };\n  }, [map]);\n\n  // Update options when they change\n  useEffect(() => {\n    if (controlRef.current) {\n      // Handle collapsed state changes\n      const currentState = controlRef.current.getState();\n      if (options.collapsed !== undefined && options.collapsed !== currentState.collapsed) {\n        if (options.collapsed) {\n          controlRef.current.collapse();\n        } else {\n          controlRef.current.expand();\n        }\n      }\n\n      // Handle style changes\n      if (options.pointSize !== undefined && options.pointSize !== currentState.pointSize) {\n        controlRef.current.setPointSize(options.pointSize);\n      }\n\n      if (options.opacity !== undefined && options.opacity !== currentState.opacity) {\n        controlRef.current.setOpacity(options.opacity);\n      }\n\n      if (options.colorScheme !== undefined && options.colorScheme !== currentState.colorScheme) {\n        controlRef.current.setColorScheme(options.colorScheme);\n      }\n    }\n  }, [options.collapsed, options.pointSize, options.opacity, options.colorScheme]);\n\n  return null;\n}\n","import { useState, useCallback } from 'react';\nimport type { LidarState, ColorScheme } from '../core/types';\n\n/**\n * Default initial state for the LiDAR control\n */\nconst DEFAULT_STATE: LidarState = {\n  collapsed: true,\n  panelWidth: 365,\n  panelMaxHeight: 600,\n  pointClouds: [],\n  activePointCloudId: null,\n  pointSize: 2,\n  opacity: 1.0,\n  colorScheme: 'elevation',\n  usePercentile: true,\n  elevationRange: null,\n  pointBudget: 1000000,\n  pickable: false,\n  loading: false,\n  error: null,\n  zOffsetEnabled: false,\n  zOffset: 0,\n};\n\n/**\n * Custom hook for managing LiDAR state in React applications.\n *\n * This hook provides a simple way to track and update the state\n * of a LidarControl from React components.\n *\n * @example\n * ```tsx\n * function MyComponent() {\n *   const { state, setPointSize, setColorScheme, toggle } = useLidarState();\n *\n *   return (\n *     <div>\n *       <button onClick={toggle}>\n *         {state.collapsed ? 'Expand' : 'Collapse'}\n *       </button>\n *       <button onClick={() => setColorScheme('intensity')}>\n *         Show Intensity\n *       </button>\n *       <LidarControlReact\n *         map={map}\n *         collapsed={state.collapsed}\n *         pointSize={state.pointSize}\n *         colorScheme={state.colorScheme}\n *         onStateChange={(newState) => setState(newState)}\n *       />\n *     </div>\n *   );\n * }\n * ```\n *\n * @param initialState - Optional initial state values\n * @returns Object containing state and update functions\n */\nexport function useLidarState(initialState?: Partial<LidarState>) {\n  const [state, setState] = useState<LidarState>({\n    ...DEFAULT_STATE,\n    ...initialState,\n  });\n\n  /**\n   * Sets the collapsed state\n   */\n  const setCollapsed = useCallback((collapsed: boolean) => {\n    setState((prev) => ({ ...prev, collapsed }));\n  }, []);\n\n  /**\n   * Sets the panel width\n   */\n  const setPanelWidth = useCallback((panelWidth: number) => {\n    setState((prev) => ({ ...prev, panelWidth }));\n  }, []);\n\n  /**\n   * Sets the point size\n   */\n  const setPointSize = useCallback((pointSize: number) => {\n    setState((prev) => ({ ...prev, pointSize }));\n  }, []);\n\n  /**\n   * Sets the opacity\n   */\n  const setOpacity = useCallback((opacity: number) => {\n    setState((prev) => ({ ...prev, opacity }));\n  }, []);\n\n  /**\n   * Sets the color scheme\n   */\n  const setColorScheme = useCallback((colorScheme: ColorScheme) => {\n    setState((prev) => ({ ...prev, colorScheme }));\n  }, []);\n\n  /**\n   * Sets whether to use percentile range for coloring\n   */\n  const setUsePercentile = useCallback((usePercentile: boolean) => {\n    setState((prev) => ({ ...prev, usePercentile }));\n  }, []);\n\n  /**\n   * Sets the elevation range filter\n   */\n  const setElevationRange = useCallback((elevationRange: [number, number] | null) => {\n    setState((prev) => ({ ...prev, elevationRange }));\n  }, []);\n\n  /**\n   * Sets the point budget\n   */\n  const setPointBudget = useCallback((pointBudget: number) => {\n    setState((prev) => ({ ...prev, pointBudget }));\n  }, []);\n\n  /**\n   * Sets whether Z offset is enabled\n   */\n  const setZOffsetEnabled = useCallback((zOffsetEnabled: boolean) => {\n    setState((prev) => ({ ...prev, zOffsetEnabled }));\n  }, []);\n\n  /**\n   * Sets the Z offset value\n   */\n  const setZOffset = useCallback((zOffset: number) => {\n    setState((prev) => ({ ...prev, zOffset }));\n  }, []);\n\n  /**\n   * Resets the state to default values\n   */\n  const reset = useCallback(() => {\n    setState({ ...DEFAULT_STATE, ...initialState });\n  }, [initialState]);\n\n  /**\n   * Toggles the collapsed state\n   */\n  const toggle = useCallback(() => {\n    setState((prev) => ({ ...prev, collapsed: !prev.collapsed }));\n  }, []);\n\n  return {\n    state,\n    setState,\n    setCollapsed,\n    setPanelWidth,\n    setPointSize,\n    setOpacity,\n    setColorScheme,\n    setUsePercentile,\n    setElevationRange,\n    setPointBudget,\n    setZOffsetEnabled,\n    setZOffset,\n    reset,\n    toggle,\n  };\n}\n","import { useState, useCallback } from 'react';\nimport { PointCloudLoader } from '../loaders/PointCloudLoader';\nimport type { PointCloudData, LoaderOptions } from '../loaders/types';\n\n/**\n * Result of the usePointCloud hook\n */\ninterface UsePointCloudResult {\n  /** The loaded point cloud data or null */\n  data: PointCloudData | null;\n  /** Whether loading is in progress */\n  loading: boolean;\n  /** Error if loading failed */\n  error: Error | null;\n  /** Loading progress (0-1) */\n  progress: number;\n  /** Function to load a point cloud */\n  load: (source: string | File | ArrayBuffer) => Promise<PointCloudData | null>;\n  /** Function to reset the state */\n  reset: () => void;\n}\n\n/**\n * Custom hook for loading point cloud data in React applications.\n *\n * This hook provides a simple way to load point cloud files\n * with loading state and error handling.\n *\n * @example\n * ```tsx\n * function PointCloudLoader() {\n *   const { data, loading, error, load, reset } = usePointCloud();\n *\n *   const handleFile = async (file: File) => {\n *     const result = await load(file);\n *     if (result) {\n *       console.log(`Loaded ${result.pointCount} points`);\n *     }\n *   };\n *\n *   return (\n *     <div>\n *       <input type=\"file\" onChange={(e) => handleFile(e.target.files?.[0])} />\n *       {loading && <p>Loading...</p>}\n *       {error && <p>Error: {error.message}</p>}\n *       {data && <p>Loaded {data.pointCount} points</p>}\n *     </div>\n *   );\n * }\n * ```\n *\n * @param options - Optional loader options\n * @returns Object containing state and functions\n */\nexport function usePointCloud(options?: Partial<LoaderOptions>): UsePointCloudResult {\n  const [data, setData] = useState<PointCloudData | null>(null);\n  const [loading, setLoading] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n  const [progress, setProgress] = useState(0);\n\n  const load = useCallback(\n    async (source: string | File | ArrayBuffer): Promise<PointCloudData | null> => {\n      setLoading(true);\n      setError(null);\n      setProgress(0);\n\n      try {\n        const loader = new PointCloudLoader();\n        const result = await loader.load(source);\n        setData(result);\n        return result;\n      } catch (err) {\n        const e = err instanceof Error ? err : new Error(String(err));\n        setError(e);\n        return null;\n      } finally {\n        setLoading(false);\n      }\n    },\n    [options]\n  );\n\n  const reset = useCallback(() => {\n    setData(null);\n    setLoading(false);\n    setError(null);\n    setProgress(0);\n  }, []);\n\n  return { data, loading, error, progress, load, reset };\n}\n"],"names":["useRef","useEffect","LidarControl","useState","useCallback","PointCloudLoader"],"mappings":"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"}

package/dist/react.mjs

@@ -0,0 +1,179 @@
+import { useRef, useEffect, useState, useCallback } from "react";
+import { L as LidarControl, P as PointCloudLoader } from "./LidarControl-BFJN1DIQ.js";
+function LidarControlReact({
+  map,
+  onStateChange,
+  onLoad,
+  onError,
+  ...options
+}) {
+  const controlRef = useRef(null);
+  useEffect(() => {
+    if (!map) return;
+    const control = new LidarControl(options);
+    controlRef.current = control;
+    if (onStateChange) {
+      control.on("statechange", (event) => {
+        onStateChange(event.state);
+      });
+    }
+    if (onLoad) {
+      control.on("load", (event) => {
+        if (event.pointCloud) {
+          onLoad(event.pointCloud);
+        }
+      });
+    }
+    if (onError) {
+      control.on("loaderror", (event) => {
+        if (event.error) {
+          onError(event.error);
+        }
+      });
+    }
+    map.addControl(control, options.position || "top-right");
+    return () => {
+      if (map.hasControl(control)) {
+        map.removeControl(control);
+      }
+      controlRef.current = null;
+    };
+  }, [map]);
+  useEffect(() => {
+    if (controlRef.current) {
+      const currentState = controlRef.current.getState();
+      if (options.collapsed !== void 0 && options.collapsed !== currentState.collapsed) {
+        if (options.collapsed) {
+          controlRef.current.collapse();
+        } else {
+          controlRef.current.expand();
+        }
+      }
+      if (options.pointSize !== void 0 && options.pointSize !== currentState.pointSize) {
+        controlRef.current.setPointSize(options.pointSize);
+      }
+      if (options.opacity !== void 0 && options.opacity !== currentState.opacity) {
+        controlRef.current.setOpacity(options.opacity);
+      }
+      if (options.colorScheme !== void 0 && options.colorScheme !== currentState.colorScheme) {
+        controlRef.current.setColorScheme(options.colorScheme);
+      }
+    }
+  }, [options.collapsed, options.pointSize, options.opacity, options.colorScheme]);
+  return null;
+}
+const DEFAULT_STATE = {
+  collapsed: true,
+  panelWidth: 365,
+  panelMaxHeight: 600,
+  pointClouds: [],
+  activePointCloudId: null,
+  pointSize: 2,
+  opacity: 1,
+  colorScheme: "elevation",
+  usePercentile: true,
+  elevationRange: null,
+  pointBudget: 1e6,
+  pickable: false,
+  loading: false,
+  error: null,
+  zOffsetEnabled: false,
+  zOffset: 0
+};
+function useLidarState(initialState) {
+  const [state, setState] = useState({
+    ...DEFAULT_STATE,
+    ...initialState
+  });
+  const setCollapsed = useCallback((collapsed) => {
+    setState((prev) => ({ ...prev, collapsed }));
+  }, []);
+  const setPanelWidth = useCallback((panelWidth) => {
+    setState((prev) => ({ ...prev, panelWidth }));
+  }, []);
+  const setPointSize = useCallback((pointSize) => {
+    setState((prev) => ({ ...prev, pointSize }));
+  }, []);
+  const setOpacity = useCallback((opacity) => {
+    setState((prev) => ({ ...prev, opacity }));
+  }, []);
+  const setColorScheme = useCallback((colorScheme) => {
+    setState((prev) => ({ ...prev, colorScheme }));
+  }, []);
+  const setUsePercentile = useCallback((usePercentile) => {
+    setState((prev) => ({ ...prev, usePercentile }));
+  }, []);
+  const setElevationRange = useCallback((elevationRange) => {
+    setState((prev) => ({ ...prev, elevationRange }));
+  }, []);
+  const setPointBudget = useCallback((pointBudget) => {
+    setState((prev) => ({ ...prev, pointBudget }));
+  }, []);
+  const setZOffsetEnabled = useCallback((zOffsetEnabled) => {
+    setState((prev) => ({ ...prev, zOffsetEnabled }));
+  }, []);
+  const setZOffset = useCallback((zOffset) => {
+    setState((prev) => ({ ...prev, zOffset }));
+  }, []);
+  const reset = useCallback(() => {
+    setState({ ...DEFAULT_STATE, ...initialState });
+  }, [initialState]);
+  const toggle = useCallback(() => {
+    setState((prev) => ({ ...prev, collapsed: !prev.collapsed }));
+  }, []);
+  return {
+    state,
+    setState,
+    setCollapsed,
+    setPanelWidth,
+    setPointSize,
+    setOpacity,
+    setColorScheme,
+    setUsePercentile,
+    setElevationRange,
+    setPointBudget,
+    setZOffsetEnabled,
+    setZOffset,
+    reset,
+    toggle
+  };
+}
+function usePointCloud(options) {
+  const [data, setData] = useState(null);
+  const [loading, setLoading] = useState(false);
+  const [error, setError] = useState(null);
+  const [progress, setProgress] = useState(0);
+  const load = useCallback(
+    async (source) => {
+      setLoading(true);
+      setError(null);
+      setProgress(0);
+      try {
+        const loader = new PointCloudLoader();
+        const result = await loader.load(source);
+        setData(result);
+        return result;
+      } catch (err) {
+        const e = err instanceof Error ? err : new Error(String(err));
+        setError(e);
+        return null;
+      } finally {
+        setLoading(false);
+      }
+    },
+    [options]
+  );
+  const reset = useCallback(() => {
+    setData(null);
+    setLoading(false);
+    setError(null);
+    setProgress(0);
+  }, []);
+  return { data, loading, error, progress, load, reset };
+}
+export {
+  LidarControlReact,
+  useLidarState,
+  usePointCloud
+};
+//# sourceMappingURL=react.mjs.map

package/dist/react.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.mjs","sources":["../src/lib/core/LidarControlReact.tsx","../src/lib/hooks/useLidarState.ts","../src/lib/hooks/usePointCloud.ts"],"sourcesContent":["import { useEffect, useRef } from 'react';\nimport { LidarControl } from './LidarControl';\nimport type { LidarControlReactProps } from './types';\n\n/**\n * React wrapper component for LidarControl.\n *\n * This component manages the lifecycle of a LidarControl instance,\n * adding it to the map on mount and removing it on unmount.\n *\n * @example\n * ```tsx\n * import { LidarControlReact } from 'maplibre-gl-lidar/react';\n *\n * function MyMap() {\n *   const [map, setMap] = useState<Map | null>(null);\n *\n *   return (\n *     <>\n *       <div ref={mapContainer} />\n *       {map && (\n *         <LidarControlReact\n *           map={map}\n *           title=\"LiDAR Viewer\"\n *           collapsed={false}\n *           onLoad={(pc) => console.log('Loaded:', pc)}\n *         />\n *       )}\n *     </>\n *   );\n * }\n * ```\n *\n * @param props - Component props including map instance and control options\n * @returns null - This component renders nothing directly\n */\nexport function LidarControlReact({\n  map,\n  onStateChange,\n  onLoad,\n  onError,\n  ...options\n}: LidarControlReactProps): null {\n  const controlRef = useRef<LidarControl | null>(null);\n\n  useEffect(() => {\n    if (!map) return;\n\n    // Create the control instance\n    const control = new LidarControl(options);\n    controlRef.current = control;\n\n    // Register event handlers\n    if (onStateChange) {\n      control.on('statechange', (event) => {\n        onStateChange(event.state);\n      });\n    }\n\n    if (onLoad) {\n      control.on('load', (event) => {\n        if (event.pointCloud) {\n          onLoad(event.pointCloud);\n        }\n      });\n    }\n\n    if (onError) {\n      control.on('loaderror', (event) => {\n        if (event.error) {\n          onError(event.error);\n        }\n      });\n    }\n\n    // Add control to map\n    map.addControl(control, options.position || 'top-right');\n\n    // Cleanup on unmount\n    return () => {\n      if (map.hasControl(control)) {\n        map.removeControl(control);\n      }\n      controlRef.current = null;\n    };\n  }, [map]);\n\n  // Update options when they change\n  useEffect(() => {\n    if (controlRef.current) {\n      // Handle collapsed state changes\n      const currentState = controlRef.current.getState();\n      if (options.collapsed !== undefined && options.collapsed !== currentState.collapsed) {\n        if (options.collapsed) {\n          controlRef.current.collapse();\n        } else {\n          controlRef.current.expand();\n        }\n      }\n\n      // Handle style changes\n      if (options.pointSize !== undefined && options.pointSize !== currentState.pointSize) {\n        controlRef.current.setPointSize(options.pointSize);\n      }\n\n      if (options.opacity !== undefined && options.opacity !== currentState.opacity) {\n        controlRef.current.setOpacity(options.opacity);\n      }\n\n      if (options.colorScheme !== undefined && options.colorScheme !== currentState.colorScheme) {\n        controlRef.current.setColorScheme(options.colorScheme);\n      }\n    }\n  }, [options.collapsed, options.pointSize, options.opacity, options.colorScheme]);\n\n  return null;\n}\n","import { useState, useCallback } from 'react';\nimport type { LidarState, ColorScheme } from '../core/types';\n\n/**\n * Default initial state for the LiDAR control\n */\nconst DEFAULT_STATE: LidarState = {\n  collapsed: true,\n  panelWidth: 365,\n  panelMaxHeight: 600,\n  pointClouds: [],\n  activePointCloudId: null,\n  pointSize: 2,\n  opacity: 1.0,\n  colorScheme: 'elevation',\n  usePercentile: true,\n  elevationRange: null,\n  pointBudget: 1000000,\n  pickable: false,\n  loading: false,\n  error: null,\n  zOffsetEnabled: false,\n  zOffset: 0,\n};\n\n/**\n * Custom hook for managing LiDAR state in React applications.\n *\n * This hook provides a simple way to track and update the state\n * of a LidarControl from React components.\n *\n * @example\n * ```tsx\n * function MyComponent() {\n *   const { state, setPointSize, setColorScheme, toggle } = useLidarState();\n *\n *   return (\n *     <div>\n *       <button onClick={toggle}>\n *         {state.collapsed ? 'Expand' : 'Collapse'}\n *       </button>\n *       <button onClick={() => setColorScheme('intensity')}>\n *         Show Intensity\n *       </button>\n *       <LidarControlReact\n *         map={map}\n *         collapsed={state.collapsed}\n *         pointSize={state.pointSize}\n *         colorScheme={state.colorScheme}\n *         onStateChange={(newState) => setState(newState)}\n *       />\n *     </div>\n *   );\n * }\n * ```\n *\n * @param initialState - Optional initial state values\n * @returns Object containing state and update functions\n */\nexport function useLidarState(initialState?: Partial<LidarState>) {\n  const [state, setState] = useState<LidarState>({\n    ...DEFAULT_STATE,\n    ...initialState,\n  });\n\n  /**\n   * Sets the collapsed state\n   */\n  const setCollapsed = useCallback((collapsed: boolean) => {\n    setState((prev) => ({ ...prev, collapsed }));\n  }, []);\n\n  /**\n   * Sets the panel width\n   */\n  const setPanelWidth = useCallback((panelWidth: number) => {\n    setState((prev) => ({ ...prev, panelWidth }));\n  }, []);\n\n  /**\n   * Sets the point size\n   */\n  const setPointSize = useCallback((pointSize: number) => {\n    setState((prev) => ({ ...prev, pointSize }));\n  }, []);\n\n  /**\n   * Sets the opacity\n   */\n  const setOpacity = useCallback((opacity: number) => {\n    setState((prev) => ({ ...prev, opacity }));\n  }, []);\n\n  /**\n   * Sets the color scheme\n   */\n  const setColorScheme = useCallback((colorScheme: ColorScheme) => {\n    setState((prev) => ({ ...prev, colorScheme }));\n  }, []);\n\n  /**\n   * Sets whether to use percentile range for coloring\n   */\n  const setUsePercentile = useCallback((usePercentile: boolean) => {\n    setState((prev) => ({ ...prev, usePercentile }));\n  }, []);\n\n  /**\n   * Sets the elevation range filter\n   */\n  const setElevationRange = useCallback((elevationRange: [number, number] | null) => {\n    setState((prev) => ({ ...prev, elevationRange }));\n  }, []);\n\n  /**\n   * Sets the point budget\n   */\n  const setPointBudget = useCallback((pointBudget: number) => {\n    setState((prev) => ({ ...prev, pointBudget }));\n  }, []);\n\n  /**\n   * Sets whether Z offset is enabled\n   */\n  const setZOffsetEnabled = useCallback((zOffsetEnabled: boolean) => {\n    setState((prev) => ({ ...prev, zOffsetEnabled }));\n  }, []);\n\n  /**\n   * Sets the Z offset value\n   */\n  const setZOffset = useCallback((zOffset: number) => {\n    setState((prev) => ({ ...prev, zOffset }));\n  }, []);\n\n  /**\n   * Resets the state to default values\n   */\n  const reset = useCallback(() => {\n    setState({ ...DEFAULT_STATE, ...initialState });\n  }, [initialState]);\n\n  /**\n   * Toggles the collapsed state\n   */\n  const toggle = useCallback(() => {\n    setState((prev) => ({ ...prev, collapsed: !prev.collapsed }));\n  }, []);\n\n  return {\n    state,\n    setState,\n    setCollapsed,\n    setPanelWidth,\n    setPointSize,\n    setOpacity,\n    setColorScheme,\n    setUsePercentile,\n    setElevationRange,\n    setPointBudget,\n    setZOffsetEnabled,\n    setZOffset,\n    reset,\n    toggle,\n  };\n}\n","import { useState, useCallback } from 'react';\nimport { PointCloudLoader } from '../loaders/PointCloudLoader';\nimport type { PointCloudData, LoaderOptions } from '../loaders/types';\n\n/**\n * Result of the usePointCloud hook\n */\ninterface UsePointCloudResult {\n  /** The loaded point cloud data or null */\n  data: PointCloudData | null;\n  /** Whether loading is in progress */\n  loading: boolean;\n  /** Error if loading failed */\n  error: Error | null;\n  /** Loading progress (0-1) */\n  progress: number;\n  /** Function to load a point cloud */\n  load: (source: string | File | ArrayBuffer) => Promise<PointCloudData | null>;\n  /** Function to reset the state */\n  reset: () => void;\n}\n\n/**\n * Custom hook for loading point cloud data in React applications.\n *\n * This hook provides a simple way to load point cloud files\n * with loading state and error handling.\n *\n * @example\n * ```tsx\n * function PointCloudLoader() {\n *   const { data, loading, error, load, reset } = usePointCloud();\n *\n *   const handleFile = async (file: File) => {\n *     const result = await load(file);\n *     if (result) {\n *       console.log(`Loaded ${result.pointCount} points`);\n *     }\n *   };\n *\n *   return (\n *     <div>\n *       <input type=\"file\" onChange={(e) => handleFile(e.target.files?.[0])} />\n *       {loading && <p>Loading...</p>}\n *       {error && <p>Error: {error.message}</p>}\n *       {data && <p>Loaded {data.pointCount} points</p>}\n *     </div>\n *   );\n * }\n * ```\n *\n * @param options - Optional loader options\n * @returns Object containing state and functions\n */\nexport function usePointCloud(options?: Partial<LoaderOptions>): UsePointCloudResult {\n  const [data, setData] = useState<PointCloudData | null>(null);\n  const [loading, setLoading] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n  const [progress, setProgress] = useState(0);\n\n  const load = useCallback(\n    async (source: string | File | ArrayBuffer): Promise<PointCloudData | null> => {\n      setLoading(true);\n      setError(null);\n      setProgress(0);\n\n      try {\n        const loader = new PointCloudLoader();\n        const result = await loader.load(source);\n        setData(result);\n        return result;\n      } catch (err) {\n        const e = err instanceof Error ? err : new Error(String(err));\n        setError(e);\n        return null;\n      } finally {\n        setLoading(false);\n      }\n    },\n    [options]\n  );\n\n  const reset = useCallback(() => {\n    setData(null);\n    setLoading(false);\n    setError(null);\n    setProgress(0);\n  }, []);\n\n  return { data, loading, error, progress, load, reset };\n}\n"],"names":[],"mappings":"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"}

package/dist/types/index.d.ts

@@ -0,0 +1,13 @@
+export { LidarControl } from './lib/core/LidarControl';
+export { DeckOverlay } from './lib/core/DeckOverlay';
+export { ViewportManager } from './lib/core/ViewportManager';
+export { PointCloudLoader } from './lib/loaders/PointCloudLoader';
+export { CopcStreamingLoader } from './lib/loaders/CopcStreamingLoader';
+export { PointCloudManager } from './lib/layers/PointCloudManager';
+export { ColorSchemeProcessor, getClassificationName } from './lib/colorizers/ColorScheme';
+export type { LidarControlOptions, LidarState, LidarControlEvent, LidarControlEventHandler, LidarEventData, PointCloudInfo, PointCloudBounds, ColorScheme, ColorSchemeType, ColorSchemeConfig, CopcLoadingMode, } from './lib/core/types';
+export type { PointCloudData, LoaderOptions, } from './lib/loaders/types';
+export type { StreamingLoaderOptions, StreamingProgressEvent, ViewportInfo, CachedNode, NodeKey, NodeState, StreamingLoaderEvent, StreamingLoaderEventHandler, StreamingLoadOptions, } from './lib/loaders/streaming-types';
+export type { PointCloudLayerOptions, } from './lib/layers/types';
+export { clamp, formatNumericValue, generateId, debounce, throttle, classNames, formatNumber, formatBytes, getFilename, } from './lib/utils';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,gCAAgC,CAAC;AAGxC,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAG3F,YAAY,EACV,mBAAmB,EACnB,UAAU,EACV,iBAAiB,EACjB,wBAAwB,EACxB,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EACV,cAAc,EACd,aAAa,GACd,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EACV,sBAAsB,EACtB,sBAAsB,EACtB,YAAY,EACZ,UAAU,EACV,OAAO,EACP,SAAS,EACT,oBAAoB,EACpB,2BAA2B,EAC3B,oBAAoB,GACrB,MAAM,+BAA+B,CAAC;AAEvC,YAAY,EACV,sBAAsB,GACvB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,KAAK,EACL,kBAAkB,EAClB,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,WAAW,EACX,WAAW,GACZ,MAAM,aAAa,CAAC"}

package/dist/types/lib/colorizers/ColorScheme.d.ts

@@ -0,0 +1,60 @@
+import { PointCloudData } from '../loaders/types';
+import { ColorScheme } from '../core/types';
+/**
+ * Options for color generation
+ */
+export interface ColorOptions {
+    /** Whether to use percentile range (2-98%) for elevation/intensity coloring */
+    usePercentile?: boolean;
+}
+/**
+ * Processes point cloud data into color arrays based on color scheme.
+ */
+export declare class ColorSchemeProcessor {
+    /**
+     * Generates a color array for the point cloud based on the color scheme.
+     *
+     * @param data - Point cloud data
+     * @param scheme - Color scheme to apply
+     * @param options - Optional color generation options
+     * @returns Uint8Array of RGBA colors (length = pointCount * 4)
+     */
+    getColors(data: PointCloudData, scheme: ColorScheme, options?: ColorOptions): Uint8Array;
+    /**
+     * Colors points by elevation using terrain-like ramp.
+     *
+     * @param data - Point cloud data
+     * @param colors - Output color array
+     * @param usePercentile - Whether to use percentile bounds (2-98%) for better color distribution
+     */
+    private _colorByElevation;
+    /**
+     * Colors points by intensity using grayscale ramp.
+     *
+     * @param data - Point cloud data
+     * @param colors - Output color array
+     * @param usePercentile - Whether to use percentile bounds (2-98%) for better color distribution
+     */
+    private _colorByIntensity;
+    /**
+     * Colors points by classification using ASPRS standard colors.
+     */
+    private _colorByClassification;
+    /**
+     * Uses embedded RGB colors from the point cloud.
+     */
+    private _colorByRGB;
+    /**
+     * Applies a custom color scheme configuration.
+     */
+    private _colorByCustom;
+    /**
+     * Interpolates a color from a color ramp.
+     */
+    private _interpolateRamp;
+}
+/**
+ * Gets the name of a classification code.
+ */
+export declare function getClassificationName(code: number): string;
+//# sourceMappingURL=ColorScheme.d.ts.map

package/dist/types/lib/colorizers/ColorScheme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ColorScheme.d.ts","sourceRoot":"","sources":["../../../../src/lib/colorizers/ColorScheme.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAqB,MAAM,eAAe,CAAC;AAwDpE;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,+EAA+E;IAC/E,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,qBAAa,oBAAoB;IAC/B;;;;;;;OAOG;IACH,SAAS,CAAC,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,GAAE,YAAiB,GAAG,UAAU;IAsB5F;;;;;;OAMG;IACH,OAAO,CAAC,iBAAiB;IAsCzB;;;;;;OAMG;IACH,OAAO,CAAC,iBAAiB;IAuCzB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAiB9B;;OAEG;IACH,OAAO,CAAC,WAAW;IAgBnB;;OAEG;IACH,OAAO,CAAC,cAAc;IAUtB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAmBzB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAuB1D"}

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

@@ -0,0 +1,3 @@
+export { ColorSchemeProcessor, getClassificationName } from './ColorScheme';
+export type { RGBColor, RGBAColor, ColorRamp, ClassificationColorMap } from './types';
+//# sourceMappingURL=index.d.ts.map

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

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

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

@@ -0,0 +1,17 @@
+/**
+ * RGB color tuple
+ */
+export type RGBColor = [number, number, number];
+/**
+ * RGBA color tuple
+ */
+export type RGBAColor = [number, number, number, number];
+/**
+ * Color ramp definition (array of RGB colors)
+ */
+export type ColorRamp = RGBColor[];
+/**
+ * Classification color map
+ */
+export type ClassificationColorMap = Record<number, RGBColor>;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/lib/colorizers/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAEhD;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAEzD;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,QAAQ,EAAE,CAAC;AAEnC;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC"}

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

@@ -0,0 +1,64 @@
+import { Map as MapLibreMap } from 'maplibre-gl';
+import { Layer } from '@deck.gl/core';
+/**
+ * Manages the deck.gl overlay integration with MapLibre GL.
+ * Handles adding, removing, and updating deck.gl layers.
+ */
+export declare class DeckOverlay {
+    private _map;
+    private _overlay;
+    private _layers;
+    constructor(map: MapLibreMap);
+    /**
+     * Adds a layer to the overlay.
+     *
+     * @param id - Unique layer ID
+     * @param layer - The deck.gl layer to add
+     */
+    addLayer(id: string, layer: Layer): void;
+    /**
+     * Removes a layer from the overlay.
+     *
+     * @param id - ID of the layer to remove
+     */
+    removeLayer(id: string): void;
+    /**
+     * Updates an existing layer with new props.
+     *
+     * @param id - ID of the layer to update
+     * @param layer - New layer instance with updated props
+     */
+    updateLayer(id: string, layer: Layer): void;
+    /**
+     * Gets all current layers.
+     *
+     * @returns Array of deck.gl layers
+     */
+    getLayers(): Layer[];
+    /**
+     * Checks if a layer exists.
+     *
+     * @param id - Layer ID to check
+     * @returns True if layer exists
+     */
+    hasLayer(id: string): boolean;
+    /**
+     * Clears all layers from the overlay.
+     */
+    clearLayers(): void;
+    /**
+     * Gets the MapLibre map instance.
+     *
+     * @returns The MapLibre map
+     */
+    getMap(): MapLibreMap;
+    /**
+     * Destroys the overlay and removes it from the map.
+     */
+    destroy(): void;
+    /**
+     * Updates the overlay with current layers.
+     */
+    private _updateOverlay;
+}
+//# sourceMappingURL=DeckOverlay.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DeckOverlay.d.ts","sourceRoot":"","sources":["../../../../src/lib/core/DeckOverlay.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,GAAG,IAAI,WAAW,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAE3C;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,IAAI,CAAc;IAC1B,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,OAAO,CAAqB;gBAExB,GAAG,EAAE,WAAW;IAW5B;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI;IAKxC;;;;OAIG;IACH,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAK7B;;;;;OAKG;IACH,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI;IAO3C;;;;OAIG;IACH,SAAS,IAAI,KAAK,EAAE;IAIpB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI7B;;OAEG;IACH,WAAW,IAAI,IAAI;IAKnB;;;;OAIG;IACH,MAAM,IAAI,WAAW;IAIrB;;OAEG;IACH,OAAO,IAAI,IAAI;IASf;;OAEG;IACH,OAAO,CAAC,cAAc;CAOvB"}