@chrtco/sdk 0.10.46 → 0.10.47

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { F as FileSystemAdapter } from './fs-adapter-D5iwdb1Q.js';
-import { C as ColorTableName } from './symbol-families-D2Kx20HJ.js';
-export { S as S52_COLORS, a as S52_DAY, b as S52_DUSK, c as S52_NIGHT, d as SYMBOL_FAMILIES, e as SYMBOL_FAMILY_META, f as SymbolFamily, g as SymbolFamilyMeta, h as getColorTable, i as iconExpressionForFamily, p as parseSymbolFamily, r as resolveColor } from './symbol-families-D2Kx20HJ.js';
+import { C as ColorTableName } from './symbol-families-De7sN-p5.js';
+export { E as EINK_COLOR_TABLES, a as EINK_MONO_GREYS, S as S52_COLORS, b as S52_DAY, c as S52_DUSK, d as S52_EINK_COLOR, e as S52_EINK_MONO, f as S52_EINK_NIGHT, g as S52_NIGHT, h as SYMBOL_FAMILIES, i as SYMBOL_FAMILY_META, j as SymbolFamily, k as SymbolFamilyMeta, l as getColorTable, m as iconExpressionForFamily, n as isEinkColorTable, o as isEinkGreyTable, p as parseSymbolFamily, r as resolveColor } from './symbol-families-De7sN-p5.js';
 import maplibregl from 'maplibre-gl';
 import { ExpressionSpecification } from '@maplibre/maplibre-gl-style-spec';
 
