@chrtco/sdk 0.10.30 → 0.10.31

package/dist/index.cjs

@@ -28842,455 +28842,138 @@ function worldMinusBboxPolygon(bbox) {
   };
 }
 
-// src/atlas/land-layers.ts
-var LAND_SURFACE_MINZOOM = BAND_PRIORITY_RANGES["5"].minzoom;
-var LAND_SURFACE_LAYERS = (id) => id === "chrtland-base" || id === "chrtland-cover" || id === "chrtland-contour" || id === "chrtland-hillshade" || id.startsWith("chrtland-fade-");
-var isLandGroundOverlay = (id) => LAND_SURFACE_LAYERS(id) && id !== "chrtland-base" || id === "chrtland-road";
-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));
-}
-function landBaseColor(palette) {
-  return (LAND_THEMES[palette] ?? LAND_THEMES.DAY).base;
+// src/atlas/base-layers.ts
+var NOCOVERAGE_PATTERN = "chrt:hatch-nocoverage";
+var UNCHARTED_PATTERN = "chrt:hatch-uncharted";
+function inlandWaterColor(palette) {
+  return (BASE_THEMES[palette] ?? BASE_THEMES.DAY).inlandWater;
 }
-var LAND_THEMES = {
+var BASE_THEMES = {
   DAY: {
-    base: "#e8d9b0",
-    cover: { wood: "#cfd8b4", wetland: "#c9d3c4", urban: "#dedad2", sand: "#efe4c2" },
-    contour: "#a89878",
-    contourIndex: "#8a7a5c",
-    road: "#d9c9a4",
-    roadMajor: "#d2bd8e",
-    label: "#5b4f3a",
-    halo: "#f2ead6",
-    shadow: "#6b5a3e",
-    highlight: "#fffaf0",
-    fade: "#e8f2f8",
-    // Raised from 0.45 on 2026-08-23. ⚠ Above the ~0.5 that
-    // hillshade-style.mjs warns "starts competing with depth areas" — a
-    // deliberate, sighted choice made against rendered evidence, not a
-    // default. If soundings or DEPARE ever read as fighting the terrain,
-    // this number is the first thing to walk back.
-    exaggeration: 0.8
+    // ── `earth` is the jurisdiction tan DIMMED (~0.55), not a blue-grey ──
+    // Outside the jurisdiction the map still owes the reader "what is land".
+    // State 3 in the header is "the geography, under a crosshatch", and until
+    // 2026-08-31 that geography was unreadable: earth #2A3439 against sea
+    // #1B2328 measured 1.25:1, so Hispaniola showed charted boxes with tan
+    // land inside and nothing recognisable around them (owner report: "no
+    // land painting down near the DR at some zooms"). Land is warm and sea is
+    // cool because that is what land and sea are; dimming the JURISDICTION
+    // tan rather than inventing a colour says the true thing — this is the
+    // same land, we simply do not carry charts for it. Held against BOTH
+    // neighbours: legible over sea, and never mistakable for the full tan of
+    // a country we do carry. DAY 3.59:1 vs sea, 3.17:1 vs tan.
+    earth: "#807761",
+    water: "#1B2328",
+    river: "#24313A",
+    boundary: "#4A575E",
+    jurisdiction: "#D4C69D",
+    // CHRTland's own tan — one land colour
+    inlandWater: "#B9CFDD",
+    // muted, unmistakably not a charted blue
+    // 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
+    // a shade deeper than the tan, quiet caps, tan halo.
+    stateLine: "#B1A077",
+    stateLabel: "#8E8468",
+    stateHalo: "#D4C69D",
+    // Rough-lake furniture (owner ask 2026-08-28: "the lakes need labels,
+    // and shorelines drawn"): a shoreline a shade deeper than the rough
+    // water, and a name in the water's own voice, haloed by the water.
+    inlandShore: "#8FA9BA",
+    inlandLabel: "#54707F",
+    inlandHalo: "#B9CFDD"
   },
   DUSK: {
-    base: "#4a4433",
-    cover: { wood: "#414a38", wetland: "#3f4740", urban: "#4e4a42", sand: "#544c39" },
-    contour: "#6b6250",
-    contourIndex: "#837961",
-    road: "#565040",
-    roadMajor: "#63594440",
-    label: "#c3b898",
-    halo: "#2b2820",
-    shadow: "#2e2a20",
-    highlight: "#8a8068",
-    fade: "#16202a",
-    // Unchanged. DUSK was not the palette the 0.8 decision was made against.
-    exaggeration: 0.45
+    // ── Re-derived 2026-09-01: the basemap sits UNDER the chart ──────────
+    // These were the DAY tones scaled by a constant, never measured against
+    // the DUSK chart — so `jurisdiction` came out at L=0.506 against a chart
+    // whose own land (LANDA #8a7d5e) is L=0.209, i.e. the context layer was
+    // 2.4x brighter than the data layer. Now capped at the chart's own land.
+    // The rest of the block rides the same 0.666 channel factor so every
+    // relationship the palette already chose is preserved, only moved down.
+    // `water` is deliberately NOT scaled: it is the reference the land/sea
+    // floor is measured against.
+    earth: "#544E3E",
+    water: "#161D21",
+    river: "#141B20",
+    boundary: "#293135",
+    jurisdiction: "#867D64",
+    inlandWater: "#62717A",
+    // 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",
+    stateLabel: "#38342A",
+    stateHalo: "#867D64",
+    inlandShore: "#4D5B67",
+    inlandLabel: "#212629",
+    inlandHalo: "#62717A"
   },
   NIGHT: {
-    base: "#2a2620",
-    cover: { wood: "#242a20", wetland: "#232823", urban: "#2c2925", sand: "#302b22" },
-    contour: "#413b30",
-    contourIndex: "#524a3b",
-    road: "#332f27",
-    roadMajor: "#3d382d",
-    label: "#7d745e",
-    halo: "#15130f",
-    shadow: "#1a1712",
-    highlight: "#4a4436",
-    fade: "#07090b",
-    // ⚠ DELIBERATELY NOT RAISED. See the type's note: a strong hillshade
-    // under red night vision is a grey haze over exactly the contrast a
-    // skipper is navigating by. Left at the shipped value rather than
-    // lowered, because lowering it is a separate decision from this one.
-    exaggeration: 0.45
+    // ── Re-derived 2026-09-01 — the owner-reported night defect ──────────
+    // `jurisdiction` was L=0.240 against a chart whose own land (LANDA
+    // #3a3020) is L=0.031: the world basemap was 7.7x BRIGHTER than the chart
+    // it sits under, so at z<11 the uncharted interior read as a pale
+    // continent-sized slab on a night chart. Capped at the chart's own land.
+    //
+    // ⚠ `earth` AND `jurisdiction` CONVERGE HERE, and that is forced, not
+    // sloppy. Holding earth 2:1 above the ocean AND 2:1 below the jurisdiction
+    // tan requires jurisdiction >= L 0.174 — 5.6x the chart's own land. At
+    // night the range between the ocean (L 0.006) and the cap (L 0.031) is too
+    // compressed to carry two land tones. COVERAGE IS STILL SAID, by the
+    // `chrt:hatch-nocoverage` crosshatch, which is a stronger signal than tone
+    // and is the one thing that cannot be lost to palette compression.
+    //
+    // Labels invert to light-on-dark: 3:1 downward is unreachable off a halo
+    // this close to black, and CHRTland's own night town labels already sit at
+    // L=0.177 for exactly this reason.
+    earth: "#333026",
+    water: "#10161A",
+    river: "#090D0F",
+    boundary: "#131719",
+    jurisdiction: "#353128",
+    inlandWater: "#232A30",
+    stateLine: "#484236",
+    stateLabel: "#837963",
+    stateHalo: "#353128",
+    inlandShore: "#1C2227",
+    inlandLabel: "#617484",
+    inlandHalo: "#232A30"
   }
 };
-var FITS = ["<=", ["coalesce", ["get", "min_z"], 0], ["zoom"]];
-var ANCHOR = ["coalesce", ["get", "anchor"], "top"];
-var anchorOffset = (em) => [
-  "match",
-  ["get", "anchor"],
-  "left",
-  ["literal", [0.6, 0]],
-  "right",
-  ["literal", [-0.6, 0]],
-  "bottom",
-  ["literal", [0, -em]],
-  ["literal", [0, em]]
-];
-var FONT = ["Open Sans Regular"];
-var FONT_ITALIC = ["Open Sans Italic"];
-function landLayers(opts = {}) {
+function baseLayers(opts = {}) {
   const palette = opts.palette ?? "DAY";
-  const T = LAND_THEMES[palette] ?? LAND_THEMES.DAY;
-  const src = opts.sourceId ?? LAND_REGION;
-  const demSrc = opts.reliefSourceId ?? RELIEF_REGION;
+  const T = BASE_THEMES[palette] ?? BASE_THEMES.DAY;
+  const src = opts.sourceId ?? BASE_REGION;
   const L = (o) => o;
-  const layers = [
-    // 1. The land itself — LNDARE ∩ coverage, so it can never outrun the chart.
+  return [
+    // 1. Geography — the world as it is, in the quiet dark voice. The OCEAN
+    //    is a background, not a polygon: the archive ships land and lakes,
+    //    and "everything else is sea" is exactly what a background expresses
+    //    — geometry-free, gap-free at every antimeridian and pole. Without
+    //    it the sea outside coverage was bare S-52 NODTA, a light grey that
+    //    read as "charted ground" with a hatch on it.
     L({
-      id: "chrtland-base",
+      id: "chrtbase-ocean",
+      type: "background",
+      paint: { "background-color": T.water }
+    }),
+    L({
+      id: "chrtbase-earth",
       type: "fill",
       source: src,
-      "source-layer": "land_base",
-      paint: { "fill-color": T.base }
-    })
-  ];
-  layers.push(L({
-    id: "chrtland-cover",
-    type: "fill",
-    source: src,
-    "source-layer": "land_cover",
-    filter: ["<=", ["coalesce", ["get", "min_z"], 0], ["zoom"]],
-    paint: {
-      "fill-color": [
-        "match",
-        ["get", "class"],
-        "wood",
-        T.cover.wood,
-        "wetland",
-        T.cover.wetland,
-        "urban",
-        T.cover.urban,
-        "sand",
-        T.cover.sand,
-        T.base
-      ],
-      "fill-opacity": 0.85
-    }
-  }));
-  if (opts.relief) {
-    layers.push(L({
-      // No minzoom here: LAND_SURFACE_LAYERS floors it with the rest of the
-      // surface, so the two can never drift apart again.
-      id: "chrtland-hillshade",
-      type: "hillshade",
-      source: demSrc,
-      paint: {
-        "hillshade-exaggeration": T.exaggeration,
-        "hillshade-shadow-color": T.shadow,
-        "hillshade-highlight-color": T.highlight,
-        "hillshade-accent-color": T.shadow
-      }
-    }));
-  }
-  const isIndexContour = [
-    "any",
-    ["<=", ["coalesce", ["get", "index_z"], 99], ["zoom"]],
-    ["==", ["get", "is_index"], 1]
-  ];
-  layers.push(L({
-    id: "chrtland-contour",
-    type: "line",
-    source: src,
-    "source-layer": "land_contour",
-    filter: ["<=", ["coalesce", ["get", "min_z"], 0], ["zoom"]],
-    paint: {
-      "line-color": ["case", isIndexContour, T.contourIndex, T.contour],
-      "line-width": ["case", isIndexContour, 0.8, 0.4],
-      "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",
-    source: src,
-    "source-layer": "land_road",
-    minzoom: 10,
-    paint: {
-      "line-color": ["match", ["get", "kind"], "highway", T.roadMajor, T.road],
-      "line-width": [
-        "interpolate",
-        ["linear"],
-        ["zoom"],
-        10,
-        ["match", ["get", "kind"], "highway", 0.8, 0.4],
-        14,
-        ["match", ["get", "kind"], "highway", 2.4, 1.2]
-      ],
-      "line-opacity": 0.8
-    }
-  }));
-  layers.push(L({
-    id: "chrtland-city-major",
-    type: "symbol",
-    source: src,
-    "source-layer": "land_town",
-    minzoom: 6.5,
-    filter: [">=", ["coalesce", ["get", "prank"], 0], 10],
-    layout: {
-      "text-field": [
-        "case",
-        ["==", ["get", "upcase"], true],
-        ["upcase", ["get", "name"]],
-        ["get", "name"]
-      ],
-      "text-font": FONT,
-      "text-size": [
-        "interpolate",
-        ["linear"],
-        ["zoom"],
-        6.5,
-        11.5,
-        9,
-        ["+", 10, ["*", 0.4, ["coalesce", ["get", "prank"], 10]]],
-        13,
-        ["+", 13, ["*", 0.5, ["coalesce", ["get", "prank"], 10]]]
-      ],
-      "text-letter-spacing": ["case", ["==", ["get", "upcase"], true], 0.14, 0.02],
-      "text-offset": anchorOffset(0.75),
-      "text-anchor": ANCHOR,
-      "text-padding": 10,
-      "text-allow-overlap": false,
-      "symbol-sort-key": ["*", -1, ["coalesce", ["get", "pop"], 0]]
-    },
-    paint: { "text-color": T.label, "text-halo-color": T.halo, "text-halo-width": 1.6 }
-  }));
-  layers.push(L({
-    id: "chrtland-town-port",
-    type: "symbol",
-    source: src,
-    "source-layer": "land_town",
-    minzoom: 8.5,
-    filter: [
-      "all",
-      ["==", ["get", "enc_dup"], true],
-      ["<", ["coalesce", ["get", "prank"], 0], 10]
-    ],
-    layout: {
-      "text-field": ["get", "name"],
-      "text-font": FONT,
-      "text-size": ["interpolate", ["linear"], ["zoom"], 8.5, 11, 12, 13.5],
-      "text-offset": anchorOffset(0.75),
-      "text-anchor": ANCHOR,
-      "text-padding": 8,
-      "text-allow-overlap": false,
-      // Within the tier, the bigger place wins the space: without this the
-      // tie broke on data order and "West Gloucester" beat Gloucester.
-      "symbol-sort-key": ["*", -1, ["coalesce", ["get", "pop"], 0]]
-    },
-    paint: { "text-color": T.label, "text-halo-color": T.halo, "text-halo-width": 1.4 }
-  }));
-  layers.push(L({
-    id: "chrtland-town",
-    type: "symbol",
-    source: src,
-    "source-layer": "land_town",
-    minzoom: 9,
-    filter: [
-      "all",
-      FITS,
-      ["<", ["coalesce", ["get", "prank"], 0], 10],
-      ["!=", ["get", "enc_dup"], true]
-    ],
-    layout: {
-      "text-field": [
-        "case",
-        ["==", ["get", "upcase"], true],
-        ["upcase", ["get", "name"]],
-        ["get", "name"]
-      ],
-      "text-font": FONT,
-      "text-size": ["interpolate", ["linear"], ["zoom"], 9, 10, 14, 13.5],
-      "text-letter-spacing": ["case", ["==", ["get", "upcase"], true], 0.14, 0],
-      "text-offset": anchorOffset(0.75),
-      "text-anchor": ANCHOR,
-      "text-padding": 6,
-      "text-allow-overlap": false,
-      "symbol-sort-key": 2
-    },
-    paint: { "text-color": T.label, "text-halo-color": T.halo, "text-halo-width": 1.2 }
-  }));
-  layers.push(L({
-    id: "chrtland-summit",
-    type: "symbol",
-    source: src,
-    "source-layer": "land_summit",
-    minzoom: 11.5,
-    filter: ["all", FITS, [">=", ["get", "peak_m"], 40]],
-    layout: {
-      "text-field": ["concat", ["get", "name"], "\n", ["to-string", ["get", "peak_m"]], " m"],
-      "text-font": FONT,
-      "text-size": ["interpolate", ["linear"], ["zoom"], 11.5, 8.5, 14, 11],
-      "text-offset": anchorOffset(0.8),
-      "text-anchor": ANCHOR,
-      "text-padding": 5,
-      "text-allow-overlap": false,
-      "symbol-sort-key": 3
-    },
-    paint: { "text-color": T.label, "text-halo-color": T.halo, "text-halo-width": 1.2 }
-  }));
-  layers.push(L({
-    id: "chrtland-poi",
-    type: "symbol",
-    source: src,
-    "source-layer": "land_poi",
-    minzoom: 13,
-    filter: FITS,
-    layout: {
-      "text-field": ["get", "name"],
-      "text-font": FONT_ITALIC,
-      "text-size": ["interpolate", ["linear"], ["zoom"], 13, 8, 14, 9.5],
-      "text-offset": anchorOffset(0.7),
-      "text-anchor": ANCHOR,
-      "text-padding": 5,
-      "text-allow-overlap": false,
-      "symbol-sort-key": 5
-    },
-    paint: { "text-color": T.label, "text-halo-color": T.halo, "text-halo-width": 1.2 }
-  }));
-  for (const layer of layers) {
-    const l = layer;
-    if (!LAND_SURFACE_LAYERS(l.id)) continue;
-    l.minzoom = Math.max(l.minzoom ?? 0, LAND_SURFACE_MINZOOM);
-  }
-  return layers;
-}
-
-// src/atlas/base-layers.ts
-var NOCOVERAGE_PATTERN = "chrt:hatch-nocoverage";
-var UNCHARTED_PATTERN = "chrt:hatch-uncharted";
-var BASE_THEMES = {
-  DAY: {
-    // ── `earth` is the jurisdiction tan DIMMED (~0.55), not a blue-grey ──
-    // Outside the jurisdiction the map still owes the reader "what is land".
-    // State 3 in the header is "the geography, under a crosshatch", and until
-    // 2026-08-31 that geography was unreadable: earth #2A3439 against sea
-    // #1B2328 measured 1.25:1, so Hispaniola showed charted boxes with tan
-    // land inside and nothing recognisable around them (owner report: "no
-    // land painting down near the DR at some zooms"). Land is warm and sea is
-    // cool because that is what land and sea are; dimming the JURISDICTION
-    // tan rather than inventing a colour says the true thing — this is the
-    // same land, we simply do not carry charts for it. Held against BOTH
-    // neighbours: legible over sea, and never mistakable for the full tan of
-    // a country we do carry. DAY 3.59:1 vs sea, 3.17:1 vs tan.
-    earth: "#807761",
-    water: "#1B2328",
-    river: "#24313A",
-    boundary: "#4A575E",
-    jurisdiction: "#E8D9B0",
-    // CHRTland's own tan — one land colour
-    inlandWater: "#B9CFDD",
-    // muted, unmistakably not a charted blue
-    // 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
-    // a shade deeper than the tan, quiet caps, tan halo.
-    stateLine: "#C4B389",
-    stateLabel: "#8E8468",
-    stateHalo: "#E8D9B0",
-    // Rough-lake furniture (owner ask 2026-08-28: "the lakes need labels,
-    // and shorelines drawn"): a shoreline a shade deeper than the rough
-    // water, and a name in the water's own voice, haloed by the water.
-    inlandShore: "#8FA9BA",
-    inlandLabel: "#54707F",
-    inlandHalo: "#B9CFDD"
-  },
-  DUSK: {
-    // ── Re-derived 2026-09-01: the basemap sits UNDER the chart ──────────
-    // These were the DAY tones scaled by a constant, never measured against
-    // the DUSK chart — so `jurisdiction` came out at L=0.506 against a chart
-    // whose own land (LANDA #8a7d5e) is L=0.209, i.e. the context layer was
-    // 2.4x brighter than the data layer. Now capped at the chart's own land.
-    // The rest of the block rides the same 0.666 channel factor so every
-    // relationship the palette already chose is preserved, only moved down.
-    // `water` is deliberately NOT scaled: it is the reference the land/sea
-    // floor is measured against.
-    earth: "#544E3E",
-    water: "#161D21",
-    river: "#141B20",
-    boundary: "#293135",
-    jurisdiction: "#867D64",
-    inlandWater: "#62717A",
-    // 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",
-    stateLabel: "#38342A",
-    stateHalo: "#867D64",
-    inlandShore: "#4D5B67",
-    inlandLabel: "#212629",
-    inlandHalo: "#62717A"
-  },
-  NIGHT: {
-    // ── Re-derived 2026-09-01 — the owner-reported night defect ──────────
-    // `jurisdiction` was L=0.240 against a chart whose own land (LANDA
-    // #3a3020) is L=0.031: the world basemap was 7.7x BRIGHTER than the chart
-    // it sits under, so at z<11 the uncharted interior read as a pale
-    // continent-sized slab on a night chart. Capped at the chart's own land.
-    //
-    // ⚠ `earth` AND `jurisdiction` CONVERGE HERE, and that is forced, not
-    // sloppy. Holding earth 2:1 above the ocean AND 2:1 below the jurisdiction
-    // tan requires jurisdiction >= L 0.174 — 5.6x the chart's own land. At
-    // night the range between the ocean (L 0.006) and the cap (L 0.031) is too
-    // compressed to carry two land tones. COVERAGE IS STILL SAID, by the
-    // `chrt:hatch-nocoverage` crosshatch, which is a stronger signal than tone
-    // and is the one thing that cannot be lost to palette compression.
-    //
-    // Labels invert to light-on-dark: 3:1 downward is unreachable off a halo
-    // this close to black, and CHRTland's own night town labels already sit at
-    // L=0.177 for exactly this reason.
-    earth: "#333026",
-    water: "#10161A",
-    river: "#090D0F",
-    boundary: "#131719",
-    jurisdiction: "#353128",
-    inlandWater: "#232A30",
-    stateLine: "#484236",
-    stateLabel: "#837963",
-    stateHalo: "#353128",
-    inlandShore: "#1C2227",
-    inlandLabel: "#617484",
-    inlandHalo: "#232A30"
-  }
-};
-function baseLayers(opts = {}) {
-  const palette = opts.palette ?? "DAY";
-  const T = BASE_THEMES[palette] ?? BASE_THEMES.DAY;
-  const src = opts.sourceId ?? BASE_REGION;
-  const L = (o) => o;
-  return [
-    // 1. Geography — the world as it is, in the quiet dark voice. The OCEAN
-    //    is a background, not a polygon: the archive ships land and lakes,
-    //    and "everything else is sea" is exactly what a background expresses
-    //    — geometry-free, gap-free at every antimeridian and pole. Without
-    //    it the sea outside coverage was bare S-52 NODTA, a light grey that
-    //    read as "charted ground" with a hatch on it.
-    L({
-      id: "chrtbase-ocean",
-      type: "background",
-      paint: { "background-color": T.water }
-    }),
-    L({
-      id: "chrtbase-earth",
-      type: "fill",
-      source: src,
-      "source-layer": "base_earth",
-      paint: { "fill-color": T.earth }
-    }),
-    L({
-      id: "chrtbase-water",
-      type: "fill",
-      source: src,
-      "source-layer": "base_water",
-      paint: { "fill-color": T.water }
-    }),
-    L({
-      id: "chrtbase-river",
+      "source-layer": "base_earth",
+      paint: { "fill-color": T.earth }
+    }),
+    L({
+      id: "chrtbase-water",
+      type: "fill",
+      source: src,
+      "source-layer": "base_water",
+      paint: { "fill-color": T.water }
+    }),
+    L({
+      id: "chrtbase-river",
       type: "line",
       source: src,
       "source-layer": "base_river",
@@ -29568,32 +29251,360 @@ function baseInlandWaterLayers(opts = {}) {
       }
     }),
     L({
-      id: "chrtbase-inland-label",
-      type: "symbol",
+      id: "chrtbase-inland-label",
+      type: "symbol",
+      source: src,
+      "source-layer": "inland_water_label",
+      minzoom: 5,
+      layout: {
+        "text-field": ["get", "name"],
+        "text-font": ["Open Sans Regular"],
+        "text-size": ["interpolate", ["linear"], ["zoom"], 5, 9.5, 10, 12],
+        "text-max-width": 7,
+        "text-allow-overlap": false,
+        // Zoom-scaled spacing for the anchor GRID: at z8.9 the 0.08-deg
+        // anchors sit ~54 px apart and a flat padding let six copies of
+        // "Lake Ontario" crowd one screen (owner-reported 2026-08-30).
+        // Wide collision boxes at low zoom thin the grid to the repeat-
+        // by-convention cadence; by z12 the anchors are ~850 px apart and
+        // the padding relaxes to normal.
+        "text-padding": ["interpolate", ["linear"], ["zoom"], 5, 80, 9, 64, 12, 16]
+      },
+      paint: {
+        "text-color": T.inlandLabel,
+        "text-halo-color": T.inlandHalo,
+        "text-halo-width": 1.1
+      }
+    })
+  ];
+}
+
+// src/atlas/land-layers.ts
+var LAND_SURFACE_MINZOOM = BAND_PRIORITY_RANGES["5"].minzoom;
+var LAND_SURFACE_LAYERS = (id) => id === "chrtland-base" || id === "chrtland-cover" || id === "chrtland-contour" || id === "chrtland-hillshade" || id === "chrtland-water" || id.startsWith("chrtland-fade-");
+var isLandGroundOverlay = (id) => LAND_SURFACE_LAYERS(id) && id !== "chrtland-base" || id === "chrtland-road";
+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));
+}
+function landBaseColor(palette) {
+  return (LAND_THEMES[palette] ?? LAND_THEMES.DAY).base;
+}
+var LAND_THEMES = {
+  DAY: {
+    base: "#d4c69d",
+    cover: { wood: "#bcc5a1", wetland: "#b6c0b1", urban: "#cac6bf", sand: "#dbd0af" },
+    contour: "#958666",
+    contourIndex: "#78694b",
+    road: "#c5b691",
+    roadMajor: "#beaa7c",
+    label: "#5b4f3a",
+    halo: "#ded6c3",
+    shadow: "#6b5a3e",
+    highlight: "#fffaf0",
+    fade: "#e8f2f8",
+    // Raised from 0.45 on 2026-08-23. ⚠ Above the ~0.5 that
+    // hillshade-style.mjs warns "starts competing with depth areas" — a
+    // deliberate, sighted choice made against rendered evidence, not a
+    // default. If soundings or DEPARE ever read as fighting the terrain,
+    // this number is the first thing to walk back.
+    exaggeration: 0.8
+  },
+  DUSK: {
+    base: "#4a4433",
+    cover: { wood: "#414a38", wetland: "#3f4740", urban: "#4e4a42", sand: "#544c39" },
+    contour: "#6b6250",
+    contourIndex: "#837961",
+    road: "#565040",
+    roadMajor: "#63594440",
+    label: "#c3b898",
+    halo: "#2b2820",
+    shadow: "#2e2a20",
+    highlight: "#8a8068",
+    fade: "#16202a",
+    // Unchanged. DUSK was not the palette the 0.8 decision was made against.
+    exaggeration: 0.45
+  },
+  NIGHT: {
+    base: "#2a2620",
+    cover: { wood: "#242a20", wetland: "#232823", urban: "#2c2925", sand: "#302b22" },
+    contour: "#413b30",
+    contourIndex: "#524a3b",
+    road: "#332f27",
+    roadMajor: "#3d382d",
+    label: "#7d745e",
+    halo: "#15130f",
+    shadow: "#1a1712",
+    highlight: "#4a4436",
+    fade: "#07090b",
+    // ⚠ DELIBERATELY NOT RAISED. See the type's note: a strong hillshade
+    // under red night vision is a grey haze over exactly the contrast a
+    // skipper is navigating by. Left at the shipped value rather than
+    // lowered, because lowering it is a separate decision from this one.
+    exaggeration: 0.45
+  }
+};
+var FITS = ["<=", ["coalesce", ["get", "min_z"], 0], ["zoom"]];
+var ANCHOR = ["coalesce", ["get", "anchor"], "top"];
+var anchorOffset = (em) => [
+  "match",
+  ["get", "anchor"],
+  "left",
+  ["literal", [0.6, 0]],
+  "right",
+  ["literal", [-0.6, 0]],
+  "bottom",
+  ["literal", [0, -em]],
+  ["literal", [0, em]]
+];
+var FONT = ["Open Sans Regular"];
+var FONT_ITALIC = ["Open Sans Italic"];
+function landLayers(opts = {}) {
+  const palette = opts.palette ?? "DAY";
+  const T = LAND_THEMES[palette] ?? LAND_THEMES.DAY;
+  const src = opts.sourceId ?? LAND_REGION;
+  const demSrc = opts.reliefSourceId ?? RELIEF_REGION;
+  const L = (o) => o;
+  const layers = [
+    // 1. The land itself — LNDARE ∩ coverage, so it can never outrun the chart.
+    L({
+      id: "chrtland-base",
+      type: "fill",
       source: src,
-      "source-layer": "inland_water_label",
-      minzoom: 5,
-      layout: {
-        "text-field": ["get", "name"],
-        "text-font": ["Open Sans Regular"],
-        "text-size": ["interpolate", ["linear"], ["zoom"], 5, 9.5, 10, 12],
-        "text-max-width": 7,
-        "text-allow-overlap": false,
-        // Zoom-scaled spacing for the anchor GRID: at z8.9 the 0.08-deg
-        // anchors sit ~54 px apart and a flat padding let six copies of
-        // "Lake Ontario" crowd one screen (owner-reported 2026-08-30).
-        // Wide collision boxes at low zoom thin the grid to the repeat-
-        // by-convention cadence; by z12 the anchors are ~850 px apart and
-        // the padding relaxes to normal.
-        "text-padding": ["interpolate", ["linear"], ["zoom"], 5, 80, 9, 64, 12, 16]
-      },
+      "source-layer": "land_base",
+      paint: { "fill-color": T.base }
+    })
+  ];
+  layers.push(L({
+    id: "chrtland-cover",
+    type: "fill",
+    source: src,
+    "source-layer": "land_cover",
+    filter: ["<=", ["coalesce", ["get", "min_z"], 0], ["zoom"]],
+    paint: {
+      "fill-color": [
+        "match",
+        ["get", "class"],
+        "wood",
+        T.cover.wood,
+        "wetland",
+        T.cover.wetland,
+        "urban",
+        T.cover.urban,
+        "sand",
+        T.cover.sand,
+        T.base
+      ],
+      "fill-opacity": 0.85
+    }
+  }));
+  if (opts.relief) {
+    layers.push(L({
+      // No minzoom here: LAND_SURFACE_LAYERS floors it with the rest of the
+      // surface, so the two can never drift apart again.
+      id: "chrtland-hillshade",
+      type: "hillshade",
+      source: demSrc,
       paint: {
-        "text-color": T.inlandLabel,
-        "text-halo-color": T.inlandHalo,
-        "text-halo-width": 1.1
+        "hillshade-exaggeration": T.exaggeration,
+        "hillshade-shadow-color": T.shadow,
+        "hillshade-highlight-color": T.highlight,
+        "hillshade-accent-color": T.shadow
       }
-    })
+    }));
+  }
+  const isIndexContour = [
+    "any",
+    ["<=", ["coalesce", ["get", "index_z"], 99], ["zoom"]],
+    ["==", ["get", "is_index"], 1]
   ];
+  layers.push(L({
+    id: "chrtland-contour",
+    type: "line",
+    source: src,
+    "source-layer": "land_contour",
+    filter: ["<=", ["coalesce", ["get", "min_z"], 0], ["zoom"]],
+    paint: {
+      "line-color": ["case", isIndexContour, T.contourIndex, T.contour],
+      "line-width": ["case", isIndexContour, 0.8, 0.4],
+      "line-opacity": 0.7
+    }
+  }));
+  layers.push(L({
+    id: "chrtland-water",
+    type: "fill",
+    source: src,
+    "source-layer": "land_water",
+    filter: ["<=", ["coalesce", ["get", "min_z"], 0], ["zoom"]],
+    paint: { "fill-color": inlandWaterColor(palette) }
+  }));
+  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",
+    source: src,
+    "source-layer": "land_road",
+    minzoom: 10,
+    paint: {
+      "line-color": ["match", ["get", "kind"], "highway", T.roadMajor, T.road],
+      "line-width": [
+        "interpolate",
+        ["linear"],
+        ["zoom"],
+        10,
+        ["match", ["get", "kind"], "highway", 0.8, 0.4],
+        14,
+        ["match", ["get", "kind"], "highway", 2.4, 1.2]
+      ],
+      "line-opacity": 0.8
+    }
+  }));
+  layers.push(L({
+    id: "chrtland-city-major",
+    type: "symbol",
+    source: src,
+    "source-layer": "land_town",
+    minzoom: 6.5,
+    filter: [">=", ["coalesce", ["get", "prank"], 0], 10],
+    layout: {
+      "text-field": [
+        "case",
+        ["==", ["get", "upcase"], true],
+        ["upcase", ["get", "name"]],
+        ["get", "name"]
+      ],
+      "text-font": FONT,
+      "text-size": [
+        "interpolate",
+        ["linear"],
+        ["zoom"],
+        6.5,
+        11.5,
+        9,
+        ["+", 10, ["*", 0.4, ["coalesce", ["get", "prank"], 10]]],
+        13,
+        ["+", 13, ["*", 0.5, ["coalesce", ["get", "prank"], 10]]]
+      ],
+      "text-letter-spacing": ["case", ["==", ["get", "upcase"], true], 0.14, 0.02],
+      "text-offset": anchorOffset(0.75),
+      "text-anchor": ANCHOR,
+      "text-padding": 10,
+      "text-allow-overlap": false,
+      "symbol-sort-key": ["*", -1, ["coalesce", ["get", "pop"], 0]]
+    },
+    paint: { "text-color": T.label, "text-halo-color": T.halo, "text-halo-width": 1.6 }
+  }));
+  layers.push(L({
+    id: "chrtland-town-port",
+    type: "symbol",
+    source: src,
+    "source-layer": "land_town",
+    minzoom: 8.5,
+    filter: [
+      "all",
+      ["==", ["get", "enc_dup"], true],
+      ["<", ["coalesce", ["get", "prank"], 0], 10]
+    ],
+    layout: {
+      "text-field": ["get", "name"],
+      "text-font": FONT,
+      "text-size": ["interpolate", ["linear"], ["zoom"], 8.5, 11, 12, 13.5],
+      "text-offset": anchorOffset(0.75),
+      "text-anchor": ANCHOR,
+      "text-padding": 8,
+      "text-allow-overlap": false,
+      // Within the tier, the bigger place wins the space: without this the
+      // tie broke on data order and "West Gloucester" beat Gloucester.
+      "symbol-sort-key": ["*", -1, ["coalesce", ["get", "pop"], 0]]
+    },
+    paint: { "text-color": T.label, "text-halo-color": T.halo, "text-halo-width": 1.4 }
+  }));
+  layers.push(L({
+    id: "chrtland-town",
+    type: "symbol",
+    source: src,
+    "source-layer": "land_town",
+    minzoom: 9,
+    filter: [
+      "all",
+      FITS,
+      ["<", ["coalesce", ["get", "prank"], 0], 10],
+      ["!=", ["get", "enc_dup"], true]
+    ],
+    layout: {
+      "text-field": [
+        "case",
+        ["==", ["get", "upcase"], true],
+        ["upcase", ["get", "name"]],
+        ["get", "name"]
+      ],
+      "text-font": FONT,
+      "text-size": ["interpolate", ["linear"], ["zoom"], 9, 10, 14, 13.5],
+      "text-letter-spacing": ["case", ["==", ["get", "upcase"], true], 0.14, 0],
+      "text-offset": anchorOffset(0.75),
+      "text-anchor": ANCHOR,
+      "text-padding": 6,
+      "text-allow-overlap": false,
+      "symbol-sort-key": 2
+    },
+    paint: { "text-color": T.label, "text-halo-color": T.halo, "text-halo-width": 1.2 }
+  }));
+  layers.push(L({
+    id: "chrtland-summit",
+    type: "symbol",
+    source: src,
+    "source-layer": "land_summit",
+    minzoom: 11.5,
+    filter: ["all", FITS, [">=", ["get", "peak_m"], 40]],
+    layout: {
+      "text-field": ["concat", ["get", "name"], "\n", ["to-string", ["get", "peak_m"]], " m"],
+      "text-font": FONT,
+      "text-size": ["interpolate", ["linear"], ["zoom"], 11.5, 8.5, 14, 11],
+      "text-offset": anchorOffset(0.8),
+      "text-anchor": ANCHOR,
+      "text-padding": 5,
+      "text-allow-overlap": false,
+      "symbol-sort-key": 3
+    },
+    paint: { "text-color": T.label, "text-halo-color": T.halo, "text-halo-width": 1.2 }
+  }));
+  layers.push(L({
+    id: "chrtland-poi",
+    type: "symbol",
+    source: src,
+    "source-layer": "land_poi",
+    minzoom: 13,
+    filter: FITS,
+    layout: {
+      "text-field": ["get", "name"],
+      "text-font": FONT_ITALIC,
+      "text-size": ["interpolate", ["linear"], ["zoom"], 13, 8, 14, 9.5],
+      "text-offset": anchorOffset(0.7),
+      "text-anchor": ANCHOR,
+      "text-padding": 5,
+      "text-allow-overlap": false,
+      "symbol-sort-key": 5
+    },
+    paint: { "text-color": T.label, "text-halo-color": T.halo, "text-halo-width": 1.2 }
+  }));
+  for (const layer of layers) {
+    const l = layer;
+    if (!LAND_SURFACE_LAYERS(l.id)) continue;
+    l.minzoom = Math.max(l.minzoom ?? 0, LAND_SURFACE_MINZOOM);
+  }
+  return layers;
 }
 
 // src/atlas/band-collapse.ts