@chrtco/sdk 0.10.45 → 0.10.47

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 import { F as FileSystemAdapter } from './fs-adapter-D5iwdb1Q.cjs';
-import { C as ColorTableName } from './symbol-families-D2Kx20HJ.cjs';
-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.cjs';
+import { C as ColorTableName } from './symbol-families-De7sN-p5.cjs';
+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.cjs';
 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,1167 +2832,1379 @@ declare class InteractClient {
 }
 
 /**
- * Light arithmetic for the chart palettes: how much light a colour emits, and
- * how to dim a colour without changing its hue.
- *
- * Everything here works in LINEAR light (WCAG 2.x relative luminance, sRGB
- * primaries). That is the quantity a dark-adapted eye responds to, and it is
- * the one `sounding-legibility.test.ts` already measures soundings in. Scaling
- * the sRGB-ENCODED channels instead would dim dark colours far more than
- * bright ones and shift every hue it touched.
+ * Post-consolidation (2026-04): one consolidated PMTiles per region, all
+ * S-57 classes as distinct MVT layers inside. The MapLibre style emits one
+ * vector source (id = region) and N paint layers that reference it via
+ * `source-layer` = S-57 class name.
  *
- * The one derivation the palettes rely on, and the reason this file exists:
- * NIGHT's deeper sounding SNDG1 (#897350) is SNDG2 (#c8aa78) at 43% of its
- * linear light. `labels.ts` builds its NIGHT secondary text the same way, so
- * the two stay one family by construction rather than by two hand-typed hexes
- * that happen to agree.
- */
-/** WCAG 2.x relative luminance of a `#rrggbb` colour, 0 (black) to 1 (white). */
-declare function relativeLuminance(hex: string): number;
-/** WCAG 2.x contrast ratio between two `#rrggbb` colours, 1 to 21. */
-declare function contrastRatio(a: string, b: string): number;
-/**
- * The same hue at `factor` times its linear light. `factor` above 1 can clip a
- * channel, which shifts the hue; nothing in the palettes brightens, so callers
- * pass 0–1.
+ * `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 scaleLinearLight(hex: string, factor: number): string;
+/** Vector source emitted for the legacy Mapbox MTS path. */
+interface MapboxVectorSource {
+    type: "vector";
+    url: 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).
+ * 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 function capLuminance(hex: string, ceiling: number): 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;
+}
 /**
- * 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.
+ * 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 const NIGHT_INK: string;
-declare const NIGHT_MUTED_INK: string;
-
-/** 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.
- */
-declare const DEFAULT_SAFETY_CONTOUR_M = 10;
-declare function depareColor(props: Record<string, unknown>, ct?: ColorTableName, safetyContourM?: number): string;
-/**
- * The colour token of each `case` branch of `depareFillExpression`, in branch
- * order, then the fallback. `depth-area-opaque.ts` names the layers it splits
- * the expression into from this list, so the two read from one place.
- */
-declare const DEPARE_FILL_BRANCH_TOKENS: readonly ["DEPIT", "DEPVS", "DEPMS", "DEPMD"];
-declare const DEPARE_FILL_FALLBACK_TOKEN = "DEPDW";
-declare function depareFillExpression(ct?: ColorTableName, safetyContourM?: number): unknown[];
-declare function lightColor(props: Record<string, unknown>, ct?: ColorTableName): string;
-declare function lightFillExpression(ct?: ColorTableName): unknown[];
-declare function lateralColor(props: Record<string, unknown>, ct?: ColorTableName): string;
-declare function lateralFillExpression(ct?: ColorTableName): unknown[];
-declare function hazardColor(props: Record<string, unknown>, ct?: ColorTableName): string;
-declare function hazardFillExpression(ct?: ColorTableName): unknown[];
-declare function daymarkColor(props: Record<string, unknown>, ct?: ColorTableName): string;
-
-/**
- * Label configurations for S-57 layers.
- * Defines which layers get text labels and how to extract label text.
- */
-
-/**
- * Feature-class hierarchy for SEAARE labels. Returns a tier number 1-5 per
- * feature:
+ * On a nautical chart that is not a cosmetic seam. Measured live 2026-08-25,
+ * cutting `CHRT_LAND` from `463b265e` to `dbb69074` (a build that deliberately
+ * changes land extent): adjacent tiles disagreed about whether land was there,
+ * at the seam between them. Putting the build in the key gives each build its
+ * own cache namespace — old entries age out untouched, and the next style
+ * build flips the whole viewport at once instead of tile by tile.
  *
- * Exported (with the other tier builders below) for the build-side parity
- * test: CHRTbaremetal replicates these taxonomies as data in
- * tools/chrt-baremetal/server/src/tilebuild/placeNameTiers.ts to stamp
- * `tier` onto PLACENAME index features, and
- * placename-tier-parity.test.ts evaluates the two against shared
- * fixtures. Change a branch here and that test names the drift.
+ * ── Why a QUERY PARAMETER and not a path segment ──────────────────────────
  *
- *   1 — Ocean              (OBJNAM contains "<X> Ocean" — CATSEA has no
- *                          ocean code; the attribute is 1/unset on oceans)
- *   2 — Sea / Gulf         (OBJNAM "Gulf of …" / "… Sea")
- *   3 — Bay / Sound /      (CATSEA in {5 bay, 12 narrows} OR OBJNAM
- *       Strait / Narrows    " Bay" / " Sound" / " Strait")
- *   4 — Anchorage detail   (OBJNAM contains "Anchorage Area")
- *   5 — Relief + default   (CATSEA relief codes — authoritative — or
- *                          relief-term names, or anything uncategorised;
- *                          suppressed below z9 by the size curve)
+ * A path segment would be the tidier-looking URL and it is the wrong trade
+ * here, for two reasons that are both about other people's code:
  *
- * Order matters: tier-4/5 demotions (anchorages, relief) run BEFORE the
- * promotion shims so "Bear Seamount" (contains " Sea") and "…Anchorage
- * Area" compound names can't bubble up into headline tiers.
- * `coalesce(CATSEA, catsea)` handles post-tippecanoe case variation
- * (matches `s52-conditional.ts` precedent).
+ *   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 function buildSeaAreaTierExpression(): ExpressionSpecification;
+declare const BUILD_PARAM = "v";
 /**
- * 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)
+ * One tile-URL template — the single place a CHRT tile URL is spelled.
  *
- * Tier 1/2 may fire via CATBUA when populated; OBJNAM length is the
- * fallback so unpopulated CATBUA still produces a usable hierarchy.
+ * `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 function buildBuiltUpAreaTierExpression(): ExpressionSpecification;
+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;
+}
 /**
- * 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")
+ * Build the "sources" block for a CHRT style.
  *
- * 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.
+ * - `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 buildLandRegionTierExpression(): ExpressionSpecification;
+declare function buildSources(opts?: BuildSourcesOptions): Record<string, AnySourceSpec>;
+
 /**
- * Land area tier (LNDARE): major vs. local.
- *   1 — Major (OBJNAM length <= 12)
- *   2 — Local
+ * DEPTH NUMBERS — how big the chart draws its depth figures.
  *
- * No category attribute. OBJNAM length is the only signal.
+ * 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
+ * ===========================================================================
+ *
+ * The chart's glyph sets are Open Sans Regular, Semibold and Italic — the tile
+ * worker's `/v1/glyphs` (`cloudflare/tile-worker/glyphs/GLYPHS.json`) and the
+ * offline chart-assets pack serve those three and nothing else, and a
+ * fontstack no glyph host serves is the failure `labels.ts`'s SOUNDG note
+ * describes (Native lost every sounding). Soundings are already Semibold. So "bolder" here is
+ * size: stroke width scales with the glyph, and at 1x device pixels (a Pi's
+ * panel) a 14 px Semibold numeral is both heavier and crisper than a 10 px one.
  */
