@sportsdataverse/sdvplot 0.1.0 → 0.2.0

package/dist/maplibre.d.ts

@@ -0,0 +1,271 @@
+import { GeoJSONSourceSpecification, Map, SymbolLayerSpecification, LineLayerSpecification } from 'maplibre-gl';
+import { a as DrawnMark, R as Row } from './_web-D7Aa5Rd8.js';
+import { L as League, S as SeasonInput, V as Variant, I as IdSystem, W as Which } from './types-C7n6gJF3.js';
+
+/**
+ * The MapLibre GL JS 6 adapter: team logos as a native `symbol` layer (`logoSymbols`, with `addLogoImages` to load
+ * each logo once into the map's images), team-coloured travel lines as a `line` layer (`routeLines`), and a free,
+ * keyless basemap (`basemap`, OpenFreeMap). Each builder returns plain style JSON: a GeoJSON source and a layer that
+ * reads it, for `map.addSource(set.id, set.source)` and `map.addLayer(set.layer)`. Pure: `maplibre-gl` (an optional
+ * peer, 6.14 or later) is never imported at runtime, only its types; the map is passed in. For deck.gl layers on a
+ * MapLibre map, hand `@sportsdataverse/sdvplot/deckgl`'s `logoIconLayer` / `passArcLayer` props to deck.gl's layers
+ * inside `@deck.gl/mapbox`'s `MapboxOverlay`. Synchronous builders: call after `loadLeague(league)` / `preloadAll()`.
+ */
+
+/** `logoSymbols` options. */
+interface LogoSymbolOptions {
+    /** Name of the row column holding each logo's longitude. */
+    x: string;
+    /** Name of the row column holding each logo's latitude. */
+    y: string;
+    /** Name of the row column holding the team (abbreviation, name or id, a number or a string; see `idSystem`). */
+    team: string;
+    /** The league the teams belong to, e.g. "nfl". */
+    league: League;
+    /** A season (number or string) for every row, or the name of a row column holding each row's season. */
+    season?: SeasonInput;
+    /** Logo variant, e.g. "dark". Default "default". */
+    variant?: Variant;
+    /** How the `team` values are read. Default "auto". */
+    idSystem?: IdSystem;
+    /** The logo's height on screen in px, 1 or more. Default 32. */
+    size?: number;
+    /** The logos' opacity in [0, 1] (`icon-opacity`). Default 1. */
+    alpha?: number;
+    /** The source and layer id. Default "sdvplot-logos". */
+    id?: string;
+}
+/** A logo feature's properties. */
+interface LogoProperties {
+    /** The resolved team id. */
+    team: string;
+    /** The map image the symbol draws (`icon-image`), one per logo and size. */
+    icon: string;
+    /** The logo's URL. */
+    url: string;
+    /** The row's position in the input (left-out rows leave gaps). */
+    index: number;
+}
+/** One logo the map needs as an image: `addLogoImages` loads `url` and adds it as `id`, drawn `height` px tall. */
+interface LogoImage {
+    id: string;
+    url: string;
+    height: number;
+}
+/** A GeoJSON point: [longitude, latitude]. */
+interface PointGeometry {
+    type: "Point";
+    coordinates: [lon: number, lat: number];
+}
+/** A GeoJSON line through [longitude, latitude] positions. */
+interface LineGeometry {
+    type: "LineString";
+    coordinates: [lon: number, lat: number][];
+}
+/** A GeoJSON feature; its id is the row's index in the input. */
+interface Feature<G, P> {
+    type: "Feature";
+    id: number;
+    geometry: G;
+    properties: P;
+}
+/** A GeoJSON source holding a feature collection: `map.addSource(id, source)`. */
+type FeatureSource<G, P> = GeoJSONSourceSpecification & {
+    type: "geojson";
+    data: {
+        type: "FeatureCollection";
+        features: Feature<G, P>[];
+    };
+};
+/** `logoSymbols`' result: a source and a symbol layer for the map, and the images that layer draws. */
+interface LogoSymbols {
+    /** The source id (the layer's own id too). */
+    id: string;
+    /** One point feature per drawn row; the feature id is the row's index. */
+    source: FeatureSource<PointGeometry, LogoProperties>;
+    layer: SymbolLayerSpecification;
+    /** One per distinct logo: what `addLogoImages` loads. */
+    images: LogoImage[];
+}
+/** `routeLines` options. */
+interface RouteLineOptions {
+    /** Name of the row column holding each leg's start longitude. */
+    x: string;
+    /** Name of the row column holding each leg's start latitude. */
+    y: string;
+    /** Name of the row column holding each leg's end longitude. */
+    xend: string;
+    /** Name of the row column holding each leg's end latitude. */
+    yend: string;
+    /** Name of the row column holding the team the leg is coloured by. */
+    team: string;
+    /** The league the teams belong to, e.g. "nfl". */
+    league: League;
+    /** The season the teams are resolved for. */
+    season?: SeasonInput;
+    /** How the `team` values are read. Default "auto". */
+    idSystem?: IdSystem;
+    /** "primary" (default) or "secondary" colour. */
+    which?: Which;
+    /**
+     * The basemap's background (`basemap("dark").background` under the dark basemap). Given, every team colour keeps 3:1
+     * contrast against it and aims to stay distinct from the other teams' (CIE76 ΔE of 20 or more), through the shared
+     * team palette, as `teamColorPalette` does in the other adapters.
+     */
+    background?: string;
+    /** The colour of a team that does not resolve, or has no colour. Default "#808080". */
+    fallback?: string;
+    /** The line's width in px, 1 or more. Default 3. */
+    width?: number;
+    /** The lines' opacity in [0, 1] (`line-opacity`). Default 1. */
+    alpha?: number;
+    /** The source and layer id. Default "sdvplot-routes". */
+    id?: string;
+}
+/** A route feature's properties. */
+interface RouteProperties {
+    /** The resolved team id, or the row's own value as text when it does not resolve. */
+    team: string;
+    /** The line's colour, `#rrggbb`. */
+    color: string;
+    /** The row's position in the input (left-out rows leave gaps). */
+    index: number;
+}
+/** `routeLines`' result: a source and a line layer for the map. */
+interface RouteLines {
+    id: string;
+    /** One two-point line per drawn row; the feature id is the row's index. */
+    source: FeatureSource<LineGeometry, RouteProperties>;
+    layer: LineLayerSpecification;
+}
+/** The map methods `addLogoImages` calls: a MapLibre `Map`. */
+type LogoImageMap = Pick<Map, "loadImage" | "addImage" | "hasImage">;
+/**
+ * Each row's team logo at its (longitude, latitude), as a GeoJSON source and a MapLibre `symbol` layer: one point
+ * feature per row (its `id` is the row's index; `team`, `icon`, `url` and `index` are its properties), and a layer
+ * drawing `icon-image: ["get", "icon"]`, every logo shown even where two overlap. A team with no logo (or one that
+ * does not resolve) is left out with one warning; so is a row with a missing, non-numeric or infinite coordinate (a
+ * numeric string such as "-94.7" is read as its number). Team values may be numbers or strings (ESPN ids,
+ * abbreviations, names). The map needs the logos as images first:
+ * `await addLogoImages(map, logos)`, then `map.addSource(logos.id, logos.source)` and `map.addLayer(logos.layer)`.
+ *
+ * @example
+ * ```ts
+ * import { loadLeague } from "@sportsdataverse/sdvplot";
+ * import { logoSymbols } from "@sportsdataverse/sdvplot/maplibre";
+ *
+ * await loadLeague("nfl");
+ * // Kansas City's home airport, from nflverse's nfldata airports.csv
+ * const logos = logoSymbols([{ team: "KC", lon: -94.714, lat: 39.297 }], {
+ *   x: "lon",
+ *   y: "lat",
+ *   team: "team",
+ *   league: "nfl",
+ *   size: 40,
+ * });
+ * // in the browser: await addLogoImages(map, logos); map.addSource(logos.id, logos.source); map.addLayer(logos.layer)
+ * logos.source.data.features[0]?.properties.icon;
+ * ```
+ */
+declare function logoSymbols(rows: readonly Row[], o: LogoSymbolOptions): LogoSymbols;
+/**
+ * Loads each logo of `logoSymbols` sets into the map's images, once: `map.loadImage(url)`, then
+ * `map.addImage(id, image, { pixelRatio })`, the pixel ratio making the image draw `size` px tall at icon size 1 (and
+ * stay sharp on a high-density screen). An image the map already has is skipped, so calling it again adds nothing
+ * twice. `map.setStyle` drops the map's images, sources and layers: on the map's `style.load` event, call it again
+ * (it adds back only what the new style lacks) and re-add the source and layer. A logo that fails to load is left undrawn with one
+ * warning. Resolves when every image is in. Call it before adding the layers that draw them.
+ *
+ * @example
+ * ```ts
+ * import { loadLeague } from "@sportsdataverse/sdvplot";
+ * import { addLogoImages, logoSymbols } from "@sportsdataverse/sdvplot/maplibre";
+ *
+ * await loadLeague("nfl");
+ * const logos = logoSymbols([{ team: "KC", lon: -94.714, lat: 39.297 }], { x: "lon", y: "lat", team: "team", league: "nfl" });
+ * // a stand-in for a MapLibre map (in the browser: the map from `new maplibregl.Map(...)`, once it has loaded)
+ * const added: string[] = [];
+ * const map = {
+ *   hasImage: (id: string) => added.includes(id),
+ *   loadImage: async () => ({ data: { width: 500, height: 500 } as ImageBitmap }),
+ *   addImage(id: string) {
+ *     added.push(id);
+ *     return this;
+ *   },
+ * };
+ * await addLogoImages(map as never, logos);
+ * added;
+ * ```
+ */
+declare function addLogoImages(map: LogoImageMap, ...sets: readonly LogoSymbols[]): Promise<void>;
+/**
+ * Team-coloured travel legs as a GeoJSON source and a MapLibre `line` layer: one straight line per row from (x, y) to
+ * (xend, yend) in longitude and latitude, in the team's colour (`line-color: ["get", "color"]`). Each team keeps one
+ * colour, from the shared team palette; with `background` the colours read on the basemap (dark mode) and stay
+ * distinct. A team that does not resolve takes `fallback`. A coordinate may be a number or a numeric string, as for
+ * `logoSymbols`; a row with a missing, non-numeric or infinite one is left out with one warning. The feature id is the row's index. The same rows feed `./deckgl`'s `passArcLayer` for arcs instead.
+ *
+ * @example
+ * ```ts
+ * import { loadLeague } from "@sportsdataverse/sdvplot";
+ * import { routeLines } from "@sportsdataverse/sdvplot/maplibre";
+ *
+ * await loadLeague("nfl");
+ * // Kansas City to Buffalo, airport to airport (nflverse nfldata airports.csv): week 11 of 2024
+ * const leg = { team: "KC", lon: -94.714, lat: 39.297, lon_end: -78.732, lat_end: 42.94 };
+ * const routes = routeLines([leg], { x: "lon", y: "lat", xend: "lon_end", yend: "lat_end", team: "team", league: "nfl" });
+ * // in the browser: map.addSource(routes.id, routes.source); map.addLayer(routes.layer)
+ * routes.source.data.features[0]?.properties.color;
+ * ```
+ */
+declare function routeLines(rows: readonly Row[], o: RouteLineOptions): RouteLines;
+/** `basemap`'s result. */
+interface Basemap {
+    /** The style URL, for the map's `style` option. */
+    style: string;
+    /**
+     * The provider's credit (HTML). MapLibre shows it by itself from the style's source, in its attribution control (on
+     * by default; keep it). Anything else that draws these tiles, or a static export of the map, must show it.
+     */
+    attribution: string;
+    /**
+     * The colour of the style's `background` layer, the land (read from the style on 2026-10-27), for `routeLines`' and
+     * `passArcLayer`'s `background` (dark mode). Their 3:1 contrast is measured against it, not against the water,
+     * which is a little lighter on the dark style (#1b1b1d) and a little darker on the light one (#c2c8ca).
+     */
+    background: string;
+}
+/**
+ * A free basemap that needs no API key: OpenFreeMap's `positron` (light) or `dark` vector style, built from
+ * OpenStreetMap data. Pass `style` to `new maplibregl.Map({ style })`. OpenFreeMap's public instance asks for no
+ * registration or key and sets no request limit; the credit is required, and MapLibre's attribution control shows it
+ * from the style's source (`attribution` is the same text, for anything else). Each map view requests the
+ * provider's tiles: build or test pages without a map, or serve a local style.
+ *
+ * @example
+ * ```ts
+ * import { basemap } from "@sportsdataverse/sdvplot/maplibre";
+ *
+ * const { style, background } = basemap("dark");
+ * // in the browser: new maplibregl.Map({ container, style, center: [-96, 38], zoom: 3 })
+ * [style, background];
+ * ```
+ */
+declare function basemap(theme?: "light" | "dark"): Basemap;
+/**
+ * What `logoSymbols` sets draw, as `[team, longitude, latitude, px, url]` per feature, in order: the module's test
+ * hook, as the other adapters' `drawnMarks`.
+ *
+ * @example
+ * ```ts
+ * import { loadLeague } from "@sportsdataverse/sdvplot";
+ * import { drawnMarks, logoSymbols } from "@sportsdataverse/sdvplot/maplibre";
+ *
+ * await loadLeague("nfl");
+ * // 12 is Kansas City's ESPN team id
+ * drawnMarks(logoSymbols([{ team: 12, lon: -94.714, lat: 39.297 }], { x: "lon", y: "lat", team: "team", league: "nfl" }));
+ * ```
+ */
+declare function drawnMarks(...sets: readonly LogoSymbols[]): DrawnMark[];
+
+export { type Basemap, DrawnMark, type Feature, type FeatureSource, type LineGeometry, type LogoImage, type LogoImageMap, type LogoProperties, type LogoSymbolOptions, type LogoSymbols, type PointGeometry, type RouteLineOptions, type RouteLines, type RouteProperties, Row, addLogoImages, basemap, drawnMarks, logoSymbols, routeLines };

