@chrtco/sdk 0.7.6 → 0.8.0

package/CHANGELOG.md

@@ -2,6 +2,16 @@
 
 All notable changes to `@chrtco/sdk` will be documented in this file.
 
+## [0.8.0] — 2026-06-30
+- **Online tile rendering now works end-to-end against `tiles.chrt.co`.** `chrt.transformRequest()` mints a short-lived ES256 tile JWT from your API key (`POST {baseUrl}/mint/tile-token`), caches and refreshes it, and attaches `Authorization: Bearer` on `tiles.chrt.co/v1/tiles/{region}/…/.mvt` requests only. This replaces the previous no-op transformer that injected `x-api-key` against a removed `api.chrt.co/v1/tiles/…?key=` path.
+- **New `chrt.style(opts?)`** — returns a ready-to-use IHO **S-52** MapLibre / Mapbox GL style object (`palette`: `DAY` | `DUSK` | `NIGHT`, plus `region`, `depthUnits`, and the other atlas options), with the tile source wired in. Mutate the returned object, or build a fully custom style over `buildSources()`. S-101 portrayal is on the roadmap.
+- **New `chrt.warmTiles(region?)`** — optionally pre-mint the tile token to surface `region_not_licensed` / `tile_quota_exceeded` before the map loads.
+- **New config options**: `region` (default `NOAA_ENC`) and `tileBaseUrl` (default `https://tiles.chrt.co`).
+- **New exports**: `TileAuth`, `TileTokenError`, and the `TileTokenResponse` / `TileTokenErrorCode` / `ChrtStyleOptions` types.
+- **Deprecated**: `styleUrl()` — CHRT serves no remote `style.json`; it now throws with guidance to use `style()`. `tiles.groups()` — legacy pre-consolidation per-group catalogue. `tiles.tileUrl()` now returns the real `tiles.chrt.co` URL.
+- `TransformRequest.headers` is now optional (matches MapLibre; the transformer omits headers on unauthenticated passthrough).
+- **Requires** the public `POST /v1/mint/tile-token` route on `api.chrt.co` (the sibling of the existing `/v1/mint/offline-token`).
+
 ## [0.7.0] — 2026-05-08
 - **Atlas — dominance cascade & scale-band rendering**: per-feature dominance cascade in continuous mode, cascading band fallback, band-then-class layer emission, chart-mode per-cell cascade fallback to coarser bands, dominance filter on orientation-cross-band labels.
 - **Atlas — cartographic labels**: orientation labels + typography hierarchy.

package/README.md

@@ -37,30 +37,56 @@ const cells = await chrt.cells.list({ source: 'NOAA' });
 const cell = await chrt.cells.get('US5MA11M');
 ```
 
-## Mapbox GL JS / MapLibre
+## Maps (MapLibre GL JS / Mapbox GL JS)
+
+`chrt.style()` returns a ready-to-use IHO **S-52** nautical style; `chrt.transformRequest()`
+mints a short-lived tile token from your API key and attaches it to tile requests
+automatically. Examples use MapLibre — substitute `mapbox-gl` if you're already on Mapbox.
 
 ```typescript
-import mapboxgl from 'mapbox-gl';
+import maplibregl from 'maplibre-gl';
 import { Chrt } from '@chrtco/sdk';
 
 const chrt = new Chrt('chrt_live_...');
 
