Packages

All packages are published under the @studnicky scope to the GitHub Package Registry.

@studnicky:registry=https://npm.pkg.github.com

Core resolution and primitives

Package	Description
@studnicky/geo-resolver	Multi-modal geo resolution: address, IP, coordinate, and phone-based location lookup with country/timezone/locale detail
@studnicky/spatial	Zero-dependency spatial primitives: point-in-polygon, bounding-box zone index, grid-based nearest-neighbor search
@studnicky/time-conversion	Allocation-free epoch/ISO date conversion using integer civil-calendar arithmetic
@studnicky/grid-schemes	GridSchemeInterface contract plus the GeohashScheme implementation for spatial indexing and coverage queries

Data pipeline

Package	Description
@studnicky/geo-artifact-codec	Generic N-field binary artifact codec (GAC1 bit-packed cell tables, GACO adaptive-depth override trees)
@studnicky/geo-adapters	Source-fetching adapters for external geo and administrative-boundary data (Natural Earth, US Census TIGER, country-coder, IANA tzdata)
@studnicky/geo-data-builder	Builds the geohash-indexed timezone/country/water-body artifact geo-resolver ships

Administrative layers

Each layer is an independently-loadable package — install only what you need. Bundled default() artifacts are documented, synthetic placeholders for development/testing; a real production table requires running each package's generate script against live data.

Package	Description
@studnicky/geo-layer-state	State/province lookup (Natural Earth admin-1, global coverage)
@studnicky/geo-layer-county	County/parish lookup (US Census TIGER, US-only)
@studnicky/geo-layer-postal	Postal/ZCTA lookup (US Census TIGER, US-only)
@studnicky/geo-layer-voting-district	Congressional district lookup (US Census TIGER, US-only)