@trackunit/react-map 0.2.39 → 0.2.40

package/index.cjs.js

@@ -1312,7 +1312,7 @@ function useMapAdapterState(adapterConfig) {
  * @returns Tuple of [Map component, API object]
  * @example Basic usage
  * ```tsx
- * import { useMap, Controls } from "@trackunit/react-map";
+ * import { useMap, DefaultControls } from "@trackunit/react-map";
  * import { googleMapsAdapter } from "@trackunit/react-map-adapter-google";
  *
  * const MyMap = () => {
@@ -1323,7 +1323,7 @@ function useMapAdapterState(adapterConfig) {
  *
  *   return (
  *     <Map>
- *       <Controls api={api} />
+ *       <DefaultControls api={api} />
  *     </Map>
  *   );
  * };
@@ -10923,7 +10923,7 @@ const applyPortalZIndex = (container, zIndex) => {
  *
  * return (
  *   <Map>
- *     <Controls api={api} />
+ *     <DefaultControls api={api} />
  *     <Layers api={api} layers={layers} />
  *   </Map>
  * );
@@ -11543,14 +11543,24 @@ const composeControlAreas = (areas) => ({
  *
  * Returns `defineControlStack` and `composeControlAreas` for consumers building
  * custom control layouts without duplicating the stack-ordering logic already
- * used by `Controls`.
+ * used by `Controls`. Pass area stacks directly to `composeControlAreas` — it
+ * runs `defineControlStack` per area. Use `defineControlStack` on its own when
+ * assembling a single area's `{ controls }` outside `composeControlAreas`.
  *
  * @example
  * ```tsx
- * const { defineControlStack, composeControlAreas } = useControlStack();
+ * const { composeControlAreas } = useControlStack();
  * const controls = composeControlAreas({
- *   navigation: [builtIn.navigation.zoom, builtIn.navigation.fullscreen],
- *   settings: [builtIn.settings.mapStyle],
+ *   navigation: [
+ *     builtIn.navigation.myLocation,
+ *     builtIn.navigation.zoom,
+ *     builtIn.navigation.fullscreen,
+ *   ],
+ *   settings: [
+ *     ...markers.layer.controls.settings ?? [],
+ *     builtIn.settings.mapStyle,
+ *     isAdmin ? adminControl : undefined,
+ *   ],
  * });
  * ```
  */

package/index.esm.js

@@ -1311,7 +1311,7 @@ function useMapAdapterState(adapterConfig) {
  * @returns Tuple of [Map component, API object]
  * @example Basic usage
  * ```tsx
- * import { useMap, Controls } from "@trackunit/react-map";
+ * import { useMap, DefaultControls } from "@trackunit/react-map";
  * import { googleMapsAdapter } from "@trackunit/react-map-adapter-google";
  *
  * const MyMap = () => {
@@ -1322,7 +1322,7 @@ function useMapAdapterState(adapterConfig) {
  *
  *   return (
  *     <Map>
- *       <Controls api={api} />
+ *       <DefaultControls api={api} />
  *     </Map>
  *   );
  * };
@@ -10922,7 +10922,7 @@ const applyPortalZIndex = (container, zIndex) => {
  *
  * return (
  *   <Map>
- *     <Controls api={api} />
+ *     <DefaultControls api={api} />
  *     <Layers api={api} layers={layers} />
  *   </Map>
  * );
@@ -11542,14 +11542,24 @@ const composeControlAreas = (areas) => ({
  *
  * Returns `defineControlStack` and `composeControlAreas` for consumers building
  * custom control layouts without duplicating the stack-ordering logic already
- * used by `Controls`.
+ * used by `Controls`. Pass area stacks directly to `composeControlAreas` — it
+ * runs `defineControlStack` per area. Use `defineControlStack` on its own when
+ * assembling a single area's `{ controls }` outside `composeControlAreas`.
  *
  * @example
  * ```tsx
- * const { defineControlStack, composeControlAreas } = useControlStack();
+ * const { composeControlAreas } = useControlStack();
  * const controls = composeControlAreas({
- *   navigation: [builtIn.navigation.zoom, builtIn.navigation.fullscreen],
- *   settings: [builtIn.settings.mapStyle],
+ *   navigation: [
+ *     builtIn.navigation.myLocation,
+ *     builtIn.navigation.zoom,
+ *     builtIn.navigation.fullscreen,
+ *   ],
+ *   settings: [
+ *     ...markers.layer.controls.settings ?? [],
+ *     builtIn.settings.mapStyle,
+ *     isAdmin ? adminControl : undefined,
+ *   ],
  * });
  * ```
  */

package/package.json

@@ -1,22 +1,22 @@
 {
   "name": "@trackunit/react-map",
-  "version": "0.2.39",
+  "version": "0.2.40",
   "repository": "https://github.com/Trackunit/manager",
   "license": "SEE LICENSE IN LICENSE.txt",
   "engines": {
     "node": ">=24.x"
   },
   "dependencies": {
-    "@trackunit/react-components": "2.3.0",
-    "@trackunit/css-class-variance-utilities": "1.13.85",
-    "@trackunit/react-form-components": "2.3.0",
-    "@trackunit/react-core-hooks": "1.19.0",
-    "@trackunit/geo-json-utils": "1.14.88",
-    "@trackunit/i18n-library-translation": "2.2.0",
+    "@trackunit/react-components": "2.3.1",
+    "@trackunit/css-class-variance-utilities": "1.13.86",
+    "@trackunit/react-form-components": "2.3.1",
+    "@trackunit/react-core-hooks": "1.19.1",
+    "@trackunit/geo-json-utils": "1.14.89",
+    "@trackunit/i18n-library-translation": "2.2.1",
     "react-minimal-pie-chart": "^8.4.0",
-    "@trackunit/react-map-adapter-shared": "0.0.69",
-    "@trackunit/react-map-color-utils": "0.0.54",
-    "@trackunit/ui-design-tokens": "1.13.84",
+    "@trackunit/react-map-adapter-shared": "0.0.70",
+    "@trackunit/react-map-color-utils": "0.0.55",
+    "@trackunit/ui-design-tokens": "1.13.85",
     "@floating-ui/react": "^0.26.25",
     "es-toolkit": "^1.39.10",
     "tailwind-merge": "^2.0.0",

package/src/controls/useControlStack.d.ts

@@ -9,14 +9,24 @@ export type ControlStackHelpers = Readonly<{
  *
  * Returns `defineControlStack` and `composeControlAreas` for consumers building
  * custom control layouts without duplicating the stack-ordering logic already
- * used by `Controls`.
+ * used by `Controls`. Pass area stacks directly to `composeControlAreas` — it
+ * runs `defineControlStack` per area. Use `defineControlStack` on its own when
+ * assembling a single area's `{ controls }` outside `composeControlAreas`.
  *
  * @example
  * ```tsx
- * const { defineControlStack, composeControlAreas } = useControlStack();
+ * const { composeControlAreas } = useControlStack();
  * const controls = composeControlAreas({
- *   navigation: [builtIn.navigation.zoom, builtIn.navigation.fullscreen],
- *   settings: [builtIn.settings.mapStyle],
+ *   navigation: [
+ *     builtIn.navigation.myLocation,
+ *     builtIn.navigation.zoom,
+ *     builtIn.navigation.fullscreen,
+ *   ],
+ *   settings: [
+ *     ...markers.layer.controls.settings ?? [],
+ *     builtIn.settings.mapStyle,
+ *     isAdmin ? adminControl : undefined,
+ *   ],
  * });
  * ```
  */

package/src/core/types.d.ts

@@ -181,7 +181,7 @@ export type MapApi = Readonly<{
  *
  * return (
  *   <Map>
- *     <Controls api={api} />
+ *     <DefaultControls api={api} />
  *   </Map>
  * );
  * ```

package/src/core/useMap.d.ts

@@ -17,7 +17,7 @@ import { type UseMapReturn } from "./types";
  * @returns Tuple of [Map component, API object]
  * @example Basic usage
  * ```tsx
- * import { useMap, Controls } from "@trackunit/react-map";
+ * import { useMap, DefaultControls } from "@trackunit/react-map";
  * import { googleMapsAdapter } from "@trackunit/react-map-adapter-google";
  *
  * const MyMap = () => {
@@ -28,7 +28,7 @@ import { type UseMapReturn } from "./types";
  *
  *   return (
  *     <Map>
- *       <Controls api={api} />
+ *       <DefaultControls api={api} />
  *     </Map>
  *   );
  * };

package/src/layers/Layers.d.ts

@@ -41,7 +41,7 @@ type LayersProps = Readonly<{
  *
  * return (
  *   <Map>
- *     <Controls api={api} />
+ *     <DefaultControls api={api} />
  *     <Layers api={api} layers={layers} />
  *   </Map>
  * );