How terra-online/oem-sdk works
Open Endfield Map SDK lets host applications embed an interactive, versioned Endfield map. The main workflow is host configuration into the SDK widget, manifest/resource loading, map creation, feature and point rendering, and interactive results returned through map APIs and events. React wraps the widget lifecycle; hosts can also use the lower-level map package directly. The README documents localization, historical data, coordinate conversion, custom overlays, and clustering. Some subsystem links reflect documented capabilities and directory structure; only sampled source was inspected.
Main entry points: widget.ts Widget lifecycle · oem.ts Map runtime · src/index.ts Map creation · src/index.ts Core utilities
Components 17
Host integration
- React wrapper
packages/react/src/index.tsx - SDK entry
packages/sdk/src/index.ts
Widget experience
- Widget lifecycle
packages/sdk/src/widget.ts - Map controls
packages/sdk/src/components/index.ts - Click-point tool
packages/sdk/src/tools/clickPoints.ts
Map runtime
- Map API
packages/map/src/api.ts - Map creation
packages/map/src/index.ts - Map runtime
packages/map/src/runtime/oem.ts - Resource cache
packages/map/src/runtime/repository.ts - Marker rendering
packages/map/src/atlos/canvas/canvasMarkerSurface.ts - Map configuration
packages/map/src/config.ts
Data and resources
- Core utilities
packages/core/src/index.ts - Manifest validation
packages/core/src/validation.ts - Resource loading
packages/core/src/resources.ts - Coordinate conversion
packages/core/src/coordinates.ts
Other components
- Host application
- OEM map assets
Connections 20
- Host application → SDK entry: configures
- Host application → React wrapper: mounts
- React wrapper → Widget lifecycle: creates and updates
- SDK entry → Widget lifecycle: creates
- Widget lifecycle → Core utilities: loads manifest
- Widget lifecycle → Map creation: creates map
- Widget lifecycle → Map controls: mounts controls
- Widget lifecycle → Map API: delegates commands
- SDK entry → Click-point tool: exposes tool
- Click-point tool → Map API: subscribes and edits points
- Map creation → Core utilities: loads resources
- Map creation → Manifest validation: checks manifest
- Map creation → Map runtime: constructs runtime
- Map runtime → Resource cache: caches loads
- Map runtime → OEM map assets: fetches assets
- Map runtime → Marker rendering: renders markers
- Map runtime → Map configuration: resolves updates
- Core utilities → Resource loading: provides resource helpers
- Core utilities → Coordinate conversion: provides conversions
- Resource loading → OEM map assets: resolves asset URLs