LocusLocation intelligence toolkit for TypeScript.
A toolkit for location intelligence: multi-modal geo resolution, spatial primitives, pluggable grid systems, and geohash-indexed administrative-layer lookups.
Skip to content
See it resolve your own location
Core resolution and primitives
@studnicky/geo-resolverMulti-modal geo resolution: address, IP, coordinate, and phone-based location lookup with country/timezone/locale detail. Exposes both a discoverable Geo static surface and granular tree-shakeable primitives.@studnicky/spatialZero-dependency spatial primitives: point-in-polygon, bounding-box zone index, grid-based nearest-neighbor search, named-feature-collection resolution.@studnicky/time-conversionAllocation-free epoch/ISO date conversion using integer civil-calendar arithmetic.@studnicky/grid-schemesGridSchemeInterface contract plus four implementations — GeohashScheme, H3Scheme, S2Scheme, MgrsScheme (encode/decode, covering(), bbox tiling). Grid systems are swappable, not hardcoded.
Data pipeline
@studnicky/geo-artifact-codecGeneric N-field binary artifact codec (GAC1 bit-packed cell tables, GACO adaptive-depth override trees) that any per-layer builder can encode/decode against, independent of field count or shape.@studnicky/geo-adaptersSourceAdapterInterface and AdministrativeSystemAdapterInterface contracts, plus concrete adapters (Natural Earth, US Census TIGER, country-coder, IANA tzdata) for fetching the source-of-truth data every builder consumes.@studnicky/geo-data-builderBuilds the geohash-indexed timezone/country/water-body artifact geo-resolver ships, with adaptive-depth descent and bit-packed encoding options.
Administrative layers
@studnicky/geo-layer-stateState/province lookup (Natural Earth admin-1, global coverage).@studnicky/geo-layer-countyCounty/parish lookup (US Census TIGER, US-only).@studnicky/geo-layer-postalPostal/ZCTA lookup (US Census TIGER, US-only).@studnicky/geo-layer-voting-districtCongressional district lookup (US Census TIGER, US-only).
Locus is a toolkit, not a fixed dataset. Consumers pick the grid system and the administrative layers they need; the data-builder pipeline composes artifacts from pluggable source adapters; the runtime lookups stay agnostic to both.
Multi-modal resolution. @studnicky/geo-resolver fuses address, IP, coordinate, and phone-based signals into one higher-confidence location result, weighting each modality and back-filling empty fields from lower-weight candidates.
Swappable grid systems. @studnicky/grid-schemes defines a GridSchemeInterface contract implemented by geohash, S2, H3, and MGRS — so the data-builder and runtime decoder never hardcode one choice.
No layer is mandatory. Administrative layers (state, county, postal, voting district) are independently-loadable packages. A consumer building for a single country doesn't pay for congressional-district data they'll never query.
See Architecture for the full grid-system, data-layer, and source-adapter design.