@chrtco/sdk 0.10.55 → 0.10.57

package/dist/index.js

@@ -465,7 +465,9 @@ var TilesEndpoint = class {
     const params = new URLSearchParams();
     if (opts.theme) params.set("theme", opts.theme);
     if (opts.symbols) params.set("symbols", opts.symbols);
+    if (opts.look) params.set("look", opts.look);
     if (opts.mode) params.set("mode", opts.mode);
+    if (opts.lock) params.set("lock", opts.lock);
     if (opts.land) params.set("land", "1");
     if (opts.relief) params.set("relief", "1");
     if (opts.units === "imperial") params.set("units", "imperial");
@@ -31936,8 +31938,11 @@ function washTint(cls, id, tints) {
   if (cls === "LAKARE" || id === "chrtland-water" || id === "paper-base-lakes") return tints.lake;
   return null;
 }
+function lookSprite(style, look) {
+  return typeof style.sprite === "string" ? { sprite: style.sprite.replace(/-day$/, `-look_${look}`) } : {};
+}
 function withLook(style, look, opts = {}) {
-  if (look === "paper") return withClassic(style);
+  if (look === "paper") return { ...withClassic(style), ...lookSprite(style, look) };
   const tone = LOOK_TONES[look];
   const ink = tone.ink;
   const tints = look === "handcolored" && opts.tints !== false ? WASH_TINTS : null;
@@ -32037,10 +32042,7 @@ function withLook(style, look, opts = {}) {
   });
   return {
     ...style,
-    // The black & white sheet's symbols, the same INT-1 shapes in black, on
-    // both looks: the day sheet's magenta anchors and light flares read as a
-    // modern chart under the wash.
-    ...typeof style.sprite === "string" ? { sprite: style.sprite.replace(/-day$/, "-eink_mono") } : {},
+    ...lookSprite(style, look),
     sources: {
       ...style.sources,
       [LOOK_WATERLINES_SOURCE]: { type: "geojson", data: { type: "FeatureCollection", features: [] } }
@@ -33645,8 +33647,8 @@ var SYMBOL_SET_LABELS = {
 var SPRITE_SHEET_FAMILY = {
   s52: "s52",
   chrt: "chrt",
-  int1: "raster",
-  uschart1: "raster"
+  int1: "int1",
+  uschart1: "uschart1"
 };
 function applySymbolFamily(style, family, palette) {
   switch (family) {
@@ -34869,7 +34871,7 @@ function applyCustomStyleSettings(style, config) {
 }
 function generateCustomStyle(config, opts = {}) {
   const { theme, ...generatorOpts } = opts;
-  const { palette, themeFellBack } = resolveCustomTheme(config, theme ?? null);
+  const { palette, themeFellBack } = generatorOpts.look !== void 0 ? { palette: "DAY", themeFellBack: theme != null && theme !== "DAY" } : resolveCustomTheme(config, theme ?? null);
   const style = generateStyle(palette, {
     ...generatorOpts,
     safetyContour: config.sounding_settings.safetyContour,
@@ -34943,6 +34945,301 @@ function splitOpaqueDepthAreas(layers) {
   return out;
 }
 
+// src/atlas/chart-reduction.ts
+var CHART_LOCK_BANDS = [
+  { band: 1, name: "Overview", floor: 5 },
+  { band: 2, name: "General", floor: 7 },
+  { band: 3, name: "Coastal", floor: 9 },
+  { band: 4, name: "Approach", floor: 11 },
+  { band: 5, name: "Harbor", floor: 13 },
+  { band: 6, name: "Berthing", floor: 14 }
+];
+var DEFAULT_CHART_LOCK_BAND = 5;
+var MAX_REDUCTION_LEVELS = 2;
+var CHART_ARCHIVE_MAXZOOM = 14;
+function isChartLockBand(v) {
+  return v === 1 || v === 2 || v === 3 || v === 4 || v === 5 || v === 6;
+}
+function chartLockBandInfo(band) {
+  return CHART_LOCK_BANDS[band - 1];
+}
+function chartLockFloor(band) {
+  return chartLockBandInfo(band).floor;
+}
+function chartLockMinZoom(band) {
+  return chartLockFloor(band) - MAX_REDUCTION_LEVELS;
+}
+function chartLockStyleMode(band) {
+  const name = chartLockBandInfo(band).name;
+  return { band: name === "Berthing" ? "Harbor" : name, finestBand: String(band) };
+}
+var FINER_DATA_DECISION_OFFSET = 1e-3;
+function chartLockDecisionZoom(band, bandOnly) {
+  const floor = chartLockFloor(band);
+  return bandOnly ? floor : floor - FINER_DATA_DECISION_OFFSET;
+}
+function chartLockSourceMaxzoom(band, archiveMax = CHART_ARCHIVE_MAXZOOM) {
+  return Math.min(archiveMax, chartLockFloor(band));
+}
+var REDUCED_SIZE_PROPERTIES = /* @__PURE__ */ new Set([
+  "text-size",
+  "icon-size",
+  "text-padding",
+  "icon-padding",
+  "icon-text-fit-padding",
+  "symbol-spacing",
+  "line-width",
+  "line-gap-width",
+  "line-offset",
+  "line-blur",
+  "circle-radius",
+  "circle-stroke-width",
+  "text-halo-width",
+  "text-halo-blur",
+  "icon-halo-width",
+  "icon-halo-blur",
+  "text-translate",
+  "icon-translate",
+  "line-translate",
+  "fill-translate",
+  "circle-translate"
+]);
+var REDUCTION_STOPS_PER_LEVEL = 4;
+var STEP_RAMP = 1e-3;
+var isZoom = (e) => Array.isArray(e) && e.length === 1 && e[0] === "zoom";
+function round2(n) {
+  return Math.round(n * 1e4) / 1e4;
+}
+function mentionsZoom2(v) {
+  if (Array.isArray(v)) {
+    if (v[0] === "literal") return false;
+    if (isZoom(v)) return true;
+    return v.some(mentionsZoom2);
+  }
+  if (v !== null && typeof v === "object") return Object.values(v).some(mentionsZoom2);
+  return false;
+}
+function isNumArray(v) {
+  return Array.isArray(v) && v.length > 0 && v.every((n) => typeof n === "number");
+}
+function numArrayOf(v) {
+  if (isNumArray(v)) return v;
+  if (Array.isArray(v) && v.length === 2 && v[0] === "literal" && isNumArray(v[1])) return v[1];
+  return null;
+}
+function asOutput(v) {
+  return isNumArray(v) ? ["literal", v] : v;
+}
+function zoomCurveOf(v) {
+  if (Array.isArray(v)) {
+    if (v[0] === "interpolate" && isZoom(v[2])) {
+      const stops = [];
+      for (let i = 3; i + 1 < v.length; i += 2) {
+        if (typeof v[i] !== "number") return null;
+        stops.push([v[i], v[i + 1]]);
+      }
+      return stops.length > 0 ? { kind: "interpolate", type: v[1], first: void 0, stops } : null;
+    }
+    if (v[0] === "step" && isZoom(v[1])) {
+      const stops = [];
+      for (let i = 3; i + 1 < v.length; i += 2) {
+        if (typeof v[i] !== "number") return null;
+        stops.push([v[i], v[i + 1]]);
+      }
+      return { kind: "step", type: null, first: v[2], stops };
+    }
+    return null;
+  }
+  if (v !== null && typeof v === "object") {
+    const f = v;
+    if (f.property !== void 0 || !Array.isArray(f.stops) || f.stops.length === 0) return null;
+    const stops = [];
+    for (const s of f.stops) {
+      if (!Array.isArray(s) || s.length !== 2 || typeof s[0] !== "number") return null;
+      stops.push([s[0], s[1]]);
+    }
+    if (f.type === "interval") return { kind: "step", type: null, first: stops[0][1], stops: stops.slice(1) };
+    if (f.type !== void 0 && f.type !== "exponential") return null;
+    const base = typeof f.base === "number" ? f.base : 1;
+    return { kind: "interpolate", type: base === 1 ? ["linear"] : ["exponential", base], first: void 0, stops };
+  }
+  return null;
+}
+function interpolationT(type, z, z0, z1) {
+  if (Array.isArray(type) && type[0] === "exponential" && typeof type[1] === "number" && type[1] !== 1) {
+    const b = type[1];
+    return (b ** (z - z0) - 1) / (b ** (z1 - z0) - 1);
+  }
+  return (z - z0) / (z1 - z0);
+}
+function blend(a, b, t, numeric) {
+  if (t <= 0) return a;
+  if (t >= 1) return b;
+  if (typeof a === "number" && typeof b === "number") return round2(a + (b - a) * t);
+  const aa = numArrayOf(a);
+  const bb = numArrayOf(b);
+  if (aa && bb) return aa.length === bb.length ? aa.map((x, i) => round2(x + (bb[i] - x) * t)) : void 0;
+  if (numeric && !aa && !bb && (typeof a === "number" || Array.isArray(a)) && (typeof b === "number" || Array.isArray(b))) {
+    return ["+", ["*", a, round2(1 - t)], ["*", b, round2(t)]];
+  }
+  return void 0;
+}
+function valueAt(c, z, numeric) {
+  if (c.kind === "step") {
+    let out = c.first;
+    for (const [sz, o] of c.stops) if (sz <= z) out = o;
+    return out;
+  }
+  const s = c.stops;
+  if (z <= s[0][0]) return s[0][1];
+  if (z >= s[s.length - 1][0]) return s[s.length - 1][1];
+  for (let j = 0; j + 1 < s.length; j++) {
+    const [z0, o0] = s[j];
+    const [z1, o1] = s[j + 1];
+    if (z === z0) return o0;
+    if (z0 < z && z < z1) return blend(o0, o1, interpolationT(c.type, z, z0, z1), numeric);
+  }
+  return void 0;
+}
+function scaled3(v, f) {
+  if (typeof v === "number") return round2(v * f);
+  const arr = numArrayOf(v);
+  if (arr) return arr.map((n) => round2(n * f));
+  if (Array.isArray(v) && typeof v[0] === "string") return ["*", v, round2(f)];
+  return void 0;
+}
+function reducedSize(value, floor, levels) {
+  const curve = zoomCurveOf(value);
+  if (curve === null && mentionsZoom2(value)) return void 0;
+  const atFloor = curve ? valueAt(curve, floor, true) : value;
+  if (atFloor === void 0) return void 0;
+  const out = [];
+  for (let i = levels * REDUCTION_STOPS_PER_LEVEL; i >= 1; i--) {
+    const dz = i / REDUCTION_STOPS_PER_LEVEL;
+    const v = scaled3(atFloor, 2 ** -dz);
+    if (v === void 0) return void 0;
+    out.push(round2(floor - dz), asOutput(v));
+  }
+  out.push(floor, asOutput(atFloor));
+  if (curve === null) return ["interpolate", ["linear"], ["zoom"], ...out];
+  if (curve.kind === "interpolate") {
+    for (const [z, o] of curve.stops) if (z > floor) out.push(z, o);
+    return ["interpolate", curve.type, ["zoom"], ...out];
+  }
+  let prev = atFloor;
+  for (const [z, o] of curve.stops) {
+    if (z <= floor) continue;
+    if (z - STEP_RAMP > floor) out.push(z - STEP_RAMP, asOutput(prev));
+    out.push(z, asOutput(o));
+    prev = o;
+  }
+  return ["interpolate", ["linear"], ["zoom"], ...out];
+}
+function heldAtFloor(value, floor) {
+  const curve = zoomCurveOf(value);
+  if (curve === null) return void 0;
+  const atFloor = valueAt(curve, floor, false);
+  if (atFloor === void 0) return void 0;
+  const above = curve.stops.filter(([z]) => z > floor).flatMap(([z, o]) => [z, o]);
+  if (above.length === 0) return atFloor;
+  return curve.kind === "step" ? ["step", ["zoom"], atFloor, ...above] : ["interpolate", curve.type, ["zoom"], floor, asOutput(atFloor), ...above];
+}
+function filterAtFloor(filter, floor) {
+  if (!Array.isArray(filter)) return filter;
+  if (filter[0] === "literal") return filter;
+  if (isZoom(filter)) return ["max", ["zoom"], floor];
+  return filter.map((e) => filterAtFloor(e, floor));
+}
+function propsReduced(props, floor, decideAt, levels) {
+  if (!props) return props;
+  let next = null;
+  for (const [name, value] of Object.entries(props)) {
+    if (name === "visibility") continue;
+    const moved = REDUCED_SIZE_PROPERTIES.has(name) ? reducedSize(value, floor, levels) : heldAtFloor(value, decideAt);
+    if (moved === void 0) continue;
+    next ??= { ...props };
+    next[name] = moved;
+  }
+  return next ?? props;
+}
+function withChartReduction(layers, floor, options = {}) {
+  const levels = options.levels ?? MAX_REDUCTION_LEVELS;
+  const at = Math.min(floor, options.decideAt ?? floor);
+  const lo = floor - levels;
+  return layers.map((layer) => {
+    const next = { ...layer };
+    const min = layer.minzoom ?? 0;
+    const max = layer.maxzoom ?? 24;
+    if (min <= at && at < max) {
+      if (min > lo) next.minzoom = lo;
+    } else if (max <= at) {
+      next.maxzoom = Math.max(min, Math.min(max, lo));
+    }
+    if (layer.filter !== void 0) next.filter = filterAtFloor(layer.filter, at);
+    const paint = propsReduced(layer.paint, floor, at, levels);
+    if (paint !== void 0) next.paint = paint;
+    const layout = propsReduced(layer.layout, floor, at, levels);
+    if (layout !== void 0) next.layout = layout;
+    return next;
+  });
+}
+
+// src/atlas/served-chart-lock.ts
+var ONLY_SUFFIX = ":only";
+var CHART_LOCK_PARAMS = CHART_LOCK_BANDS.flatMap(({ name }) => {
+  const band = name.toLowerCase();
+  return [band, `${band}${ONLY_SUFFIX}`];
+});
+function chartLockParam(lock) {
+  const band = chartLockBandInfo(lock.band).name.toLowerCase();
+  return lock.bandOnly ? `${band}${ONLY_SUFFIX}` : band;
+}
+function parseChartLock(raw) {
+  const lower = raw.toLowerCase();
+  const bandOnly = lower.endsWith(ONLY_SUFFIX);
+  const name = bandOnly ? lower.slice(0, -ONLY_SUFFIX.length) : lower;
+  const info = CHART_LOCK_BANDS.find((b) => b.name.toLowerCase() === name);
+  return info ? { band: info.band, bandOnly } : null;
+}
+function chartLockGeneratorOptions(lock) {
+  return lock?.bandOnly ? { chartMode: chartLockStyleMode(lock.band) } : {};
+}
+function servedChartLockMetadata(lock) {
+  const info = chartLockBandInfo(lock.band);
+  return {
+    "chrt:lock": chartLockParam(lock),
+    "chrt:lock-band": info.name,
+    "chrt:lock-floor": info.floor,
+    "chrt:lock-min-zoom": chartLockMinZoom(lock.band),
+    "chrt:lock-band-only": lock.bandOnly
+  };
+}
+function withServedChartLock(style, lock, chartSource) {
+  const info = chartLockBandInfo(lock.band);
+  const param = chartLockParam(lock);
+  const layers = withChartReduction(style.layers, info.floor, {
+    decideAt: chartLockDecisionZoom(lock.band, lock.bandOnly)
+  });
+  let sources = style.sources;
+  const chart = style.sources[chartSource];
+  if (lock.bandOnly && chart !== null && typeof chart === "object") {
+    const current = chart.maxzoom;
+    const maxzoom = chartLockSourceMaxzoom(lock.band, typeof current === "number" ? current : CHART_ARCHIVE_MAXZOOM);
+    sources = { ...style.sources, [chartSource]: { ...chart, maxzoom } };
+  }
+  return {
+    ...style,
+    name: `${style.name.replace(/ — chart:[A-Za-z]+$/, "")} \u2014 lock:${param}`,
+    metadata: {
+      ...style.metadata,
+      "chrt:render-mode": "continuous",
+      ...servedChartLockMetadata(lock)
+    },
+    sources,
+    layers
+  };
+}
+
 // src/pagination.ts
 async function* paginate(fetchPage, getItems, getTotalCount, options) {
   const pageSize = options?.pageSize ?? 100;
@@ -35388,8 +35685,11 @@ export {
   BUILD_MAXZOOM,
   BUILD_MINZOOM,
   BUILD_PARAM,
+  CHART_ARCHIVE_MAXZOOM,
   CHART_BAND_CODES,
   CHART_CASCADE_CODES,
+  CHART_LOCK_BANDS,
+  CHART_LOCK_PARAMS,
   CHART_LOOKS,
   CHART_SECTIONS,
   CHART_SOUNDINGS_RULE,
@@ -35418,6 +35718,7 @@ export {
   DANGER_DEPTH_PLACER_ID,
   DANGER_DEPTH_PLACER_LAYOUT,
   DANGER_DEPTH_VISIBLE_LAYOUT,
+  DEFAULT_CHART_LOCK_BAND,
   DEFAULT_CLICK_TOLERANCE,
   DEFAULT_CUSTOM_STYLE_CONFIG,
   DEFAULT_INSPECT_CLASS_RANK,
@@ -35439,6 +35740,7 @@ export {
   EINK_HATCH_PATTERN,
   EINK_MONO_GREYS,
   ENGRAVED_LOOKS,
+  FINER_DATA_DECISION_OFFSET,
   HAZARD_LABEL_PRIORITY,
   INSPECT_CLASS_RANK,
   INSPECT_RANK_DEVIATIONS,
@@ -35466,6 +35768,7 @@ export {
   LOOK_TONES,
   LOOK_WATERLINES_SOURCE,
   MAPLIBRE_DEFAULT_TEXT_PADDING_PX,
+  MAX_REDUCTION_LEVELS,
   NAUTICAL_SYMBOLS,
   NAV_AID_LAYER_GROUPS,
   NAV_AID_QUERY_LAYERS,
@@ -35483,6 +35786,7 @@ export {
   RASTER_ATON_CLASSES,
   RASTER_GLYPH_NAMES,
   RASTER_ICON_PREFIX,
+  REDUCED_SIZE_PROPERTIES,
   RELIEF_ATTRIBUTION,
   RELIEF_ENCODING,
   RELIEF_REGION,
@@ -35578,6 +35882,14 @@ export {
   capLuminance,
   cellBandCharacters,
   cellBandMatch,
+  chartLockBandInfo,
+  chartLockDecisionZoom,
+  chartLockFloor,
+  chartLockGeneratorOptions,
+  chartLockMinZoom,
+  chartLockParam,
+  chartLockSourceMaxzoom,
+  chartLockStyleMode,
   chartSymbolSizingCensus,
   chrtAtonTintExpression,
   chrtHouseColor,
@@ -35617,6 +35929,7 @@ export {
   extinguishedLightExpression,
   extractNavAidDesignation,
   featureIdentity,
+  filterAtFloor,
   formatDayboard,
   formatLightDescription,
   formatLightRhythm,
@@ -35653,6 +35966,7 @@ export {
   hazardFillExpression,
   iconExpressionForFamily,
   iconSliderFor,
+  isChartLockBand,
   isDangerDepthPlacer,
   isDepthAreaClassLayerId,
   isDrapeable,
@@ -35691,6 +36005,7 @@ export {
   normalizeTheme,
   opaqueSplitBaseOf,
   paginate,
+  parseChartLock,
   parseChartLook,
   parseListCodes,
   parseSigseqTerms,
@@ -35720,6 +36035,7 @@ export {
   seafloorLayers,
   sectorLimitToArcBearing,
   semiboldFontStack,
+  servedChartLockMetadata,
   snapChartSymbolScale,
   soundingPadding,
   soundingPaddingValue,
@@ -35732,8 +36048,10 @@ export {
   themeChrtGlyph,
   tileTemplate,
   uncoveredSectorArcs,
+  withChartReduction,
   withClassicMarks,
   withLook,
+  withServedChartLock,
   withWaterLines,
   withinBboxFilter,
   worldMinusBboxPolygon