@chrtco/sdk 0.10.46 → 0.10.48

package/dist/symbol-families-De7sN-p5.d.cts

@@ -0,0 +1,93 @@
+/**
+ * IHO S-52 Colour Tables: DAY_BRIGHT, DUSK, and NIGHT — plus CHRT's two
+ * e-ink tables, EINK_COLOR and EINK_MONO, which are NOT S-52 tables (see
+ * their block below).
+ * Each token maps to a hex colour string.
+ * Source: IHO S-52 Presentation Library, Edition 4.0 – Annex A
+ */
+type ColorTableName = "DAY" | "DUSK" | "NIGHT" | "EINK_COLOR" | "EINK_MONO" | "EINK_NIGHT";
+/**
+ * The e-ink chart palettes, by what a client calls the mode. Import this
+ * rather than spelling the strings: a client that keys its e-ink setting off
+ * these names can never ask for a table the SDK does not have.
+ *
+ *   color  E Ink Kaleido 3 and other colour e-paper (150 ppi colour layer over
+ *          a 300 ppi black-and-white one). Paper ground, black ink, a few
+ *          strong colours as fills and thick lines only.
+ *   mono   Monochrome e-paper (Carta), e-ink monitors, and colour panels run
+ *          in black-and-white. Four greys; every distinction the colour chart
+ *          makes by hue is made here by weight, dash, pattern or symbol.
+ *   night  E-ink at night, front light on (any e-ink panel, colour or mono).
+ *          The mono chart inverted: a black page, so the front light the
+ *          page reflects into a dark-adapted eye is small. Replaces red night
+ *          on e-ink, where no front light is red (owner, 2026-10-05).
+ *
+ * Wire names on the served style (`?theme=`) are the lowercase table names:
+ * `eink_color`, `eink_mono`, `eink_night`.
+ */
+declare const EINK_COLOR_TABLES: {
+    readonly color: "EINK_COLOR";
+    readonly mono: "EINK_MONO";
+    readonly night: "EINK_NIGHT";
+};
+/** True for the e-ink tables. */
+declare function isEinkColorTable(ct: ColorTableName): ct is "EINK_COLOR" | "EINK_MONO" | "EINK_NIGHT";
+/** True for the e-ink tables drawn in the four greys only (mono and night). */
+declare function isEinkGreyTable(ct: ColorTableName): ct is "EINK_MONO" | "EINK_NIGHT";
+/**
+ * The four greys EINK_MONO is built from, and nothing else. Carta panels show
+ * 16 grey levels, of which about four are reliably distinct at a glance (fewer
+ * in sunlight) — so the mono chart uses exactly four, a third of the range
+ * apart, and every further distinction is a line weight, dash or fill pattern.
+ * Owner decision 2026-10-05: one mono palette, four greys.
+ */
+declare const EINK_MONO_GREYS: {
+    readonly INK: "#000000";
+    readonly DARK: "#555555";
+    readonly MID: "#aaaaaa";
+    readonly PAPER: "#ffffff";
+};
+declare const S52_DAY: Record<string, string>;
+declare const S52_DUSK: Record<string, string>;
+declare const S52_NIGHT: Record<string, string>;
+declare const S52_EINK_COLOR: Record<string, string>;
+declare const S52_EINK_MONO: Record<string, string>;
+declare const S52_EINK_NIGHT: Record<string, string>;
+/** Backward-compatible alias – the DAY_BRIGHT table */
+declare const S52_COLORS: Record<string, string>;
+/** Get a full colour table by name */
+declare function getColorTable(name: ColorTableName): Record<string, string>;
+/** Resolve an S-52 colour token to a hex string. Falls back to black/amber. */
+declare function resolveColor(token: string, table?: ColorTableName): string;
+
+/**
+ * The symbol-artwork families, as one shared vocabulary.
+ *
+ * `applyS101SymbolSet` / `applyChrtSymbolSet` / `applyRasterSymbolSet`
+ * switch a whole generated style document. Consumers that build layers
+ * class-by-class (the /map viewer's renderer) need the same decision at
+ * the level of a single class — that's `iconExpressionForFamily`, so the
+ * viewer and the Style API can never disagree about what a family means.
+ */
+type SymbolFamily = "s52" | "s101" | "chrt" | "raster";
+/** Every family, in presentation order. Mirrors the Style API's
+ *  `?symbols=` values (SYMBOL_SET_PARAMS in the tile worker). */
+declare const SYMBOL_FAMILIES: readonly SymbolFamily[];
+interface SymbolFamilyMeta {
+    /** Short UI label. */
+    label: string;
+    /** One-line description of what the family is. */
+    description: string;
+}
+declare const SYMBOL_FAMILY_META: Record<SymbolFamily, SymbolFamilyMeta>;
+/** Narrow an arbitrary string to a family, or null. Case-insensitive. */
+declare function parseSymbolFamily(raw: string | null | undefined): SymbolFamily | null;
+/**
+ * The icon-image expression for one S-57 class under a given family —
+ * the per-class equivalent of the `apply*SymbolSet` style rewrites.
+ * Classes a family doesn't restyle fall back to the S-52 expression,
+ * exactly as they do on a served style.
+ */
+declare function iconExpressionForFamily(objectClass: string, family: SymbolFamily): string | unknown[];
+
+export { type ColorTableName as C, EINK_COLOR_TABLES as E, S52_COLORS as S, EINK_MONO_GREYS as a, S52_DAY as b, S52_DUSK as c, S52_EINK_COLOR as d, S52_EINK_MONO as e, S52_EINK_NIGHT as f, S52_NIGHT as g, SYMBOL_FAMILIES as h, SYMBOL_FAMILY_META as i, type SymbolFamily as j, type SymbolFamilyMeta as k, getColorTable as l, iconExpressionForFamily as m, isEinkColorTable as n, isEinkGreyTable as o, parseSymbolFamily as p, resolveColor as r };

