@trackunit/react-map 0.1.22 → 0.1.25

package/package.json

@@ -1,23 +1,23 @@
 {
   "name": "@trackunit/react-map",
-  "version": "0.1.22",
+  "version": "0.1.25",
   "repository": "https://github.com/Trackunit/manager",
   "license": "SEE LICENSE IN LICENSE.txt",
   "engines": {
     "node": ">=24.x"
   },
   "dependencies": {
-    "@trackunit/react-components": "2.1.33",
-    "@trackunit/css-class-variance-utilities": "1.13.37",
-    "@trackunit/react-form-components": "2.1.35",
-    "@trackunit/react-core-hooks": "1.17.46",
-    "@trackunit/geo-json-utils": "1.14.40",
-    "@trackunit/i18n-library-translation": "2.0.34",
-    "@trackunit/react-modal": "2.1.36",
+    "@trackunit/react-components": "2.1.36",
+    "@trackunit/css-class-variance-utilities": "1.13.40",
+    "@trackunit/react-form-components": "2.1.38",
+    "@trackunit/react-core-hooks": "1.17.49",
+    "@trackunit/geo-json-utils": "1.14.43",
+    "@trackunit/i18n-library-translation": "2.0.37",
+    "@trackunit/react-modal": "2.1.39",
     "react-minimal-pie-chart": "^8.4.0",
-    "@trackunit/react-map-adapter-shared": "0.0.21",
-    "@trackunit/react-map-color-utils": "0.0.6",
-    "@trackunit/ui-design-tokens": "1.13.37",
+    "@trackunit/react-map-adapter-shared": "0.0.24",
+    "@trackunit/react-map-color-utils": "0.0.9",
+    "@trackunit/ui-design-tokens": "1.13.40",
     "@floating-ui/react": "^0.26.25",
     "es-toolkit": "^1.39.10",
     "tailwind-merge": "^2.0.0",

package/src/cursor/useEntitiesNearCursor.d.ts

@@ -0,0 +1,36 @@
+import type { GeoJsonPosition, MapApi } from "../core/types";
+/**
+ * A point entity that can be tested against the cursor. `position` is the
+ * geographic anchor as `[lng, lat]`.
+ */
+export type EntityNearCursor = Readonly<{
+    id: string;
+    position: GeoJsonPosition;
+}>;
+export type UseEntitiesNearCursorOptions = Readonly<{
+    /** The point entities to hit-test against the cursor on every move. */
+    entities: ReadonlyArray<EntityNearCursor>;
+    /** Hit radius around the cursor, in CSS pixels. */
+    radiusPx: number;
+}>;
+/**
+ * The **Entities Near Cursor** primitive: returns a referentially-stable
+ * `ReadonlySet<string>` of entity ids whose projected position is within
+ * `radiusPx` CSS pixels of the projected cursor, nearest-first.
+ *
+ * It is the point-marker counterpart to **Shapes Under Cursor** and runs on the
+ * same pure Web Mercator substrate (`@trackunit/geo-json-utils`) fed by
+ * `useCameraState` + the RAF-throttled `pointermove` event — adapter-agnostic by
+ * construction (see ADR-0025). The hook owns radius geometry only; consumers
+ * decide why the ids are wanted (preload, highlight, …) and may cap the set to
+ * the nearest N via iteration order.
+ *
+ * The returned Set keeps a stable identity until either its membership or its
+ * nearest-first ordering changes, so wiring it straight into a memo or query
+ * does not churn while the cursor drifts within the same cluster of dots at the
+ * same relative distances. The host only re-renders when membership or ordering
+ * actually changes: the cursor lives in a ref and recomputes commit through an
+ * order-sensitive functional update that bails out (returns the previous Set)
+ * when nothing changed.
+ */
+export declare const useEntitiesNearCursor: (api: MapApi, options: UseEntitiesNearCursorOptions) => ReadonlySet<string>;

package/src/index.d.ts

@@ -38,6 +38,7 @@ export { MARKER_TUNING } from "./markers/model/markerTuningParams";
 export { cvaMapMarker, cvaMarkerIndicator } from "./markers/shared/mapMarkerVariants";
 export { MARKER_DARK_PILL, MARKER_LIGHT_PILL } from "./markers/shared/markerColors";
 export type { MarkerColorConfig, MarkerColorCssVars, ResolvedMarkerColors } from "./markers/shared/markerColors";
+export { useEntitiesNearCursor, type EntityNearCursor, type UseEntitiesNearCursorOptions, } from "./cursor/useEntitiesNearCursor";
 export { type HoverPanelPreloadInitiator, type PanelPreloadInitiator, type PanelPreloadInitiatorType, type ProximityPanelPreloadInitiator, } from "./panel/preload/preloadInitiators";
 export { usePanelPreload, type UsePanelPreloadOptions } from "./panel/preload/usePanelPreload";
 export { type PanelStore } from "./panel/store/panels";
@@ -46,7 +47,7 @@ export { type AutoPanContext, type AutoPanResult } from "./panel/utils/autoPan";
 export type { DecorationAnchor, EdgeSide, ShapeDecoration } from "./layers/useShapes/shapeDecorations";
 export { type AnnotationContext, type ShapeLabelPolicy } from "./layers/useShapes/shapeLabelPolicy";
 export type { ResolveShapeLabel, ShapeLabelResolution, ShapeLabelResolutionContext, } from "./layers/useShapes/shapeLabelResolution";
-export { type ContendedShape, type ResolveShapeStackOrder, type ShapeStackContext, } from "./layers/useShapes/shapeStackOrder";
+export { type ContendedShape, type ResolveShapeStackOrder } from "./layers/useShapes/shapeStackOrder";
 export { useImageOverlay, type UseImageOverlayOptions, type UseImageOverlayReturn, } from "./layers/image-overlay/useImageOverlay";
 export { buildExpandedIds, useExpandedIds, type MapFocus, type MapFocusTier, type MapFocusTierDisplay, } from "./layers/mapFocus";
 export { useRoute, type UseRouteOptions, type UseRouteReturn } from "./layers/routes/useRoute";

package/src/layers/shared/measureLabelWidth.d.ts

@@ -1,11 +1,13 @@
 /**
- * Measure the rendered pixel width of label text using an off-screen probe
- * styled with the same CSS classes as shape edge labels (`cvaShapeLabel`).
+ * Measure the rendered pixel width of label text using a Canvas context configured
+ * with the same font as shape edge labels (`cvaShapeLabel` / `ShapeLabelPill`).
  *
- * Shape edge labels and other layout utilities that need a DOM-measured width use this.
+ * Results are cached per label text. Using Canvas.measureText avoids the forced
+ * synchronous layout (reflow) that getBoundingClientRect triggers when called inside
+ * a Google Maps onDraw callback — the previous implementation caused ~67ms of blocked
+ * main-thread time per draw cycle during zoom (observed in Chrome DevTools trace).
  *
- * Results are cached per label text. In environments where DOM measurement is
- * unavailable or returns zero (SSR, jsdom), falls back to a character-count
- * estimate (label.length * 6 + 16).
+ * Falls back to DOM measurement if canvas is unavailable, and to a character-count
+ * estimate in environments without DOM (SSR, jsdom).
  */
 export declare const measureLabelWidth: (label: string) => number;

package/src/layers/useShapes/buildShapeLabelResolutionContext.d.ts

@@ -2,14 +2,13 @@ import { type GeoJsonBbox, type GeoJsonFeature } from "@trackunit/geo-json-utils
 import type { MapInteractionState } from "@trackunit/react-map-adapter-shared";
 import type { ShapeLabelResolutionContext } from "./shapeLabelResolution";
 /**
- * Build the per-feature, per-frame context passed to an `edge-auto` anchor's
- * `resolveLabel` callback. Pure: no React, no `api` reads — caller supplies the
- * already-projected viewport bits, the precomputed `shapesInViewport` count for
- * the layer, and the current interaction state.
+ * Build the per-feature, per-frame context passed to viewport-aware shape
+ * callbacks. Pure: no React, no `api` reads — caller supplies the already-
+ * projected viewport bits, the precomputed `shapesInViewport` count for the
+ * layer, a lazy overlap count, and the current interaction state.
  *
  * Lives next to `shapeLabelResolution.ts` and is consumed by
- * `useShapeDecorations` once per feature that has at least one `edge-auto`
- * decoration, before any placement work runs.
+ * `useShapeDecorations` once per feature, before any placement work runs.
  */
 export declare const buildShapeLabelResolutionContext: (feature: GeoJsonFeature, args: Readonly<{
     handleId: string;
@@ -18,6 +17,6 @@ export declare const buildShapeLabelResolutionContext: (feature: GeoJsonFeature,
     zoom: number;
     tileSize: number;
     shapesInViewport: number;
-    overlappingShapesCount: number;
+    getOverlappingShapesCount: () => number;
     interaction: MapInteractionState;
 }>) => ShapeLabelResolutionContext | null;

package/src/layers/useShapes/edge/findBestEdgePosition.d.ts

@@ -39,8 +39,6 @@ export type EdgeInsets = Readonly<{
 export declare const clipSegmentToRect: (x0: number, y0: number, x1: number, y1: number, xMin: number, yMin: number, xMax: number, yMax: number) => ClippedSegment | null;
 export { extractEdges } from "@trackunit/geo-json-utils";
 export { computeGeometryCentroid } from "@trackunit/geo-json-utils";
-export declare const lngLatToWebMercatorPx: (lng: number, lat: number, zoom: number, tileSize?: number) => readonly [number, number];
-export declare const webMercatorPxToLngLat: (px: number, py: number, zoom: number, tileSize?: number) => readonly [number, number];
 /**
  * Compute the screen-space angle (in degrees) of a line segment, accounting for
  * Web Mercator distortion. Normalized to [-90, 90] so text reads left-to-right.
@@ -60,11 +58,6 @@ export declare const edgeScreenAngleDeg: (x0: number, y0: number, x1: number, y1
  * Latitude pixels scale by sec(lat).
  */
 export declare const edgePixelLength: (x0: number, y0: number, x1: number, y1: number, zoom: number, midLatDeg: number, tileSize?: number) => number;
-/**
- * Convert a pixel distance to latitude degrees at a given zoom level,
- * accounting for Web Mercator latitude distortion.
- */
-export declare const pixelsToLatDegrees: (pixels: number, zoom: number, latDeg: number, tileSize?: number) => number;
 /**
  * Determine which side of an edge the geometry interior lies on, in screen space.
  * Returns "above" if the label should extend above the edge (interior is below),

package/src/layers/useShapes/shapeFillTiling.d.ts

@@ -29,7 +29,6 @@ export type FillTilingInput = Readonly<{
     /** Only features whose bbox intersects this are considered. */
     viewportBounds: GeoJsonBbox;
     resolveStackOrder: ResolveShapeStackOrder;
-    zoom: number;
     /**
      * Feature id that is currently selected. Selection forces the feature to the
      * top of its overlap group, overriding resting order. Takes highest priority.

package/src/layers/useShapes/shapeStackOrder.d.ts

@@ -12,22 +12,15 @@ export type ContendedShape = Readonly<{
     /** IDs of other contended shapes that fully contain this one. */
     containedIn: ReadonlyArray<string>;
 }>;
-/**
- * Context for a single resolve pass.
- */
-export type ShapeStackContext = Readonly<{
-    /** Current map zoom level. */
-    zoom: number;
-}>;
 /**
  * Decides fill ownership for a set of overlapping shapes. Returns the contended
  * feature IDs ordered **top-first** — the first ID owns shared pixels, later
  * IDs are clipped against the winners ahead of them.
  *
- * Pure: same inputs must yield the same ordering. Swappable per-layer via the
- * `overlap.resolveStackOrder` option on `useShapes`.
+ * Pure and zoom-invariant: same contended shapes must yield the same ordering.
+ * Swappable per-layer via the `overlap.resolveStackOrder` option on `useShapes`.
  */
-export type ResolveShapeStackOrder = (contended: ReadonlyArray<ContendedShape>, ctx: ShapeStackContext) => ReadonlyArray<string>;
+export type ResolveShapeStackOrder = (contended: ReadonlyArray<ContendedShape>) => ReadonlyArray<string>;
 /**
  * Default stack-order policy (ADR-0021 "golden path"). In priority order:
  *

package/src/markers/shared/mapMarkerVariants.d.ts

@@ -8,9 +8,9 @@
  * both states. The inner indicator disc (`cvaMarkerIndicator` below) carries
  * its own per-size `h-* w-*`; the outer surface sizes intrinsically around it.
  *
- * `transition-all` enables the morph; the duration and timing-function are
- * applied inline from `MARKER_TUNING.animation` so the spring config remains
- * the single source of truth (no stale `duration-200 ease-in-out` here).
+ * `transitionProperty` is set inline in `MapMarker.tsx` to list only the
+ * properties that need to animate, intentionally excluding `width` to prevent
+ * non-composited layout thrashing. See `MarkerAnimatedSurface.tsx` for details.
  */
 export declare const cvaMapMarker: (props?: import("class-variance-authority/types").ClassProp | undefined) => string;
 /**