-declare function buildLandAreaTierExpression(): ExpressionSpecification;
+
+/** The two choices, in presentation order. */
+declare const DEPTH_LABEL_SIZES: readonly ["standard", "large"];
+type DepthLabelSize = (typeof DEPTH_LABEL_SIZES)[number];
 /**
- * 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)
+ * Standard is the chart as it has always been drawn, and it is what a style
+ * generated without the option gets: byte-identical, so the served style, the
+ * native-render goldens and every client that never asks are unchanged.
  */
-declare function buildLakeTierExpression(): ExpressionSpecification;
+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>;
 /**
- * River tier (RIVERS): major vs. local.
- *   1 — Major river (OBJNAM length <= 15 AND no comma)
- *   2 — Local creek (else)
+ * Sounding collision padding at Large, px. Standard is 6.
+ *
+ * ⚠ THIS IS THE ONE THAT DECIDES HOW MANY SOUNDINGS SURVIVE. MapLibre drops a
+ * sounding whose box (glyphs + padding) overlaps one already placed — the
+ * shallowest places first, so what drops is the deeper figure. A 1.4x numeral
+ * inside Standard's 6 px padding lost a quarter of the soundings: bigger
+ * numbers, fewer of them, which is not what was asked for. Trimming the
+ * padding gives the box back.
+ *
+ * Measured 2026-10-05 on the chart bench (`scripts/chart-bench`, Boston, DAY,
+ * 1280x800 at 1x), soundings placed, Standard → Large at this padding:
+ *
+ *   z11.5  515 → 539 (+5%)    z12.3  434 → 415 (−4%)
+ *   z13    374 → 366 (−2%)    z14    326 → 311 (−5%)
+ *
+ * and at Standard's 6 px: 391 / 246 at z11.5 / z14 (−24% / −25%). 3 px kept
+ * z14 level but put 17% MORE figures on the coastal view, which reads as
+ * clutter rather than as the same chart drawn bigger.
  */
-declare function buildRiverTierExpression(): ExpressionSpecification;
+declare const LARGE_SOUNDING_PADDING_PX = 3.5;
 /**
- * Airport tier (AIRARE): major airport vs. small airstrip.
- *   1 — Major (OBJNAM length <= 25 — e.g. "Logan International Airport")
- *   2 — Airstrip
+ * Apply a depth-label size to one generated label layer.
+ *
+ * Standard — and any class that is not a depth figure — returns the SAME
+ * object, untouched. Large returns a copy with only the properties listed in
+ * the header changed.
  */
-declare function 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 */
+declare function applyDepthLabelSize(objectClass: string, layer: StyleLayer, size: DepthLabelSize | undefined): StyleLayer;
+
+/**
+ * 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>;
-    /** Minimum zoom level for this label */
     minzoom?: number;
+    maxzoom?: number;
+    metadata?: Record<string, unknown>;
 }
 /**
- * Optional palette-and-data-driven options for label config.
+ * Build all Mapbox GL layers for a given S-57 object class.
+ * Returns multiple layers (fill, outline, symbol, label, etc.).
  *
- * 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.
+ * Post-consolidation: all S-57 classes live as MVT layers inside one
+ * consolidated PMTiles per region; `source` is always the region name.
+ *
+ * `opts.safetyContour` is the mariner's safety depth in metres — it drives
+ * the §CSYM02 isolated-danger ring on hazard classes. Defaults to
+ * `DEFAULT_SAFETY_CONTOUR_M`, the same default the SOUNDG two-shade rule
+ * uses, so the ring and the sounding colour always agree.
  */
-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.
-     */
+declare function buildLayersForClass(objectClass: string, ct: ColorTableName, sourceId?: string, opts?: {
     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";
-}
+}): StyleLayer[];
 /**
- * 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.
+ * 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.
  */
-type LabelBehavior = "feature-band-gated" | "orientation-cross-band";
-declare const LABEL_BEHAVIOR: Record<string, LabelBehavior>;
-/** Returns the rendering strategy for an S-57 class. Unknown classes default to band-gated. */
-declare function getLabelBehavior(layerName: string): LabelBehavior;
+declare function getOrderedClasses(): string[];
+
 /**
- * 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:
+ * Dominance fan-out collapse (P8 Phase 3.3 / D4 "axis 1").
  *
- *   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.)
+ * `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.
  *
- * The ladder (safety-critical > nav-aids > depth field > structures >
- * ambient notes):
+ * **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:
  *
- *   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.
+ *   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.
  *
- * Safety guardrail: a lower rung never blocks a higher rung — placement
- * order guarantees the safety-critical label got the space first. Density
- * relief comes from dropping the LOWEST rung in a pile-up, never the top.
- */
-declare const LABEL_PRIORITY: Record<string, number>;
-/**
- * Resolve the priority rank for an S-57 class's label. Orientation classes
- * report 900 regardless of ladder membership (PRDARE etc.) so the
- * layer-order sort in style-generator.ts can treat priority uniformly.
- */
-declare function getLabelPriority(layerName: string): number;
-/**
- * Compose a `symbol-sort-key` from a class rank and an optional
- * within-class key expression. The within-class key is clamped to
- * [0, 999] so it can never bleed into a neighboring rank's band.
- */
-declare function labelSortKey(rank: number, within?: unknown): ExpressionSpecification | number;
-/**
- * Extract the trailing designation token from a nav-aid OBJNAM.
+ * 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.
  *
- * 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).
+ * **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`.
  *
- * This is the TS twin of `navAidDesignationTextExpression` — the GeoJSON
- * preprocessing path uses this function, the PMTiles path uses the GL
- * expression. Keep the two in agreement (see label-priority.test.ts).
- */
-declare function extractNavAidDesignation(objnam: string): string | null;
-/** Get label config for a given S-57 layer, or null if no labels */
-declare function getLabelConfig(layerName: string, opts?: LabelConfigOptions): LabelLayerConfig | null;
-/**
- * Build a Mapbox symbol layer spec from a label config.
- */
-declare function buildLabelLayer(layerId: string, sourceId: string, config: LabelLayerConfig, visible: boolean, overrides?: {
-    textScale?: number;
-    minzoom?: number | null;
-    allowOverlap?: boolean;
-}): maplibregl.LayerSpecification;
-/**
- * Pre-process SOUNDG GeoJSON to extract Z coordinates as `depth` properties.
- * Soundings are MultiPoint with Z values in geometry.coordinates[][2].
- * This explodes MultiPoints into individual Points with a `depth` property.
- */
-declare function preprocessSoundings(fc: GeoJSON.FeatureCollection): GeoJSON.FeatureCollection;
-/**
- * Pre-process LIGHTS GeoJSON to derive compact light characteristic labels.
- * Adds `_lightLabel` property (e.g., "Fl(2) WR 4s 5M").
+ * 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.
  *
- * 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.
+ * **Load-bearing invariant.** A collapsed per-band FEATURE layer MUST keep
+ * the `-band{B}` id segment: `custom-style.ts` `bandFloor()` parses
+ * `/-band(\d)/` to clamp customer minzoom/scamin overrides to the band's
+ * data floor, on the live public Style API path. Renaming the id silently
+ * unclamps those overrides. Cross-band LABEL layers are the deliberate
+ * exception: they carry every band floor INSIDE the filter (tile-zoom
+ * clauses a customer override cannot touch), which supersedes the clamp —
+ * `bandFloor()` returning 0 for a bare label id is correct, not a gap.
+ * Both halves asserted in `band-collapse.test.ts`.
  */
