@chrtco/sdk 0.10.46 → 0.10.48

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,1582 @@ 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:
+ * ── Why the build has to be IN THE URL ────────────────────────────────────
  *
- *   - §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).
+ * 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.
  *
- * 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.
+ * 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.
+ *
+ * ── Why a QUERY PARAMETER and not a path segment ──────────────────────────
+ *
+ * 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:
+ *
+ *   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`).
+ *
+ * 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.
+ *
+ * `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 const DEFAULT_SAFETY_CONTOUR_M = 10;
-declare function depareColor(props: Record<string, unknown>, ct?: ColorTableName, safetyContourM?: number): string;
+declare const BUILD_PARAM = "v";
 /**
- * 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.
+ * One tile-URL template — the single place a CHRT tile URL is spelled.
+ *
+ * `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.
  */
-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;
+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;
+    /**
+     * 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.
+     */
+    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;
+}
+/**
+ * Build the "sources" block for a CHRT 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`
+ *
+ * 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}.
+ */
+declare function buildSources(opts?: BuildSourcesOptions): Record<string, AnySourceSpec>;
 
 /**
- * Label configurations for S-57 layers.
- * Defines which layers get text labels and how to extract label text.
+ * Builds Mapbox GL Style layer specs from S-52 lookup entries.
+ * Wraps the existing atlas resolveStyle() and adds source/source-layer/filter.
  */
 
