@trackunit/react-map 0.2.217 → 0.2.219

package/index.cjs.js

@@ -32,6 +32,10 @@ var defaultTranslations = {
 	"controls.stepper.decrease": "Decrease",
 	"controls.stepper.increase": "Increase",
 	"controls.zoom": "Zoom",
+	"draw.clear": "Clear drawing",
+	"draw.polygon": "Draw polygon",
+	"draw.select": "Edit polygon",
+	"draw.selectDisabled": "Draw a polygon first",
 	"map.loading": "Loading map",
 	"map.loadingData": "Loading map data",
 	"map.loadingErrorMessage": "Unable to load the map. Please try again later.",
@@ -1375,6 +1379,8 @@ const useMap = (adapterConfig) => {
         setShowRoads: adapter.setShowRoads.bind(adapter),
         // Optional capability: stays undefined for adapters without traffic support
         setShowTraffic: adapter.setShowTraffic?.bind(adapter),
+        // Optional capability: stays undefined for adapters without drawing support (ADR 0030)
+        draw: adapter.draw ?? undefined,
     }), [adapter]);
     // Stable event subscription callback
     const on = react.useMemo(() => adapter.on.bind(adapter), [adapter]);
@@ -3383,6 +3389,108 @@ const useControls = (base, areas) => {
     }, [base, areas]);
 };
 