-const map = new mapboxgl.Map({
+const map = new maplibregl.Map({
   container: 'map',
-  style: chrt.styleUrl(),
+  style: chrt.style({ palette: 'DAY' }),   // 'DAY' | 'DUSK' | 'NIGHT'
   center: [-70.25, 43.66],
   zoom: 12,
   transformRequest: chrt.transformRequest(),
 });
 ```
 
+Tiles are served from `tiles.chrt.co` and gated by a short-lived ES256 JWT. The SDK mints
+it from your key, attaches it as `Authorization: Bearer` on tile requests only, and refreshes
+it before expiry — you never handle tokens directly.
+
+### Custom styles
+
+`chrt.style()` returns a standard MapLibre style object you can mutate. For a fully custom
+look, build your own style over CHRT's vector source with `buildSources()` and keep
+`chrt.transformRequest()` for auth:
+
+```typescript
+import { buildSources } from '@chrtco/sdk';
+
+const sources = buildSources({ region: 'NOAA_ENC' });
+// sources['NOAA_ENC'].tiles → ['https://tiles.chrt.co/v1/tiles/NOAA_ENC/{z}/{x}/{y}.mvt']
+// Each S-57 class (DEPARE, LIGHTS, BOYLAT, …) is a `source-layer` inside that one source.
+```
+
+> S-101 portrayal is on the roadmap; today `chrt.style()` emits S-52.
+
 ## Configuration
 
 ```typescript
 const chrt = new Chrt({
   apiKey: 'chrt_live_...',
-  baseUrl: 'https://api.chrt.co/v1', // default
-  retries: 2,                         // retry on 5xx, default 2
+  baseUrl: 'https://api.chrt.co/v1',     // default
+  retries: 2,                             // retry on 5xx, default 2
+  region: 'NOAA_ENC',                     // default tile region
+  tileBaseUrl: 'https://tiles.chrt.co',   // override for staging tiles
 });
 ```
 
@@ -92,20 +118,27 @@ List available ENC cells.
 ### `chrt.cells.get(cellId)`
 Get metadata for a specific cell.
 
-### `chrt.tiles.styleUrl()`
-Returns a Mapbox/MapLibre-compatible `style.json` URL.
+### `chrt.style(opts?)`
+Returns a ready-to-use MapLibre/Mapbox GL **S-52** style object. Options: `palette`
+(`'DAY'` | `'DUSK'` | `'NIGHT'`), `region`, `depthUnits`, plus the other atlas style options.
 
-### `chrt.tiles.tileUrl(z, x, y)`
-Returns a single vector tile URL.
+### `chrt.transformRequest(opts?)`
+Returns a `transformRequest` that mints a short-lived tile JWT from your API key and attaches
+it as `Authorization: Bearer` on `tiles.chrt.co` requests only. Pass `{ region }` to override
+the default region.
 
-### `chrt.tiles.groups()`
-List available tileset groups.
+### `chrt.warmTiles(region?)`
+Pre-mints the tile token so you can surface auth errors (e.g. `region_not_licensed`,
+`tile_quota_exceeded`) before the map loads. Optional — `transformRequest()` warms the cache
+on its own.
 
-### `chrt.styleUrl()`
-Shortcut for `chrt.tiles.styleUrl()`.
+### `chrt.tiles.tileUrl(z, x, y)`
+Single vector tile URL template at `tiles.chrt.co`. Prefer `chrt.style()`, which wires the
+source for you.
 
-### `chrt.transformRequest()`
-Returns a `transformRequest` function for Mapbox GL / MapLibre that auto-injects the API key.
+### `chrt.styleUrl()` · `chrt.tiles.groups()` — deprecated
+CHRT serves no remote `style.json` — use `chrt.style()`. Tilesets were consolidated to one
+source per region (2026-04), so the per-group catalogue is legacy.
 
 ## Error Handling
 

package/dist/atlas/browser.cjs

@@ -2895,7 +2895,10 @@ var NAUTICAL_SYMBOLS = [
     getSvg: landmarkSpire,
     group: "landmarks",
     description: "Church spire or steeple, conspicuous from seaward. Useful for visual fixing.",
-    s52PlRef: "LNDMRK17",
+    // CATLMK 20 alone has no dedicated PL symbol (renders POSGEN01/03); church spires carry
+    // FUNCTN 20/21 and render as the religious-building symbol BUIREL01 (BUIREL13 when conspicuous)
+    s52PlRef: "BUIREL01",
+    s57Class: "LNDMRK",
     attributeKey: "CATLMK",
     attributeValue: 20,
     renderSize: "32x32",
@@ -2912,9 +2915,11 @@ var NAUTICAL_SYMBOLS = [
     getSvg: landmarkTower,
     group: "landmarks",
     description: "Tower conspicuous from seaward. General-purpose landmark symbol.",
-    s52PlRef: "LNDMRK20",
+    s52PlRef: "TOWERS01",
+    s57Class: "LNDMRK",
     attributeKey: "CATLMK",
     attributeValue: 17,
+    // TOWERS03 = conspicuous variant
     renderSize: "32x32",
     colors: [{ token: "CHBLK", hex: "#000000", usage: "Tower body, cap, position circle" }],
     lineStyles: [{ element: "Tower outline", width: 0.8, color: "#000000" }, { element: "Position circle", width: 0.6, pattern: "2, 2", color: "#000000" }],
@@ -2929,7 +2934,8 @@ var NAUTICAL_SYMBOLS = [
     getSvg: landmarkChimney,
     group: "landmarks",
     description: "Industrial chimney or smokestack visible from the sea.",
-    s52PlRef: "LNDMRK01",
+    s52PlRef: "CHIMNY01",
+    s57Class: "LNDMRK",
     attributeKey: "CATLMK",
     attributeValue: 3,
     renderSize: "32x32",
@@ -2946,7 +2952,8 @@ var NAUTICAL_SYMBOLS = [
     getSvg: landmarkFlagstaff,
     group: "landmarks",
     description: "Flagstaff or flagpole conspicuous from seaward.",
-    s52PlRef: "LNDMRK03",
+    s52PlRef: "FLGSTF01",
+    s57Class: "LNDMRK",
     attributeKey: "CATLMK",
     attributeValue: 5,
     renderSize: "32x32",
@@ -2966,9 +2973,11 @@ var NAUTICAL_SYMBOLS = [
     getSvg: landmarkMonument,
     group: "landmarks",
     description: "Monument or memorial conspicuous from the sea.",
-    s52PlRef: "LNDMRK05",
+    s52PlRef: "MONUMT12",
+    s57Class: "LNDMRK",
     attributeKey: "CATLMK",
     attributeValue: 9,
+    // MONUMT02 = non-conspicuous variant
     renderSize: "32x32",
     colors: [{ token: "CHBLK", hex: "#000000", usage: "Monument body, base, position circle" }],
     lineStyles: [{ element: "Body outline", width: 0.8, color: "#000000" }, { element: "Position circle", width: 0.6, pattern: "2, 2", color: "#000000" }],
@@ -2984,6 +2993,7 @@ var NAUTICAL_SYMBOLS = [
     group: "landmarks",
     description: "Traditional windmill with rotating vanes. Conspicuous landmark.",
     s52PlRef: "WNDMIL12",
+    s57Class: "LNDMRK",
     attributeKey: "CATLMK",
     attributeValue: 18,
     renderSize: "32x32",
@@ -3001,6 +3011,7 @@ var NAUTICAL_SYMBOLS = [
     group: "landmarks",
     description: "Modern 3-blade wind turbine. Increasingly common offshore landmark.",
     s52PlRef: "WIMCON11",
+    s57Class: "LNDMRK",
     attributeKey: "CATLMK",
     attributeValue: 19,
     renderSize: "32x32",
@@ -3017,9 +3028,11 @@ var NAUTICAL_SYMBOLS = [
     getSvg: landmarkDome,
     group: "landmarks",
     description: "Dome or cupola (e.g., observatory, mosque) visible from the sea.",
-    s52PlRef: "LNDMRK03",
+    s52PlRef: "DOMES011",
+    s57Class: "LNDMRK",
     attributeKey: "CATLMK",
     attributeValue: 15,
+    // DOMES001 = non-conspicuous variant
     renderSize: "32x32",
     colors: [{ token: "CHBLK", hex: "#000000", usage: "Dome, base, position circle" }],
     lineStyles: [{ element: "Base outline", width: 0.8, color: "#000000" }, { element: "Dome curve", width: 0.8, color: "#000000" }, { element: "Position circle", width: 0.6, pattern: "2, 2", color: "#000000" }],
@@ -3034,7 +3047,8 @@ var NAUTICAL_SYMBOLS = [
     getSvg: landmarkRadarScanner,
     group: "landmarks",
     description: "Radar scanner antenna conspicuous from seaward.",
-    s52PlRef: "LNDMRK12",
+    s52PlRef: "RASCAN01",
+    s57Class: "LNDMRK",
     attributeKey: "CATLMK",
     attributeValue: 16,
     renderSize: "32x32",
@@ -3051,7 +3065,8 @@ var NAUTICAL_SYMBOLS = [
     getSvg: landmarkDishAerial,
     group: "landmarks",
     description: "Satellite dish or parabolic antenna visible from the sea.",
-    s52PlRef: "LNDMRK12",
+    s52PlRef: "DSHAER01",
+    s57Class: "LNDMRK",
     attributeKey: "CATLMK",
     attributeValue: 4,
     renderSize: "32x32",
@@ -3069,6 +3084,7 @@ var NAUTICAL_SYMBOLS = [
     group: "landmarks",
     description: "Water tower. Elevated tank on supporting structure, conspicuous landmark.",
     s52PlRef: "TOWERS12",
+    s57Class: "SILTNK",
     attributeKey: "CATSIL",
     attributeValue: 4,
     renderSize: "32x32",
@@ -3085,7 +3101,9 @@ var NAUTICAL_SYMBOLS = [
     getSvg: landmarkRadioTvMast,
     group: "landmarks",
     description: "Radio or television transmission mast with horizontal cross-arms.",
-    s52PlRef: "LNDMRK10",
+    // Radio/TV masts are CATLMK 7 (mast) + FUNCTN in S-57, so both mast entries share MSTCON04
+    s52PlRef: "MSTCON04",
+    s57Class: "LNDMRK",
     attributeKey: "CATLMK",
     attributeValue: 7,
     renderSize: "32x32",
@@ -3102,7 +3120,10 @@ var NAUTICAL_SYMBOLS = [
     getSvg: landmarkCross,
     group: "landmarks",
     description: "Religious cross or calvary conspicuous from seaward.",
-    s52PlRef: "LNDMRK05",
+    // The PL has no dedicated symbol for CATLMK 14 (cross/calvary) — S-52 falls back to the
+    // generic position symbol POSGEN01 (POSGEN03 when conspicuous)
+    s52PlRef: "POSGEN01",
+    s57Class: "LNDMRK",
     attributeKey: "CATLMK",
     attributeValue: 14,
     renderSize: "32x32",
@@ -3119,9 +3140,11 @@ var NAUTICAL_SYMBOLS = [
     getSvg: landmarkMast,
     group: "landmarks",
     description: "General mast (not radio/TV). Pole with spherical top.",
-    s52PlRef: "LNDMRK10",
+    s52PlRef: "MSTCON04",
+    s57Class: "LNDMRK",
     attributeKey: "CATLMK",
     attributeValue: 7,
+    // MSTCON14 = conspicuous variant
     renderSize: "32x32",
     colors: [{ token: "CHBLK", hex: "#000000", usage: "Mast pole, top ball, position circle" }],
     lineStyles: [{ element: "Mast pole", width: 2, color: "#000000" }, { element: "Position circle", width: 0.6, pattern: "2, 2", color: "#000000" }],
@@ -3137,6 +3160,7 @@ var NAUTICAL_SYMBOLS = [
     group: "landmarks",
     description: "Silo, grain elevator, or storage tank conspicuous from the sea.",
     s52PlRef: "SILBUI01",
+    s57Class: "SILTNK",
     attributeKey: "CATSIL",
     attributeValue: 1,
     renderSize: "32x32",