+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>;
+}
 /**
- * Feature-class hierarchy for SEAARE labels. Returns a tier number 1-5 per
- * feature:
- *
- * 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.
+ * Build all Mapbox GL layers for a given S-57 object class.
+ * Returns multiple layers (fill, outline, symbol, label, etc.).
  *
- *   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)
+ * Post-consolidation: all S-57 classes live as MVT layers inside one
+ * consolidated PMTiles per region; `source` is always the region name.
  *
- * 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).
+ * `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 buildSeaAreaTierExpression(): ExpressionSpecification;
+declare function buildLayersForClass(objectClass: string, ct: ColorTableName, sourceId?: string, opts?: {
+    safetyContour?: number;
+}): StyleLayer[];
 /**
- * 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)
- *
- * Tier 1/2 may fire via CATBUA when populated; OBJNAM length is the
- * fallback so unpopulated CATBUA still produces a usable hierarchy.
+ * 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 buildBuiltUpAreaTierExpression(): ExpressionSpecification;
+declare function getOrderedClasses(): string[];
+
 /**
- * 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")
+ * CHART SIZING — five sliders over what the chart prints: LAND LABELS, WATER
+ * LABELS, DEPTH NUMBERS, WAYPOINTS, CHART ICONS, 50–200 % (owner, 2026-10-05).
  *
- * 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.
+ * ===========================================================================
+ * ONE MODEL, EVERY CLIENT
+ * ===========================================================================
+ *
+ * The owner asked for the sliders on CHRTsail iOS (*"please add the following
+ * as sizing sliders: land label size, water label size, waypoint size, chart
+ * icon size"*) the same day a captain at a Raspberry Pi helm asked CHRTsail
+ * desktop for *"the depth numbers to be bolder"* (chip 68). The decisions:
+ * desktop and web ADOPT the iOS model rather than ship a control of their own,
+ * and every platform gains a FIFTH slider, DEPTH NUMBERS, for the depth
+ * figures. So this file is a port of `ChartSymbolSizing.swift` (chrt-co/sail,
+ * #1038 at d5cd7060, read 2026-10-05) plus DEPTH NUMBERS as agreed with
+ * CHRTKit's owner (sail, 2026-10-05: `depthNumbers`, `chart.depthNumberScale`,
+ * the ladder and rules below). The classification tables and the collision
+ * rules are copied, not re-derived; a disagreement between the two clients is
+ * a bug in one of them.
+ *
+ * WAYPOINTS is in the vocabulary but not in this file's transform: waypoints
+ * are the app's own marks (DOM, not style layers) and the app scales them.
+ *
+ * ===========================================================================
+ * THE RULE THE PORT KEEPS — iOS's, verbatim in substance
+ * ===========================================================================
+ *
+ *   A bigger symbol may OVERLAP the chart. It may never DISPLACE it.
+ *
+ *   1. 100 % is the generated style, byte for byte (`applyChartSymbolScales`
+ *      returns the same object).
+ *   2. An enlarged layer stops taking part in other symbols' placement
+ *      (`*-ignore-placement: true`): it may vanish itself, it removes nothing.
+ *   3. Enlarged hazard text — CHRT's label band 100, `chrt:labelPriority` —
+ *      also gets `text-allow-overlap: true`: never dropped.
+ *   4. The soundings keep CHRT's collision flags (a sounding layer that ignored
+ *      placement would stop decluttering itself) — and OUTRANK every label
+ *      above them: whenever ANY label slider (land, water, chart icons) is off
+ *      100 %, every text label placed before the soundings, hazard text and
+ *      unclassified labels included, stops taking part in placement. A
+ *      sounding then gives way only to a shallower sounding. iOS's
+ *      `ChartSoundingsRule.outrankLabels`, chosen by its Boston Inner Harbor
+ *      census (z13–16, every slider at 50/100/150/200 %): every rule that only
+ *      protected the ENLARGED layer lost a shallow sounding, including on the
+ *      way DOWN — a sea-area name shrunk to 50 % fitted where it used to be
+ *      culled, got placed, and culled a sounding beneath it.
+ *
+ *      Its cost, measured on this chart (bench, Boston, LAND 105 %): 46–56 %
+ *      more soundings at z11.5–13, aid names up to 3.6x, sea and island names
+ *      drawn twice — labels above the soundings stop culling each other as well
+ *      as the soundings.
+ *
+ *      **THE ZOOM SPLIT — the soundings rule in force** (owner, 2026-10-06;
+ *      CHRTKit `ChartSoundingsRule.zoomSplit(harbourFrom: 14)`, sail 20f9f56bb;
+ *      `CHART_SOUNDINGS_RULE`). MapLibre has one collision index and no
+ *      groups, so a label class above the soundings either culls them or culls
+ *      nothing, its own kind included (the pile-up). Rule 4 is therefore kept
+ *      only for what orients the chart — sea-area, island and land-region
+ *      names, CHRTland and CHRT_BASE labels, and label band 100
+ *      (`keptAboveSoundings`). Every OTHER text label above the soundings
+ *      (buoy, beacon and fog-signal names, the dredged-area note) moves
+ *      directly BELOW them, in its served order, and its collision flags step
+ *      with zoom: CHRT's own below zoom 14, where it thins out round the
+ *      soundings, and `true` from 14, where it is always drawn and displaces
+ *      nothing — exactly what rule 4 draws there. Measured on the bench: 0
+ *      shoals uncovered beyond rule 4's own; buoy names 33 / 12 / 5 at
+ *      z14 / 15 / 16 against served 25 / 11 / 5, and 5–27 against 60–78 below.
+ *      Layer order cannot change with zoom, but flags can, so this is one
+ *      order with zoom-stepped flags, the same edits on every platform.
+ *
+ *   Shrinking keeps every served flag on the layer that shrinks: a smaller box
+ *   can only free space (rule 4 covers what that freed space then admits).
+ *
+ * ===========================================================================
+ * DEPTH NUMBERS — 0.10.3's toggle, as a slider
+ * ===========================================================================
+ *
+ * DEPTH NUMBERS takes the depth figures (`DEPTH_FIGURE_CLASSES`: soundings,
+ * contour values, the depth beside a rock, wreck or obstruction) away from
+ * WATER LABELS and CHART ICONS, and keeps CHRT's collision flags on the
+ * soundings and contour values. OFF 100 %, EITHER WAY, IT TRIGGERS THE ZOOM
+ * SPLIT (owner, 2026-10-06, `labelSlidersOffStandard`: "a size control must
+ * never remove a shoal, whichever way it's moved"). Bigger depth glyphs collide
+ * with more of the labels placed before them: on the bench at Boston DEPTH
+ * 140 % alone left 7 / 3 / 1 shoals uncovered at z12.3 / 13 / 14 — 0.10.3's
+ * Large left 8 / 4 / 1. With the split: 0. Shrinking is a trigger by the same
+ * rule, measured or not (`scripts/chart-bench/depth-numbers-census.ts`).
+ * Above 100 %:
+ *
+ *   A. **Depth figures go Semibold** — each served Regular face swapped for its
+ *      Semibold (`semiboldFontStack`, derived from the name as CHRTKit does).
+ *      Soundings already are; contour values and the depth beside a rock,
+ *      wreck or obstruction are Regular, and an enlarged Regular numeral
+ *      beside an enlarged Semibold one reads as two kinds of figure. There is no Bold glyph set on any CHRT glyph host
+ *      (`cloudflare/tile-worker/glyphs/GLYPHS.json`), so this is the heaviest
+ *      face a client may ask for.
+ *   B. **Halos grow half as fast as the glyph** (`haloFactor`), on depth
+ *      figures only and at DEPTH NUMBERS' own factor — a contour value's
+ *      half-rate size does not halve its halo again (CHRTKit,
+ *      `ChartDepthFigureRules.haloWidth`). A halo is the S-52 cut-out, and in
+ *      DUSK it is dark like a deeper sounding's fill, so it THICKENS that
+ *      numeral instead of cutting it out (`s-52.md` §8a). Grown in proportion,
+ *      the deeper DUSK soundings out-weighed the shoal ones beside them — the
+ *      two-shade rule backwards.
+ *   C. **The sounding collision padding shrinks as the soundings grow**
+ *      (`soundingPadding`), so about as many soundings are placed at 140 % as
+ *      at 100 %: CHRT's 6 px padding at 1.4x placed a quarter fewer (326 → 246
+ *      at Boston z14, chip 68); 3.5 px held z11.5–15 within ±5 %.
+ *   D. **Contour values grow at half rate** (`contourValueFactor`) — 0.10.3's
+ *      1.2x beside 1.4x soundings, so a contour label still fits its line.
+ *   And rule 3 for the depth callouts beside rocks, wrecks and obstructions
+ *   (CHRTKit's call): never dropped, never displacing, so a hazard is never
+ *   drawn with its depth culled.
+ *
+ * Nothing here touches a label's TEXT, its colours (the §SOUNDG02 two shades),
+ * its sort key, filter or zoom gate, or the layer set.
  */