package/dist/symbol-families-De7sN-p5.d.ts

@@ -0,0 +1,93 @@
+/**
+ * IHO S-52 Colour Tables: DAY_BRIGHT, DUSK, and NIGHT — plus CHRT's two
+ * e-ink tables, EINK_COLOR and EINK_MONO, which are NOT S-52 tables (see
+ * their block below).
+ * Each token maps to a hex colour string.
+ * Source: IHO S-52 Presentation Library, Edition 4.0 – Annex A
+ */
+type ColorTableName = "DAY" | "DUSK" | "NIGHT" | "EINK_COLOR" | "EINK_MONO" | "EINK_NIGHT";
+/**
+ * The e-ink chart palettes, by what a client calls the mode. Import this
+ * rather than spelling the strings: a client that keys its e-ink setting off
+ * these names can never ask for a table the SDK does not have.
+ *
+ *   color  E Ink Kaleido 3 and other colour e-paper (150 ppi colour layer over
+ *          a 300 ppi black-and-white one). Paper ground, black ink, a few
+ *          strong colours as fills and thick lines only.
+ *   mono   Monochrome e-paper (Carta), e-ink monitors, and colour panels run
+ *          in black-and-white. Four greys; every distinction the colour chart
+ *          makes by hue is made here by weight, dash, pattern or symbol.
+ *   night  E-ink at night, front light on (any e-ink panel, colour or mono).
+ *          The mono chart inverted: a black page, so the front light the
+ *          page reflects into a dark-adapted eye is small. Replaces red night
+ *          on e-ink, where no front light is red (owner, 2026-10-05).
+ *
+ * Wire names on the served style (`?theme=`) are the lowercase table names:
+ * `eink_color`, `eink_mono`, `eink_night`.
+ */
+declare const EINK_COLOR_TABLES: {
+    readonly color: "EINK_COLOR";
+    readonly mono: "EINK_MONO";
+    readonly night: "EINK_NIGHT";
+};
+/** True for the e-ink tables. */
+declare function isEinkColorTable(ct: ColorTableName): ct is "EINK_COLOR" | "EINK_MONO" | "EINK_NIGHT";
+/** True for the e-ink tables drawn in the four greys only (mono and night). */
+declare function isEinkGreyTable(ct: ColorTableName): ct is "EINK_MONO" | "EINK_NIGHT";
+/**
+ * The four greys EINK_MONO is built from, and nothing else. Carta panels show
+ * 16 grey levels, of which about four are reliably distinct at a glance (fewer
+ * in sunlight) — so the mono chart uses exactly four, a third of the range
+ * apart, and every further distinction is a line weight, dash or fill pattern.
+ * Owner decision 2026-10-05: one mono palette, four greys.
+ */
+declare const EINK_MONO_GREYS: {
+    readonly INK: "#000000";
+    readonly DARK: "#555555";
+    readonly MID: "#aaaaaa";
+    readonly PAPER: "#ffffff";
+};
+declare const S52_DAY: Record<string, string>;
+declare const S52_DUSK: Record<string, string>;
+declare const S52_NIGHT: Record<string, string>;
+declare const S52_EINK_COLOR: Record<string, string>;
+declare const S52_EINK_MONO: Record<string, string>;
+declare const S52_EINK_NIGHT: Record<string, string>;
+/** Backward-compatible alias – the DAY_BRIGHT table */
+declare const S52_COLORS: Record<string, string>;
+/** Get a full colour table by name */
+declare function getColorTable(name: ColorTableName): Record<string, string>;
+/** Resolve an S-52 colour token to a hex string. Falls back to black/amber. */
+declare function resolveColor(token: string, table?: ColorTableName): string;
+
+/**
+ * The symbol-artwork families, as one shared vocabulary.
+ *
+ * `applyS101SymbolSet` / `applyChrtSymbolSet` / `applyRasterSymbolSet`
+ * switch a whole generated style document. Consumers that build layers
+ * class-by-class (the /map viewer's renderer) need the same decision at
+ * the level of a single class — that's `iconExpressionForFamily`, so the
+ * viewer and the Style API can never disagree about what a family means.
+ */
+type SymbolFamily = "s52" | "s101" | "chrt" | "raster";
+/** Every family, in presentation order. Mirrors the Style API's
+ *  `?symbols=` values (SYMBOL_SET_PARAMS in the tile worker). */
+declare const SYMBOL_FAMILIES: readonly SymbolFamily[];
+interface SymbolFamilyMeta {
+    /** Short UI label. */
+    label: string;
+    /** One-line description of what the family is. */
+    description: string;
+}
+declare const SYMBOL_FAMILY_META: Record<SymbolFamily, SymbolFamilyMeta>;
+/** Narrow an arbitrary string to a family, or null. Case-insensitive. */
+declare function parseSymbolFamily(raw: string | null | undefined): SymbolFamily | null;
+/**
+ * The icon-image expression for one S-57 class under a given family —
+ * the per-class equivalent of the `apply*SymbolSet` style rewrites.
+ * Classes a family doesn't restyle fall back to the S-52 expression,
+ * exactly as they do on a served style.
+ */
+declare function iconExpressionForFamily(objectClass: string, family: SymbolFamily): string | unknown[];
+
+export { type ColorTableName as C, EINK_COLOR_TABLES as E, S52_COLORS as S, EINK_MONO_GREYS as a, S52_DAY as b, S52_DUSK as c, S52_EINK_COLOR as d, S52_EINK_MONO as e, S52_EINK_NIGHT as f, S52_NIGHT as g, SYMBOL_FAMILIES as h, SYMBOL_FAMILY_META as i, type SymbolFamily as j, type SymbolFamilyMeta as k, getColorTable as l, iconExpressionForFamily as m, isEinkColorTable as n, isEinkGreyTable as o, parseSymbolFamily as p, resolveColor as r };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chrtco/sdk",
-  "version": "0.10.46",
+  "version": "0.10.48",
   "description": "Official TypeScript SDK for the CHRT nautical chart API",
   "type": "module",
   "main": "./dist/index.cjs",