package/dist/maplibre.js

@@ -0,0 +1,175 @@
+import { contentId } from './chunk-WQT4IVLX.js';
+import { markPlacements, column, colorPalette } from './chunk-UL5M6KDE.js';
+import { checkAlpha } from './chunk-7ULOCCFL.js';
+import { resolveSync, normValue } from './chunk-ZAEQXFJM.js';
+import './chunk-J6R2LEJ7.js';
+import { warn, InputError } from './chunk-E7G7VSLV.js';
+
+// src/maplibre.ts
+var real = (v) => typeof v === "number" && Number.isFinite(v);
+function coord(v) {
+  const n = typeof v === "number" ? v : typeof v === "string" && v.trim() !== "" ? Number(v) : Number.NaN;
+  return Number.isFinite(n) ? n : null;
+}
+function skippedRows(key, what, teams) {
+  if (teams.length === 0) return;
+  const shown = teams.slice(0, 10).map(String).join(", ") + (teams.length > 10 ? ` and ${teams.length - 10} more` : "");
+  warn(`${key}:${shown}`, `skipped ${teams.length} ${what} with a missing coordinate: ${shown}`);
+}
+function checkPx(name, v) {
+  if (!real(v) || v < 1) throw new InputError(`${name} is in px, 1 or more, got ${String(v)}`);
+  return v;
+}
+function logoSymbols(rows, o) {
+  const size = checkPx("size", o.size ?? 32);
+  const opacity = checkAlpha(o.alpha ?? 1);
+  const id = o.id ?? "sdvplot-logos";
+  const images = /* @__PURE__ */ new Map();
+  const placed = markPlacements(rows, "logo", o);
+  const at = placed.map((p) => [coord(p.x), coord(p.y)]);
+  skippedRows(
+    `maplibre:logos:${o.league}:missing`,
+    "logo(s)",
+    placed.filter((_, k) => at[k]?.includes(null)).map((p) => p.id)
+  );
+  const features = placed.flatMap((p, k) => {
+    const [lon, lat] = at[k];
+    if (lon === null || lat === null) return [];
+    const icon = `${contentId("sdv-logo", p.url)}-${size}`;
+    if (!images.has(icon)) images.set(icon, { id: icon, url: p.url, height: size });
+    return [
+      {
+        type: "Feature",
+        id: p.index,
+        geometry: { type: "Point", coordinates: [lon, lat] },
+        properties: { team: p.id, icon, url: p.url, index: p.index }
+      }
+    ];
+  });
+  return {
+    id,
+    source: { type: "geojson", data: { type: "FeatureCollection", features } },
+    layer: {
+      id,
+      type: "symbol",
+      source: id,
+      layout: {
+        "icon-image": ["get", "icon"],
+        "icon-allow-overlap": true,
+        "icon-ignore-placement": true
+      },
+      paint: { "icon-opacity": opacity }
+    },
+    images: [...images.values()]
+  };
+}
+async function addLogoImages(map, ...sets) {
+  const want = new Map(sets.flatMap((s) => s.images).map((im) => [im.id, im]));
+  await Promise.all(
+    [...want.values()].map(async (im) => {
+      if (map.hasImage(im.id)) return;
+      let image;
+      try {
+        image = (await map.loadImage(im.url)).data;
+      } catch (e) {
+        warn(`maplibre:image:${im.url}`, `could not load the logo ${im.url}: ${String(e)}`);
+        return;
+      }
+      if (map.hasImage(im.id)) return;
+      map.addImage(im.id, image, { pixelRatio: image.height / im.height });
+    })
+  );
+}
+var label = (t) => t === null || t === void 0 ? "" : typeof t === "number" ? normValue(t) ?? "" : String(t);
+function routeLines(rows, o) {
+  const width = checkPx("width", o.width ?? 3);
+  const opacity = checkAlpha(o.alpha ?? 1);
+  const id = o.id ?? "sdvplot-routes";
+  const cols = [o.x, o.y, o.xend, o.yend].map(
+    (c, k) => column(rows, c, ["x", "y", "xend", "yend"][k])
+  );
+  const teams = column(rows, o.team, "team");
+  const at = rows.map((_, i) => cols.map((c) => coord(c[i])));
+  const keep = rows.flatMap((_, i) => at[i]?.includes(null) ? [] : [i]);
+  skippedRows(
+    `maplibre:routes:${o.league}:missing`,
+    "route leg(s)",
+    rows.flatMap((_, i) => at[i]?.includes(null) ? [teams[i]] : [])
+  );
+  const kept = keep.map((i) => teams[i]);
+  const ro = {
+    ...o.season === void 0 ? {} : { season: o.season },
+    ...o.idSystem === void 0 ? {} : { idSystem: o.idSystem }
+  };
+  const resolved = resolveSync(kept, o.league, ro);
+  const keys = kept.map((t, j) => resolved[j] ?? `?${label(t)}`);
+  const distinct = [...new Set(keys)];
+  const known = distinct.filter((k) => !k.startsWith("?"));
+  const palette = colorPalette(o.league, known, {
+    ...ro,
+    idSystem: "team_id",
+    ...o.which === void 0 ? {} : { which: o.which },
+    ...o.background === void 0 ? {} : { background: o.background },
+    ...o.fallback === void 0 ? {} : { fallback: o.fallback }
+  });
+  const colorOf = new Map(known.map((k, j) => [k, palette[j]]));
+  const fallback = o.fallback ?? "#808080";
+  const features = keep.map((i, j) => {
+    const c = at[i];
+    return {
+      type: "Feature",
+      id: i,
+      geometry: {
+        type: "LineString",
+        coordinates: [
+          [c[0], c[1]],
+          [c[2], c[3]]
+        ]
+      },
+      properties: {
+        team: resolved[j] ?? label(kept[j]),
+        color: colorOf.get(keys[j]) ?? fallback,
+        index: i
+      }
+    };
+  });
+  return {
+    id,
+    source: { type: "geojson", data: { type: "FeatureCollection", features } },
+    layer: {
+      id,
+      type: "line",
+      source: id,
+      layout: { "line-cap": "round", "line-join": "round" },
+      paint: { "line-color": ["get", "color"], "line-width": width, "line-opacity": opacity }
+    }
+  };
+}
+var OPENFREEMAP_ATTRIBUTION = '<a href="https://openfreemap.org" target="_blank">OpenFreeMap</a> <a href="https://www.openmaptiles.org/" target="_blank">&copy; OpenMapTiles</a> Data from <a href="https://www.openstreetmap.org/copyright" target="_blank">OpenStreetMap</a>';
+var STYLES = {
+  light: { style: "https://tiles.openfreemap.org/styles/positron", background: "#f2f3f0" },
+  dark: { style: "https://tiles.openfreemap.org/styles/dark", background: "#0c0c0c" }
+};
+function basemap(theme = "light") {
+  const s = STYLES[theme];
+  if (s === void 0) throw new InputError(`theme is "light" or "dark", got ${JSON.stringify(theme)}`);
+  return { ...s, attribution: OPENFREEMAP_ATTRIBUTION };
+}
+function drawnMarks(...sets) {
+  return sets.flatMap((s) => {
+    const px = new Map(s.images.map((im) => [im.id, im.height]));
+    return s.source.data.features.map(
+      (f) => [
+        f.properties.team,
+        f.geometry.coordinates[0],
+        f.geometry.coordinates[1],
+        px.get(f.properties.icon),
+        f.properties.url
+      ]
+    );
+  });
+}
+
+export { addLogoImages, basemap, drawnMarks, logoSymbols, routeLines };
+//# sourceMappingURL=maplibre.js.map
+//# sourceMappingURL=maplibre.js.map