-declare function buildLandRegionTierExpression(): ExpressionSpecification;
+
 /**
- * Land area tier (LNDARE): major vs. local.
- *   1 — Major (OBJNAM length <= 12)
- *   2 — Local
+ * Drawer order — iOS's `ChartSymbolSize.allCases` plus DEPTH NUMBERS.
+ *
+ * ⚠ DEPTH NUMBERS IS THE OWNER'S FIFTH SLIDER (2026-10-05), on every platform.
+ * It takes the depth figures — soundings, contour values, the depth beside a
+ * rock, wreck or obstruction — away from WATER LABELS and CHART ICONS, scales
+ * them the way 0.10.3's DEPTH NUMBERS toggle did, and off 100 % — either way —
+ * triggers the zoom split as LAND, WATER and CHART ICONS do (owner, 2026-10-06). 100 % on
+ * every client by default. Name, wire and ladder as CHRTKit's shared model;
+ * see `CHART_SYMBOL_SIZE_WIRE`.
+ */
+declare const CHART_SYMBOL_SIZES: readonly ["landLabels", "waterLabels", "depthNumbers", "waypoints", "chartIcons"];
+type ChartSymbolSize = (typeof CHART_SYMBOL_SIZES)[number];
+/** The account key each slider syncs under — iOS `SettingKey.*Scale.wireName`. */
+declare const CHART_SYMBOL_SIZE_WIRE: Readonly<Record<ChartSymbolSize, string>>;
+/** The row names — `ChartSymbolSize.label`, verbatim. */
+declare const CHART_SYMBOL_SIZE_LABELS: Readonly<Record<ChartSymbolSize, string>>;
+/** What each slider reaches, one line — `ChartSymbolSize.reach`, verbatim. */
+declare const CHART_SYMBOL_SIZE_REACH: Readonly<Record<ChartSymbolSize, string>>;
+/** `ChartSymbolScale` — integer percent throughout. */
+declare const CHART_SYMBOL_SCALE: {
+    readonly min: 50;
+    readonly max: 200;
+    readonly standard: 100;
+    /** The − / + step. */
+    readonly buttonStep: 10;
+    /** The slider's snap. */
+    readonly sliderStep: 5;
+};
+type ChartSymbolScales = Readonly<Record<ChartSymbolSize, number>>;
+declare const STANDARD_CHART_SYMBOL_SCALES: ChartSymbolScales;
+declare function clampChartSymbolScale(percent: number): number;
+/** A slider position → the stored percent: nearest 5, clamped. */
+declare function snapChartSymbolScale(value: number): number;
+/** One press of − or +, from wherever the value is (125 % − is 115 %). */
+declare function stepChartSymbolScale(percent: number, presses: number): number;
+/**
+ * A stored or synced value. Unreadable → `null` (the caller's default);
+ * out of range → clamped, so a newer client's wider range never reaches the
+ * renderer raw. A string must be a whole number — "140", not "140%".
+ */
+declare function decodeChartSymbolScale(raw: unknown): number | null;
+/** Text that names a place or a feature on LAND. */
+declare const LAND_TEXT_CLASSES: ReadonlySet<string>;
+/**
+ * Text that names WATER, or states a clearance over it. LAKARE, RIVERS and
+ * CANALS are here though CHRT files them under "Land": the label is the name
+ * of water. SOUNDG and DEPCNT left for DEPTH NUMBERS (owner, 2026-10-05).
+ */
+declare const WATER_TEXT_CLASSES: ReadonlySet<string>;
+/**
+ * Text that belongs to a charted point symbol — it follows CHART ICONS so it
+ * keeps its em offset from the symbol it annotates.
+ */
+declare const SYMBOL_ANNOTATION_TEXT_CLASSES: ReadonlySet<string>;
+/** CHRT's hazard label band. Enlarged text in it is never dropped (rule 3). */
+declare const HAZARD_LABEL_PRIORITY = 100;
+/**
+ * The depth figures — DEPTH NUMBERS' text. The labels the depth-unit switch
+ * converts (`buildLabelLayer`): a sounding, a contour value, the depth beside a
+ * rock, wreck or obstruction (that class's ICON stays CHART ICONS'). Not the
+ * dredged-channel note: it is a sentence.
+ */
+declare const DEPTH_FIGURE_CLASSES: ReadonlySet<string>;
+/**
+ * Contour values grow at half DEPTH NUMBERS' rate: a contour value rides its
+ * line and needs a straight-enough run to fit, and shares rank 300 with the
+ * soundings, which place first. 0.10.3's Large drew them 1.2x when it drew the
+ * soundings 1.4x, for that reason; this is the same ratio as a slider.
+ */
+declare function contourValueFactor(depthNumbersFactor: number): number;
+/**
+ * The font stacks a CHRT glyph host serves (`cloudflare/tile-worker/glyphs/
+ * GLYPHS.json`; the test pins this copy to it). There is no Bold.
+ */
+declare const SERVED_FONT_STACKS: readonly string[];
+/**
+ * Rule A: the served font stack with each Regular face swapped for its
+ * Semibold — DERIVED from the served name, not typed, as CHRTKit does, so a
+ * family that changes its face is followed rather than overridden. A swap
+ * that would ask for a face no glyph host serves is refused (the face stays
+ * Regular), as CHRTKit's `servedFontStacks` does. Semibold and Italic faces
+ * are left as served (soundings are already Semibold, so A changes the
+ * contour values and the three callouts). Anything that is not a plain list
+ * of names — absent, or an expression — is returned untouched.
+ */
+declare function semiboldFontStack(font: unknown): unknown;
+/** The slider a layer's TEXT follows, or null (stays at 100 %, counted). */
+declare function textSliderFor(layer: StyleLayer): ChartSymbolSize | null;
+/** The slider a layer's ICON follows: every chart point symbol, no basemap one. */
+declare function iconSliderFor(layer: StyleLayer): ChartSymbolSize | null;
+/**
+ * `value` × `factor`, keeping its zoom structure: the factor goes onto every
+ * stop's OUTPUT, because MapLibre accepts `["zoom"]` only as the input of a
+ * TOP-LEVEL `interpolate`/`step`. `null` for a shape this does not recognise —
+ * the caller leaves that property at its served size rather than guess.
+ * `undefined` (absent) is the renderer default × factor.
+ */
+declare function scaleSizeExpression(value: unknown, factor: number, fallback: number): unknown;
+/** Rule B: a halo grows half as fast as its glyph, and only above 100 %. */
+declare function haloFactor(factor: number): number;
+/**
+ * CHRT's sounding collision padding, px (`labels.ts`). Read from the generated
+ * layer where it is a number; this is the fallback and the test's anchor.
+ */
+declare const SERVED_SOUNDING_PADDING_PX = 6;
+/**
+ * Rule C: px of padding taken off per unit of factor above 1. 6.25 puts 140 %
+ * at 3.5 px — the value the chip-68 sweep chose — and reaches 0 at 196 %.
+ * DEPTH NUMBERS alone (no rule 4) holds the soundings count to −9 % … +7 % of
+ * the served chart across 120–200 %, z11.5–15 (bench, Boston, DAY, 1280×800 at
+ * 1×; −9 % is z14 at 200 %). `.chrt/standards/s-52.md` §8a has the figures.
+ */
+declare const SOUNDING_PADDING_PER_FACTOR = 6.25;
+/** Rule C: the sounding padding at a DEPTH NUMBERS factor. */
+declare function soundingPadding(factor: number, served?: number): number;
+/** MapLibre's `text-padding` when a layer sets none. */
+declare const MAPLIBRE_DEFAULT_TEXT_PADDING_PX = 2;
+/**
+ * Rule C on whatever the served `text-padding` is, as CHRTKit's
+ * `ChartDepthFigureRules.soundingPadding` does: absent is MapLibre's 2 px; a
+ * number is reduced; a zoom `interpolate` or `step` has each OUTPUT reduced;
+ * any other shape is left as served. At or below 100 % it is the served value.
+ */
+declare function soundingPaddingValue(served: unknown, factor: number): unknown;
+/**
+ * What the labels above the soundings do when LAND LABELS, WATER LABELS or
+ * CHART ICONS leaves 100 % (the header's rule 4 and THE ZOOM SPLIT). CHRTKit's
+ * `ChartSoundingsRule`, the two cases this client ships.
+ */
+type ChartSoundingsRule = {
+    readonly kind: "outrankLabels";
+} | {
+    readonly kind: "zoomSplit";
+    readonly harbourFrom: number;
+    readonly splitLights?: boolean;
+};
+/** Rule 4 as iOS first shipped it: every text label above the soundings yields. */
+declare const OUTRANK_LABELS: ChartSoundingsRule;
+/** The rule in force — the owner's split at zoom 14 (2026-10-06), CHRTKit's default. */
+declare const CHART_SOUNDINGS_RULE: ChartSoundingsRule;
+/**
+ * Whether a label stays above the soundings under the zoom split: label band
+ * 100 (hazard text), the CHRTland and CHRT_BASE labels, and sea-area, island
+ * and land-region names. With `splittingLights`, light characteristics are
+ * split like the buoy names despite being band 100 (measured, not shipped).
+ */
+declare function keptAboveSoundings(layer: StyleLayer, splittingLights?: boolean): boolean;
+/** `value` below zoom `z`, `true` from it — CHRTKit `fromZoom`. Absent is MapLibre's `false`. */
+declare function fromZoom(z: number, value: unknown): unknown[];
+/**
+ * One generated layer at a set of scales. Returns the SAME object when nothing
+ * reaches it (100 %, unclassified, not a symbol layer, or a size this cannot
+ * multiply), so a standard chart is the generated chart, byte for byte.
  *
- * No category attribute. OBJNAM length is the only signal.
+ * `yieldText` is rule 4, decided by the caller from the layer's position: the
+ * layer is a label placed before the soundings, and some label slider is off
+ * 100 %. Its text then takes no part in placement, whatever its own size.
  */
