@chrtco/sdk 0.10.45 → 0.10.46

package/dist/index.d.cts

@@ -2867,6 +2867,46 @@ declare function capLuminance(hex: string, ceiling: number): string;
 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 */
@@ -3753,6 +3793,112 @@ interface BuildSourcesOptions {
  */
 declare function buildSources(opts?: BuildSourcesOptions): Record<string, AnySourceSpec>;
 
+/**
+ * DEPTH NUMBERS — how big the chart draws its depth figures.
+ *
+ * Asked for from the helm (chip 68, 2026-10-05), by a captain running CHRTsail
+ * desktop on a Raspberry Pi: *"I still need the depth numbers to be bolder
+ * which may be a setting. I just can't sail the boat and adjust all that stuff
+ * at the same time."* A set-and-forget choice, then, not a slider.
+ *
+ * ===========================================================================
+ * WHAT "LARGE" CHANGES, AND WHAT IT IS NOT ALLOWED TO TOUCH
+ * ===========================================================================
+ *
+ * It changes the SIZE of the glyphs (and, where a class was Regular, the
+ * WEIGHT, to the Semibold soundings already use), the halo a little — see
+ * `LARGE` for why less than the glyph — and the sounding collision padding —
+ * see `LARGE_SOUNDING_PADDING_PX` for why that one moves.
+ *
+ * It does not touch, and `depth-label-size.test.ts` holds every one of these
+ * equal to the Standard style in every palette and every symbol family:
+ *
+ *   - `text-field` — the number itself, its unit conversion, its rounding.
+ *     ENC content is never altered; a bigger "4" is still the cell's "4".
+ *   - `text-color` / `text-halo-color` — §SOUNDG02's two shades against the
+ *     safety contour, and the palette that draws them (red night included:
+ *     it IS the NIGHT chart). A depth number shoaler than the contour stays
+ *     the loud one.
+ *   - `symbol-sort-key` — shallowest wins a collision, at any size.
+ *   - `filter`, `minzoom`, `maxzoom`, layer ids and layer order — so the
+ *     resident layer set the desktop builds at boot is the same set, and a
+ *     switch is `setLayoutProperty` / `setPaintProperty` on layers already
+ *     there. No layer and no draw call is added; what costs more is GPU fill,
+ *     because a bigger glyph covers more pixels (about 6–7 % more blended
+ *     fragments per pixel on the chart bench — the PR has the numbers).
+ *
+ * ===========================================================================
+ * WHICH LABELS ARE "DEPTH NUMBERS"
+ * ===========================================================================
+ *
+ * Exactly the ones the depth-unit switch converts (`buildLabelLayer` in
+ * `layer-builder.ts`): soundings, contour values, and the depth printed beside
+ * a rock, wreck or obstruction. The unit switch already treats those three as
+ * one claim — its own note says a rock's figure "is the SAME depth claim as a
+ * sounding" — and a size switch that enlarged the soundings around a rock but
+ * left the rock's own depth small would make the hazard the quietest number
+ * on that part of the chart.
+ *
+ * Not the dredged-channel note (`DRGNOTE`): it is a sentence fitted inside
+ * its own channel polygon at a computed size, and scaling it would stop it
+ * fitting. Not the bridge note: a clearance is a height, not a depth.
+ *
+ * ===========================================================================
+ * WHY NOT A BOLD FACE
+ * ===========================================================================
+ *
+ * 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.
+ */
+
+/** The two choices, in presentation order. */
+declare const DEPTH_LABEL_SIZES: readonly ["standard", "large"];
+type DepthLabelSize = (typeof DEPTH_LABEL_SIZES)[number];
+/**
+ * Standard is the chart as it has always been drawn, and it is what a style
+ * generated without the option gets: byte-identical, so the served style, the
+ * native-render goldens and every client that never asks are unchanged.
+ */
+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>;
+/**
+ * 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 const LARGE_SOUNDING_PADDING_PX = 3.5;
+/**
+ * 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 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.
@@ -3968,6 +4114,14 @@ interface StyleGeneratorOptions extends BuildSourcesOptions {
      * at small sizes on screen.
      */
     soundingFontWeight?: "regular" | "semibold";
+    /**
+     * How big the depth figures are drawn — soundings, contour values and the
+     * depth beside a rock, wreck or obstruction. "standard" (default) is
+     * byte-identical to omitting it; "large" enlarges those labels only, and
+     * never their text, colours, sort keys, filters or layer set. See
+     * depth-label-size.ts.
+     */
+    depthLabelSize?: DepthLabelSize;
 }
 declare function generateStyle(palette?: ColorTableName, opts?: StyleGeneratorOptions & {
     bandFan?: BandFanMode;
@@ -5350,4 +5504,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, type FeatureCollection, type FeaturesOptions, type FetchStyleOptions, FileSystemAdapter, type FlashPattern, type FlashPhase, type GenerateCustomStyleOptions, type GeneratedCustomStyle, type GeoJsonFeature, type GeoJsonGeometry, type GeomType, INSPECT_CLASS_RANK, INSPECT_RANK_DEVIATIONS, type InspectCandidate, type InspectCandidateSet, type InspectEnrichment, type InspectEventContext, type InspectNotice, type InspectOptions, type InspectResult, type InspectTargetClass, type InspectableFeature, InteractClient, type InteractEntitlement, InteractError, type InteractErrorCode, type InteractHandle, type InteractMapLike, type InteractMapMouseEvent, LABELED_LAYERS, LABEL_BEHAVIOR, LABEL_LAYER_GROUPS, LABEL_PRIORITY, LAMP_CORE_LAYER_ID, LAMP_GLOW_LAYER_ID, LAMP_LAYER_IDS, LAMP_TICK_MS, LAND_ATTRIBUTION, LAND_BUILD_MAXZOOM, LAND_REGION, LARGE_SOUNDING_PADDING_PX, type LabelBehavior, type LabelConfigOptions, type LabelLayerConfig, type LabelSettings, type LampLayer, type LookupEntry, type MapLibreStyle, type MapboxStyle, type MapboxVectorSource, type MarineAlert, type MarineAlertsOptions, type MarineAlertsResponse, type MarineConditionsObservation, type MarineConditionsOptions, type MarineConditionsResponse, type MarineConditionsSeries, type MarineForecastOptions, type MarineForecastPeriod, type MarineForecastResponse, type MarineSeas, type MarineStation, type MarineSwellTrain, type MarineWind, type MarineZoneRef, NAUTICAL_SYMBOLS, NAV_AID_LAYER_GROUPS, NAV_AID_QUERY_LAYERS, NIGHT_INK, NIGHT_MUTED_INK, NON_SOLAS_DISCLAIMER, NON_SOLAS_DISCLAIMER_SHORT, type NauticalCategory, type NauticalSymbol, type NavAidInspectResult, type NavAidSettings, type NearbyMarineStation, OPAQUE_SPLIT_OF, type OfflineBundleResponse, type OfflineDownloadOptions, type OfflineDownloadProgress, type OfflineDownloadResult, OfflineError, type OfflineErrorCode, type OfflineFetchStyleOptions, type OfflineHeartbeatOptions, type OfflineRegionSummary, type OfflineRemoveOptions, OfflineStyleError, type OfflineStylePlatform, type OfflineStyleResponse, PLACENAME_LAND_CLASSES, PLACENAME_SOURCE_LAYER, PLACENAME_WATER_CLASSES, type ParsedSigseqTerms, type PmtilesVectorSource, type Poi, type PoiCoverage, type PoiDataset, type PoiOptions, type PoiResponse, type QueryFeatureProperties, type QueryOptions, type QueryResponse, RASTER_ATON_CLASSES, RASTER_GLYPH_NAMES, RASTER_ICON_PREFIX, RELIEF_ATTRIBUTION, RELIEF_ENCODING, RELIEF_REGION, RELIEF_TILE_SIZE, type ResolvedStyle, type ResolvedTheme, type S101ArtworkProvenance, type S101Feature, S101_AREA_FILL_NAMES, S101_CHART_SECTIONS, S101_FEATURES, S101_ICON_PREFIX, S101_LINE_STYLE_NAMES, S101_NEW_SYMBOLS, S101_NO_OFFICIAL_COUNTERPART, S101_SOURCE_COMMIT, S101_SYMBOL_GROUPS, S101_SYMBOL_NAMES, S52_ATON_LOOKUPS, S52_ATON_LOOKUPS_PAPER, S52_DRAW_ORDER, S52_LOOKUP, S52_PATTERN_SPRITE_PREFIX, SIGPER_TOLERANCE_SECONDS, SIGSEQ_MAX_TERMS, SOUNDING_LAYERS, SYMBOL_GROUPS, SYMBOL_MAP, type ScaleBand, type SearchCoverageNotice, type SearchHit, type SearchOptions, type SearchResponse, type SectorArcFeature, type SectorArcFeatureCollection, type SectorInfo, type SigseqRefusal, type SigseqTerm, type SoundingSettings, type SourceMode, type StyleGeneratorOptions, type StyleLayer, type StyleUrlOptions, type SymbolGroup, TileAuth, type TileGroup, type TileGroupsResponse, TileTokenError, type TileTokenErrorCode, type TileTokenResponse, type TransformRequest, type TransformedRequest, type VectorSourceSpec, type VesselProfile, WATER_BODY_LAYER_GROUPS, type WaterBodySettings, WeatherEndpoint, type WeatherReading, type WebhookEvent, type WebhookEventType, type WebhookPayload, applyBaseBundle, applyChrtSymbolSet, applyColorTheme, applyCustomStyleSettings, applyDepthLabelSize, applyRasterSymbolSet, applyS101SymbolSet, atonIconExpression, bandFilterExpression, buildAirportTierExpression, buildBuiltUpAreaTierExpression, buildFlashPattern, buildLabelLayer, buildLakeTierExpression, buildLampLayers, buildLandAreaTierExpression, buildLandRegionTierExpression, buildLayersForClass, buildOfflineStyle, buildPlaceNameLayers, buildRiverTierExpression, buildSeaAreaTierExpression, buildSectorArcGeoJSON, buildSectorArcsFC, buildSectorsFromFeatures, buildSources, candidateRank, capLuminance, cellBandCharacters, cellBandMatch, chrtAtonTintExpression, chrtHouseColor, chrtLightTintExpression, collectCandidates, collectClickCandidates, combineWithBandFilter, contrastRatio, daymarkColor, decimateFeatures, decodeAreaFeatureProps, decodeBridgeProps, decodeCandidate, decodeNavAidProps, depareColor, depareFillExpression, depthAreaClassLayerId, depthAreaSplitIds, deriveMarinerName, drapeHalves, drapedFirst, extractNavAidDesignation, featureIdentity, generateCustomStyle, generateSpriteManifest, generateSpriteSheet, generateStyle, generateStyleJSON, getAvailableLineSymbols, getAvailablePatterns, getAvailablePointSymbols, getCollisionSettings, getDrawPriority, getGridSizeForZoom, getIconExpression, getLabelBehavior, getLabelConfig, getLabelPriority, getLookupEntry, getMaxCellsForZoom, getOrderedClasses, getRasterSvg, getS52SvgString, getS52SymbolStats, getStyleStats, getSymbolSvgString, getThemedS101Svg, getThemedS52Svg, getTopmarkMeaning, hazardColor, hazardFillExpression, isDepthAreaClassLayerId, isDrapeable, isLabelLayerVisible, isMapLive, isNavAidLayer, isNavAidLayerVisible, isSoundingLayerVisible, isVisibleInMode, isWaterBodyLayerVisible, labelSortKey, lampRhythmColour, lampRhythmOpacity, lateralColor, lateralFillExpression, lightColor, lightFillExpression, lightsIconExpression, normalizeStyleMode, normalizeTheme, opaqueSplitBaseOf, paginate, parseDepthLabelSize, parseListCodes, parseSigseqTerms, parseWebhook, patternSpriteId, preprocessLights, preprocessNavAids, preprocessSoundings, preprocessWaterBodies, rasterAtonIconExpression, relativeLuminance, resolveCustomTheme, resolveRasterImage, resolveS101Color, resolveStyle, resolveTargetClass, rhythmProperties, s101ArtworkProvenance, sanitizeCustomStyleConfig, scaleLinearLight, scaleSizeValue, scaminToMinZoom, sectorLimitToArcBearing, splitOpaqueDepthAreas, styleModeBand, terrainStackCount, themeChrtGlyph, tileTemplate, uncoveredSectorArcs, withinBboxFilter, worldMinusBboxPolygon };

package/dist/index.d.ts

@@ -2867,6 +2867,46 @@ declare function capLuminance(hex: string, ceiling: number): string;
 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 */
@@ -3753,6 +3793,112 @@ interface BuildSourcesOptions {
  */
 declare function buildSources(opts?: BuildSourcesOptions): Record<string, AnySourceSpec>;
 
+/**
+ * DEPTH NUMBERS — how big the chart draws its depth figures.
+ *
+ * Asked for from the helm (chip 68, 2026-10-05), by a captain running CHRTsail
+ * desktop on a Raspberry Pi: *"I still need the depth numbers to be bolder
+ * which may be a setting. I just can't sail the boat and adjust all that stuff
+ * at the same time."* A set-and-forget choice, then, not a slider.
+ *
+ * ===========================================================================
+ * WHAT "LARGE" CHANGES, AND WHAT IT IS NOT ALLOWED TO TOUCH
+ * ===========================================================================
+ *
+ * It changes the SIZE of the glyphs (and, where a class was Regular, the
+ * WEIGHT, to the Semibold soundings already use), the halo a little — see
+ * `LARGE` for why less than the glyph — and the sounding collision padding —
+ * see `LARGE_SOUNDING_PADDING_PX` for why that one moves.
+ *
+ * It does not touch, and `depth-label-size.test.ts` holds every one of these
+ * equal to the Standard style in every palette and every symbol family:
+ *
+ *   - `text-field` — the number itself, its unit conversion, its rounding.
+ *     ENC content is never altered; a bigger "4" is still the cell's "4".
+ *   - `text-color` / `text-halo-color` — §SOUNDG02's two shades against the
+ *     safety contour, and the palette that draws them (red night included:
+ *     it IS the NIGHT chart). A depth number shoaler than the contour stays
+ *     the loud one.
+ *   - `symbol-sort-key` — shallowest wins a collision, at any size.
+ *   - `filter`, `minzoom`, `maxzoom`, layer ids and layer order — so the
+ *     resident layer set the desktop builds at boot is the same set, and a
+ *     switch is `setLayoutProperty` / `setPaintProperty` on layers already
+ *     there. No layer and no draw call is added; what costs more is GPU fill,
+ *     because a bigger glyph covers more pixels (about 6–7 % more blended
+ *     fragments per pixel on the chart bench — the PR has the numbers).
+ *
+ * ===========================================================================
+ * WHICH LABELS ARE "DEPTH NUMBERS"
+ * ===========================================================================
+ *
+ * Exactly the ones the depth-unit switch converts (`buildLabelLayer` in
+ * `layer-builder.ts`): soundings, contour values, and the depth printed beside
+ * a rock, wreck or obstruction. The unit switch already treats those three as
+ * one claim — its own note says a rock's figure "is the SAME depth claim as a
+ * sounding" — and a size switch that enlarged the soundings around a rock but
+ * left the rock's own depth small would make the hazard the quietest number
+ * on that part of the chart.
+ *
+ * Not the dredged-channel note (`DRGNOTE`): it is a sentence fitted inside
+ * its own channel polygon at a computed size, and scaling it would stop it
+ * fitting. Not the bridge note: a clearance is a height, not a depth.
+ *
+ * ===========================================================================
+ * WHY NOT A BOLD FACE
+ * ===========================================================================
+ *
+ * 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.
+ */
+
+/** The two choices, in presentation order. */
+declare const DEPTH_LABEL_SIZES: readonly ["standard", "large"];
+type DepthLabelSize = (typeof DEPTH_LABEL_SIZES)[number];
+/**
+ * Standard is the chart as it has always been drawn, and it is what a style
+ * generated without the option gets: byte-identical, so the served style, the
+ * native-render goldens and every client that never asks are unchanged.
+ */
+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>;
+/**
+ * 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 const LARGE_SOUNDING_PADDING_PX = 3.5;
+/**
+ * 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 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.
@@ -3968,6 +4114,14 @@ interface StyleGeneratorOptions extends BuildSourcesOptions {
      * at small sizes on screen.
      */
     soundingFontWeight?: "regular" | "semibold";
+    /**
+     * How big the depth figures are drawn — soundings, contour values and the
+     * depth beside a rock, wreck or obstruction. "standard" (default) is
+     * byte-identical to omitting it; "large" enlarges those labels only, and
+     * never their text, colours, sort keys, filters or layer set. See
+     * depth-label-size.ts.
+     */
+    depthLabelSize?: DepthLabelSize;
 }
 declare function generateStyle(palette?: ColorTableName, opts?: StyleGeneratorOptions & {
     bandFan?: BandFanMode;
@@ -5350,4 +5504,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, type FeatureCollection, type FeaturesOptions, type FetchStyleOptions, FileSystemAdapter, type FlashPattern, type FlashPhase, type GenerateCustomStyleOptions, type GeneratedCustomStyle, type GeoJsonFeature, type GeoJsonGeometry, type GeomType, INSPECT_CLASS_RANK, INSPECT_RANK_DEVIATIONS, type InspectCandidate, type InspectCandidateSet, type InspectEnrichment, type InspectEventContext, type InspectNotice, type InspectOptions, type InspectResult, type InspectTargetClass, type InspectableFeature, InteractClient, type InteractEntitlement, InteractError, type InteractErrorCode, type InteractHandle, type InteractMapLike, type InteractMapMouseEvent, LABELED_LAYERS, LABEL_BEHAVIOR, LABEL_LAYER_GROUPS, LABEL_PRIORITY, LAMP_CORE_LAYER_ID, LAMP_GLOW_LAYER_ID, LAMP_LAYER_IDS, LAMP_TICK_MS, LAND_ATTRIBUTION, LAND_BUILD_MAXZOOM, LAND_REGION, LARGE_SOUNDING_PADDING_PX, type LabelBehavior, type LabelConfigOptions, type LabelLayerConfig, type LabelSettings, type LampLayer, type LookupEntry, type MapLibreStyle, type MapboxStyle, type MapboxVectorSource, type MarineAlert, type MarineAlertsOptions, type MarineAlertsResponse, type MarineConditionsObservation, type MarineConditionsOptions, type MarineConditionsResponse, type MarineConditionsSeries, type MarineForecastOptions, type MarineForecastPeriod, type MarineForecastResponse, type MarineSeas, type MarineStation, type MarineSwellTrain, type MarineWind, type MarineZoneRef, NAUTICAL_SYMBOLS, NAV_AID_LAYER_GROUPS, NAV_AID_QUERY_LAYERS, NIGHT_INK, NIGHT_MUTED_INK, NON_SOLAS_DISCLAIMER, NON_SOLAS_DISCLAIMER_SHORT, type NauticalCategory, type NauticalSymbol, type NavAidInspectResult, type NavAidSettings, type NearbyMarineStation, OPAQUE_SPLIT_OF, type OfflineBundleResponse, type OfflineDownloadOptions, type OfflineDownloadProgress, type OfflineDownloadResult, OfflineError, type OfflineErrorCode, type OfflineFetchStyleOptions, type OfflineHeartbeatOptions, type OfflineRegionSummary, type OfflineRemoveOptions, OfflineStyleError, type OfflineStylePlatform, type OfflineStyleResponse, PLACENAME_LAND_CLASSES, PLACENAME_SOURCE_LAYER, PLACENAME_WATER_CLASSES, type ParsedSigseqTerms, type PmtilesVectorSource, type Poi, type PoiCoverage, type PoiDataset, type PoiOptions, type PoiResponse, type QueryFeatureProperties, type QueryOptions, type QueryResponse, RASTER_ATON_CLASSES, RASTER_GLYPH_NAMES, RASTER_ICON_PREFIX, RELIEF_ATTRIBUTION, RELIEF_ENCODING, RELIEF_REGION, RELIEF_TILE_SIZE, type ResolvedStyle, type ResolvedTheme, type S101ArtworkProvenance, type S101Feature, S101_AREA_FILL_NAMES, S101_CHART_SECTIONS, S101_FEATURES, S101_ICON_PREFIX, S101_LINE_STYLE_NAMES, S101_NEW_SYMBOLS, S101_NO_OFFICIAL_COUNTERPART, S101_SOURCE_COMMIT, S101_SYMBOL_GROUPS, S101_SYMBOL_NAMES, S52_ATON_LOOKUPS, S52_ATON_LOOKUPS_PAPER, S52_DRAW_ORDER, S52_LOOKUP, S52_PATTERN_SPRITE_PREFIX, SIGPER_TOLERANCE_SECONDS, SIGSEQ_MAX_TERMS, SOUNDING_LAYERS, SYMBOL_GROUPS, SYMBOL_MAP, type ScaleBand, type SearchCoverageNotice, type SearchHit, type SearchOptions, type SearchResponse, type SectorArcFeature, type SectorArcFeatureCollection, type SectorInfo, type SigseqRefusal, type SigseqTerm, type SoundingSettings, type SourceMode, type StyleGeneratorOptions, type StyleLayer, type StyleUrlOptions, type SymbolGroup, TileAuth, type TileGroup, type TileGroupsResponse, TileTokenError, type TileTokenErrorCode, type TileTokenResponse, type TransformRequest, type TransformedRequest, type VectorSourceSpec, type VesselProfile, WATER_BODY_LAYER_GROUPS, type WaterBodySettings, WeatherEndpoint, type WeatherReading, type WebhookEvent, type WebhookEventType, type WebhookPayload, applyBaseBundle, applyChrtSymbolSet, applyColorTheme, applyCustomStyleSettings, applyDepthLabelSize, applyRasterSymbolSet, applyS101SymbolSet, atonIconExpression, bandFilterExpression, buildAirportTierExpression, buildBuiltUpAreaTierExpression, buildFlashPattern, buildLabelLayer, buildLakeTierExpression, buildLampLayers, buildLandAreaTierExpression, buildLandRegionTierExpression, buildLayersForClass, buildOfflineStyle, buildPlaceNameLayers, buildRiverTierExpression, buildSeaAreaTierExpression, buildSectorArcGeoJSON, buildSectorArcsFC, buildSectorsFromFeatures, buildSources, candidateRank, capLuminance, cellBandCharacters, cellBandMatch, chrtAtonTintExpression, chrtHouseColor, chrtLightTintExpression, collectCandidates, collectClickCandidates, combineWithBandFilter, contrastRatio, daymarkColor, decimateFeatures, decodeAreaFeatureProps, decodeBridgeProps, decodeCandidate, decodeNavAidProps, depareColor, depareFillExpression, depthAreaClassLayerId, depthAreaSplitIds, deriveMarinerName, drapeHalves, drapedFirst, extractNavAidDesignation, featureIdentity, generateCustomStyle, generateSpriteManifest, generateSpriteSheet, generateStyle, generateStyleJSON, getAvailableLineSymbols, getAvailablePatterns, getAvailablePointSymbols, getCollisionSettings, getDrawPriority, getGridSizeForZoom, getIconExpression, getLabelBehavior, getLabelConfig, getLabelPriority, getLookupEntry, getMaxCellsForZoom, getOrderedClasses, getRasterSvg, getS52SvgString, getS52SymbolStats, getStyleStats, getSymbolSvgString, getThemedS101Svg, getThemedS52Svg, getTopmarkMeaning, hazardColor, hazardFillExpression, isDepthAreaClassLayerId, isDrapeable, isLabelLayerVisible, isMapLive, isNavAidLayer, isNavAidLayerVisible, isSoundingLayerVisible, isVisibleInMode, isWaterBodyLayerVisible, labelSortKey, lampRhythmColour, lampRhythmOpacity, lateralColor, lateralFillExpression, lightColor, lightFillExpression, lightsIconExpression, normalizeStyleMode, normalizeTheme, opaqueSplitBaseOf, paginate, parseDepthLabelSize, parseListCodes, parseSigseqTerms, parseWebhook, patternSpriteId, preprocessLights, preprocessNavAids, preprocessSoundings, preprocessWaterBodies, rasterAtonIconExpression, relativeLuminance, resolveCustomTheme, resolveRasterImage, resolveS101Color, resolveStyle, resolveTargetClass, rhythmProperties, s101ArtworkProvenance, sanitizeCustomStyleConfig, scaleLinearLight, scaleSizeValue, scaminToMinZoom, sectorLimitToArcBearing, splitOpaqueDepthAreas, styleModeBand, terrainStackCount, themeChrtGlyph, tileTemplate, uncoveredSectorArcs, withinBboxFilter, worldMinusBboxPolygon };

package/dist/index.js

@@ -5027,6 +5027,11 @@ function capLuminance(hex, ceiling) {
 var NIGHT_INK = S52_NIGHT.CHBLK;
 var NIGHT_MUTED_INK = scaleLinearLight(S52_NIGHT.CHBLK, 0.43);
 
+// src/atlas/map-live.ts
+function isMapLive(map) {
+  return map._removed !== true;
+}
+
 // src/atlas/s52-linestyles-generated.ts
 var S52_LINESTYLES = {
   ACHARE51: {
@@ -27703,6 +27708,67 @@ function iconExpressionForFamily(objectClass, family) {
   }
 }
 
+// src/atlas/depth-label-size.ts
+var DEPTH_LABEL_SIZES = ["standard", "large"];
+var DEFAULT_DEPTH_LABEL_SIZE = "standard";
+function parseDepthLabelSize(raw) {
+  if (!raw) return null;
+  const lower = raw.toLowerCase();
+  return DEPTH_LABEL_SIZES.find((s) => s === lower) ?? null;
+}
+var DEPTH_LABEL_CLASSES = /* @__PURE__ */ new Set([
+  "SOUNDG",
+  "DEPCNT",
+  "UWTROC",
+  "OBSTRN",
+  "WRECKS"
+]);
+var SEMIBOLD = ["Open Sans Semibold"];
+var HAZARD_DEPTH = {
+  textSize: ["interpolate", ["linear"], ["zoom"], 12, 12, 16, 15],
+  haloWidth: 1.4,
+  font: SEMIBOLD
+};
+var LARGE = {
+  // Standard: 7 / 8 / 10 / 12 at z8 / 11 / 14 / 16, halo 1.0, Semibold.
+  SOUNDG: {
+    textSize: ["interpolate", ["linear"], ["zoom"], 8, 10, 11, 11, 14, 14, 16, 17],
+    haloWidth: 1.2,
+    font: SEMIBOLD
+  },
+  // Standard: 8 / 10 at z10 / 14, halo 1.2, Regular.
+  //
+  // ⚠ ~1.2x, NOT 1.4x, AND SEMIBOLD CARRIES THE REST. A contour value rides
+  // its line (`symbol-placement: line`) and needs a straight-enough run to fit;
+  // it also shares rank 300 with the soundings, which place first. At 1.4x the
+  // Boston harbour view kept 15 of Standard's 20 contour labels; at 1.2x, 18.
+  DEPCNT: {
+    textSize: ["interpolate", ["linear"], ["zoom"], 10, 10, 14, 12],
+    haloWidth: 1.2,
+    font: SEMIBOLD
+  },
+  UWTROC: HAZARD_DEPTH,
+  OBSTRN: HAZARD_DEPTH,
+  WRECKS: HAZARD_DEPTH
+};
+var LARGE_SOUNDING_PADDING_PX = 3.5;
+function applyDepthLabelSize(objectClass, layer, size) {
+  if (size !== "large") return layer;
+  const large = LARGE[objectClass];
+  if (large === void 0) return layer;
+  const layout = {
+    ...layer.layout ?? {},
+    "text-size": large.textSize,
+    "text-font": [...large.font]
+  };
+  if (objectClass === "SOUNDG") layout["text-padding"] = LARGE_SOUNDING_PADDING_PX;
+  return {
+    ...layer,
+    layout,
+    paint: { ...layer.paint, "text-halo-width": large.haloWidth }
+  };
+}
+
 // src/atlas/base-bundle.ts
 var BASE_BUNDLE_ID = BASE_REGION;
 var BASE_BUNDLE_SCHEMA = "chrt.basemap-bundle/1";
@@ -29043,7 +29109,7 @@ function buildLabelLayer2(objectClass, ct, sourceId = DEFAULT_REGION, depthUnits
   if (getLabelBehavior(objectClass) === "orientation-cross-band") {
     layer.filter = LABEL_ANCHOR_FILTER;
   }
-  return layer;
+  return applyDepthLabelSize(objectClass, layer, labelOpts.depthLabelSize);
 }
 function getGeomTypesForClass(objectClass, defaultType) {
   if (SYMBOL_MAP[objectClass] && defaultType === "symbol") {
@@ -29392,6 +29458,12 @@ var BASE_THEMES = {
     // CHRTland's own tan — one land colour
     inlandWater: "#B9CFDD",
     // muted, unmistakably not a charted blue
+    // The uncharted hatch's stripe, held to 2.3:1 against `inlandWater` in
+    // every palette (`inland-hatch-contrast.test.ts`) — the hatch says "we have
+    // not charted this water", and stripes the eye cannot find say nothing.
+    // DAY 3.08:1, darker than its ground. Also the colour the artwork file
+    // itself is drawn in.
+    inlandHatch: "#5B7383",
     // State furniture. These three were referenced by the layers but missing
     // from this table (and its type — the long-standing TS2339 trio), so the
     // lines shipped on MapLibre's DEFAULT black. Now deliberate: a hairline
@@ -29422,6 +29494,9 @@ var BASE_THEMES = {
     boundary: "#293135",
     jurisdiction: "#867D64",
     inlandWater: "#62717A",
+    // Owner's choice, 2026-10-04: dark stripes, 2.37:1. The DAY stripe here
+    // was 1.02:1 — invisible, so an uncharted lake read as plain water.
+    inlandHatch: "#2E383F",
     // Label stays DARK here — the halo is still mid-toned, so 3:1 is reachable
     // downward and a bright label would be a new light source at dusk.
     stateLine: "#B5A987",
@@ -29455,6 +29530,10 @@ var BASE_THEMES = {
     boundary: "#131719",
     jurisdiction: "#353128",
     inlandWater: "#232A30",
+    // The DAY stripe, lighter than this ground: 2.92:1, and L 0.16, under the
+    // NIGHT muted-ink ceiling (`night-luminance.test.ts`). Red night draws the
+    // NIGHT chart, so this is its stripe too.
+    inlandHatch: "#5B7383",
     stateLine: "#484236",
     stateLabel: "#837963",
     stateHalo: "#353128",
@@ -30581,7 +30660,8 @@ function generateStyle(palette = "DAY", opts = {}) {
       label: buildLabelLayer2(objectClass, palette, sourceId, opts.depthUnits ?? "meters", {
         safetyContour: opts.safetyContour,
         twoShadeSoundings: opts.twoShadeSoundings,
-        soundingFontWeight: opts.soundingFontWeight
+        soundingFontWeight: opts.soundingFontWeight,
+        depthLabelSize: opts.depthLabelSize
       })
     });
   }
@@ -31927,6 +32007,7 @@ export {
   ChrtError,
   DEFAULT_CLICK_TOLERANCE,
   DEFAULT_CUSTOM_STYLE_CONFIG,
+  DEFAULT_DEPTH_LABEL_SIZE,
   DEFAULT_INSPECT_CLASS_RANK,
   DEFAULT_LABEL_SETTINGS,
   DEFAULT_NAV_AID_SETTINGS,
@@ -31938,6 +32019,8 @@ export {
   DEFAULT_WATER_BODY_SETTINGS,
   DEPARE_FILL_BRANCH_TOKENS,
   DEPARE_FILL_FALLBACK_TOKEN,
+  DEPTH_LABEL_CLASSES,
+  DEPTH_LABEL_SIZES,
   DRAPEABLE_LAYER_TYPES,
   INSPECT_CLASS_RANK,
   INSPECT_RANK_DEVIATIONS,
@@ -31954,6 +32037,7 @@ export {
   LAND_ATTRIBUTION,
   LAND_BUILD_MAXZOOM,
   LAND_REGION,
+  LARGE_SOUNDING_PADDING_PX,
   NAUTICAL_SYMBOLS,
   NAV_AID_LAYER_GROUPS,
   NAV_AID_QUERY_LAYERS,
@@ -32008,6 +32092,7 @@ export {
   applyChrtSymbolSet,
   applyColorTheme,
   applyCustomStyleSettings,
+  applyDepthLabelSize,
   applyRasterSymbolSet,
   applyS101SymbolSet,
   atonIconExpression,
@@ -32088,6 +32173,7 @@ export {
   isDepthAreaClassLayerId,
   isDrapeable,
   isLabelLayerVisible,
+  isMapLive,
   isNavAidLayer,
   isNavAidLayerVisible,
   isSoundingLayerVisible,
@@ -32105,6 +32191,7 @@ export {
   normalizeTheme,
   opaqueSplitBaseOf,
   paginate,
+  parseDepthLabelSize,
   parseListCodes,
   parseSigseqTerms,
   parseSymbolFamily,