@@ -862,8 +862,10 @@ interface OfflineHeartbeatOptions {
  * from `GET /v1/offline/styles/{region}`.
  */
 interface OfflineFetchStyleOptions {
-    /** S-52 colour palette. Default: `"DAY"`. */
-    palette?: "DAY" | "DUSK" | "NIGHT";
+    /** Colour palette. Default: `"DAY"`. `"EINK_COLOR"` / `"EINK_MONO"` are
+     *  the e-paper variants (colour and monochrome e-ink); `"EINK_NIGHT"` is
+     *  e-ink at night. */
+    palette?: "DAY" | "DUSK" | "NIGHT" | "EINK_COLOR" | "EINK_MONO" | "EINK_NIGHT";
     /**
      * URL scheme baked into the source. Default: `"mbtiles"` (iOS/Android via
      * MLN Native). Use `"file"` for desktop (Win/macOS/Linux).
@@ -894,7 +896,7 @@ interface OfflineFetchStyleOptions {
  */
 interface OfflineStyleResponse {
     region: string;
-    palette: "DAY" | "DUSK" | "NIGHT";
+    palette: "DAY" | "DUSK" | "NIGHT" | "EINK_COLOR" | "EINK_MONO" | "EINK_NIGHT";
     protocol: "mbtiles" | "file";
     /** Resolved symbol-artwork family (lowercased), echoed from `?symbols=`. */
     symbols?: ChrtSymbolSet;
@@ -1558,12 +1560,20 @@ declare class TileAuth {
 
 /** Symbol-artwork families served by the Style API. */
 type ChrtSymbolSet = "s52" | "s101" | "chrt" | "raster";
-/** Palette themes served by the Style API (S-52 colour tables). */
-type ChrtStyleTheme = "day" | "dusk" | "night";
+/**
+ * Palette themes served by the Style API: the S-52 colour tables (`day`,
+ * `dusk`, `night`) and CHRT's e-paper variants — `eink_color` for colour
+ * e-ink (E Ink Kaleido 3) and `eink_mono` for monochrome e-ink panels and
+ * monitors, `eink_night` for any e-ink screen at night (a black page). The
+ * e-ink themes change portrayal as well as colour (heavier
+ * lines, a heavy safety contour, depth steps by pattern in mono).
+ */
+type ChrtStyleTheme = "day" | "dusk" | "night" | "eink_color" | "eink_mono" | "eink_night";
 interface StyleUrlOptions {
-    /** Palette: "day" (default), "dusk", or "night". Omit to get the style's
-     *  default — for keys with a bound CHRTstyle custom style, that's the
-     *  style's default palette. */
+    /** Palette: "day" (default), "dusk", "night", "eink_color", "eink_mono"
+     *  or "eink_night". Omit to get the style's default — for keys with a bound
+     *  CHRTstyle custom style, that's the style's default palette (the e-ink
+     *  themes are always available, bound style or not). */
     theme?: ChrtStyleTheme;
     /** Symbol-artwork family: `s52` (default PresLib set), `s101` (official
      *  S-101 Portrayal Catalogue symbols), `chrt` (the CHRT house set), or
@@ -2822,1321 +2832,1379 @@ declare class InteractClient {
 }
 
 /**
- * Light arithmetic for the chart palettes: how much light a colour emits, and
- * how to dim a colour without changing its hue.
- *
- * Everything here works in LINEAR light (WCAG 2.x relative luminance, sRGB
- * primaries). That is the quantity a dark-adapted eye responds to, and it is
- * the one `sounding-legibility.test.ts` already measures soundings in. Scaling
- * the sRGB-ENCODED channels instead would dim dark colours far more than
- * bright ones and shift every hue it touched.
+ * Post-consolidation (2026-04): one consolidated PMTiles per region, all
+ * S-57 classes as distinct MVT layers inside. The MapLibre style emits one
+ * vector source (id = region) and N paint layers that reference it via
+ * `source-layer` = S-57 class name.
  *
- * The one derivation the palettes rely on, and the reason this file exists:
- * NIGHT's deeper sounding SNDG1 (#897350) is SNDG2 (#c8aa78) at 43% of its
- * linear light. `labels.ts` builds its NIGHT secondary text the same way, so
- * the two stay one family by construction rather than by two hand-typed hexes
- * that happen to agree.
- */
-/** WCAG 2.x relative luminance of a `#rrggbb` colour, 0 (black) to 1 (white). */
-declare function relativeLuminance(hex: string): number;
-/** WCAG 2.x contrast ratio between two `#rrggbb` colours, 1 to 21. */
-declare function contrastRatio(a: string, b: string): number;
-/**
- * The same hue at `factor` times its linear light. `factor` above 1 can clip a
- * channel, which shifts the hue; nothing in the palettes brightens, so callers
- * pass 0–1.
- */
-declare function scaleLinearLight(hex: string, factor: number): string;
-/**
- * `hex` dimmed, hue kept, until its luminance is at most `ceiling`. A colour
- * already at or under the ceiling comes back unchanged (lower-cased).
+ * `buildSources()` returns either the legacy Mapbox MTS shape (preserved for
+ * demos / external style export — see generateStyle comments) or the PMTiles
+ * shape pointing at a single tile URL per region.
  */
-declare function capLuminance(hex: string, ceiling: number): string;
+/** Vector source emitted for the legacy Mapbox MTS path. */
+interface MapboxVectorSource {
+    type: "vector";
+    url: string;
+}
 /**
- * NIGHT's two ink levels, shared by every family's text and marks.
- *
- *   `NIGHT_INK`        S52_NIGHT.CHBLK — the palette's linework and navigation
- *                      text. The brightest thing NIGHT draws on purpose.
- *   `NIGHT_MUTED_INK`  that ink at 43% of its linear light, which is how
- *                      S52_NIGHT.SNDG1 (the deeper soundings) was derived.
- *                      Everything that orients rather than navigates is drawn
- *                      at or under this, and `night-luminance.test.ts` holds
- *                      every visible NIGHT colour to it unless an exemption
- *                      names a reason.
+ * Vector source emitted for the tiles.chrt.co PMTiles path. Uses an explicit
+ * `tiles` array (not a TileJSON `url`) because the tile-worker serves raw MVT
+ * bytes without a TileJSON descriptor.
  */
-declare const NIGHT_INK: string;
-declare const NIGHT_MUTED_INK: string;
-
+interface PmtilesVectorSource {
+    type: "vector";
+    tiles: string[];
+    minzoom: number;
+    maxzoom: number;
+    /** The credit a renderer shows for this source (MapLibre's attribution control). */
+    attribution?: string;
+}
 /**
- * Is this MapLibre map still there to be written to?
- *
- * ===========================================================================
- * ⚠ ASK AFTER EVERY AWAIT. A MAP CAN BE REMOVED WHILE YOU WERE WAITING.
- * ===========================================================================
- *
- * `map.remove()` deletes `map.style`, and after that nearly every method that
- * touches the style throws rather than returning: `hasImage`, `addImage`,
- * `updateImage`, `getSource`, `addLayer` all fail with "Cannot read properties
- * of undefined (reading 'getImage')" and its siblings. Code that was handed a
- * map, awaited a decode, an IndexedDB read or a fetch, and then wrote to the
- * map, throws from wherever it resumed — usually a promise nobody is awaiting,
- * so the throw is an uncaught error with no caller to explain it.
- *
- * Measured in CHRTdesktop (chip 63, 2026-10-04): with the page's main thread
- * held at 6× CPU, the chart removed its map in the middle of a pan, and the
- * S-52 image loader resumed onto it:
- *
- *     TypeError: Cannot read properties of undefined (reading 'getImage')
- *       at Map.hasImage
- *       at addImageToMap (s52-image-cache.ts)
- *
- * The rule, for anything in this package or the app that takes a map: after
- * an `await` (or in a `.then`, a frame callback, an `onload`), check this
- * before the first call on the map, and stop quietly if it says no. A removed
- * map is not an error to report — whoever removed it is building the next one.
- *
- * ⚠ `_removed`, NOT `style`. maplibre sets `_removed = true` as the last step
- * of `remove()` (typed on `Map` in maplibre-gl 4 and 5), so it is the fact,
- * where `style === undefined` is a consequence. Test doubles that never had a
- * `style` read as live, which is what they are. The app pins the maplibre side
- * of this (`map-live.test.ts`), so an upgrade that renames the field fails a
- * test rather than silently making every check say yes.
- *
- * Typed `object` so the structural map shapes the app passes around (a tile
- * census, an errored-tile tracker) can be asked too, not only `maplibregl.Map`.
+ * Terrarium elevation, served as PNG from `CHRT_RELIEF`. Separate from the
+ * vector shapes because MapLibre needs `type: "raster-dem"` and an explicit
+ * `encoding` — a raster-dem source read as a plain raster renders the encoded
+ * RGB as a garish false-colour image rather than as elevation.
  */
-declare function isMapLive(map: object): boolean;
-
-/** S-52 display categories – controls default visibility */
-type DisplayCategory = "BASE" | "STANDARD" | "OTHER" | "MARINERS" | "META";
-/** Mapbox GL layer type we'll use for this entry */
-type GeomType = "fill" | "line" | "circle" | "symbol";
-/** Nautical groupings (loosely follows Chart No. 1 sections) */
-type NauticalCategory = "Depths" | "Land" | "Navigation Aids" | "Hazards" | "Regulated Areas" | "Infrastructure" | "Meta";
-/** Paint properties – a subset we actually use */
-interface AtlasStyle {
-    type: GeomType;
-    paint: Record<string, unknown>;
-    layout?: Record<string, unknown>;
-    /** Nautical symbol ID for symbol-type layers */
-    iconImage?: string;
-}
-/** One row in the S-52 lookup table */
-interface LookupEntry {
-    /** S-57 object class acronym */
-    objectClass: string;
-    /** Human-readable name */
-    name: string;
-    /** Chart No. 1 section */
-    category: NauticalCategory;
-    /** S-52 display category */
-    displayCategory: DisplayCategory;
-    /** Default style using S-52 color tokens (resolved later) */
-    style: AtlasStyle;
-    /** Whether conditional symbology may override the style */
-    hasConditional?: boolean;
-    /** Attributes that affect styling */
-    conditionalAttributes?: string[];
-    /** INT1 / Chart No. 1 reference (e.g. "Q130.1") */
-    int1Ref?: string;
-    /** S-52 viewing group number */
-    viewingGroup?: number;
-    /** Minimum compilation scale for display (SCAMIN) */
-    scamin?: number;
-    /**
-     * Mark this class as deliberately invisible (label-only or metadata-only)
-     * so the layer-coverage audit doesn't flag its geometry-type gaps as bugs.
-     *
-     * Examples:
-     *   - SOUNDG: rendered as depth numbers via labels.ts, not as visible dots
-     *   - LNDRGN: region NAME labels only, no shape
-     *   - M_NPUB / M_NSYS / M_QUAL / M_SREL / DSID: S-57 metadata classes;
-     *     present for click-query attributes, never drawn
-     *
-     * Without this flag, `scripts/audit-layer-coverage.ts` reports the
-     * thousands of features in these classes as "gaps" every week even
-     * though the invisibility is intentional.
-     */
-    auditIgnore?: boolean;
-}
-/** Resolved style ready for Mapbox GL (tokens → hex) */
-interface ResolvedStyle {
-    type: GeomType;
-    paint: Record<string, unknown>;
-    layout?: Record<string, unknown>;
-    minzoom?: number;
-    maxzoom?: number;
+interface RasterDemSource {
+    type: "raster-dem";
+    tiles: string[];
+    encoding: "terrarium";
+    tileSize: number;
+    minzoom: number;
+    maxzoom: number;
+    /** The credit a renderer shows for this source (MapLibre's attribution control). */
+    attribution?: string;
 }
-
+type VectorSourceSpec = MapboxVectorSource | PmtilesVectorSource;
+type AnySourceSpec = VectorSourceSpec | RasterDemSource;
+/** CHRTland's vector land base. ADR 0023: its own archive, never chart data. */
+declare const LAND_REGION = "CHRT_LAND";
+/** CHRTland's terrarium relief. */
+declare const RELIEF_REGION = "CHRT_RELIEF";
+/** The world basemap under everything (completing-the-world-map, 2026-08-27). */
+declare const BASE_REGION = "CHRT_BASE";
 /**
- * S-52 lookup table covering all S-57 object classes found in NOAA ENCs.
- * Colours reference S-52 tokens (resolved at render time).
- * INT1 references per NOAA Chart No. 1 (Ed 13).
+ * CHRT_BASE's zoom range. 11 is the deepest zoom the archive's detail tier
+ * carries honestly — the planet's inland water exists from z9 and is read at
+ * z10 — and the world tier is tiled to the same depth so no layer vanishes
+ * from a tile the detail tier creates. Above 11 the client overzooms, and
+ * overzoomed inland water looks soft DELIBERATELY: it is "roughly where the
+ * lakes are", not a surveyed shoreline. Must equal the builder's MAXZOOM
+ * (tools/chrtbase-build/build.mjs).
  */
-declare const S52_LOOKUP: Record<string, LookupEntry>;
-
+declare const BASE_MINZOOM = 0;
+declare const BASE_MAXZOOM = 11;
 /**
- * S-52 draw order: layers listed bottom → top.
- * Layers not in this list are inserted before point features.
+ * The credit the ONLINE CHRT_BASE source carries (owner wording, 2026-09-16).
+ *
+ * OpenStreetMap is named because the online archive's z9–11 detail tier IS
+ * OSM-derived inland water (ODbL, `public/chrtbase-derivation.json`). The
+ * app-embeddable offline bundle is a z0–6 cut that contains no OSM data and
+ * carries `BASE_BUNDLE_ATTRIBUTION` instead (base-layers.ts) — one credit per
+ * artefact, each naming exactly the data it holds.
  */
-declare const S52_DRAW_ORDER: string[];
-/** Get numeric draw priority for a layer (lower = drawn first / below) */
-declare function getDrawPriority(layerName: string): number;
-
-/** S-52 display modes */
-type DisplayMode = "BASE" | "STANDARD" | "ALL";
-/** Check if a layer's display category is visible in the given mode */
-declare function isVisibleInMode(displayCategory: DisplayCategory, mode: DisplayMode): boolean;
+declare const BASE_ATTRIBUTION = "\u00A9 CHRT \u00B7 Made with Natural Earth \u00B7 \u00A9 OpenStreetMap contributors";
 /**
- * Convert S-52 SCAMIN (scale minimum) to Mapbox GL minzoom.
+ * The credit the CHRT_LAND source carries. CHRTland's land, land use, roads,
+ * places, peaks and marinas are OpenStreetMap via the Protomaps planet, and the
+ * ODbL requires this notice wherever the map is shown (.chrt/legal.md
+ * "Required notices"). Its other inputs — the ENC's charted land, USGS 3DEP
+ * contours, GNIS names — are US federal public domain and owe none. Same
+ * string as the offline land bundle's (offline-worker `LAND_PROVENANCE`).
  */
-declare function scaminToMinZoom(scamin?: number): number | undefined;
-declare function getCollisionSettings(viewingGroup?: number): {
-    iconAllowOverlap: boolean;
-    iconOptional: boolean;
-    symbolSortKey?: number;
-};
+declare const LAND_ATTRIBUTION = "\u00A9 OpenStreetMap contributors";
 /**
- * Get the resolved Mapbox GL style for a given S-57 layer.
+ * The credit the CHRT_RELIEF source carries. USGS 3DEP elevation, public
+ * domain (17 U.S.C. § 105) — no notice is required, so this is a courtesy that
+ * names the source. There is no OpenStreetMap in it.
  */
-declare function resolveStyle(layerName: string, geomKind?: GeomType, ct?: ColorTableName, opts?: {
-    safetyContour?: number;
-}): ResolvedStyle;
-declare function getLookupEntry(layerName: string): LookupEntry;
-
+declare const RELIEF_ATTRIBUTION = "Elevation: USGS 3D Elevation Program";
+/** Terrarium tiles are 512 px; the default 256 would halve the apparent relief. */
+declare const RELIEF_TILE_SIZE = 512;
 /**
- * S-52 Conditional Symbology Procedures.
- * Each function takes feature properties and returns paint overrides (hex colours).
- * All expression builders accept an optional colorTable parameter.
+ * How `CHRT_RELIEF`'s PNGs encode elevation. MapLibre's raster-dem default is
+ * `mapbox`, which decodes terrarium RGB into nonsense heights — so every
+ * surface that describes this source (this registry, the tile-worker's
+ * TileJSON) has to say it.
  */
+declare const RELIEF_ENCODING = "terrarium";
+type SourceMode = "mapbox" | "pmtiles";
 /**
- * Default safety contour in metres — the depth below which a feature is
- * "dangerous to my hull" for portrayal purposes.
+ * Query parameter carrying the resolved build id on every tile URL.
  *
- * This is the single source of truth for the *default* used by every
- * safety-contour-driven conditional symbology rule, so the rules can't
- * silently disagree with each other:
- *
- *   - §SOUNDG02 — soundings shoaler than the contour get the
- *     high-contrast shade (see `getLabelConfig` in labels.ts).
- *   - §CSYM02   — isolated dangers shoaler than the contour get the
- *     DNGCIR01 ring (see `buildLayersForClass` in layer-builder.ts).
- *   - §DEPARE04 — the MS/MD shade boundary (owner decision 2026-08-21,
- *     replacing a hardcoded 5 m middle cut; see the DEPARE block below
- *     for the full IHO correspondence).
+ * ── Why the build has to be IN THE URL ────────────────────────────────────
  *
- * All are overridden by the user's setting (sounding panel slider,
- * `safetyContour` in the style options); this is only the fallback when
- * none is supplied. It matches `custom-style.ts`'s config default.
- */
-declare const DEFAULT_SAFETY_CONTOUR_M = 10;
-declare function depareColor(props: Record<string, unknown>, ct?: ColorTableName, safetyContourM?: number): string;
-/**
- * The colour token of each `case` branch of `depareFillExpression`, in branch
- * order, then the fallback. `depth-area-opaque.ts` names the layers it splits
- * the expression into from this list, so the two read from one place.
- */
-declare const DEPARE_FILL_BRANCH_TOKENS: readonly ["DEPIT", "DEPVS", "DEPMS", "DEPMD"];
-declare const DEPARE_FILL_FALLBACK_TOKEN = "DEPDW";
-declare function depareFillExpression(ct?: ColorTableName, safetyContourM?: number): unknown[];
-declare function lightColor(props: Record<string, unknown>, ct?: ColorTableName): string;
-declare function lightFillExpression(ct?: ColorTableName): unknown[];
-declare function lateralColor(props: Record<string, unknown>, ct?: ColorTableName): string;
-declare function lateralFillExpression(ct?: ColorTableName): unknown[];
-declare function hazardColor(props: Record<string, unknown>, ct?: ColorTableName): string;
-declare function hazardFillExpression(ct?: ColorTableName): unknown[];
-declare function daymarkColor(props: Record<string, unknown>, ct?: ColorTableName): string;
-
-/**
- * Label configurations for S-57 layers.
- * Defines which layers get text labels and how to extract label text.
- */
-
-/**
- * Feature-class hierarchy for SEAARE labels. Returns a tier number 1-5 per
- * feature:
+ * The Worker reports the build it served in the `X-Build-Id` RESPONSE HEADER
+ * and sends `Cache-Control: private, max-age=3600`. A header is not part of a
+ * cache key, so every build shares one URL: after a cutover, tiles the client
+ * already fetched keep coming from its own HTTP cache — the old build — while
+ * newly-panned-to tiles come from the new one, for up to the full hour. The
+ * client renders TWO BUILDS AT ONCE.
  *
- * Exported (with the other tier builders below) for the build-side parity
- * test: CHRTbaremetal replicates these taxonomies as data in
- * tools/chrt-baremetal/server/src/tilebuild/placeNameTiers.ts to stamp
- * `tier` onto PLACENAME index features, and
- * placename-tier-parity.test.ts evaluates the two against shared
- * fixtures. Change a branch here and that test names the drift.
+ * On a nautical chart that is not a cosmetic seam. Measured live 2026-08-25,
+ * cutting `CHRT_LAND` from `463b265e` to `dbb69074` (a build that deliberately
+ * changes land extent): adjacent tiles disagreed about whether land was there,
+ * at the seam between them. Putting the build in the key gives each build its
+ * own cache namespace — old entries age out untouched, and the next style
+ * build flips the whole viewport at once instead of tile by tile.
  *
- *   1 — Ocean              (OBJNAM contains "<X> Ocean" — CATSEA has no
- *                          ocean code; the attribute is 1/unset on oceans)
- *   2 — Sea / Gulf         (OBJNAM "Gulf of …" / "… Sea")
- *   3 — Bay / Sound /      (CATSEA in {5 bay, 12 narrows} OR OBJNAM
- *       Strait / Narrows    " Bay" / " Sound" / " Strait")
- *   4 — Anchorage detail   (OBJNAM contains "Anchorage Area")
- *   5 — Relief + default   (CATSEA relief codes — authoritative — or
- *                          relief-term names, or anything uncategorised;
- *                          suppressed below z9 by the size curve)
+ * ── Why a QUERY PARAMETER and not a path segment ──────────────────────────
  *
- * Order matters: tier-4/5 demotions (anchorages, relief) run BEFORE the
- * promotion shims so "Bear Seamount" (contains " Sea") and "…Anchorage
- * Area" compound names can't bubble up into headline tiers.
- * `coalesce(CATSEA, catsea)` handles post-tippecanoe case variation
- * (matches `s52-conditional.ts` precedent).
- */
-declare function buildSeaAreaTierExpression(): ExpressionSpecification;
-/**
- * Built-up area tier (BUAARE): major city / town / neighborhood.
- *   1 — Major city (CATBUA=1 urban, or OBJNAM length <= 8)
- *   2 — Town (CATBUA=5 village, or OBJNAM length <= 14)
- *   3 — Neighborhood (longer compound names)
+ * A path segment would be the tidier-looking URL and it is the wrong trade
+ * here, for two reasons that are both about other people's code:
  *
- * Tier 1/2 may fire via CATBUA when populated; OBJNAM length is the
- * fallback so unpopulated CATBUA still produces a usable hierarchy.
- */
-declare function buildBuiltUpAreaTierExpression(): ExpressionSpecification;
-/**
- * Land region tier (LNDRGN): major region vs. local point.
- *   1 — Major region (OBJNAM length <= 12 AND no comma — "Long Island", "Cape Cod")
- *   2 — Local point (else — "Bird Island", "Cottage Park")
+ *   1. COMPATIBILITY IS PERMANENT, NOT "one release". iOS and desktop are
+ *      prod-only clients that ship on their own cadence. The Worker routes on
+ *      `url.pathname` (`TILE_ROUTE_PATH`) and reads only `?build=`, so a URL
+ *      carrying this parameter routes BYTE-IDENTICALLY to one without it. A
+ *      new path segment would instead need a second route regex kept alive
+ *      indefinitely.
+ *   2. FIVE SEPARATE PATTERNS ALREADY MATCH THIS URL, and every one of them
+ *      ends `(?:\?.*)?$` — `src/lib/map/tile-token-client.ts` TILE_URL_PATH
+ *      and `src/site/chart/sail-tile-token.ts` (which decide whether a tile
+ *      gets its Bearer), `packages/sdk/src/tile-auth.ts` TILE_URL_PATH,
+ *      `public/chrt-tile-sw.js` TILE_URL_RE (which also reads the region out of
+ *      the URL to pick its per-region cache), and
+ *      `src/site/offline/pack-protocol.ts` TILE_URL (which rewrites a tile to
+ *      a downloaded pack). Their optional PATH segment, by contrast, is
+ *      `[a-z][a-z0-9-]*` — letter-first so it cannot be confused with the
+ *      numeric `{z}` — and build ids are hex (`463b265e`, `4de67273`). A build
+ *      in the path would miss every one of them, and a tile those patterns
+ *      miss does not merely go uncached: it goes out with NO BEARER and comes
+ *      back 401, which MapLibre records as a permanently errored tile. That is
+ *      the exact failure the `.png` drift caused on staging-sail (see
+ *      `chrt-tile-sw.js`).
  *
- * No CATLND analog for region scope, so OBJNAM is the only signal.
- * The comma-absence test is a heuristic: NOAA compound names like
- * "Boston Harbor, MA Castle Island" carry a comma and belong at deeper
- * zoom regardless of length.
- */
-declare function buildLandRegionTierExpression(): ExpressionSpecification;
-/**
- * Land area tier (LNDARE): major vs. local.
- *   1 — Major (OBJNAM length <= 12)
- *   2 — Local
+ * The query string is also what the caches this fix targets actually key on:
+ * the browser HTTP cache, MapLibre's own tile cache, and the Service Worker's
+ * `new Request(req.url)` entry key all include it.
  *
- * No category attribute. OBJNAM length is the only signal.
- */
-declare function buildLandAreaTierExpression(): ExpressionSpecification;
-/**
- * Lake tier (LAKARE): lake vs. reservoir/pond.
- *   1 — Lake (CATLAK=1, or OBJNAM length <= 12)
- *   2 — Reservoir/pond (CATLAK in {2,3}, or longer name)
- */
-declare function buildLakeTierExpression(): ExpressionSpecification;
-/**
- * River tier (RIVERS): major vs. local.
- *   1 — Major river (OBJNAM length <= 15 AND no comma)
- *   2 — Local creek (else)
- */
-declare function buildRiverTierExpression(): ExpressionSpecification;
-/**
- * Airport tier (AIRARE): major airport vs. small airstrip.
- *   1 — Major (OBJNAM length <= 25 — e.g. "Logan International Airport")
- *   2 — Airstrip
+ * `v` rather than `build`: `?build=` is a taken name with a strict meaning on
+ * the Worker (`?build=candidate`, employee-only, 400 on any other value).
  */
-declare function buildAirportTierExpression(): ExpressionSpecification;
-interface LabelLayerConfig {
-    /** Mapbox source layer type */
-    type: "symbol";
-    /** Text field expression or string */
-    textField: ExpressionSpecification | string;
-    /** Text size in pixels */
-    textSize: number | ExpressionSpecification;
-    /** Text color (hex) or data-driven expression */
-    textColor: string | ExpressionSpecification;
-    /** Halo color for contrast */
-    textHaloColor: string;
-    /** Halo width — pixels or zoom-interpolation expression */
-    textHaloWidth: number | ExpressionSpecification;
-    /** Text offset [x, y] in ems */
-    textOffset: [number, number];
-    /** Font stack */
-    textFont?: string[];
-    /** Additional layout properties */
-    layout?: Record<string, unknown>;
-    /** Minimum zoom level for this label */
-    minzoom?: number;
-}
+declare const BUILD_PARAM = "v";
 /**
- * Optional palette-and-data-driven options for label config.
+ * One tile-URL template — the single place a CHRT tile URL is spelled.
  *
- * Currently used by SOUNDG to pick palette-aware text/halo colors and to
- * drive the S-52 safety-contour two-shade rule. Other classes ignore
- * these options.
+ * `buildId` is encoded rather than interpolated raw: MapLibre substitutes
+ * `{z}`/`{x}`/`{y}` by brace-matching the template, so an id containing a
+ * brace would corrupt every tile request. Empty / whitespace-only ids emit no
+ * parameter at all instead of a bare `?v=` that would key its own useless
+ * cache namespace.
  */
-interface LabelConfigOptions {
-    /** S-52 colour table — drives palette-aware text and halo colors. */
-    colorTable?: ColorTableName;
+declare function tileTemplate(base: string, region: string, extension: "mvt" | "png", buildId?: string): string;
+/** Canonical source id used in `generateStyle()` — matches the region name
+ *  of the one consolidated PMTiles served by the tile-worker for this region. */
+declare const DEFAULT_REGION = "NOAA_ENC";
+interface BuildSourcesOptions {
+    /** Which tile path to emit. Default: "pmtiles" (the supported path post-Mapbox). */
+    mode?: SourceMode;
+    /** Chart region. Default: "NOAA_ENC". */
+    region?: string;
     /**
-     * Safety contour depth in metres. Soundings shoaler than this render in
-     * `SNDG2` (high-contrast); deeper soundings render in `SNDG1` (muted).
-     * S-52 §SOUNDG02 conditional symbology.
+     * Build id of the CHART region (`region`) — the `build_tag` a
+     * `mint-tile-token` response hands back.
+     *
+     * Emitted as the {@link BUILD_PARAM} query parameter on that region's tile
+     * template. See {@link tileTemplate} for why a build discriminator has to be
+     * in the URL at all.
+     *
+     * ⚠ THIS COVERS THE CHART REGION ONLY. A token is minted for one chart
+     * region and `CHRT_LAND` / `CHRT_RELIEF` ride it, so the JWT's `build_tag`
+     * says nothing about a land cutover — the same blind spot that made the
+     * Worker's edge-cache key wrong until `TILE_CACHE_VERSION` v3
+     * (cloudflare/tile-worker/src/cache-encoding.ts). Pass {@link buildTags} to
+     * discriminate the basemap sources too.
      */
-    safetyContour?: number;
+    buildTag?: string;
     /**
-     * When false, all soundings render in `SNDG2` (single-shade). Default
-     * true — emit the safety-contour case expression.
+     * Resolved build id per region — `{ NOAA_ENC: "…", CHRT_LAND: "…" }`.
+     *
+     * The complete form of {@link buildTag}: every source this style declares
+     * gets its own discriminator, so a `CHRT_LAND` promotion turns over the land
+     * URLs without touching the chart's (and vice versa). An entry here wins
+     * over `buildTag` for the same region.
+     *
+     * This is the mint response's `build_tags` map verbatim (claim contract
+     * v1.7) — `TileTokenResponse.buildTags` in both `lib/map/tile-token-client.ts`
+     * and the SDK's `tile-auth.ts`. The same map already keys the tile Service
+     * Worker's per-region caches; passing it here puts the same identity in the
+     * URL, so the layer above the Service Worker stops mixing builds too.
+     *
+     * A region absent from the map simply gets no discriminator — the URL it
+     * has always had. That is a deliberate soft edge: an older mint response, or
+     * a region with no servable build, must degrade to today's behaviour rather
+     * than emit a URL pinned to a build nobody resolved.
      */
-    twoShadeSoundings?: boolean;
+    buildTags?: Readonly<Record<string, string>>;
+    /** Override tile-worker origin (e.g. staging). Default: DEFAULT_TILE_BASE_URL. */
+    tileBaseUrl?: string;
     /**
-     * When "semibold", SOUNDG labels use Open Sans Semibold for crisper
-     * numerals at small sizes. Default "semibold".
+     * Emit the CHRTland vector land base as a second source (ADR 0023). Off by
+     * default: it costs a source, and the region must be granted on the token.
      */
-    soundingFontWeight?: "regular" | "semibold";
+    land?: boolean;
+    /**
+     * Emit CHRTland's terrarium relief as a raster-dem source. Separate from
+     * `land` because relief needs a raster-capable worker AND a grant that
+     * `land-regions.ts` still withholds.
+     */
+    relief?: boolean;
+    /**
+     * Emit the CHRT_BASE world basemap as a third vector source — the dark
+     * geography under everything, the tan jurisdiction fill, and the rough
+     * inland water inside countries CHRT carries. Its layers sit UNDER the
+     * no-coverage hatch's companions and everything else; see baseLayers().
+     */
+    base?: boolean;
 }
 /**
- * Two-tier label rendering strategy for the band-priority style.
+ * Build the "sources" block for a CHRT style.
  *
- * `feature-band-gated` — emit one variant per source band, each gated to
- * its band's zoom window (the existing `makeBandVariants` behaviour). Right
- * for dense feature labels where seeing the same buoy designation or
- * sounding twice across overlapping bands is visual noise.
+ * - `mode: "mapbox"`: one mapbox:// url (kept for external style export only).
+ * - `mode: "pmtiles"` (default): one vector tile endpoint for the region,
+ *   routed by the Worker to the one consolidated PMTiles:
+ *   `${tileBaseUrl}/v1/tiles/{region}/{z}/{x}/{y}.mvt`
  *
- * `orientation-cross-band` — emit a SINGLE label layer with no band
- * filter. The per-class `minzoom` is honoured. Right for orientation
- * "where am I" labels (sea-area names, land regions, cities) — these
- * must persist as the user zooms in, even if the broader-scope cell
- * carrying the OBJNAM is from a coarser band than the one rendering
- * features at the current zoom. Collision arbitration via
- * `ORIENTATION_BAND_SORT_KEY` gives the broader-scope (lower-band) copy
- * priority where the same OBJNAM exists in multiple bands.
+ * Pass `buildTag` / `buildTags` to pin each source's URL to the build it is
+ * serving — without that, one URL is shared by every build and a cutover
+ * leaves the client rendering two of them at once. See {@link BUILD_PARAM}.
  */
-type LabelBehavior = "feature-band-gated" | "orientation-cross-band";
-declare const LABEL_BEHAVIOR: Record<string, LabelBehavior>;
-/** Returns the rendering strategy for an S-57 class. Unknown classes default to band-gated. */
-declare function getLabelBehavior(layerName: string): LabelBehavior;
+declare function buildSources(opts?: BuildSourcesOptions): Record<string, AnySourceSpec>;
+
 /**
- * Class-based label priority ladder — THE single collision-priority model
- * for feature labels (portrayal-excellence P4). Converges the previous
- * per-mechanism patches (SAFETY_CRITICAL_LABELS allow-overlap, the
- * band-5/6-only Harbor collision discipline) into one explicit ranking.
+ * DEPTH NUMBERS — how big the chart draws its depth figures.
  *
- * Rank semantics: LOWER rank = higher priority. The rank drives two
- * mechanisms that must stay in agreement:
+ * Asked for from the helm (chip 68, 2026-10-05), by a captain running CHRTsail
+ * desktop on a Raspberry Pi: *"I still need the depth numbers to be bolder
+ * which may be a setting. I just can't sail the boat and adjust all that stuff
+ * at the same time."* A set-and-forget choice, then, not a slider.
  *
- *   1. `symbol-sort-key` — every feature label carries
- *      `rank*1000 + within-class-key`, so if label layers are ever merged
- *      (the P8 style fan-out reduction), placement priority survives the
- *      merge unchanged.
- *   2. Label LAYER ORDER — MapLibre places symbols topmost-layer-first, so
- *      `style-generator.ts` emits feature-label layers lowest-priority
- *      first: safety-critical classes end up topmost and claim collision
- *      space before anything else. (`symbol-sort-key` alone cannot do
- *      this — it only orders placement WITHIN a layer.)
+ * ===========================================================================
+ * WHAT "LARGE" CHANGES, AND WHAT IT IS NOT ALLOWED TO TOUCH
+ * ===========================================================================
  *
- * The ladder (safety-critical > nav-aids > depth field > structures >
- * ambient notes):
+ * It changes the SIZE of the glyphs (and, where a class was Regular, the
+ * WEIGHT, to the Semibold soundings already use), the halo a little — see
+ * `LARGE` for why less than the glyph — and the sounding collision padding —
+ * see `LARGE_SOUNDING_PADDING_PX` for why that one moves.
  *
- *   100 — Safety-critical: light characteristics (LIGHTS), hazard depth
- *         callouts (UWTROC/OBSTRN/WRECKS VALSOU), overhead clearances
- *         (CBLOHD/PIPOHD VERCLR). Irreducible mariner-safety text.
- *   200 — Nav-aid designations: buoy / beacon `R "4"` labels.
- *   250 — Auxiliary nav-aid info: fog signal type (FOGSIG).
- *   300 — Depth field: soundings, contour values. Individually droppable —
- *         a hidden sounding has visible neighbors.
- *   400 — Structures: bridges, landmarks, piers, moorings, buildings.
- *   500 — Ambient annotation: seabed nature, magnetic variation, kelp.
- *   900 — Orientation names (SEAARE etc.) — not part of this ladder;
- *         they keep their settled watermark model (cell-band fan +
- *         dominance composition + `orientationLabelLayout`) and always
- *         paint underneath feature labels.
+ * It does not touch, and `depth-label-size.test.ts` holds every one of these
+ * equal to the Standard style in every palette and every symbol family:
  *
- * Safety guardrail: a lower rung never blocks a higher rung — placement
- * order guarantees the safety-critical label got the space first. Density
- * relief comes from dropping the LOWEST rung in a pile-up, never the top.
- */
-declare const LABEL_PRIORITY: Record<string, number>;
-/**
- * Resolve the priority rank for an S-57 class's label. Orientation classes
- * report 900 regardless of ladder membership (PRDARE etc.) so the
- * layer-order sort in style-generator.ts can treat priority uniformly.
- */
-declare function getLabelPriority(layerName: string): number;
-/**
- * Compose a `symbol-sort-key` from a class rank and an optional
- * within-class key expression. The within-class key is clamped to
- * [0, 999] so it can never bleed into a neighboring rank's band.
- */
-declare function labelSortKey(rank: number, within?: unknown): ExpressionSpecification | number;
-/**
- * Extract the trailing designation token from a nav-aid OBJNAM.
+ *   - `text-field` — the number itself, its unit conversion, its rounding.
+ *     ENC content is never altered; a bigger "4" is still the cell's "4".
+ *   - `text-color` / `text-halo-color` — §SOUNDG02's two shades against the
+ *     safety contour, and the palette that draws them (red night included:
+ *     it IS the NIGHT chart). A depth number shoaler than the contour stays
+ *     the loud one.
+ *   - `symbol-sort-key` — shallowest wins a collision, at any size.
+ *   - `filter`, `minzoom`, `maxzoom`, layer ids and layer order — so the
+ *     resident layer set the desktop builds at boot is the same set, and a
+ *     switch is `setLayoutProperty` / `setPaintProperty` on layers already
+ *     there. No layer and no draw call is added; what costs more is GPU fill,
+ *     because a bigger glyph covers more pixels (about 6–7 % more blended
+ *     fragments per pixel on the chart bench — the PR has the numbers).
  *
- * NOAA names channel aids "<waterway> <type> Buoy|Beacon <designation>"
- * where the designation is 1-4 alphanumerics: "4", "18A", "B", "BG".
- * Returns null when the name has no designation (trailing token is a
- * stopword type-name, or longer than 4 chars).
+ * ===========================================================================
+ * WHICH LABELS ARE "DEPTH NUMBERS"
+ * ===========================================================================
  *
- * This is the TS twin of `navAidDesignationTextExpression` — the GeoJSON
- * preprocessing path uses this function, the PMTiles path uses the GL
- * expression. Keep the two in agreement (see label-priority.test.ts).
+ * Exactly the ones the depth-unit switch converts (`buildLabelLayer` in
+ * `layer-builder.ts`): soundings, contour values, and the depth printed beside
+ * a rock, wreck or obstruction. The unit switch already treats those three as
+ * one claim — its own note says a rock's figure "is the SAME depth claim as a
+ * sounding" — and a size switch that enlarged the soundings around a rock but
+ * left the rock's own depth small would make the hazard the quietest number
+ * on that part of the chart.
+ *
+ * Not the dredged-channel note (`DRGNOTE`): it is a sentence fitted inside
+ * its own channel polygon at a computed size, and scaling it would stop it
+ * fitting. Not the bridge note: a clearance is a height, not a depth.
+ *
+ * ===========================================================================
+ * WHY NOT A BOLD FACE
+ * ===========================================================================
+ *
+ * The chart's glyph sets are Open Sans Regular, Semibold and Italic — the tile
+ * worker's `/v1/glyphs` (`cloudflare/tile-worker/glyphs/GLYPHS.json`) and the
+ * offline chart-assets pack serve those three and nothing else, and a
+ * fontstack no glyph host serves is the failure `labels.ts`'s SOUNDG note
+ * describes (Native lost every sounding). Soundings are already Semibold. So "bolder" here is
+ * size: stroke width scales with the glyph, and at 1x device pixels (a Pi's
+ * panel) a 14 px Semibold numeral is both heavier and crisper than a 10 px one.
  */
-declare function extractNavAidDesignation(objnam: string): string | null;
-/** Get label config for a given S-57 layer, or null if no labels */
-declare function getLabelConfig(layerName: string, opts?: LabelConfigOptions): LabelLayerConfig | null;
+
+/** The two choices, in presentation order. */
+declare const DEPTH_LABEL_SIZES: readonly ["standard", "large"];
+type DepthLabelSize = (typeof DEPTH_LABEL_SIZES)[number];
 /**
- * Build a Mapbox symbol layer spec from a label config.
+ * Standard is the chart as it has always been drawn, and it is what a style
+ * generated without the option gets: byte-identical, so the served style, the
+ * native-render goldens and every client that never asks are unchanged.
  */
-declare function buildLabelLayer(layerId: string, sourceId: string, config: LabelLayerConfig, visible: boolean, overrides?: {
-    textScale?: number;
-    minzoom?: number | null;
-    allowOverlap?: boolean;
-}): maplibregl.LayerSpecification;
+declare const DEFAULT_DEPTH_LABEL_SIZE: DepthLabelSize;
+/** Case-insensitive; anything unrecognised is `null`, never a throw. */
+declare function parseDepthLabelSize(raw: string | null | undefined): DepthLabelSize | null;
+/** The S-57 classes whose label is a depth figure. See the header. */
+declare const DEPTH_LABEL_CLASSES: ReadonlySet<string>;
 /**
- * Pre-process SOUNDG GeoJSON to extract Z coordinates as `depth` properties.
- * Soundings are MultiPoint with Z values in geometry.coordinates[][2].
- * This explodes MultiPoints into individual Points with a `depth` property.
+ * Sounding collision padding at Large, px. Standard is 6.
+ *
+ * ⚠ THIS IS THE ONE THAT DECIDES HOW MANY SOUNDINGS SURVIVE. MapLibre drops a
+ * sounding whose box (glyphs + padding) overlaps one already placed — the
+ * shallowest places first, so what drops is the deeper figure. A 1.4x numeral
+ * inside Standard's 6 px padding lost a quarter of the soundings: bigger
+ * numbers, fewer of them, which is not what was asked for. Trimming the
+ * padding gives the box back.
+ *
+ * Measured 2026-10-05 on the chart bench (`scripts/chart-bench`, Boston, DAY,
+ * 1280x800 at 1x), soundings placed, Standard → Large at this padding:
+ *
+ *   z11.5  515 → 539 (+5%)    z12.3  434 → 415 (−4%)
+ *   z13    374 → 366 (−2%)    z14    326 → 311 (−5%)
+ *
+ * and at Standard's 6 px: 391 / 246 at z11.5 / z14 (−24% / −25%). 3 px kept
+ * z14 level but put 17% MORE figures on the coastal view, which reads as
+ * clutter rather than as the same chart drawn bigger.
  */
-declare function preprocessSoundings(fc: GeoJSON.FeatureCollection): GeoJSON.FeatureCollection;
+declare const LARGE_SOUNDING_PADDING_PX = 3.5;
 /**
- * Pre-process LIGHTS GeoJSON to derive compact light characteristic labels.
- * Adds `_lightLabel` property (e.g., "Fl(2) WR 4s 5M").
+ * Apply a depth-label size to one generated label layer.
  *
- * KEEP IN STEP WITH `buildLightLabelExpression()` in layer-builder.ts — that
- * is the same label built as a GL expression for the tile path, which has no
- * JS preprocessing step. `light-label-parity.test.ts` asserts the two agree
- * on real tile features; if you change one, change both.
+ * Standard — and any class that is not a depth figure — returns the SAME
+ * object, untouched. Large returns a copy with only the properties listed in
+ * the header changed.
  */
-declare function preprocessLights(fc: GeoJSON.FeatureCollection): GeoJSON.FeatureCollection;
-/** List of layers that have labels */
-declare const LABELED_LAYERS: Set<string>;
+declare function applyDepthLabelSize(objectClass: string, layer: StyleLayer, size: DepthLabelSize | undefined): StyleLayer;
+
 /**
- * Pre-process buoy/beacon GeoJSON to derive concise mariner-style labels.
- * Adds `_navAidLabel` property (e.g., 'R "8"', 'G "5"').
+ * Builds Mapbox GL Style layer specs from S-52 lookup entries.
+ * Wraps the existing atlas resolveStyle() and adds source/source-layer/filter.
  */
-declare function preprocessNavAids(fc: GeoJSON.FeatureCollection): GeoJSON.FeatureCollection;
-/** Check if a layer name needs nav aid preprocessing */
-declare function isNavAidLayer(layerName: string): boolean;
+
+interface StyleLayer {
+    id: string;
+    type: string;
+    source: string;
+    "source-layer": string;
+    filter?: unknown[];
+    paint: Record<string, unknown>;
+    layout?: Record<string, unknown>;
+    minzoom?: number;
+    maxzoom?: number;
+    metadata?: Record<string, unknown>;
+}
 /**
- * Pre-process water body polygon GeoJSON into centroid points for label placement.
- * Computes a simple average-coordinate centroid for each polygon feature that has OBJNAM.
+ * Build all Mapbox GL layers for a given S-57 object class.
+ * Returns multiple layers (fill, outline, symbol, label, etc.).
+ *
+ * Post-consolidation: all S-57 classes live as MVT layers inside one
+ * consolidated PMTiles per region; `source` is always the region name.
+ *
+ * `opts.safetyContour` is the mariner's safety depth in metres — it drives
+ * the §CSYM02 isolated-danger ring on hazard classes. Defaults to
+ * `DEFAULT_SAFETY_CONTOUR_M`, the same default the SOUNDG two-shade rule
+ * uses, so the ring and the sounding colour always agree.
  */
-declare function preprocessWaterBodies(fc: GeoJSON.FeatureCollection): GeoJSON.FeatureCollection;
-/** MVT layer the build-side place-name index emits. */
-declare const PLACENAME_SOURCE_LAYER = "PLACENAME";
-/** Orientation classes whose names render italic (water voice). */
-declare const PLACENAME_WATER_CLASSES: readonly string[];
-/** Orientation classes whose names render upright (land voice). */
-declare const PLACENAME_LAND_CLASSES: readonly string[];
+declare function buildLayersForClass(objectClass: string, ct: ColorTableName, sourceId?: string, opts?: {
+    safetyContour?: number;
+}): StyleLayer[];
 /**
- * The 2 PLACENAME symbol layers. Layout contract (design §2.2): collision
- * ON (`allow-overlap: false`, `ignore-placement: false`,
- * `optional: true`), padding 4, `text-variable-anchor`, and
- * `symbol-sort-key` straight from the build-side `rank` — MapLibre places
- * LOWER sort keys first, and rank is minted lower-is-more-important
- * (tier major, bbox area minor), so when space runs out the biggest names
- * survive. That ranking is the per-zoom density governor P4 asked for.
+ * Get the full ordered list of object classes for style generation.
+ * Uses S52_DRAW_ORDER as base, then adds any missing classes from the
+ * S-52 lookup table so a newly-ingested class automatically gets styled
+ * without touching this file.
  */
-declare function buildPlaceNameLayers(sourceId: string, ct?: ColorTableName): maplibregl.LayerSpecification[];
+declare function getOrderedClasses(): string[];
 
 /**
- * Spatial grid-based feature decimation for performance at low zoom levels.
- * Thins dense GeoJSON feature sets by keeping only one representative
- * feature per grid cell per layer.
- */
-interface DecimationOptions {
-    /** Grid resolution (cells per axis). Default 80. */
-    gridSize?: number;
-    /** Zoom level below which decimation kicks in. Default 12. */
-    zoomThreshold?: number;
-}
-/**
- * Zoom-adaptive grid resolution for decimation.
- */
-declare function getGridSizeForZoom(zoom: number): number;
-/**
- * Decimate a GeoJSON FeatureCollection using spatial grid thinning.
- * Only runs when zoom < zoomThreshold. Returns the original FC otherwise.
+ * Dominance fan-out collapse (P8 Phase 3.3 / D4 "axis 1").
  *
- * @param fc - Input FeatureCollection
- * @param layerName - S-57 layer name (affects priority logic)
- * @param currentZoom - Current map zoom level
- * @param bounds - Current viewport bounds
- * @param opts - Decimation options
+ * `makeBandVariants()` historically emitted, per (class, band): one
+ * "not-dominated" layer plus up to five `-domBy{D}` copies that differ ONLY
+ * in their dominance filter and a `maxzoom` of `dominatedVariantMaxzoom(D)`.
+ * That fan existed because MapLibre filters could not read `["zoom"]`. They
+ * can now (style-spec 24.8.5; buckets evaluate at the tile's `overscaledZ`),
+ * so the whole fan folds into ONE layer per (class, band) whose filter
+ * carries the zoom gate.
+ *
+ * **Construction principle — read before changing anything here.** The
+ * collapsed filter is the literal `["any"]` UNION of the clauses the fan
+ * already encoded: every variant the legacy emitter would have produced
+ * contributes exactly one `["all", <its dominance filter>, ["<", ["zoom"],
+ * <its maxzoom>]]` clause, and the dead-variant skip is mirrored too.
+ * Equivalence is therefore *structural*, not re-derived — which matters,
+ * because the two "obvious" hand-written forms are both wrong:
+ *
+ *   1. A `["match", ["get","_dominated_by_min"], 2,5, 3,7, 4,9, 5,11, 6,11, 24]`
+ *      threshold (the form the design doc proposed) uses band 6's *eligibility*
+ *      zoom 11. The real ceiling is `dominatedVariantMaxzoom("6") = 13` — band
+ *      6's DATA floor. Using 11 reopens the z11–z12 void window that
+ *      `band-priority.ts` documents closing.
+ *   2. That same form silently drops the legacy `_dominated: true` boolean,
+ *      which `dominatedByMinFilter("6")` still honours. A legacy-tagged feature
+ *      has no `_dominated_by_min`, so `match` falls to its default and the
+ *      feature renders FOREVER instead of dropping at z13.
+ *
+ * Deriving the gate from the emitter's own clauses avoids both by construction.
+ * `band-collapse.test.ts` re-proves it on every CI run by differentially
+ * evaluating legacy-vs-collapsed through MapLibre's real three gates.
+ *
+ * **Scope.** For FEATURE layers (fills, lines, feature symbols) this is
+ * axis 1 ONLY: the per-band layers survive, with identical ids and identical
+ * positions, so the band-major draw order is untouched. "Axis 2" (collapsing
+ * the per-band copies into one layer per class) was evaluated and **KILLED**
+ * for feature layers — it is unsound for the opaque-fill classes
+ * (`DOMINANCE_EXEMPT_FILL_CLASSES` ≡ `OPAQUE_FILL_LAYERS`), where band-major
+ * order is the ONLY thing separating the bands, and 15/15 class pairs are
+ * provably unsatisfiable with one layer each. Do not reintroduce it there.
+ * Evidence: `.chrt/perf/2026-07-14-p8-d4-spike.md`.
+ *
+ * LABEL layers are different (CHRTsail #121 — MapLibre Native iOS silently
+ * collapses its whole render pass above 482 symbol layers, and the served
+ * style carried 575): `makeCollapsedCrossBandLabel` folds a label's ×6 band
+ * fan into ONE layer per class, and `collapsedOrientationGate` folds the
+ * orientation fan's per-dominator variants into its per-cell layers. That is
+ * NOT the killed axis 2, because what the fill argument protects — paint
+ * order as the sole band separator — does not apply to labels: their
+ * load-bearing order is the cross-class P4 priority ladder (each class keeps
+ * exactly one layer in its ladder slot), and within-class placement priority
+ * rides the `rank*1000 + within-key` symbol-sort-key that labels.ts
+ * documents as designed to survive precisely this merge.
+ *
+ * **Load-bearing invariant.** A collapsed per-band FEATURE layer MUST keep
+ * the `-band{B}` id segment: `custom-style.ts` `bandFloor()` parses
+ * `/-band(\d)/` to clamp customer minzoom/scamin overrides to the band's
+ * data floor, on the live public Style API path. Renaming the id silently
+ * unclamps those overrides. Cross-band LABEL layers are the deliberate
+ * exception: they carry every band floor INSIDE the filter (tile-zoom
+ * clauses a customer override cannot touch), which supersedes the clamp —
+ * `bandFloor()` returning 0 for a bare label id is correct, not a gap.
+ * Both halves asserted in `band-collapse.test.ts`.
  */
-declare function decimateFeatures(fc: GeoJSON.FeatureCollection, layerName: string, currentZoom: number, bounds: {
-    west: number;
-    south: number;
-    east: number;
-    north: number;
-}, opts?: DecimationOptions): GeoJSON.FeatureCollection;
+
 /**
- * Get the max number of cells to load based on zoom level.
+ * Which emitter the style generator uses for the dominance fan.
+ * `"legacy"` exists so CI can differentially prove the two equivalent (it is
+ * the oracle in `band-collapse.test.ts`) and as a one-line rollback. It is an
+ * internal knob — deliberately NOT on the exported `StyleGeneratorOptions`,
+ * so it cannot reach `@chrtco/sdk` consumers via `ChrtStyleOptions`.
  */
-declare function getMaxCellsForZoom(zoom: number): number;
+type BandFanMode = "collapsed" | "legacy";
 
 /**
- * IHO S-52 / NOAA Chart No. 1 / INT1 nautical symbol SVGs.
- *
- * Complete symbology suite following:
- *   - IHO S-52 Presentation Library (Ed 4.0)
- *   - IALA Maritime Buoyage System R1001 (Region B for US waters)
- *   - NOAA Chart No. 1 (Ed 13) / INT1
- *
- * Buoy shape terminology (US / Chart No. 1):
- *   - CAN (Q20): Flat-top cylindrical buoy — Port mark in IALA-B (red)
- *   - NUN (Q21): Conical/pointed-top buoy — Starboard mark in IALA-B (green)
- *   - PILLAR: Tall narrow buoy — used for cardinal, isolated danger, etc.
- *   - SPAR: Tall thin pole buoy
- *   - SPHERICAL: Round buoy — safe water marks
- *   - BARREL: Barrel/tun shaped buoy
- *   - SUPER: Large navigation buoy / LANBY
- *
- * Cardinal mark topmark orientations (IALA):
- *   - North: both cones point UP ▲▲
- *   - South: both cones point DOWN ▼▼
- *   - East:  cones base-to-base (diamond) ◆
- *   - West:  cones point-to-point (hourglass) ⊗
- *
- * Each symbol is a compact SVG at 32×32 for Mapbox GL `map.addImage()`.
+ * Generates a complete Mapbox GL Style Specification v8 JSON
+ * from the S-52 atlas definitions.
  */
-/** Color used in the SVG with its S-52 token name, hex, and usage */
-interface SymbolColor {
-    token: string;
-    hex: string;
-    usage: string;
-}
-/** Line style used in the SVG */
-interface SymbolLineStyle {
-    element: string;
-    width: number;
-    pattern?: string;
-    color: string;
-}
-/** Fill element used in the SVG */
-interface SymbolFillElement {
-    element: string;
-    color: string;
-    opacity?: number;
-}
-interface NauticalSymbol {
-    id: string;
-    label: string;
-    /** INT1 / Chart No. 1 reference */
-    int1Ref: string;
-    /** Chart No. 1 section letter */
-    section: string;
-    getSvg: () => string;
-    /** Generate SVG with theme-specific colors (for bridge icons etc.) */
-    getThemedSvg?: (chblk: string, movable: string) => string;
-    /** What this symbol represents on a chart */
-    description?: string;
-    /** S-52 Presentation Library symbol name */
-    s52PlRef?: string;
-    /** S-57 object class (e.g. "LNDMRK") when it can't be derived from s52PlRef's prefix */
-    s57Class?: string;
-    /** Grouping key for family clustering */
-    group?: string;
-    /** IDs of related variant symbols */
-    variants?: string[];
-    /** S-57 attribute that selects this variant */
-    attributeKey?: string;
-    /** Value of that attribute for this variant */
-    attributeValue?: number;
-    /** Example label strings seen on charts */
-    labelExamples?: string[];
-    /** What the color represents */
-    colorMeaning?: string;
-    /** Colors used in the SVG */
-    colors?: SymbolColor[];
-    /** Line/stroke styles used in the SVG */
-    lineStyles?: SymbolLineStyle[];
-    /** Fill regions in the SVG */
-    fillElements?: SymbolFillElement[];
-    /** Expanded navigational usage context (2-4 sentences) */
-    usageContext?: string;
-    /** Render size for documentation */
-    renderSize?: string;
-}
-/** A logical grouping of related symbols */
-interface SymbolGroup {
-    id: string;
-    label: string;
-    section: string;
-    description: string;
-    symbolIds: string[];
+
+interface MapboxStyle {
+    version: 8;
+    name: string;
+    metadata: Record<string, unknown>;
+    sources: Record<string, unknown>;
+    sprite?: string;
+    glyphs: string;
+    layers: StyleLayer[];
 }
-/** Chart No. 1 section metadata */
-interface ChartSection {
-    id: string;
-    label: string;
-    description: string;
+interface StyleGeneratorOptions extends BuildSourcesOptions {
+    /**
+     * When set, emit a "paper chart" style centered on the selected scale
+     * band, with graceful coverage fallback: the requested band's layers
+     * draw on top where its cells have data; coarser bands (driven by
+     * `CHART_CASCADE_CODES`) fill gaps where the requested band has no
+     * cells. Per-feature SCAMIN minzooms are preserved on every cascade
+     * variant; `maxzoom` is dropped so the user can zoom in indefinitely.
+     *
+     * When omitted (default), continuous mode emits one layer copy per
+     * source band with strict per-band zoom windows so exactly one band
+     * renders at any given continuous zoom.
+     *
+     * `lockedBounds` (optional) restricts chart-mode rendering to a
+     * specific bbox via a `["within"]` filter — applied ONLY to the
+     * requested band's variants. Cascade fallback bands render across the
+     * full viewport so a chart-Harbor user panning offshore still sees
+     * Approach/Coastal data. The frontend pairs this with a translucent
+     * grey overlay outside the bbox so the lock boundary is still visible
+     * to the user (the fallback data is dimmed by the overlay but not
+     * filtered out).
+     */
+    chartMode?: {
+        band: ScaleBand$1;
+        lockedBounds?: BBox;
+    };
+    /**
+     * Display unit for depth labels (SOUNDG soundings, DEPCNT contour
+     * values). Source data is always meters (S-57 / VALSOU / VALDCO);
+     * "feet" wraps the text-field expression with a unit conversion +
+     * round so the rendered numbers match. Default "meters".
+     */
+    depthUnits?: "meters" | "feet";
+    /**
+     * Which symbol artwork the style references. "s52" (default) uses the
+     * PresLib-derived S-52 set; "s101" rewrites icon references to the
+     * official S-101 Portrayal Catalogue symbols (s101: image namespace)
+     * where a counterpart exists — see s101-style.ts. "chrt" applies the
+     * CHRT house ATON/LIGHTS glyphs with colour-true tinting — see
+     * chrt-style.ts. Selection logic differences are documented per module.
+     */
+    symbolSet?: "s52" | "s101" | "chrt" | "raster";
+    /**
+     * The mariner's safety contour in metres — the depth below which a
+     * feature is "dangerous to my hull". Drives both safety-contour
+     * conditional symbology rules:
+     *
+     *   - §SOUNDG02 — soundings shoaler than this render in the
+     *     high-contrast color; deeper soundings render in the muted color.
+     *   - §CSYM02   — isolated dangers (rocks / wrecks / obstructions)
+     *     shoaler than this get the DNGCIR01 danger ring.
+     *
+     * Default `DEFAULT_SAFETY_CONTOUR_M` (10 m).
+     *
+     * Does not affect the DEPARE depth-area shading, whose 2/5/10 m bands
+     * are a separate S-52 concept.
+     */
+    safetyContour?: number;
+    /**
+     * When false, all soundings render in a single shade. Default true.
+     */
+    twoShadeSoundings?: boolean;
+    /**
+     * Label model for the 9 orientation place-name classes (SEAARE, LNDRGN,
+     * LAKARE, RIVERS, CANALS, BUAARE, AIRARE, LNDARE, PRDARE).
+     *
+     * "legacy" (default) — the per-cell-band orientation fan
+     * (fanOrientationLabelByCellBand): one label per feature per band,
+     * deconflicted only by `_label_anchor` tags and watermark opacity.
+     *
+     * "placename" — 2 PLACENAME symbol layers over the build-side
+     * place-name index (CHRTbaremetal placeNameIndex.ts): one collision-
+     * managed label per named place with a per-feature zoom window; the
+     * orientation fan for those classes is NOT emitted. Requires tiles
+     * built with the PLACENAME side index — on older tiles the layers
+     * simply draw nothing (soft-fail is index-side), which is why the
+     * default stays "legacy" until L2c's rebuild + Maine-coast visual
+     * verification flips it (docs/design/chart-label-deconfliction.md
+     * §2.3). Feature-label classes are untouched either way.
+     */
+    labels?: "legacy" | "placename";
+    /**
+     * Font weight for SOUNDG labels. Default "semibold" — crisper numerals
+     * at small sizes on screen.
+     */
+    soundingFontWeight?: "regular" | "semibold";
+    /**
+     * How big the depth figures are drawn — soundings, contour values and the
+     * depth beside a rock, wreck or obstruction. "standard" (default) is
+     * byte-identical to omitting it; "large" enlarges those labels only, and
+     * never their text, colours, sort keys, filters or layer set. See
+     * depth-label-size.ts.
+     */
+    depthLabelSize?: DepthLabelSize;
 }
-declare const NAUTICAL_SYMBOLS: NauticalSymbol[];
-/** S-57 object class → default symbol ID mapping.
- *  Values are S-52 PL symbol names (matching SVG filenames in s52/point/).
- *  Conditional expressions in getIconExpression() override these for classes
- *  with attribute-dependent variants.
- */
-declare const SYMBOL_MAP: Record<string, string>;
-/** Get the Mapbox icon-image expression for data-driven symbol selection.
- *  Returns S-52 PL symbol names that correspond to SVG files in s52/point/.
+declare function generateStyle(palette?: ColorTableName, opts?: StyleGeneratorOptions & {
+    bandFan?: BandFanMode;
+}): MapboxStyle;
+declare function generateStyleJSON(palette?: ColorTableName, opts?: StyleGeneratorOptions): string;
+/** Get summary stats about the generated style */
+declare function getStyleStats(style: MapboxStyle): {
+    totalLayers: number;
+    fillLayers: number;
+    lineLayers: number;
+    symbolLayers: number;
+    circleLayers: number;
+    sources: number;
+    objectClasses: Set<string>;
+};
+
+/**
+ * The e-ink portrayal pass — what `EINK_COLOR`, `EINK_MONO` and `EINK_NIGHT`
+ * change beyond their colour tables. Night is mono inverted: everything below
+ * applies, the patterns and safety contour are drawn LIGHT (the patterns are
+ * themed per palette, the contour takes the table's DEPSC), and the chart
+ * background gets the no-coverage crosshatch, because a black no-data hole
+ * on a black-water page would read as deep water.
+ *
+ * A colour table can only move colours. E-paper needs more than that (owner
+ * decision 2026-10-05: CHRT serves the e-ink chart, clients never recolour it;
+ * requirements in CHRTsail's e-ink product spec §3c):
+ *
+ *   1. MEANING UNCHANGED. Nothing here adds, removes or reorders a feature
+ *      class or changes a filter that decides WHICH features draw. It changes
+ *      how they look, and adds two kinds of OVERLAY layer (depth patterns,
+ *      the safety contour) that draw features the chart already draws.
+ *   2. MONO STANDS ON ITS OWN. Depth steps become fill PATTERNS (mono only);
+ *      danger areas get a cross-hatch; the safety contour gets its own heavy
+ *      line; restricted/caution areas keep their dashes, now heavier.
+ *   3. DEPTH IN AT MOST FOUR STEPS. The tables do the colour side (DEPMD ==
+ *      DEPDW). Mono shows three: drying (hatch), shallower than the safety
+ *      contour (stipple), safe (paper).
+ *   4. SAFETY CONTOUR AND DANGERS EMPHASISED: a heavy black safety-contour
+ *      line; danger symbols drawn larger; danger areas cross-hatched.
+ *   5. COVERAGE PORTRAYAL SURVIVES: the no-coverage crosshatch goes to full
+ *      strength rather than being dropped with the other translucency.
+ *   6. ATTRIBUTION/CURRENCY METADATA: untouched — this pass never edits
+ *      `sources` or the metadata other than adding `chrt:eink`.
+ *   7. SIZES FOR 150 ppi COLOUR / 300 ppi MONO: every line ×1.5 (min 1 px),
+ *      text ×1.15 with a solid paper halo, no translucency, no blur, no fades.
+ *
+ * Translucency is the thing e-paper cannot draw: a 10% magenta wash over pale
+ * blue is a fifth grey in mono and nothing at all on Kaleido 3. So faint washes
+ * (< 0.3) are dropped — every one of them is a CHRT addition over a feature
+ * whose boundary and symbol S-52 already draws — and stronger ones are made
+ * solid.
+ *
+ * Pure: takes a generated style, returns a new one. `generateStyle` applies it
+ * for the e-ink tables, so the served style, the offline style and the SDK's
+ * local `generateStyle` all carry the same portrayal.
  */
-declare function getIconExpression(layerName: string): string | unknown[];
+
+/** The three e-ink fill patterns (house glyphs, registered with the world hatches). */
+declare const EINK_DOTS_PATTERN = "chrt:eink-dots";
+declare const EINK_HATCH_PATTERN = "chrt:eink-hatch";
+declare const EINK_DANGER_PATTERN = "chrt:eink-danger";
+/** The VALDCO values that ARE the safety contour, one per ladder. */
+declare function safetyContourValues(safetyContourM: number): number[];
+interface EinkPortrayalOptions {
+    /** The mariner's safety contour, metres — the same value the generator used. */
+    safetyContour?: number;
+}
 /**
- * Browser-only image loaders (`loadSymbolImages`, `loadThemedBridgeImages`)
- * live in `./symbols-browser.ts` (sub-export `@chrtco/sdk/atlas/browser`) —
- * they require a DOM (use `new Image()` + `map.addImage()`).
+ * Apply the e-ink portrayal for `palette`. Returns the style unchanged for a
+ * non-e-ink palette, so a caller may apply it unconditionally.
  */
-/** Get inline SVG string for a symbol by ID (for the Atlas legend) */
-declare function getSymbolSvgString(symbolId: string): string | null;
-declare const CHART_SECTIONS: ChartSection[];
-declare const SYMBOL_GROUPS: SymbolGroup[];
-/** Generate a single SVG sprite sheet containing all symbols as <symbol> elements */
-declare function generateSpriteSheet(): string;
-/** Generate a JSON manifest mapping symbol IDs to metadata */
-declare function generateSpriteManifest(): Record<string, {
-    label: string;
-    int1Ref: string;
-    section: string;
-    group?: string;
-    s52PlRef?: string;
-    description?: string;
-    attributeKey?: string;
-    attributeValue?: number;
-}>;
+declare function applyEinkPortrayal(style: MapboxStyle, palette: ColorTableName, opts?: EinkPortrayalOptions): MapboxStyle;
 
 /**
- * IHO S-101 ENC Product Specification — Feature Catalogue
+ * Light arithmetic for the chart palettes: how much light a colour emits, and
+ * how to dim a colour without changing its hue.
  *
- * S-101 replaces S-57 as the data model for Electronic Navigational Charts.
- * This catalogue maps S-101 feature classes to:
- *   - S-57 equivalents (where they exist)
- *   - Chart No. 1 sections (same organizational structure)
- *   - Portrayal catalogue references (S-100 Portrayal Model)
+ * Everything here works in LINEAR light (WCAG 2.x relative luminance, sRGB
+ * primaries). That is the quantity a dark-adapted eye responds to, and it is
+ * the one `sounding-legibility.test.ts` already measures soundings in. Scaling
+ * the sRGB-ENCODED channels instead would dim dark colours far more than
+ * bright ones and shift every hue it touched.
  *
- * Key S-101 changes from S-57:
- *   - CamelCase feature class names (DepthArea vs DEPARE)
- *   - Complex/structured attributes (nested objects vs flat)
- *   - New feature types for AIS, quality, under-keel clearance
- *   - Removed/merged features for simplification
+ * The one derivation the palettes rely on, and the reason this file exists:
+ * NIGHT's deeper sounding SNDG1 (#897350) is SNDG2 (#c8aa78) at 43% of its
+ * linear light. `labels.ts` builds its NIGHT secondary text the same way, so
+ * the two stay one family by construction rather than by two hand-typed hexes
+ * that happen to agree.
+ */
+/** WCAG 2.x relative luminance of a `#rrggbb` colour, 0 (black) to 1 (white). */
+declare function relativeLuminance(hex: string): number;
+/** WCAG 2.x contrast ratio between two `#rrggbb` colours, 1 to 21. */
+declare function contrastRatio(a: string, b: string): number;
+/**
+ * The same hue at `factor` times its linear light. `factor` above 1 can clip a
+ * channel, which shifts the hue; nothing in the palettes brightens, so callers
+ * pass 0–1.
+ */
+declare function scaleLinearLight(hex: string, factor: number): string;
+/**
+ * `hex` dimmed, hue kept, until its luminance is at most `ceiling`. A colour
+ * already at or under the ceiling comes back unchanged (lower-cased).
+ */
+declare function capLuminance(hex: string, ceiling: number): string;
+/**
+ * NIGHT's two ink levels, shared by every family's text and marks.
  *
- * Reference: IHO S-101 Product Specification (Ed 1.1.0)
- *            IHO S-100 Universal Hydrographic Data Model
+ *   `NIGHT_INK`        S52_NIGHT.CHBLK — the palette's linework and navigation
+ *                      text. The brightest thing NIGHT draws on purpose.
+ *   `NIGHT_MUTED_INK`  that ink at 43% of its linear light, which is how
+ *                      S52_NIGHT.SNDG1 (the deeper soundings) was derived.
+ *                      Everything that orients rather than navigates is drawn
+ *                      at or under this, and `night-luminance.test.ts` holds
+ *                      every visible NIGHT colour to it unless an exemption
+ *                      names a reason.
  */
-interface S101Feature {
-    /** S-101 camelCase feature class name */
-    featureClass: string;
-    /** Human-readable name */
-    name: string;
-    /** S-57 6-char equivalent acronym, if any */
-    s57Equivalent?: string;
-    /** Chart No. 1 section letter */
-    section: string;
-    /** Group key for clustering */
-    group: string;
-    /** Feature category */
-    category: "geo" | "meta" | "info";
-    /** Description of the feature */
-    description: string;
-    /** S-100 Portrayal Catalogue reference */
-    portrayalRef?: string;
-    /** True if this feature has no S-57 equivalent */
-    isNewInS101: boolean;
-    /** Key attributes specific to this feature */
-    attributes?: string[];
-}
-declare const S101_FEATURES: S101Feature[];
-declare const S101_CHART_SECTIONS: {
-    id: string;
-    label: string;
-    description: string;
-}[];
-declare const S101_SYMBOL_GROUPS: {
-    id: string;
-    label: string;
-    section: string;
-    description: string;
-}[];
+declare const NIGHT_INK: string;
+declare const NIGHT_MUTED_INK: string;
 
 /**
- * S-101 Portrayal Catalogue — New Symbol SVGs
+ * Is this MapLibre map still there to be written to?
  *
- * These symbols represent features introduced in S-101 that have no
- * direct S-57/S-52 equivalent. The existing S-52 symbols are reused
- * where S-101 retains visual continuity with the S-57 portrayal.
+ * ===========================================================================
+ * ⚠ ASK AFTER EVERY AWAIT. A MAP CAN BE REMOVED WHILE YOU WERE WAITING.
+ * ===========================================================================
  *
- * Reference: IHO S-101 Portrayal Catalogue (Ed 1.1.0)
+ * `map.remove()` deletes `map.style`, and after that nearly every method that
+ * touches the style throws rather than returning: `hasImage`, `addImage`,
+ * `updateImage`, `getSource`, `addLayer` all fail with "Cannot read properties
+ * of undefined (reading 'getImage')" and its siblings. Code that was handed a
+ * map, awaited a decode, an IndexedDB read or a fetch, and then wrote to the
+ * map, throws from wherever it resumed — usually a promise nobody is awaiting,
+ * so the throw is an uncaught error with no caller to explain it.
+ *
+ * Measured in CHRTdesktop (chip 63, 2026-10-04): with the page's main thread
+ * held at 6× CPU, the chart removed its map in the middle of a pan, and the
+ * S-52 image loader resumed onto it:
+ *
+ *     TypeError: Cannot read properties of undefined (reading 'getImage')
+ *       at Map.hasImage
+ *       at addImageToMap (s52-image-cache.ts)
+ *
+ * The rule, for anything in this package or the app that takes a map: after
+ * an `await` (or in a `.then`, a frame callback, an `onload`), check this
+ * before the first call on the map, and stop quietly if it says no. A removed
+ * map is not an error to report — whoever removed it is building the next one.
+ *
+ * ⚠ `_removed`, NOT `style`. maplibre sets `_removed = true` as the last step
+ * of `remove()` (typed on `Map` in maplibre-gl 4 and 5), so it is the fact,
+ * where `style === undefined` is a consequence. Test doubles that never had a
+ * `style` read as live, which is what they are. The app pins the maplibre side
+ * of this (`map-live.test.ts`), so an upgrade that renames the field fails a
+ * test rather than silently making every check say yes.
+ *
+ * Typed `object` so the structural map shapes the app passes around (a tile
+ * census, an errored-tile tracker) can be asked too, not only `maplibregl.Map`.
  */
+declare function isMapLive(map: object): boolean;
 
-declare const S101_NEW_SYMBOLS: NauticalSymbol[];
+/** S-52 display categories – controls default visibility */
+type DisplayCategory = "BASE" | "STANDARD" | "OTHER" | "MARINERS" | "META";
+/** Mapbox GL layer type we'll use for this entry */
+type GeomType = "fill" | "line" | "circle" | "symbol";
+/** Nautical groupings (loosely follows Chart No. 1 sections) */
+type NauticalCategory = "Depths" | "Land" | "Navigation Aids" | "Hazards" | "Regulated Areas" | "Infrastructure" | "Meta";
+/** Paint properties – a subset we actually use */
+interface AtlasStyle {
+    type: GeomType;
+    paint: Record<string, unknown>;
+    layout?: Record<string, unknown>;
+    /** Nautical symbol ID for symbol-type layers */
+    iconImage?: string;
+}
+/** One row in the S-52 lookup table */
+interface LookupEntry {
+    /** S-57 object class acronym */
+    objectClass: string;
+    /** Human-readable name */
+    name: string;
+    /** Chart No. 1 section */
+    category: NauticalCategory;
+    /** S-52 display category */
+    displayCategory: DisplayCategory;
+    /** Default style using S-52 color tokens (resolved later) */
+    style: AtlasStyle;
+    /** Whether conditional symbology may override the style */
+    hasConditional?: boolean;
+    /** Attributes that affect styling */
+    conditionalAttributes?: string[];
+    /** INT1 / Chart No. 1 reference (e.g. "Q130.1") */
+    int1Ref?: string;
+    /** S-52 viewing group number */
+    viewingGroup?: number;
+    /** Minimum compilation scale for display (SCAMIN) */
+    scamin?: number;
+    /**
+     * Mark this class as deliberately invisible (label-only or metadata-only)
+     * so the layer-coverage audit doesn't flag its geometry-type gaps as bugs.
+     *
+     * Examples:
+     *   - SOUNDG: rendered as depth numbers via labels.ts, not as visible dots
+     *   - LNDRGN: region NAME labels only, no shape
+     *   - M_NPUB / M_NSYS / M_QUAL / M_SREL / DSID: S-57 metadata classes;
+     *     present for click-query attributes, never drawn
+     *
+     * Without this flag, `scripts/audit-layer-coverage.ts` reports the
+     * thousands of features in these classes as "gaps" every week even
+     * though the invisibility is intentional.
+     */
+    auditIgnore?: boolean;
+}
+/** Resolved style ready for Mapbox GL (tokens → hex) */
+interface ResolvedStyle {
+    type: GeomType;
+    paint: Record<string, unknown>;
+    layout?: Record<string, unknown>;
+    minzoom?: number;
+    maxzoom?: number;
+}
 
 /**
- * Post-consolidation (2026-04): one consolidated PMTiles per region, all
- * S-57 classes as distinct MVT layers inside. The MapLibre style emits one
- * vector source (id = region) and N paint layers that reference it via
- * `source-layer` = S-57 class name.
- *
- * `buildSources()` returns either the legacy Mapbox MTS shape (preserved for
- * demos / external style export — see generateStyle comments) or the PMTiles
- * shape pointing at a single tile URL per region.
+ * S-52 lookup table covering all S-57 object classes found in NOAA ENCs.
+ * Colours reference S-52 tokens (resolved at render time).
+ * INT1 references per NOAA Chart No. 1 (Ed 13).
  */
-/** Vector source emitted for the legacy Mapbox MTS path. */
-interface MapboxVectorSource {
-    type: "vector";
-    url: string;
-}
+declare const S52_LOOKUP: Record<string, LookupEntry>;
+
 /**
- * Vector source emitted for the tiles.chrt.co PMTiles path. Uses an explicit
- * `tiles` array (not a TileJSON `url`) because the tile-worker serves raw MVT
- * bytes without a TileJSON descriptor.
+ * S-52 draw order: layers listed bottom → top.
+ * Layers not in this list are inserted before point features.
  */
-interface PmtilesVectorSource {
-    type: "vector";
-    tiles: string[];
-    minzoom: number;
-    maxzoom: number;
-    /** The credit a renderer shows for this source (MapLibre's attribution control). */
-    attribution?: string;
-}
+declare const S52_DRAW_ORDER: string[];
+/** Get numeric draw priority for a layer (lower = drawn first / below) */
+declare function getDrawPriority(layerName: string): number;
+
+/** S-52 display modes */
+type DisplayMode = "BASE" | "STANDARD" | "ALL";
+/** Check if a layer's display category is visible in the given mode */
+declare function isVisibleInMode(displayCategory: DisplayCategory, mode: DisplayMode): boolean;
 /**
- * Terrarium elevation, served as PNG from `CHRT_RELIEF`. Separate from the
- * vector shapes because MapLibre needs `type: "raster-dem"` and an explicit
- * `encoding` — a raster-dem source read as a plain raster renders the encoded
- * RGB as a garish false-colour image rather than as elevation.
+ * Convert S-52 SCAMIN (scale minimum) to Mapbox GL minzoom.
  */
-interface RasterDemSource {
-    type: "raster-dem";
-    tiles: string[];
-    encoding: "terrarium";
-    tileSize: number;
-    minzoom: number;
-    maxzoom: number;
-    /** The credit a renderer shows for this source (MapLibre's attribution control). */
-    attribution?: string;
-}
-type VectorSourceSpec = MapboxVectorSource | PmtilesVectorSource;
-type AnySourceSpec = VectorSourceSpec | RasterDemSource;
-/** CHRTland's vector land base. ADR 0023: its own archive, never chart data. */
-declare const LAND_REGION = "CHRT_LAND";
-/** CHRTland's terrarium relief. */
-declare const RELIEF_REGION = "CHRT_RELIEF";
-/** The world basemap under everything (completing-the-world-map, 2026-08-27). */
-declare const BASE_REGION = "CHRT_BASE";
+declare function scaminToMinZoom(scamin?: number): number | undefined;
+declare function getCollisionSettings(viewingGroup?: number): {
+    iconAllowOverlap: boolean;
+    iconOptional: boolean;
+    symbolSortKey?: number;
+};
 /**
- * CHRT_BASE's zoom range. 11 is the deepest zoom the archive's detail tier
- * carries honestly — the planet's inland water exists from z9 and is read at
- * z10 — and the world tier is tiled to the same depth so no layer vanishes
- * from a tile the detail tier creates. Above 11 the client overzooms, and
- * overzoomed inland water looks soft DELIBERATELY: it is "roughly where the
- * lakes are", not a surveyed shoreline. Must equal the builder's MAXZOOM
- * (tools/chrtbase-build/build.mjs).
+ * Get the resolved Mapbox GL style for a given S-57 layer.
  */
-declare const BASE_MINZOOM = 0;
-declare const BASE_MAXZOOM = 11;
+declare function resolveStyle(layerName: string, geomKind?: GeomType, ct?: ColorTableName, opts?: {
+    safetyContour?: number;
+}): ResolvedStyle;
+declare function getLookupEntry(layerName: string): LookupEntry;
+
 /**
- * The credit the ONLINE CHRT_BASE source carries (owner wording, 2026-09-16).
- *
- * OpenStreetMap is named because the online archive's z9–11 detail tier IS
- * OSM-derived inland water (ODbL, `public/chrtbase-derivation.json`). The
- * app-embeddable offline bundle is a z0–6 cut that contains no OSM data and
- * carries `BASE_BUNDLE_ATTRIBUTION` instead (base-layers.ts) — one credit per
- * artefact, each naming exactly the data it holds.
+ * S-52 Conditional Symbology Procedures.
+ * Each function takes feature properties and returns paint overrides (hex colours).
+ * All expression builders accept an optional colorTable parameter.
  */
-declare const BASE_ATTRIBUTION = "\u00A9 CHRT \u00B7 Made with Natural Earth \u00B7 \u00A9 OpenStreetMap contributors";
 /**
- * The credit the CHRT_LAND source carries. CHRTland's land, land use, roads,
- * places, peaks and marinas are OpenStreetMap via the Protomaps planet, and the
- * ODbL requires this notice wherever the map is shown (.chrt/legal.md
- * "Required notices"). Its other inputs — the ENC's charted land, USGS 3DEP
- * contours, GNIS names — are US federal public domain and owe none. Same
- * string as the offline land bundle's (offline-worker `LAND_PROVENANCE`).
+ * Default safety contour in metres — the depth below which a feature is
+ * "dangerous to my hull" for portrayal purposes.
+ *
+ * This is the single source of truth for the *default* used by every
+ * safety-contour-driven conditional symbology rule, so the rules can't
+ * silently disagree with each other:
+ *
+ *   - §SOUNDG02 — soundings shoaler than the contour get the
+ *     high-contrast shade (see `getLabelConfig` in labels.ts).
+ *   - §CSYM02   — isolated dangers shoaler than the contour get the
+ *     DNGCIR01 ring (see `buildLayersForClass` in layer-builder.ts).
+ *   - §DEPARE04 — the MS/MD shade boundary (owner decision 2026-08-21,
+ *     replacing a hardcoded 5 m middle cut; see the DEPARE block below
+ *     for the full IHO correspondence).
+ *
+ * All are overridden by the user's setting (sounding panel slider,
+ * `safetyContour` in the style options); this is only the fallback when
+ * none is supplied. It matches `custom-style.ts`'s config default.
  */
-declare const LAND_ATTRIBUTION = "\u00A9 OpenStreetMap contributors";
+declare const DEFAULT_SAFETY_CONTOUR_M = 10;
+declare function depareColor(props: Record<string, unknown>, ct?: ColorTableName, safetyContourM?: number): string;
 /**
- * The credit the CHRT_RELIEF source carries. USGS 3DEP elevation, public
- * domain (17 U.S.C. § 105) — no notice is required, so this is a courtesy that
- * names the source. There is no OpenStreetMap in it.
+ * The colour token of each `case` branch of `depareFillExpression`, in branch
+ * order, then the fallback. `depth-area-opaque.ts` names the layers it splits
+ * the expression into from this list, so the two read from one place.
  */
-declare const RELIEF_ATTRIBUTION = "Elevation: USGS 3D Elevation Program";
-/** Terrarium tiles are 512 px; the default 256 would halve the apparent relief. */
-declare const RELIEF_TILE_SIZE = 512;
+declare const DEPARE_FILL_BRANCH_TOKENS: readonly ["DEPIT", "DEPVS", "DEPMS", "DEPMD"];
+declare const DEPARE_FILL_FALLBACK_TOKEN = "DEPDW";
+declare function depareFillExpression(ct?: ColorTableName, safetyContourM?: number): unknown[];
+declare function lightColor(props: Record<string, unknown>, ct?: ColorTableName): string;
+declare function lightFillExpression(ct?: ColorTableName): unknown[];
+declare function lateralColor(props: Record<string, unknown>, ct?: ColorTableName): string;
+declare function lateralFillExpression(ct?: ColorTableName): unknown[];
+declare function hazardColor(props: Record<string, unknown>, ct?: ColorTableName): string;
+declare function hazardFillExpression(ct?: ColorTableName): unknown[];
+declare function daymarkColor(props: Record<string, unknown>, ct?: ColorTableName): string;
+
 /**
- * How `CHRT_RELIEF`'s PNGs encode elevation. MapLibre's raster-dem default is
- * `mapbox`, which decodes terrarium RGB into nonsense heights — so every
- * surface that describes this source (this registry, the tile-worker's
- * TileJSON) has to say it.
+ * Label configurations for S-57 layers.
+ * Defines which layers get text labels and how to extract label text.
  */
-declare const RELIEF_ENCODING = "terrarium";
-type SourceMode = "mapbox" | "pmtiles";
+
 /**
- * Query parameter carrying the resolved build id on every tile URL.
- *
- * ── Why the build has to be IN THE URL ────────────────────────────────────
- *
- * The Worker reports the build it served in the `X-Build-Id` RESPONSE HEADER
- * and sends `Cache-Control: private, max-age=3600`. A header is not part of a
- * cache key, so every build shares one URL: after a cutover, tiles the client
- * already fetched keep coming from its own HTTP cache — the old build — while
- * newly-panned-to tiles come from the new one, for up to the full hour. The
- * client renders TWO BUILDS AT ONCE.
+ * Feature-class hierarchy for SEAARE labels. Returns a tier number 1-5 per
+ * feature:
  *
- * On a nautical chart that is not a cosmetic seam. Measured live 2026-08-25,
- * cutting `CHRT_LAND` from `463b265e` to `dbb69074` (a build that deliberately
- * changes land extent): adjacent tiles disagreed about whether land was there,
- * at the seam between them. Putting the build in the key gives each build its
- * own cache namespace — old entries age out untouched, and the next style
- * build flips the whole viewport at once instead of tile by tile.
+ * Exported (with the other tier builders below) for the build-side parity
+ * test: CHRTbaremetal replicates these taxonomies as data in
+ * tools/chrt-baremetal/server/src/tilebuild/placeNameTiers.ts to stamp
+ * `tier` onto PLACENAME index features, and
+ * placename-tier-parity.test.ts evaluates the two against shared
+ * fixtures. Change a branch here and that test names the drift.
  *
- * ── Why a QUERY PARAMETER and not a path segment ──────────────────────────
+ *   1 — Ocean              (OBJNAM contains "<X> Ocean" — CATSEA has no
+ *                          ocean code; the attribute is 1/unset on oceans)
+ *   2 — Sea / Gulf         (OBJNAM "Gulf of …" / "… Sea")
+ *   3 — Bay / Sound /      (CATSEA in {5 bay, 12 narrows} OR OBJNAM
+ *       Strait / Narrows    " Bay" / " Sound" / " Strait")
+ *   4 — Anchorage detail   (OBJNAM contains "Anchorage Area")
+ *   5 — Relief + default   (CATSEA relief codes — authoritative — or
+ *                          relief-term names, or anything uncategorised;
+ *                          suppressed below z9 by the size curve)
  *
- * A path segment would be the tidier-looking URL and it is the wrong trade
- * here, for two reasons that are both about other people's code:
+ * Order matters: tier-4/5 demotions (anchorages, relief) run BEFORE the
+ * promotion shims so "Bear Seamount" (contains " Sea") and "…Anchorage
+ * Area" compound names can't bubble up into headline tiers.
+ * `coalesce(CATSEA, catsea)` handles post-tippecanoe case variation
+ * (matches `s52-conditional.ts` precedent).
+ */
+declare function buildSeaAreaTierExpression(): ExpressionSpecification;
+/**
+ * Built-up area tier (BUAARE): major city / town / neighborhood.
+ *   1 — Major city (CATBUA=1 urban, or OBJNAM length <= 8)
+ *   2 — Town (CATBUA=5 village, or OBJNAM length <= 14)
+ *   3 — Neighborhood (longer compound names)
  *
- *   1. COMPATIBILITY IS PERMANENT, NOT "one release". iOS and desktop are
- *      prod-only clients that ship on their own cadence. The Worker routes on
- *      `url.pathname` (`TILE_ROUTE_PATH`) and reads only `?build=`, so a URL
- *      carrying this parameter routes BYTE-IDENTICALLY to one without it. A
- *      new path segment would instead need a second route regex kept alive
- *      indefinitely.
- *   2. FIVE SEPARATE PATTERNS ALREADY MATCH THIS URL, and every one of them
- *      ends `(?:\?.*)?$` — `src/lib/map/tile-token-client.ts` TILE_URL_PATH
- *      and `src/site/chart/sail-tile-token.ts` (which decide whether a tile
- *      gets its Bearer), `packages/sdk/src/tile-auth.ts` TILE_URL_PATH,
- *      `public/chrt-tile-sw.js` TILE_URL_RE (which also reads the region out of
- *      the URL to pick its per-region cache), and
- *      `src/site/offline/pack-protocol.ts` TILE_URL (which rewrites a tile to
- *      a downloaded pack). Their optional PATH segment, by contrast, is
- *      `[a-z][a-z0-9-]*` — letter-first so it cannot be confused with the
- *      numeric `{z}` — and build ids are hex (`463b265e`, `4de67273`). A build
- *      in the path would miss every one of them, and a tile those patterns
- *      miss does not merely go uncached: it goes out with NO BEARER and comes
- *      back 401, which MapLibre records as a permanently errored tile. That is
- *      the exact failure the `.png` drift caused on staging-sail (see
- *      `chrt-tile-sw.js`).
+ * Tier 1/2 may fire via CATBUA when populated; OBJNAM length is the
+ * fallback so unpopulated CATBUA still produces a usable hierarchy.
+ */
+declare function buildBuiltUpAreaTierExpression(): ExpressionSpecification;
+/**
+ * Land region tier (LNDRGN): major region vs. local point.
+ *   1 — Major region (OBJNAM length <= 12 AND no comma — "Long Island", "Cape Cod")
+ *   2 — Local point (else — "Bird Island", "Cottage Park")
  *
- * The query string is also what the caches this fix targets actually key on:
- * the browser HTTP cache, MapLibre's own tile cache, and the Service Worker's
- * `new Request(req.url)` entry key all include it.
+ * No CATLND analog for region scope, so OBJNAM is the only signal.
+ * The comma-absence test is a heuristic: NOAA compound names like
+ * "Boston Harbor, MA Castle Island" carry a comma and belong at deeper
+ * zoom regardless of length.
+ */
+declare function buildLandRegionTierExpression(): ExpressionSpecification;
+/**
+ * Land area tier (LNDARE): major vs. local.
+ *   1 — Major (OBJNAM length <= 12)
+ *   2 — Local
  *
- * `v` rather than `build`: `?build=` is a taken name with a strict meaning on
- * the Worker (`?build=candidate`, employee-only, 400 on any other value).
+ * No category attribute. OBJNAM length is the only signal.
+ */
+declare function buildLandAreaTierExpression(): ExpressionSpecification;
+/**
+ * Lake tier (LAKARE): lake vs. reservoir/pond.
+ *   1 — Lake (CATLAK=1, or OBJNAM length <= 12)
+ *   2 — Reservoir/pond (CATLAK in {2,3}, or longer name)
+ */
+declare function buildLakeTierExpression(): ExpressionSpecification;
+/**
+ * River tier (RIVERS): major vs. local.
+ *   1 — Major river (OBJNAM length <= 15 AND no comma)
+ *   2 — Local creek (else)
  */
-declare const BUILD_PARAM = "v";
+declare function buildRiverTierExpression(): ExpressionSpecification;
 /**
- * One tile-URL template — the single place a CHRT tile URL is spelled.
+ * Airport tier (AIRARE): major airport vs. small airstrip.
+ *   1 — Major (OBJNAM length <= 25 — e.g. "Logan International Airport")
+ *   2 — Airstrip
+ */
+declare function buildAirportTierExpression(): ExpressionSpecification;
+interface LabelLayerConfig {
+    /** Mapbox source layer type */
+    type: "symbol";
+    /** Text field expression or string */
+    textField: ExpressionSpecification | string;
+    /** Text size in pixels */
+    textSize: number | ExpressionSpecification;
+    /** Text color (hex) or data-driven expression */
+    textColor: string | ExpressionSpecification;
+    /** Halo color for contrast */
+    textHaloColor: string;
+    /** Halo width — pixels or zoom-interpolation expression */
+    textHaloWidth: number | ExpressionSpecification;
+    /** Text offset [x, y] in ems */
+    textOffset: [number, number];
+    /** Font stack */
+    textFont?: string[];
+    /** Additional layout properties */
+    layout?: Record<string, unknown>;
+    /** Minimum zoom level for this label */
+    minzoom?: number;
+}
+/**
+ * Optional palette-and-data-driven options for label config.
  *
- * `buildId` is encoded rather than interpolated raw: MapLibre substitutes
- * `{z}`/`{x}`/`{y}` by brace-matching the template, so an id containing a
- * brace would corrupt every tile request. Empty / whitespace-only ids emit no
- * parameter at all instead of a bare `?v=` that would key its own useless
- * cache namespace.
+ * Currently used by SOUNDG to pick palette-aware text/halo colors and to
+ * drive the S-52 safety-contour two-shade rule. Other classes ignore
+ * these options.
  */
-declare function tileTemplate(base: string, region: string, extension: "mvt" | "png", buildId?: string): string;
-/** Canonical source id used in `generateStyle()` — matches the region name
- *  of the one consolidated PMTiles served by the tile-worker for this region. */
-declare const DEFAULT_REGION = "NOAA_ENC";
-interface BuildSourcesOptions {
-    /** Which tile path to emit. Default: "pmtiles" (the supported path post-Mapbox). */
-    mode?: SourceMode;
-    /** Chart region. Default: "NOAA_ENC". */
-    region?: string;
-    /**
-     * Build id of the CHART region (`region`) — the `build_tag` a
-     * `mint-tile-token` response hands back.
-     *
-     * Emitted as the {@link BUILD_PARAM} query parameter on that region's tile
-     * template. See {@link tileTemplate} for why a build discriminator has to be
-     * in the URL at all.
-     *
-     * ⚠ THIS COVERS THE CHART REGION ONLY. A token is minted for one chart
-     * region and `CHRT_LAND` / `CHRT_RELIEF` ride it, so the JWT's `build_tag`
-     * says nothing about a land cutover — the same blind spot that made the
-     * Worker's edge-cache key wrong until `TILE_CACHE_VERSION` v3
-     * (cloudflare/tile-worker/src/cache-encoding.ts). Pass {@link buildTags} to
-     * discriminate the basemap sources too.
-     */
-    buildTag?: string;
-    /**
-     * Resolved build id per region — `{ NOAA_ENC: "…", CHRT_LAND: "…" }`.
-     *
-     * The complete form of {@link buildTag}: every source this style declares
-     * gets its own discriminator, so a `CHRT_LAND` promotion turns over the land
-     * URLs without touching the chart's (and vice versa). An entry here wins
-     * over `buildTag` for the same region.
-     *
-     * This is the mint response's `build_tags` map verbatim (claim contract
-     * v1.7) — `TileTokenResponse.buildTags` in both `lib/map/tile-token-client.ts`
-     * and the SDK's `tile-auth.ts`. The same map already keys the tile Service
-     * Worker's per-region caches; passing it here puts the same identity in the
-     * URL, so the layer above the Service Worker stops mixing builds too.
-     *
-     * A region absent from the map simply gets no discriminator — the URL it
-     * has always had. That is a deliberate soft edge: an older mint response, or
-     * a region with no servable build, must degrade to today's behaviour rather
-     * than emit a URL pinned to a build nobody resolved.
-     */
-    buildTags?: Readonly<Record<string, string>>;
-    /** Override tile-worker origin (e.g. staging). Default: DEFAULT_TILE_BASE_URL. */
-    tileBaseUrl?: string;
+interface LabelConfigOptions {
+    /** S-52 colour table — drives palette-aware text and halo colors. */
+    colorTable?: ColorTableName;
     /**
-     * Emit the CHRTland vector land base as a second source (ADR 0023). Off by
-     * default: it costs a source, and the region must be granted on the token.
+     * Safety contour depth in metres. Soundings shoaler than this render in
+     * `SNDG2` (high-contrast); deeper soundings render in `SNDG1` (muted).
+     * S-52 §SOUNDG02 conditional symbology.
      */
-    land?: boolean;
+    safetyContour?: number;
     /**
-     * Emit CHRTland's terrarium relief as a raster-dem source. Separate from
-     * `land` because relief needs a raster-capable worker AND a grant that
-     * `land-regions.ts` still withholds.
+     * When false, all soundings render in `SNDG2` (single-shade). Default
+     * true — emit the safety-contour case expression.
      */
-    relief?: boolean;
+    twoShadeSoundings?: boolean;
     /**
-     * Emit the CHRT_BASE world basemap as a third vector source — the dark
-     * geography under everything, the tan jurisdiction fill, and the rough
-     * inland water inside countries CHRT carries. Its layers sit UNDER the
-     * no-coverage hatch's companions and everything else; see baseLayers().
+     * When "semibold", SOUNDG labels use Open Sans Semibold for crisper
+     * numerals at small sizes. Default "semibold".
      */
-    base?: boolean;
+    soundingFontWeight?: "regular" | "semibold";
 }
 /**
- * Build the "sources" block for a CHRT style.
+ * Two-tier label rendering strategy for the band-priority style.
  *
- * - `mode: "mapbox"`: one mapbox:// url (kept for external style export only).
- * - `mode: "pmtiles"` (default): one vector tile endpoint for the region,
- *   routed by the Worker to the one consolidated PMTiles:
- *   `${tileBaseUrl}/v1/tiles/{region}/{z}/{x}/{y}.mvt`
+ * `feature-band-gated` — emit one variant per source band, each gated to
+ * its band's zoom window (the existing `makeBandVariants` behaviour). Right
+ * for dense feature labels where seeing the same buoy designation or
+ * sounding twice across overlapping bands is visual noise.
  *
- * Pass `buildTag` / `buildTags` to pin each source's URL to the build it is
- * serving — without that, one URL is shared by every build and a cutover
- * leaves the client rendering two of them at once. See {@link BUILD_PARAM}.
+ * `orientation-cross-band` — emit a SINGLE label layer with no band
+ * filter. The per-class `minzoom` is honoured. Right for orientation
+ * "where am I" labels (sea-area names, land regions, cities) — these
+ * must persist as the user zooms in, even if the broader-scope cell
+ * carrying the OBJNAM is from a coarser band than the one rendering
+ * features at the current zoom. Collision arbitration via
+ * `ORIENTATION_BAND_SORT_KEY` gives the broader-scope (lower-band) copy
+ * priority where the same OBJNAM exists in multiple bands.
  */
-declare function buildSources(opts?: BuildSourcesOptions): Record<string, AnySourceSpec>;
-
+type LabelBehavior = "feature-band-gated" | "orientation-cross-band";
+declare const LABEL_BEHAVIOR: Record<string, LabelBehavior>;
+/** Returns the rendering strategy for an S-57 class. Unknown classes default to band-gated. */
+declare function getLabelBehavior(layerName: string): LabelBehavior;
 /**
- * DEPTH NUMBERS — how big the chart draws its depth figures.
- *
- * Asked for from the helm (chip 68, 2026-10-05), by a captain running CHRTsail
- * desktop on a Raspberry Pi: *"I still need the depth numbers to be bolder
- * which may be a setting. I just can't sail the boat and adjust all that stuff
- * at the same time."* A set-and-forget choice, then, not a slider.
- *
- * ===========================================================================
- * WHAT "LARGE" CHANGES, AND WHAT IT IS NOT ALLOWED TO TOUCH
- * ===========================================================================
+ * Class-based label priority ladder — THE single collision-priority model
+ * for feature labels (portrayal-excellence P4). Converges the previous
+ * per-mechanism patches (SAFETY_CRITICAL_LABELS allow-overlap, the
+ * band-5/6-only Harbor collision discipline) into one explicit ranking.
  *
- * It changes the SIZE of the glyphs (and, where a class was Regular, the
- * WEIGHT, to the Semibold soundings already use), the halo a little — see
- * `LARGE` for why less than the glyph — and the sounding collision padding —
- * see `LARGE_SOUNDING_PADDING_PX` for why that one moves.
+ * Rank semantics: LOWER rank = higher priority. The rank drives two
+ * mechanisms that must stay in agreement:
  *
- * It does not touch, and `depth-label-size.test.ts` holds every one of these
- * equal to the Standard style in every palette and every symbol family:
+ *   1. `symbol-sort-key` — every feature label carries
+ *      `rank*1000 + within-class-key`, so if label layers are ever merged
+ *      (the P8 style fan-out reduction), placement priority survives the
+ *      merge unchanged.
+ *   2. Label LAYER ORDER — MapLibre places symbols topmost-layer-first, so
+ *      `style-generator.ts` emits feature-label layers lowest-priority
+ *      first: safety-critical classes end up topmost and claim collision
+ *      space before anything else. (`symbol-sort-key` alone cannot do
+ *      this — it only orders placement WITHIN a layer.)
  *
- *   - `text-field` — the number itself, its unit conversion, its rounding.
- *     ENC content is never altered; a bigger "4" is still the cell's "4".
- *   - `text-color` / `text-halo-color` — §SOUNDG02's two shades against the
- *     safety contour, and the palette that draws them (red night included:
- *     it IS the NIGHT chart). A depth number shoaler than the contour stays
- *     the loud one.
- *   - `symbol-sort-key` — shallowest wins a collision, at any size.
- *   - `filter`, `minzoom`, `maxzoom`, layer ids and layer order — so the
- *     resident layer set the desktop builds at boot is the same set, and a
- *     switch is `setLayoutProperty` / `setPaintProperty` on layers already
- *     there. No layer and no draw call is added; what costs more is GPU fill,
- *     because a bigger glyph covers more pixels (about 6–7 % more blended
- *     fragments per pixel on the chart bench — the PR has the numbers).
+ * The ladder (safety-critical > nav-aids > depth field > structures >
+ * ambient notes):
  *
- * ===========================================================================
- * WHICH LABELS ARE "DEPTH NUMBERS"
- * ===========================================================================
+ *   100 — Safety-critical: light characteristics (LIGHTS), hazard depth
+ *         callouts (UWTROC/OBSTRN/WRECKS VALSOU), overhead clearances
+ *         (CBLOHD/PIPOHD VERCLR). Irreducible mariner-safety text.
+ *   200 — Nav-aid designations: buoy / beacon `R "4"` labels.
+ *   250 — Auxiliary nav-aid info: fog signal type (FOGSIG).
+ *   300 — Depth field: soundings, contour values. Individually droppable —
+ *         a hidden sounding has visible neighbors.
+ *   400 — Structures: bridges, landmarks, piers, moorings, buildings.
+ *   500 — Ambient annotation: seabed nature, magnetic variation, kelp.
+ *   900 — Orientation names (SEAARE etc.) — not part of this ladder;
+ *         they keep their settled watermark model (cell-band fan +
+ *         dominance composition + `orientationLabelLayout`) and always
+ *         paint underneath feature labels.
  *
- * Exactly the ones the depth-unit switch converts (`buildLabelLayer` in
- * `layer-builder.ts`): soundings, contour values, and the depth printed beside
- * a rock, wreck or obstruction. The unit switch already treats those three as
- * one claim — its own note says a rock's figure "is the SAME depth claim as a
- * sounding" — and a size switch that enlarged the soundings around a rock but
- * left the rock's own depth small would make the hazard the quietest number
- * on that part of the chart.
+ * Safety guardrail: a lower rung never blocks a higher rung — placement
+ * order guarantees the safety-critical label got the space first. Density
+ * relief comes from dropping the LOWEST rung in a pile-up, never the top.
+ */
+declare const LABEL_PRIORITY: Record<string, number>;
+/**
+ * Resolve the priority rank for an S-57 class's label. Orientation classes
+ * report 900 regardless of ladder membership (PRDARE etc.) so the
+ * layer-order sort in style-generator.ts can treat priority uniformly.
+ */
+declare function getLabelPriority(layerName: string): number;
+/**
+ * Compose a `symbol-sort-key` from a class rank and an optional
+ * within-class key expression. The within-class key is clamped to
+ * [0, 999] so it can never bleed into a neighboring rank's band.
+ */
+declare function labelSortKey(rank: number, within?: unknown): ExpressionSpecification | number;
+/**
+ * Extract the trailing designation token from a nav-aid OBJNAM.
  *
- * Not the dredged-channel note (`DRGNOTE`): it is a sentence fitted inside
- * its own channel polygon at a computed size, and scaling it would stop it
- * fitting. Not the bridge note: a clearance is a height, not a depth.
+ * NOAA names channel aids "<waterway> <type> Buoy|Beacon <designation>"
+ * where the designation is 1-4 alphanumerics: "4", "18A", "B", "BG".
+ * Returns null when the name has no designation (trailing token is a
+ * stopword type-name, or longer than 4 chars).
  *
- * ===========================================================================
- * WHY NOT A BOLD FACE
- * ===========================================================================
+ * This is the TS twin of `navAidDesignationTextExpression` — the GeoJSON
+ * preprocessing path uses this function, the PMTiles path uses the GL
+ * expression. Keep the two in agreement (see label-priority.test.ts).
+ */
+declare function extractNavAidDesignation(objnam: string): string | null;
+/** Get label config for a given S-57 layer, or null if no labels */
+declare function getLabelConfig(layerName: string, opts?: LabelConfigOptions): LabelLayerConfig | null;
+/**
+ * Build a Mapbox symbol layer spec from a label config.
+ */
+declare function buildLabelLayer(layerId: string, sourceId: string, config: LabelLayerConfig, visible: boolean, overrides?: {
+    textScale?: number;
+    minzoom?: number | null;
+    allowOverlap?: boolean;
+}): maplibregl.LayerSpecification;
+/**
+ * Pre-process SOUNDG GeoJSON to extract Z coordinates as `depth` properties.
+ * Soundings are MultiPoint with Z values in geometry.coordinates[][2].
+ * This explodes MultiPoints into individual Points with a `depth` property.
+ */
+declare function preprocessSoundings(fc: GeoJSON.FeatureCollection): GeoJSON.FeatureCollection;
+/**
+ * Pre-process LIGHTS GeoJSON to derive compact light characteristic labels.
+ * Adds `_lightLabel` property (e.g., "Fl(2) WR 4s 5M").
  *
- * The chart's glyph sets are Open Sans Regular, Semibold and Italic — the tile
- * worker's `/v1/glyphs` (`cloudflare/tile-worker/glyphs/GLYPHS.json`) and the
- * offline chart-assets pack serve those three and nothing else, and a
- * fontstack no glyph host serves is the failure `labels.ts`'s SOUNDG note
- * describes (Native lost every sounding). Soundings are already Semibold. So "bolder" here is
- * size: stroke width scales with the glyph, and at 1x device pixels (a Pi's
- * panel) a 14 px Semibold numeral is both heavier and crisper than a 10 px one.
+ * KEEP IN STEP WITH `buildLightLabelExpression()` in layer-builder.ts — that
+ * is the same label built as a GL expression for the tile path, which has no
+ * JS preprocessing step. `light-label-parity.test.ts` asserts the two agree
+ * on real tile features; if you change one, change both.
+ */
+declare function preprocessLights(fc: GeoJSON.FeatureCollection): GeoJSON.FeatureCollection;
+/** List of layers that have labels */
+declare const LABELED_LAYERS: Set<string>;
+/**
+ * Pre-process buoy/beacon GeoJSON to derive concise mariner-style labels.
+ * Adds `_navAidLabel` property (e.g., 'R "8"', 'G "5"').
+ */
+declare function preprocessNavAids(fc: GeoJSON.FeatureCollection): GeoJSON.FeatureCollection;
+/** Check if a layer name needs nav aid preprocessing */
+declare function isNavAidLayer(layerName: string): boolean;
+/**
+ * Pre-process water body polygon GeoJSON into centroid points for label placement.
+ * Computes a simple average-coordinate centroid for each polygon feature that has OBJNAM.
+ */
+declare function preprocessWaterBodies(fc: GeoJSON.FeatureCollection): GeoJSON.FeatureCollection;
+/** MVT layer the build-side place-name index emits. */
+declare const PLACENAME_SOURCE_LAYER = "PLACENAME";
+/** Orientation classes whose names render italic (water voice). */
+declare const PLACENAME_WATER_CLASSES: readonly string[];
+/** Orientation classes whose names render upright (land voice). */
+declare const PLACENAME_LAND_CLASSES: readonly string[];
+/**
+ * The 2 PLACENAME symbol layers. Layout contract (design §2.2): collision
+ * ON (`allow-overlap: false`, `ignore-placement: false`,
+ * `optional: true`), padding 4, `text-variable-anchor`, and
+ * `symbol-sort-key` straight from the build-side `rank` — MapLibre places
+ * LOWER sort keys first, and rank is minted lower-is-more-important
+ * (tier major, bbox area minor), so when space runs out the biggest names
+ * survive. That ranking is the per-zoom density governor P4 asked for.
  */
+declare function buildPlaceNameLayers(sourceId: string, ct?: ColorTableName): maplibregl.LayerSpecification[];
 
-/** The two choices, in presentation order. */
-declare const DEPTH_LABEL_SIZES: readonly ["standard", "large"];
-type DepthLabelSize = (typeof DEPTH_LABEL_SIZES)[number];
 /**
- * Standard is the chart as it has always been drawn, and it is what a style
- * generated without the option gets: byte-identical, so the served style, the
- * native-render goldens and every client that never asks are unchanged.
+ * Spatial grid-based feature decimation for performance at low zoom levels.
+ * Thins dense GeoJSON feature sets by keeping only one representative
+ * feature per grid cell per layer.
  */
-declare const DEFAULT_DEPTH_LABEL_SIZE: DepthLabelSize;
-/** Case-insensitive; anything unrecognised is `null`, never a throw. */
-declare function parseDepthLabelSize(raw: string | null | undefined): DepthLabelSize | null;
-/** The S-57 classes whose label is a depth figure. See the header. */
-declare const DEPTH_LABEL_CLASSES: ReadonlySet<string>;
+interface DecimationOptions {
+    /** Grid resolution (cells per axis). Default 80. */
+    gridSize?: number;
+    /** Zoom level below which decimation kicks in. Default 12. */
+    zoomThreshold?: number;
+}
 /**
- * Sounding collision padding at Large, px. Standard is 6.
- *
- * ⚠ THIS IS THE ONE THAT DECIDES HOW MANY SOUNDINGS SURVIVE. MapLibre drops a
- * sounding whose box (glyphs + padding) overlaps one already placed — the
- * shallowest places first, so what drops is the deeper figure. A 1.4x numeral
- * inside Standard's 6 px padding lost a quarter of the soundings: bigger
- * numbers, fewer of them, which is not what was asked for. Trimming the
- * padding gives the box back.
- *
- * Measured 2026-10-05 on the chart bench (`scripts/chart-bench`, Boston, DAY,
- * 1280x800 at 1x), soundings placed, Standard → Large at this padding:
- *
- *   z11.5  515 → 539 (+5%)    z12.3  434 → 415 (−4%)
- *   z13    374 → 366 (−2%)    z14    326 → 311 (−5%)
- *
- * and at Standard's 6 px: 391 / 246 at z11.5 / z14 (−24% / −25%). 3 px kept
- * z14 level but put 17% MORE figures on the coastal view, which reads as
- * clutter rather than as the same chart drawn bigger.
+ * Zoom-adaptive grid resolution for decimation.
  */
-declare const LARGE_SOUNDING_PADDING_PX = 3.5;
+declare function getGridSizeForZoom(zoom: number): number;
 /**
- * Apply a depth-label size to one generated label layer.
+ * Decimate a GeoJSON FeatureCollection using spatial grid thinning.
+ * Only runs when zoom < zoomThreshold. Returns the original FC otherwise.
  *
- * Standard — and any class that is not a depth figure — returns the SAME
- * object, untouched. Large returns a copy with only the properties listed in
- * the header changed.
+ * @param fc - Input FeatureCollection
+ * @param layerName - S-57 layer name (affects priority logic)
+ * @param currentZoom - Current map zoom level
+ * @param bounds - Current viewport bounds
+ * @param opts - Decimation options
  */
-declare function applyDepthLabelSize(objectClass: string, layer: StyleLayer, size: DepthLabelSize | undefined): StyleLayer;
-
+declare function decimateFeatures(fc: GeoJSON.FeatureCollection, layerName: string, currentZoom: number, bounds: {
+    west: number;
+    south: number;
+    east: number;
+    north: number;
+}, opts?: DecimationOptions): GeoJSON.FeatureCollection;
 /**
- * Builds Mapbox GL Style layer specs from S-52 lookup entries.
- * Wraps the existing atlas resolveStyle() and adds source/source-layer/filter.
+ * Get the max number of cells to load based on zoom level.
  */
+declare function getMaxCellsForZoom(zoom: number): number;
 
-interface StyleLayer {
-    id: string;
-    type: string;
-    source: string;
-    "source-layer": string;
-    filter?: unknown[];
-    paint: Record<string, unknown>;
-    layout?: Record<string, unknown>;
-    minzoom?: number;
-    maxzoom?: number;
-    metadata?: Record<string, unknown>;
-}
 /**
- * Build all Mapbox GL layers for a given S-57 object class.
- * Returns multiple layers (fill, outline, symbol, label, etc.).
+ * IHO S-52 / NOAA Chart No. 1 / INT1 nautical symbol SVGs.
  *
- * Post-consolidation: all S-57 classes live as MVT layers inside one
- * consolidated PMTiles per region; `source` is always the region name.
+ * Complete symbology suite following:
+ *   - IHO S-52 Presentation Library (Ed 4.0)
+ *   - IALA Maritime Buoyage System R1001 (Region B for US waters)
+ *   - NOAA Chart No. 1 (Ed 13) / INT1
  *
- * `opts.safetyContour` is the mariner's safety depth in metres — it drives
- * the §CSYM02 isolated-danger ring on hazard classes. Defaults to
- * `DEFAULT_SAFETY_CONTOUR_M`, the same default the SOUNDG two-shade rule
- * uses, so the ring and the sounding colour always agree.
+ * Buoy shape terminology (US / Chart No. 1):
+ *   - CAN (Q20): Flat-top cylindrical buoy — Port mark in IALA-B (red)
+ *   - NUN (Q21): Conical/pointed-top buoy — Starboard mark in IALA-B (green)
+ *   - PILLAR: Tall narrow buoy — used for cardinal, isolated danger, etc.
+ *   - SPAR: Tall thin pole buoy
+ *   - SPHERICAL: Round buoy — safe water marks
+ *   - BARREL: Barrel/tun shaped buoy
+ *   - SUPER: Large navigation buoy / LANBY
+ *
+ * Cardinal mark topmark orientations (IALA):
+ *   - North: both cones point UP ▲▲
+ *   - South: both cones point DOWN ▼▼
+ *   - East:  cones base-to-base (diamond) ◆
+ *   - West:  cones point-to-point (hourglass) ⊗
+ *
+ * Each symbol is a compact SVG at 32×32 for Mapbox GL `map.addImage()`.
  */
-declare function buildLayersForClass(objectClass: string, ct: ColorTableName, sourceId?: string, opts?: {
-    safetyContour?: number;
-}): StyleLayer[];
+/** Color used in the SVG with its S-52 token name, hex, and usage */
+interface SymbolColor {
+    token: string;
+    hex: string;
+    usage: string;
+}
+/** Line style used in the SVG */
+interface SymbolLineStyle {
+    element: string;
+    width: number;
+    pattern?: string;
+    color: string;
+}
+/** Fill element used in the SVG */
+interface SymbolFillElement {
+    element: string;
+    color: string;
+    opacity?: number;
+}
+interface NauticalSymbol {
+    id: string;
+    label: string;
+    /** INT1 / Chart No. 1 reference */
+    int1Ref: string;
+    /** Chart No. 1 section letter */
+    section: string;
+    getSvg: () => string;
+    /** Generate SVG with theme-specific colors (for bridge icons etc.) */
+    getThemedSvg?: (chblk: string, movable: string) => string;
+    /** What this symbol represents on a chart */
+    description?: string;
+    /** S-52 Presentation Library symbol name */
+    s52PlRef?: string;
+    /** S-57 object class (e.g. "LNDMRK") when it can't be derived from s52PlRef's prefix */
+    s57Class?: string;
+    /** Grouping key for family clustering */
+    group?: string;
+    /** IDs of related variant symbols */
+    variants?: string[];
+    /** S-57 attribute that selects this variant */
+    attributeKey?: string;
+    /** Value of that attribute for this variant */
+    attributeValue?: number;
+    /** Example label strings seen on charts */
+    labelExamples?: string[];
+    /** What the color represents */
+    colorMeaning?: string;
+    /** Colors used in the SVG */
+    colors?: SymbolColor[];
+    /** Line/stroke styles used in the SVG */
+    lineStyles?: SymbolLineStyle[];
+    /** Fill regions in the SVG */
+    fillElements?: SymbolFillElement[];
+    /** Expanded navigational usage context (2-4 sentences) */
+    usageContext?: string;
+    /** Render size for documentation */
+    renderSize?: string;
+}
+/** A logical grouping of related symbols */
+interface SymbolGroup {
+    id: string;
+    label: string;
+    section: string;
+    description: string;
+    symbolIds: string[];
+}
+/** Chart No. 1 section metadata */
+interface ChartSection {
+    id: string;
+    label: string;
+    description: string;
+}
+declare const NAUTICAL_SYMBOLS: NauticalSymbol[];
+/** S-57 object class → default symbol ID mapping.
+ *  Values are S-52 PL symbol names (matching SVG filenames in s52/point/).
+ *  Conditional expressions in getIconExpression() override these for classes
+ *  with attribute-dependent variants.
+ */
+declare const SYMBOL_MAP: Record<string, string>;
+/** Get the Mapbox icon-image expression for data-driven symbol selection.
+ *  Returns S-52 PL symbol names that correspond to SVG files in s52/point/.
+ */
+declare function getIconExpression(layerName: string): string | unknown[];
 /**
- * Get the full ordered list of object classes for style generation.
- * Uses S52_DRAW_ORDER as base, then adds any missing classes from the
- * S-52 lookup table so a newly-ingested class automatically gets styled
- * without touching this file.
+ * Browser-only image loaders (`loadSymbolImages`, `loadThemedBridgeImages`)
+ * live in `./symbols-browser.ts` (sub-export `@chrtco/sdk/atlas/browser`) —
+ * they require a DOM (use `new Image()` + `map.addImage()`).
  */
-declare function getOrderedClasses(): string[];
+/** Get inline SVG string for a symbol by ID (for the Atlas legend) */
+declare function getSymbolSvgString(symbolId: string): string | null;
+declare const CHART_SECTIONS: ChartSection[];
+declare const SYMBOL_GROUPS: SymbolGroup[];
+/** Generate a single SVG sprite sheet containing all symbols as <symbol> elements */
+declare function generateSpriteSheet(): string;
+/** Generate a JSON manifest mapping symbol IDs to metadata */
+declare function generateSpriteManifest(): Record<string, {
+    label: string;
+    int1Ref: string;
+    section: string;
+    group?: string;
+    s52PlRef?: string;
+    description?: string;
+    attributeKey?: string;
+    attributeValue?: number;
+}>;
 
 /**
- * Dominance fan-out collapse (P8 Phase 3.3 / D4 "axis 1").
- *
- * `makeBandVariants()` historically emitted, per (class, band): one
- * "not-dominated" layer plus up to five `-domBy{D}` copies that differ ONLY
- * in their dominance filter and a `maxzoom` of `dominatedVariantMaxzoom(D)`.
- * That fan existed because MapLibre filters could not read `["zoom"]`. They
- * can now (style-spec 24.8.5; buckets evaluate at the tile's `overscaledZ`),
- * so the whole fan folds into ONE layer per (class, band) whose filter
- * carries the zoom gate.
- *
- * **Construction principle — read before changing anything here.** The
- * collapsed filter is the literal `["any"]` UNION of the clauses the fan
- * already encoded: every variant the legacy emitter would have produced
- * contributes exactly one `["all", <its dominance filter>, ["<", ["zoom"],
- * <its maxzoom>]]` clause, and the dead-variant skip is mirrored too.
- * Equivalence is therefore *structural*, not re-derived — which matters,
- * because the two "obvious" hand-written forms are both wrong:
- *
- *   1. A `["match", ["get","_dominated_by_min"], 2,5, 3,7, 4,9, 5,11, 6,11, 24]`
- *      threshold (the form the design doc proposed) uses band 6's *eligibility*
- *      zoom 11. The real ceiling is `dominatedVariantMaxzoom("6") = 13` — band
- *      6's DATA floor. Using 11 reopens the z11–z12 void window that
- *      `band-priority.ts` documents closing.
- *   2. That same form silently drops the legacy `_dominated: true` boolean,
- *      which `dominatedByMinFilter("6")` still honours. A legacy-tagged feature
- *      has no `_dominated_by_min`, so `match` falls to its default and the
- *      feature renders FOREVER instead of dropping at z13.
- *
- * Deriving the gate from the emitter's own clauses avoids both by construction.
- * `band-collapse.test.ts` re-proves it on every CI run by differentially
- * evaluating legacy-vs-collapsed through MapLibre's real three gates.
+ * IHO S-101 ENC Product Specification — Feature Catalogue
  *
- * **Scope.** For FEATURE layers (fills, lines, feature symbols) this is
- * axis 1 ONLY: the per-band layers survive, with identical ids and identical
- * positions, so the band-major draw order is untouched. "Axis 2" (collapsing
- * the per-band copies into one layer per class) was evaluated and **KILLED**
- * for feature layers — it is unsound for the opaque-fill classes
- * (`DOMINANCE_EXEMPT_FILL_CLASSES` ≡ `OPAQUE_FILL_LAYERS`), where band-major
- * order is the ONLY thing separating the bands, and 15/15 class pairs are
- * provably unsatisfiable with one layer each. Do not reintroduce it there.
- * Evidence: `.chrt/perf/2026-07-14-p8-d4-spike.md`.
+ * S-101 replaces S-57 as the data model for Electronic Navigational Charts.
+ * This catalogue maps S-101 feature classes to:
+ *   - S-57 equivalents (where they exist)
+ *   - Chart No. 1 sections (same organizational structure)
+ *   - Portrayal catalogue references (S-100 Portrayal Model)
  *
- * LABEL layers are different (CHRTsail #121 — MapLibre Native iOS silently
- * collapses its whole render pass above 482 symbol layers, and the served
- * style carried 575): `makeCollapsedCrossBandLabel` folds a label's ×6 band
- * fan into ONE layer per class, and `collapsedOrientationGate` folds the
- * orientation fan's per-dominator variants into its per-cell layers. That is
- * NOT the killed axis 2, because what the fill argument protects — paint
- * order as the sole band separator — does not apply to labels: their
- * load-bearing order is the cross-class P4 priority ladder (each class keeps
- * exactly one layer in its ladder slot), and within-class placement priority
- * rides the `rank*1000 + within-key` symbol-sort-key that labels.ts
- * documents as designed to survive precisely this merge.
+ * Key S-101 changes from S-57:
+ *   - CamelCase feature class names (DepthArea vs DEPARE)
+ *   - Complex/structured attributes (nested objects vs flat)
+ *   - New feature types for AIS, quality, under-keel clearance
+ *   - Removed/merged features for simplification
  *
- * **Load-bearing invariant.** A collapsed per-band FEATURE layer MUST keep
- * the `-band{B}` id segment: `custom-style.ts` `bandFloor()` parses
- * `/-band(\d)/` to clamp customer minzoom/scamin overrides to the band's
- * data floor, on the live public Style API path. Renaming the id silently
- * unclamps those overrides. Cross-band LABEL layers are the deliberate
- * exception: they carry every band floor INSIDE the filter (tile-zoom
- * clauses a customer override cannot touch), which supersedes the clamp —
- * `bandFloor()` returning 0 for a bare label id is correct, not a gap.
- * Both halves asserted in `band-collapse.test.ts`.
- */
-
-/**
- * Which emitter the style generator uses for the dominance fan.
- * `"legacy"` exists so CI can differentially prove the two equivalent (it is
- * the oracle in `band-collapse.test.ts`) and as a one-line rollback. It is an
- * internal knob — deliberately NOT on the exported `StyleGeneratorOptions`,
- * so it cannot reach `@chrtco/sdk` consumers via `ChrtStyleOptions`.
+ * Reference: IHO S-101 Product Specification (Ed 1.1.0)
+ *            IHO S-100 Universal Hydrographic Data Model
  */
-type BandFanMode = "collapsed" | "legacy";
+interface S101Feature {
+    /** S-101 camelCase feature class name */
+    featureClass: string;
+    /** Human-readable name */
+    name: string;
+    /** S-57 6-char equivalent acronym, if any */
+    s57Equivalent?: string;
+    /** Chart No. 1 section letter */
+    section: string;
+    /** Group key for clustering */
+    group: string;
+    /** Feature category */
+    category: "geo" | "meta" | "info";
+    /** Description of the feature */
+    description: string;
+    /** S-100 Portrayal Catalogue reference */
+    portrayalRef?: string;
+    /** True if this feature has no S-57 equivalent */
+    isNewInS101: boolean;
+    /** Key attributes specific to this feature */
+    attributes?: string[];
+}
+declare const S101_FEATURES: S101Feature[];
+declare const S101_CHART_SECTIONS: {
+    id: string;
+    label: string;
+    description: string;
+}[];
+declare const S101_SYMBOL_GROUPS: {
+    id: string;
+    label: string;
+    section: string;
+    description: string;
+}[];
 
 /**
- * Generates a complete Mapbox GL Style Specification v8 JSON
- * from the S-52 atlas definitions.
+ * S-101 Portrayal Catalogue — New Symbol SVGs
+ *
+ * These symbols represent features introduced in S-101 that have no
+ * direct S-57/S-52 equivalent. The existing S-52 symbols are reused
+ * where S-101 retains visual continuity with the S-57 portrayal.
+ *
+ * Reference: IHO S-101 Portrayal Catalogue (Ed 1.1.0)
  */
 
-interface MapboxStyle {
-    version: 8;
-    name: string;
-    metadata: Record<string, unknown>;
-    sources: Record<string, unknown>;
-    sprite?: string;
-    glyphs: string;
-    layers: StyleLayer[];
-}
-interface StyleGeneratorOptions extends BuildSourcesOptions {
-    /**
-     * When set, emit a "paper chart" style centered on the selected scale
-     * band, with graceful coverage fallback: the requested band's layers
-     * draw on top where its cells have data; coarser bands (driven by
-     * `CHART_CASCADE_CODES`) fill gaps where the requested band has no
-     * cells. Per-feature SCAMIN minzooms are preserved on every cascade
-     * variant; `maxzoom` is dropped so the user can zoom in indefinitely.
-     *
-     * When omitted (default), continuous mode emits one layer copy per
-     * source band with strict per-band zoom windows so exactly one band
-     * renders at any given continuous zoom.
-     *
-     * `lockedBounds` (optional) restricts chart-mode rendering to a
-     * specific bbox via a `["within"]` filter — applied ONLY to the
-     * requested band's variants. Cascade fallback bands render across the
-     * full viewport so a chart-Harbor user panning offshore still sees
-     * Approach/Coastal data. The frontend pairs this with a translucent
-     * grey overlay outside the bbox so the lock boundary is still visible
-     * to the user (the fallback data is dimmed by the overlay but not
-     * filtered out).
-     */
-    chartMode?: {
-        band: ScaleBand$1;
-        lockedBounds?: BBox;
-    };
-    /**
-     * Display unit for depth labels (SOUNDG soundings, DEPCNT contour
-     * values). Source data is always meters (S-57 / VALSOU / VALDCO);
-     * "feet" wraps the text-field expression with a unit conversion +
-     * round so the rendered numbers match. Default "meters".
-     */
-    depthUnits?: "meters" | "feet";
-    /**
-     * Which symbol artwork the style references. "s52" (default) uses the
-     * PresLib-derived S-52 set; "s101" rewrites icon references to the
-     * official S-101 Portrayal Catalogue symbols (s101: image namespace)
-     * where a counterpart exists — see s101-style.ts. "chrt" applies the
-     * CHRT house ATON/LIGHTS glyphs with colour-true tinting — see
-     * chrt-style.ts. Selection logic differences are documented per module.
-     */
-    symbolSet?: "s52" | "s101" | "chrt" | "raster";
-    /**
-     * The mariner's safety contour in metres — the depth below which a
-     * feature is "dangerous to my hull". Drives both safety-contour
-     * conditional symbology rules:
-     *
-     *   - §SOUNDG02 — soundings shoaler than this render in the
-     *     high-contrast color; deeper soundings render in the muted color.
-     *   - §CSYM02   — isolated dangers (rocks / wrecks / obstructions)
-     *     shoaler than this get the DNGCIR01 danger ring.
-     *
-     * Default `DEFAULT_SAFETY_CONTOUR_M` (10 m).
-     *
-     * Does not affect the DEPARE depth-area shading, whose 2/5/10 m bands
-     * are a separate S-52 concept.
-     */
-    safetyContour?: number;
-    /**
-     * When false, all soundings render in a single shade. Default true.
-     */
-    twoShadeSoundings?: boolean;
-    /**
-     * Label model for the 9 orientation place-name classes (SEAARE, LNDRGN,
-     * LAKARE, RIVERS, CANALS, BUAARE, AIRARE, LNDARE, PRDARE).
-     *
-     * "legacy" (default) — the per-cell-band orientation fan
-     * (fanOrientationLabelByCellBand): one label per feature per band,
-     * deconflicted only by `_label_anchor` tags and watermark opacity.
-     *
-     * "placename" — 2 PLACENAME symbol layers over the build-side
-     * place-name index (CHRTbaremetal placeNameIndex.ts): one collision-
-     * managed label per named place with a per-feature zoom window; the
-     * orientation fan for those classes is NOT emitted. Requires tiles
-     * built with the PLACENAME side index — on older tiles the layers
-     * simply draw nothing (soft-fail is index-side), which is why the
-     * default stays "legacy" until L2c's rebuild + Maine-coast visual
-     * verification flips it (docs/design/chart-label-deconfliction.md
-     * §2.3). Feature-label classes are untouched either way.
-     */
-    labels?: "legacy" | "placename";
-    /**
-     * Font weight for SOUNDG labels. Default "semibold" — crisper numerals
-     * at small sizes on screen.
-     */
-    soundingFontWeight?: "regular" | "semibold";
-    /**
-     * How big the depth figures are drawn — soundings, contour values and the
-     * depth beside a rock, wreck or obstruction. "standard" (default) is
-     * byte-identical to omitting it; "large" enlarges those labels only, and
-     * never their text, colours, sort keys, filters or layer set. See
-     * depth-label-size.ts.
-     */
-    depthLabelSize?: DepthLabelSize;
-}
-declare function generateStyle(palette?: ColorTableName, opts?: StyleGeneratorOptions & {
-    bandFan?: BandFanMode;
-}): MapboxStyle;
-declare function generateStyleJSON(palette?: ColorTableName, opts?: StyleGeneratorOptions): string;
-/** Get summary stats about the generated style */
-declare function getStyleStats(style: MapboxStyle): {
-    totalLayers: number;
-    fillLayers: number;
-    lineLayers: number;
-    symbolLayers: number;
-    circleLayers: number;
-    sources: number;
-    objectClasses: Set<string>;
-};
+declare const S101_NEW_SYMBOLS: NauticalSymbol[];
 
 declare const S101_SOURCE_COMMIT = "05063500e898544c90078ab78a61efc72b7e62f3";
 
@@ -4847,7 +4915,11 @@ declare const DEFAULT_CUSTOM_STYLE_CONFIG: CustomStyleConfig;
  * fields fall back to the platform defaults. Never throws.
  */
 declare function sanitizeCustomStyleConfig(raw: unknown): CustomStyleConfig;
-/** Normalize a `?theme=` value to a colour table name; null for anything else. */
+/**
+ * Normalize a `?theme=` value to a colour table name; null for anything else.
+ * Case-insensitive; `-` is accepted for `_` (`eink-mono` = `eink_mono`), so
+ * the e-ink names survive either spelling a caller guesses.
+ */
 declare function normalizeTheme(raw: string | null | undefined): ColorTableName | null;
 interface ResolvedTheme {
     palette: ColorTableName;
@@ -5215,7 +5287,8 @@ declare class OfflineError extends Error {
 
 /** Options for `chrt.style()`. Extends the atlas style generator options. */
 interface ChrtStyleOptions extends StyleGeneratorOptions {
-    /** S-52 colour palette: "DAY" (default), "DUSK", or "NIGHT". */
+    /** Colour palette: "DAY" (default), "DUSK", "NIGHT", or the e-paper
+     *  palettes "EINK_COLOR" / "EINK_MONO" / "EINK_NIGHT" (see `EINK_COLOR_TABLES`). */
     palette?: ColorTableName;
 }
 declare class Chrt {
@@ -5504,4 +5577,4 @@ declare class Chrt {
     warmTiles(region?: string): Promise<TileTokenResponse>;
 }
 
-export { ALL_NAV_AID_LAYERS, ALL_WATER_BODY_LAYERS, AREA_QUERY_LAYERS, ATON_EXPRESSION_CLASSES, type AheadCoverageCell, type AheadFeatureProperties, type AheadOptions, type AheadResponse, type AlongRouteFeatureProperties, type AlongRouteOptions, type AlongRouteResponse, type AreaInspectResult, type AtlasStyle, type AttachOptions, BAND_CODE_ALIASES, BAND_DRAW_ORDER, BAND_PRIORITY_RANGES, BASE_ATTRIBUTION, BASE_BUNDLE_ATTRIBUTION, BASE_BUNDLE_ID, BASE_BUNDLE_MAXZOOM, BASE_BUNDLE_SCHEMA, BASE_BUNDLE_SOURCE_LAYERS, BASE_CLIENT_RASTER_BEFORE_ID, BASE_MAXZOOM, BASE_MINZOOM, BASE_REGION, type BBox, BRIDGE_QUERY_LAYERS, BUILD_MAXZOOM, BUILD_MINZOOM, BUILD_PARAM, type BandCode, type BandPriorityRange, type BridgeInspectResult, type BuildOfflineStyleOptions, type BuildSourcesOptions, CHART_BAND_CODES, CHART_CASCADE_CODES, CHART_SECTIONS, CHRTRASTER_REF_CROPS, CHRTRASTER_SVGS, CHRT_ATON_COLORS, CHRT_GLYPH_NAMES, CHRT_GLYPH_SVGS, CHRT_ICON_EXPRESSIONS, CHRT_ICON_PREFIX, CHRT_SDF_GLYPHS, CHRT_STYLE_MODES, type CandidateQueryOptions, type CandidatesEventContext, type CellDeletedEvent, type CellDetail, type CellEventData, type CellNewEvent, type CellUpdatedData, type CellUpdatedEvent, type CellsOptions, type CellsResponse, type ChartSection, Chrt, type ChrtConfig, ChrtError, type ChrtStyleMode, type ChrtStyleOptions, type ChrtStyleTheme, type ChrtSymbolSet, type ClickAnchor, ColorTableName, type CoverageOptions, type CoverageResponse, type CoverageRouteCell, type CoverageRouteOptions, type CoverageRouteResponse, type CoverageSource, type CustomStyleConfig, DEFAULT_CLICK_TOLERANCE, DEFAULT_CUSTOM_STYLE_CONFIG, DEFAULT_DEPTH_LABEL_SIZE, DEFAULT_INSPECT_CLASS_RANK, DEFAULT_LABEL_SETTINGS, DEFAULT_NAV_AID_SETTINGS, DEFAULT_REGION, DEFAULT_SAFETY_CONTOUR_M, DEFAULT_SOUNDING_SETTINGS, DEFAULT_TILE_BASE_URL, DEFAULT_TILE_REGION, DEFAULT_WATER_BODY_SETTINGS, DEPARE_FILL_BRANCH_TOKENS, DEPARE_FILL_FALLBACK_TOKEN, DEPTH_LABEL_CLASSES, DEPTH_LABEL_SIZES, DRAPEABLE_LAYER_TYPES, type DecodedAreaFeature, type DecodedBridge, type DecodedNavAid, type DecodedProperty, type DepthLabelSize, type DisplayCategory, type DisplayMode, type FeatureCollection, type FeaturesOptions, type FetchStyleOptions, FileSystemAdapter, type FlashPattern, type FlashPhase, type GenerateCustomStyleOptions, type GeneratedCustomStyle, type GeoJsonFeature, type GeoJsonGeometry, type GeomType, INSPECT_CLASS_RANK, INSPECT_RANK_DEVIATIONS, type InspectCandidate, type InspectCandidateSet, type InspectEnrichment, type InspectEventContext, type InspectNotice, type InspectOptions, type InspectResult, type InspectTargetClass, type InspectableFeature, InteractClient, type InteractEntitlement, InteractError, type InteractErrorCode, type InteractHandle, type InteractMapLike, type InteractMapMouseEvent, LABELED_LAYERS, LABEL_BEHAVIOR, LABEL_LAYER_GROUPS, LABEL_PRIORITY, LAMP_CORE_LAYER_ID, LAMP_GLOW_LAYER_ID, LAMP_LAYER_IDS, LAMP_TICK_MS, LAND_ATTRIBUTION, LAND_BUILD_MAXZOOM, LAND_REGION, LARGE_SOUNDING_PADDING_PX, type LabelBehavior, type LabelConfigOptions, type LabelLayerConfig, type LabelSettings, type LampLayer, type LookupEntry, type MapLibreStyle, type MapboxStyle, type MapboxVectorSource, type MarineAlert, type MarineAlertsOptions, type MarineAlertsResponse, type MarineConditionsObservation, type MarineConditionsOptions, type MarineConditionsResponse, type MarineConditionsSeries, type MarineForecastOptions, type MarineForecastPeriod, type MarineForecastResponse, type MarineSeas, type MarineStation, type MarineSwellTrain, type MarineWind, type MarineZoneRef, NAUTICAL_SYMBOLS, NAV_AID_LAYER_GROUPS, NAV_AID_QUERY_LAYERS, NIGHT_INK, NIGHT_MUTED_INK, NON_SOLAS_DISCLAIMER, NON_SOLAS_DISCLAIMER_SHORT, type NauticalCategory, type NauticalSymbol, type NavAidInspectResult, type NavAidSettings, type NearbyMarineStation, OPAQUE_SPLIT_OF, type OfflineBundleResponse, type OfflineDownloadOptions, type OfflineDownloadProgress, type OfflineDownloadResult, OfflineError, type OfflineErrorCode, type OfflineFetchStyleOptions, type OfflineHeartbeatOptions, type OfflineRegionSummary, type OfflineRemoveOptions, OfflineStyleError, type OfflineStylePlatform, type OfflineStyleResponse, PLACENAME_LAND_CLASSES, PLACENAME_SOURCE_LAYER, PLACENAME_WATER_CLASSES, type ParsedSigseqTerms, type PmtilesVectorSource, type Poi, type PoiCoverage, type PoiDataset, type PoiOptions, type PoiResponse, type QueryFeatureProperties, type QueryOptions, type QueryResponse, RASTER_ATON_CLASSES, RASTER_GLYPH_NAMES, RASTER_ICON_PREFIX, RELIEF_ATTRIBUTION, RELIEF_ENCODING, RELIEF_REGION, RELIEF_TILE_SIZE, type ResolvedStyle, type ResolvedTheme, type S101ArtworkProvenance, type S101Feature, S101_AREA_FILL_NAMES, S101_CHART_SECTIONS, S101_FEATURES, S101_ICON_PREFIX, S101_LINE_STYLE_NAMES, S101_NEW_SYMBOLS, S101_NO_OFFICIAL_COUNTERPART, S101_SOURCE_COMMIT, S101_SYMBOL_GROUPS, S101_SYMBOL_NAMES, S52_ATON_LOOKUPS, S52_ATON_LOOKUPS_PAPER, S52_DRAW_ORDER, S52_LOOKUP, S52_PATTERN_SPRITE_PREFIX, SIGPER_TOLERANCE_SECONDS, SIGSEQ_MAX_TERMS, SOUNDING_LAYERS, SYMBOL_GROUPS, SYMBOL_MAP, type ScaleBand, type SearchCoverageNotice, type SearchHit, type SearchOptions, type SearchResponse, type SectorArcFeature, type SectorArcFeatureCollection, type SectorInfo, type SigseqRefusal, type SigseqTerm, type SoundingSettings, type SourceMode, type StyleGeneratorOptions, type StyleLayer, type StyleUrlOptions, type SymbolGroup, TileAuth, type TileGroup, type TileGroupsResponse, TileTokenError, type TileTokenErrorCode, type TileTokenResponse, type TransformRequest, type TransformedRequest, type VectorSourceSpec, type VesselProfile, WATER_BODY_LAYER_GROUPS, type WaterBodySettings, WeatherEndpoint, type WeatherReading, type WebhookEvent, type WebhookEventType, type WebhookPayload, applyBaseBundle, applyChrtSymbolSet, applyColorTheme, applyCustomStyleSettings, applyDepthLabelSize, applyRasterSymbolSet, applyS101SymbolSet, atonIconExpression, bandFilterExpression, buildAirportTierExpression, buildBuiltUpAreaTierExpression, buildFlashPattern, buildLabelLayer, buildLakeTierExpression, buildLampLayers, buildLandAreaTierExpression, buildLandRegionTierExpression, buildLayersForClass, buildOfflineStyle, buildPlaceNameLayers, buildRiverTierExpression, buildSeaAreaTierExpression, buildSectorArcGeoJSON, buildSectorArcsFC, buildSectorsFromFeatures, buildSources, candidateRank, capLuminance, cellBandCharacters, cellBandMatch, chrtAtonTintExpression, chrtHouseColor, chrtLightTintExpression, collectCandidates, collectClickCandidates, combineWithBandFilter, contrastRatio, daymarkColor, decimateFeatures, decodeAreaFeatureProps, decodeBridgeProps, decodeCandidate, decodeNavAidProps, depareColor, depareFillExpression, depthAreaClassLayerId, depthAreaSplitIds, deriveMarinerName, drapeHalves, drapedFirst, extractNavAidDesignation, featureIdentity, generateCustomStyle, generateSpriteManifest, generateSpriteSheet, generateStyle, generateStyleJSON, getAvailableLineSymbols, getAvailablePatterns, getAvailablePointSymbols, getCollisionSettings, getDrawPriority, getGridSizeForZoom, getIconExpression, getLabelBehavior, getLabelConfig, getLabelPriority, getLookupEntry, getMaxCellsForZoom, getOrderedClasses, getRasterSvg, getS52SvgString, getS52SymbolStats, getStyleStats, getSymbolSvgString, getThemedS101Svg, getThemedS52Svg, getTopmarkMeaning, hazardColor, hazardFillExpression, isDepthAreaClassLayerId, isDrapeable, isLabelLayerVisible, isMapLive, isNavAidLayer, isNavAidLayerVisible, isSoundingLayerVisible, isVisibleInMode, isWaterBodyLayerVisible, labelSortKey, lampRhythmColour, lampRhythmOpacity, lateralColor, lateralFillExpression, lightColor, lightFillExpression, lightsIconExpression, normalizeStyleMode, normalizeTheme, opaqueSplitBaseOf, paginate, parseDepthLabelSize, parseListCodes, parseSigseqTerms, parseWebhook, patternSpriteId, preprocessLights, preprocessNavAids, preprocessSoundings, preprocessWaterBodies, rasterAtonIconExpression, relativeLuminance, resolveCustomTheme, resolveRasterImage, resolveS101Color, resolveStyle, resolveTargetClass, rhythmProperties, s101ArtworkProvenance, sanitizeCustomStyleConfig, scaleLinearLight, scaleSizeValue, scaminToMinZoom, sectorLimitToArcBearing, splitOpaqueDepthAreas, styleModeBand, terrainStackCount, themeChrtGlyph, tileTemplate, uncoveredSectorArcs, withinBboxFilter, worldMinusBboxPolygon };
+export { ALL_NAV_AID_LAYERS, ALL_WATER_BODY_LAYERS, AREA_QUERY_LAYERS, ATON_EXPRESSION_CLASSES, type AheadCoverageCell, type AheadFeatureProperties, type AheadOptions, type AheadResponse, type AlongRouteFeatureProperties, type AlongRouteOptions, type AlongRouteResponse, type AreaInspectResult, type AtlasStyle, type AttachOptions, BAND_CODE_ALIASES, BAND_DRAW_ORDER, BAND_PRIORITY_RANGES, BASE_ATTRIBUTION, BASE_BUNDLE_ATTRIBUTION, BASE_BUNDLE_ID, BASE_BUNDLE_MAXZOOM, BASE_BUNDLE_SCHEMA, BASE_BUNDLE_SOURCE_LAYERS, BASE_CLIENT_RASTER_BEFORE_ID, BASE_MAXZOOM, BASE_MINZOOM, BASE_REGION, type BBox, BRIDGE_QUERY_LAYERS, BUILD_MAXZOOM, BUILD_MINZOOM, BUILD_PARAM, type BandCode, type BandPriorityRange, type BridgeInspectResult, type BuildOfflineStyleOptions, type BuildSourcesOptions, CHART_BAND_CODES, CHART_CASCADE_CODES, CHART_SECTIONS, CHRTRASTER_REF_CROPS, CHRTRASTER_SVGS, CHRT_ATON_COLORS, CHRT_GLYPH_NAMES, CHRT_GLYPH_SVGS, CHRT_ICON_EXPRESSIONS, CHRT_ICON_PREFIX, CHRT_SDF_GLYPHS, CHRT_STYLE_MODES, type CandidateQueryOptions, type CandidatesEventContext, type CellDeletedEvent, type CellDetail, type CellEventData, type CellNewEvent, type CellUpdatedData, type CellUpdatedEvent, type CellsOptions, type CellsResponse, type ChartSection, Chrt, type ChrtConfig, ChrtError, type ChrtStyleMode, type ChrtStyleOptions, type ChrtStyleTheme, type ChrtSymbolSet, type ClickAnchor, ColorTableName, type CoverageOptions, type CoverageResponse, type CoverageRouteCell, type CoverageRouteOptions, type CoverageRouteResponse, type CoverageSource, type CustomStyleConfig, DEFAULT_CLICK_TOLERANCE, DEFAULT_CUSTOM_STYLE_CONFIG, DEFAULT_DEPTH_LABEL_SIZE, DEFAULT_INSPECT_CLASS_RANK, DEFAULT_LABEL_SETTINGS, DEFAULT_NAV_AID_SETTINGS, DEFAULT_REGION, DEFAULT_SAFETY_CONTOUR_M, DEFAULT_SOUNDING_SETTINGS, DEFAULT_TILE_BASE_URL, DEFAULT_TILE_REGION, DEFAULT_WATER_BODY_SETTINGS, DEPARE_FILL_BRANCH_TOKENS, DEPARE_FILL_FALLBACK_TOKEN, DEPTH_LABEL_CLASSES, DEPTH_LABEL_SIZES, DRAPEABLE_LAYER_TYPES, type DecodedAreaFeature, type DecodedBridge, type DecodedNavAid, type DecodedProperty, type DepthLabelSize, type DisplayCategory, type DisplayMode, EINK_DANGER_PATTERN, EINK_DOTS_PATTERN, EINK_HATCH_PATTERN, type FeatureCollection, type FeaturesOptions, type FetchStyleOptions, FileSystemAdapter, type FlashPattern, type FlashPhase, type GenerateCustomStyleOptions, type GeneratedCustomStyle, type GeoJsonFeature, type GeoJsonGeometry, type GeomType, INSPECT_CLASS_RANK, INSPECT_RANK_DEVIATIONS, type InspectCandidate, type InspectCandidateSet, type InspectEnrichment, type InspectEventContext, type InspectNotice, type InspectOptions, type InspectResult, type InspectTargetClass, type InspectableFeature, InteractClient, type InteractEntitlement, InteractError, type InteractErrorCode, type InteractHandle, type InteractMapLike, type InteractMapMouseEvent, LABELED_LAYERS, LABEL_BEHAVIOR, LABEL_LAYER_GROUPS, LABEL_PRIORITY, LAMP_CORE_LAYER_ID, LAMP_GLOW_LAYER_ID, LAMP_LAYER_IDS, LAMP_TICK_MS, LAND_ATTRIBUTION, LAND_BUILD_MAXZOOM, LAND_REGION, LARGE_SOUNDING_PADDING_PX, type LabelBehavior, type LabelConfigOptions, type LabelLayerConfig, type LabelSettings, type LampLayer, type LookupEntry, type MapLibreStyle, type MapboxStyle, type MapboxVectorSource, type MarineAlert, type MarineAlertsOptions, type MarineAlertsResponse, type MarineConditionsObservation, type MarineConditionsOptions, type MarineConditionsResponse, type MarineConditionsSeries, type MarineForecastOptions, type MarineForecastPeriod, type MarineForecastResponse, type MarineSeas, type MarineStation, type MarineSwellTrain, type MarineWind, type MarineZoneRef, NAUTICAL_SYMBOLS, NAV_AID_LAYER_GROUPS, NAV_AID_QUERY_LAYERS, NIGHT_INK, NIGHT_MUTED_INK, NON_SOLAS_DISCLAIMER, NON_SOLAS_DISCLAIMER_SHORT, type NauticalCategory, type NauticalSymbol, type NavAidInspectResult, type NavAidSettings, type NearbyMarineStation, OPAQUE_SPLIT_OF, type OfflineBundleResponse, type OfflineDownloadOptions, type OfflineDownloadProgress, type OfflineDownloadResult, OfflineError, type OfflineErrorCode, type OfflineFetchStyleOptions, type OfflineHeartbeatOptions, type OfflineRegionSummary, type OfflineRemoveOptions, OfflineStyleError, type OfflineStylePlatform, type OfflineStyleResponse, PLACENAME_LAND_CLASSES, PLACENAME_SOURCE_LAYER, PLACENAME_WATER_CLASSES, type ParsedSigseqTerms, type PmtilesVectorSource, type Poi, type PoiCoverage, type PoiDataset, type PoiOptions, type PoiResponse, type QueryFeatureProperties, type QueryOptions, type QueryResponse, RASTER_ATON_CLASSES, RASTER_GLYPH_NAMES, RASTER_ICON_PREFIX, RELIEF_ATTRIBUTION, RELIEF_ENCODING, RELIEF_REGION, RELIEF_TILE_SIZE, type ResolvedStyle, type ResolvedTheme, type S101ArtworkProvenance, type S101Feature, S101_AREA_FILL_NAMES, S101_CHART_SECTIONS, S101_FEATURES, S101_ICON_PREFIX, S101_LINE_STYLE_NAMES, S101_NEW_SYMBOLS, S101_NO_OFFICIAL_COUNTERPART, S101_SOURCE_COMMIT, S101_SYMBOL_GROUPS, S101_SYMBOL_NAMES, S52_ATON_LOOKUPS, S52_ATON_LOOKUPS_PAPER, S52_DRAW_ORDER, S52_LOOKUP, S52_PATTERN_SPRITE_PREFIX, SIGPER_TOLERANCE_SECONDS, SIGSEQ_MAX_TERMS, SOUNDING_LAYERS, SYMBOL_GROUPS, SYMBOL_MAP, type ScaleBand, type SearchCoverageNotice, type SearchHit, type SearchOptions, type SearchResponse, type SectorArcFeature, type SectorArcFeatureCollection, type SectorInfo, type SigseqRefusal, type SigseqTerm, type SoundingSettings, type SourceMode, type StyleGeneratorOptions, type StyleLayer, type StyleUrlOptions, type SymbolGroup, TileAuth, type TileGroup, type TileGroupsResponse, TileTokenError, type TileTokenErrorCode, type TileTokenResponse, type TransformRequest, type TransformedRequest, type VectorSourceSpec, type VesselProfile, WATER_BODY_LAYER_GROUPS, type WaterBodySettings, WeatherEndpoint, type WeatherReading, type WebhookEvent, type WebhookEventType, type WebhookPayload, applyBaseBundle, applyChrtSymbolSet, applyColorTheme, applyCustomStyleSettings, applyDepthLabelSize, applyEinkPortrayal, applyRasterSymbolSet, applyS101SymbolSet, atonIconExpression, bandFilterExpression, buildAirportTierExpression, buildBuiltUpAreaTierExpression, buildFlashPattern, buildLabelLayer, buildLakeTierExpression, buildLampLayers, buildLandAreaTierExpression, buildLandRegionTierExpression, buildLayersForClass, buildOfflineStyle, buildPlaceNameLayers, buildRiverTierExpression, buildSeaAreaTierExpression, buildSectorArcGeoJSON, buildSectorArcsFC, buildSectorsFromFeatures, buildSources, candidateRank, capLuminance, cellBandCharacters, cellBandMatch, chrtAtonTintExpression, chrtHouseColor, chrtLightTintExpression, collectCandidates, collectClickCandidates, combineWithBandFilter, contrastRatio, daymarkColor, decimateFeatures, decodeAreaFeatureProps, decodeBridgeProps, decodeCandidate, decodeNavAidProps, depareColor, depareFillExpression, depthAreaClassLayerId, depthAreaSplitIds, deriveMarinerName, drapeHalves, drapedFirst, extractNavAidDesignation, featureIdentity, generateCustomStyle, generateSpriteManifest, generateSpriteSheet, generateStyle, generateStyleJSON, getAvailableLineSymbols, getAvailablePatterns, getAvailablePointSymbols, getCollisionSettings, getDrawPriority, getGridSizeForZoom, getIconExpression, getLabelBehavior, getLabelConfig, getLabelPriority, getLookupEntry, getMaxCellsForZoom, getOrderedClasses, getRasterSvg, getS52SvgString, getS52SymbolStats, getStyleStats, getSymbolSvgString, getThemedS101Svg, getThemedS52Svg, getTopmarkMeaning, hazardColor, hazardFillExpression, isDepthAreaClassLayerId, isDrapeable, isLabelLayerVisible, isMapLive, isNavAidLayer, isNavAidLayerVisible, isSoundingLayerVisible, isVisibleInMode, isWaterBodyLayerVisible, labelSortKey, lampRhythmColour, lampRhythmOpacity, lateralColor, lateralFillExpression, lightColor, lightFillExpression, lightsIconExpression, normalizeStyleMode, normalizeTheme, opaqueSplitBaseOf, paginate, parseDepthLabelSize, parseListCodes, parseSigseqTerms, parseWebhook, patternSpriteId, preprocessLights, preprocessNavAids, preprocessSoundings, preprocessWaterBodies, rasterAtonIconExpression, relativeLuminance, resolveCustomTheme, resolveRasterImage, resolveS101Color, resolveStyle, resolveTargetClass, rhythmProperties, s101ArtworkProvenance, safetyContourValues, sanitizeCustomStyleConfig, scaleLinearLight, scaleSizeValue, scaminToMinZoom, sectorLimitToArcBearing, splitOpaqueDepthAreas, styleModeBand, terrainStackCount, themeChrtGlyph, tileTemplate, uncoveredSectorArcs, withinBboxFilter, worldMinusBboxPolygon };