@gisatcz/deckgl-geolib 2.6.0-dev.2 → 2.6.0-dev.3

package/dist/esm/react/index.js

@@ -0,0 +1,37 @@
+import { useState } from 'react';
+
+/**
+ * React hook for syncing terrain elevation bounds to overlay TileLayer for 3D frustum culling.
+ *
+ * Manages the zRange state needed to prevent foreground tile clipping when viewport is tilted in 3D.
+ *
+ * @returns Object with zRange state and onZRangeUpdate callback
+ *
+ * @example
+ * ```typescript
+ * const { zRange, onZRangeUpdate } = useTerrainZRange();
+ *
+ * const layers = useMemo(() => [
+ *   new TileLayer({
+ *     id: 'osm',
+ *     zRange: zRange,  // Pass elevation bounds to overlay
+ *     // ... other props
+ *   }),
+ *   new CogTerrainLayer({
+ *     id: 'terrain',
+ *     onZRangeUpdate: onZRangeUpdate,  // Sync elevation bounds from terrain
+ *     // ... other props
+ *   }),
+ * ], [zRange]);
+ * ```
+ */
+function useTerrainZRange() {
+    const [zRange, setZRange] = useState(null);
+    return {
+        zRange,
+        onZRangeUpdate: setZRange,
+    };
+}
+
+export { useTerrainZRange };
+//# sourceMappingURL=index.js.map

package/dist/esm/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../../src/hooks/useTerrainZRange.ts"],"sourcesContent":["import { useState } from 'react';\nimport type { ZRange } from '../layers/CogTerrainLayer';\n\n/**\n * React hook for syncing terrain elevation bounds to overlay TileLayer for 3D frustum culling.\n *\n * Manages the zRange state needed to prevent foreground tile clipping when viewport is tilted in 3D.\n *\n * @returns Object with zRange state and onZRangeUpdate callback\n *\n * @example\n * ```typescript\n * const { zRange, onZRangeUpdate } = useTerrainZRange();\n *\n * const layers = useMemo(() => [\n *   new TileLayer({\n *     id: 'osm',\n *     zRange: zRange,  // Pass elevation bounds to overlay\n *     // ... other props\n *   }),\n *   new CogTerrainLayer({\n *     id: 'terrain',\n *     onZRangeUpdate: onZRangeUpdate,  // Sync elevation bounds from terrain\n *     // ... other props\n *   }),\n * ], [zRange]);\n * ```\n */\nexport function useTerrainZRange() {\n  const [zRange, setZRange] = useState<ZRange | null>(null);\n\n  return {\n    zRange,\n    onZRangeUpdate: setZRange,\n  };\n}\n"],"names":[],"mappings":";;AAGA;;;;;;;;;;;;;;;;;;;;;;;;AAwBG;SACa,gBAAgB,GAAA;IAC9B,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC;IAEzD,OAAO;QACL,MAAM;AACN,QAAA,cAAc,EAAE,SAAS;KAC1B;AACH;;;;"}

package/dist/esm/react/index.min.js

@@ -0,0 +1,2 @@
+import{useState as n}from"react";function t(){const[t,e]=n(null);return{zRange:t,onZRangeUpdate:e}}export{t as useTerrainZRange};
+//# sourceMappingURL=index.min.js.map

