@chrtco/sdk 0.10.6 → 0.10.7

package/dist/index.d.cts

@@ -2708,7 +2708,12 @@ declare function buildLabelLayer(layerId: string, sourceId: string, config: Labe
 declare function preprocessSoundings(fc: GeoJSON.FeatureCollection): GeoJSON.FeatureCollection;
 /**
  * Pre-process LIGHTS GeoJSON to derive compact light characteristic labels.
- * Adds `_lightLabel` property (e.g., "Fl R 4s").
+ * 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 function preprocessLights(fc: GeoJSON.FeatureCollection): GeoJSON.FeatureCollection;
 /** List of layers that have labels */
@@ -3248,7 +3253,32 @@ declare const S101_SOURCE_COMMIT = "05063500e898544c90078ab78a61efc72b7e62f3";
 declare const S101_ICON_PREFIX = "s101:";
 /** All vendored S-101 symbol names (unprefixed). */
 declare const S101_SYMBOL_NAMES: ReadonlySet<string>;
-/** Resolve an S-101 colour token via the official profile for `table`. */
+/**
+ * Symbols the generated style references that have **no official S-101
+ * counterpart** in the Portrayal Catalogue, and therefore keep their S-52
+ * artwork under `?symbols=s101`.
+ *
+ * These are deliberate, not gaps in the vendoring: the catalogue at the
+ * pinned commit defines no symbol of the same name, and inventing an
+ * equivalence (e.g. SISTAT02 → SISTAT03, WATTUR01 → WATTUR02) would be a
+ * portrayal judgement, not a direct replica of the standard. The S-101
+ * rule engine (the later 7c phase) is what will resolve these properly —
+ * it selects symbols by rule rather than by S-52 name identity.
+ *
+ *   DNGCIR01 / LNDMRK18 / LNDMRK19 / RADRFL03 — the catalogue defines no
+ *     DNGCIR, LNDMRK or RADRFL symbols at all. (RETRFL01/02 *are* defined,
+ *     so the retroreflector class needs no exemption.)
+ *   UWTROC01 / SISTAT02 / WATTUR01 — only differently-numbered siblings
+ *     exist (UWTROC03/04, SISTAT03, WATTUR02); the number encodes a
+ *     different portrayal case.
+ *   LIGHTHOUSE01 — a CHRT-local symbol name with no PresLib/S-101 analogue.
+ *
+ * Pinned by `s101-style.test.ts` so the set can only shrink deliberately
+ * (e.g. when re-pinned to an in-force catalogue edition that adds them).
+ */
+declare const S101_NO_OFFICIAL_COUNTERPART: ReadonlySet<string>;
+/** Resolve an S-101 colour token via the official profile for `table`.
+ *  An unknown token warns (see `reportUnresolvedToken`) before falling back. */
 declare function resolveS101Color(token: string, table?: ColorTableName): string;
 /**
  * Get an S-101 symbol SVG with its colour tokens resolved through the
@@ -3256,10 +3286,64 @@ declare function resolveS101Color(token: string, table?: ColorTableName): string
  */
 declare function getThemedS101Svg(symbolName: string, table?: ColorTableName): string | null;
 /**
- * Switch a generated style document to the S-101 symbol set. Symbol names
- * without an official S-101 counterpart keep their S-52 image (both sets
- * are loaded by `loadChartSymbolImages`), so coverage can only grow as the
- * PC adds symbols. Returns the same style object (mutated), for chaining.
+ * Where a symbol's artwork actually comes from under `?symbols=s101`.
+ *
+ *   - `official`      — the vendored IHO S-101 Portrayal Catalogue file.
+ *   - `s52-substitute`— the catalogue defines no symbol of this name, so S-52
+ *                       artwork is drawn instead (the pinned exemption set).
+ *   - `chrt-drawn`    — neither; a CHRT-authored approximation. `S101_NEW_SYMBOLS`
+ *                       in `s101-symbols.ts` is this, and it is NOT official
+ *                       artwork despite living under an S-101 name.
+ *
+ * Exported because any surface that *displays* S-101 symbology has to be able
+ * to say which of the three it is showing. Presenting a substitute or an
+ * approximation as catalogue artwork is the same silent-fallback defect as a
+ * chart quietly dropping a symbol — see the parity audit.
+ */
+type S101ArtworkProvenance = "official" | "s52-substitute" | "chrt-drawn";
+/** Classify a symbol name's artwork provenance. `symbolName` is the S-52
+ *  PresLib name (e.g. `BOYCAN01`), which is how every set here is keyed.
+ *
+ *  The `s52-substitute` test is "does real S-52 artwork exist for this name",
+ *  NOT "is it in the pinned exemption set" — that set only covers names the
+ *  generated style references, and a display surface (the Atlas) shows many
+ *  that it does not. Keying off the exemption set alone would misreport every
+ *  one of those as a CHRT drawing. */
+declare function s101ArtworkProvenance(symbolName: string | undefined): S101ArtworkProvenance;
+/**
+ * Official S-101 **area fill** names available to the rewrite below.
+ *
+ * **Empty, and that is the finding — not an oversight in this file.** The
+ * upstream `PortrayalCatalog/` ships `AreaFills/` and `LineStyles/` alongside
+ * `Symbols/`, but `PROVENANCE.md` records that only `Symbols/` was ever
+ * vendored, and `gen-s101-svgs.ts` reads that one directory. So every area
+ * fill and complex line under `?symbols=s101` is still S-52 artwork:
+ * `AP:CBLARE01`, `AP:MARSHES1`, `AP:PIPARE01`, `AP:VEGATN03`, `AP:VEGATN04`,
+ * `LC:CBLARE51`, `LC:CBLSUB06`, `LC:PIPSOL05`, `LC:PIPSOL06`.
+ *
+ * These sets are declared rather than assumed so the omission is *typed and
+ * measurable* instead of invisible: `applyS101SymbolSet` now walks pattern
+ * references too, the coverage metadata below reports the real ratio, and
+ * `s101-parity.test.ts` pins it at 0. Vendor the two directories, populate
+ * these sets, and every count moves on its own — no other change required.
+ */
+declare const S101_AREA_FILL_NAMES: ReadonlySet<string>;
+/** Official S-101 **line style** names available to the rewrite. Empty for the
+ *  same reason as `S101_AREA_FILL_NAMES` — see that doc comment. */
+declare const S101_LINE_STYLE_NAMES: ReadonlySet<string>;
+/**
+ * Switch a generated style document to the S-101 symbol set.
+ *
+ * Covers all three ways a GL style names an image — `icon-image`,
+ * `fill-pattern` and `line-pattern`. Names without official S-101 artwork keep
+ * their S-52 image (both sets are loaded by `loadChartSymbolImages`), so
+ * coverage can only grow as the catalogue is vendored further.
+ *
+ * Emits `chrt:s101-coverage` so a consumer can tell *how* S-101 the document
+ * it just fetched actually is. Before this existed the answer was
+ * unobtainable without decoding the style yourself, which is how "s101" read
+ * as complete when its areas and lines were entirely S-52.
+ * Returns the same style object (mutated), for chaining.
  */
 declare function applyS101SymbolSet(style: MapboxStyle): MapboxStyle;
 
@@ -4172,4 +4256,4 @@ declare class Chrt {
     warmTiles(region?: string): Promise<void>;
 }
 
-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_DRAW_ORDER, BAND_PRIORITY_RANGES, type BBox, BRIDGE_QUERY_LAYERS, BUILD_MAXZOOM, BUILD_MINZOOM, 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, 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, type LabelBehavior, type LabelConfigOptions, type LabelLayerConfig, type LabelSettings, type LookupEntry, type MapLibreStyle, type MapboxStyle, type MapboxVectorSource, type MarineAlert, type MarineAlertsOptions, type MarineAlertsResponse, type MarineConditionsOptions, type MarineConditionsResponse, 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, NON_SOLAS_DISCLAIMER, NON_SOLAS_DISCLAIMER_SHORT, type NauticalCategory, type NauticalSymbol, type NavAidInspectResult, type NavAidSettings, type NearbyMarineStation, type OfflineBundleResponse, type OfflineDownloadOptions, type OfflineDownloadProgress, type OfflineDownloadResult, OfflineError, type OfflineErrorCode, type OfflineFetchStyleOptions, type OfflineHeartbeatOptions, type OfflineRegionSummary, type OfflineRemoveOptions, OfflineStyleError, type OfflineStylePlatform, type OfflineStyleResponse, type PmtilesVectorSource, type QueryFeatureProperties, type QueryOptions, type QueryResponse, RASTER_ATON_CLASSES, RASTER_GLYPH_NAMES, RASTER_ICON_PREFIX, type ResolvedStyle, type ResolvedTheme, type S101Feature, S101_CHART_SECTIONS, S101_FEATURES, S101_ICON_PREFIX, S101_NEW_SYMBOLS, 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, SOUNDING_LAYERS, SYMBOL_FAMILIES, SYMBOL_FAMILY_META, SYMBOL_GROUPS, SYMBOL_MAP, type ScaleBand, type SearchCoverageNotice, type SearchHit, type SearchOptions, type SearchResponse, type SectorArcFeature, type SectorArcFeatureCollection, type SectorInfo, type SoundingSettings, type SourceMode, type StyleGeneratorOptions, type StyleLayer, type StyleUrlOptions, type SymbolFamily, type SymbolFamilyMeta, 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, applyChrtSymbolSet, applyColorTheme, applyCustomStyleSettings, applyRasterSymbolSet, applyS101SymbolSet, atonIconExpression, bandFilterExpression, buildFlashPattern, buildLabelLayer, buildLayersForClass, buildOfflineStyle, buildSectorArcGeoJSON, buildSectorArcsFC, buildSectorsFromFeatures, buildSources, candidateRank, chrtAtonTintExpression, chrtLightTintExpression, collectCandidates, collectClickCandidates, combineWithBandFilter, daymarkColor, decimateFeatures, decodeAreaFeatureProps, decodeBridgeProps, decodeCandidate, decodeNavAidProps, depareColor, depareFillExpression, deriveMarinerName, 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, iconExpressionForFamily, isLabelLayerVisible, isNavAidLayer, isNavAidLayerVisible, isSoundingLayerVisible, isVisibleInMode, isWaterBodyLayerVisible, labelSortKey, lateralColor, lateralFillExpression, lightColor, lightFillExpression, lightsIconExpression, normalizeStyleMode, normalizeTheme, paginate, parseListCodes, parseSymbolFamily, parseWebhook, patternSpriteId, preprocessLights, preprocessNavAids, preprocessSoundings, preprocessWaterBodies, rasterAtonIconExpression, resolveCustomTheme, resolveRasterImage, resolveS101Color, resolveStyle, resolveTargetClass, sanitizeCustomStyleConfig, scaleSizeValue, scaminToMinZoom, styleModeBand, 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_DRAW_ORDER, BAND_PRIORITY_RANGES, type BBox, BRIDGE_QUERY_LAYERS, BUILD_MAXZOOM, BUILD_MINZOOM, 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, 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, type LabelBehavior, type LabelConfigOptions, type LabelLayerConfig, type LabelSettings, type LookupEntry, type MapLibreStyle, type MapboxStyle, type MapboxVectorSource, type MarineAlert, type MarineAlertsOptions, type MarineAlertsResponse, type MarineConditionsOptions, type MarineConditionsResponse, 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, NON_SOLAS_DISCLAIMER, NON_SOLAS_DISCLAIMER_SHORT, type NauticalCategory, type NauticalSymbol, type NavAidInspectResult, type NavAidSettings, type NearbyMarineStation, type OfflineBundleResponse, type OfflineDownloadOptions, type OfflineDownloadProgress, type OfflineDownloadResult, OfflineError, type OfflineErrorCode, type OfflineFetchStyleOptions, type OfflineHeartbeatOptions, type OfflineRegionSummary, type OfflineRemoveOptions, OfflineStyleError, type OfflineStylePlatform, type OfflineStyleResponse, type PmtilesVectorSource, type QueryFeatureProperties, type QueryOptions, type QueryResponse, RASTER_ATON_CLASSES, RASTER_GLYPH_NAMES, RASTER_ICON_PREFIX, 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, SOUNDING_LAYERS, SYMBOL_FAMILIES, SYMBOL_FAMILY_META, SYMBOL_GROUPS, SYMBOL_MAP, type ScaleBand, type SearchCoverageNotice, type SearchHit, type SearchOptions, type SearchResponse, type SectorArcFeature, type SectorArcFeatureCollection, type SectorInfo, type SoundingSettings, type SourceMode, type StyleGeneratorOptions, type StyleLayer, type StyleUrlOptions, type SymbolFamily, type SymbolFamilyMeta, 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, applyChrtSymbolSet, applyColorTheme, applyCustomStyleSettings, applyRasterSymbolSet, applyS101SymbolSet, atonIconExpression, bandFilterExpression, buildFlashPattern, buildLabelLayer, buildLayersForClass, buildOfflineStyle, buildSectorArcGeoJSON, buildSectorArcsFC, buildSectorsFromFeatures, buildSources, candidateRank, chrtAtonTintExpression, chrtLightTintExpression, collectCandidates, collectClickCandidates, combineWithBandFilter, daymarkColor, decimateFeatures, decodeAreaFeatureProps, decodeBridgeProps, decodeCandidate, decodeNavAidProps, depareColor, depareFillExpression, deriveMarinerName, 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, iconExpressionForFamily, isLabelLayerVisible, isNavAidLayer, isNavAidLayerVisible, isSoundingLayerVisible, isVisibleInMode, isWaterBodyLayerVisible, labelSortKey, lateralColor, lateralFillExpression, lightColor, lightFillExpression, lightsIconExpression, normalizeStyleMode, normalizeTheme, paginate, parseListCodes, parseSymbolFamily, parseWebhook, patternSpriteId, preprocessLights, preprocessNavAids, preprocessSoundings, preprocessWaterBodies, rasterAtonIconExpression, resolveCustomTheme, resolveRasterImage, resolveS101Color, resolveStyle, resolveTargetClass, s101ArtworkProvenance, sanitizeCustomStyleConfig, scaleSizeValue, scaminToMinZoom, styleModeBand, withinBboxFilter, worldMinusBboxPolygon };

