@chrtco/sdk 0.10.46 → 0.10.48

package/CHANGELOG.md

@@ -5,6 +5,28 @@ All notable changes to `@chrtco/sdk` will be documented in this file.
 ## [Unreleased]
 
 ### Added
+- **`EINK_NIGHT`** — the e-ink night palette (`theme=eink_night`, offline `palette=EINK_NIGHT`,
+  `EINK_COLOR_TABLES.night`): `EINK_MONO`'s four greys on a black page, for any e-ink screen at
+  night with the front light on, in place of red night. Water black; lines and labels `#aaaaaa`;
+  only the safety contour, dangers, lights, shoal soundings and white marks white; land `#555555`;
+  depth patterns drawn light; the chart background crosshatched so no-data never reads as black safe
+  water. `isEinkGreyTable` (mono or night), `S52_EINK_NIGHT`. In every e-ink palette, label halos
+  are now the page's own ground (`UIBCK`).
+- **E-ink chart palettes: `EINK_COLOR` and `EINK_MONO`.** Two new `ColorTableName`s for
+  reflective e-ink screens — colour e-ink (E Ink Kaleido 3) and monochrome e-ink — usable
+  everywhere a palette is: `chrt.style({ palette: 'EINK_MONO' })`, `chrt.styleUrl({ theme:
+  'eink_mono' })` (`ChrtStyleTheme` gains `eink_color` / `eink_mono`), the offline style
+  (`palette: 'EINK_COLOR' | 'EINK_MONO'`), and every symbol-image loader. Same features, classes
+  and priorities as `DAY`; `generateStyle` runs an e-ink portrayal pass for them
+  (`applyEinkPortrayal`): lines ×1.5, text ×1.15 on paper halos, a heavy safety-contour line
+  (`safetyContourValues`), danger symbols ×1.35 and cross-hatched danger areas, depth in at most
+  four steps (mono: by fill pattern), no translucent washes, hillshade, glows or transitions.
+  `EINK_MONO` paints only the four `EINK_MONO_GREYS`. New exports: `EINK_COLOR_TABLES`,
+  `isEinkColorTable`, `EINK_MONO_GREYS`, `S52_EINK_COLOR`, `S52_EINK_MONO`,
+  `applyEinkPortrayal`, `safetyContourValues`, and the three pattern ids. The world-hatch image set
+  (`basePatternImageSpecs` / `loadBasePatternImages`) gains the three e-ink fill patterns in every
+  palette. `normalizeTheme` accepts `-` for `_`, and `resolveCustomTheme` serves the e-ink themes
+  even when a custom style has narrowed its palettes.
 - **`isMapLive(map)`** — `false` once MapLibre's `map.remove()` has run (it
   reads the `_removed` flag `remove()` sets last). After `remove()`, `hasImage`,
   `addImage`, `getSource` and their siblings throw, so anything that awaits and

package/README.md