-declare function buildPlaceNameLayers(sourceId: string, ct?: ColorTableName): maplibregl.LayerSpecification[];
 
 /**
- * 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.
- *
- * @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
+ * Which emitter the style generator uses for the dominance fan.
+ * `"legacy"` exists so CI can differentially prove the two equivalent (it is
+ * the oracle in `band-collapse.test.ts`) and as a one-line rollback. It is an
+ * internal knob — deliberately NOT on the exported `StyleGeneratorOptions`,
+ * so it cannot reach `@chrtco/sdk` consumers via `ChrtStyleOptions`.
  */
-declare function decimateFeatures(fc: GeoJSON.FeatureCollection, layerName: string, currentZoom: number, bounds: {
-    west: number;
-    south: number;
-    east: number;
-    north: number;
-}, opts?: DecimationOptions): GeoJSON.FeatureCollection;
+type BandFanMode = "collapsed" | "legacy";
+
 /**
- * Get the max number of cells to load based on zoom level.
+ * Generates a complete Mapbox GL Style Specification v8 JSON
+ * from the S-52 atlas definitions.
  */
-declare function getMaxCellsForZoom(zoom: number): number;
 
-/**
- * IHO S-52 / NOAA Chart No. 1 / INT1 nautical symbol SVGs.
- *
- * Complete symbology suite following:
- *   - IHO S-52 Presentation Library (Ed 4.0)
- *   - IALA Maritime Buoyage System R1001 (Region B for US waters)
- *   - NOAA Chart No. 1 (Ed 13) / INT1
- *
- * Buoy shape terminology (US / Chart No. 1):
- *   - CAN (Q20): Flat-top cylindrical buoy — Port mark in IALA-B (red)
- *   - NUN (Q21): Conical/pointed-top buoy — Starboard mark in IALA-B (green)
- *   - PILLAR: Tall narrow buoy — used for cardinal, isolated danger, etc.
- *   - SPAR: Tall thin pole buoy
- *   - SPHERICAL: Round buoy — safe water marks
- *   - BARREL: Barrel/tun shaped buoy
- *   - SUPER: Large navigation buoy / LANBY
- *
- * Cardinal mark topmark orientations (IALA):
- *   - North: both cones point UP ▲▲
- *   - South: both cones point DOWN ▼▼
- *   - East:  cones base-to-base (diamond) ◆
- *   - West:  cones point-to-point (hourglass) ⊗
- *
- * Each symbol is a compact SVG at 32×32 for Mapbox GL `map.addImage()`.
- */
-/** Color used in the SVG with its S-52 token name, hex, and usage */
-interface SymbolColor {
-    token: string;
-    hex: string;
-    usage: string;
+interface MapboxStyle {
+    version: 8;
+    name: string;
+    metadata: Record<string, unknown>;
+    sources: Record<string, unknown>;
+    sprite?: string;
+    glyphs: string;
+    layers: StyleLayer[];
 }
-/** Line style used in the SVG */
-interface SymbolLineStyle {
-    element: string;
-    width: number;
-    pattern?: string;
-    color: string;
+interface StyleGeneratorOptions extends BuildSourcesOptions {
+    /**
+     * When set, emit a "paper chart" style centered on the selected scale
+     * band, with graceful coverage fallback: the requested band's layers
+     * draw on top where its cells have data; coarser bands (driven by
+     * `CHART_CASCADE_CODES`) fill gaps where the requested band has no
+     * cells. Per-feature SCAMIN minzooms are preserved on every cascade
+     * variant; `maxzoom` is dropped so the user can zoom in indefinitely.
+     *
+     * When omitted (default), continuous mode emits one layer copy per
+     * source band with strict per-band zoom windows so exactly one band
+     * renders at any given continuous zoom.
+     *
+     * `lockedBounds` (optional) restricts chart-mode rendering to a
+     * specific bbox via a `["within"]` filter — applied ONLY to the
+     * requested band's variants. Cascade fallback bands render across the
+     * full viewport so a chart-Harbor user panning offshore still sees
+     * Approach/Coastal data. The frontend pairs this with a translucent
+     * grey overlay outside the bbox so the lock boundary is still visible
+     * to the user (the fallback data is dimmed by the overlay but not
+     * filtered out).
+     */
+    chartMode?: {
+        band: ScaleBand$1;
+        lockedBounds?: BBox;
+    };
+    /**
+     * Display unit for depth labels (SOUNDG soundings, DEPCNT contour
+     * values). Source data is always meters (S-57 / VALSOU / VALDCO);
+     * "feet" wraps the text-field expression with a unit conversion +
+     * round so the rendered numbers match. Default "meters".
+     */
+    depthUnits?: "meters" | "feet";
+    /**
+     * Which symbol artwork the style references. "s52" (default) uses the
+     * PresLib-derived S-52 set; "s101" rewrites icon references to the
+     * official S-101 Portrayal Catalogue symbols (s101: image namespace)
+     * where a counterpart exists — see s101-style.ts. "chrt" applies the
+     * CHRT house ATON/LIGHTS glyphs with colour-true tinting — see
+     * chrt-style.ts. Selection logic differences are documented per module.
+     */
+    symbolSet?: "s52" | "s101" | "chrt" | "raster";
+    /**
+     * The mariner's safety contour in metres — the depth below which a
+     * feature is "dangerous to my hull". Drives both safety-contour
+     * conditional symbology rules:
+     *
+     *   - §SOUNDG02 — soundings shoaler than this render in the
+     *     high-contrast color; deeper soundings render in the muted color.
+     *   - §CSYM02   — isolated dangers (rocks / wrecks / obstructions)
+     *     shoaler than this get the DNGCIR01 danger ring.
+     *
+     * Default `DEFAULT_SAFETY_CONTOUR_M` (10 m).
+     *
+     * Does not affect the DEPARE depth-area shading, whose 2/5/10 m bands
+     * are a separate S-52 concept.
+     */
+    safetyContour?: number;
+    /**
+     * When false, all soundings render in a single shade. Default true.
+     */
+    twoShadeSoundings?: boolean;
+    /**
+     * Label model for the 9 orientation place-name classes (SEAARE, LNDRGN,
+     * LAKARE, RIVERS, CANALS, BUAARE, AIRARE, LNDARE, PRDARE).
+     *
+     * "legacy" (default) — the per-cell-band orientation fan
+     * (fanOrientationLabelByCellBand): one label per feature per band,
+     * deconflicted only by `_label_anchor` tags and watermark opacity.
+     *
+     * "placename" — 2 PLACENAME symbol layers over the build-side
+     * place-name index (CHRTbaremetal placeNameIndex.ts): one collision-
+     * managed label per named place with a per-feature zoom window; the
+     * orientation fan for those classes is NOT emitted. Requires tiles
+     * built with the PLACENAME side index — on older tiles the layers
+     * simply draw nothing (soft-fail is index-side), which is why the
+     * default stays "legacy" until L2c's rebuild + Maine-coast visual
+     * verification flips it (docs/design/chart-label-deconfliction.md
+     * §2.3). Feature-label classes are untouched either way.
+     */
+    labels?: "legacy" | "placename";
+    /**
+     * Font weight for SOUNDG labels. Default "semibold" — crisper numerals
+     * at small sizes on screen.
+     */
+    soundingFontWeight?: "regular" | "semibold";
+    /**
+     * How big the depth figures are drawn — soundings, contour values and the
+     * depth beside a rock, wreck or obstruction. "standard" (default) is
+     * byte-identical to omitting it; "large" enlarges those labels only, and
+     * never their text, colours, sort keys, filters or layer set. See
+     * depth-label-size.ts.
+     */
+    depthLabelSize?: DepthLabelSize;
 }
-/** Fill element used in the SVG */
-interface SymbolFillElement {
-    element: string;
-    color: string;
-    opacity?: number;
+declare function generateStyle(palette?: ColorTableName, opts?: StyleGeneratorOptions & {
+    bandFan?: BandFanMode;
+}): MapboxStyle;
+declare function generateStyleJSON(palette?: ColorTableName, opts?: StyleGeneratorOptions): string;
+/** Get summary stats about the generated style */
+declare function getStyleStats(style: MapboxStyle): {
+    totalLayers: number;
+    fillLayers: number;
+    lineLayers: number;
+    symbolLayers: number;
+    circleLayers: number;
+    sources: number;
+    objectClasses: Set<string>;
+};
+
+/**
+ * The e-ink portrayal pass — what `EINK_COLOR`, `EINK_MONO` and `EINK_NIGHT`
+ * change beyond their colour tables. Night is mono inverted: everything below
+ * applies, the patterns and safety contour are drawn LIGHT (the patterns are
+ * themed per palette, the contour takes the table's DEPSC), and the chart
+ * background gets the no-coverage crosshatch, because a black no-data hole
+ * on a black-water page would read as deep water.
+ *
+ * A colour table can only move colours. E-paper needs more than that (owner
+ * decision 2026-10-05: CHRT serves the e-ink chart, clients never recolour it;
+ * requirements in CHRTsail's e-ink product spec §3c):
+ *
+ *   1. MEANING UNCHANGED. Nothing here adds, removes or reorders a feature
+ *      class or changes a filter that decides WHICH features draw. It changes
+ *      how they look, and adds two kinds of OVERLAY layer (depth patterns,
+ *      the safety contour) that draw features the chart already draws.
+ *   2. MONO STANDS ON ITS OWN. Depth steps become fill PATTERNS (mono only);
+ *      danger areas get a cross-hatch; the safety contour gets its own heavy
+ *      line; restricted/caution areas keep their dashes, now heavier.
+ *   3. DEPTH IN AT MOST FOUR STEPS. The tables do the colour side (DEPMD ==
+ *      DEPDW). Mono shows three: drying (hatch), shallower than the safety
+ *      contour (stipple), safe (paper).
+ *   4. SAFETY CONTOUR AND DANGERS EMPHASISED: a heavy black safety-contour
+ *      line; danger symbols drawn larger; danger areas cross-hatched.
+ *   5. COVERAGE PORTRAYAL SURVIVES: the no-coverage crosshatch goes to full
+ *      strength rather than being dropped with the other translucency.
+ *   6. ATTRIBUTION/CURRENCY METADATA: untouched — this pass never edits
+ *      `sources` or the metadata other than adding `chrt:eink`.
+ *   7. SIZES FOR 150 ppi COLOUR / 300 ppi MONO: every line ×1.5 (min 1 px),
+ *      text ×1.15 with a solid paper halo, no translucency, no blur, no fades.
+ *
+ * Translucency is the thing e-paper cannot draw: a 10% magenta wash over pale
+ * blue is a fifth grey in mono and nothing at all on Kaleido 3. So faint washes
+ * (< 0.3) are dropped — every one of them is a CHRT addition over a feature
+ * whose boundary and symbol S-52 already draws — and stronger ones are made
+ * solid.
+ *
+ * Pure: takes a generated style, returns a new one. `generateStyle` applies it
+ * for the e-ink tables, so the served style, the offline style and the SDK's
+ * local `generateStyle` all carry the same portrayal.
+ */
+
+/** 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;
 }
-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;
+/**
+ * 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 applyEinkPortrayal(style: MapboxStyle, palette: ColorTableName, opts?: EinkPortrayalOptions): MapboxStyle;
+
+/**
+ * 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.
+ *
+ * The one derivation the palettes rely on, and the reason this file exists:
+ * NIGHT's deeper sounding SNDG1 (#897350) is SNDG2 (#c8aa78) at 43% of its
+ * linear light. `labels.ts` builds its NIGHT secondary text the same way, so
+ * the two stay one family by construction rather than by two hand-typed hexes
+ * that happen to agree.
+ */
+/** WCAG 2.x relative luminance of a `#rrggbb` colour, 0 (black) to 1 (white). */
+declare function relativeLuminance(hex: string): number;
+/** WCAG 2.x contrast ratio between two `#rrggbb` colours, 1 to 21. */
+declare function contrastRatio(a: string, b: string): number;
+/**
+ * The same hue at `factor` times its linear light. `factor` above 1 can clip a
+ * channel, which shifts the hue; nothing in the palettes brightens, so callers
+ * pass 0–1.
+ */
+declare function scaleLinearLight(hex: string, factor: number): string;
+/**
+ * `hex` dimmed, hue kept, until its luminance is at most `ceiling`. A colour
+ * already at or under the ceiling comes back unchanged (lower-cased).
+ */
+declare function capLuminance(hex: string, ceiling: number): string;
+/**
+ * NIGHT's two ink levels, shared by every family's text and marks.
+ *
+ *   `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 const NIGHT_INK: string;
+declare const NIGHT_MUTED_INK: 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`.
+ */
+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;
 }
-/** 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 S52_LOOKUP: Record<string, LookupEntry>;
+
+/**
+ * S-52 draw order: layers listed bottom → top.
+ * Layers not in this list are inserted before point features.
  */
-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_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;
+/**
+ * Convert S-52 SCAMIN (scale minimum) to Mapbox GL minzoom.
  */
-declare function getIconExpression(layerName: string): string | unknown[];
+declare function scaminToMinZoom(scamin?: number): number | undefined;
+declare function getCollisionSettings(viewingGroup?: number): {
+    iconAllowOverlap: boolean;
+    iconOptional: boolean;
+    symbolSortKey?: number;
+};
 /**
- * Browser-only image loaders (`loadSymbolImages`, `loadThemedBridgeImages`)
- * live in `./symbols-browser.ts` (sub-export `@chrtco/sdk/atlas/browser`) —
- * they require a DOM (use `new Image()` + `map.addImage()`).
+ * Get the resolved Mapbox GL style for a given S-57 layer.
  */
-/** 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 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.
+ */
+declare const DEFAULT_SAFETY_CONTOUR_M = 10;
+declare function depareColor(props: Record<string, unknown>, ct?: ColorTableName, safetyContourM?: number): string;
+/**
+ * The colour token of each `case` branch of `depareFillExpression`, in branch
+ * order, then the fallback. `depth-area-opaque.ts` names the layers it splits
+ * the expression into from this list, so the two read from one place.
+ */
+declare const DEPARE_FILL_BRANCH_TOKENS: readonly ["DEPIT", "DEPVS", "DEPMS", "DEPMD"];
+declare const DEPARE_FILL_FALLBACK_TOKEN = "DEPDW";
+declare function depareFillExpression(ct?: ColorTableName, safetyContourM?: number): unknown[];
+declare function lightColor(props: Record<string, unknown>, ct?: ColorTableName): string;
+declare function lightFillExpression(ct?: ColorTableName): unknown[];
+declare function lateralColor(props: Record<string, unknown>, ct?: ColorTableName): string;
+declare function lateralFillExpression(ct?: ColorTableName): unknown[];
+declare function hazardColor(props: Record<string, unknown>, ct?: ColorTableName): string;
+declare function hazardFillExpression(ct?: ColorTableName): unknown[];
+declare function daymarkColor(props: Record<string, unknown>, ct?: ColorTableName): string;
+
+/**
+ * Label configurations for S-57 layers.
+ * Defines which layers get text labels and how to extract label text.
  */
-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;
-}[];
 
 /**
- * S-101 Portrayal Catalogue — New Symbol SVGs
+ * 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.
+ *
+ *   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).
+ */
+declare function buildSeaAreaTierExpression(): ExpressionSpecification;
+/**
+ * Built-up area tier (BUAARE): major city / town / neighborhood.
+ *   1 — Major city (CATBUA=1 urban, or OBJNAM length <= 8)
+ *   2 — Town (CATBUA=5 village, or OBJNAM length <= 14)
+ *   3 — Neighborhood (longer compound names)
+ *
+ * Tier 1/2 may fire via CATBUA when populated; OBJNAM length is the
+ * fallback so unpopulated CATBUA still produces a usable hierarchy.
+ */
+declare function buildBuiltUpAreaTierExpression(): ExpressionSpecification;
+/**
+ * Land region tier (LNDRGN): major region vs. local point.
+ *   1 — Major region (OBJNAM length <= 12 AND no comma — "Long Island", "Cape Cod")
+ *   2 — Local point (else — "Bird Island", "Cottage Park")
+ *
+ * No CATLND analog for region scope, so OBJNAM is the only signal.
+ * The comma-absence test is a heuristic: NOAA compound names like
+ * "Boston Harbor, MA Castle Island" carry a comma and belong at deeper
+ * zoom regardless of length.
+ */
+declare function buildLandRegionTierExpression(): ExpressionSpecification;
+/**
+ * Land area tier (LNDARE): major vs. local.
+ *   1 — Major (OBJNAM length <= 12)
+ *   2 — Local
+ *
+ * No category attribute. OBJNAM length is the only signal.
+ */
+declare function buildLandAreaTierExpression(): ExpressionSpecification;
+/**
+ * Lake tier (LAKARE): lake vs. reservoir/pond.
+ *   1 — Lake (CATLAK=1, or OBJNAM length <= 12)
+ *   2 — Reservoir/pond (CATLAK in {2,3}, or longer name)
+ */
+declare function buildLakeTierExpression(): ExpressionSpecification;
+/**
+ * River tier (RIVERS): major vs. local.
+ *   1 — Major river (OBJNAM length <= 15 AND no comma)
+ *   2 — Local creek (else)
+ */
+declare function buildRiverTierExpression(): ExpressionSpecification;
+/**
+ * Airport tier (AIRARE): major airport vs. small airstrip.
+ *   1 — Major (OBJNAM length <= 25 — e.g. "Logan International Airport")
+ *   2 — Airstrip
+ */
+declare function buildAirportTierExpression(): ExpressionSpecification;
+interface LabelLayerConfig {
+    /** Mapbox source layer type */
+    type: "symbol";
+    /** Text field expression or string */
+    textField: ExpressionSpecification | string;
+    /** Text size in pixels */
+    textSize: number | ExpressionSpecification;
+    /** Text color (hex) or data-driven expression */
+    textColor: string | ExpressionSpecification;
+    /** Halo color for contrast */
+    textHaloColor: string;
+    /** Halo width — pixels or zoom-interpolation expression */
+    textHaloWidth: number | ExpressionSpecification;
+    /** Text offset [x, y] in ems */
+    textOffset: [number, number];
+    /** Font stack */
+    textFont?: string[];
+    /** Additional layout properties */
+    layout?: Record<string, unknown>;
+    /** Minimum zoom level for this label */
+    minzoom?: number;
+}
+/**
+ * Optional palette-and-data-driven options for label config.
+ *
+ * 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.
+ */
+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";
+}
+/**
+ * Two-tier label rendering strategy for the band-priority style.
  *
- * 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.
+ * `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.
  *
- * Reference: IHO S-101 Portrayal Catalogue (Ed 1.1.0)
+ * `orientation-cross-band` — emit a SINGLE label layer with no band
+ * filter. The per-class `minzoom` is honoured. Right for orientation
+ * "where am I" labels (sea-area names, land regions, cities) — these
+ * must persist as the user zooms in, even if the broader-scope cell
+ * carrying the OBJNAM is from a coarser band than the one rendering
+ * features at the current zoom. Collision arbitration via
+ * `ORIENTATION_BAND_SORT_KEY` gives the broader-scope (lower-band) copy
+ * priority where the same OBJNAM exists in multiple bands.
  */
