@trackunit/react-map 0.1.4 → 0.1.6

package/package.json

@@ -1,22 +1,22 @@
 {
   "name": "@trackunit/react-map",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "repository": "https://github.com/Trackunit/manager",
   "license": "SEE LICENSE IN LICENSE.txt",
   "engines": {
     "node": ">=24.x"
   },
   "dependencies": {
-    "@trackunit/react-components": "2.1.23",
-    "@trackunit/css-class-variance-utilities": "1.13.29",
-    "@trackunit/react-form-components": "2.1.24",
-    "@trackunit/react-core-hooks": "1.17.37",
-    "@trackunit/geo-json-utils": "1.14.31",
-    "@trackunit/i18n-library-translation": "2.0.25",
-    "@trackunit/react-modal": "2.1.25",
+    "@trackunit/react-components": "2.1.24",
+    "@trackunit/css-class-variance-utilities": "1.13.30",
+    "@trackunit/react-form-components": "2.1.25",
+    "@trackunit/react-core-hooks": "1.17.38",
+    "@trackunit/geo-json-utils": "1.14.32",
+    "@trackunit/i18n-library-translation": "2.0.26",
+    "@trackunit/react-modal": "2.1.26",
     "react-minimal-pie-chart": "^8.4.0",
-    "@trackunit/react-map-adapter-shared": "0.0.10",
-    "@trackunit/ui-design-tokens": "1.13.29",
+    "@trackunit/react-map-adapter-shared": "0.0.12",
+    "@trackunit/ui-design-tokens": "1.13.30",
     "@floating-ui/react": "^0.26.25",
     "es-toolkit": "^1.39.10",
     "tailwind-merge": "^2.0.0",

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

@@ -41,6 +41,13 @@ export type EdgeAutoPlacementOptions = Readonly<{
     labelPlacementResolver?: EdgeLabelPlacementResolver;
     /** Placement mode. Defaults to `"auto"`. */
     mode?: EdgeAutoPlacementMode;
+    /**
+     * When `true`, the label anchor and rotation angle are computed via great-circle
+     * arc math rather than Mercator straight-line interpolation. Should match
+     * `ShapeStyle.geodesic` so the label tracks the visible curved edge.
+     * Defaults to `false`.
+     */
+    geodesic?: boolean;
 }>;
 export type EdgeAutoPlacementOutcome = Readonly<{
     type: "placed";

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

@@ -17,5 +17,9 @@ export type EdgeComputedProperties = Readonly<{
  * For Polygons, `outwardSide` uses the cross product with the geometry centroid
  * to determine which side faces away from the interior. For LineStrings (no
  * interior), `outwardSide` defaults to `"above"`.
+ *
+ * When `geodesic` is `true`, `angleDeg` is derived from the arc tangent at
+ * the edge midpoint (t = 0.5) via finite difference, so decorations are
+ * rotated correctly relative to the visible curved edge.
  */
-export declare const computeEdgeProperties: (start: GeoJsonPosition, end: GeoJsonPosition, geometry: GeoJsonGeometry, zoom: number, tileSize: number) => EdgeComputedProperties;
+export declare const computeEdgeProperties: (start: GeoJsonPosition, end: GeoJsonPosition, geometry: GeoJsonGeometry, zoom: number, tileSize: number, geodesic?: boolean) => EdgeComputedProperties;

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

@@ -85,6 +85,7 @@ export { isPositionInsideRing as isPointInsideRing } from "@trackunit/geo-json-u
  * the rotated label rectangle when placed on the outward and inward side respectively.
  */
 export type EdgeCandidateInfo = Readonly<{
+    candidateId: number;
     edgeIdx: number;
     edge: EdgeIdentity;
     pxLen: number;
@@ -140,6 +141,15 @@ export type EdgePlacementContext = Readonly<{
      * left than it was on the previous frame ("don't slide back" behaviour).
      */
     previousAnchorClippedT?: number;
+    /**
+     * The `candidateId` of the candidate that `previousAnchorClippedT` was measured
+     * against. With geodesic segmentation a single edge yields multiple candidates
+     * (one per arc segment) that all share the same `edge` identity; `previousAnchorClippedT`
+     * is a fraction along *this specific* candidate's reading frame. The resolver must
+     * pin the label to this same candidate, otherwise the hold fraction would be applied
+     * in a different segment's reading frame and the label would jump.
+     */
+    previousAnchorClippedCandidateId?: number;
     /**
      * The `outwardSide` ("above" | "below") of the label on the previous frame.
      * The default resolver uses this to avoid flipping the label to the other
@@ -161,6 +171,7 @@ export type EdgePlacementContext = Readonly<{
  */
 export type EdgePlacementDecision = Readonly<{
     edgeIdx: number;
+    candidateId?: number;
     side: "outward" | "inward";
     anchorT?: number;
     anchor?: EdgeLabelAnchor;
@@ -229,6 +240,14 @@ export type FindBestEdgePositionConfig = Readonly<{
     labelPlacementResolver?: EdgeLabelPlacementResolver;
     /** True when this is the forced retry pass (minPixelWidth was relaxed to 0). Passed to EdgePlacementContext. */
     isForced?: boolean;
+    /**
+     * When `true`, the anchor geo-position is computed via great-circle interpolation
+     * and `directionPx` uses the arc tangent at that point rather than the straight
+     * Mercator chord direction. Defaults to `false` (Mercator straight-line).
+     *
+     * Set this to match `ShapeStyle.geodesic` so the label tracks the visible arc.
+     */
+    geodesic?: boolean;
 }>;
 /**
  * Default edge-label placement strategy.
@@ -244,4 +263,4 @@ export type FindBestEdgePositionConfig = Readonly<{
  * to the inward side of the edge, which naturally avoids the overflow.
  */
 export declare const defaultEdgeLabelPlacementResolver: (context: EdgePlacementContext) => EdgePlacementDecision | null;
-export declare const findBestEdgePosition: ({ features, viewportBounds, zoom, minPixelWidth, labelPixelWidth, tileSize, maxReadableAngleDeg, previousEdgeIdentity, previousAnchorGeo, previousLayoutSide, edgeInsets, labelAnchor, labelPlacementResolver, isForced, }: FindBestEdgePositionConfig) => EdgePlacement | null;
+export declare const findBestEdgePosition: ({ features, viewportBounds, zoom, minPixelWidth, labelPixelWidth, tileSize, maxReadableAngleDeg, previousEdgeIdentity, previousAnchorGeo, previousLayoutSide, edgeInsets, labelAnchor, labelPlacementResolver, isForced, geodesic, }: FindBestEdgePositionConfig) => EdgePlacement | null;

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

@@ -1,5 +1,5 @@
 import { type GeoJsonBbox, type GeoJsonFeature, type GeoJsonGeometry, type GeoJsonMultiPolygon, type GeoJsonPosition } from "@trackunit/geo-json-utils";
-import type { ShapeStyle } from "@trackunit/react-map-adapter-shared";
+import { type ShapeStyle } from "@trackunit/react-map-adapter-shared";
 import type { ResolveShapeStackOrder } from "./shapeStackOrder";
 /**
  * Pure fill-tiling core for ADR-0021. Given a set of features, the current
@@ -42,6 +42,17 @@ export type FillTilingInput = Readonly<{
      * viewport. They get no `featureToGroupKey` entry so promotion is a no-op.
      */
     suppressedFeatureIds?: ReadonlySet<string>;
+    /**
+     * Layer-level geodesic flag. When `true` (or `undefined`), polygon/line edges
+     * follow great-circle arcs and coordinates are densified before any clip math.
+     * Mirror of `ShapeStyle.geodesic` at the layer level.
+     */
+    layerGeodesic: boolean | undefined;
+    /**
+     * Per-feature style overrides. `geodesic` is read from each entry to determine
+     * whether that feature's edges should be densified (overrides `layerGeodesic`).
+     */
+    featureStyles: ReadonlyMap<string, ShapeStyle> | undefined;
 }>;
 export type FillTilingResult = Readonly<{
     /** Feature id → clipped fill geometry. Only clipped/covered features appear. */
@@ -102,6 +113,17 @@ export declare const shapesUnderCursor: (position: GeoJsonPosition, features: Re
      * = full geometry; null / empty MultiPolygon = no visible fill.
      */
     visibleFillFor?: VisibleFillLookup;
+    /**
+     * Layer-level geodesic flag. When `true` (or `undefined`), edges are
+     * densified before boundary-distance and point-in-polygon checks so stroke
+     * and fill hits follow great-circle arcs.
+     */
+    layerGeodesic: boolean | undefined;
+    /**
+     * Per-feature style overrides; `geodesic` is read per-feature to determine
+     * whether that feature's edges should be densified.
+     */
+    featureStyles: ReadonlyMap<string, ShapeStyle> | undefined;
 }>) => Array<ShapesUnderCursorHit>;
 /**
  * Hover-promotion overlay for one overlap group: the winner renders at full
@@ -110,5 +132,5 @@ export declare const shapesUnderCursor: (position: GeoJsonPosition, features: Re
  * its full geometry — so peer-to-peer overlap ownership from resting tiling is
  * preserved and translucent fills do not compound under the winner.
  */
-export declare const computePromotionGroupFills: (members: ReadonlyArray<GeoJsonFeature>, winnerId: string, restingPeerFills?: ReadonlyMap<string, GeoJsonGeometry>) => ReadonlyMap<string, GeoJsonGeometry>;
+export declare const computePromotionGroupFills: (members: ReadonlyArray<GeoJsonFeature>, winnerId: string, restingPeerFills?: ReadonlyMap<string, GeoJsonGeometry>, layerGeodesic?: boolean | undefined, featureStyles?: ReadonlyMap<string, ShapeStyle> | undefined) => ReadonlyMap<string, GeoJsonGeometry>;
 export declare const computeFillTiling: (input: FillTilingInput) => FillTilingResult;