@sportsdataverse/sdvplot 0.1.0 → 0.2.0

package/dist/lightweight-charts.d.ts

@@ -0,0 +1,217 @@
+import { M as MarkOptions, a as DrawnMark, R as Row } from './_web-D7Aa5Rd8.js';
+import { V as Value } from './resolve-CQW-jzvr.js';
+import { L as League, S as SeasonInput, W as Which, I as IdSystem } from './types-C7n6gJF3.js';
+
+/**
+ * The TradingView Lightweight Charts adapter: chart options that keep TradingView's attribution on, team-coloured
+ * series options with prices read as probabilities or odds, and team logos drawn at points by a series primitive.
+ * Pure: lightweight-charts is never imported (the types here are structural, read from lightweight-charts 5.2.1), so
+ * everything can be built anywhere, a server included; only `createChart(...)` needs a browser. Call after
+ * `loadLeague(league)` / `preloadAll()`.
+ *
+ * Lightweight Charts is Apache-2.0 and asks every page that shows it for TradingView's attribution notice
+ * (`TRADINGVIEW_NOTICE`) and a link to https://www.tradingview.com/. `withAttribution` keeps the library's own
+ * attribution logo on, which is that link, and `attributionNotice` puts the notice on the page.
+ */
+
+/**
+ * TradingView's attribution notice: the NOTICE file of tradingview/lightweight-charts at v5.2.1, verbatim (its "с" is
+ * the Cyrillic letter, as upstream writes it). Lightweight Charts' licence asks for it, and a link to
+ * https://www.tradingview.com/, on the page that shows the chart.
+ */
+declare const TRADINGVIEW_NOTICE = "TradingView Lightweight Charts\u2122\nCopyright (\u0441) 2025 TradingView, Inc. https://www.tradingview.com/";
+/** `withAttribution` options. */
+interface AttributionOptions {
+    /**
+     * `true` turns TradingView's attribution logo off. Pass it only when the page already shows TradingView's
+     * attribution notice and a link to https://www.tradingview.com/ elsewhere: meeting Lightweight Charts' licence is
+     * then on you. Anything but `true` (or `false`, the default) throws.
+     */
+    attributedElsewhere?: boolean;
+}
+/**
+ * Chart options for `createChart` with TradingView's attribution logo on (`layout.attributionLogo: true`), the
+ * library's own link to https://www.tradingview.com/ that its licence asks for. The options are copied, never changed;
+ * the rest of them is kept. A `layout.attributionLogo: false` in them is turned back on, with one warning: only the
+ * explicit `{ attributedElsewhere: true }` turns it off, and the licence is then the caller's to meet.
+ *
+ * @example
+ * ```ts
+ * import { attributionNotice, withAttribution } from "@sportsdataverse/sdvplot/lightweight-charts";
+ * import { createChart } from "lightweight-charts";
+ *
+ * const el = document.body.appendChild(document.createElement("div"));
+ * // the chart, with TradingView's logo (its link) on it, and TradingView's notice on the page
+ * const chart = createChart(el, withAttribution({ width: 640, height: 320 }));
+ * const notice = attributionNotice(el.parentElement ?? el);
+ * [chart.options().layout.attributionLogo, notice.textContent];
+ * ```
+ */
+declare function withAttribution<F extends object = Record<never, never>>(chartOptions?: F, o?: AttributionOptions): F & {
+    layout: {
+        attributionLogo: boolean;
+    };
+};
+/**
+ * Puts TradingView's attribution notice on the page, as Lightweight Charts' licence asks: a `<p>` appended to
+ * `container`, holding `TRADINGVIEW_NOTICE` (its URL a link, its two lines kept), and returned. Idempotent: called
+ * again on the same container it returns the notice already there rather than adding a second. Give it the element
+ * around the chart (`el.parentElement ?? el` for the chart's own `el`), so the notice sits under the chart. On a
+ * server (no `document`) it does nothing and returns `container`. `withAttribution`'s example draws a chart with it.
+ *
+ * @example
+ * ```ts
+ * import { TRADINGVIEW_NOTICE, attributionNotice } from "@sportsdataverse/sdvplot/lightweight-charts";
+ *
+ * const figure = document.body.appendChild(document.createElement("figure"));
+ * const notice = attributionNotice(figure);
+ * // once per container, and exactly TradingView's notice
+ * [attributionNotice(figure) === notice, notice.textContent === TRADINGVIEW_NOTICE];
+ * ```
+ */
+declare function attributionNotice(container: HTMLElement): HTMLElement;
+/** What a price is: a probability (a fraction in [0, 1], read as a percentage) or American odds (-110, +150). */
+type PriceUnits = "probability" | "american";
+/** A Lightweight Charts custom price format. */
+interface LwcPriceFormat {
+    /** Always "custom": the formatter reads the prices. */
+    type: "custom";
+    /** A price as text: "58.5%" for a probability, "+150" for American odds. */
+    formatter: (price: number) => string;
+    /** The smallest price step: 0.001 for a probability (0.1%), 1 for American odds. */
+    minMove: number;
+}
+/** What `teamSeriesOptions` returns: a LineSeries' options. */
+interface LwcTeamSeriesOptions {
+    /** The line's colour, `#rrggbb`. */
+    color: string;
+    /** With `units`: how the price scale, the crosshair label and the last-value label read the prices. */
+    priceFormat?: LwcPriceFormat;
+}
+/** `teamSeriesOptions` options. */
+interface TeamSeriesOptions {
+    /** The league the team belongs to, e.g. "nfl". */
+    league: League;
+    /** Every team on the chart, in order (the team itself among them), so that with `background` each gets its own
+     *  colour. Default: the team alone. */
+    teams?: readonly Value[];
+    /** What the prices are: "probability" (a fraction in [0, 1], read "58.5%") or "american" (odds, read "+150").
+     *  Default: Lightweight Charts' own number format. */
+    units?: PriceUnits;
+    /** The season the team is resolved (and coloured) for. */
+    season?: SeasonInput;
+    /** "primary" (default) or "secondary". */
+    which?: Which;
+    /** How the team values are read. Default "auto". */
+    idSystem?: IdSystem;
+    /** The colour of a team that does not resolve. Default "#808080". */
+    fallback?: string;
+    /**
+     * The chart's background. Given, every colour keeps 3:1 contrast against it (dark mode): a team colour under that
+     * is swapped for the team's other colour, else moved towards white (on a dark background) or black (a light one)
+     * until it reads. A colour that would then sit too close to an earlier team's in `teams` (CIE76 ΔE under 20) takes
+     * the team's other colour, or the nearest colour to its own (lightness, hue or chroma stepped) that is distinct and
+     * still reads; failing that it is kept, with one warning.
+     */
+    background?: string;
+}
+/**
+ * A LineSeries' options in a team's colour, for `chart.addSeries(LineSeries, ...)`. With `units`, the prices read as
+ * probabilities ("58.5%") or American odds ("+150", "-120") on the price scale, the crosshair and the last-value line.
+ * With `background`, the colour keeps 3:1 contrast against it and aims to stay distinct from the other `teams` on the
+ * chart (when it cannot, it keeps the readable colour and warns once).
+ * A team that does not resolve takes `fallback` and warns; it never moves a real team's colour.
+ *
+ * @example
+ * ```ts
+ * import { loadLeague } from "@sportsdataverse/sdvplot";
+ * import { teamSeriesOptions } from "@sportsdataverse/sdvplot/lightweight-charts";
+ *
+ * await loadLeague("nfl");
+ * const teams = ["PHI", "KC"];
+ * const phi = teamSeriesOptions("PHI", { league: "nfl", teams, units: "probability", background: "#181a1b" });
+ * // in the browser: chart.addSeries(LineSeries, phi)
+ * [phi.color, phi.priceFormat?.formatter(0.5846)];
+ * ```
+ */
+declare function teamSeriesOptions(team: Value, o: TeamSeriesOptions): LwcTeamSeriesOptions;
+/** A Lightweight Charts time: a UTC timestamp in seconds, a "yyyy-mm-dd" string or a business day. */
+type LwcTime = number | string | {
+    year: number;
+    month: number;
+    day: number;
+};
+/** The parts of what Lightweight Charts attaches a series primitive with that `logoMarkers` reads. */
+interface LwcAttached {
+    /** The chart: its time scale places `x`. */
+    chart: {
+        timeScale(): {
+            timeToCoordinate(time: LwcTime): number | null;
+        };
+    };
+    /** The series the primitive is attached to: its price scale places `y`. */
+    series: {
+        priceToCoordinate(price: number): number | null;
+    };
+    /** Asks the chart to redraw. */
+    requestUpdate: () => void;
+}
+/** The drawing target Lightweight Charts hands a primitive's renderer (fancy-canvas' `CanvasRenderingTarget2D`). */
+interface LwcRenderTarget {
+    /** Calls `f` with the 2D context scaled to CSS pixels and the pane's size in them. */
+    useMediaCoordinateSpace<T>(f: (scope: {
+        context: CanvasRenderingContext2D;
+        mediaSize: {
+            width: number;
+            height: number;
+        };
+    }) => T): T;
+}
+/** A Lightweight Charts series primitive: attach it with `series.attachPrimitive(primitive)`. */
+interface LwcSeriesPrimitive {
+    /** Lightweight Charts calls this on `attachPrimitive`: the logos start loading. */
+    attached(param: LwcAttached): void;
+    /** Lightweight Charts calls this on `detachPrimitive`: the chart is forgotten, nothing more is drawn, and
+     *  `drawnMarks` reads empty. */
+    detached(): void;
+    /** Lightweight Charts calls this when the view changes; the logos are placed at each draw, so it does nothing. */
+    updateAllViews(): void;
+    /** The one pane view, whose renderer paints the logos (the same array every call, as the library asks). */
+    paneViews(): readonly {
+        renderer(): {
+            draw(target: LwcRenderTarget): void;
+        } | null;
+    }[];
+}
+/** `logoMarkers` options: the spec adapters' mark options, less `embed`, plus what the prices are. */
+interface LogoMarkersOptions extends Omit<MarkOptions, "embed"> {
+    /** What `y` is: "probability" values must be fractions in [0, 1], "american" values -100 or less or +100 or more. */
+    units?: PriceUnits;
+}
+/**
+ * Team logos on a Lightweight Charts series: a series primitive (`series.attachPrimitive(...)`) whose renderer paints
+ * each row's logo centred on its `x` (a time, as in the series' data) and `y` (a price on the series' scale), placed
+ * with the chart's own `timeToCoordinate` / `priceToCoordinate`, `height` of the pane tall (a fraction, as in the spec
+ * adapters). Lightweight Charts' series markers draw only shapes and text, so logos take a primitive. The images start
+ * loading when it is attached, and the chart redraws as each one lands; building it fetches nothing. A team with no
+ * logo draws nothing and warns once, as `sdvplot/echarts` does; an image that fails to load is never drawn and warns
+ * once; a row at a time the chart has no point for, or off the pane, is not drawn.
+ *
+ * @example
+ * ```ts
+ * import { loadLeague } from "@sportsdataverse/sdvplot";
+ * import { logoMarkers } from "@sportsdataverse/sdvplot/lightweight-charts";
+ *
+ * await loadLeague("nfl");
+ * // Super Bowl LIX's final reading (ESPN): 3600 seconds played, Philadelphia's win probability 1
+ * const rows = [{ t: 3600, wp: 1, team: "PHI" }];
+ * const logos = logoMarkers(rows, { x: "t", y: "wp", team: "team", league: "nfl", units: "probability" });
+ * // in the browser: series.attachPrimitive(logos)
+ * typeof logos.paneViews;
+ * ```
+ */
+declare function logoMarkers(rows: readonly Row[], o: LogoMarkersOptions): LwcSeriesPrimitive;
+/** Test hook: [teamId, x, y, height, url] per logo the primitive last drew, `height` a fraction of the pane. */
+declare function drawnMarks(primitive: LwcSeriesPrimitive): DrawnMark[];
+
+export { type AttributionOptions, DrawnMark, type LogoMarkersOptions, type LwcAttached, type LwcPriceFormat, type LwcRenderTarget, type LwcSeriesPrimitive, type LwcTeamSeriesOptions, type LwcTime, MarkOptions, type PriceUnits, Row, TRADINGVIEW_NOTICE, type TeamSeriesOptions, attributionNotice, drawnMarks, logoMarkers, teamSeriesOptions, withAttribution };

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"]}