package/dist/esm/react/index.min.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.min.js","sources":["../../../src/hooks/useTerrainZRange.ts"],"sourcesContent":["import { useState } from 'react';\nimport type { ZRange } from '../layers/CogTerrainLayer';\n\n/**\n * React hook for syncing terrain elevation bounds to overlay TileLayer for 3D frustum culling.\n *\n * Manages the zRange state needed to prevent foreground tile clipping when viewport is tilted in 3D.\n *\n * @returns Object with zRange state and onZRangeUpdate callback\n *\n * @example\n * ```typescript\n * const { zRange, onZRangeUpdate } = useTerrainZRange();\n *\n * const layers = useMemo(() => [\n *   new TileLayer({\n *     id: 'osm',\n *     zRange: zRange,  // Pass elevation bounds to overlay\n *     // ... other props\n *   }),\n *   new CogTerrainLayer({\n *     id: 'terrain',\n *     onZRangeUpdate: onZRangeUpdate,  // Sync elevation bounds from terrain\n *     // ... other props\n *   }),\n * ], [zRange]);\n * ```\n */\nexport function useTerrainZRange() {\n  const [zRange, setZRange] = useState<ZRange | null>(null);\n\n  return {\n    zRange,\n    onZRangeUpdate: setZRange,\n  };\n}\n"],"names":["useTerrainZRange","zRange","setZRange","useState","onZRangeUpdate"],"mappings":"0CA4BgBA,IACd,MAAOC,EAAQC,GAAaC,EAAwB,MAEpD,MAAO,CACLF,SACAG,eAAgBF,EAEpB"}

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

@@ -0,0 +1 @@
+export { useTerrainZRange } from './useTerrainZRange';

package/dist/esm/types/hooks/useTerrainZRange.d.ts

@@ -0,0 +1,30 @@
+import type { ZRange } from '../layers/CogTerrainLayer';
+/**
+ * React hook for syncing terrain elevation bounds to overlay TileLayer for 3D frustum culling.
+ *
+ * Manages the zRange state needed to prevent foreground tile clipping when viewport is tilted in 3D.
+ *
+ * @returns Object with zRange state and onZRangeUpdate callback
+ *
+ * @example
+ * ```typescript
+ * const { zRange, onZRangeUpdate } = useTerrainZRange();
+ *
+ * const layers = useMemo(() => [
+ *   new TileLayer({
+ *     id: 'osm',
+ *     zRange: zRange,  // Pass elevation bounds to overlay
+ *     // ... other props
+ *   }),
+ *   new CogTerrainLayer({
+ *     id: 'terrain',
+ *     onZRangeUpdate: onZRangeUpdate,  // Sync elevation bounds from terrain
+ *     // ... other props
+ *   }),
+ * ], [zRange]);
+ * ```
+ */
+export declare function useTerrainZRange(): {
+    zRange: ZRange | null;
+    onZRangeUpdate: import("react").Dispatch<import("react").SetStateAction<ZRange | null>>;
+};

package/dist/esm/types/layers/CogTerrainLayer.d.ts

@@ -61,6 +61,11 @@ type _CogTerrainLayerProps = {
      * Useful for showing a neutral grey terrain during mode transitions.
      */
     disableTexture?: boolean;
+    /**
+     * Callback fired when the terrain zRange is updated.
+     * Used to sync overlay TileLayer zRange for proper 3D frustum culling.
+     */
+    onZRangeUpdate?: (zRange: ZRange | null) => void;
     /**
      * @deprecated Use `loadOptions.terrain.workerUrl` instead
      */

package/dist/esm/types/react/index.d.ts

@@ -0,0 +1 @@
+export { useTerrainZRange } from '../hooks/index';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gisatcz/deckgl-geolib",
-  "version": "2.6.0-dev.2",
+  "version": "2.6.0-dev.3",
   "description": "Deck.gl extension for rendering Cloud-Optimized GeoTIFF (COG) data",
   "keywords": [
     "deck.gl",
@@ -30,6 +30,11 @@
       "types": "./dist/esm/types/index.d.ts",
       "import": "./dist/esm/index.js",
       "require": "./dist/cjs/index.js"
+    },
+    "./react": {
+      "types": "./dist/esm/types/react/index.d.ts",
+      "import": "./dist/esm/react/index.js",
+      "require": "./dist/cjs/react/index.js"
     }
   },
   "sideEffects": false,
@@ -64,7 +69,13 @@
     "@loaders.gl/schema": ">=4.0.0",
     "@luma.gl/core": ">=9.0.0",
     "@luma.gl/engine": ">=9.0.0",
-    "@luma.gl/shadertools": ">=9.0.0"
+    "@luma.gl/shadertools": ">=9.0.0",
+    "react": ">=16.8.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
   },
   "devDependencies": {
     "@deck.gl/core": "^9.3.2",