@sportsdataverse/sdvplot 0.0.0-stage → 0.2.0

package/dist/lightweight-charts.js

@@ -0,0 +1,155 @@
+import { colorList, teamPalette, markPlacements, aspect } from './chunk-UL5M6KDE.js';
+import { checkHeight, checkAlpha } from './chunk-7ULOCCFL.js';
+import { resolveSync } from './chunk-ZAEQXFJM.js';
+import { hex6 } from './chunk-J6R2LEJ7.js';
+import { InputError, warn } from './chunk-E7G7VSLV.js';
+
+// src/lightweight-charts.ts
+var TRADINGVIEW_NOTICE = "TradingView Lightweight Charts\u2122\nCopyright (\u0441) 2025 TradingView, Inc. https://www.tradingview.com/";
+function withAttribution(chartOptions, o = {}) {
+  const off = o.attributedElsewhere;
+  if (off !== void 0 && typeof off !== "boolean")
+    throw new InputError(
+      `attributedElsewhere is true (your page attributes TradingView itself) or left out, not ${JSON.stringify(off)}`
+    );
+  const opts = chartOptions ?? {};
+  if (off !== true && opts.layout?.attributionLogo === false)
+    warn(
+      "lightweight-charts:attribution",
+      "layout.attributionLogo: false was turned back on: Lightweight Charts' licence asks for TradingView's notice and link. Pass { attributedElsewhere: true } only if your page shows both itself"
+    );
+  return { ...opts, layout: { ...opts.layout, attributionLogo: off !== true } };
+}
+function attributionNotice(container) {
+  if (typeof document === "undefined") return container;
+  for (const c of Array.from(container.children))
+    if (c instanceof HTMLElement && c.dataset.sdvAttribution === "tradingview") return c;
+  const doc = container.ownerDocument;
+  const url = "https://www.tradingview.com/";
+  const p = doc.createElement("p");
+  p.dataset.sdvAttribution = "tradingview";
+  p.style.whiteSpace = "pre-line";
+  const a = doc.createElement("a");
+  a.href = url;
+  a.textContent = url;
+  p.append(TRADINGVIEW_NOTICE.slice(0, -url.length), a);
+  container.append(p);
+  return p;
+}
+var UNITS = ["probability", "american"];
+var checkUnits = (u) => {
+  if (u === void 0 || UNITS.includes(u)) return u;
+  throw new InputError(`units is "probability" or "american", not ${JSON.stringify(u)}`);
+};
+var percent = (p) => `${Number((p * 100).toFixed(1))}%`;
+var american = (v) => {
+  const r = Math.sign(v) * Math.round(Math.abs(v));
+  return r === 0 ? "0" : `${r > 0 ? "+" : ""}${r}`;
+};
+function teamSeriesOptions(team, o) {
+  const units = checkUnits(o.units);
+  const teams = o.teams ?? [team];
+  const at = teams.indexOf(team);
+  if (at < 0) throw new InputError(`team ${JSON.stringify(team)} is not in teams ${JSON.stringify(teams)}`);
+  const fallback = hex6(o.fallback ?? "#808080", { dropAlpha: true });
+  const season = o.season === void 0 ? {} : { season: o.season };
+  const ids = resolveSync(teams, o.league, {
+    ...season,
+    ...o.idSystem === void 0 ? {} : { idSystem: o.idSystem }
+  });
+  const id = ids[at];
+  let color = fallback;
+  if (id !== void 0 && id !== null) {
+    const known = [...new Set(ids.filter((x) => x !== void 0 && x !== null))];
+    const which = o.which ?? "primary";
+    const co = { ...season, idSystem: "team_id" };
+    const main = colorList(o.league, known, { ...co, which });
+    const other = colorList(o.league, known, { ...co, which: which === "primary" ? "secondary" : "primary" });
+    let colors = main.map((c, i) => hex6(c ?? other[i] ?? fallback, { dropAlpha: true }));
+    if (o.background !== void 0) colors = teamPalette(colors, other, hex6(o.background), known);
+    color = colors[known.indexOf(id)];
+  }
+  if (units === void 0) return { color };
+  return {
+    color,
+    priceFormat: units === "probability" ? { type: "custom", formatter: percent, minMove: 1e-3 } : { type: "custom", formatter: american, minMove: 1 }
+  };
+}
+var drawn = /* @__PURE__ */ new WeakMap();
+function logoMarkers(rows, o) {
+  const h = checkHeight(o.height ?? 0.1);
+  const a = checkAlpha(o.alpha ?? 1);
+  const units = checkUnits(o.units);
+  if (units !== void 0)
+    for (const r of rows) {
+      if (r[o.y] === void 0 || r[o.y] === null) continue;
+      const v = Number(r[o.y]);
+      if (units === "probability" && !(v >= 0 && v <= 1))
+        throw new InputError(
+          `a probability is a fraction in [0, 1], not ${r[o.y]} (a percent? divide it by 100)`
+        );
+      if (units === "american" && !(Math.abs(v) >= 100))
+        throw new InputError(`American odds are -100 or less or +100 or more, not ${r[o.y]} (decimal odds?)`);
+    }
+  const ps = markPlacements(rows, "logo", o);
+  const images = /* @__PURE__ */ new Map();
+  let at;
+  const load = (url) => {
+    if (images.has(url) || typeof Image === "undefined") return;
+    const img = new Image();
+    img.crossOrigin = "anonymous";
+    images.set(url, img);
+    img.onload = () => at?.requestUpdate();
+    img.onerror = () => {
+      images.set(url, null);
+      warn(`lightweight-charts:image:${url}`, `could not load ${url}, so it is not drawn`);
+    };
+    img.src = url;
+  };
+  const draw = (target) => {
+    const c = at;
+    if (c === void 0) return;
+    target.useMediaCoordinateSpace(({ context: ctx, mediaSize }) => {
+      const out = [];
+      const ph = h * mediaSize.height;
+      ctx.save();
+      ctx.globalAlpha = a;
+      for (const p of ps) {
+        const img = images.get(p.url);
+        if (!img?.complete || img.naturalWidth === 0) continue;
+        const cx = c.chart.timeScale().timeToCoordinate(p.x);
+        const cy = c.series.priceToCoordinate(Number(p.y));
+        if (cx === null || cy === null) continue;
+        if (!(cx >= 0 && cx <= mediaSize.width && cy >= 0 && cy <= mediaSize.height)) continue;
+        const pw = ph * aspect(p);
+        ctx.drawImage(img, cx - pw / 2, cy - ph / 2, pw, ph);
+        out.push([p.id, p.x, p.y, h, p.url]);
+      }
+      ctx.restore();
+      drawn.set(primitive, out);
+    });
+  };
+  const views = [{ renderer: () => ({ draw }) }];
+  const primitive = {
+    attached(param) {
+      at = param;
+      for (const p of ps) load(p.url);
+      param.requestUpdate();
+    },
+    detached() {
+      at = void 0;
+      drawn.delete(primitive);
+    },
+    updateAllViews() {
+    },
+    paneViews: () => views
+  };
+  return primitive;
+}
+function drawnMarks(primitive) {
+  return [...drawn.get(primitive) ?? []];
+}
+
+export { TRADINGVIEW_NOTICE, attributionNotice, drawnMarks, logoMarkers, teamSeriesOptions, withAttribution };
+//# sourceMappingURL=lightweight-charts.js.map
+//# sourceMappingURL=lightweight-charts.js.map

