@chrtco/sdk 0.7.4 → 0.7.5

package/dist/index.js

@@ -6358,30 +6358,141 @@ function buildSeabedLabelExpression() {
   const natsurJoined = ["slice", natsurParts, 1];
   return ["concat", natquaPrefix, natsurJoined];
 }
+function underseaFeatureNameMatch(objnam) {
+  const terms = [
+    "Canyon",
+    "Seamount",
+    "Ridge",
+    "Basin",
+    "Swell",
+    "Knoll",
+    "Shoal",
+    "Ledge",
+    "Bank",
+    "Valley",
+    "Spur",
+    "Escarpment"
+  ];
+  return ["any", ...terms.map((t) => [">=", ["index-of", t, objnam], 0])];
+}
+var CATSEA_RELIEF_CODES = [
+  2,
+  // gat
+  3,
+  // bank
+  4,
+  // deep
+  6,
+  // trench
+  7,
+  // basin
+  8,
+  // mud flats
+  9,
+  // reef
+  10,
+  // ledge
+  11,
+  // canyon
+  13,
+  // shoal
+  14,
+  // knoll
+  15,
+  // ridge
+  16,
+  // seamount
+  17,
+  // pinnacle
+  18,
+  // abyssal plain
+  19,
+  // plateau
+  20,
+  // spur
+  21,
+  // shelf
+  22,
+  // trough
+  23,
+  // saddle
+  24,
+  // abyssal hills
+  25,
+  // apron
+  26,
+  // archipelagic apron
+  27,
+  // borderland
+  28,
+  // continental margin
+  29,
+  // continental rise
+  30,
+  // escarpment
+  31,
+  // fan
+  32,
+  // fracture zone
+  33,
+  // gap
+  34,
+  // guyot
+  35,
+  // hill
+  36,
+  // hole
+  37,
+  // hollow
+  39,
+  // levee
+  40,
+  // median valley
+  41,
+  // moat
+  42,
+  // mountains
+  43,
+  // peak
+  44,
+  // province
+  45,
+  // rise
+  47,
+  // seamount chain
+  48,
+  // shelf-edge
+  49,
+  // sill
+  50,
+  // slope
+  51,
+  // terrace
+  52
+  // valley
+];
 function buildSeaAreaTierExpression() {
-  const catsea = ["coalesce", ["get", "CATSEA"], ["get", "catsea"], 0];
+  const catsea = ["to-number", ["coalesce", ["get", "CATSEA"], ["get", "catsea"], 0]];
   const objnam = ["coalesce", ["get", "OBJNAM"], ""];
   return [
     "case",
-    // Tier 1 — Ocean (CATSEA=31 OR OBJNAM contains "Ocean", excluding
-    // anchorage-area-style compound names which we filter on later).
-    ["==", ["to-number", catsea], 31],
-    1,
-    ["any", ["==", ["to-number", catsea], 29], ["==", ["to-number", catsea], 30]],
-    2,
-    [
-      "any",
-      ["==", ["to-number", catsea], 4],
-      ["==", ["to-number", catsea], 11],
-      ["==", ["to-number", catsea], 27],
-      ["==", ["to-number", catsea], 28]
-    ],
-    3,
-    // Tier 4 — Anchorage detail (must be checked before OBJNAM-substring
-    // promotion so "Boston Harbor, MA …" anchorages don't bubble up).
+    // Tier 4 — Anchorage detail (before all promotions so "Boston Harbor,
+    // MA …" anchorage compound names don't bubble up).
     [">=", ["index-of", "Anchorage Area", objnam], 0],
     4,
-    // OBJNAM-substring promotion shims (run AFTER tier 4 demotion):
+    // Tier 5 — undersea relief, by authoritative CATSEA code first
+    // (Georges Bank=3, Georges Shoal=13, …), then by name for
+    // uncategorised features. Before promotion shims; see
+    // underseaFeatureNameMatch.
+    ["match", catsea, CATSEA_RELIEF_CODES, true, false],
+    5,
+    underseaFeatureNameMatch(objnam),
+    5,
+    // Tier 3 by authoritative CATSEA: bay / narrows.
+    ["match", catsea, [5, 12], true, false],
+    3,
+    // OBJNAM promotion shims (CATSEA has no ocean/sea/gulf/sound/strait
+    // codes, so names are the only signal for the headline tiers):
     [">=", ["index-of", "Atlantic Ocean", objnam], 0],
     1,
     [">=", ["index-of", "Pacific Ocean", objnam], 0],
@@ -6390,9 +6501,6 @@ function buildSeaAreaTierExpression() {
     1,
     [">=", ["index-of", "Gulf of", objnam], 0],
     2,
-    // Bay/Sound/Sea/Strait/Channel as a tier-3 shim (matches "Massachusetts
-    // Bay", "Buzzards Bay", "Long Island Sound", "Block Island Sound",
-    // "Vineyard Sound", "Cape Cod Bay", etc. without needing CATSEA).
     [">=", ["index-of", " Bay", objnam], 0],
     3,
     [">=", ["index-of", " Sound", objnam], 0],
@@ -6426,6 +6534,11 @@ function buildLandRegionTierExpression() {
   const nameLen = ["length", objnam];
   return [
     "case",
+    // NOAA also encodes undersea relief names (e.g. "Block Canyon", 12
+    // chars, no comma) as LNDRGN — without this demotion they'd qualify
+    // as tier-1 "major region" and paint at overview zoom.
+    underseaFeatureNameMatch(objnam),
+    2,
     ["all", ["<=", nameLen, 12], ["==", ["index-of", ",", objnam], -1]],
     1,
     2
@@ -6507,6 +6620,36 @@ function orientationLabelLayout(extras = {}) {
     ...extras
   };
 }
+function tieredSizeCurve(tierExpr, stops) {
+  const withHolds = [];
+  for (let i = 0; i < stops.length; i++) {
+    if (i > 0) {
+      const [pz, pv] = stops[i - 1];
+      const [nz, nv] = stops[i];
+      if (pv.some((v, t) => v === 0 && nv[t] > 0)) {
+        const hz = Math.round((nz - 0.2) * 10) / 10;
+        if (hz > pz) {
+          const f = (hz - pz) / (nz - pz);
+          withHolds.push([
+            hz,
+            pv.map(
+              (v, t) => v === 0 && nv[t] > 0 ? 0 : Math.round((v + (nv[t] - v) * f) * 10) / 10
+            )
+          ]);
+        }
+      }
+    }
+    withHolds.push(stops[i]);
+  }
+  const expr = ["interpolate", ["linear"], ["zoom"]];
+  for (const [z, vals] of withHolds) {
+    const m = ["match", tierExpr];
+    for (let t = 0; t < vals.length - 1; t++) m.push(t + 1, vals[t]);
+    m.push(vals[vals.length - 1]);
+    expr.push(z, m);
+  }
+  return expr;
+}
 var ORIENTATION_HALO_WIDTH = [
   "interpolate",
   ["linear"],
@@ -6636,35 +6779,23 @@ function getLabelConfig(layerName, opts = {}) {
     }
     case "LNDRGN": {
       const tierExpr = buildLandRegionTierExpression();
-      const sizeAt = (t1, t2) => [
-        "match",
-        tierExpr,
-        1,
-        t1,
-        2,
-        t2,
-        t2
-      ];
       return {
         type: "symbol",
         textField: ["get", "OBJNAM"],
-        textSize: [
-          "interpolate",
-          ["linear"],
-          ["zoom"],
-          5,
-          sizeAt(9, 0),
-          7,
-          sizeAt(11, 0),
-          9,
-          sizeAt(12, 0),
-          11,
-          sizeAt(12, 9),
-          13,
-          sizeAt(11, 11),
-          16,
-          sizeAt(10, 10)
-        ],
+        // Tier-1 entry moved from z5 to z7: undersea-relief names without a
+        // generic keyword ("Three Dory", "Outer Fall") can't be demoted by
+        // pattern, so the overview/general bands stay clean by holding ALL
+        // LNDRGN labels until coastal zoom. The Carto basemap already labels
+        // major land regions at z5-z6. Columns: t1 major region, t2 local
+        // point (also the default).
+        textSize: tieredSizeCurve(tierExpr, [
+          [5, [0, 0]],
+          [7, [11, 0]],
+          [9, [12, 0]],
+          [11, [12, 9]],
+          [13, [11, 11]],
+          [16, [10, 10]]
+        ]),
         textColor: DARK_BG,
         textHaloColor: COLOR.LAND_REGION,
         textHaloWidth: ORIENTATION_HALO_WIDTH,
@@ -6804,19 +6935,6 @@ function getLabelConfig(layerName, opts = {}) {
     }
     case "SEAARE": {
       const tierExpr = buildSeaAreaTierExpression();
-      const sizeAt = (t1, t2, t3, t4, def) => [
-        "match",
-        tierExpr,
-        1,
-        t1,
-        2,
-        t2,
-        3,
-        t3,
-        4,
-        t4,
-        def
-      ];
       return {
         type: "symbol",
         textField: ["get", "OBJNAM"],
@@ -6825,26 +6943,17 @@ function getLabelConfig(layerName, opts = {}) {
         // it floods the overview with hundreds of small italic labels that
         // crowd out the headline Ocean/Sea/Gulf names. It becomes visible only
         // at approach scale (z9) when the user has zoomed in enough that
-        // individual banks are useful context.
-        textSize: [
-          "interpolate",
-          ["linear"],
-          ["zoom"],
-          3,
-          sizeAt(14, 8, 0, 0, 0),
-          5,
-          sizeAt(16, 13, 9, 0, 0),
-          7,
-          sizeAt(14, 14, 12, 0, 0),
-          9,
-          sizeAt(12, 13, 14, 0, 9),
-          11,
-          sizeAt(10, 12, 13, 0, 11),
-          13,
-          sizeAt(9, 11, 12, 10, 11),
-          16,
-          sizeAt(9, 10, 11, 11, 10)
-        ],
+        // individual banks are useful context. Columns: t1 ocean, t2 sea/gulf,
+        // t3 bay/sound, t4 anchorage, default.
+        textSize: tieredSizeCurve(tierExpr, [
+          [3, [14, 8, 0, 0, 0]],
+          [5, [16, 13, 9, 0, 0]],
+          [7, [14, 14, 12, 0, 0]],
+          [9, [12, 13, 14, 0, 9]],
+          [11, [10, 12, 13, 0, 11]],
+          [13, [9, 11, 12, 10, 11]],
+          [16, [9, 10, 11, 11, 10]]
+        ]),
         textColor: DARK_BG,
         textHaloColor: COLOR.WATER_DEEP,
         textHaloWidth: ORIENTATION_HALO_WIDTH,
@@ -6853,39 +6962,38 @@ function getLabelConfig(layerName, opts = {}) {
         minzoom: 5,
         layout: orientationLabelLayout({
           "text-letter-spacing": 0.15,
-          "text-max-width": 9
+          "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,
+          "text-padding": 2
         })
       };
     }
     case "LAKARE": {
       const tierExpr = buildLakeTierExpression();
-      const sizeAt = (t1, t2) => [
-        "match",
-        tierExpr,
-        1,
-        t1,
-        2,
-        t2,
-        t2
-      ];
       return {
         type: "symbol",
         textField: ["get", "OBJNAM"],
-        textSize: [
-          "interpolate",
-          ["linear"],
-          ["zoom"],
-          7,
-          sizeAt(9, 0),
-          9,
-          sizeAt(11, 0),
-          11,
-          sizeAt(11, 9),
-          13,
-          sizeAt(10, 11),
-          16,
-          sizeAt(9, 10)
-        ],
+        textSize: tieredSizeCurve(tierExpr, [
+          [7, [9, 0]],
+          [9, [11, 0]],
+          [11, [11, 9]],
+          [13, [10, 11]],
+          [16, [9, 10]]
+        ]),
         textColor: DARK_BG,
         textHaloColor: COLOR.WATER,
         textHaloWidth: ORIENTATION_HALO_WIDTH,
@@ -6897,33 +7005,16 @@ function getLabelConfig(layerName, opts = {}) {
     }
     case "RIVERS": {
       const tierExpr = buildRiverTierExpression();
-      const sizeAt = (t1, t2) => [
-        "match",
-        tierExpr,
-        1,
-        t1,
-        2,
-        t2,
-        t2
-      ];
       return {
         type: "symbol",
         textField: ["get", "OBJNAM"],
-        textSize: [
-          "interpolate",
-          ["linear"],
-          ["zoom"],
-          7,
-          sizeAt(9, 0),
-          9,
-          sizeAt(11, 0),
-          11,
-          sizeAt(11, 9),
-          13,
-          sizeAt(10, 10),
-          16,
-          sizeAt(9, 10)
-        ],
+        textSize: tieredSizeCurve(tierExpr, [
+          [7, [9, 0]],
+          [9, [11, 0]],
+          [11, [11, 9]],
+          [13, [10, 10]],
+          [16, [9, 10]]
+        ]),
         textColor: DARK_BG,
         textHaloColor: COLOR.WATER,
         textHaloWidth: ORIENTATION_HALO_WIDTH,
@@ -6958,35 +7049,17 @@ function getLabelConfig(layerName, opts = {}) {
       };
     case "LNDARE": {
       const tierExpr = buildLandAreaTierExpression();
-      const sizeAt = (t1, t2) => [
-        "match",
-        tierExpr,
-        1,
-        t1,
-        2,
-        t2,
-        t2
-      ];
       return {
         type: "symbol",
         textField: ["get", "OBJNAM"],
-        textSize: [
-          "interpolate",
-          ["linear"],
-          ["zoom"],
-          5,
-          sizeAt(8, 0),
-          7,
-          sizeAt(10, 0),
-          9,
-          sizeAt(11, 0),
-          11,
-          sizeAt(11, 9),
-          13,
-          sizeAt(10, 10),
-          16,
-          sizeAt(9, 10)
-        ],
+        textSize: tieredSizeCurve(tierExpr, [
+          [5, [8, 0]],
+          [7, [10, 0]],
+          [9, [11, 0]],
+          [11, [11, 9]],
+          [13, [10, 10]],
+          [16, [9, 10]]
+        ]),
         textColor: DARK_BG,
         textHaloColor: COLOR.LAND_NATURAL,
         textHaloWidth: ORIENTATION_HALO_WIDTH,
@@ -6998,39 +7071,18 @@ function getLabelConfig(layerName, opts = {}) {
     }
     case "BUAARE": {
       const tierExpr = buildBuiltUpAreaTierExpression();
-      const sizeAt = (t1, t2, t3) => [
-        "match",
-        tierExpr,
-        1,
-        t1,
-        2,
-        t2,
-        3,
-        t3,
-        t3
-      ];
       return {
         type: "symbol",
         textField: ["get", "OBJNAM"],
-        textSize: [
-          "interpolate",
-          ["linear"],
-          ["zoom"],
-          3,
-          sizeAt(11, 0, 0),
-          5,
-          sizeAt(13, 0, 0),
-          7,
-          sizeAt(13, 9, 0),
-          9,
-          sizeAt(12, 12, 0),
-          11,
-          sizeAt(11, 12, 10),
-          13,
-          sizeAt(10, 11, 12),
-          16,
-          sizeAt(10, 10, 11)
-        ],
+        textSize: tieredSizeCurve(tierExpr, [
+          [3, [11, 0, 0]],
+          [5, [13, 0, 0]],
+          [7, [13, 9, 0]],
+          [9, [12, 12, 0]],
+          [11, [11, 12, 10]],
+          [13, [10, 11, 12]],
+          [16, [10, 10, 11]]
+        ]),
         textColor: DARK_BG,
         textHaloColor: COLOR.CITY,
         textHaloWidth: ORIENTATION_HALO_WIDTH,
@@ -7111,33 +7163,16 @@ function getLabelConfig(layerName, opts = {}) {
       };
     case "AIRARE": {
       const tierExpr = buildAirportTierExpression();
-      const sizeAt = (t1, t2) => [
-        "match",
-        tierExpr,
-        1,
-        t1,
-        2,
-        t2,
-        t2
-      ];
       return {
         type: "symbol",
         textField: ["get", "OBJNAM"],
-        textSize: [
-          "interpolate",
-          ["linear"],
-          ["zoom"],
-          7,
-          sizeAt(9, 0),
-          9,
-          sizeAt(11, 0),
-          11,
-          sizeAt(11, 9),
-          13,
-          sizeAt(10, 10),
-          16,
-          sizeAt(9, 9)
-        ],
+        textSize: tieredSizeCurve(tierExpr, [
+          [7, [9, 0]],
+          [9, [11, 0]],
+          [11, [11, 9]],
+          [13, [10, 10]],
+          [16, [9, 9]]
+        ]),
         textColor: DARK_BG,
         textHaloColor: COLOR.AIRPORT,
         textHaloWidth: ORIENTATION_HALO_WIDTH,
@@ -10409,7 +10444,10 @@ function buildLayersForClass(objectClass, ct, sourceId = DEFAULT_REGION) {
     }
     if (objectClass === "TUNNEL" && resolved.type === "line") {
       layers.push({
-        id: `s52-TUNNEL-line`,
+        // NOT `s52-TUNNEL-line` — that id is already taken by the main layer
+        // (`s52-${objectClass}-${resolved.type}`), and duplicate layer ids
+        // are a Mapbox style-spec violation (caught by style-integrity.test).
+        id: `s52-TUNNEL-linestring`,
         type: "line",
         source: sourceId,
         "source-layer": "TUNNEL",
@@ -10783,24 +10821,37 @@ function fanOrientationLabelByCellBand(label) {
     const curve = CELL_BAND_OPACITY_CURVE[code];
     const opacityExpr = ["interpolate", ["linear"], ["zoom"]];
     for (const [z, o] of curve) opacityExpr.push(z, o);
-    const variant = {
-      ...label,
-      id: `${label.id}-cell${code}`,
-      filter: combineWithBandFilter(
-        label.filter,
-        ["==", cellBandExpr, code]
-      ),
-      minzoom: Math.max(
-        label.minzoom ?? range.minzoom,
-        range.minzoom
-      ),
-      paint: {
-        ...label.paint ?? {},
-        "text-opacity": opacityExpr
-      }
+    const cellFiltered = combineWithBandFilter(
+      label.filter,
+      ["==", cellBandExpr, code]
+    );
+    const minzoom = Math.max(
+      label.minzoom ?? range.minzoom,
+      range.minzoom
+    );
+    const paint = {
+      ...label.paint ?? {},
+      "text-opacity": opacityExpr
     };
-    delete variant.maxzoom;
-    variants.push(variant);
+    variants.push({
+      ...label,
+      id: `${label.id}-cell${code}-notdom`,
+      filter: combineWithBandFilter(cellFiltered, NOT_DOMINATED_FILTER),
+      minzoom,
+      paint
+    });
+    for (const D of BAND_DRAW_ORDER) {
+      const dom = BAND_PRIORITY_RANGES[D];
+      if (dom.minzoom <= minzoom) continue;
+      variants.push({
+        ...label,
+        id: `${label.id}-cell${code}-domBy${D}`,
+        filter: combineWithBandFilter(cellFiltered, dominatedByMinFilter(D)),
+        minzoom,
+        maxzoom: dom.minzoom,
+        paint
+      });
+    }
   }
   return variants;
 }