@trackunit/react-map-adapter-shared 0.0.134 → 0.0.135

package/index.cjs.js

@@ -1109,9 +1109,12 @@ const INITIAL_INTERACTION_STATE = {
 const GEOMETRY_WEIGHT = {
     cluster: 0,
     circle: 1,
-    pill: 2,
-    stick: 3,
+    // Idle band for `stick`; an active (hovered/selected) stick uses `STICK_ACTIVE_WEIGHT` instead.
+    stick: 2,
+    pill: 3,
 };
+/** Band a hovered/selected stick jumps to — above the `pill` (label) band, for interaction-to-front. */
+const STICK_ACTIVE_WEIGHT = 4;
 const PHASE_WEIGHT = {
     expanded: 0,
     idle: 1,
@@ -1120,15 +1123,19 @@ const PHASE_WEIGHT = {
 };
 /** Room for new phases without overlapping the next geometry band. */
 const GEOMETRY_STRIDE = 10;
+const isActivePhase = (phase) => phase === "hovered" || phase === "selected";
 /**
  * Single source of truth for DOM marker portal `z-index` values.
  *
- * Higher geometry tiers always sort above lower tiers regardless of phase
- * (e.g. any `pill` stacks above any `circle`). Within a tier, phase orders
+ * `cluster`, `circle` and `pill` tiers always sort by geometry regardless of phase (any `pill`
+ * stacks above any `circle`). A `stick` is the exception: idle/expanded it sits just below the
+ * `pill` band (so its leader line and anchor pin never cover another label), but hovered/selected it
+ * promotes above the `pill` band (interaction-to-front). Within a band, phase orders
  * expanded → idle → hovered → selected.
  */
 const computeMarkerDomPortalZIndex = (geometry, phase) => {
-    return GEOMETRY_WEIGHT[geometry] * GEOMETRY_STRIDE + PHASE_WEIGHT[phase];
+    const geometryWeight = geometry === "stick" && isActivePhase(phase) ? STICK_ACTIVE_WEIGHT : GEOMETRY_WEIGHT[geometry];
+    return geometryWeight * GEOMETRY_STRIDE + PHASE_WEIGHT[phase];
 };
 
 // ============================================================================

package/index.esm.js

@@ -1107,9 +1107,12 @@ const INITIAL_INTERACTION_STATE = {
 const GEOMETRY_WEIGHT = {
     cluster: 0,
     circle: 1,
-    pill: 2,
-    stick: 3,
+    // Idle band for `stick`; an active (hovered/selected) stick uses `STICK_ACTIVE_WEIGHT` instead.
+    stick: 2,
+    pill: 3,
 };
+/** Band a hovered/selected stick jumps to — above the `pill` (label) band, for interaction-to-front. */
+const STICK_ACTIVE_WEIGHT = 4;
 const PHASE_WEIGHT = {
     expanded: 0,
     idle: 1,
@@ -1118,15 +1121,19 @@ const PHASE_WEIGHT = {
 };
 /** Room for new phases without overlapping the next geometry band. */
 const GEOMETRY_STRIDE = 10;
+const isActivePhase = (phase) => phase === "hovered" || phase === "selected";
 /**
  * Single source of truth for DOM marker portal `z-index` values.
  *
- * Higher geometry tiers always sort above lower tiers regardless of phase
- * (e.g. any `pill` stacks above any `circle`). Within a tier, phase orders
+ * `cluster`, `circle` and `pill` tiers always sort by geometry regardless of phase (any `pill`
+ * stacks above any `circle`). A `stick` is the exception: idle/expanded it sits just below the
+ * `pill` band (so its leader line and anchor pin never cover another label), but hovered/selected it
+ * promotes above the `pill` band (interaction-to-front). Within a band, phase orders
  * expanded → idle → hovered → selected.
  */
 const computeMarkerDomPortalZIndex = (geometry, phase) => {
-    return GEOMETRY_WEIGHT[geometry] * GEOMETRY_STRIDE + PHASE_WEIGHT[phase];
+    const geometryWeight = geometry === "stick" && isActivePhase(phase) ? STICK_ACTIVE_WEIGHT : GEOMETRY_WEIGHT[geometry];
+    return geometryWeight * GEOMETRY_STRIDE + PHASE_WEIGHT[phase];
 };
 
 // ============================================================================

package/migrations/entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry.js","sourceRoot":"","sources":["../../../../../libs/react/map-adapter-shared/migrations/entry.ts"],"names":[],"mappings":"","sourcesContent":["export {};\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trackunit/react-map-adapter-shared",
-  "version": "0.0.134",
+  "version": "0.0.135",
   "repository": "https://github.com/Trackunit/manager",
   "license": "SEE LICENSE IN LICENSE.txt",
   "engines": {

package/src/markerDomPortalStacking.d.ts

@@ -2,8 +2,10 @@ import type { MapTheme } from "./primitiveMapTypes";
 /**
  * Visual role of a DOM portal marker for **global** stacking (z-index) on the map.
  *
- * Ordering (back → front): `cluster` < `circle` < `pill` < `stick`.
- * Cluster DOM is kept behind individual markers so promoted pins stay clickable.
+ * Ordering (back → front): `cluster` < `circle` < idle `stick` < `pill` < active `stick`.
+ * A `stick` is phase-dependent: while idle/expanded it sits below the `pill` (label) band so its
+ * leader line and anchor pin never cover another marker's label; when hovered/selected it promotes
+ * above the label band (interaction-to-front). Cluster DOM stays behind individual markers.
  */
 export type MarkerDomPortalStackGeometry = "circle" | "pill" | "stick" | "cluster";
 /**
@@ -29,8 +31,10 @@ export type DomPortalStackingResolver = (item: unknown, input: DomPortalStacking
 /**
  * Single source of truth for DOM marker portal `z-index` values.
  *
- * Higher geometry tiers always sort above lower tiers regardless of phase
- * (e.g. any `pill` stacks above any `circle`). Within a tier, phase orders
+ * `cluster`, `circle` and `pill` tiers always sort by geometry regardless of phase (any `pill`
+ * stacks above any `circle`). A `stick` is the exception: idle/expanded it sits just below the
+ * `pill` band (so its leader line and anchor pin never cover another label), but hovered/selected it
+ * promotes above the `pill` band (interaction-to-front). Within a band, phase orders
  * expanded → idle → hovered → selected.
  */
 export declare const computeMarkerDomPortalZIndex: (geometry: MarkerDomPortalStackGeometry, phase: MarkerDomPortalStackPhase) => number;