-declare function buildLandAreaTierExpression(): ExpressionSpecification;
+declare function applyChartSymbolScalesToLayer(layer: StyleLayer, scales: ChartSymbolScales, yieldText?: boolean): StyleLayer;
 /**
- * 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)
+ * Every layer of a generated style at a set of scales, in draw order — rule 4
+ * reads the order (MapLibre places the TOP of the style first, so "above the
+ * soundings" is "placed before them"). Standard → the same array.
  */
-declare function buildLakeTierExpression(): ExpressionSpecification;
+declare function applyChartSymbolScales<L extends StyleLayer>(layers: readonly L[], scales: ChartSymbolScales | undefined, rule?: ChartSoundingsRule): L[];
 /**
- * River tier (RIVERS): major vs. local.
- *   1 — Major river (OBJNAM length <= 15 AND no comma)
- *   2 — Local creek (else)
+ * The text labels the zoom split moves below the soundings at these scales,
+ * in draw order — empty when nothing triggers the split
+ * (`labelSlidersOffStandard`: LAND / WATER / DEPTH / ICONS off 100 %, either
+ * way) or the rule does not split. For a client that reorders a live map.
  */
-declare function buildRiverTierExpression(): ExpressionSpecification;
+declare function demotedBelowSoundings(layers: readonly StyleLayer[], scales: ChartSymbolScales | undefined, rule?: ChartSoundingsRule): string[];
 /**
- * Airport tier (AIRARE): major airport vs. small airstrip.
- *   1 — Major (OBJNAM length <= 25 — e.g. "Logan International Airport")
- *   2 — Airstrip
+ * What no slider reaches, and what a slider reaches but cannot multiply —
+ * iOS's `unclassified` / `unscalable`, for a test that fails when CHRT adds a
+ * label class nobody has decided about.
  */