+const noopUnsubscribe$1 = () => undefined;
+const subscribeNoop = () => noopUnsubscribe$1;
+const getIdle = () => "idle";
+const getEmpty = () => reactMapAdapterShared.EMPTY_DRAW_VALUE;
+/**
+ * Feature-facing hook for the optional drawing capability (ADR 0030).
+ *
+ * Calling this hook is the consumer's opt-in: a map only offers drawing where a
+ * component renders `controls` (typically appended to the `tools` area through
+ * `useControls`). Feature code sees GeoJSON in and GeoJSON out; the engine behind
+ * the adapter is never exposed.
+ *
+ * @example
+ * ```tsx
+ * const [Map, api] = useMap(adapter);
+ * const draw = useDraw(api);
+ * const controls = useControls(api, { tools: { append: draw.controls } });
+ *
+ * return (
+ *   <Map>
+ *     <Controls api={api} controls={controls} />
+ *   </Map>
+ * );
+ * ```
+ */
+const useDraw = (api, options) => {
+    const [t] = useTranslation();
+    const port = api.actions.draw;
+    const enabled = options?.enabled ?? true;
+    const isSupported = port !== undefined;
+    // Call through the port object (never pass its methods around unbound): adapters
+    // implement DrawPort as a class whose methods read instance state.
+    const subscribe = react.useMemo(() => (port === undefined ? subscribeNoop : (listener) => port.subscribe(listener)), [port]);
+    const getMode = react.useMemo(() => (port === undefined ? getIdle : () => port.getMode()), [port]);
+    const getValue = react.useMemo(() => (port === undefined ? getEmpty : () => port.getValue()), [port]);
+    const mode = react.useSyncExternalStore(subscribe, getMode, getIdle);
+    const value = react.useSyncExternalStore(subscribe, getValue, getEmpty);
+    // A disabled hook must not leave the map in a drawing mode it can no longer exit.
+    react.useEffect(() => {
+        if (!enabled)
+            port?.setMode("idle");
+    }, [enabled, port]);
+    const setMode = react.useCallback((nextMode) => {
+        port?.setMode(nextMode);
+    }, [port]);
+    const setValue = react.useCallback((nextValue) => {
+        port?.setValue(nextValue);
+    }, [port]);
+    const clear = react.useCallback(() => {
+        port?.setValue(reactMapAdapterShared.EMPTY_DRAW_VALUE);
+        port?.setMode("idle");
+    }, [port]);
+    const hasPolygons = value.features.length > 0;
+    const controls = react.useMemo(() => {
+        if (!isSupported || !enabled)
+            return [];
+        const polygonToggle = {
+            type: "toggle",
+            id: "draw-polygon",
+            icon: { on: "Pencil", off: "Pencil" },
+            label: t("draw.polygon"),
+            section: t("controls.category.tools"),
+            value: mode === "polygon",
+            onChange: on => setMode(on ? "polygon" : "idle"),
+            "data-testid": "map-draw-polygon-toggle",
+        };
+        const selectToggle = {
+            type: "toggle",
+            id: "draw-select",
+            icon: { on: "CursorArrowRays", off: "CursorArrowRays" },
+            label: t("draw.select"),
+            section: t("controls.category.tools"),
+            value: mode === "select",
+            onChange: on => setMode(on ? "select" : "idle"),
+            // Never disable the active toggle: the user must always be able to switch it off.
+            disabled: !hasPolygons && mode !== "select",
+            disabledReason: hasPolygons || mode === "select" ? undefined : t("draw.selectDisabled"),
+            "data-testid": "map-draw-select-toggle",
+        };
+        const clearButton = {
+            type: "button",
+            id: "draw-clear",
+            icon: "Trash",
+            label: t("draw.clear"),
+            section: t("controls.category.tools"),
+            onClick: clear,
+            "data-testid": "map-draw-clear-button",
+        };
+        return [polygonToggle, selectToggle, clearButton];
+    }, [clear, enabled, hasPolygons, isSupported, mode, setMode, t]);
+    return react.useMemo(() => ({
+        isSupported,
+        isDrawing: mode !== "idle",
+        mode,
+        value,
+        setMode,
+        setValue,
+        clear,
+        controls,
+    }), [clear, controls, isSupported, mode, setMode, setValue, value]);
+};
+
 /**
  * Reads the persisted map appearance once (on mount) so it can seed the adapter
  * factory, letting the FIRST map be constructed with the user's stored theme,
@@ -13355,6 +13463,10 @@ Object.defineProperty(exports, "DEFAULT_MAP_APPEARANCE", {
   enumerable: true,
   get: function () { return reactMapAdapterShared.DEFAULT_MAP_APPEARANCE; }
 });
+Object.defineProperty(exports, "EMPTY_DRAW_VALUE", {
+  enumerable: true,
+  get: function () { return reactMapAdapterShared.EMPTY_DRAW_VALUE; }
+});
 Object.defineProperty(exports, "HIT_SURFACE_SELECTOR", {
   enumerable: true,
   get: function () { return reactMapAdapterShared.HIT_SURFACE_SELECTOR; }
@@ -13430,6 +13542,7 @@ exports.useControlStack = useControlStack;
 exports.useControls = useControls;
 exports.useDefaultControls = useDefaultControls;
 exports.useDirectionIndicator = useDirectionIndicator;
+exports.useDraw = useDraw;
 exports.useEntitiesNearCursor = useEntitiesNearCursor;
 exports.useExpandedIds = useExpandedIds;
 exports.useFitFeatureBounds = useFitFeatureBounds;

package/index.esm.js

@@ -1,7 +1,7 @@
 import { jsx, Fragment, jsxs } from 'react/jsx-runtime';
 import { useNamespaceTranslation, registerTranslations } from '@trackunit/i18n-library-translation';
-import { INITIAL_CAMERA_STATE, INITIAL_MAP_STATUS, KEYBOARD_PAN_AMOUNT, KEYBOARD_ZOOM_AMOUNT, mapAppearanceSchema, DEFAULT_MAP_APPEARANCE, WORLD_BBOX, INITIAL_INTERACTION_STATE, mapThemeSchema, mergeAntimeridianFeatures, extractSourceData, computeMarkerDomPortalZIndex, densifyGeodesicFeatures, angularDistance, intermediatePoint, GEODESIC_MAX_SEGMENT_KM, geometryTypeToShapeType, resolveStrokeColors } from '@trackunit/react-map-adapter-shared';
-export { ANCHOR_SELECTOR, DEFAULT_MAP_APPEARANCE, HIT_SURFACE_SELECTOR, INITIAL_CAMERA_STATE, INITIAL_INTERACTION_STATE, INITIAL_MAP_STATE, INITIAL_MAP_STATUS, computeMarkerDomPortalZIndex, defineAdapter, geometryTypeToShapeType, mapAppearanceSchema, mapThemeSchema, mapTypeSchema } from '@trackunit/react-map-adapter-shared';
+import { INITIAL_CAMERA_STATE, INITIAL_MAP_STATUS, KEYBOARD_PAN_AMOUNT, KEYBOARD_ZOOM_AMOUNT, mapAppearanceSchema, DEFAULT_MAP_APPEARANCE, EMPTY_DRAW_VALUE, WORLD_BBOX, INITIAL_INTERACTION_STATE, mapThemeSchema, mergeAntimeridianFeatures, extractSourceData, computeMarkerDomPortalZIndex, densifyGeodesicFeatures, angularDistance, intermediatePoint, GEODESIC_MAX_SEGMENT_KM, geometryTypeToShapeType, resolveStrokeColors } from '@trackunit/react-map-adapter-shared';
+export { ANCHOR_SELECTOR, DEFAULT_MAP_APPEARANCE, EMPTY_DRAW_VALUE, HIT_SURFACE_SELECTOR, INITIAL_CAMERA_STATE, INITIAL_INTERACTION_STATE, INITIAL_MAP_STATE, INITIAL_MAP_STATUS, computeMarkerDomPortalZIndex, defineAdapter, geometryTypeToShapeType, mapAppearanceSchema, mapThemeSchema, mapTypeSchema } from '@trackunit/react-map-adapter-shared';
 import { useSyncExternalStore, useMemo, useState, useRef, useCallback, useLayoutEffect, useEffect, useReducer, createContext, useContext, memo, Suspense, useId, Fragment as Fragment$1, forwardRef } from 'react';
 import { cva } from '@trackunit/css-class-variance-utilities';
 import { Tooltip, useMergeRefs, Icon, Spinner, Text, useMeasure, useContainerBreakpoints, useDebounce, useWatch, useKeyboardShortcut, IconButton, ToggleGroup as ToggleGroup$1, useIsFullscreen, Popover, PopoverTrigger, PopoverContent, MoreMenu, useHover as useHover$1, cvaInteractableItem, useLocalStorageReducer } from '@trackunit/react-components';
@@ -31,6 +31,10 @@ var defaultTranslations = {
 	"controls.stepper.decrease": "Decrease",
 	"controls.stepper.increase": "Increase",
 	"controls.zoom": "Zoom",
+	"draw.clear": "Clear drawing",
+	"draw.polygon": "Draw polygon",
+	"draw.select": "Edit polygon",
+	"draw.selectDisabled": "Draw a polygon first",
 	"map.loading": "Loading map",
 	"map.loadingData": "Loading map data",
 	"map.loadingErrorMessage": "Unable to load the map. Please try again later.",
@@ -1374,6 +1378,8 @@ const useMap = (adapterConfig) => {
         setShowRoads: adapter.setShowRoads.bind(adapter),
         // Optional capability: stays undefined for adapters without traffic support
         setShowTraffic: adapter.setShowTraffic?.bind(adapter),
+        // Optional capability: stays undefined for adapters without drawing support (ADR 0030)
+        draw: adapter.draw ?? undefined,
     }), [adapter]);
     // Stable event subscription callback
     const on = useMemo(() => adapter.on.bind(adapter), [adapter]);
@@ -3382,6 +3388,108 @@ const useControls = (base, areas) => {
     }, [base, areas]);
 };
 
+const noopUnsubscribe$1 = () => undefined;
+const subscribeNoop = () => noopUnsubscribe$1;
+const getIdle = () => "idle";
+const getEmpty = () => EMPTY_DRAW_VALUE;
+/**
+ * Feature-facing hook for the optional drawing capability (ADR 0030).
+ *
+ * Calling this hook is the consumer's opt-in: a map only offers drawing where a
+ * component renders `controls` (typically appended to the `tools` area through
+ * `useControls`). Feature code sees GeoJSON in and GeoJSON out; the engine behind
+ * the adapter is never exposed.
+ *
+ * @example
+ * ```tsx
+ * const [Map, api] = useMap(adapter);
+ * const draw = useDraw(api);
+ * const controls = useControls(api, { tools: { append: draw.controls } });
+ *
+ * return (
+ *   <Map>
+ *     <Controls api={api} controls={controls} />
+ *   </Map>
+ * );
+ * ```
+ */
+const useDraw = (api, options) => {
+    const [t] = useTranslation();
+    const port = api.actions.draw;
+    const enabled = options?.enabled ?? true;
+    const isSupported = port !== undefined;
+    // Call through the port object (never pass its methods around unbound): adapters
+    // implement DrawPort as a class whose methods read instance state.
+    const subscribe = useMemo(() => (port === undefined ? subscribeNoop : (listener) => port.subscribe(listener)), [port]);
+    const getMode = useMemo(() => (port === undefined ? getIdle : () => port.getMode()), [port]);
+    const getValue = useMemo(() => (port === undefined ? getEmpty : () => port.getValue()), [port]);
+    const mode = useSyncExternalStore(subscribe, getMode, getIdle);
+    const value = useSyncExternalStore(subscribe, getValue, getEmpty);
+    // A disabled hook must not leave the map in a drawing mode it can no longer exit.
+    useEffect(() => {
+        if (!enabled)
+            port?.setMode("idle");
+    }, [enabled, port]);
+    const setMode = useCallback((nextMode) => {
+        port?.setMode(nextMode);
+    }, [port]);
+    const setValue = useCallback((nextValue) => {
+        port?.setValue(nextValue);
+    }, [port]);
+    const clear = useCallback(() => {
+        port?.setValue(EMPTY_DRAW_VALUE);
+        port?.setMode("idle");
+    }, [port]);
+    const hasPolygons = value.features.length > 0;
+    const controls = useMemo(() => {
+        if (!isSupported || !enabled)
+            return [];
+        const polygonToggle = {
+            type: "toggle",
+            id: "draw-polygon",
+            icon: { on: "Pencil", off: "Pencil" },
+            label: t("draw.polygon"),
+            section: t("controls.category.tools"),
+            value: mode === "polygon",
+            onChange: on => setMode(on ? "polygon" : "idle"),
+            "data-testid": "map-draw-polygon-toggle",
+        };
+        const selectToggle = {
+            type: "toggle",
+            id: "draw-select",
+            icon: { on: "CursorArrowRays", off: "CursorArrowRays" },
+            label: t("draw.select"),
+            section: t("controls.category.tools"),
+            value: mode === "select",
+            onChange: on => setMode(on ? "select" : "idle"),
+            // Never disable the active toggle: the user must always be able to switch it off.
+            disabled: !hasPolygons && mode !== "select",
+            disabledReason: hasPolygons || mode === "select" ? undefined : t("draw.selectDisabled"),
+            "data-testid": "map-draw-select-toggle",
+        };
+        const clearButton = {
+            type: "button",
+            id: "draw-clear",
+            icon: "Trash",
+            label: t("draw.clear"),
+            section: t("controls.category.tools"),
+            onClick: clear,
+            "data-testid": "map-draw-clear-button",
+        };
+        return [polygonToggle, selectToggle, clearButton];
+    }, [clear, enabled, hasPolygons, isSupported, mode, setMode, t]);
+    return useMemo(() => ({
+        isSupported,
+        isDrawing: mode !== "idle",
+        mode,
+        value,
+        setMode,
+        setValue,
+        clear,
+        controls,
+    }), [clear, controls, isSupported, mode, setMode, setValue, value]);
+};
+
 /**
  * Reads the persisted map appearance once (on mount) so it can seed the adapter
  * factory, letting the FIRST map be constructed with the user's stored theme,
@@ -13346,4 +13454,4 @@ const mockMapApi = (overrides) => {
  */
 setupLibraryTranslations();
 
