@chrtco/sdk 0.10.54 → 0.10.55

package/CHANGELOG.md

@@ -4,6 +4,34 @@ All notable changes to `@chrtco/sdk` will be documented in this file.
 
 ## [Unreleased]
 
+### Changed
+- **The paper-chart symbol family is `int1`, "INT-1"**, after the standard it draws (IHO INT 1);
+  it was `raster`, "CHRTraster". `SymbolFamily` is `"s52" | "s101" | "chrt" | "int1"` and
+  `SYMBOL_FAMILIES` lists `int1`. The style records `chrt:symbol-set: "int1"` and is named
+  `CHRT INT-1 …`; its sprite is still the published `raster-{palette}` sheet.
+
+### Added
+- **Decorative looks: `generateStyle("DAY", { look })`**, `"paper"` (the U.S. paper chart as last
+  printed), `"engraved"` (the 1860s Coast Survey engraving) and `"handcolored"` (the engraving
+  with the colourist's wash, laid as flat tints). Applied last; drawn over DAY only (another palette
+  throws). Moved from CHRTpaper, which draws the same looks: `withLook`, `lookImages`,
+  `CHART_LOOKS`, `parseChartLook`, `styleLook`, `LOOK_TONES`, `LOOK_FONTS`, `WASH_TONES`,
+  `WASH_TINTS`. Their images are painted, not on a sprite sheet yet: register them with
+  `provideChartLookImages(map)` from `@chrtco/sdk/atlas/browser`.
+- **Symbol family `uschart1`, "U.S. Chart No. 1"**: INT-1 with the aids as U.S. Chart No. 1's NOAA
+  column draws them (diamond buoys with the shape in the label, filled daybeacons, magenta discs and
+  flares). By day and on e-ink by day; INT-1's artwork at dusk and night. Moved from CHRTpaper's
+  Classic Paper set: `withClassicMarks`, `classicInkFor`, `classicIconExpression`,
+  `classicMarkImages`, `usChart1ImageSpecs`. Declares INT-1's `raster-*` sheet until it has its own.
+- **`STYLE_CATALOGUE`** — every theme (`STYLE_THEMES`: day, dusk, night and the three e-ink
+  palettes), look (`STYLE_LOOKS`) and symbol family, with labels, in presentation order.
+
+### Deprecated
+- **`raster` as a symbol family id.** Still accepted wherever it was — `generateStyle({ symbolSet })`,
+  `parseSymbolFamily` — and means exactly `int1`. `LEGACY_SYMBOL_FAMILY_ALIASES`,
+  `normalizeSymbolFamily`, `SymbolFamilyInput`. The served Style API's `symbols` still takes
+  `raster` only, until the tile worker accepts `int1`.
+
 ### Added
 - **`generateStyle({ dangerDepthRounding: 'down' })`** — the depth beside a rock, wreck or
   obstruction rounded toward the shallower figure (ADR 0047): whole feet floored in a feet style,

package/README.md

@@ -212,10 +212,23 @@ await chrt.styleUrl({ symbols: 's101' }); // served — symbols,   theme:   'day
 | `s52` (default) | IHO S-52 Presentation Library — spec-exact ATON/LIGHTS selection |
 | `s101` | official IHO S-101 Portrayal Catalogue artwork |
 | `chrt` | CHRT house set — colour-true silhouettes, capability badges |
-| `raster` | raster symbol set |
+| `int1` | INT-1 — the IHO INT 1 symbols, as paper charts draw them (local `symbolSet`; the served `symbols` still takes its old id, `raster`) |
 
-`s101` and `chrt` need their images loaded at runtime via `loadS101SymbolImages` /
-`loadChrtSymbolImages` from `@chrtco/sdk/atlas/browser`.
+| `uschart1` | U.S. Chart No. 1 — INT-1 with diamond buoys and filled daybeacons, as U.S. paper charts drew them (local only for now) |
+
+`raster` is INT-1's id before 2026-11 and is still accepted everywhere it was, meaning `int1`.
+
+### Looks
+
+`chrt.style({ look: 'paper' | 'engraved' | 'handcolored' })` restyles the day chart as a period
+chart: the U.S. paper chart as last printed, the 1860s Coast Survey engraving, or the engraving
+hand-coloured. Every danger, aid, light and sounding still draws. A look is drawn over the DAY
+palette only. Its images (and U.S. Chart No. 1's marks) are painted on demand: call
+`provideChartLookImages(map)` from `@chrtco/sdk/atlas/browser` once per map. `STYLE_CATALOGUE`
+lists the themes (e-ink included), looks and symbol families with their labels.
+
+`s101`, `chrt` and `int1` need their images loaded at runtime via `loadS101SymbolImages` /
+`loadChrtSymbolImages` / `loadChrtRasterSymbolImages` from `@chrtco/sdk/atlas/browser`.
 
 ### Custom styles