@accelint/map-toolkit 0.3.1 → 0.4.0

package/dist/deckgl/base-map/constants.js

@@ -1,18 +1,32 @@
+/*
+ * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+
+//#region src/deckgl/base-map/constants.ts
 const BASE_MAP_STYLE = "https://tiles.basemaps.cartocdn.com/gl/dark-matter-gl-style/style.json";
 const PARAMETERS = {
-  depthWriteEnabled: true,
-  depthCompare: "always",
-  depthBias: 0,
-  blend: true,
-  depthTest: false,
-  blendColorSrcFactor: "src-alpha",
-  blendColorDstFactor: "one-minus-src-alpha",
-  blendAlphaSrcFactor: "one",
-  blendAlphaDstFactor: "one-minus-src-alpha",
-  blendColorOperation: "add",
-  blendAlphaOperation: "add"
+	depthWriteEnabled: true,
+	depthCompare: "always",
+	depthBias: 0,
+	blend: true,
+	depthTest: false,
+	blendColorSrcFactor: "src-alpha",
+	blendColorDstFactor: "one-minus-src-alpha",
+	blendAlphaSrcFactor: "one",
+	blendAlphaDstFactor: "one-minus-src-alpha",
+	blendColorOperation: "add",
+	blendAlphaOperation: "add"
 };
 
+//#endregion
 export { BASE_MAP_STYLE, PARAMETERS };
-//# sourceMappingURL=constants.js.map
 //# sourceMappingURL=constants.js.map

package/dist/deckgl/base-map/constants.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/deckgl/base-map/constants.ts"],"names":[],"mappings":"AAaO,MAAM,cAAA,GACX;AAEK,MAAM,UAAA,GAAa;AAAA,EACxB,iBAAA,EAAmB,IAAA;AAAA,EACnB,YAAA,EAAc,QAAA;AAAA,EACd,SAAA,EAAW,CAAA;AAAA,EACX,KAAA,EAAO,IAAA;AAAA,EACP,SAAA,EAAW,KAAA;AAAA,EACX,mBAAA,EAAqB,WAAA;AAAA,EACrB,mBAAA,EAAqB,qBAAA;AAAA,EACrB,mBAAA,EAAqB,KAAA;AAAA,EACrB,mBAAA,EAAqB,qBAAA;AAAA,EACrB,mBAAA,EAAqB,KAAA;AAAA,EACrB,mBAAA,EAAqB;AACvB","file":"constants.js","sourcesContent":["// __private-exports\n/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nexport const BASE_MAP_STYLE =\n  'https://tiles.basemaps.cartocdn.com/gl/dark-matter-gl-style/style.json';\n\nexport const PARAMETERS = {\n  depthWriteEnabled: true,\n  depthCompare: 'always',\n  depthBias: 0,\n  blend: true,\n  depthTest: false,\n  blendColorSrcFactor: 'src-alpha',\n  blendColorDstFactor: 'one-minus-src-alpha',\n  blendAlphaSrcFactor: 'one',\n  blendAlphaDstFactor: 'one-minus-src-alpha',\n  blendColorOperation: 'add',\n  blendAlphaOperation: 'add',\n};\n"]}
+{"version":3,"file":"constants.js","names":[],"sources":["../../../src/deckgl/base-map/constants.ts"],"sourcesContent":["// __private-exports\n/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nexport const BASE_MAP_STYLE =\n  'https://tiles.basemaps.cartocdn.com/gl/dark-matter-gl-style/style.json';\n\nexport const PARAMETERS = {\n  depthWriteEnabled: true,\n  depthCompare: 'always',\n  depthBias: 0,\n  blend: true,\n  depthTest: false,\n  blendColorSrcFactor: 'src-alpha',\n  blendColorDstFactor: 'one-minus-src-alpha',\n  blendAlphaSrcFactor: 'one',\n  blendAlphaDstFactor: 'one-minus-src-alpha',\n  blendColorOperation: 'add',\n  blendAlphaOperation: 'add',\n};\n"],"mappings":";;;;;;;;;;;;;;AAaA,MAAa,iBACX;AAEF,MAAa,aAAa;CACxB,mBAAmB;CACnB,cAAc;CACd,WAAW;CACX,OAAO;CACP,WAAW;CACX,qBAAqB;CACrB,qBAAqB;CACrB,qBAAqB;CACrB,qBAAqB;CACrB,qBAAqB;CACrB,qBAAqB;CACtB"}

package/dist/deckgl/base-map/events.d.ts

@@ -1,8 +1,10 @@
+//#region src/deckgl/base-map/events.d.ts
 declare const MapEventsNamespace = "map";
 declare const MapEvents: {
-    readonly click: "map:click";
-    readonly hover: "map:hover";
-    readonly viewport: "map:viewport";
+  readonly click: "map:click";
+  readonly hover: "map:hover";
+  readonly viewport: "map:viewport";
 };
-
+//#endregion
 export { MapEvents, MapEventsNamespace };
+//# sourceMappingURL=events.d.ts.map

package/dist/deckgl/base-map/events.js

@@ -1,10 +1,24 @@
+/*
+ * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
+
+
+//#region src/deckgl/base-map/events.ts
 const MapEventsNamespace = "map";
 const MapEvents = {
-  click: `${MapEventsNamespace}:click`,
-  hover: `${MapEventsNamespace}:hover`,
-  viewport: `${MapEventsNamespace}:viewport`
+	click: `${MapEventsNamespace}:click`,
+	hover: `${MapEventsNamespace}:hover`,
+	viewport: `${MapEventsNamespace}:viewport`
 };
 
+//#endregion
 export { MapEvents, MapEventsNamespace };
-//# sourceMappingURL=events.js.map
 //# sourceMappingURL=events.js.map

package/dist/deckgl/base-map/events.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/deckgl/base-map/events.ts"],"names":[],"mappings":"AAYO,MAAM,kBAAA,GAAqB;AAE3B,MAAM,SAAA,GAAY;AAAA,EACvB,KAAA,EAAO,GAAG,kBAAkB,CAAA,MAAA,CAAA;AAAA,EAC5B,KAAA,EAAO,GAAG,kBAAkB,CAAA,MAAA,CAAA;AAAA,EAC5B,QAAA,EAAU,GAAG,kBAAkB,CAAA,SAAA;AACjC","file":"events.js","sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nexport const MapEventsNamespace = 'map';\n\nexport const MapEvents = {\n  click: `${MapEventsNamespace}:click`,\n  hover: `${MapEventsNamespace}:hover`,\n  viewport: `${MapEventsNamespace}:viewport`,\n} as const;\n"]}
+{"version":3,"file":"events.js","names":[],"sources":["../../../src/deckgl/base-map/events.ts"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\nexport const MapEventsNamespace = 'map';\n\nexport const MapEvents = {\n  click: `${MapEventsNamespace}:click`,\n  hover: `${MapEventsNamespace}:hover`,\n  viewport: `${MapEventsNamespace}:viewport`,\n} as const;\n"],"mappings":";;;;;;;;;;;;;;AAYA,MAAa,qBAAqB;AAElC,MAAa,YAAY;CACvB,OAAO,GAAG,mBAAmB;CAC7B,OAAO,GAAG,mBAAmB;CAC7B,UAAU,GAAG,mBAAmB;CACjC"}

package/dist/deckgl/base-map/index.d.ts

@@ -1,24 +1,37 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import { UniqueId } from '@accelint/core';
-import { DeckglProps } from '@deckgl-fiber-renderer/types';
+/*
+ * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
 
+import { UniqueId } from "@accelint/core";
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+import { DeckglProps } from "@deckgl-fiber-renderer/types";
+
+//#region src/deckgl/base-map/index.d.ts
 /**
  * Props for the BaseMap component.
  * Extends all Deck.gl props and adds additional map-specific properties.
  */
 type BaseMapProps = DeckglProps & {
-    /** Optional CSS class name to apply to the map container element */
-    className?: string;
-    /**
-     * Unique identifier for this map instance (required).
-     *
-     * Used to isolate map mode state between multiple map instances (e.g., main map vs minimap).
-     * This should be a UUID generated using `uuid()` from `@accelint/core`.
-     *
-     * The same id should be passed to `useMapMode()` when accessing map mode state
-     * from components rendered outside of the BaseMap's children (i.e., as siblings).
-     */
-    id: UniqueId;
+  /** Optional CSS class name to apply to the map container element */
+  className?: string;
+  /**
+   * Unique identifier for this map instance (required).
+   *
+   * Used to isolate map mode state between multiple map instances (e.g., main map vs minimap).
+   * This should be a UUID generated using `uuid()` from `@accelint/core`.
+   *
+   * The same id should be passed to `useMapMode()` when accessing map mode state
+   * from components rendered outside of the BaseMap's children (i.e., as siblings).
+   */
+  id: UniqueId;
 };
 /**
  * A React component that provides a Deck.gl-powered base map with MapLibre GL integration.
@@ -93,6 +106,20 @@ type BaseMapProps = DeckglProps & {
  * }
  * ```
  */