-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 function chartSymbolSizingCensus(layers: readonly StyleLayer[]): {
+    unclassified: string[];
+    unscalable: string[];
+};
+
 /**
- * Optional palette-and-data-driven options for label config.
+ * Dominance fan-out collapse (P8 Phase 3.3 / D4 "axis 1").
  *
- * 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.
+ * `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`.
  */
-interface LabelConfigOptions {
-    /** S-52 colour table — drives palette-aware text and halo colors. */
-    colorTable?: ColorTableName;
+
+/**
+ * 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`.
+ */
+type BandFanMode = "collapsed" | "legacy";
+
+/**
+ * Generates a complete Mapbox GL Style Specification v8 JSON
+ * from the S-52 atlas definitions.
+ */
+
+interface MapboxStyle {
+    version: 8;
+    name: string;
+    metadata: Record<string, unknown>;
+    sources: Record<string, unknown>;
+    sprite?: string;
+    glyphs: string;
+    layers: StyleLayer[];
+}
+interface StyleGeneratorOptions extends BuildSourcesOptions {
     /**
-     * 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.
+     * 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 `SNDG2` (single-shade). Default
-     * true — emit the safety-contour case expression.
+     * When false, all soundings render in a single shade. Default true.
      */
     twoShadeSoundings?: boolean;
     /**
-     * When "semibold", SOUNDG labels use Open Sans Semibold for crisper
-     * numerals at small sizes. Default "semibold".
+     * 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";
+    /**
+     * CHART SIZING — the five sliders, in percent (50–200; `waypoints` is the
+     * app's and is ignored here). Omitted, or every value 100, is byte-identical
+     * to the style without it. Applied LAST, after the symbol-family rewrite, so
+     * it sizes what the chosen family draws. Never changes a label's text,
+     * colours, sort key, filter, zoom gate or the layer set — see
+     * chart-symbol-sizing.ts.
+     */
+    symbolScales?: ChartSymbolScales;
+    /**
+     * What the labels above the soundings do when LAND, WATER or CHART ICONS is
+     * off 100 %, or DEPTH NUMBERS either way — `CHART_SOUNDINGS_RULE` (the owner's zoom split at 14) when
+     * omitted. Rule 4 (`OUTRANK_LABELS`) is kept for measurement.
+     */
+    soundingsRule?: ChartSoundingsRule;
 }
+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>;
+};
+
 /**
- * Two-tier label rendering strategy for the band-priority 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.
- *
- * `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.
+ * 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.
  */