-
-declare const S101_NEW_SYMBOLS: NauticalSymbol[];
-
+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;
 /**
- * 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.
+ * 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.
  *
- * `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.
+ * 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.
  */
-/** Vector source emitted for the legacy Mapbox MTS path. */
-interface MapboxVectorSource {
-    type: "vector";
-    url: string;
-}
+declare const LABEL_PRIORITY: Record<string, number>;
 /**
- * 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.
+ * 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.
  */
-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 getLabelPriority(layerName: string): number;
 /**
- * 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.
+ * 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.
  */
-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 labelSortKey(rank: number, within?: unknown): ExpressionSpecification | number;
 /**
- * CHRT_BASE's zoom range. 11 is the deepest zoom the archive's detail tier
- * carries honestly — the planet's inland water exists from z9 and is read at
- * z10 — and the world tier is tiled to the same depth so no layer vanishes
- * from a tile the detail tier creates. Above 11 the client overzooms, and
- * overzoomed inland water looks soft DELIBERATELY: it is "roughly where the
- * lakes are", not a surveyed shoreline. Must equal the builder's MAXZOOM
- * (tools/chrtbase-build/build.mjs).
+ * Extract the trailing designation token from a nav-aid OBJNAM.
+ *
+ * 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).
+ *
+ * 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 const BASE_MINZOOM = 0;
-declare const BASE_MAXZOOM = 11;
+declare function extractNavAidDesignation(objnam: string): string | null;
+/** Get label config for a given S-57 layer, or null if no labels */
+declare function getLabelConfig(layerName: string, opts?: LabelConfigOptions): LabelLayerConfig | null;
 /**
- * The 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.
+ * Build a Mapbox symbol layer spec from a label config.
  */