-declare function BaseMap({ id, className, children, controller, interleaved, parameters, useDevicePixels, widgets: widgetsProp, onClick, onHover, onViewStateChange, ...rest }: BaseMapProps): react_jsx_runtime.JSX.Element;
-
-export { BaseMap, type BaseMapProps };
+declare function BaseMap({
+  id,
+  className,
+  children,
+  controller,
+  interleaved,
+  parameters,
+  useDevicePixels,
+  widgets: widgetsProp,
+  onClick,
+  onHover,
+  onViewStateChange,
+  ...rest
+}: BaseMapProps): react_jsx_runtime0.JSX.Element;
+//#endregion
+export { BaseMap, BaseMapProps };
+//# sourceMappingURL=index.d.ts.map

package/dist/deckgl/base-map/index.js

@@ -1,153 +1,221 @@
-import { jsx } from 'react/jsx-runtime';
-import 'client-only';
-import { useEmit, useEffectEvent } from '@accelint/bus/react';
-import { useDeckgl, Deckgl } from '@deckgl-fiber-renderer/dom';
-import { useId, useMemo, useCallback } from 'react';
-import { INITIAL_VIEW_STATE } from '../../maplibre/constants.js';
-import { useMapLibre } from '../../maplibre/hooks/use-maplibre.js';
-import { BASE_MAP_STYLE, PARAMETERS } from './constants.js';
-import { MapEvents } from './events.js';
-import { MapProvider } from './provider.js';
+/*
+ * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.
+ * This file is licensed to you under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License. You may obtain a copy
+ * of the License at https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under
+ * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
+ * OF ANY KIND, either express or implied. See the License for the specific language
+ * governing permissions and limitations under the License.
+ */
 