-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;
+
+/** 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;
+}
 /**
- * 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.
- *
- * Rank semantics: LOWER rank = higher priority. The rank drives two
- * mechanisms that must stay in agreement:
- *
- *   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.)
- *
- * The ladder (safety-critical > nav-aids > depth field > structures >
- * ambient notes):
- *
- *   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.
- *
- * 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.
+ * Apply the e-ink portrayal for `palette`. Returns the style unchanged for a
+ * non-e-ink palette, so a caller may apply it unconditionally.
  */
-declare function labelSortKey(rank: number, within?: unknown): ExpressionSpecification | number;
+declare function applyEinkPortrayal(style: MapboxStyle, palette: ColorTableName, opts?: EinkPortrayalOptions): MapboxStyle;
+
 /**
- * Extract the trailing designation token from a nav-aid OBJNAM.
+ * Light arithmetic for the chart palettes: how much light a colour emits, and
+ * how to dim a colour without changing its hue.
  *
- * 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).
+ * 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.
  *
- * 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).
+ * 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.
  */
-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;
+/** 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;
 /**
- * Build a Mapbox symbol layer spec from a label config.
+ * 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 buildLabelLayer(layerId: string, sourceId: string, config: LabelLayerConfig, visible: boolean, overrides?: {
-    textScale?: number;
-    minzoom?: number | null;
-    allowOverlap?: boolean;
-}): maplibregl.LayerSpecification;
+declare function scaleLinearLight(hex: string, factor: number): 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.
+ * `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 preprocessSoundings(fc: GeoJSON.FeatureCollection): GeoJSON.FeatureCollection;
+declare function capLuminance(hex: string, ceiling: number): string;
 /**
- * Pre-process LIGHTS GeoJSON to derive compact light characteristic labels.
- * Adds `_lightLabel` property (e.g., "Fl(2) WR 4s 5M").
+ * NIGHT's two ink levels, shared by every family's text and marks.
  *
- * 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.
+ *   `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.
  */
-declare function buildPlaceNameLayers(sourceId: string, ct?: ColorTableName): maplibregl.LayerSpecification[];
+declare const NIGHT_INK: string;
+declare const NIGHT_MUTED_INK: 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.
+ * Is this MapLibre map still there to be written to?
  *
- * @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 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.
- */
-declare function getMaxCellsForZoom(zoom: number): number;
-
-/**
- * IHO S-52 / NOAA Chart No. 1 / INT1 nautical symbol SVGs.
+ * ===========================================================================
+ * ⚠ ASK AFTER EVERY AWAIT. A MAP CAN BE REMOVED WHILE YOU WERE WAITING.
+ * ===========================================================================
  *
- * 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
+ * `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.
  *
- * 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
+ * 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:
  *
- * 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) ⊗
+ *     TypeError: Cannot read properties of undefined (reading 'getImage')
+ *       at Map.hasImage
+ *       at addImageToMap (s52-image-cache.ts)
  *
- * Each symbol is a compact SVG at 32×32 for Mapbox GL `map.addImage()`.
+ * 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`.
  */