-export { ClusterMarker, ClusterStick, Controls, DEFAULT_APPEARANCE_PERSISTENCE_KEY, DEFAULT_MARKER_SIZE_BREAKPOINTS, DefaultControls, Layers, MARKER_DARK_PILL, MARKER_DISC_BORDER_WIDTH_PX, MARKER_LIGHT_PILL, MARKER_PILL_CONTENT_LAYOUT_SIZE, MARKER_SIZE_MAP, MARKER_TUNING, MapLoadingState, MapMarker, MapMarkerIcon, PanelIconButton, ShapeAnnotationLabel, buildExpandedIds, cvaMapMarker, cvaMarkerIndicator, mockMapApi, useAdaptiveMarkerHelpers, useAutoPanResolver, useCameraIdle, useCameraState, useClusterCountFormat, useControlStack, useControls, useDefaultControls, useDirectionIndicator, useEntitiesNearCursor, useExpandedIds, useFitFeatureBounds, useFitToContent, useHeatmap, useImageOverlay, useLabelPlacement, useLayers, useMap, useMapAnnotation, useMapAnnotations, useMapAppearanceControls, useMapKeyboardNavigation, useMarkerColors, useMarkerStateResolvers, useMarkers, usePanel, usePanelPreload, usePersistedAppearanceSeed, usePreviewMap, useRoute, useShapeLabelHelpers, useShapes, useViewportContext };
+export { ClusterMarker, ClusterStick, Controls, DEFAULT_APPEARANCE_PERSISTENCE_KEY, DEFAULT_MARKER_SIZE_BREAKPOINTS, DefaultControls, Layers, MARKER_DARK_PILL, MARKER_DISC_BORDER_WIDTH_PX, MARKER_LIGHT_PILL, MARKER_PILL_CONTENT_LAYOUT_SIZE, MARKER_SIZE_MAP, MARKER_TUNING, MapLoadingState, MapMarker, MapMarkerIcon, PanelIconButton, ShapeAnnotationLabel, buildExpandedIds, cvaMapMarker, cvaMarkerIndicator, mockMapApi, useAdaptiveMarkerHelpers, useAutoPanResolver, useCameraIdle, useCameraState, useClusterCountFormat, useControlStack, useControls, useDefaultControls, useDirectionIndicator, useDraw, useEntitiesNearCursor, useExpandedIds, useFitFeatureBounds, useFitToContent, useHeatmap, useImageOverlay, useLabelPlacement, useLayers, useMap, useMapAnnotation, useMapAnnotations, useMapAppearanceControls, useMapKeyboardNavigation, useMarkerColors, useMarkerStateResolvers, useMarkers, usePanel, usePanelPreload, usePersistedAppearanceSeed, usePreviewMap, useRoute, useShapeLabelHelpers, useShapes, useViewportContext };