package/dist/symbol-families-D2Kx20HJ.d.cts

@@ -1,47 +0,0 @@
-/**
- * IHO S-52 Colour Tables: DAY_BRIGHT, DUSK, and NIGHT.
- * Each token maps to a hex colour string.
- * Source: IHO S-52 Presentation Library, Edition 4.0 – Annex A
- */
-type ColorTableName = "DAY" | "DUSK" | "NIGHT";
-declare const S52_DAY: Record<string, string>;
-declare const S52_DUSK: Record<string, string>;
-declare const S52_NIGHT: Record<string, string>;
-/** Backward-compatible alias – the DAY_BRIGHT table */
-declare const S52_COLORS: Record<string, string>;
-/** Get a full colour table by name */
-declare function getColorTable(name: ColorTableName): Record<string, string>;
-/** Resolve an S-52 colour token to a hex string. Falls back to black/amber. */
-declare function resolveColor(token: string, table?: ColorTableName): string;
-
-/**
- * The symbol-artwork families, as one shared vocabulary.
- *
- * `applyS101SymbolSet` / `applyChrtSymbolSet` / `applyRasterSymbolSet`
- * switch a whole generated style document. Consumers that build layers
- * class-by-class (the /map viewer's renderer) need the same decision at
- * the level of a single class — that's `iconExpressionForFamily`, so the
- * viewer and the Style API can never disagree about what a family means.
- */
-type SymbolFamily = "s52" | "s101" | "chrt" | "raster";
-/** Every family, in presentation order. Mirrors the Style API's
- *  `?symbols=` values (SYMBOL_SET_PARAMS in the tile worker). */
-declare const SYMBOL_FAMILIES: readonly SymbolFamily[];
-interface SymbolFamilyMeta {
-    /** Short UI label. */
-    label: string;
-    /** One-line description of what the family is. */
-    description: string;
-}
-declare const SYMBOL_FAMILY_META: Record<SymbolFamily, SymbolFamilyMeta>;
-/** Narrow an arbitrary string to a family, or null. Case-insensitive. */
-declare function parseSymbolFamily(raw: string | null | undefined): SymbolFamily | null;
-/**
- * The icon-image expression for one S-57 class under a given family —
- * the per-class equivalent of the `apply*SymbolSet` style rewrites.
- * Classes a family doesn't restyle fall back to the S-52 expression,
- * exactly as they do on a served style.
- */
-declare function iconExpressionForFamily(objectClass: string, family: SymbolFamily): string | unknown[];
-
-export { type ColorTableName as C, S52_COLORS as S, S52_DAY as a, S52_DUSK as b, S52_NIGHT as c, SYMBOL_FAMILIES as d, SYMBOL_FAMILY_META as e, type SymbolFamily as f, type SymbolFamilyMeta as g, getColorTable as h, iconExpressionForFamily as i, parseSymbolFamily as p, resolveColor as r };