-/** 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;
+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;
 }
-/** 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[];
+/** 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;
 }
-/** Chart No. 1 section metadata */
-interface ChartSection {
-    id: string;
-    label: string;
-    description: string;
+/** Resolved style ready for Mapbox GL (tokens → hex) */
+interface ResolvedStyle {
+    type: GeomType;
+    paint: Record<string, unknown>;
+    layout?: Record<string, unknown>;
+    minzoom?: number;
+    maxzoom?: number;
 }
-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.
+
+/**
+ * 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).
  */
-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 const S52_LOOKUP: Record<string, LookupEntry>;
+
+/**
+ * S-52 draw order: layers listed bottom → top.
+ * Layers not in this list are inserted before point features.
  */
-declare function getIconExpression(layerName: string): string | unknown[];
+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;
 /**
- * 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()`).
+ * Convert S-52 SCAMIN (scale minimum) to Mapbox GL minzoom.
  */
-/** 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 scaminToMinZoom(scamin?: number): number | undefined;
+declare function getCollisionSettings(viewingGroup?: number): {
+    iconAllowOverlap: boolean;
+    iconOptional: boolean;
+    symbolSortKey?: number;
+};
+/**
+ * Get the resolved Mapbox GL style for a given S-57 layer.
+ */
+declare function resolveStyle(layerName: string, geomKind?: GeomType, ct?: ColorTableName, opts?: {
+    safetyContour?: number;
+}): ResolvedStyle;
+declare function getLookupEntry(layerName: string): LookupEntry;
 
 /**
- * IHO S-101 ENC Product Specification — Feature Catalogue
+ * S-52 Conditional Symbology Procedures.
+ * Each function takes feature properties and returns paint overrides (hex colours).
+ * All expression builders accept an optional colorTable parameter.
+ */
+/**
+ * Default safety contour in metres — the depth below which a feature is
+ * "dangerous to my hull" for portrayal purposes.
  *
- * 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)
+ * 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:
  *
- * 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
+ *   - §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).
  *
- * Reference: IHO S-101 Product Specification (Ed 1.1.0)
- *            IHO S-100 Universal Hydrographic Data Model
+ * 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.
  */
-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 DEFAULT_SAFETY_CONTOUR_M = 10;
+declare function depareColor(props: Record<string, unknown>, ct?: ColorTableName, safetyContourM?: number): string;
 /**
- * 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)
+ * 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;
 
-declare const S101_NEW_SYMBOLS: NauticalSymbol[];
+/**
+ * Label configurations for S-57 layers.
+ * Defines which layers get text labels and how to extract label text.
+ */
 
 /**
- * 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.
+ * Feature-class hierarchy for SEAARE labels. Returns a tier number 1-5 per
+ * feature:
  *
- * `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.
+ * 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.
+ *
+ *   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)
+ *
+ * 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).
  */
-/** Vector source emitted for the legacy Mapbox MTS path. */
-interface MapboxVectorSource {
-    type: "vector";
-    url: string;
-}
+declare function buildSeaAreaTierExpression(): ExpressionSpecification;
 /**
- * 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.
+ * 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)
+ *
+ * Tier 1/2 may fire via CATBUA when populated; OBJNAM length is the
+ * fallback so unpopulated CATBUA still produces a usable hierarchy.
  */
-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 function buildBuiltUpAreaTierExpression(): ExpressionSpecification;
 /**
- * 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.
+ * 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")
+ *
+ * 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.
  */
-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 buildLandRegionTierExpression(): ExpressionSpecification;
 /**
- * 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).
+ * Land area tier (LNDARE): major vs. local.
+ *   1 — Major (OBJNAM length <= 12)
+ *   2 — Local
+ *
+ * No category attribute. OBJNAM length is the only signal.
  */
-declare const BASE_MINZOOM = 0;
-declare const BASE_MAXZOOM = 11;
+declare function buildLandAreaTierExpression(): ExpressionSpecification;
 /**
- * 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.
+ * 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 const BASE_ATTRIBUTION = "\u00A9 CHRT \u00B7 Made with Natural Earth \u00B7 \u00A9 OpenStreetMap contributors";
+declare function buildLakeTierExpression(): ExpressionSpecification;
 /**
- * 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`).
+ * River tier (RIVERS): major vs. local.
+ *   1 — Major river (OBJNAM length <= 15 AND no comma)
+ *   2 — Local creek (else)
  */
-declare const LAND_ATTRIBUTION = "\u00A9 OpenStreetMap contributors";
+declare function buildRiverTierExpression(): ExpressionSpecification;
 /**
- * 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.
+ * Airport tier (AIRARE): major airport vs. small airstrip.
+ *   1 — Major (OBJNAM length <= 25 — e.g. "Logan International Airport")
+ *   2 — Airstrip
  */
-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 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;
+}
 /**
- * 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.
+ * Optional palette-and-data-driven options for label config.
+ *
+ * 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 const RELIEF_ENCODING = "terrarium";
-type SourceMode = "mapbox" | "pmtiles";
+interface LabelConfigOptions {
+    /** S-52 colour table — drives palette-aware text and halo colors. */
+    colorTable?: ColorTableName;
+    /**
+     * 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.
+     */
+    safetyContour?: number;
+    /**
+     * When false, all soundings render in `SNDG2` (single-shade). Default
+     * true — emit the safety-contour case expression.
+     */
+    twoShadeSoundings?: boolean;
+    /**
+     * When "semibold", SOUNDG labels use Open Sans Semibold for crisper
+     * numerals at small sizes. Default "semibold".
+     */
+    soundingFontWeight?: "regular" | "semibold";
+}
 /**
- * Query parameter carrying the resolved build id on every tile URL.
- *
- * ── Why the build has to be IN THE URL ────────────────────────────────────
+ * Two-tier label rendering strategy for the band-priority style.
  *
- * 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-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.
  *
- * 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.
+ * `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.
+ */
+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;
+/**
+ * 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.
  *
- * ── Why a QUERY PARAMETER and not a path segment ──────────────────────────
+ * Rank semantics: LOWER rank = higher priority. The rank drives two
+ * mechanisms that must stay in agreement:
  *
- * 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:
+ *   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.)
  *
- *   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`).
+ * The ladder (safety-critical > nav-aids > depth field > structures >
+ * ambient notes):
  *
- * 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.
+ *   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.
  *
- * `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).
+ * 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 BUILD_PARAM = "v";
+declare const LABEL_PRIORITY: Record<string, number>;
 /**
- * One tile-URL template — the single place a CHRT tile URL is spelled.
- *
- * `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.
+ * 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 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;
-    /**
-     * 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.
-     */
-    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;
-}
+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;
 /**
- * Build the "sources" block for a CHRT style.
+ * Extract the trailing designation token from a nav-aid OBJNAM.
  *
- * - `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`
+ * 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).
  *
- * 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}.
+ * 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 buildSources(opts?: BuildSourcesOptions): Record<string, AnySourceSpec>;
-
+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;
 /**
- * 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
- * ===========================================================================
- *
- * 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.
- *
- * 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:
- *
- *   - `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).
- *
- * ===========================================================================
- * WHICH LABELS ARE "DEPTH NUMBERS"
- * ===========================================================================
- *
- * 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
- * ===========================================================================
+ * 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 +5118,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 +5490,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 +5780,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, CHART_SOUNDINGS_RULE, CHART_SYMBOL_SCALE, CHART_SYMBOL_SIZES, CHART_SYMBOL_SIZE_LABELS, CHART_SYMBOL_SIZE_REACH, CHART_SYMBOL_SIZE_WIRE, 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, type ChartSoundingsRule, type ChartSymbolScales, type ChartSymbolSize, 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_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_FIGURE_CLASSES, DRAPEABLE_LAYER_TYPES, type DecodedAreaFeature, type DecodedBridge, type DecodedNavAid, type DecodedProperty, 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, HAZARD_LABEL_PRIORITY, 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, LAND_TEXT_CLASSES, type LabelBehavior, type LabelConfigOptions, type LabelLayerConfig, type LabelSettings, type LampLayer, type LookupEntry, MAPLIBRE_DEFAULT_TEXT_PADDING_PX, 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, OUTRANK_LABELS, 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, SERVED_FONT_STACKS, SERVED_SOUNDING_PADDING_PX, SIGPER_TOLERANCE_SECONDS, SIGSEQ_MAX_TERMS, SOUNDING_LAYERS, SOUNDING_PADDING_PER_FACTOR, STANDARD_CHART_SYMBOL_SCALES, SYMBOL_ANNOTATION_TEXT_CLASSES, 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, WATER_TEXT_CLASSES, type WaterBodySettings, WeatherEndpoint, type WeatherReading, type WebhookEvent, type WebhookEventType, type WebhookPayload, applyBaseBundle, applyChartSymbolScales, applyChartSymbolScalesToLayer, applyChrtSymbolSet, applyColorTheme, applyCustomStyleSettings, 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, chartSymbolSizingCensus, chrtAtonTintExpression, chrtHouseColor, chrtLightTintExpression, clampChartSymbolScale, collectCandidates, collectClickCandidates, combineWithBandFilter, contourValueFactor, contrastRatio, daymarkColor, decimateFeatures, decodeAreaFeatureProps, decodeBridgeProps, decodeCandidate, decodeChartSymbolScale, decodeNavAidProps, demotedBelowSoundings, depareColor, depareFillExpression, depthAreaClassLayerId, depthAreaSplitIds, deriveMarinerName, drapeHalves, drapedFirst, extractNavAidDesignation, featureIdentity, fromZoom, 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, haloFactor, hazardColor, hazardFillExpression, iconSliderFor, isDepthAreaClassLayerId, isDrapeable, isLabelLayerVisible, isMapLive, isNavAidLayer, isNavAidLayerVisible, isSoundingLayerVisible, isVisibleInMode, isWaterBodyLayerVisible, keptAboveSoundings, labelSortKey, lampRhythmColour, lampRhythmOpacity, lateralColor, lateralFillExpression, lightColor, lightFillExpression, lightsIconExpression, normalizeStyleMode, normalizeTheme, opaqueSplitBaseOf, paginate, parseListCodes, parseSigseqTerms, parseWebhook, patternSpriteId, preprocessLights, preprocessNavAids, preprocessSoundings, preprocessWaterBodies, rasterAtonIconExpression, relativeLuminance, resolveCustomTheme, resolveRasterImage, resolveS101Color, resolveStyle, resolveTargetClass, rhythmProperties, s101ArtworkProvenance, safetyContourValues, sanitizeCustomStyleConfig, scaleLinearLight, scaleSizeExpression, scaleSizeValue, scaminToMinZoom, sectorLimitToArcBearing, semiboldFontStack, snapChartSymbolScale, soundingPadding, soundingPaddingValue, splitOpaqueDepthAreas, stepChartSymbolScale, styleModeBand, terrainStackCount, textSliderFor, themeChrtGlyph, tileTemplate, uncoveredSectorArcs, withinBboxFilter, worldMinusBboxPolygon };