package/package.json

@@ -1,23 +1,23 @@
 {
   "name": "@trackunit/react-map",
-  "version": "0.2.217",
+  "version": "0.2.219",
   "repository": "https://github.com/Trackunit/manager",
   "license": "SEE LICENSE IN LICENSE.txt",
   "engines": {
     "node": ">=24.x"
   },
   "dependencies": {
-    "@trackunit/react-components": "3.8.10",
-    "@trackunit/css-class-variance-utilities": "2.3.10",
-    "@trackunit/react-form-components": "2.10.17",
-    "@trackunit/react-core-hooks": "1.25.11",
-    "@trackunit/geo-json-utils": "1.18.10",
-    "@trackunit/i18n-library-translation": "2.8.11",
+    "@trackunit/react-components": "3.9.0",
+    "@trackunit/css-class-variance-utilities": "2.4.0",
+    "@trackunit/react-form-components": "2.11.0",
+    "@trackunit/react-core-hooks": "1.26.0",
+    "@trackunit/geo-json-utils": "1.19.0",
+    "@trackunit/i18n-library-translation": "2.9.0",
     "react-minimal-pie-chart": "^8.4.0",
-    "@trackunit/react-map-adapter-shared": "0.0.162",
-    "@trackunit/react-map-color-utils": "0.0.136",
-    "@trackunit/shared-utils": "1.19.10",
-    "@trackunit/ui-design-tokens": "1.18.9",
+    "@trackunit/react-map-adapter-shared": "0.0.164",
+    "@trackunit/react-map-color-utils": "0.0.138",
+    "@trackunit/shared-utils": "1.20.0",
+    "@trackunit/ui-design-tokens": "1.19.0",
     "@floating-ui/react": "^0.26.25",
     "es-toolkit": "^1.52.0",
     "tailwind-merge": "^2.0.0",

package/src/core/types.d.ts

@@ -1,6 +1,6 @@
 export { DEFAULT_MAP_APPEARANCE, INITIAL_CAMERA_STATE, INITIAL_MAP_STATE, INITIAL_MAP_STATUS, mapAppearanceSchema, mapThemeSchema, mapTypeSchema, } from "@trackunit/react-map-adapter-shared";
 export type { CameraState, ContainerRefHolder, FitBoundsOptions, GeoJsonBbox, GeoJsonPosition, InitialViewport, MapAppearance, MapComponentProps, MapEvent, MapEventHandler, MapEventOfType, MapState, MapStatus, MapTheme, MapType, StoredEventHandler, } from "@trackunit/react-map-adapter-shared";
-import type { AdapterConfig, CameraState, ContainerRefHolder, FitBoundsOptions, GeoJsonBbox, GeoJsonPosition, MapComponentProps, MapEvent, MapEventHandler, MapStatus, MapTheme, MapType } from "@trackunit/react-map-adapter-shared";
+import type { AdapterConfig, CameraState, ContainerRefHolder, DrawPort, FitBoundsOptions, GeoJsonBbox, GeoJsonPosition, MapComponentProps, MapEvent, MapEventHandler, MapStatus, MapTheme, MapType } from "@trackunit/react-map-adapter-shared";
 import type { ComponentType } from "react";
 import type { MapAnnotationStore } from "../annotations/mapAnnotations";
 import type { PanelStore } from "../panel/store/panels";
@@ -92,6 +92,15 @@ export type MapActions = Readonly<{
      * @returns Promise that resolves when the change is applied
      */
     setShowTraffic?: (showTraffic: boolean) => Promise<void>;
+    /**
+     * Interactive polygon drawing (ADR 0030).
+     *
+     * Undefined when the adapter cannot draw — `useDraw` reports `isSupported: false`
+     * and renders no controls in that case. The port is a controlled input: set
+     * `mode` and `value`, subscribe for user edits. Prefer `useDraw(api)` from React
+     * components; this is the lower-level handle.
+     */
+    draw?: DrawPort;
 }>;
 /**
  * The API object returned as the second element of the useMap tuple.

package/src/draw/useDraw.d.ts

@@ -0,0 +1,62 @@
+import { type DrawMode, type DrawValue } from "@trackunit/react-map-adapter-shared";
+import type { ControlConfig } from "../controls/types";
+import type { MapApi } from "../core/types";
+/** Minimal slice of `MapApi` consumed by `useDraw`. */
+type DrawApi = Readonly<{
+    actions: Pick<MapApi["actions"], "draw">;
+}>;
+export type UseDrawOptions = Readonly<{
+    /**
+     * Hide the draw controls and force the map back to `"idle"` without unmounting
+     * the hook, for example while a feature flag is off. Default `true`.
+     */
+    enabled?: boolean;
+}>;
+export type UseDrawReturn = Readonly<{
+    /** False when the adapter has no drawing capability; `controls` is then empty. */
+    isSupported: boolean;
+    /** True while `mode` is not `"idle"`. Same signal as `api.state.drawing`. */
+    isDrawing: boolean;
+    /** Current drawing mode. */
+    mode: DrawMode;
+    /**
+     * Committed polygons as GeoJSON. Updates when the user finishes, edits or deletes a
+     * polygon, and when `setValue` is called.
+     */
+    value: DrawValue;
+    /** Enter a drawing mode; `"idle"` ends drawing. */
+    setMode: (mode: DrawMode) => void;
+    /** Replace the committed polygons (controlled-input style). */
+    setValue: (value: DrawValue) => void;
+    /** Remove every polygon and return to `"idle"`. */
+    clear: () => void;
+    /**
+     * Ready-made controls for the `tools` area: a "Draw polygon" toggle, an "Edit
+     * polygon" toggle and a "Clear drawing" button. Empty when drawing is unsupported
+     * or disabled.
+     */
+    controls: ReadonlyArray<ControlConfig>;
+}>;
+/**
+ * Feature-facing hook for the optional drawing capability (ADR 0030).
+ *
+ * Calling this hook is the consumer's opt-in: a map only offers drawing where a
+ * component renders `controls` (typically appended to the `tools` area through
+ * `useControls`). Feature code sees GeoJSON in and GeoJSON out; the engine behind
+ * the adapter is never exposed.
+ *
+ * @example
+ * ```tsx
+ * const [Map, api] = useMap(adapter);
+ * const draw = useDraw(api);
+ * const controls = useControls(api, { tools: { append: draw.controls } });
+ *
+ * return (
+ *   <Map>
+ *     <Controls api={api} controls={controls} />
+ *   </Map>
+ * );
+ * ```
+ */
+export declare const useDraw: (api: DrawApi, options?: UseDrawOptions) => UseDrawReturn;
+export {};

package/src/index.d.ts

@@ -16,6 +16,9 @@ export type { ControlStackItem } from "./controls/defineControlStack";
 export type { UseControlsAreas } from "./controls/types";
 export { useControls } from "./controls/useControls";
 export { useDefaultControls, type UseDefaultControlsOptions } from "./controls/useDefaultControls";
+export { EMPTY_DRAW_VALUE } from "@trackunit/react-map-adapter-shared";
+export type { DrawMode, DrawPort, DrawValue } from "@trackunit/react-map-adapter-shared";
+export { useDraw, type UseDrawOptions, type UseDrawReturn } from "./draw/useDraw";
 export { DEFAULT_APPEARANCE_PERSISTENCE_KEY } from "./appearance/appearanceTypes";
 export type { AppearanceAction, AppearanceOption, AppearanceOptions, MapAppearanceApi, PersistedAppearance, UseMapAppearanceControlsParams, } from "./appearance/appearanceTypes";
 export { useMapAppearanceControls } from "./appearance/useMapAppearanceControls";