package/dist/lightweight-charts.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lightweight-charts.ts"],"names":[],"mappings":"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","file":"lightweight-charts.js","sourcesContent":["/**\n * The TradingView Lightweight Charts adapter: chart options that keep TradingView's attribution on, team-coloured\n * series options with prices read as probabilities or odds, and team logos drawn at points by a series primitive.\n * Pure: lightweight-charts is never imported (the types here are structural, read from lightweight-charts 5.2.1), so\n * everything can be built anywhere, a server included; only `createChart(...)` needs a browser. Call after\n * `loadLeague(league)` / `preloadAll()`.\n *\n * Lightweight Charts is Apache-2.0 and asks every page that shows it for TradingView's attribution notice\n * (`TRADINGVIEW_NOTICE`) and a link to https://www.tradingview.com/. `withAttribution` keeps the library's own\n * attribution logo on, which is that link, and `attributionNotice` puts the notice on the page.\n */\nimport {\n  type MarkOptions,\n  type Row,\n  aspect,\n  checkAlpha,\n  checkHeight,\n  colorList,\n  markPlacements,\n} from \"./_web.js\";\nimport type { DrawnMark } from \"./_web.js\";\nimport { hex6 } from \"./contrast.js\";\nimport { InputError, warn } from \"./errors.js\";\nimport { resolveSync } from \"./resolve.js\";\nimport type { Value } from \"./resolve.js\";\nimport { teamPalette } from \"./team-palette.js\";\nimport type { IdSystem, League, SeasonInput, Which } from \"./types.js\";\nexport type { DrawnMark, MarkOptions, Row } from \"./_web.js\";\n\n/**\n * TradingView's attribution notice: the NOTICE file of tradingview/lightweight-charts at v5.2.1, verbatim (its \"с\" is\n * the Cyrillic letter, as upstream writes it). Lightweight Charts' licence asks for it, and a link to\n * https://www.tradingview.com/, on the page that shows the chart.\n */\nexport const TRADINGVIEW_NOTICE =\n  \"TradingView Lightweight Charts™\\nCopyright (с) 2025 TradingView, Inc. https://www.tradingview.com/\";\n\n/** `withAttribution` options. */\nexport interface AttributionOptions {\n  /**\n   * `true` turns TradingView's attribution logo off. Pass it only when the page already shows TradingView's\n   * attribution notice and a link to https://www.tradingview.com/ elsewhere: meeting Lightweight Charts' licence is\n   * then on you. Anything but `true` (or `false`, the default) throws.\n   */\n  attributedElsewhere?: boolean;\n}\n\n/**\n * Chart options for `createChart` with TradingView's attribution logo on (`layout.attributionLogo: true`), the\n * library's own link to https://www.tradingview.com/ that its licence asks for. The options are copied, never changed;\n * the rest of them is kept. A `layout.attributionLogo: false` in them is turned back on, with one warning: only the\n * explicit `{ attributedElsewhere: true }` turns it off, and the licence is then the caller's to meet.\n *\n * @example\n * ```ts\n * import { attributionNotice, withAttribution } from \"@sportsdataverse/sdvplot/lightweight-charts\";\n * import { createChart } from \"lightweight-charts\";\n *\n * const el = document.body.appendChild(document.createElement(\"div\"));\n * // the chart, with TradingView's logo (its link) on it, and TradingView's notice on the page\n * const chart = createChart(el, withAttribution({ width: 640, height: 320 }));\n * const notice = attributionNotice(el.parentElement ?? el);\n * [chart.options().layout.attributionLogo, notice.textContent];\n * ```\n */\nexport function withAttribution<F extends object = Record<never, never>>(\n  chartOptions?: F,\n  o: AttributionOptions = {},\n): F & { layout: { attributionLogo: boolean } } {\n  const off = o.attributedElsewhere;\n  if (off !== undefined && typeof off !== \"boolean\")\n    throw new InputError(\n      `attributedElsewhere is true (your page attributes TradingView itself) or left out, not ${JSON.stringify(off)}`,\n    );\n  const opts = (chartOptions ?? {}) as F & { layout?: { attributionLogo?: unknown } };\n  if (off !== true && opts.layout?.attributionLogo === false)\n    warn(\n      \"lightweight-charts:attribution\",\n      \"layout.attributionLogo: false was turned back on: Lightweight Charts' licence asks for TradingView's notice and link. Pass { attributedElsewhere: true } only if your page shows both itself\",\n    );\n  return { ...opts, layout: { ...opts.layout, attributionLogo: off !== true } };\n}\n\n/**\n * Puts TradingView's attribution notice on the page, as Lightweight Charts' licence asks: a `<p>` appended to\n * `container`, holding `TRADINGVIEW_NOTICE` (its URL a link, its two lines kept), and returned. Idempotent: called\n * again on the same container it returns the notice already there rather than adding a second. Give it the element\n * around the chart (`el.parentElement ?? el` for the chart's own `el`), so the notice sits under the chart. On a\n * server (no `document`) it does nothing and returns `container`. `withAttribution`'s example draws a chart with it.\n *\n * @example\n * ```ts\n * import { TRADINGVIEW_NOTICE, attributionNotice } from \"@sportsdataverse/sdvplot/lightweight-charts\";\n *\n * const figure = document.body.appendChild(document.createElement(\"figure\"));\n * const notice = attributionNotice(figure);\n * // once per container, and exactly TradingView's notice\n * [attributionNotice(figure) === notice, notice.textContent === TRADINGVIEW_NOTICE];\n * ```\n */\nexport function attributionNotice(container: HTMLElement): HTMLElement {\n  if (typeof document === \"undefined\") return container;\n  for (const c of Array.from(container.children))\n    if (c instanceof HTMLElement && c.dataset.sdvAttribution === \"tradingview\") return c;\n  const doc = container.ownerDocument;\n  const url = \"https://www.tradingview.com/\";\n  const p = doc.createElement(\"p\");\n  p.dataset.sdvAttribution = \"tradingview\";\n  p.style.whiteSpace = \"pre-line\"; // the notice's two lines\n  const a = doc.createElement(\"a\");\n  a.href = url;\n  a.textContent = url;\n  p.append(TRADINGVIEW_NOTICE.slice(0, -url.length), a);\n  container.append(p);\n  return p;\n}\n\n/** What a price is: a probability (a fraction in [0, 1], read as a percentage) or American odds (-110, +150). */\nexport type PriceUnits = \"probability\" | \"american\";\nconst UNITS: readonly PriceUnits[] = [\"probability\", \"american\"];\nconst checkUnits = (u: unknown): PriceUnits | undefined => {\n  if (u === undefined || UNITS.includes(u as PriceUnits)) return u as PriceUnits | undefined;\n  throw new InputError(`units is \"probability\" or \"american\", not ${JSON.stringify(u)}`);\n};\nconst percent = (p: number): string => `${Number((p * 100).toFixed(1))}%`;\n/** American odds as text: rounded half away from zero, signed, and \"0\" (never \"+0\" or \"-0\") for a zero. */\nconst american = (v: number): string => {\n  const r = Math.sign(v) * Math.round(Math.abs(v));\n  return r === 0 ? \"0\" : `${r > 0 ? \"+\" : \"\"}${r}`;\n};\n\n/** A Lightweight Charts custom price format. */\nexport interface LwcPriceFormat {\n  /** Always \"custom\": the formatter reads the prices. */\n  type: \"custom\";\n  /** A price as text: \"58.5%\" for a probability, \"+150\" for American odds. */\n  formatter: (price: number) => string;\n  /** The smallest price step: 0.001 for a probability (0.1%), 1 for American odds. */\n  minMove: number;\n}\n/** What `teamSeriesOptions` returns: a LineSeries' options. */\nexport interface LwcTeamSeriesOptions {\n  /** The line's colour, `#rrggbb`. */\n  color: string;\n  /** With `units`: how the price scale, the crosshair label and the last-value label read the prices. */\n  priceFormat?: LwcPriceFormat;\n}\n/** `teamSeriesOptions` options. */\nexport interface TeamSeriesOptions {\n  /** The league the team belongs to, e.g. \"nfl\". */\n  league: League;\n  /** Every team on the chart, in order (the team itself among them), so that with `background` each gets its own\n   *  colour. Default: the team alone. */\n  teams?: readonly Value[];\n  /** What the prices are: \"probability\" (a fraction in [0, 1], read \"58.5%\") or \"american\" (odds, read \"+150\").\n   *  Default: Lightweight Charts' own number format. */\n  units?: PriceUnits;\n  /** The season the team is resolved (and coloured) for. */\n  season?: SeasonInput;\n  /** \"primary\" (default) or \"secondary\". */\n  which?: Which;\n  /** How the team values are read. Default \"auto\". */\n  idSystem?: IdSystem;\n  /** The colour of a team that does not resolve. Default \"#808080\". */\n  fallback?: string;\n  /**\n   * The chart's background. Given, every colour keeps 3:1 contrast against it (dark mode): a team colour under that\n   * is swapped for the team's other colour, else moved towards white (on a dark background) or black (a light one)\n   * until it reads. A colour that would then sit too close to an earlier team's in `teams` (CIE76 ΔE under 20) takes\n   * the team's other colour, or the nearest colour to its own (lightness, hue or chroma stepped) that is distinct and\n   * still reads; failing that it is kept, with one warning.\n   */\n  background?: string;\n}\n\n/**\n * A LineSeries' options in a team's colour, for `chart.addSeries(LineSeries, ...)`. With `units`, the prices read as\n * probabilities (\"58.5%\") or American odds (\"+150\", \"-120\") on the price scale, the crosshair and the last-value line.\n * With `background`, the colour keeps 3:1 contrast against it and aims to stay distinct from the other `teams` on the\n * chart (when it cannot, it keeps the readable colour and warns once).\n * A team that does not resolve takes `fallback` and warns; it never moves a real team's colour.\n *\n * @example\n * ```ts\n * import { loadLeague } from \"@sportsdataverse/sdvplot\";\n * import { teamSeriesOptions } from \"@sportsdataverse/sdvplot/lightweight-charts\";\n *\n * await loadLeague(\"nfl\");\n * const teams = [\"PHI\", \"KC\"];\n * const phi = teamSeriesOptions(\"PHI\", { league: \"nfl\", teams, units: \"probability\", background: \"#181a1b\" });\n * // in the browser: chart.addSeries(LineSeries, phi)\n * [phi.color, phi.priceFormat?.formatter(0.5846)];\n * ```\n */\nexport function teamSeriesOptions(team: Value, o: TeamSeriesOptions): LwcTeamSeriesOptions {\n  const units = checkUnits(o.units);\n  const teams = o.teams ?? [team];\n  const at = teams.indexOf(team);\n  if (at < 0) throw new InputError(`team ${JSON.stringify(team)} is not in teams ${JSON.stringify(teams)}`);\n  const fallback = hex6(o.fallback ?? \"#808080\", { dropAlpha: true });\n  const season = o.season === undefined ? {} : { season: o.season };\n  const ids = resolveSync(teams, o.league, {\n    ...season,\n    ...(o.idSystem === undefined ? {} : { idSystem: o.idSystem }),\n  });\n  const id = ids[at];\n  let color = fallback;\n  if (id !== undefined && id !== null) {\n    // the palette runs over the resolved teams only: an unresolved one never moves a real team's colour\n    const known = [...new Set(ids.filter((x): x is NonNullable<typeof x> => x !== undefined && x !== null))];\n    const which = o.which ?? \"primary\";\n    const co = { ...season, idSystem: \"team_id\" as const };\n    const main = colorList(o.league, known, { ...co, which });\n    const other = colorList(o.league, known, { ...co, which: which === \"primary\" ? \"secondary\" : \"primary\" });\n    let colors = main.map((c, i) => hex6(c ?? other[i] ?? fallback, { dropAlpha: true }));\n    if (o.background !== undefined) colors = teamPalette(colors, other, hex6(o.background), known);\n    color = colors[known.indexOf(id)] as string;\n  }\n  if (units === undefined) return { color };\n  return {\n    color,\n    priceFormat:\n      units === \"probability\"\n        ? { type: \"custom\", formatter: percent, minMove: 0.001 }\n        : { type: \"custom\", formatter: american, minMove: 1 },\n  };\n}\n\n/** A Lightweight Charts time: a UTC timestamp in seconds, a \"yyyy-mm-dd\" string or a business day. */\nexport type LwcTime = number | string | { year: number; month: number; day: number };\n/** The parts of what Lightweight Charts attaches a series primitive with that `logoMarkers` reads. */\nexport interface LwcAttached {\n  /** The chart: its time scale places `x`. */\n  chart: { timeScale(): { timeToCoordinate(time: LwcTime): number | null } };\n  /** The series the primitive is attached to: its price scale places `y`. */\n  series: { priceToCoordinate(price: number): number | null };\n  /** Asks the chart to redraw. */\n  requestUpdate: () => void;\n}\n/** The drawing target Lightweight Charts hands a primitive's renderer (fancy-canvas' `CanvasRenderingTarget2D`). */\nexport interface LwcRenderTarget {\n  /** Calls `f` with the 2D context scaled to CSS pixels and the pane's size in them. */\n  useMediaCoordinateSpace<T>(\n    f: (scope: { context: CanvasRenderingContext2D; mediaSize: { width: number; height: number } }) => T,\n  ): T;\n}\n/** A Lightweight Charts series primitive: attach it with `series.attachPrimitive(primitive)`. */\nexport interface LwcSeriesPrimitive {\n  /** Lightweight Charts calls this on `attachPrimitive`: the logos start loading. */\n  attached(param: LwcAttached): void;\n  /** Lightweight Charts calls this on `detachPrimitive`: the chart is forgotten, nothing more is drawn, and\n   *  `drawnMarks` reads empty. */\n  detached(): void;\n  /** Lightweight Charts calls this when the view changes; the logos are placed at each draw, so it does nothing. */\n  updateAllViews(): void;\n  /** The one pane view, whose renderer paints the logos (the same array every call, as the library asks). */\n  paneViews(): readonly { renderer(): { draw(target: LwcRenderTarget): void } | null }[];\n}\n/** `logoMarkers` options: the spec adapters' mark options, less `embed`, plus what the prices are. */\nexport interface LogoMarkersOptions extends Omit<MarkOptions, \"embed\"> {\n  /** What `y` is: \"probability\" values must be fractions in [0, 1], \"american\" values -100 or less or +100 or more. */\n  units?: PriceUnits;\n}\n\n// ponytail: a WeakMap per primitive of what it last drew, so drawnMarks reads what reached the canvas\nconst drawn = new WeakMap<LwcSeriesPrimitive, DrawnMark[]>();\n\n/**\n * Team logos on a Lightweight Charts series: a series primitive (`series.attachPrimitive(...)`) whose renderer paints\n * each row's logo centred on its `x` (a time, as in the series' data) and `y` (a price on the series' scale), placed\n * with the chart's own `timeToCoordinate` / `priceToCoordinate`, `height` of the pane tall (a fraction, as in the spec\n * adapters). Lightweight Charts' series markers draw only shapes and text, so logos take a primitive. The images start\n * loading when it is attached, and the chart redraws as each one lands; building it fetches nothing. A team with no\n * logo draws nothing and warns once, as `sdvplot/echarts` does; an image that fails to load is never drawn and warns\n * once; a row at a time the chart has no point for, or off the pane, is not drawn.\n *\n * @example\n * ```ts\n * import { loadLeague } from \"@sportsdataverse/sdvplot\";\n * import { logoMarkers } from \"@sportsdataverse/sdvplot/lightweight-charts\";\n *\n * await loadLeague(\"nfl\");\n * // Super Bowl LIX's final reading (ESPN): 3600 seconds played, Philadelphia's win probability 1\n * const rows = [{ t: 3600, wp: 1, team: \"PHI\" }];\n * const logos = logoMarkers(rows, { x: \"t\", y: \"wp\", team: \"team\", league: \"nfl\", units: \"probability\" });\n * // in the browser: series.attachPrimitive(logos)\n * typeof logos.paneViews;\n * ```\n */\nexport function logoMarkers(rows: readonly Row[], o: LogoMarkersOptions): LwcSeriesPrimitive {\n  const h = checkHeight(o.height ?? 0.1);\n  const a = checkAlpha(o.alpha ?? 1);\n  const units = checkUnits(o.units);\n  if (units !== undefined)\n    for (const r of rows) {\n      // a missing y is left to markPlacements, which skips the row with one warning (Number(null) is 0, a \"probability\")\n      if (r[o.y] === undefined || r[o.y] === null) continue;\n      const v = Number(r[o.y]);\n      if (units === \"probability\" && !(v >= 0 && v <= 1))\n        throw new InputError(\n          `a probability is a fraction in [0, 1], not ${r[o.y]} (a percent? divide it by 100)`,\n        );\n      if (units === \"american\" && !(Math.abs(v) >= 100))\n        throw new InputError(`American odds are -100 or less or +100 or more, not ${r[o.y]} (decimal odds?)`);\n    }\n  const ps = markPlacements(rows, \"logo\", o); // validates the rows (and warns on a team with no logo) now\n  const images = new Map<string, HTMLImageElement | null>(); // null: it failed to load\n  let at: LwcAttached | undefined;\n  const load = (url: string): void => {\n    if (images.has(url) || typeof Image === \"undefined\") return;\n    const img = new Image();\n    img.crossOrigin = \"anonymous\"; // keeps the canvas exportable\n    images.set(url, img);\n    img.onload = () => at?.requestUpdate();\n    img.onerror = () => {\n      images.set(url, null);\n      warn(`lightweight-charts:image:${url}`, `could not load ${url}, so it is not drawn`);\n    };\n    img.src = url;\n  };\n  const draw = (target: LwcRenderTarget): void => {\n    const c = at;\n    if (c === undefined) return;\n    target.useMediaCoordinateSpace(({ context: ctx, mediaSize }) => {\n      const out: DrawnMark[] = [];\n      const ph = h * mediaSize.height;\n      ctx.save();\n      ctx.globalAlpha = a;\n      for (const p of ps) {\n        const img = images.get(p.url);\n        if (!img?.complete || img.naturalWidth === 0) continue;\n        const cx = c.chart.timeScale().timeToCoordinate(p.x as LwcTime);\n        const cy = c.series.priceToCoordinate(Number(p.y));\n        if (cx === null || cy === null) continue;\n        if (!(cx >= 0 && cx <= mediaSize.width && cy >= 0 && cy <= mediaSize.height)) continue; // also drops NaN\n        const pw = ph * aspect(p);\n        ctx.drawImage(img, cx - pw / 2, cy - ph / 2, pw, ph);\n        out.push([p.id, p.x, p.y, h, p.url]);\n      }\n      ctx.restore();\n      drawn.set(primitive, out);\n    });\n  };\n  const views = [{ renderer: () => ({ draw }) }] as const; // the same array every time, as the library asks\n  const primitive: LwcSeriesPrimitive = {\n    attached(param) {\n      at = param;\n      for (const p of ps) load(p.url);\n      param.requestUpdate(); // logos loaded before (attached again) draw now, not at the next unrelated redraw\n    },\n    detached() {\n      at = undefined;\n      drawn.delete(primitive);\n    },\n    updateAllViews() {},\n    paneViews: () => views,\n  };\n  return primitive;\n}\n\n/** Test hook: [teamId, x, y, height, url] per logo the primitive last drew, `height` a fraction of the pane. */\nexport function drawnMarks(primitive: LwcSeriesPrimitive): DrawnMark[] {\n  return [...(drawn.get(primitive) ?? [])];\n}\n"]}

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