package/dist/symbol-families-D2Kx20HJ.d.ts

@@ -1,47 +0,0 @@
-/**
- * IHO S-52 Colour Tables: DAY_BRIGHT, DUSK, and NIGHT.
- * Each token maps to a hex colour string.
- * Source: IHO S-52 Presentation Library, Edition 4.0 – Annex A
- */
-type ColorTableName = "DAY" | "DUSK" | "NIGHT";
-declare const S52_DAY: Record<string, string>;
-declare const S52_DUSK: Record<string, string>;
-declare const S52_NIGHT: Record<string, string>;
-/** Backward-compatible alias – the DAY_BRIGHT table */
-declare const S52_COLORS: Record<string, string>;
-/** Get a full colour table by name */
-declare function getColorTable(name: ColorTableName): Record<string, string>;
-/** Resolve an S-52 colour token to a hex string. Falls back to black/amber. */
-declare function resolveColor(token: string, table?: ColorTableName): string;
-
-/**
- * The symbol-artwork families, as one shared vocabulary.
- *
- * `applyS101SymbolSet` / `applyChrtSymbolSet` / `applyRasterSymbolSet`
- * switch a whole generated style document. Consumers that build layers
- * class-by-class (the /map viewer's renderer) need the same decision at
- * the level of a single class — that's `iconExpressionForFamily`, so the
- * viewer and the Style API can never disagree about what a family means.
- */
-type SymbolFamily = "s52" | "s101" | "chrt" | "raster";
-/** Every family, in presentation order. Mirrors the Style API's
- *  `?symbols=` values (SYMBOL_SET_PARAMS in the tile worker). */
-declare const SYMBOL_FAMILIES: readonly SymbolFamily[];
-interface SymbolFamilyMeta {
-    /** Short UI label. */
-    label: string;
-    /** One-line description of what the family is. */
-    description: string;
-}
-declare const SYMBOL_FAMILY_META: Record<SymbolFamily, SymbolFamilyMeta>;
-/** Narrow an arbitrary string to a family, or null. Case-insensitive. */
-declare function parseSymbolFamily(raw: string | null | undefined): SymbolFamily | null;
-/**
- * The icon-image expression for one S-57 class under a given family —
- * the per-class equivalent of the `apply*SymbolSet` style rewrites.
- * Classes a family doesn't restyle fall back to the S-52 expression,
- * exactly as they do on a served style.
- */
-declare function iconExpressionForFamily(objectClass: string, family: SymbolFamily): string | unknown[];
-
-export { type ColorTableName as C, S52_COLORS as S, S52_DAY as a, S52_DUSK as b, S52_NIGHT as c, SYMBOL_FAMILIES as d, SYMBOL_FAMILY_META as e, type SymbolFamily as f, type SymbolFamilyMeta as g, getColorTable as h, iconExpressionForFamily as i, parseSymbolFamily as p, resolveColor as r };