@@ -150,7 +150,7 @@ const chrt = new Chrt(process.env.CHRT_API_KEY!);
 // Locally generated style — no network, no custom style applied.
 const map = new maplibregl.Map({
   container: 'map',
-  style: chrt.style({ palette: 'DAY' }),   // 'DAY' | 'DUSK' | 'NIGHT'
+  style: chrt.style({ palette: 'DAY' }),   // 'DAY' | 'DUSK' | 'NIGHT' | 'EINK_COLOR' | 'EINK_MONO' | 'EINK_NIGHT'
   center: [-70.25, 43.66],
   zoom: 12,
   transformRequest: chrt.transformRequest(),
@@ -162,7 +162,7 @@ Or use the **served** style, which honours the CHRTstyle custom style bound to y
 ```typescript
 const map = new maplibregl.Map({
   container: 'map',
-  style: await chrt.styleUrl({ theme: 'dusk' }),   // 'day' | 'dusk' | 'night'
+  style: await chrt.styleUrl({ theme: 'dusk' }),   // 'day' | 'dusk' | 'night' | 'eink_color' | 'eink_mono' | 'eink_night'
   transformRequest: chrt.transformRequest(),       // required — authenticates the style request too
 });
 ```
@@ -174,14 +174,37 @@ Tiles are served from `tiles.chrt.co` and gated by a short-lived ES256 JWT. The
 your key, attaches it as `Authorization: Bearer`, and refreshes it before expiry — you never handle
 tokens directly.
 
+### E-ink screens
+
+Three palettes are for reflective e-ink (e-paper) screens, on every plan: **`EINK_COLOR`** for colour
+e-ink (E Ink Kaleido 3 — Boox Note Air C, Go Color 7, Tab X C), **`EINK_MONO`** for monochrome
+e-ink panels and monitors, or colour e-ink run in black and white, and **`EINK_NIGHT`** for any e-ink
+screen at night with the front light on (mono inverted onto a black page, so the lit area stays
+small — use it instead of a red night palette). Same features and meaning as
+`DAY`; drawn for paper: black ink, heavier lines, a heavy safety-contour line, larger danger
+symbols, depth in at most four steps (by fill pattern in mono, which uses only four greys), and no
+translucency or transitions.
+
+```typescript
+import { EINK_COLOR_TABLES } from '@chrtco/sdk';   // { color, mono, night }
+
+chrt.style({ palette: EINK_COLOR_TABLES.mono });    // local
+await chrt.styleUrl({ theme: 'eink_mono' });        // served (wire names are lowercase)
+```
+
+A locally generated e-ink style also needs `loadBasePatternImages(map, palette)` from
+`@chrtco/sdk/atlas/browser` (the fill patterns); a served style declares its own sprite. Use these
+rather than recolouring the chart, and set MapLibre's `fadeDuration: 0` — renderer animation is a
+client setting the style cannot turn off.
+
 ### Symbol families
 
 `style()`, `styleUrl()` and `fetchStyle()` all select symbol artwork, but **the option is spelled
 differently** on the local and served paths:
 
 ```typescript
-chrt.style({ symbolSet: 's101' });      // local  — symbolSet, palette: 'DAY' | 'DUSK' | 'NIGHT'
-await chrt.styleUrl({ symbols: 's101' }); // served — symbols,   theme:   'day' | 'dusk' | 'night'
+chrt.style({ symbolSet: 's101' });      // local  — symbolSet, palette: 'DAY' | 'DUSK' | 'NIGHT' | 'EINK_COLOR' | 'EINK_MONO' | 'EINK_NIGHT'
+await chrt.styleUrl({ symbols: 's101' }); // served — symbols,   theme:   'day' | 'dusk' | 'night' | 'eink_color' | 'eink_mono' | 'eink_night'
 ```
 
 | Value | Artwork |
@@ -482,14 +505,14 @@ valid — passing an agency name anywhere else silently matches nothing.
 ### `chrt.style(opts?)` — **JS-only**
 Returns a ready-to-use MapLibre/Mapbox GL **S-52** style object. Generated locally: no network, works
 offline, and **does not apply a custom style bound to your key**. Options: `palette`
-(`'DAY' | 'DUSK' | 'NIGHT'`), `symbolSet`, `region`, `depthUnits`, `safetyContour`, `chartMode`, plus
+(`'DAY' | 'DUSK' | 'NIGHT' | 'EINK_COLOR' | 'EINK_MONO' | 'EINK_NIGHT'`), `symbolSet`, `region`, `depthUnits`, `safetyContour`, `chartMode`, plus
 the other atlas style options. Non-JS clients want `styleUrl()` instead.
 
 ### `chrt.styleUrl(opts?)`
 URL of the **served** S-52 style — the CHRTstyle Style API at
 `{tileBaseUrl}/v1/styles/{region}/style.json`. `async`: it pre-mints the tile token so the style
 request (which MapLibre does not retry) carries auth. Options: `theme`
-(`'day' | 'dusk' | 'night'`), `symbols`. Always pair with `transformRequest()`.
+(`'day' | 'dusk' | 'night' | 'eink_color' | 'eink_mono' | 'eink_night'`), `symbols`. Always pair with `transformRequest()`.
 
 The served document honours the CHRTstyle custom style bound to your key (a **Dev+** feature; Free
 keys and keys with no bound style get the default themes). This is the style path for any client that

package/dist/atlas/browser.cjs

@@ -48,6 +48,12 @@ __export(browser_exports, {
 module.exports = __toCommonJS(browser_exports);
 
 // src/atlas/s52-colors.ts
+var EINK_MONO_GREYS = {
+  INK: "#000000",
+  DARK: "#555555",
+  MID: "#aaaaaa",
+  PAPER: "#ffffff"
+};
 var S52_DAY = {
   // Depth
   NODTA: "#a4a4a4",
@@ -328,10 +334,234 @@ var S52_NIGHT = {
   RES02: "#383028",
   RES03: "#383028"
 };
+var S52_EINK_COLOR = {
+  NODTA: "#b4b4b4",
+  DEPIT: "#4f8f3a",
+  DEPVS: "#74ade0",
+  DEPMS: "#bad6ef",
+  DEPMD: "#ffffff",
+  DEPDW: "#ffffff",
+  LANDA: "#f2e2b0",
+  LANDF: "#c49a4a",
+  CHBRN: "#8b5a2b",
+  CHGRF: "#9a9a9a",
+  CHGRD: "#444444",
+  CHBLK: "#000000",
+  CSTLN: "#000000",
+  OUTLW: "#000000",
+  BKAJ1: "#333333",
+  TRFCD: "#c800c8",
+  TRFCF: "#c800c8",
+  RESBL: "#0050c8",
+  APTS1: "#c800c8",
+  DNGHL: "#e00000",
+  ISHDG: "#e00000",
+  LITRD: "#e00000",
+  LITGN: "#00a000",
+  LITYW: "#f0c000",
+  LITWT: "#ffffff",
+  LITBL: "#0050c8",
+  LITOR: "#f07000",
+  RADHI: "#00a000",
+  RADLO: "#006000",
+  PLRTE: "#e00000",
+  ARPAT: "#008040",
+  ISDNG: "#c800c8",
+  CHRED: "#e00000",
+  CHGRN: "#00a000",
+  CHYLW: "#f0c000",
+  CHMGD: "#c800c8",
+  CHMGF: "#c800c8",
+  CHWHT: "#ffffff",
+  CHCOR: "#f07000",
+  // Deeper-than-safety soundings: dark grey, the one secondary ink. Shoal
+  // soundings are black — the louder numeral, as in every other table.
+  SNDG1: "#555555",
+  SNDG2: "#000000",
+  DEPSC: "#000000",
+  DEPCN: "#555555",
+  UINFD: "#000000",
+  UINFF: "#555555",
+  UINFR: "#e00000",
+  UINFG: "#00a000",
+  UINFO: "#f07000",
+  UINFB: "#0050c8",
+  UINFM: "#c800c8",
+  UIBCK: "#ffffff",
+  UIBDR: "#555555",
+  UIAFD: "#74ade0",
+  UIAFF: "#c49a4a",
+  PIPLN: "#008000",
+  OUTLL: "#c49a4a",
+  SCLBR: "#f07000",
+  NINFO: "#f07000",
+  ADINF: "#b08800",
+  RESGR: "#555555",
+  SHIPS: "#000000",
+  PSTRK: "#000000",
+  SYTRK: "#555555",
+  APLRT: "#f07000",
+  CURSR: "#f07000",
+  BKAJ2: "#000000",
+  RES01: "#808080",
+  RES02: "#808080",
+  RES03: "#808080"
+};
+var M = EINK_MONO_GREYS;
+var S52_EINK_MONO = {
+  // No data is DARK, never the land tone: a no-data edge in the land tone
+  // reads as a coastline (seen on the Boston render, 2026-10-05).
+  NODTA: M.DARK,
+  DEPIT: M.PAPER,
+  DEPVS: M.PAPER,
+  DEPMS: M.PAPER,
+  DEPMD: M.PAPER,
+  DEPDW: M.PAPER,
+  LANDA: M.MID,
+  LANDF: M.DARK,
+  CHBRN: M.DARK,
+  CHGRF: M.MID,
+  CHGRD: M.DARK,
+  CHBLK: M.INK,
+  CSTLN: M.INK,
+  OUTLW: M.INK,
+  BKAJ1: M.DARK,
+  TRFCD: M.INK,
+  TRFCF: M.INK,
+  RESBL: M.INK,
+  APTS1: M.INK,
+  DNGHL: M.INK,
+  ISHDG: M.INK,
+  LITRD: M.INK,
+  LITGN: M.INK,
+  LITYW: M.INK,
+  LITWT: M.PAPER,
+  LITBL: M.INK,
+  LITOR: M.INK,
+  RADHI: M.INK,
+  RADLO: M.DARK,
+  PLRTE: M.INK,
+  ARPAT: M.INK,
+  ISDNG: M.INK,
+  CHRED: M.DARK,
+  CHGRN: M.MID,
+  CHYLW: M.MID,
+  CHMGD: M.INK,
+  CHMGF: M.INK,
+  CHWHT: M.PAPER,
+  CHCOR: M.MID,
+  SNDG1: M.DARK,
+  SNDG2: M.INK,
+  DEPSC: M.INK,
+  DEPCN: M.DARK,
+  UINFD: M.INK,
+  UINFF: M.DARK,
+  UINFR: M.INK,
+  UINFG: M.INK,
+  UINFO: M.INK,
+  UINFB: M.INK,
+  UINFM: M.INK,
+  UIBCK: M.PAPER,
+  UIBDR: M.DARK,
+  UIAFD: M.MID,
+  UIAFF: M.MID,
+  PIPLN: M.INK,
+  OUTLL: M.DARK,
+  SCLBR: M.INK,
+  NINFO: M.INK,
+  ADINF: M.DARK,
+  RESGR: M.DARK,
+  SHIPS: M.INK,
+  PSTRK: M.INK,
+  SYTRK: M.DARK,
+  APLRT: M.INK,
+  CURSR: M.INK,
+  BKAJ2: M.INK,
+  RES01: M.DARK,
+  RES02: M.DARK,
+  RES03: M.DARK
+};
+var N = { GROUND: M.INK, DIM: M.DARK, LINE: M.MID, BRIGHT: M.PAPER };
+var S52_EINK_NIGHT = {
+  NODTA: N.GROUND,
+  DEPIT: N.GROUND,
+  DEPVS: N.GROUND,
+  DEPMS: N.GROUND,
+  DEPMD: N.GROUND,
+  DEPDW: N.GROUND,
+  LANDA: N.DIM,
+  LANDF: N.LINE,
+  CHBRN: N.LINE,
+  CHGRF: N.DIM,
+  CHGRD: N.LINE,
+  CHBLK: N.LINE,
+  CSTLN: N.LINE,
+  OUTLW: N.LINE,
+  BKAJ1: N.DIM,
+  TRFCD: N.LINE,
+  TRFCF: N.LINE,
+  RESBL: N.LINE,
+  APTS1: N.LINE,
+  DNGHL: N.BRIGHT,
+  ISHDG: N.BRIGHT,
+  LITRD: N.BRIGHT,
+  LITGN: N.BRIGHT,
+  LITYW: N.BRIGHT,
+  LITWT: N.BRIGHT,
+  LITBL: N.BRIGHT,
+  LITOR: N.BRIGHT,
+  RADHI: N.LINE,
+  RADLO: N.DIM,
+  PLRTE: N.LINE,
+  ARPAT: N.LINE,
+  ISDNG: N.BRIGHT,
+  // Mark bodies by tone, as in mono, so they stay apart from each other and
+  // from the black water; shape still says which side.
+  CHRED: N.DIM,
+  CHGRN: N.LINE,
+  CHYLW: N.LINE,
+  CHMGD: N.LINE,
+  CHMGF: N.LINE,
+  CHWHT: N.BRIGHT,
+  CHCOR: N.LINE,
+  SNDG1: N.LINE,
+  SNDG2: N.BRIGHT,
+  DEPSC: N.BRIGHT,
+  DEPCN: N.LINE,
+  UINFD: N.LINE,
+  UINFF: N.DIM,
+  UINFR: N.BRIGHT,
+  UINFG: N.LINE,
+  UINFO: N.LINE,
+  UINFB: N.LINE,
+  UINFM: N.LINE,
+  UIBCK: N.GROUND,
+  UIBDR: N.DIM,
+  UIAFD: N.DIM,
+  UIAFF: N.DIM,
+  PIPLN: N.LINE,
+  OUTLL: N.DIM,
+  SCLBR: N.LINE,
+  NINFO: N.LINE,
+  ADINF: N.DIM,
+  RESGR: N.DIM,
+  SHIPS: N.BRIGHT,
+  PSTRK: N.LINE,
+  SYTRK: N.DIM,
+  APLRT: N.BRIGHT,
+  CURSR: N.BRIGHT,
+  BKAJ2: N.GROUND,
+  RES01: N.DIM,
+  RES02: N.DIM,
+  RES03: N.DIM
+};
 var COLOR_TABLES = {
   DAY: S52_DAY,
   DUSK: S52_DUSK,
-  NIGHT: S52_NIGHT
+  NIGHT: S52_NIGHT,
+  EINK_COLOR: S52_EINK_COLOR,
+  EINK_MONO: S52_EINK_MONO,
+  EINK_NIGHT: S52_EINK_NIGHT
 };
 function resolveColor(token, table = "DAY") {
   const t = COLOR_TABLES[table];
@@ -15666,6 +15896,9 @@ var CHRT_GLYPH_SVGS = {
   "cardinal-w": '<svg xmlns="http://www.w3.org/2000/svg" width="32" height="32" viewBox="0 0 32 32"><path d="M16 6 12 1.5h8Z" fill="#101418"/><path d="M16 6.5 20 11h-8Z" fill="#101418"/><path d="M13 12h6l1 13H12Z" fill="#FFC805"/><path d="M6 28h20" stroke="#101418" stroke-width="2.4" stroke-linecap="round"/></svg>',
   "daymark-square": '<svg xmlns="http://www.w3.org/2000/svg" width="32" height="32" viewBox="0 0 32 32"><rect x="6" y="6" width="20" height="20" rx="1.5" fill="#fff"/></svg>',
   "daymark-triangle": '<svg xmlns="http://www.w3.org/2000/svg" width="32" height="32" viewBox="0 0 32 32"><path d="M16 5 28 26H4Z" fill="#fff"/></svg>',
+  "eink-danger": '<svg xmlns="http://www.w3.org/2000/svg" width="8" height="8" viewBox="0 0 8 8"><path d="M-2 2 L2 -2 M0 8 L8 0 M6 10 L10 6" stroke="#000000" stroke-width="1" fill="none"/><path d="M-2 6 L2 10 M0 0 L8 8 M6 -2 L10 2" stroke="#000000" stroke-width="1" fill="none"/></svg>',
+  "eink-dots": '<svg xmlns="http://www.w3.org/2000/svg" width="10" height="10" viewBox="0 0 10 10"><circle cx="2.5" cy="2.5" r="0.9" fill="#000000"/><circle cx="7.5" cy="7.5" r="0.9" fill="#000000"/></svg>',
+  "eink-hatch": '<svg xmlns="http://www.w3.org/2000/svg" width="8" height="8" viewBox="0 0 8 8"><path d="M-2 2 L2 -2 M0 8 L8 0 M6 10 L10 6" stroke="#000000" stroke-width="0.9" fill="none"/></svg>',
   "hatch-nocoverage": '<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24"><path d="M-3 9 L9 -3 M-3 21 L21 -3 M3 27 L27 3 M15 27 L27 15" stroke="#8A97A0" stroke-width="0.8" fill="none"/><path d="M-3 15 L15 33 M-3 3 L21 27 M3 -3 L27 21 M15 -3 L27 9" stroke="#8A97A0" stroke-width="0.8" fill="none"/></svg>',
   "hatch-uncharted": '<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24"><path d="M-3 9 L9 -3 M-3 21 L21 -3 M3 27 L27 3 M15 27 L27 15" stroke="#5B7383" stroke-width="0.65" fill="none"/></svg>',
   "isolated-danger": '<svg xmlns="http://www.w3.org/2000/svg" width="32" height="32" viewBox="0 0 32 32"><circle cx="16" cy="3.5" r="2.4" fill="#101418"/><circle cx="16" cy="9.5" r="2.4" fill="#101418"/><path d="M13 13h6l1 12H12Z" fill="#101418"/><rect x="12.4" y="17.5" width="7.2" height="3.4" fill="#E5484D"/><path d="M6 28h20" stroke="#101418" stroke-width="2.4" stroke-linecap="round"/></svg>',
@@ -15708,6 +15941,22 @@ function capLuminance(hex, ceiling) {
 }
 var NIGHT_INK = S52_NIGHT.CHBLK;
 var NIGHT_MUTED_INK = scaleLinearLight(S52_NIGHT.CHBLK, 0.43);
+function einkMonoGrey(hex) {
+  const l = relativeLuminance(hex);
+  const g = EINK_MONO_GREYS;
+  const steps = [g.INK, g.DARK, g.MID, g.PAPER].map((c) => [c, relativeLuminance(c)]);
+  let best = steps[0];
+  for (const step of steps) if (Math.abs(step[1] - l) < Math.abs(best[1] - l)) best = step;
+  return best[0];
+}
+function einkNightGrey(hex) {
+  const l = relativeLuminance(hex);
+  const g = EINK_MONO_GREYS;
+  const steps = [g.DARK, g.MID, g.PAPER].map((c) => [c, relativeLuminance(c)]);
+  let best = steps[0];
+  for (const step of steps) if (Math.abs(step[1] - l) < Math.abs(best[1] - l)) best = step;
+  return best[0];
+}
 
 // src/atlas/chrt-style.ts
 var CHRT_ICON_PREFIX = "chrt:";
@@ -15732,7 +15981,9 @@ var CHRT_SDF_GLYPHS = /* @__PURE__ */ new Set([
 var CHRT_GLYPH_NAMES = new Set(Object.keys(CHRT_GLYPH_SVGS));
 var HOUSE_BLACK = "#101418";
 function chrtHouseColor(dayHex, palette = "DAY") {
-  if (palette === "DAY") return dayHex;
+  if (palette === "DAY" || palette === "EINK_COLOR") return dayHex;
+  if (palette === "EINK_MONO") return einkMonoGrey(dayHex);
+  if (palette === "EINK_NIGHT") return dayHex.toLowerCase() === HOUSE_BLACK.toLowerCase() || dayHex.toLowerCase() === "#000000" ? "#aaaaaa" : einkNightGrey(dayHex);
   const isBlack = dayHex.toLowerCase() === HOUSE_BLACK.toLowerCase();
   if (palette === "DUSK") {
     return isBlack ? dayHex : capLuminance(dayHex, relativeLuminance(resolveColor("CHBLK", "DUSK")));
@@ -15740,7 +15991,7 @@ function chrtHouseColor(dayHex, palette = "DAY") {
   return isBlack ? NIGHT_INK : capLuminance(dayHex, relativeLuminance(NIGHT_MUTED_INK));
 }
 function themeChrtGlyph(svg2, palette = "DAY") {
-  if (palette === "DAY") return svg2;
+  if (palette === "DAY" || palette === "EINK_COLOR") return svg2;
   return svg2.replace(
     /(fill|stroke)="(#[0-9a-fA-F]{3}|#[0-9a-fA-F]{6})"/g,
     (_m, attr, hex) => {
@@ -15751,6 +16002,7 @@ function themeChrtGlyph(svg2, palette = "DAY") {
 }
 
 // src/atlas/base-layers.ts
+var NOCOVERAGE_PATTERN = "chrt:hatch-nocoverage";
 var UNCHARTED_PATTERN = "chrt:hatch-uncharted";
 function inlandHatchColor(palette) {
   return (BASE_THEMES[palette] ?? BASE_THEMES.DAY).inlandHatch;
@@ -15761,6 +16013,9 @@ function basePatternSvg(name, palette) {
   if (`${CHRT_ICON_PREFIX}${name}` === UNCHARTED_PATTERN) {
     return raw.replace(/stroke="#[0-9a-fA-F]{3,6}"/g, `stroke="${inlandHatchColor(palette)}"`);
   }
+  if (palette === "EINK_NIGHT" && `${CHRT_ICON_PREFIX}${name}` === NOCOVERAGE_PATTERN) {
+    return raw.replace(/stroke="#[0-9a-fA-F]{3,6}"/g, `stroke="#555555"`);
+  }
   return themeChrtGlyph(raw, palette);
 }
 var BASE_THEMES = {
@@ -15867,6 +16122,65 @@ var BASE_THEMES = {
     inlandShore: "#1C2227",
     inlandLabel: "#617484",
     inlandHalo: "#232A30"
+  },
+  // ── E-ink: uncharted is DARK, never paper ─────────────────────────────
+  // On an e-ink chart, charted safe water is paper. Water outside coverage
+  // must never read as that, so it is the darkest fill on the page — the
+  // e-ink twin of DAY's dark carto — with the no-coverage crosshatch over it
+  // (invariant 5: the coverage portrayal survives). Land outside coverage
+  // keeps the chart's own land tone.
+  EINK_COLOR: {
+    earth: "#d8ccb0",
+    water: "#4f5a62",
+    river: "#4f5a62",
+    boundary: "#000000",
+    jurisdiction: "#f2e2b0",
+    inlandWater: "#c8d6e0",
+    // The house stripe, 3.4:1 on this rough water — strong enough for the
+    // 150 ppi colour layer.
+    inlandHatch: "#5B7383",
+    stateLine: "#555555",
+    stateLabel: "#000000",
+    stateHalo: "#ffffff",
+    inlandShore: "#555555",
+    inlandLabel: "#000000",
+    inlandHalo: "#ffffff"
+  },
+  // Mono: the same rule in the four greys. Uncharted water DARK under a MID
+  // crosshatch; land MID; rough inland water PAPER under the uncharted hatch.
+  EINK_MONO: {
+    earth: "#aaaaaa",
+    water: "#555555",
+    river: "#555555",
+    boundary: "#000000",
+    jurisdiction: "#aaaaaa",
+    inlandWater: "#ffffff",
+    inlandHatch: "#555555",
+    stateLine: "#555555",
+    stateLabel: "#000000",
+    stateHalo: "#ffffff",
+    inlandShore: "#555555",
+    inlandLabel: "#000000",
+    inlandHalo: "#ffffff"
+  },
+  // Night: the inverse. Water outside coverage is the black ground UNDER the
+  // light crosshatch — charted safe water is plain black, so the hatch is what
+  // tells them apart, here as everywhere. Land the DIM grey; labels the line
+  // grey on black.
+  EINK_NIGHT: {
+    earth: "#555555",
+    water: "#000000",
+    river: "#000000",
+    boundary: "#aaaaaa",
+    jurisdiction: "#555555",
+    inlandWater: "#000000",
+    inlandHatch: "#aaaaaa",
+    stateLine: "#aaaaaa",
+    stateLabel: "#aaaaaa",
+    stateHalo: "#000000",
+    inlandShore: "#aaaaaa",
+    inlandLabel: "#aaaaaa",
+    inlandHalo: "#000000"
   }
 };
 
@@ -16427,10 +16741,20 @@ var S101_NIGHT = {
 // src/atlas/s101-style.ts
 var S101_ICON_PREFIX = "s101:";
 var S101_SYMBOL_NAMES = new Set(Object.keys(S101_POINT_SVGS));
+function s101EinkTable(einkS52, fallback) {
+  const out = {};
+  for (const [token, dayHex] of Object.entries(S101_DAY)) {
+    out[token] = einkS52[token] ?? fallback(dayHex);
+  }
+  return out;
+}
 var S101_TABLES = {
   DAY: S101_DAY,
   DUSK: S101_DUSK,
-  NIGHT: S101_NIGHT
+  NIGHT: S101_NIGHT,
+  EINK_COLOR: s101EinkTable(S52_EINK_COLOR, (hex) => hex),
+  EINK_MONO: s101EinkTable(S52_EINK_MONO, einkMonoGrey),
+  EINK_NIGHT: s101EinkTable(S52_EINK_NIGHT, einkNightGrey)
 };
 var warnedTokens = /* @__PURE__ */ new Set();
 function reportUnresolvedToken(token, table) {
@@ -16455,7 +16779,17 @@ function getThemedS101Svg(symbolName, table = "DAY") {
 
 // src/atlas/symbol-image-specs.ts
 var SUPERSAMPLE = 2;
-var BASE_PATTERN_GLYPHS = ["hatch-nocoverage", "hatch-uncharted"];
+var BASE_PATTERN_GLYPHS = [
+  "hatch-nocoverage",
+  "hatch-uncharted",
+  // The e-ink fill patterns (`eink-portrayal.ts`). Only the e-ink palettes
+  // reference them, but they are registered with the hatches in every palette
+  // so a client switching INTO e-ink never draws a pattern-less fill while a
+  // late image load catches up. Three 8 px tiles.
+  "eink-dots",
+  "eink-hatch",
+  "eink-danger"
+];
 function upsample(svg2) {
   return svg2.replace(
     /width="(\d+)" height="(\d+)"/,