package/dist/index.d.ts

@@ -2708,7 +2708,12 @@ declare function buildLabelLayer(layerId: string, sourceId: string, config: Labe
 declare function preprocessSoundings(fc: GeoJSON.FeatureCollection): GeoJSON.FeatureCollection;
 /**
  * Pre-process LIGHTS GeoJSON to derive compact light characteristic labels.
- * Adds `_lightLabel` property (e.g., "Fl R 4s").
+ * 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 function preprocessLights(fc: GeoJSON.FeatureCollection): GeoJSON.FeatureCollection;
 /** List of layers that have labels */
@@ -3248,7 +3253,32 @@ declare const S101_SOURCE_COMMIT = "05063500e898544c90078ab78a61efc72b7e62f3";
 declare const S101_ICON_PREFIX = "s101:";
 /** All vendored S-101 symbol names (unprefixed). */
 declare const S101_SYMBOL_NAMES: ReadonlySet<string>;
-/** Resolve an S-101 colour token via the official profile for `table`. */
+/**
+ * Symbols the generated style references that have **no official S-101
+ * counterpart** in the Portrayal Catalogue, and therefore keep their S-52
+ * artwork under `?symbols=s101`.
+ *
+ * These are deliberate, not gaps in the vendoring: the catalogue at the
+ * pinned commit defines no symbol of the same name, and inventing an
+ * equivalence (e.g. SISTAT02 → SISTAT03, WATTUR01 → WATTUR02) would be a
+ * portrayal judgement, not a direct replica of the standard. The S-101
+ * rule engine (the later 7c phase) is what will resolve these properly —
+ * it selects symbols by rule rather than by S-52 name identity.
+ *
+ *   DNGCIR01 / LNDMRK18 / LNDMRK19 / RADRFL03 — the catalogue defines no
+ *     DNGCIR, LNDMRK or RADRFL symbols at all. (RETRFL01/02 *are* defined,
+ *     so the retroreflector class needs no exemption.)
+ *   UWTROC01 / SISTAT02 / WATTUR01 — only differently-numbered siblings
+ *     exist (UWTROC03/04, SISTAT03, WATTUR02); the number encodes a
+ *     different portrayal case.
+ *   LIGHTHOUSE01 — a CHRT-local symbol name with no PresLib/S-101 analogue.
+ *
+ * Pinned by `s101-style.test.ts` so the set can only shrink deliberately
+ * (e.g. when re-pinned to an in-force catalogue edition that adds them).
+ */
+declare const S101_NO_OFFICIAL_COUNTERPART: ReadonlySet<string>;
+/** Resolve an S-101 colour token via the official profile for `table`.
+ *  An unknown token warns (see `reportUnresolvedToken`) before falling back. */
 declare function resolveS101Color(token: string, table?: ColorTableName): string;
 /**
  * Get an S-101 symbol SVG with its colour tokens resolved through the
@@ -3256,10 +3286,64 @@ declare function resolveS101Color(token: string, table?: ColorTableName): string
  */
 declare function getThemedS101Svg(symbolName: string, table?: ColorTableName): string | null;
 /**
- * Switch a generated style document to the S-101 symbol set. Symbol names
- * without an official S-101 counterpart keep their S-52 image (both sets
- * are loaded by `loadChartSymbolImages`), so coverage can only grow as the
- * PC adds symbols. Returns the same style object (mutated), for chaining.
+ * Where a symbol's artwork actually comes from under `?symbols=s101`.
+ *
+ *   - `official`      — the vendored IHO S-101 Portrayal Catalogue file.
+ *   - `s52-substitute`— the catalogue defines no symbol of this name, so S-52
+ *                       artwork is drawn instead (the pinned exemption set).
+ *   - `chrt-drawn`    — neither; a CHRT-authored approximation. `S101_NEW_SYMBOLS`
+ *                       in `s101-symbols.ts` is this, and it is NOT official
+ *                       artwork despite living under an S-101 name.
+ *
+ * Exported because any surface that *displays* S-101 symbology has to be able
+ * to say which of the three it is showing. Presenting a substitute or an
+ * approximation as catalogue artwork is the same silent-fallback defect as a
+ * chart quietly dropping a symbol — see the parity audit.
+ */
+type S101ArtworkProvenance = "official" | "s52-substitute" | "chrt-drawn";
+/** Classify a symbol name's artwork provenance. `symbolName` is the S-52
+ *  PresLib name (e.g. `BOYCAN01`), which is how every set here is keyed.
+ *
+ *  The `s52-substitute` test is "does real S-52 artwork exist for this name",
+ *  NOT "is it in the pinned exemption set" — that set only covers names the
+ *  generated style references, and a display surface (the Atlas) shows many
+ *  that it does not. Keying off the exemption set alone would misreport every
+ *  one of those as a CHRT drawing. */
+declare function s101ArtworkProvenance(symbolName: string | undefined): S101ArtworkProvenance;
+/**
+ * Official S-101 **area fill** names available to the rewrite below.
+ *
+ * **Empty, and that is the finding — not an oversight in this file.** The
+ * upstream `PortrayalCatalog/` ships `AreaFills/` and `LineStyles/` alongside
+ * `Symbols/`, but `PROVENANCE.md` records that only `Symbols/` was ever
+ * vendored, and `gen-s101-svgs.ts` reads that one directory. So every area
+ * fill and complex line under `?symbols=s101` is still S-52 artwork:
+ * `AP:CBLARE01`, `AP:MARSHES1`, `AP:PIPARE01`, `AP:VEGATN03`, `AP:VEGATN04`,
+ * `LC:CBLARE51`, `LC:CBLSUB06`, `LC:PIPSOL05`, `LC:PIPSOL06`.
+ *
+ * These sets are declared rather than assumed so the omission is *typed and
+ * measurable* instead of invisible: `applyS101SymbolSet` now walks pattern
+ * references too, the coverage metadata below reports the real ratio, and
+ * `s101-parity.test.ts` pins it at 0. Vendor the two directories, populate
+ * these sets, and every count moves on its own — no other change required.
+ */
+declare const S101_AREA_FILL_NAMES: ReadonlySet<string>;
+/** Official S-101 **line style** names available to the rewrite. Empty for the
+ *  same reason as `S101_AREA_FILL_NAMES` — see that doc comment. */
+declare const S101_LINE_STYLE_NAMES: ReadonlySet<string>;
+/**
+ * Switch a generated style document to the S-101 symbol set.
+ *
+ * Covers all three ways a GL style names an image — `icon-image`,
+ * `fill-pattern` and `line-pattern`. Names without official S-101 artwork keep
+ * their S-52 image (both sets are loaded by `loadChartSymbolImages`), so
+ * coverage can only grow as the catalogue is vendored further.
+ *
+ * Emits `chrt:s101-coverage` so a consumer can tell *how* S-101 the document
+ * it just fetched actually is. Before this existed the answer was
+ * unobtainable without decoding the style yourself, which is how "s101" read
+ * as complete when its areas and lines were entirely S-52.
+ * Returns the same style object (mutated), for chaining.
  */
 declare function applyS101SymbolSet(style: MapboxStyle): MapboxStyle;
 
@@ -4172,4 +4256,4 @@ declare class Chrt {
     warmTiles(region?: string): Promise<void>;
 }
 
-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_DRAW_ORDER, BAND_PRIORITY_RANGES, type BBox, BRIDGE_QUERY_LAYERS, BUILD_MAXZOOM, BUILD_MINZOOM, 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, 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, type LabelBehavior, type LabelConfigOptions, type LabelLayerConfig, type LabelSettings, type LookupEntry, type MapLibreStyle, type MapboxStyle, type MapboxVectorSource, type MarineAlert, type MarineAlertsOptions, type MarineAlertsResponse, type MarineConditionsOptions, type MarineConditionsResponse, 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, NON_SOLAS_DISCLAIMER, NON_SOLAS_DISCLAIMER_SHORT, type NauticalCategory, type NauticalSymbol, type NavAidInspectResult, type NavAidSettings, type NearbyMarineStation, type OfflineBundleResponse, type OfflineDownloadOptions, type OfflineDownloadProgress, type OfflineDownloadResult, OfflineError, type OfflineErrorCode, type OfflineFetchStyleOptions, type OfflineHeartbeatOptions, type OfflineRegionSummary, type OfflineRemoveOptions, OfflineStyleError, type OfflineStylePlatform, type OfflineStyleResponse, type PmtilesVectorSource, type QueryFeatureProperties, type QueryOptions, type QueryResponse, RASTER_ATON_CLASSES, RASTER_GLYPH_NAMES, RASTER_ICON_PREFIX, type ResolvedStyle, type ResolvedTheme, type S101Feature, S101_CHART_SECTIONS, S101_FEATURES, S101_ICON_PREFIX, S101_NEW_SYMBOLS, 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, SOUNDING_LAYERS, SYMBOL_FAMILIES, SYMBOL_FAMILY_META, SYMBOL_GROUPS, SYMBOL_MAP, type ScaleBand, type SearchCoverageNotice, type SearchHit, type SearchOptions, type SearchResponse, type SectorArcFeature, type SectorArcFeatureCollection, type SectorInfo, type SoundingSettings, type SourceMode, type StyleGeneratorOptions, type StyleLayer, type StyleUrlOptions, type SymbolFamily, type SymbolFamilyMeta, 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, applyChrtSymbolSet, applyColorTheme, applyCustomStyleSettings, applyRasterSymbolSet, applyS101SymbolSet, atonIconExpression, bandFilterExpression, buildFlashPattern, buildLabelLayer, buildLayersForClass, buildOfflineStyle, buildSectorArcGeoJSON, buildSectorArcsFC, buildSectorsFromFeatures, buildSources, candidateRank, chrtAtonTintExpression, chrtLightTintExpression, collectCandidates, collectClickCandidates, combineWithBandFilter, daymarkColor, decimateFeatures, decodeAreaFeatureProps, decodeBridgeProps, decodeCandidate, decodeNavAidProps, depareColor, depareFillExpression, deriveMarinerName, 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, iconExpressionForFamily, isLabelLayerVisible, isNavAidLayer, isNavAidLayerVisible, isSoundingLayerVisible, isVisibleInMode, isWaterBodyLayerVisible, labelSortKey, lateralColor, lateralFillExpression, lightColor, lightFillExpression, lightsIconExpression, normalizeStyleMode, normalizeTheme, paginate, parseListCodes, parseSymbolFamily, parseWebhook, patternSpriteId, preprocessLights, preprocessNavAids, preprocessSoundings, preprocessWaterBodies, rasterAtonIconExpression, resolveCustomTheme, resolveRasterImage, resolveS101Color, resolveStyle, resolveTargetClass, sanitizeCustomStyleConfig, scaleSizeValue, scaminToMinZoom, styleModeBand, 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_DRAW_ORDER, BAND_PRIORITY_RANGES, type BBox, BRIDGE_QUERY_LAYERS, BUILD_MAXZOOM, BUILD_MINZOOM, 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, 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, type LabelBehavior, type LabelConfigOptions, type LabelLayerConfig, type LabelSettings, type LookupEntry, type MapLibreStyle, type MapboxStyle, type MapboxVectorSource, type MarineAlert, type MarineAlertsOptions, type MarineAlertsResponse, type MarineConditionsOptions, type MarineConditionsResponse, 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, NON_SOLAS_DISCLAIMER, NON_SOLAS_DISCLAIMER_SHORT, type NauticalCategory, type NauticalSymbol, type NavAidInspectResult, type NavAidSettings, type NearbyMarineStation, type OfflineBundleResponse, type OfflineDownloadOptions, type OfflineDownloadProgress, type OfflineDownloadResult, OfflineError, type OfflineErrorCode, type OfflineFetchStyleOptions, type OfflineHeartbeatOptions, type OfflineRegionSummary, type OfflineRemoveOptions, OfflineStyleError, type OfflineStylePlatform, type OfflineStyleResponse, type PmtilesVectorSource, type QueryFeatureProperties, type QueryOptions, type QueryResponse, RASTER_ATON_CLASSES, RASTER_GLYPH_NAMES, RASTER_ICON_PREFIX, 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, SOUNDING_LAYERS, SYMBOL_FAMILIES, SYMBOL_FAMILY_META, SYMBOL_GROUPS, SYMBOL_MAP, type ScaleBand, type SearchCoverageNotice, type SearchHit, type SearchOptions, type SearchResponse, type SectorArcFeature, type SectorArcFeatureCollection, type SectorInfo, type SoundingSettings, type SourceMode, type StyleGeneratorOptions, type StyleLayer, type StyleUrlOptions, type SymbolFamily, type SymbolFamilyMeta, 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, applyChrtSymbolSet, applyColorTheme, applyCustomStyleSettings, applyRasterSymbolSet, applyS101SymbolSet, atonIconExpression, bandFilterExpression, buildFlashPattern, buildLabelLayer, buildLayersForClass, buildOfflineStyle, buildSectorArcGeoJSON, buildSectorArcsFC, buildSectorsFromFeatures, buildSources, candidateRank, chrtAtonTintExpression, chrtLightTintExpression, collectCandidates, collectClickCandidates, combineWithBandFilter, daymarkColor, decimateFeatures, decodeAreaFeatureProps, decodeBridgeProps, decodeCandidate, decodeNavAidProps, depareColor, depareFillExpression, deriveMarinerName, 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, iconExpressionForFamily, isLabelLayerVisible, isNavAidLayer, isNavAidLayerVisible, isSoundingLayerVisible, isVisibleInMode, isWaterBodyLayerVisible, labelSortKey, lateralColor, lateralFillExpression, lightColor, lightFillExpression, lightsIconExpression, normalizeStyleMode, normalizeTheme, paginate, parseListCodes, parseSymbolFamily, parseWebhook, patternSpriteId, preprocessLights, preprocessNavAids, preprocessSoundings, preprocessWaterBodies, rasterAtonIconExpression, resolveCustomTheme, resolveRasterImage, resolveS101Color, resolveStyle, resolveTargetClass, s101ArtworkProvenance, sanitizeCustomStyleConfig, scaleSizeValue, scaminToMinZoom, styleModeBand, withinBboxFilter, worldMinusBboxPolygon };