@trackunit/react-map-draw
v0.0.37
Published
Provider-agnostic **polygon drawing engine** for the `@trackunit/react-map` family (ADR 0030). It implements the `DrawPort` contract from `@trackunit/react-map-adapter-shared` on top of [Terra Draw](https://terradraw.io), so the Google Maps and Mapbox GL
Keywords
Readme
@trackunit/react-map-draw
Provider-agnostic polygon drawing engine for the @trackunit/react-map family (ADR 0030). It implements the DrawPort contract from @trackunit/react-map-adapter-shared on top of Terra Draw, so the Google Maps and Mapbox GL adapters share one drawing implementation and only contribute a thin bridge each.
Installation
npm install @trackunit/react-map-drawYou normally do not install this package directly: @trackunit/react-map-adapter-google and @trackunit/react-map-adapter-mapbox depend on it. Feature code uses useDraw(api) from @trackunit/react-map and never sees Terra Draw.
What lives here
DrawController— theDrawPortimplementation. Holds the controlledmodeandvalue, notifies subscribers, and lazily loads the Terra Draw engine the first time drawing is needed. On every adapter reconnect (Google Maps recreates the map on theme and traffic changes; Mapbox GL drops custom layers onsetStyle) the controller rebuilds the engine from the committed value.loadTerraDrawEngine— dynamic-imports Terra Draw and wires polygon and select modes, styling, and the committed-value change pipeline. Adapters call it with a Terra Draw provider adapter built from their native map object.normalizeDrawValue/drawValuesEqual— value hygiene shared by the controller and the engine: only single-ringPolygonfeatures are kept.
Dependency graph
@trackunit/react-map-adapter-google → @trackunit/react-map-draw → terra-draw
@trackunit/react-map-adapter-mapbox → @trackunit/react-map-draw → @trackunit/react-map-adapter-sharedThis package never imports a map adapter or a provider SDK. Terra Draw itself is only loaded through a dynamic import() when a map enters a drawing mode or receives a non-empty value, so consumers that never draw never download it.
Part of the @trackunit/react-map family
| Package | Description |
| --- | --- |
| @trackunit/react-map | Core provider-agnostic map library |
| @trackunit/react-map-adapter-google | Google Maps adapter |
| @trackunit/react-map-adapter-mapbox | Mapbox GL adapter |
| @trackunit/react-map-adapter-shared | Shared adapter contracts and utilities |
| @trackunit/react-map-draw | Shared drawing engine (this package) |
For more info and a full guide on Iris App SDK Development, please visit our Developer Hub.
Trackunit
This package was developed by Trackunit ApS. Trackunit is the leading SaaS-based IoT solution for the construction industry, offering an ecosystem of hardware, fleet management software & telematics.