-declare const BASE_ATTRIBUTION = "\u00A9 CHRT \u00B7 Made with Natural Earth \u00B7 \u00A9 OpenStreetMap contributors";
+declare function buildLabelLayer(layerId: string, sourceId: string, config: LabelLayerConfig, visible: boolean, overrides?: {
+    textScale?: number;
+    minzoom?: number | null;
+    allowOverlap?: boolean;
+}): maplibregl.LayerSpecification;
 /**
- * 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`).
+ * 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 const LAND_ATTRIBUTION = "\u00A9 OpenStreetMap contributors";
+declare function preprocessSoundings(fc: GeoJSON.FeatureCollection): GeoJSON.FeatureCollection;
 /**
- * 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.
+ * Pre-process LIGHTS GeoJSON to derive compact light characteristic labels.
+ * Adds `_lightLabel` property (e.g., "Fl(2) WR 4s 5M").
+ *
+ * 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 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 preprocessLights(fc: GeoJSON.FeatureCollection): GeoJSON.FeatureCollection;
+/** List of layers that have labels */
+declare const LABELED_LAYERS: Set<string>;
 /**
- * How `CHRT_RELIEF`'s PNGs encode elevation. MapLibre's raster-dem default is
- * `mapbox`, which decodes terrarium RGB into nonsense heights — so every
- * surface that describes this source (this registry, the tile-worker's
- * TileJSON) has to say it.
+ * Pre-process buoy/beacon GeoJSON to derive concise mariner-style labels.
+ * Adds `_navAidLabel` property (e.g., 'R "8"', 'G "5"').
  */