-function BaseMap({
-  id,
-  className,
-  children,
-  controller = true,
-  interleaved = true,
-  parameters = {},
-  useDevicePixels = false,
-  widgets: widgetsProp = [],
-  onClick,
-  onHover,
-  onViewStateChange,
-  ...rest
-}) {
-  const deckglInstance = useDeckgl();
-  const container = useId();
-  const mapOptions = useMemo(
-    () => ({
-      container,
-      center: [INITIAL_VIEW_STATE.longitude, INITIAL_VIEW_STATE.latitude],
-      zoom: INITIAL_VIEW_STATE.zoom,
-      doubleClickZoom: false,
-      dragRotate: false,
-      pitchWithRotate: false,
-      rollEnabled: false,
-      attributionControl: { compact: true }
-    }),
-    [container]
-  );
-  useMapLibre(deckglInstance, BASE_MAP_STYLE, mapOptions);
-  const emitClick = useEmit(MapEvents.click);
-  const emitHover = useEmit(MapEvents.hover);
-  const emitViewport = useEmit(MapEvents.viewport);
-  const handleClick = useCallback(
-    (info, event) => {
-      onClick?.(info, event);
-      const { viewport, layer, sourceLayer, ...infoRest } = info;
-      const infoObject = {
-        layerId: layer?.id,
-        sourceLayerId: sourceLayer?.id,
-        ...infoRest
-      };
-      const {
-        stopImmediatePropagation,
-        stopPropagation,
-        preventDefault,
-        srcEvent,
-        rootElement,
-        target,
-        changedPointers,
-        pointers,
-        ...eventRest
-      } = event;
-      emitClick({
-        info: infoObject,
-        event: eventRest,
-        id
-      });
-    },
-    [emitClick, id, onClick]
-  );
-  const handleHover = useCallback(
-    (info, event) => {
-      onHover?.(info, event);
-      const { viewport, layer, sourceLayer, ...infoRest } = info;
-      const infoObject = {
-        layerId: layer?.id,
-        sourceLayerId: sourceLayer?.id,
-        ...infoRest
-      };
-      const {
-        stopImmediatePropagation,
-        stopPropagation,
-        preventDefault,
-        srcEvent,
-        rootElement,
-        target,
-        ...eventRest
-      } = event;
-      emitHover({
-        info: infoObject,
-        event: eventRest,
-        id
-      });
-    },
-    [emitHover, id, onHover]
-  );
-  const handleViewStateChange = useEffectEvent(
-    (params) => {
-      onViewStateChange?.(params);
-      const {
-        viewId,
-        viewState: { latitude, longitude, zoom }
-      } = params;
-      const viewport = deckglInstance._deck.getViewports()?.find((vp) => vp.id === viewId);
-      emitViewport({
-        id,
-        bounds: viewport?.getBounds(),
-        latitude,
-        longitude,
-        zoom,
-        width: viewport?.width ?? 0,
-        height: viewport?.height ?? 0
-      });
-    }
-  );
-  const handleLoad = useEffectEvent(() => {
-    deckglInstance._deck.getViewports().forEach((vp) => {
-      handleViewStateChange({
-        viewId: vp.id,
-        viewState: {
-          latitude: vp.latitude,
-          longitude: vp.longitude,
-          zoom: vp.zoom,
-          id: vp.id,
-          bounds: vp.getBounds(),
-          width: vp.width,
-          height: vp.height
-        }
-      });
-    });
-  });
-  return /* @__PURE__ */ jsx("div", { id: container, className, children: /* @__PURE__ */ jsx(MapProvider, { id, children: /* @__PURE__ */ jsx(
-    Deckgl,
-    {
-      ...rest,
-      controller,
-      interleaved,
-      useDevicePixels,
-      onClick: handleClick,
-      onHover: handleHover,
-      onLoad: handleLoad,
-      onViewStateChange: handleViewStateChange,
-      parameters: { ...PARAMETERS, ...parameters },
-      children
-    }
-  ) }) });
+
+'use client';
+
+import { MapEvents } from "./events.js";
+import { getCursor } from "../../map-cursor/store.js";
+import { MapProvider } from "./provider.js";
+import { INITIAL_VIEW_STATE } from "../../maplibre/constants.js";
+import { useMapLibre } from "../../maplibre/hooks/use-maplibre.js";
+import { BASE_MAP_STYLE, PARAMETERS } from "./constants.js";
+import { useCallback, useId, useMemo } from "react";
+import { jsx } from "react/jsx-runtime";
+import { useEffectEvent, useEmit } from "@accelint/bus/react";
+import { Deckgl, useDeckgl } from "@deckgl-fiber-renderer/dom";
+
+//#region src/deckgl/base-map/index.tsx
+/**
+* Serializes PickingInfo for event bus transmission.
+* Omits viewport, layer, and sourceLayer (contain functions) but preserves layer IDs.
+*/
+function serializePickingInfo(info) {
+	const { viewport, layer, sourceLayer, ...infoRest } = info;
+	return {
+		layerId: layer?.id,
+		sourceLayerId: sourceLayer?.id,
+		...infoRest
+	};
+}
+function serializeMjolnirEvent(event) {
+	const { stopImmediatePropagation, stopPropagation, preventDefault, srcEvent, rootElement, target, ...rest } = event;
+	if ("changedPointers" in rest) {
+		const { changedPointers, pointers, ...gestureRest } = rest;
+		return gestureRest;
+	}
+	return rest;
+}
+/**
+* A React component that provides a Deck.gl-powered base map with MapLibre GL integration.
+*
+* This component serves as the foundation for building interactive map applications with
+* support for click and hover events through a centralized event bus. It integrates
+* Deck.gl for 3D visualizations with MapLibre GL for the base map tiles.
+*
+* **Map Mode Integration**: BaseMap automatically creates a `MapProvider` internally,
+* which sets up the map mode state management for this instance.
+* - **Children**: Only Deck.gl layer components can be rendered as children. Custom Deck.gl
+*   layers can use `useMapMode()` without parameters to access context.
+* - **Siblings**: UI components (buttons, toolbars, etc.) must be rendered as siblings
+*   and pass `id` to `useMapMode(id)`.
+*
+* **Event Bus**: Click and hover events are emitted through the event bus with the `id`
+* included in the payload, allowing multiple map instances to coexist without interference.
+*
+* @param props - Component props including id (required), className, onClick, onHover, and all Deck.gl props
+* @returns A map component with Deck.gl and MapLibre GL integration
+*
+* @example
+* Basic usage with id (recommended: module-level constant):
+* ```tsx
+* import { BaseMap } from '@accelint/map-toolkit/deckgl';
+* import { View } from '@deckgl-fiber-renderer/dom';
+* import { uuid } from '@accelint/core';
+*
+* // Create id at module level for stability and easy sharing
+* const MAIN_MAP_ID = uuid();
+*
+* export function MapView() {
+*   return (
+*     <BaseMap className="w-full h-full" id={MAIN_MAP_ID}>
+*       <View id="main" controller />
+*     </BaseMap>
+*   );
+* }
+* ```
+*
+* @example
+* With map mode and event handlers (module-level constant for sharing):
+* ```tsx
+* import { BaseMap } from '@accelint/map-toolkit/deckgl';
+* import { useMapMode } from '@accelint/map-toolkit/map-mode';
+* import { uuid } from '@accelint/core';
+* import type { PickingInfo } from '@deck.gl/core';
+* import type { MjolnirGestureEvent } from 'mjolnir.js';
+*
+* // Module-level constant - stable and shareable across all components
+* const MAIN_MAP_ID = uuid();
+*
+* function Toolbar() {
+*   // Access map mode using the shared id
+*   const { mode, requestModeChange } = useMapMode(MAIN_MAP_ID);
+*   return <div>Current mode: {mode}</div>;
+* }
+*
+* export function InteractiveMap() {
+*   const handleClick = (info: PickingInfo, event: MjolnirGestureEvent) => {
+*     console.log('Clicked:', info.object);
+*   };
+*
+*   return (
+*     <div className="relative w-full h-full">
+*       <BaseMap className="absolute inset-0" id={MAIN_MAP_ID} onClick={handleClick}>
+*         <View id="main" controller />
+*       </BaseMap>
+*       <Toolbar />
+*     </div>
+*   );
+* }
+* ```
+*/
+function BaseMap({ id, className, children, controller = true, interleaved = true, parameters = {}, useDevicePixels = false, widgets: widgetsProp = [], onClick, onHover, onViewStateChange, ...rest }) {
+	const deckglInstance = useDeckgl();
+	const container = useId();
+	useMapLibre(deckglInstance, BASE_MAP_STYLE, useMemo(() => ({
+		container,
+		center: [INITIAL_VIEW_STATE.longitude, INITIAL_VIEW_STATE.latitude],
+		zoom: INITIAL_VIEW_STATE.zoom,
+		doubleClickZoom: false,
+		dragRotate: false,
+		pitchWithRotate: false,
+		rollEnabled: false,
+		attributionControl: { compact: true }
+	}), [container]));
+	const emitClick = useEmit(MapEvents.click);
+	const emitHover = useEmit(MapEvents.hover);
+	const emitViewport = useEmit(MapEvents.viewport);
+	const handleClick = useCallback((info, event) => {
+		onClick?.(info, event);
+		emitClick({
+			info: serializePickingInfo(info),
+			event: serializeMjolnirEvent(event),
+			id
+		});
+	}, [
+		emitClick,
+		id,
+		onClick
+	]);
+	const handleHover = useCallback((info, event) => {
+		onHover?.(info, event);
+		emitHover({
+			info: serializePickingInfo(info),
+			event: serializeMjolnirEvent(event),
+			id
+		});
+	}, [
+		emitHover,
+		id,
+		onHover
+	]);
+	const handleGetCursor = useCallback(() => {
+		return getCursor(id);
+	}, [id]);
+	const handleViewStateChange = useEffectEvent((params) => {
+		onViewStateChange?.(params);
+		const { viewId, viewState: { latitude, longitude, zoom } } = params;
+		const viewport = deckglInstance._deck.getViewports()?.find((vp) => vp.id === viewId);
+		emitViewport({
+			id,
+			bounds: viewport?.getBounds(),
+			latitude,
+			longitude,
+			zoom,
+			width: viewport?.width ?? 0,
+			height: viewport?.height ?? 0
+		});
+	});
+	const handleLoad = useEffectEvent(() => {
+		deckglInstance._deck.getViewports().forEach((vp) => {
+			handleViewStateChange({
+				viewId: vp.id,
+				viewState: {
+					latitude: vp.latitude,
+					longitude: vp.longitude,
+					zoom: vp.zoom,
+					id: vp.id,
+					bounds: vp.getBounds(),
+					width: vp.width,
+					height: vp.height
+				}
+			});
+		});
+	});
+	return /* @__PURE__ */ jsx("div", {
+		id: container,
+		className,
+		children: /* @__PURE__ */ jsx(MapProvider, {
+			id,
+			children: /* @__PURE__ */ jsx(Deckgl, {
+				...rest,
+				controller,
+				interleaved,
+				useDevicePixels,
+				onClick: handleClick,
+				onHover: handleHover,
+				onLoad: handleLoad,
+				onViewStateChange: handleViewStateChange,
+				getCursor: handleGetCursor,
+				parameters: {
+					...PARAMETERS,
+					...parameters
+				},
+				children
+			})
+		})
+	});
 }
 
+//#endregion
 export { BaseMap };
-//# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/deckgl/base-map/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/deckgl/base-map/index.tsx"],"names":[],"mappings":";;;;;;;;;;;AA0HO,SAAS,OAAA,CAAQ;AAAA,EACtB,EAAA;AAAA,EACA,SAAA;AAAA,EACA,QAAA;AAAA,EACA,UAAA,GAAa,IAAA;AAAA,EACb,WAAA,GAAc,IAAA;AAAA,EACd,aAAa,EAAC;AAAA,EACd,eAAA,GAAkB,KAAA;AAAA,EAClB,OAAA,EAAS,cAAc,EAAC;AAAA,EACxB,OAAA;AAAA,EACA,OAAA;AAAA,EACA,iBAAA;AAAA,EACA,GAAG;AACL,CAAA,EAAiB;AACf,EAAA,MAAM,iBAAiB,SAAA,EAAU;AACjC,EAAA,MAAM,YAAY,KAAA,EAAM;AAGxB,EAAA,MAAM,UAAA,GAAa,OAAA;AAAA,IACjB,OAAO;AAAA,MACL,SAAA;AAAA,MACA,MAAA,EAAQ,CAAC,kBAAA,CAAmB,SAAA,EAAW,mBAAmB,QAAQ,CAAA;AAAA,MAIlE,MAAM,kBAAA,CAAmB,IAAA;AAAA,MACzB,eAAA,EAAiB,KAAA;AAAA,MACjB,UAAA,EAAY,KAAA;AAAA,MACZ,eAAA,EAAiB,KAAA;AAAA,MACjB,WAAA,EAAa,KAAA;AAAA,MACb,kBAAA,EAAoB,EAAE,OAAA,EAAS,IAAA;AAAK,KACtC,CAAA;AAAA,IACA,CAAC,SAAS;AAAA,GACZ;AAGA,EAAA,WAAA,CAAY,cAAA,EAA4B,gBAAgB,UAAU,CAAA;AAElE,EAAA,MAAM,SAAA,GAAY,OAAA,CAAuB,SAAA,CAAU,KAAK,CAAA;AACxD,EAAA,MAAM,SAAA,GAAY,OAAA,CAAuB,SAAA,CAAU,KAAK,CAAA;AACxD,EAAA,MAAM,YAAA,GAAe,OAAA,CAA0B,SAAA,CAAU,QAAQ,CAAA;AAEjE,EAAA,MAAM,WAAA,GAAc,WAAA;AAAA,IAClB,CAAC,MAAmB,KAAA,KAA+B;AAEjD,MAAA,OAAA,GAAU,MAAM,KAAK,CAAA;AAIrB,MAAA,MAAM,EAAE,QAAA,EAAU,KAAA,EAAO,WAAA,EAAa,GAAG,UAAS,GAAI,IAAA;AACtD,MAAA,MAAM,UAAA,GAAa;AAAA,QACjB,SAAS,KAAA,EAAO,EAAA;AAAA,QAChB,eAAe,WAAA,EAAa,EAAA;AAAA,QAC5B,GAAG;AAAA,OACL;AAEA,MAAA,MAAM;AAAA,QACJ,wBAAA;AAAA,QACA,eAAA;AAAA,QACA,cAAA;AAAA,QACA,QAAA;AAAA,QACA,WAAA;AAAA,QACA,MAAA;AAAA,QACA,eAAA;AAAA,QACA,QAAA;AAAA,QACA,GAAG;AAAA,OACL,GAAI,KAAA;AAEJ,MAAA,SAAA,CAAU;AAAA,QACR,IAAA,EAAM,UAAA;AAAA,QACN,KAAA,EAAO,SAAA;AAAA,QACP;AAAA,OACD,CAAA;AAAA,IACH,CAAA;AAAA,IACA,CAAC,SAAA,EAAW,EAAA,EAAI,OAAO;AAAA,GACzB;AAEA,EAAA,MAAM,WAAA,GAAc,WAAA;AAAA,IAClB,CAAC,MAAmB,KAAA,KAA+B;AAEjD,MAAA,OAAA,GAAU,MAAM,KAAK,CAAA;AAIrB,MAAA,MAAM,EAAE,QAAA,EAAU,KAAA,EAAO,WAAA,EAAa,GAAG,UAAS,GAAI,IAAA;AACtD,MAAA,MAAM,UAAA,GAAa;AAAA,QACjB,SAAS,KAAA,EAAO,EAAA;AAAA,QAChB,eAAe,WAAA,EAAa,EAAA;AAAA,QAC5B,GAAG;AAAA,OACL;AAEA,MAAA,MAAM;AAAA,QACJ,wBAAA;AAAA,QACA,eAAA;AAAA,QACA,cAAA;AAAA,QACA,QAAA;AAAA,QACA,WAAA;AAAA,QACA,MAAA;AAAA,QACA,GAAG;AAAA,OACL,GAAI,KAAA;AAEJ,MAAA,SAAA,CAAU;AAAA,QACR,IAAA,EAAM,UAAA;AAAA,QACN,KAAA,EAAO,SAAA;AAAA,QACP;AAAA,OACD,CAAA;AAAA,IACH,CAAA;AAAA,IACA,CAAC,SAAA,EAAW,EAAA,EAAI,OAAO;AAAA,GACzB;AAEA,EAAA,MAAM,qBAAA,GAAwB,cAAA;AAAA,IAC5B,CAAC,MAAA,KAAsC;AACrC,MAAA,iBAAA,GAAoB,MAAM,CAAA;AAE1B,MAAA,MAAM;AAAA,QACJ,MAAA;AAAA,QACA,SAAA,EAAW,EAAE,QAAA,EAAU,SAAA,EAAW,IAAA;AAAK,OACzC,GAAI,MAAA;AAGJ,MAAA,MAAM,QAAA,GAAW,cAAA,CAAe,KAAA,CAC7B,YAAA,EAAa,EAEZ,KAAK,CAAC,EAAA,KAAO,EAAA,CAAG,EAAA,KAAO,MAAM,CAAA;AAEjC,MAAA,YAAA,CAAa;AAAA,QACX,EAAA;AAAA,QACA,MAAA,EAAQ,UAAU,SAAA,EAAU;AAAA,QAC5B,QAAA;AAAA,QACA,SAAA;AAAA,QACA,IAAA;AAAA,QACA,KAAA,EAAO,UAAU,KAAA,IAAS,CAAA;AAAA,QAC1B,MAAA,EAAQ,UAAU,MAAA,IAAU;AAAA,OAC7B,CAAA;AAAA,IACH;AAAA,GACF;AAEA,EAAA,MAAM,UAAA,GAAa,eAAe,MAAM;AAGtC,IAAA,cAAA,CAAe,KAAA,CAAM,YAAA,EAAa,CAAE,OAAA,CAAQ,CAAC,EAAA,KAAO;AAClD,MAAA,qBAAA,CAAsB;AAAA,QACpB,QAAQ,EAAA,CAAG,EAAA;AAAA,QACX,SAAA,EAAW;AAAA,UACT,UAAU,EAAA,CAAG,QAAA;AAAA,UACb,WAAW,EAAA,CAAG,SAAA;AAAA,UACd,MAAM,EAAA,CAAG,IAAA;AAAA,UACT,IAAI,EAAA,CAAG,EAAA;AAAA,UACP,MAAA,EAAQ,GAAG,SAAA,EAAU;AAAA,UACrB,OAAO,EAAA,CAAG,KAAA;AAAA,UACV,QAAQ,EAAA,CAAG;AAAA;AACb,OAC4B,CAAA;AAAA,IAChC,CAAC,CAAA;AAAA,EACH,CAAC,CAAA;AAED,EAAA,2BACG,KAAA,EAAA,EAAI,EAAA,EAAI,WAAW,SAAA,EAClB,QAAA,kBAAA,GAAA,CAAC,eAAY,EAAA,EACX,QAAA,kBAAA,GAAA;AAAA,IAAC,MAAA;AAAA,IAAA;AAAA,MACE,GAAG,IAAA;AAAA,MACJ,UAAA;AAAA,MACA,WAAA;AAAA,MACA,eAAA;AAAA,MACA,OAAA,EAAS,WAAA;AAAA,MACT,OAAA,EAAS,WAAA;AAAA,MACT,MAAA,EAAQ,UAAA;AAAA,MACR,iBAAA,EAAmB,qBAAA;AAAA,MAGnB,UAAA,EAAY,EAAE,GAAG,UAAA,EAAY,GAAG,UAAA,EAAW;AAAA,MAE1C;AAAA;AAAA,KAEL,CAAA,EACF,CAAA;AAEJ","file":"index.js","sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\n'use client';\n\nimport 'client-only';\nimport { useEffectEvent, useEmit } from '@accelint/bus/react';\nimport { Deckgl, useDeckgl } from '@deckgl-fiber-renderer/dom';\nimport { useCallback, useId, useMemo } from 'react';\nimport { INITIAL_VIEW_STATE } from '../../maplibre/constants';\nimport { useMapLibre } from '../../maplibre/hooks/use-maplibre';\nimport { BASE_MAP_STYLE, PARAMETERS } from './constants';\nimport { MapEvents } from './events';\nimport { MapProvider } from './provider';\nimport type { UniqueId } from '@accelint/core';\nimport type { PickingInfo, ViewStateChangeParameters } from '@deck.gl/core';\nimport type { DeckglProps } from '@deckgl-fiber-renderer/types';\nimport type { IControl } from 'maplibre-gl';\nimport type { MjolnirGestureEvent, MjolnirPointerEvent } from 'mjolnir.js';\nimport type { MapClickEvent, MapHoverEvent, MapViewportEvent } from './types';\n\n/**\n * Props for the BaseMap component.\n * Extends all Deck.gl props and adds additional map-specific properties.\n */\nexport type BaseMapProps = DeckglProps & {\n  /** Optional CSS class name to apply to the map container element */\n  className?: string;\n  /**\n   * Unique identifier for this map instance (required).\n   *\n   * Used to isolate map mode state between multiple map instances (e.g., main map vs minimap).\n   * This should be a UUID generated using `uuid()` from `@accelint/core`.\n   *\n   * The same id should be passed to `useMapMode()` when accessing map mode state\n   * from components rendered outside of the BaseMap's children (i.e., as siblings).\n   */\n  id: UniqueId;\n};\n\n/**\n * A React component that provides a Deck.gl-powered base map with MapLibre GL integration.\n *\n * This component serves as the foundation for building interactive map applications with\n * support for click and hover events through a centralized event bus. It integrates\n * Deck.gl for 3D visualizations with MapLibre GL for the base map tiles.\n *\n * **Map Mode Integration**: BaseMap automatically creates a `MapProvider` internally,\n * which sets up the map mode state management for this instance.\n * - **Children**: Only Deck.gl layer components can be rendered as children. Custom Deck.gl\n *   layers can use `useMapMode()` without parameters to access context.\n * - **Siblings**: UI components (buttons, toolbars, etc.) must be rendered as siblings\n *   and pass `id` to `useMapMode(id)`.\n *\n * **Event Bus**: Click and hover events are emitted through the event bus with the `id`\n * included in the payload, allowing multiple map instances to coexist without interference.\n *\n * @param props - Component props including id (required), className, onClick, onHover, and all Deck.gl props\n * @returns A map component with Deck.gl and MapLibre GL integration\n *\n * @example\n * Basic usage with id (recommended: module-level constant):\n * ```tsx\n * import { BaseMap } from '@accelint/map-toolkit/deckgl';\n * import { View } from '@deckgl-fiber-renderer/dom';\n * import { uuid } from '@accelint/core';\n *\n * // Create id at module level for stability and easy sharing\n * const MAIN_MAP_ID = uuid();\n *\n * export function MapView() {\n *   return (\n *     <BaseMap className=\"w-full h-full\" id={MAIN_MAP_ID}>\n *       <View id=\"main\" controller />\n *     </BaseMap>\n *   );\n * }\n * ```\n *\n * @example\n * With map mode and event handlers (module-level constant for sharing):\n * ```tsx\n * import { BaseMap } from '@accelint/map-toolkit/deckgl';\n * import { useMapMode } from '@accelint/map-toolkit/map-mode';\n * import { uuid } from '@accelint/core';\n * import type { PickingInfo } from '@deck.gl/core';\n * import type { MjolnirGestureEvent } from 'mjolnir.js';\n *\n * // Module-level constant - stable and shareable across all components\n * const MAIN_MAP_ID = uuid();\n *\n * function Toolbar() {\n *   // Access map mode using the shared id\n *   const { mode, requestModeChange } = useMapMode(MAIN_MAP_ID);\n *   return <div>Current mode: {mode}</div>;\n * }\n *\n * export function InteractiveMap() {\n *   const handleClick = (info: PickingInfo, event: MjolnirGestureEvent) => {\n *     console.log('Clicked:', info.object);\n *   };\n *\n *   return (\n *     <div className=\"relative w-full h-full\">\n *       <BaseMap className=\"absolute inset-0\" id={MAIN_MAP_ID} onClick={handleClick}>\n *         <View id=\"main\" controller />\n *       </BaseMap>\n *       <Toolbar />\n *     </div>\n *   );\n * }\n * ```\n */\nexport function BaseMap({\n  id,\n  className,\n  children,\n  controller = true,\n  interleaved = true,\n  parameters = {},\n  useDevicePixels = false,\n  widgets: widgetsProp = [],\n  onClick,\n  onHover,\n  onViewStateChange,\n  ...rest\n}: BaseMapProps) {\n  const deckglInstance = useDeckgl();\n  const container = useId();\n\n  // Memoize MapLibre options to avoid creating new object on every render\n  const mapOptions = useMemo(\n    () => ({\n      container,\n      center: [INITIAL_VIEW_STATE.longitude, INITIAL_VIEW_STATE.latitude] as [\n        number,\n        number,\n      ],\n      zoom: INITIAL_VIEW_STATE.zoom,\n      doubleClickZoom: false,\n      dragRotate: false,\n      pitchWithRotate: false,\n      rollEnabled: false,\n      attributionControl: { compact: true },\n    }),\n    [container],\n  );\n\n  // Use the custom hook to handle MapLibre\n  useMapLibre(deckglInstance as IControl, BASE_MAP_STYLE, mapOptions);\n\n  const emitClick = useEmit<MapClickEvent>(MapEvents.click);\n  const emitHover = useEmit<MapHoverEvent>(MapEvents.hover);\n  const emitViewport = useEmit<MapViewportEvent>(MapEvents.viewport);\n\n  const handleClick = useCallback(\n    (info: PickingInfo, event: MjolnirGestureEvent) => {\n      // send full pickingInfo and event to user-defined onClick\n      onClick?.(info, event);\n\n      // omit viewport, layer, and sourceLayer (contain functions) for event bus serialization\n      // extract layerId and sourceLayerId before omission to preserve layer identification\n      const { viewport, layer, sourceLayer, ...infoRest } = info;\n      const infoObject = {\n        layerId: layer?.id,\n        sourceLayerId: sourceLayer?.id,\n        ...infoRest,\n      };\n\n      const {\n        stopImmediatePropagation,\n        stopPropagation,\n        preventDefault,\n        srcEvent,\n        rootElement,\n        target,\n        changedPointers,\n        pointers,\n        ...eventRest\n      } = event;\n\n      emitClick({\n        info: infoObject,\n        event: eventRest,\n        id,\n      });\n    },\n    [emitClick, id, onClick],\n  );\n\n  const handleHover = useCallback(\n    (info: PickingInfo, event: MjolnirPointerEvent) => {\n      // send full pickingInfo and event to user-defined onHover\n      onHover?.(info, event);\n\n      // omit viewport, layer, and sourceLayer (contain functions) for event bus serialization\n      // extract layerId and sourceLayerId before omission to preserve layer identification\n      const { viewport, layer, sourceLayer, ...infoRest } = info;\n      const infoObject = {\n        layerId: layer?.id,\n        sourceLayerId: sourceLayer?.id,\n        ...infoRest,\n      };\n\n      const {\n        stopImmediatePropagation,\n        stopPropagation,\n        preventDefault,\n        srcEvent,\n        rootElement,\n        target,\n        ...eventRest\n      } = event;\n\n      emitHover({\n        info: infoObject,\n        event: eventRest,\n        id,\n      });\n    },\n    [emitHover, id, onHover],\n  );\n\n  const handleViewStateChange = useEffectEvent(\n    (params: ViewStateChangeParameters) => {\n      onViewStateChange?.(params);\n\n      const {\n        viewId,\n        viewState: { latitude, longitude, zoom },\n      } = params;\n\n      // @ts-expect-error squirrelly deckglInstance typing\n      const viewport = deckglInstance._deck\n        .getViewports()\n        // @ts-expect-error squirrelly deckglInstance typing\n        ?.find((vp) => vp.id === viewId);\n\n      emitViewport({\n        id,\n        bounds: viewport?.getBounds(),\n        latitude,\n        longitude,\n        zoom,\n        width: viewport?.width ?? 0,\n        height: viewport?.height ?? 0,\n      });\n    },\n  );\n\n  const handleLoad = useEffectEvent(() => {\n    //--- force update viewport state once all viewports initialized ---\n    // @ts-expect-error squirrelly deckglInstance typing\n    deckglInstance._deck.getViewports().forEach((vp) => {\n      handleViewStateChange({\n        viewId: vp.id,\n        viewState: {\n          latitude: vp.latitude,\n          longitude: vp.longitude,\n          zoom: vp.zoom,\n          id: vp.id,\n          bounds: vp.getBounds(),\n          width: vp.width,\n          height: vp.height,\n        },\n      } as ViewStateChangeParameters);\n    });\n  });\n\n  return (\n    <div id={container} className={className}>\n      <MapProvider id={id}>\n        <Deckgl\n          {...rest}\n          controller={controller}\n          interleaved={interleaved}\n          useDevicePixels={useDevicePixels}\n          onClick={handleClick}\n          onHover={handleHover}\n          onLoad={handleLoad}\n          onViewStateChange={handleViewStateChange}\n          // @ts-expect-error - DeckglProps parameters type is overly strict for WebGL parameter spreading.\n          // The merged object is valid at runtime but TypeScript cannot verify all possible parameter combinations.\n          parameters={{ ...PARAMETERS, ...parameters }}\n        >\n          {children}\n        </Deckgl>\n      </MapProvider>\n    </div>\n  );\n}\n"]}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/deckgl/base-map/index.tsx"],"sourcesContent":["/*\n * Copyright 2025 Hypergiant Galactic Systems Inc. All rights reserved.\n * This file is licensed to you under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License. You may obtain a copy\n * of the License at https://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software distributed under\n * the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS\n * OF ANY KIND, either express or implied. See the License for the specific language\n * governing permissions and limitations under the License.\n */\n\n'use client';\n\nimport 'client-only';\nimport { useEffectEvent, useEmit } from '@accelint/bus/react';\nimport { Deckgl, useDeckgl } from '@deckgl-fiber-renderer/dom';\nimport { useCallback, useId, useMemo } from 'react';\nimport { getCursor } from '../../map-cursor/store';\nimport { INITIAL_VIEW_STATE } from '../../maplibre/constants';\nimport { useMapLibre } from '../../maplibre/hooks/use-maplibre';\nimport { BASE_MAP_STYLE, PARAMETERS } from './constants';\nimport { MapEvents } from './events';\nimport { MapProvider } from './provider';\nimport type { UniqueId } from '@accelint/core';\nimport type { PickingInfo, ViewStateChangeParameters } from '@deck.gl/core';\nimport type { DeckglProps } from '@deckgl-fiber-renderer/types';\nimport type { IControl } from 'maplibre-gl';\nimport type { MjolnirGestureEvent, MjolnirPointerEvent } from 'mjolnir.js';\nimport type {\n  MapClickEvent,\n  MapHoverEvent,\n  MapViewportEvent,\n  SerializablePickingInfo,\n} from './types';\n\n/**\n * Serializes PickingInfo for event bus transmission.\n * Omits viewport, layer, and sourceLayer (contain functions) but preserves layer IDs.\n */\nfunction serializePickingInfo(info: PickingInfo): SerializablePickingInfo {\n  const { viewport, layer, sourceLayer, ...infoRest } = info;\n  return {\n    layerId: layer?.id,\n    sourceLayerId: sourceLayer?.id,\n    ...infoRest,\n  };\n}\n\n/**\n * Strips non-serializable properties from MjolnirGestureEvent for event bus transmission.\n * Removes functions, DOM elements, and PointerEvent objects that cannot be cloned.\n */\nfunction serializeMjolnirEvent(\n  event: MjolnirGestureEvent,\n): Omit<\n  MjolnirGestureEvent,\n  | 'stopPropagation'\n  | 'preventDefault'\n  | 'stopImmediatePropagation'\n  | 'srcEvent'\n  | 'rootElement'\n  | 'target'\n  | 'changedPointers'\n  | 'pointers'\n>;\n/**\n * Strips non-serializable properties from MjolnirPointerEvent for event bus transmission.\n * Removes functions and DOM elements that cannot be cloned.\n */\nfunction serializeMjolnirEvent(\n  event: MjolnirPointerEvent,\n): Omit<\n  MjolnirPointerEvent,\n  | 'stopPropagation'\n  | 'preventDefault'\n  | 'stopImmediatePropagation'\n  | 'srcEvent'\n  | 'rootElement'\n  | 'target'\n>;\nfunction serializeMjolnirEvent(\n  event: MjolnirGestureEvent | MjolnirPointerEvent,\n) {\n  const {\n    stopImmediatePropagation,\n    stopPropagation,\n    preventDefault,\n    srcEvent,\n    rootElement,\n    target,\n    ...rest\n  } = event;\n\n  // Remove pointer arrays if present (only on MjolnirGestureEvent)\n  if ('changedPointers' in rest) {\n    const { changedPointers, pointers, ...gestureRest } = rest;\n    return gestureRest;\n  }\n\n  return rest;\n}\n\n/**\n * Props for the BaseMap component.\n * Extends all Deck.gl props and adds additional map-specific properties.\n */\nexport type BaseMapProps = DeckglProps & {\n  /** Optional CSS class name to apply to the map container element */\n  className?: string;\n  /**\n   * Unique identifier for this map instance (required).\n   *\n   * Used to isolate map mode state between multiple map instances (e.g., main map vs minimap).\n   * This should be a UUID generated using `uuid()` from `@accelint/core`.\n   *\n   * The same id should be passed to `useMapMode()` when accessing map mode state\n   * from components rendered outside of the BaseMap's children (i.e., as siblings).\n   */\n  id: UniqueId;\n};\n\n/**\n * A React component that provides a Deck.gl-powered base map with MapLibre GL integration.\n *\n * This component serves as the foundation for building interactive map applications with\n * support for click and hover events through a centralized event bus. It integrates\n * Deck.gl for 3D visualizations with MapLibre GL for the base map tiles.\n *\n * **Map Mode Integration**: BaseMap automatically creates a `MapProvider` internally,\n * which sets up the map mode state management for this instance.\n * - **Children**: Only Deck.gl layer components can be rendered as children. Custom Deck.gl\n *   layers can use `useMapMode()` without parameters to access context.\n * - **Siblings**: UI components (buttons, toolbars, etc.) must be rendered as siblings\n *   and pass `id` to `useMapMode(id)`.\n *\n * **Event Bus**: Click and hover events are emitted through the event bus with the `id`\n * included in the payload, allowing multiple map instances to coexist without interference.\n *\n * @param props - Component props including id (required), className, onClick, onHover, and all Deck.gl props\n * @returns A map component with Deck.gl and MapLibre GL integration\n *\n * @example\n * Basic usage with id (recommended: module-level constant):\n * ```tsx\n * import { BaseMap } from '@accelint/map-toolkit/deckgl';\n * import { View } from '@deckgl-fiber-renderer/dom';\n * import { uuid } from '@accelint/core';\n *\n * // Create id at module level for stability and easy sharing\n * const MAIN_MAP_ID = uuid();\n *\n * export function MapView() {\n *   return (\n *     <BaseMap className=\"w-full h-full\" id={MAIN_MAP_ID}>\n *       <View id=\"main\" controller />\n *     </BaseMap>\n *   );\n * }\n * ```\n *\n * @example\n * With map mode and event handlers (module-level constant for sharing):\n * ```tsx\n * import { BaseMap } from '@accelint/map-toolkit/deckgl';\n * import { useMapMode } from '@accelint/map-toolkit/map-mode';\n * import { uuid } from '@accelint/core';\n * import type { PickingInfo } from '@deck.gl/core';\n * import type { MjolnirGestureEvent } from 'mjolnir.js';\n *\n * // Module-level constant - stable and shareable across all components\n * const MAIN_MAP_ID = uuid();\n *\n * function Toolbar() {\n *   // Access map mode using the shared id\n *   const { mode, requestModeChange } = useMapMode(MAIN_MAP_ID);\n *   return <div>Current mode: {mode}</div>;\n * }\n *\n * export function InteractiveMap() {\n *   const handleClick = (info: PickingInfo, event: MjolnirGestureEvent) => {\n *     console.log('Clicked:', info.object);\n *   };\n *\n *   return (\n *     <div className=\"relative w-full h-full\">\n *       <BaseMap className=\"absolute inset-0\" id={MAIN_MAP_ID} onClick={handleClick}>\n *         <View id=\"main\" controller />\n *       </BaseMap>\n *       <Toolbar />\n *     </div>\n *   );\n * }\n * ```\n */\nexport function BaseMap({\n  id,\n  className,\n  children,\n  controller = true,\n  interleaved = true,\n  parameters = {},\n  useDevicePixels = false,\n  widgets: widgetsProp = [],\n  onClick,\n  onHover,\n  onViewStateChange,\n  ...rest\n}: BaseMapProps) {\n  const deckglInstance = useDeckgl();\n  const container = useId();\n\n  // Memoize MapLibre options to avoid creating new object on every render\n  const mapOptions = useMemo(\n    () => ({\n      container,\n      center: [INITIAL_VIEW_STATE.longitude, INITIAL_VIEW_STATE.latitude] as [\n        number,\n        number,\n      ],\n      zoom: INITIAL_VIEW_STATE.zoom,\n      doubleClickZoom: false,\n      dragRotate: false,\n      pitchWithRotate: false,\n      rollEnabled: false,\n      attributionControl: { compact: true },\n    }),\n    [container],\n  );\n\n  // Use the custom hook to handle MapLibre\n  useMapLibre(deckglInstance as IControl, BASE_MAP_STYLE, mapOptions);\n\n  const emitClick = useEmit<MapClickEvent>(MapEvents.click);\n  const emitHover = useEmit<MapHoverEvent>(MapEvents.hover);\n  const emitViewport = useEmit<MapViewportEvent>(MapEvents.viewport);\n\n  const handleClick = useCallback(\n    (info: PickingInfo, event: MjolnirGestureEvent) => {\n      // send full pickingInfo and event to user-defined onClick\n      onClick?.(info, event);\n\n      emitClick({\n        info: serializePickingInfo(info),\n        event: serializeMjolnirEvent(event),\n        id,\n      });\n    },\n    [emitClick, id, onClick],\n  );\n\n  const handleHover = useCallback(\n    (info: PickingInfo, event: MjolnirPointerEvent) => {\n      // send full pickingInfo and event to user-defined onHover\n      onHover?.(info, event);\n\n      emitHover({\n        info: serializePickingInfo(info),\n        event: serializeMjolnirEvent(event),\n        id,\n      });\n    },\n    [emitHover, id, onHover],\n  );\n\n  const handleGetCursor = useCallback(() => {\n    return getCursor(id);\n  }, [id]);\n\n  const handleViewStateChange = useEffectEvent(\n    (params: ViewStateChangeParameters) => {\n      onViewStateChange?.(params);\n\n      const {\n        viewId,\n        viewState: { latitude, longitude, zoom },\n      } = params;\n\n      // @ts-expect-error squirrelly deckglInstance typing\n      const viewport = deckglInstance._deck\n        .getViewports()\n        // @ts-expect-error squirrelly deckglInstance typing\n        ?.find((vp) => vp.id === viewId);\n\n      emitViewport({\n        id,\n        bounds: viewport?.getBounds(),\n        latitude,\n        longitude,\n        zoom,\n        width: viewport?.width ?? 0,\n        height: viewport?.height ?? 0,\n      });\n    },\n  );\n\n  const handleLoad = useEffectEvent(() => {\n    //--- force update viewport state once all viewports initialized ---\n    // @ts-expect-error squirrelly deckglInstance typing\n    deckglInstance._deck.getViewports().forEach((vp) => {\n      handleViewStateChange({\n        viewId: vp.id,\n        viewState: {\n          latitude: vp.latitude,\n          longitude: vp.longitude,\n          zoom: vp.zoom,\n          id: vp.id,\n          bounds: vp.getBounds(),\n          width: vp.width,\n          height: vp.height,\n        },\n      } as ViewStateChangeParameters);\n    });\n  });\n\n  return (\n    <div id={container} className={className}>\n      <MapProvider id={id}>\n        <Deckgl\n          {...rest}\n          controller={controller}\n          interleaved={interleaved}\n          useDevicePixels={useDevicePixels}\n          onClick={handleClick}\n          onHover={handleHover}\n          onLoad={handleLoad}\n          onViewStateChange={handleViewStateChange}\n          getCursor={handleGetCursor}\n          // @ts-expect-error - DeckglProps parameters type is overly strict for WebGL parameter spreading.\n          // The merged object is valid at runtime but TypeScript cannot verify all possible parameter combinations.\n          parameters={{ ...PARAMETERS, ...parameters }}\n        >\n          {children}\n        </Deckgl>\n      </MapProvider>\n    </div>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwCA,SAAS,qBAAqB,MAA4C;CACxE,MAAM,EAAE,UAAU,OAAO,aAAa,GAAG,aAAa;AACtD,QAAO;EACL,SAAS,OAAO;EAChB,eAAe,aAAa;EAC5B,GAAG;EACJ;;AAmCH,SAAS,sBACP,OACA;CACA,MAAM,EACJ,0BACA,iBACA,gBACA,UACA,aACA,QACA,GAAG,SACD;AAGJ,KAAI,qBAAqB,MAAM;EAC7B,MAAM,EAAE,iBAAiB,UAAU,GAAG,gBAAgB;AACtD,SAAO;;AAGT,QAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+FT,SAAgB,QAAQ,EACtB,IACA,WACA,UACA,aAAa,MACb,cAAc,MACd,aAAa,EAAE,EACf,kBAAkB,OAClB,SAAS,cAAc,EAAE,EACzB,SACA,SACA,mBACA,GAAG,QACY;CACf,MAAM,iBAAiB,WAAW;CAClC,MAAM,YAAY,OAAO;AAqBzB,aAAY,gBAA4B,gBAlBrB,eACV;EACL;EACA,QAAQ,CAAC,mBAAmB,WAAW,mBAAmB,SAAS;EAInE,MAAM,mBAAmB;EACzB,iBAAiB;EACjB,YAAY;EACZ,iBAAiB;EACjB,aAAa;EACb,oBAAoB,EAAE,SAAS,MAAM;EACtC,GACD,CAAC,UAAU,CACZ,CAGkE;CAEnE,MAAM,YAAY,QAAuB,UAAU,MAAM;CACzD,MAAM,YAAY,QAAuB,UAAU,MAAM;CACzD,MAAM,eAAe,QAA0B,UAAU,SAAS;CAElE,MAAM,cAAc,aACjB,MAAmB,UAA+B;AAEjD,YAAU,MAAM,MAAM;AAEtB,YAAU;GACR,MAAM,qBAAqB,KAAK;GAChC,OAAO,sBAAsB,MAAM;GACnC;GACD,CAAC;IAEJ;EAAC;EAAW;EAAI;EAAQ,CACzB;CAED,MAAM,cAAc,aACjB,MAAmB,UAA+B;AAEjD,YAAU,MAAM,MAAM;AAEtB,YAAU;GACR,MAAM,qBAAqB,KAAK;GAChC,OAAO,sBAAsB,MAAM;GACnC;GACD,CAAC;IAEJ;EAAC;EAAW;EAAI;EAAQ,CACzB;CAED,MAAM,kBAAkB,kBAAkB;AACxC,SAAO,UAAU,GAAG;IACnB,CAAC,GAAG,CAAC;CAER,MAAM,wBAAwB,gBAC3B,WAAsC;AACrC,sBAAoB,OAAO;EAE3B,MAAM,EACJ,QACA,WAAW,EAAE,UAAU,WAAW,WAChC;EAGJ,MAAM,WAAW,eAAe,MAC7B,cAAc,EAEb,MAAM,OAAO,GAAG,OAAO,OAAO;AAElC,eAAa;GACX;GACA,QAAQ,UAAU,WAAW;GAC7B;GACA;GACA;GACA,OAAO,UAAU,SAAS;GAC1B,QAAQ,UAAU,UAAU;GAC7B,CAAC;GAEL;CAED,MAAM,aAAa,qBAAqB;AAGtC,iBAAe,MAAM,cAAc,CAAC,SAAS,OAAO;AAClD,yBAAsB;IACpB,QAAQ,GAAG;IACX,WAAW;KACT,UAAU,GAAG;KACb,WAAW,GAAG;KACd,MAAM,GAAG;KACT,IAAI,GAAG;KACP,QAAQ,GAAG,WAAW;KACtB,OAAO,GAAG;KACV,QAAQ,GAAG;KACZ;IACF,CAA8B;IAC/B;GACF;AAEF,QACE,oBAAC;EAAI,IAAI;EAAsB;YAC7B,oBAAC;GAAgB;aACf,oBAAC;IACC,GAAI;IACQ;IACC;IACI;IACjB,SAAS;IACT,SAAS;IACT,QAAQ;IACR,mBAAmB;IACnB,WAAW;IAGX,YAAY;KAAE,GAAG;KAAY,GAAG;KAAY;IAE3C;KACM;IACG;GACV"}