@chrtco/sdk 0.10.48 → 0.10.49

package/dist/index.js

@@ -25386,8 +25386,6 @@ function getLabelConfig(layerName, opts = {}) {
         // UWTROC/OBSTRN/WRECKS are dominance-PARTICIPATING classes —
         // exactly one band's copy renders at any zoom, so anchor-shifting
         // can't split a cross-band duplicate pair into two visible labels.
-        // Shallowest (most dangerous) hazard wins within-class contests;
-        // VALSOU-less hazards (awash / unsounded) rank first of all.
         layout: {
           "text-variable-anchor": ["top-left", "bottom-left", "top-right", "bottom-right"],
           "text-radial-offset": 0.9,
@@ -25411,6 +25409,23 @@ function getLabelConfig(layerName, opts = {}) {
           "text-allow-overlap": true,
           "text-optional": true,
           "text-padding": 2,
+          // ⚠ THE DEPTH SORT KEY IS LOAD-BEARING — do not "optimise" it to a
+          // constant. It costs draw calls: MapLibre 5.24 draws an overlapping
+          // layer with a data-driven key one segment per distinct key, twice
+          // with a halo over 1 px (`drawLayerSymbols`, `hasSortKey &&
+          // bucket.canOverlap`), so at 100 % the chart issues +14 % draw calls
+          // at z12.3 against 0.10.3 (R6's 0.10.4 gate). But the key is also
+          // the PLACEMENT order, and a callout keeps its collision box, so the
+          // order decides which corner each callout takes and therefore which
+          // soundings and buoy names survive beneath it. Measured with each
+          // form booted fresh (2026-10-06, Boston and Salem Sound, z11.5–16,
+          // at 1280×800 and the Pi's 1920×1185): a constant key, 3/4/5 depth
+          // bands and whole metres ALL uncover shoals that 0.10.3 drew (a
+          // constant key: 5 at z12.3 on the Pi's canvas, a 0.6 m one at
+          // 1280×800) and change buoy names; only this key matches 0.10.4's
+          // census. `danger-depth-census.ts --form <json>` re-runs that gate
+          // for any candidate. A 1 px halo (one pass, not two) halves the
+          // cost with placement byte-identical — a portrayal call, not taken.
           "symbol-sort-key": labelSortKey(100, ["*", 10, valsou])
         }
       };