-declare const RELIEF_ENCODING = "terrarium";
-type SourceMode = "mapbox" | "pmtiles";
+declare function preprocessNavAids(fc: GeoJSON.FeatureCollection): GeoJSON.FeatureCollection;
+/** Check if a layer name needs nav aid preprocessing */
+declare function isNavAidLayer(layerName: string): boolean;
 /**
- * Query parameter carrying the resolved build id on every tile URL.
- *
- * ── Why the build has to be IN THE URL ────────────────────────────────────
- *
- * The Worker reports the build it served in the `X-Build-Id` RESPONSE HEADER
- * and sends `Cache-Control: private, max-age=3600`. A header is not part of a
- * cache key, so every build shares one URL: after a cutover, tiles the client
- * already fetched keep coming from its own HTTP cache — the old build — while
- * newly-panned-to tiles come from the new one, for up to the full hour. The
- * client renders TWO BUILDS AT ONCE.
- *
- * 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).
+ * 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 const BUILD_PARAM = "v";
+declare function buildPlaceNameLayers(sourceId: string, ct?: ColorTableName): maplibregl.LayerSpecification[];
+
 /**
- * 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.
+ * 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 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;
+interface DecimationOptions {
+    /** Grid resolution (cells per axis). Default 80. */
+    gridSize?: number;
+    /** Zoom level below which decimation kicks in. Default 12. */
+    zoomThreshold?: number;
 }
 /**
- * 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`
+ * 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.
  *
- * 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}.
+ * @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 buildSources(opts?: BuildSourcesOptions): Record<string, AnySourceSpec>;
-
+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";
-}
-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";
 
@@ -4693,7 +4915,11 @@ declare const DEFAULT_CUSTOM_STYLE_CONFIG: CustomStyleConfig;
  * fields fall back to the platform defaults. Never throws.
  */
 declare function sanitizeCustomStyleConfig(raw: unknown): CustomStyleConfig;
