@chrtco/sdk 0.10.12 → 0.10.14

package/dist/index.d.cts

@@ -2531,7 +2531,9 @@ declare function getCollisionSettings(viewingGroup?: number): {
 /**
  * Get the resolved Mapbox GL style for a given S-57 layer.
  */
-declare function resolveStyle(layerName: string, geomKind?: GeomType, ct?: ColorTableName): ResolvedStyle;
+declare function resolveStyle(layerName: string, geomKind?: GeomType, ct?: ColorTableName, opts?: {
+    safetyContour?: number;
+}): ResolvedStyle;
 declare function getLookupEntry(layerName: string): LookupEntry;
 
 /**
@@ -2551,20 +2553,17 @@ declare function getLookupEntry(layerName: string): LookupEntry;
  *     high-contrast shade (see `getLabelConfig` in labels.ts).
  *   - §CSYM02   — isolated dangers shoaler than the contour get the
  *     DNGCIR01 ring (see `buildLayersForClass` in layer-builder.ts).
+ *   - §DEPARE04 — the MS/MD shade boundary (owner decision 2026-08-21,
+ *     replacing a hardcoded 5 m middle cut; see the DEPARE block below
+ *     for the full IHO correspondence).
  *
- * Both are overridden by the user's setting (sounding panel slider,
+ * All are overridden by the user's setting (sounding panel slider,
  * `safetyContour` in the style options); this is only the fallback when
  * none is supplied. It matches `custom-style.ts`'s config default.
- *
- * NOTE: `depareFillExpression` below deliberately does NOT use this — its
- * 2/5/18.2 m bands are the four-shade DEPARE ramp (see DEPARE_DEEP_CUT_M
- * for why the deep cut is 18.2), a separate concept from the safety
- * contour. Wiring those to the user's contour would change rendering for
- * every existing user and needs its own decision.
  */
 declare const DEFAULT_SAFETY_CONTOUR_M = 10;
-declare function depareColor(props: Record<string, unknown>, ct?: ColorTableName): string;
-declare function depareFillExpression(ct?: ColorTableName): unknown[];
+declare function depareColor(props: Record<string, unknown>, ct?: ColorTableName, safetyContourM?: number): string;
+declare function depareFillExpression(ct?: ColorTableName, safetyContourM?: number): unknown[];
 declare function lightColor(props: Record<string, unknown>, ct?: ColorTableName): string;
 declare function lightFillExpression(ct?: ColorTableName): unknown[];
 declare function lateralColor(props: Record<string, unknown>, ct?: ColorTableName): string;

package/dist/index.d.ts

@@ -2531,7 +2531,9 @@ declare function getCollisionSettings(viewingGroup?: number): {
 /**
  * Get the resolved Mapbox GL style for a given S-57 layer.
  */
-declare function resolveStyle(layerName: string, geomKind?: GeomType, ct?: ColorTableName): ResolvedStyle;
+declare function resolveStyle(layerName: string, geomKind?: GeomType, ct?: ColorTableName, opts?: {
+    safetyContour?: number;
+}): ResolvedStyle;
 declare function getLookupEntry(layerName: string): LookupEntry;
 
 /**
@@ -2551,20 +2553,17 @@ declare function getLookupEntry(layerName: string): LookupEntry;
  *     high-contrast shade (see `getLabelConfig` in labels.ts).
  *   - §CSYM02   — isolated dangers shoaler than the contour get the
  *     DNGCIR01 ring (see `buildLayersForClass` in layer-builder.ts).
+ *   - §DEPARE04 — the MS/MD shade boundary (owner decision 2026-08-21,
+ *     replacing a hardcoded 5 m middle cut; see the DEPARE block below
+ *     for the full IHO correspondence).
  *
- * Both are overridden by the user's setting (sounding panel slider,
+ * All are overridden by the user's setting (sounding panel slider,
  * `safetyContour` in the style options); this is only the fallback when
  * none is supplied. It matches `custom-style.ts`'s config default.
- *
- * NOTE: `depareFillExpression` below deliberately does NOT use this — its
- * 2/5/18.2 m bands are the four-shade DEPARE ramp (see DEPARE_DEEP_CUT_M
- * for why the deep cut is 18.2), a separate concept from the safety
- * contour. Wiring those to the user's contour would change rendering for
- * every existing user and needs its own decision.
  */
 declare const DEFAULT_SAFETY_CONTOUR_M = 10;
-declare function depareColor(props: Record<string, unknown>, ct?: ColorTableName): string;
-declare function depareFillExpression(ct?: ColorTableName): unknown[];
+declare function depareColor(props: Record<string, unknown>, ct?: ColorTableName, safetyContourM?: number): string;
+declare function depareFillExpression(ct?: ColorTableName, safetyContourM?: number): unknown[];
 declare function lightColor(props: Record<string, unknown>, ct?: ColorTableName): string;
 declare function lightFillExpression(ct?: ColorTableName): unknown[];
 declare function lateralColor(props: Record<string, unknown>, ct?: ColorTableName): string;

package/dist/index.js

@@ -5271,16 +5271,23 @@ function patternSpriteId(patternName) {
 // src/atlas/s52-conditional.ts
 var DEFAULT_SAFETY_CONTOUR_M = 10;
 var DEPARE_DEEP_CUT_M = 18.2;
-function depareColor(props, ct = "DAY") {
+var DEPARE_SHALLOW_CUT_M = 2;
+function effectiveSafetyContour(safetyContourM) {
+  if (!Number.isFinite(safetyContourM)) return DEFAULT_SAFETY_CONTOUR_M;
+  return Math.min(Math.max(safetyContourM, DEPARE_SHALLOW_CUT_M), DEPARE_DEEP_CUT_M);
+}
+function depareColor(props, ct = "DAY", safetyContourM = DEFAULT_SAFETY_CONTOUR_M) {
   const drval1 = Number(props.DRVAL1 ?? props.drval1 ?? -1);
   const drval2 = Number(props.DRVAL2 ?? props.drval2 ?? drval1);
+  const safety = effectiveSafetyContour(safetyContourM);
   if (drval1 < 0 && drval2 <= 0) return resolveColor("DEPIT", ct);
-  if (drval1 < 2) return resolveColor("DEPVS", ct);
-  if (drval1 < 5) return resolveColor("DEPMS", ct);
+  if (drval1 < DEPARE_SHALLOW_CUT_M) return resolveColor("DEPVS", ct);
+  if (drval1 < safety) return resolveColor("DEPMS", ct);
   if (drval1 < DEPARE_DEEP_CUT_M) return resolveColor("DEPMD", ct);
   return resolveColor("DEPDW", ct);
 }
-function depareFillExpression(ct = "DAY") {
+function depareFillExpression(ct = "DAY", safetyContourM = DEFAULT_SAFETY_CONTOUR_M) {
+  const safety = effectiveSafetyContour(safetyContourM);
   return [
     "case",
     [
@@ -5289,9 +5296,9 @@ function depareFillExpression(ct = "DAY") {
       ["<=", ["coalesce", ["get", "DRVAL2"], ["get", "drval2"], 0], 0]
     ],
     resolveColor("DEPIT", ct),
-    ["<", ["coalesce", ["get", "DRVAL1"], ["get", "drval1"], -1], 2],
+    ["<", ["coalesce", ["get", "DRVAL1"], ["get", "drval1"], -1], DEPARE_SHALLOW_CUT_M],
     resolveColor("DEPVS", ct),
-    ["<", ["coalesce", ["get", "DRVAL1"], ["get", "drval1"], -1], 5],
+    ["<", ["coalesce", ["get", "DRVAL1"], ["get", "drval1"], -1], safety],
     resolveColor("DEPMS", ct),
     ["<", ["coalesce", ["get", "DRVAL1"], ["get", "drval1"], -1], DEPARE_DEEP_CUT_M],
     resolveColor("DEPMD", ct),
@@ -22070,15 +22077,32 @@ function isVisibleInMode(displayCategory, mode) {
   if (mode === "STANDARD") return displayCategory === "BASE" || displayCategory === "STANDARD";
   return displayCategory === "BASE";
 }
+var SCAMIN_ZOOM_BUCKETS = [
+  [12e3, 14],
+  [22e3, 12],
+  [45e3, 11],
+  [9e4, 10],
+  [35e4, 8],
+  [15e5, 6]
+];
 function scaminToMinZoom(scamin) {
   if (scamin === void 0 || scamin === null || scamin === 0) return void 0;
-  if (scamin >= 15e5) return 6;
-  if (scamin >= 35e4) return 8;
-  if (scamin >= 9e4) return 10;
-  if (scamin >= 45e3) return 11;
-  if (scamin >= 22e3) return 12;
-  if (scamin >= 12e3) return 14;
-  return void 0;
+  let zoom;
+  for (const [denom, z] of SCAMIN_ZOOM_BUCKETS) {
+    if (scamin >= denom) zoom = z;
+  }
+  return zoom;
+}
+function scaminZoomGateFilter() {
+  const step = [
+    "step",
+    ["to-number", ["coalesce", ["get", "SCAMIN"], ["get", "scamin"], 0]],
+    0
+  ];
+  for (const [denom, z] of SCAMIN_ZOOM_BUCKETS) {
+    step.push(denom, z);
+  }
+  return [">=", ["zoom"], step];
 }
 var SAFETY_CRITICAL_GROUPS = /* @__PURE__ */ new Set([24020, 27010, 27070, 27080]);
 var OPAQUE_FILL_LAYERS = /* @__PURE__ */ new Set(["DEPARE", "LNDARE", "UNSARE", "LAKARE", "DRGARE", "SEAARE"]);
@@ -22112,7 +22136,7 @@ var ZOOM_SCALED_LINES = {
   BRIDGE: [8, 1, 14, 2],
   DAMCON: [8, 1, 14, 2]
 };
-function resolvePaint(layerName, paint, geomType, ct = "DAY") {
+function resolvePaint(layerName, paint, geomType, ct = "DAY", opts = {}) {
   const resolved = {};
   for (const [key, value] of Object.entries(paint)) {
     if (typeof value === "string" && /^[A-Z]{4,5}[0-9]?$/.test(value)) {
@@ -22122,7 +22146,7 @@ function resolvePaint(layerName, paint, geomType, ct = "DAY") {
     }
   }
   if (layerName === "DEPARE" && geomType === "fill") {
-    resolved["fill-color"] = depareFillExpression(ct);
+    resolved["fill-color"] = depareFillExpression(ct, opts.safetyContour);
   } else if (layerName === "LIGHTS" && geomType === "circle") {
     resolved["circle-color"] = lightFillExpression(ct);
   } else if ((layerName === "BOYLAT" || layerName === "BCNLAT") && geomType === "circle") {
@@ -22134,7 +22158,7 @@ function resolvePaint(layerName, paint, geomType, ct = "DAY") {
   }
   return resolved;
 }
-function resolveStyle(layerName, geomKind, ct = "DAY") {
+function resolveStyle(layerName, geomKind, ct = "DAY", opts = {}) {
   const entry = S52_LOOKUP[layerName];
   if (!entry) {
     const type = geomKind ?? "circle";
@@ -22170,7 +22194,7 @@ function resolveStyle(layerName, geomKind, ct = "DAY") {
     const paint2 = effectiveType === "fill" ? { "fill-color": hexColor, "fill-opacity": 0.3 } : effectiveType === "line" ? { "line-color": hexColor, "line-width": 1 } : { "circle-color": hexColor, "circle-radius": 3, "circle-stroke-width": 0 };
     return { type: effectiveType, paint: paint2 };
   }
-  const paint = resolvePaint(layerName, { ...entry.style.paint }, effectiveType, ct);
+  const paint = resolvePaint(layerName, { ...entry.style.paint }, effectiveType, ct, opts);
   if (effectiveType === "fill" && OPAQUE_FILL_LAYERS.has(layerName)) {
     paint["fill-opacity"] = 1;
   }
@@ -23119,21 +23143,19 @@ function getLabelConfig(layerName, opts = {}) {
         layout: orientationLabelLayout({
           "text-letter-spacing": 0.15,
           "text-max-width": 9,
-          // SEAARE is always-paint, unlike the other orientation classes.
-          // MapLibre places symbols topmost-layer-first, so with
-          // allow-overlap:false the dense sounding field (drawn above)
-          // collision-starves big-water names — observed on staging at z8:
-          // only 2 SEAARE labels survived viewport-wide, with Cape Cod Bay
-          // and Gulf of Maine dropped entirely. Always-paint is safe for
-          // this class because (a) the dominance composition in
-          // fanOrientationLabelByCellBand suppresses cross-band duplicate
-          // copies, and (b) tier sizing zeroes relief/anchorage names at
-          // the zooms where density is a problem. Rivers/lakes/land keep
-          // collision-dedup — their within-band multi-polygon stacking was
-          // the original complaint, and they lack big-water headline value.
-          "text-allow-overlap": true,
-          "text-ignore-placement": true,
-          "text-optional": false,
+          // SEAARE was always-paint (allow-overlap + ignore-placement)
+          // because collision starved big-water names at z8. That trade
+          // inverted in the field on 2026-08-21: the always-paint copies —
+          // per band, per adjacent cell, and one per TILE-CLIPPED piece of
+          // a big polygon — stack into unreadable black smears (dozens of
+          // "Chesapeake Bay" at z9, owner screenshot). With collision ON
+          // the duplicates collide with EACH OTHER, so MapLibre keeps one
+          // and drops the rest: a possibly-starved name beats an illegible
+          // smear categorically. This is the interim state until the
+          // PLACENAME layer (one anchor per named place, PR #1308) reaches
+          // the tiles and replaces this fan outright — do not restore
+          // always-paint on a starvation report; flip `labels: "placename"`
+          // instead once the build carries the layer.
           "text-padding": 2
         })
       };
@@ -26740,6 +26762,13 @@ function buildSources(opts = {}) {
 }
 
 // src/atlas/layer-builder.ts
+var SCAMIN_DECLUTTER_CLASSES = /* @__PURE__ */ new Set([
+  "OFSPLF",
+  "PIPSOL",
+  "PIPARE",
+  "CBLSUB",
+  "CBLARE"
+]);
 var GEOM_FILTERS = {
   fill: ["any", ["==", ["geometry-type"], "Polygon"], ["==", ["geometry-type"], "MultiPolygon"]],
   line: ["any", ["==", ["geometry-type"], "LineString"], ["==", ["geometry-type"], "MultiLineString"]],
@@ -26898,7 +26927,7 @@ function buildLayersForClass(objectClass, ct, sourceId = DEFAULT_REGION, opts =
   const layers = [];
   const geomTypes = getGeomTypesForClass(objectClass, entry?.style.type);
   for (const geomType of geomTypes) {
-    const resolved = resolveStyle(objectClass, geomType, ct);
+    const resolved = resolveStyle(objectClass, geomType, ct, { safetyContour: opts.safetyContour });
     const layerId = `s52-${objectClass}-${resolved.type}`;
     const layer = {
       id: layerId,
@@ -26917,6 +26946,9 @@ function buildLayersForClass(objectClass, ct, sourceId = DEFAULT_REGION, opts =
     } else if (GEOM_FILTERS[resolved.type]) {
       layer.filter = GEOM_FILTERS[resolved.type];
     }
+    if (SCAMIN_DECLUTTER_CLASSES.has(objectClass)) {
+      layer.filter = layer.filter ? ["all", layer.filter, scaminZoomGateFilter()] : ["all", scaminZoomGateFilter()];
+    }
     if (resolved.minzoom) {
       layer.minzoom = resolved.minzoom;
     }
@@ -27975,6 +28007,11 @@ function getOrderedClasses() {
 }
 
 // src/atlas/land-layers.ts
+var FADE_PX = 80;
+var FADE_BANDS = 16;
+function fadeAlpha(r) {
+  return Math.max(0, Math.min(1, (FADE_PX / 2 - Math.abs(r)) / FADE_PX));
+}
 var LAND_THEMES = {
   DAY: {
     base: "#e8d9b0",
@@ -27986,7 +28023,8 @@ var LAND_THEMES = {
     label: "#5b4f3a",
     halo: "#f2ead6",
     shadow: "#6b5a3e",
-    highlight: "#fffaf0"
+    highlight: "#fffaf0",
+    fade: "#e8f2f8"
   },
   DUSK: {
     base: "#4a4433",
@@ -27998,7 +28036,8 @@ var LAND_THEMES = {
     label: "#c3b898",
     halo: "#2b2820",
     shadow: "#2e2a20",
-    highlight: "#8a8068"
+    highlight: "#8a8068",
+    fade: "#16202a"
   },
   NIGHT: {
     base: "#2a2620",
@@ -28010,7 +28049,8 @@ var LAND_THEMES = {
     label: "#7d745e",
     halo: "#15130f",
     shadow: "#1a1712",
-    highlight: "#4a4436"
+    highlight: "#4a4436",
+    fade: "#07090b"
   }
 };
 var FITS = ["<=", ["coalesce", ["get", "min_z"], 0], ["zoom"]];
@@ -28091,6 +28131,18 @@ function landLayers(opts = {}) {
       "line-opacity": 0.7
     }
   }));
+  const d = FADE_PX / 2 / FADE_BANDS;
+  for (let k = 0; k < FADE_BANDS; k++) {
+    const width = k === 0 ? { "line-width": 2 * d } : { "line-width": d, "line-gap-width": 2 * k * d };
+    layers.push(L({
+      id: `chrtland-fade-${k}`,
+      type: "line",
+      source: src,
+      "source-layer": "land_edge",
+      layout: { "line-join": "bevel" },
+      paint: { "line-color": T.fade, "line-blur": 0, "line-opacity": fadeAlpha(k * d + d / 2), ...width }
+    }));
+  }
   layers.push(L({
     id: "chrtland-road",
     type: "line",
@@ -28212,6 +28264,18 @@ function isExemptOpaqueFill(layer) {
   }
   return false;
 }
+var FILL_FLOOR_FREE_BANDS = /* @__PURE__ */ new Set([
+  "1",
+  "2",
+  "3"
+]);
+function bandVariantMinzoom(layer, B) {
+  const classMinzoom = layer.minzoom ?? 0;
+  if (isExemptOpaqueFill(layer) && FILL_FLOOR_FREE_BANDS.has(B)) {
+    return classMinzoom;
+  }
+  return Math.max(classMinzoom, BAND_PRIORITY_RANGES[B].minzoom);
+}
 var BAND_DRAW_ORDER = ["1", "2", "3", "4", "5", "6"];
 var CHART_BAND_CODES = {
   Overview: ["1"],
@@ -28330,9 +28394,7 @@ function collapsedDominanceGate(B, minzoom) {
   return ["any", ...clauses];
 }
 function makeCollapsedBandVariant(layer, B, isExempt) {
-  const range = BAND_PRIORITY_RANGES[B];
-  const classMinzoom = layer.minzoom ?? 0;
-  const minzoom = isExemptOpaqueFill(layer) ? classMinzoom : Math.max(classMinzoom, range.minzoom);
+  const minzoom = bandVariantMinzoom(layer, B);
   if (isExempt) {
     const exempt = {
       ...layer,
@@ -28471,8 +28533,7 @@ function isDominanceExempt(layer) {
 var TOP_STACK_LIGHT_CLASSES = /* @__PURE__ */ new Set(["LIGHTS"]);
 function makeBandVariants(layer, B) {
   const range = BAND_PRIORITY_RANGES[B];
-  const classMinzoom = layer.minzoom ?? 0;
-  const minzoom = isExemptOpaqueFill(layer) ? classMinzoom : Math.max(classMinzoom, range.minzoom);
+  const minzoom = bandVariantMinzoom(layer, B);
   const variants = [];
   if (isDominanceExempt(layer)) {
     const exempt = {
@@ -28780,6 +28841,12 @@ function generateStyle(palette = "DAY", opts = {}) {
   }
   const symbolSet = opts.symbolSet ?? "s52";
   const spriteBase = `${opts.tileBaseUrl ?? "https://tiles.chrt.co"}/v1/sprites`;
+  const isLndareFill = (l) => /^s52-LNDARE-fill-band\d+$/.test(l.id);
+  const emitted = opts.land ? (() => {
+    const fills = layers.filter(isLndareFill);
+    const rest = layers.filter((l) => !isLndareFill(l));
+    return [rest[0], ...fills, ...rest.slice(1)];
+  })() : layers;
   const style = {
     version: 8,
     name: `CHRT ${SYMBOL_SET_LABELS[symbolSet]} ${PALETTE_NAMES[palette]}${opts.chartMode ? ` \u2014 chart:${opts.chartMode.band}` : ""}`,
@@ -28788,7 +28855,7 @@ function generateStyle(palette = "DAY", opts = {}) {
       "chrt:symbol-set": symbolSet,
       "chrt:color-table": palette,
       "chrt:generated-at": (/* @__PURE__ */ new Date()).toISOString(),
-      "chrt:layer-count": layers.length,
+      "chrt:layer-count": emitted.length,
       "chrt:land": Boolean(opts.land),
       "chrt:relief": Boolean(opts.relief),
       "chrt:render-mode": opts.chartMode ? `chart:${opts.chartMode.band}` : "continuous",
@@ -28811,7 +28878,7 @@ function generateStyle(palette = "DAY", opts = {}) {
       sprite: `${spriteBase}/${symbolSet}-${palette.toLowerCase()}`
     },
     glyphs: "https://fonts.openmaptiles.org/{fontstack}/{range}.pbf",
-    layers
+    layers: emitted
   };
   if (symbolSet === "s101") return applyS101SymbolSet(style);
   if (symbolSet === "chrt") return applyChrtSymbolSet(style, palette);