package/dist/maplibre.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/maplibre.ts"],"names":[],"mappings":"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","file":"maplibre.js","sourcesContent":["/**\n * The MapLibre GL JS 6 adapter: team logos as a native `symbol` layer (`logoSymbols`, with `addLogoImages` to load\n * each logo once into the map's images), team-coloured travel lines as a `line` layer (`routeLines`), and a free,\n * keyless basemap (`basemap`, OpenFreeMap). Each builder returns plain style JSON: a GeoJSON source and a layer that\n * reads it, for `map.addSource(set.id, set.source)` and `map.addLayer(set.layer)`. Pure: `maplibre-gl` (an optional\n * peer, 6.14 or later) is never imported at runtime, only its types; the map is passed in. For deck.gl layers on a\n * MapLibre map, hand `@sportsdataverse/sdvplot/deckgl`'s `logoIconLayer` / `passArcLayer` props to deck.gl's layers\n * inside `@deck.gl/mapbox`'s `MapboxOverlay`. Synchronous builders: call after `loadLeague(league)` / `preloadAll()`.\n */\nimport type {\n  GeoJSONSourceSpecification,\n  LineLayerSpecification,\n  Map as MapLibreMap,\n  SymbolLayerSpecification,\n} from \"maplibre-gl\";\nimport { type DrawnMark, type Row, checkAlpha, colorPalette, column, markPlacements } from \"./_web.js\";\nimport { contentId } from \"./content-id.js\";\nimport { InputError, warn } from \"./errors.js\";\nimport { normValue } from \"./normalize.js\";\nimport { type Value, resolveSync } from \"./resolve.js\";\nimport type { IdSystem, League, SeasonInput, Variant, Which } from \"./types.js\";\n\nexport type { DrawnMark, Row } from \"./_web.js\";\n\n/** `logoSymbols` options. */\nexport interface LogoSymbolOptions {\n  /** Name of the row column holding each logo's longitude. */\n  x: string;\n  /** Name of the row column holding each logo's latitude. */\n  y: string;\n  /** Name of the row column holding the team (abbreviation, name or id, a number or a string; see `idSystem`). */\n  team: string;\n  /** The league the teams belong to, e.g. \"nfl\". */\n  league: League;\n  /** A season (number or string) for every row, or the name of a row column holding each row's season. */\n  season?: SeasonInput;\n  /** Logo variant, e.g. \"dark\". Default \"default\". */\n  variant?: Variant;\n  /** How the `team` values are read. Default \"auto\". */\n  idSystem?: IdSystem;\n  /** The logo's height on screen in px, 1 or more. Default 32. */\n  size?: number;\n  /** The logos' opacity in [0, 1] (`icon-opacity`). Default 1. */\n  alpha?: number;\n  /** The source and layer id. Default \"sdvplot-logos\". */\n  id?: string;\n}\n/** A logo feature's properties. */\nexport interface LogoProperties {\n  /** The resolved team id. */\n  team: string;\n  /** The map image the symbol draws (`icon-image`), one per logo and size. */\n  icon: string;\n  /** The logo's URL. */\n  url: string;\n  /** The row's position in the input (left-out rows leave gaps). */\n  index: number;\n}\n/** One logo the map needs as an image: `addLogoImages` loads `url` and adds it as `id`, drawn `height` px tall. */\nexport interface LogoImage {\n  id: string;\n  url: string;\n  height: number;\n}\n/** A GeoJSON point: [longitude, latitude]. */\nexport interface PointGeometry {\n  type: \"Point\";\n  coordinates: [lon: number, lat: number];\n}\n/** A GeoJSON line through [longitude, latitude] positions. */\nexport interface LineGeometry {\n  type: \"LineString\";\n  coordinates: [lon: number, lat: number][];\n}\n/** A GeoJSON feature; its id is the row's index in the input. */\nexport interface Feature<G, P> {\n  type: \"Feature\";\n  id: number;\n  geometry: G;\n  properties: P;\n}\n/** A GeoJSON source holding a feature collection: `map.addSource(id, source)`. */\nexport type FeatureSource<G, P> = GeoJSONSourceSpecification & {\n  type: \"geojson\";\n  data: { type: \"FeatureCollection\"; features: Feature<G, P>[] };\n};\n/** `logoSymbols`' result: a source and a symbol layer for the map, and the images that layer draws. */\nexport interface LogoSymbols {\n  /** The source id (the layer's own id too). */\n  id: string;\n  /** One point feature per drawn row; the feature id is the row's index. */\n  source: FeatureSource<PointGeometry, LogoProperties>;\n  layer: SymbolLayerSpecification;\n  /** One per distinct logo: what `addLogoImages` loads. */\n  images: LogoImage[];\n}\n\n/** `routeLines` options. */\nexport interface RouteLineOptions {\n  /** Name of the row column holding each leg's start longitude. */\n  x: string;\n  /** Name of the row column holding each leg's start latitude. */\n  y: string;\n  /** Name of the row column holding each leg's end longitude. */\n  xend: string;\n  /** Name of the row column holding each leg's end latitude. */\n  yend: string;\n  /** Name of the row column holding the team the leg is coloured by. */\n  team: string;\n  /** The league the teams belong to, e.g. \"nfl\". */\n  league: League;\n  /** The season the teams are resolved for. */\n  season?: SeasonInput;\n  /** How the `team` values are read. Default \"auto\". */\n  idSystem?: IdSystem;\n  /** \"primary\" (default) or \"secondary\" colour. */\n  which?: Which;\n  /**\n   * The basemap's background (`basemap(\"dark\").background` under the dark basemap). Given, every team colour keeps 3:1\n   * contrast against it and aims to stay distinct from the other teams' (CIE76 ΔE of 20 or more), through the shared\n   * team palette, as `teamColorPalette` does in the other adapters.\n   */\n  background?: string;\n  /** The colour of a team that does not resolve, or has no colour. Default \"#808080\". */\n  fallback?: string;\n  /** The line's width in px, 1 or more. Default 3. */\n  width?: number;\n  /** The lines' opacity in [0, 1] (`line-opacity`). Default 1. */\n  alpha?: number;\n  /** The source and layer id. Default \"sdvplot-routes\". */\n  id?: string;\n}\n/** A route feature's properties. */\nexport interface RouteProperties {\n  /** The resolved team id, or the row's own value as text when it does not resolve. */\n  team: string;\n  /** The line's colour, `#rrggbb`. */\n  color: string;\n  /** The row's position in the input (left-out rows leave gaps). */\n  index: number;\n}\n/** `routeLines`' result: a source and a line layer for the map. */\nexport interface RouteLines {\n  id: string;\n  /** One two-point line per drawn row; the feature id is the row's index. */\n  source: FeatureSource<LineGeometry, RouteProperties>;\n  layer: LineLayerSpecification;\n}\n\n/** The map methods `addLogoImages` calls: a MapLibre `Map`. */\nexport type LogoImageMap = Pick<MapLibreMap, \"loadImage\" | \"addImage\" | \"hasImage\">;\n\nconst real = (v: unknown): v is number => typeof v === \"number\" && Number.isFinite(v);\n/**\n * A longitude or latitude as a number: a finite number, or a string that reads as one (\"-94.7\", as a CSV gives it).\n * Anything else (missing, blank, not a number, infinite) is null: the row is left out.\n */\nfunction coord(v: unknown): number | null {\n  const n = typeof v === \"number\" ? v : typeof v === \"string\" && v.trim() !== \"\" ? Number(v) : Number.NaN;\n  return Number.isFinite(n) ? n : null;\n}\n/** One warning for the rows left out for a coordinate, naming their teams. */\nfunction skippedRows(key: string, what: string, teams: readonly Value[]): void {\n  if (teams.length === 0) return;\n  const shown =\n    teams.slice(0, 10).map(String).join(\", \") + (teams.length > 10 ? ` and ${teams.length - 10} more` : \"\");\n  warn(`${key}:${shown}`, `skipped ${teams.length} ${what} with a missing coordinate: ${shown}`);\n}\nfunction checkPx(name: string, v: unknown): number {\n  if (!real(v) || v < 1) throw new InputError(`${name} is in px, 1 or more, got ${String(v)}`);\n  return v;\n}\n\n/**\n * Each row's team logo at its (longitude, latitude), as a GeoJSON source and a MapLibre `symbol` layer: one point\n * feature per row (its `id` is the row's index; `team`, `icon`, `url` and `index` are its properties), and a layer\n * drawing `icon-image: [\"get\", \"icon\"]`, every logo shown even where two overlap. A team with no logo (or one that\n * does not resolve) is left out with one warning; so is a row with a missing, non-numeric or infinite coordinate (a\n * numeric string such as \"-94.7\" is read as its number). Team values may be numbers or strings (ESPN ids,\n * abbreviations, names). The map needs the logos as images first:\n * `await addLogoImages(map, logos)`, then `map.addSource(logos.id, logos.source)` and `map.addLayer(logos.layer)`.\n *\n * @example\n * ```ts\n * import { loadLeague } from \"@sportsdataverse/sdvplot\";\n * import { logoSymbols } from \"@sportsdataverse/sdvplot/maplibre\";\n *\n * await loadLeague(\"nfl\");\n * // Kansas City's home airport, from nflverse's nfldata airports.csv\n * const logos = logoSymbols([{ team: \"KC\", lon: -94.714, lat: 39.297 }], {\n *   x: \"lon\",\n *   y: \"lat\",\n *   team: \"team\",\n *   league: \"nfl\",\n *   size: 40,\n * });\n * // in the browser: await addLogoImages(map, logos); map.addSource(logos.id, logos.source); map.addLayer(logos.layer)\n * logos.source.data.features[0]?.properties.icon;\n * ```\n */\nexport function logoSymbols(rows: readonly Row[], o: LogoSymbolOptions): LogoSymbols {\n  const size = checkPx(\"size\", o.size ?? 32);\n  const opacity = checkAlpha(o.alpha ?? 1);\n  const id = o.id ?? \"sdvplot-logos\";\n  const images = new Map<string, LogoImage>();\n  // placeSync leaves out a null or NaN coordinate; a value that is not a number, or not finite, is left out here\n  const placed = markPlacements(rows, \"logo\", o);\n  const at = placed.map((p) => [coord(p.x), coord(p.y)] as const);\n  skippedRows(\n    `maplibre:logos:${o.league}:missing`,\n    \"logo(s)\",\n    placed.filter((_, k) => at[k]?.includes(null)).map((p) => p.id),\n  );\n  const features = placed.flatMap((p, k): Feature<PointGeometry, LogoProperties>[] => {\n    const [lon, lat] = at[k] as readonly [number | null, number | null];\n    if (lon === null || lat === null) return [];\n    const icon = `${contentId(\"sdv-logo\", p.url)}-${size}`;\n    if (!images.has(icon)) images.set(icon, { id: icon, url: p.url, height: size });\n    return [\n      {\n        type: \"Feature\",\n        id: p.index,\n        geometry: { type: \"Point\", coordinates: [lon, lat] },\n        properties: { team: p.id, icon, url: p.url, index: p.index },\n      },\n    ];\n  });\n  return {\n    id,\n    source: { type: \"geojson\", data: { type: \"FeatureCollection\", features } },\n    layer: {\n      id,\n      type: \"symbol\",\n      source: id,\n      layout: {\n        \"icon-image\": [\"get\", \"icon\"],\n        \"icon-allow-overlap\": true,\n        \"icon-ignore-placement\": true,\n      },\n      paint: { \"icon-opacity\": opacity },\n    },\n    images: [...images.values()],\n  };\n}\n\n/**\n * Loads each logo of `logoSymbols` sets into the map's images, once: `map.loadImage(url)`, then\n * `map.addImage(id, image, { pixelRatio })`, the pixel ratio making the image draw `size` px tall at icon size 1 (and\n * stay sharp on a high-density screen). An image the map already has is skipped, so calling it again adds nothing\n * twice. `map.setStyle` drops the map's images, sources and layers: on the map's `style.load` event, call it again\n * (it adds back only what the new style lacks) and re-add the source and layer. A logo that fails to load is left undrawn with one\n * warning. Resolves when every image is in. Call it before adding the layers that draw them.\n *\n * @example\n * ```ts\n * import { loadLeague } from \"@sportsdataverse/sdvplot\";\n * import { addLogoImages, logoSymbols } from \"@sportsdataverse/sdvplot/maplibre\";\n *\n * await loadLeague(\"nfl\");\n * const logos = logoSymbols([{ team: \"KC\", lon: -94.714, lat: 39.297 }], { x: \"lon\", y: \"lat\", team: \"team\", league: \"nfl\" });\n * // a stand-in for a MapLibre map (in the browser: the map from `new maplibregl.Map(...)`, once it has loaded)\n * const added: string[] = [];\n * const map = {\n *   hasImage: (id: string) => added.includes(id),\n *   loadImage: async () => ({ data: { width: 500, height: 500 } as ImageBitmap }),\n *   addImage(id: string) {\n *     added.push(id);\n *     return this;\n *   },\n * };\n * await addLogoImages(map as never, logos);\n * added;\n * ```\n */\nexport async function addLogoImages(map: LogoImageMap, ...sets: readonly LogoSymbols[]): Promise<void> {\n  const want = new Map(sets.flatMap((s) => s.images).map((im) => [im.id, im]));\n  await Promise.all(\n    [...want.values()].map(async (im) => {\n      if (map.hasImage(im.id)) return;\n      let image: HTMLImageElement | ImageBitmap;\n      try {\n        image = (await map.loadImage(im.url)).data;\n      } catch (e) {\n        warn(`maplibre:image:${im.url}`, `could not load the logo ${im.url}: ${String(e)}`);\n        return;\n      }\n      if (map.hasImage(im.id)) return; // another call added it while this one loaded\n      map.addImage(im.id, image, { pixelRatio: image.height / im.height });\n    }),\n  );\n}\n\n/** An unresolved team value as text: a number without \".0\", a missing one empty (as `./deckgl`'s arcs). */\nconst label = (t: unknown): string =>\n  t === null || t === undefined ? \"\" : typeof t === \"number\" ? (normValue(t) ?? \"\") : String(t);\n\n/**\n * Team-coloured travel legs as a GeoJSON source and a MapLibre `line` layer: one straight line per row from (x, y) to\n * (xend, yend) in longitude and latitude, in the team's colour (`line-color: [\"get\", \"color\"]`). Each team keeps one\n * colour, from the shared team palette; with `background` the colours read on the basemap (dark mode) and stay\n * distinct. A team that does not resolve takes `fallback`. A coordinate may be a number or a numeric string, as for\n * `logoSymbols`; a row with a missing, non-numeric or infinite one is left out with one warning. The feature id is the row's index. The same rows feed `./deckgl`'s `passArcLayer` for arcs instead.\n *\n * @example\n * ```ts\n * import { loadLeague } from \"@sportsdataverse/sdvplot\";\n * import { routeLines } from \"@sportsdataverse/sdvplot/maplibre\";\n *\n * await loadLeague(\"nfl\");\n * // Kansas City to Buffalo, airport to airport (nflverse nfldata airports.csv): week 11 of 2024\n * const leg = { team: \"KC\", lon: -94.714, lat: 39.297, lon_end: -78.732, lat_end: 42.94 };\n * const routes = routeLines([leg], { x: \"lon\", y: \"lat\", xend: \"lon_end\", yend: \"lat_end\", team: \"team\", league: \"nfl\" });\n * // in the browser: map.addSource(routes.id, routes.source); map.addLayer(routes.layer)\n * routes.source.data.features[0]?.properties.color;\n * ```\n */\nexport function routeLines(rows: readonly Row[], o: RouteLineOptions): RouteLines {\n  const width = checkPx(\"width\", o.width ?? 3);\n  const opacity = checkAlpha(o.alpha ?? 1);\n  const id = o.id ?? \"sdvplot-routes\";\n  const cols = [o.x, o.y, o.xend, o.yend].map((c, k) =>\n    column(rows, c, [\"x\", \"y\", \"xend\", \"yend\"][k] as string),\n  );\n  const teams = column(rows, o.team, \"team\");\n  // each row's four coordinates as numbers (a numeric string is read as one), or null\n  const at = rows.map((_, i) => cols.map((c) => coord(c[i])));\n  const keep = rows.flatMap((_, i) => (at[i]?.includes(null) ? [] : [i]));\n  skippedRows(\n    `maplibre:routes:${o.league}:missing`,\n    \"route leg(s)\",\n    rows.flatMap((_, i) => (at[i]?.includes(null) ? [teams[i] as Value] : [])),\n  );\n  const kept = keep.map((i) => teams[i] as Value);\n  const ro = {\n    ...(o.season === undefined ? {} : { season: o.season }),\n    ...(o.idSystem === undefined ? {} : { idSystem: o.idSystem }),\n  };\n  const resolved = resolveSync(kept, o.league, ro);\n  // keyed by the resolved team, so 12 and \"12\" (or \"KC\" and 12) are one team with one colour\n  const keys = kept.map((t, j) => resolved[j] ?? `?${label(t)}`);\n  const distinct = [...new Set(keys)];\n  const known = distinct.filter((k) => !k.startsWith(\"?\"));\n  const palette = colorPalette(o.league, known, {\n    ...ro,\n    idSystem: \"team_id\",\n    ...(o.which === undefined ? {} : { which: o.which }),\n    ...(o.background === undefined ? {} : { background: o.background }),\n    ...(o.fallback === undefined ? {} : { fallback: o.fallback }),\n  });\n  const colorOf = new Map(known.map((k, j) => [k, palette[j] as string]));\n  const fallback = o.fallback ?? \"#808080\";\n  const features = keep.map((i, j): Feature<LineGeometry, RouteProperties> => {\n    const c = at[i] as number[];\n    return {\n      type: \"Feature\",\n      id: i,\n      geometry: {\n        type: \"LineString\",\n        coordinates: [\n          [c[0] as number, c[1] as number],\n          [c[2] as number, c[3] as number],\n        ],\n      },\n      properties: {\n        team: resolved[j] ?? label(kept[j]),\n        color: colorOf.get(keys[j] as string) ?? fallback,\n        index: i,\n      },\n    };\n  });\n  return {\n    id,\n    source: { type: \"geojson\", data: { type: \"FeatureCollection\", features } },\n    layer: {\n      id,\n      type: \"line\",\n      source: id,\n      layout: { \"line-cap\": \"round\", \"line-join\": \"round\" },\n      paint: { \"line-color\": [\"get\", \"color\"], \"line-width\": width, \"line-opacity\": opacity },\n    },\n  };\n}\n\n/** OpenFreeMap's credit, exactly as its TileJSON (`https://tiles.openfreemap.org/planet`) gives it (read 2026-10-27). */\nconst OPENFREEMAP_ATTRIBUTION =\n  '<a href=\"https://openfreemap.org\" target=\"_blank\">OpenFreeMap</a> <a href=\"https://www.openmaptiles.org/\" target=\"_blank\">&copy; OpenMapTiles</a> Data from <a href=\"https://www.openstreetmap.org/copyright\" target=\"_blank\">OpenStreetMap</a>';\n\n/** `basemap`'s result. */\nexport interface Basemap {\n  /** The style URL, for the map's `style` option. */\n  style: string;\n  /**\n   * The provider's credit (HTML). MapLibre shows it by itself from the style's source, in its attribution control (on\n   * by default; keep it). Anything else that draws these tiles, or a static export of the map, must show it.\n   */\n  attribution: string;\n  /**\n   * The colour of the style's `background` layer, the land (read from the style on 2026-10-27), for `routeLines`' and\n   * `passArcLayer`'s `background` (dark mode). Their 3:1 contrast is measured against it, not against the water,\n   * which is a little lighter on the dark style (#1b1b1d) and a little darker on the light one (#c2c8ca).\n   */\n  background: string;\n}\nconst STYLES = {\n  light: { style: \"https://tiles.openfreemap.org/styles/positron\", background: \"#f2f3f0\" },\n  dark: { style: \"https://tiles.openfreemap.org/styles/dark\", background: \"#0c0c0c\" },\n} as const;\n\n/**\n * A free basemap that needs no API key: OpenFreeMap's `positron` (light) or `dark` vector style, built from\n * OpenStreetMap data. Pass `style` to `new maplibregl.Map({ style })`. OpenFreeMap's public instance asks for no\n * registration or key and sets no request limit; the credit is required, and MapLibre's attribution control shows it\n * from the style's source (`attribution` is the same text, for anything else). Each map view requests the\n * provider's tiles: build or test pages without a map, or serve a local style.\n *\n * @example\n * ```ts\n * import { basemap } from \"@sportsdataverse/sdvplot/maplibre\";\n *\n * const { style, background } = basemap(\"dark\");\n * // in the browser: new maplibregl.Map({ container, style, center: [-96, 38], zoom: 3 })\n * [style, background];\n * ```\n */\nexport function basemap(theme: \"light\" | \"dark\" = \"light\"): Basemap {\n  const s = STYLES[theme];\n  if (s === undefined) throw new InputError(`theme is \"light\" or \"dark\", got ${JSON.stringify(theme)}`);\n  return { ...s, attribution: OPENFREEMAP_ATTRIBUTION };\n}\n\n/**\n * What `logoSymbols` sets draw, as `[team, longitude, latitude, px, url]` per feature, in order: the module's test\n * hook, as the other adapters' `drawnMarks`.\n *\n * @example\n * ```ts\n * import { loadLeague } from \"@sportsdataverse/sdvplot\";\n * import { drawnMarks, logoSymbols } from \"@sportsdataverse/sdvplot/maplibre\";\n *\n * await loadLeague(\"nfl\");\n * // 12 is Kansas City's ESPN team id\n * drawnMarks(logoSymbols([{ team: 12, lon: -94.714, lat: 39.297 }], { x: \"lon\", y: \"lat\", team: \"team\", league: \"nfl\" }));\n * ```\n */\nexport function drawnMarks(...sets: readonly LogoSymbols[]): DrawnMark[] {\n  return sets.flatMap((s) => {\n    const px = new Map(s.images.map((im) => [im.id, im.height]));\n    return s.source.data.features.map(\n      (f): DrawnMark => [\n        f.properties.team,\n        f.geometry.coordinates[0],\n        f.geometry.coordinates[1],\n        px.get(f.properties.icon) as number,\n        f.properties.url,\n      ],\n    );\n  });\n}\n"]}