-/** Normalize a `?theme=` value to a colour table name; null for anything else. */
+/**
+ * Normalize a `?theme=` value to a colour table name; null for anything else.
+ * Case-insensitive; `-` is accepted for `_` (`eink-mono` = `eink_mono`), so
+ * the e-ink names survive either spelling a caller guesses.
+ */
 declare function normalizeTheme(raw: string | null | undefined): ColorTableName | null;
 interface ResolvedTheme {
     palette: ColorTableName;
@@ -5061,7 +5287,8 @@ declare class OfflineError extends Error {
 
 /** Options for `chrt.style()`. Extends the atlas style generator options. */
 interface ChrtStyleOptions extends StyleGeneratorOptions {
-    /** S-52 colour palette: "DAY" (default), "DUSK", or "NIGHT". */
+    /** Colour palette: "DAY" (default), "DUSK", "NIGHT", or the e-paper
+     *  palettes "EINK_COLOR" / "EINK_MONO" / "EINK_NIGHT" (see `EINK_COLOR_TABLES`). */
     palette?: ColorTableName;
 }
 declare class Chrt {
@@ -5350,4 +5577,4 @@ declare class Chrt {
     warmTiles(region?: string): Promise<TileTokenResponse>;
 }
 
-export { ALL_NAV_AID_LAYERS, ALL_WATER_BODY_LAYERS, AREA_QUERY_LAYERS, ATON_EXPRESSION_CLASSES, type AheadCoverageCell, type AheadFeatureProperties, type AheadOptions, type AheadResponse, type AlongRouteFeatureProperties, type AlongRouteOptions, type AlongRouteResponse, type AreaInspectResult, type AtlasStyle, type AttachOptions, BAND_CODE_ALIASES, BAND_DRAW_ORDER, BAND_PRIORITY_RANGES, BASE_ATTRIBUTION, BASE_BUNDLE_ATTRIBUTION, BASE_BUNDLE_ID, BASE_BUNDLE_MAXZOOM, BASE_BUNDLE_SCHEMA, BASE_BUNDLE_SOURCE_LAYERS, BASE_CLIENT_RASTER_BEFORE_ID, BASE_MAXZOOM, BASE_MINZOOM, BASE_REGION, type BBox, BRIDGE_QUERY_LAYERS, BUILD_MAXZOOM, BUILD_MINZOOM, BUILD_PARAM, type BandCode, type BandPriorityRange, type BridgeInspectResult, type BuildOfflineStyleOptions, type BuildSourcesOptions, CHART_BAND_CODES, CHART_CASCADE_CODES, CHART_SECTIONS, CHRTRASTER_REF_CROPS, CHRTRASTER_SVGS, CHRT_ATON_COLORS, CHRT_GLYPH_NAMES, CHRT_GLYPH_SVGS, CHRT_ICON_EXPRESSIONS, CHRT_ICON_PREFIX, CHRT_SDF_GLYPHS, CHRT_STYLE_MODES, type CandidateQueryOptions, type CandidatesEventContext, type CellDeletedEvent, type CellDetail, type CellEventData, type CellNewEvent, type CellUpdatedData, type CellUpdatedEvent, type CellsOptions, type CellsResponse, type ChartSection, Chrt, type ChrtConfig, ChrtError, type ChrtStyleMode, type ChrtStyleOptions, type ChrtStyleTheme, type ChrtSymbolSet, type ClickAnchor, ColorTableName, type CoverageOptions, type CoverageResponse, type CoverageRouteCell, type CoverageRouteOptions, type CoverageRouteResponse, type CoverageSource, type CustomStyleConfig, DEFAULT_CLICK_TOLERANCE, DEFAULT_CUSTOM_STYLE_CONFIG, DEFAULT_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, DRAPEABLE_LAYER_TYPES, type DecodedAreaFeature, type DecodedBridge, type DecodedNavAid, type DecodedProperty, 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, 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, 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, isNavAidLayer, isNavAidLayerVisible, isSoundingLayerVisible, isVisibleInMode, isWaterBodyLayerVisible, 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, sanitizeCustomStyleConfig, scaleLinearLight, scaleSizeValue, scaminToMinZoom, sectorLimitToArcBearing, splitOpaqueDepthAreas, styleModeBand, terrainStackCount, themeChrtGlyph, tileTemplate, uncoveredSectorArcs, withinBboxFilter, worldMinusBboxPolygon };
+export { ALL_NAV_AID_LAYERS, ALL_WATER_BODY_LAYERS, AREA_QUERY_LAYERS, ATON_EXPRESSION_CLASSES, type AheadCoverageCell, type AheadFeatureProperties, type AheadOptions, type AheadResponse, type AlongRouteFeatureProperties, type AlongRouteOptions, type AlongRouteResponse, type AreaInspectResult, type AtlasStyle, type AttachOptions, BAND_CODE_ALIASES, BAND_DRAW_ORDER, BAND_PRIORITY_RANGES, BASE_ATTRIBUTION, BASE_BUNDLE_ATTRIBUTION, BASE_BUNDLE_ID, BASE_BUNDLE_MAXZOOM, BASE_BUNDLE_SCHEMA, BASE_BUNDLE_SOURCE_LAYERS, BASE_CLIENT_RASTER_BEFORE_ID, BASE_MAXZOOM, BASE_MINZOOM, BASE_REGION, type BBox, BRIDGE_QUERY_LAYERS, BUILD_MAXZOOM, BUILD_MINZOOM, BUILD_PARAM, type BandCode, type BandPriorityRange, type BridgeInspectResult, type BuildOfflineStyleOptions, type BuildSourcesOptions, CHART_BAND_CODES, CHART_CASCADE_CODES, CHART_SECTIONS, CHRTRASTER_REF_CROPS, CHRTRASTER_SVGS, CHRT_ATON_COLORS, CHRT_GLYPH_NAMES, CHRT_GLYPH_SVGS, CHRT_ICON_EXPRESSIONS, CHRT_ICON_PREFIX, CHRT_SDF_GLYPHS, CHRT_STYLE_MODES, type CandidateQueryOptions, type CandidatesEventContext, type CellDeletedEvent, type CellDetail, type CellEventData, type CellNewEvent, type CellUpdatedData, type CellUpdatedEvent, type CellsOptions, type CellsResponse, type ChartSection, Chrt, type ChrtConfig, ChrtError, type ChrtStyleMode, type ChrtStyleOptions, type ChrtStyleTheme, type ChrtSymbolSet, type ClickAnchor, ColorTableName, type CoverageOptions, type CoverageResponse, type CoverageRouteCell, type CoverageRouteOptions, type CoverageRouteResponse, type CoverageSource, type CustomStyleConfig, DEFAULT_CLICK_TOLERANCE, DEFAULT_CUSTOM_STYLE_CONFIG, DEFAULT_DEPTH_LABEL_SIZE, DEFAULT_INSPECT_CLASS_RANK, DEFAULT_LABEL_SETTINGS, DEFAULT_NAV_AID_SETTINGS, DEFAULT_REGION, DEFAULT_SAFETY_CONTOUR_M, DEFAULT_SOUNDING_SETTINGS, DEFAULT_TILE_BASE_URL, DEFAULT_TILE_REGION, DEFAULT_WATER_BODY_SETTINGS, DEPARE_FILL_BRANCH_TOKENS, DEPARE_FILL_FALLBACK_TOKEN, DEPTH_LABEL_CLASSES, DEPTH_LABEL_SIZES, DRAPEABLE_LAYER_TYPES, type DecodedAreaFeature, type DecodedBridge, type DecodedNavAid, type DecodedProperty, type DepthLabelSize, type DisplayCategory, type DisplayMode, EINK_DANGER_PATTERN, EINK_DOTS_PATTERN, EINK_HATCH_PATTERN, type FeatureCollection, type FeaturesOptions, type FetchStyleOptions, FileSystemAdapter, type FlashPattern, type FlashPhase, type GenerateCustomStyleOptions, type GeneratedCustomStyle, type GeoJsonFeature, type GeoJsonGeometry, type GeomType, INSPECT_CLASS_RANK, INSPECT_RANK_DEVIATIONS, type InspectCandidate, type InspectCandidateSet, type InspectEnrichment, type InspectEventContext, type InspectNotice, type InspectOptions, type InspectResult, type InspectTargetClass, type InspectableFeature, InteractClient, type InteractEntitlement, InteractError, type InteractErrorCode, type InteractHandle, type InteractMapLike, type InteractMapMouseEvent, LABELED_LAYERS, LABEL_BEHAVIOR, LABEL_LAYER_GROUPS, LABEL_PRIORITY, LAMP_CORE_LAYER_ID, LAMP_GLOW_LAYER_ID, LAMP_LAYER_IDS, LAMP_TICK_MS, LAND_ATTRIBUTION, LAND_BUILD_MAXZOOM, LAND_REGION, LARGE_SOUNDING_PADDING_PX, type LabelBehavior, type LabelConfigOptions, type LabelLayerConfig, type LabelSettings, type LampLayer, type LookupEntry, type MapLibreStyle, type MapboxStyle, type MapboxVectorSource, type MarineAlert, type MarineAlertsOptions, type MarineAlertsResponse, type MarineConditionsObservation, type MarineConditionsOptions, type MarineConditionsResponse, type MarineConditionsSeries, type MarineForecastOptions, type MarineForecastPeriod, type MarineForecastResponse, type MarineSeas, type MarineStation, type MarineSwellTrain, type MarineWind, type MarineZoneRef, NAUTICAL_SYMBOLS, NAV_AID_LAYER_GROUPS, NAV_AID_QUERY_LAYERS, NIGHT_INK, NIGHT_MUTED_INK, NON_SOLAS_DISCLAIMER, NON_SOLAS_DISCLAIMER_SHORT, type NauticalCategory, type NauticalSymbol, type NavAidInspectResult, type NavAidSettings, type NearbyMarineStation, OPAQUE_SPLIT_OF, type OfflineBundleResponse, type OfflineDownloadOptions, type OfflineDownloadProgress, type OfflineDownloadResult, OfflineError, type OfflineErrorCode, type OfflineFetchStyleOptions, type OfflineHeartbeatOptions, type OfflineRegionSummary, type OfflineRemoveOptions, OfflineStyleError, type OfflineStylePlatform, type OfflineStyleResponse, PLACENAME_LAND_CLASSES, PLACENAME_SOURCE_LAYER, PLACENAME_WATER_CLASSES, type ParsedSigseqTerms, type PmtilesVectorSource, type Poi, type PoiCoverage, type PoiDataset, type PoiOptions, type PoiResponse, type QueryFeatureProperties, type QueryOptions, type QueryResponse, RASTER_ATON_CLASSES, RASTER_GLYPH_NAMES, RASTER_ICON_PREFIX, RELIEF_ATTRIBUTION, RELIEF_ENCODING, RELIEF_REGION, RELIEF_TILE_SIZE, type ResolvedStyle, type ResolvedTheme, type S101ArtworkProvenance, type S101Feature, S101_AREA_FILL_NAMES, S101_CHART_SECTIONS, S101_FEATURES, S101_ICON_PREFIX, S101_LINE_STYLE_NAMES, S101_NEW_SYMBOLS, S101_NO_OFFICIAL_COUNTERPART, S101_SOURCE_COMMIT, S101_SYMBOL_GROUPS, S101_SYMBOL_NAMES, S52_ATON_LOOKUPS, S52_ATON_LOOKUPS_PAPER, S52_DRAW_ORDER, S52_LOOKUP, S52_PATTERN_SPRITE_PREFIX, SIGPER_TOLERANCE_SECONDS, SIGSEQ_MAX_TERMS, SOUNDING_LAYERS, SYMBOL_GROUPS, SYMBOL_MAP, type ScaleBand, type SearchCoverageNotice, type SearchHit, type SearchOptions, type SearchResponse, type SectorArcFeature, type SectorArcFeatureCollection, type SectorInfo, type SigseqRefusal, type SigseqTerm, type SoundingSettings, type SourceMode, type StyleGeneratorOptions, type StyleLayer, type StyleUrlOptions, type SymbolGroup, TileAuth, type TileGroup, type TileGroupsResponse, TileTokenError, type TileTokenErrorCode, type TileTokenResponse, type TransformRequest, type TransformedRequest, type VectorSourceSpec, type VesselProfile, WATER_BODY_LAYER_GROUPS, type WaterBodySettings, WeatherEndpoint, type WeatherReading, type WebhookEvent, type WebhookEventType, type WebhookPayload, applyBaseBundle, applyChrtSymbolSet, applyColorTheme, applyCustomStyleSettings, applyDepthLabelSize, applyEinkPortrayal, applyRasterSymbolSet, applyS101SymbolSet, atonIconExpression, bandFilterExpression, buildAirportTierExpression, buildBuiltUpAreaTierExpression, buildFlashPattern, buildLabelLayer, buildLakeTierExpression, buildLampLayers, buildLandAreaTierExpression, buildLandRegionTierExpression, buildLayersForClass, buildOfflineStyle, buildPlaceNameLayers, buildRiverTierExpression, buildSeaAreaTierExpression, buildSectorArcGeoJSON, buildSectorArcsFC, buildSectorsFromFeatures, buildSources, candidateRank, capLuminance, cellBandCharacters, cellBandMatch, chrtAtonTintExpression, chrtHouseColor, chrtLightTintExpression, collectCandidates, collectClickCandidates, combineWithBandFilter, contrastRatio, daymarkColor, decimateFeatures, decodeAreaFeatureProps, decodeBridgeProps, decodeCandidate, decodeNavAidProps, depareColor, depareFillExpression, depthAreaClassLayerId, depthAreaSplitIds, deriveMarinerName, drapeHalves, drapedFirst, extractNavAidDesignation, featureIdentity, generateCustomStyle, generateSpriteManifest, generateSpriteSheet, generateStyle, generateStyleJSON, getAvailableLineSymbols, getAvailablePatterns, getAvailablePointSymbols, getCollisionSettings, getDrawPriority, getGridSizeForZoom, getIconExpression, getLabelBehavior, getLabelConfig, getLabelPriority, getLookupEntry, getMaxCellsForZoom, getOrderedClasses, getRasterSvg, getS52SvgString, getS52SymbolStats, getStyleStats, getSymbolSvgString, getThemedS101Svg, getThemedS52Svg, getTopmarkMeaning, hazardColor, hazardFillExpression, isDepthAreaClassLayerId, isDrapeable, isLabelLayerVisible, isMapLive, isNavAidLayer, isNavAidLayerVisible, isSoundingLayerVisible, isVisibleInMode, isWaterBodyLayerVisible, labelSortKey, lampRhythmColour, lampRhythmOpacity, lateralColor, lateralFillExpression, lightColor, lightFillExpression, lightsIconExpression, normalizeStyleMode, normalizeTheme, opaqueSplitBaseOf, paginate, parseDepthLabelSize, parseListCodes, parseSigseqTerms, parseWebhook, patternSpriteId, preprocessLights, preprocessNavAids, preprocessSoundings, preprocessWaterBodies, rasterAtonIconExpression, relativeLuminance, resolveCustomTheme, resolveRasterImage, resolveS101Color, resolveStyle, resolveTargetClass, rhythmProperties, s101ArtworkProvenance, safetyContourValues, sanitizeCustomStyleConfig, scaleLinearLight, scaleSizeValue, scaminToMinZoom, sectorLimitToArcBearing, splitOpaqueDepthAreas, styleModeBand, terrainStackCount, themeChrtGlyph, tileTemplate, uncoveredSectorArcs, withinBboxFilter, worldMinusBboxPolygon };