@sportsdataverse/sdvplot 0.1.0 → 0.2.0

package/dist/uplot.d.ts

@@ -0,0 +1,120 @@
+import { M as MarkOptions, a as DrawnMark, R as Row } from './_web-D7Aa5Rd8.js';
+import { L as League, S as SeasonInput, W as Which, I as IdSystem } from './types-C7n6gJF3.js';
+
+/**
+ * The uPlot adapter: team colours for each series' `stroke` / `fill`, and team logos drawn on uPlot's canvas by a
+ * plugin (its `draw` hook), at points in data units. Pure: uplot is never imported (the types here are structural,
+ * read from uplot 1.6.31 and later), so the options can be built anywhere, a server included; only `new uPlot(...)`
+ * needs a browser. Call after `loadLeague(league)` / `preloadAll()`.
+ */
+
+/** The subset of a uPlot chart this adapter reads: `new uPlot(...)` is one. */
+interface UPlotLike {
+    /** The canvas' 2D context. */
+    readonly ctx: CanvasRenderingContext2D;
+    /** The plot area in canvas pixels. */
+    readonly bbox: {
+        left: number;
+        top: number;
+        width: number;
+        height: number;
+    };
+    /** The chart's data: x values first, then one array per series. */
+    readonly data: readonly ArrayLike<number | null | undefined>[];
+    /** A value on scale `scaleKey` as a position (canvas pixels with `canvasPixels`). */
+    valToPos(val: number, scaleKey: string, canvasPixels?: boolean): number;
+    /** Redraws the chart (`rebuildPaths: false` reuses the series paths). */
+    redraw(rebuildPaths?: boolean, recalcAxes?: boolean): void;
+}
+/** A uPlot plugin: put it in the options' `plugins`. */
+interface UPlotPlugin {
+    /** `init` registers the chart (for redraws as images land), `draw` paints the logos, `destroy` forgets the chart. */
+    hooks: {
+        init: (u: UPlotLike) => void;
+        draw: (u: UPlotLike) => void;
+        destroy: (u: UPlotLike) => void;
+    };
+}
+/** `logoPlugin` options: the spec adapters' mark options, less `embed`, plus the y scale. */
+interface UPlotLogoOptions extends Omit<MarkOptions, "embed"> {
+    /** The scale key the `y` values are on. Default "y". (`x` is on uPlot's "x" scale; a time scale counts seconds.) */
+    scale?: string;
+}
+/**
+ * Team logos on a uPlot chart: a plugin whose `draw` hook paints each row's logo centred on its `x` / `y` (data units,
+ * placed with uPlot's own `valToPos`), `height` of the plot area tall (a fraction, as in the spec adapters), over the
+ * series. The images start loading when the chart starts (uPlot's `init` hook, before its first draw), and the
+ * chart redraws as each one lands; building the plugin 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 point outside the plot
+ * area (after a zoom) is not drawn over the axes.
+ *
+ * `rows` can also be a function of the chart, read at every draw: give it `u.data` and the logos follow live data
+ * (`u.setData(...)`), such as a logo at each line's newest point.
+ *
+ * @example
+ * ```ts
+ * import { loadLeague } from "@sportsdataverse/sdvplot";
+ * import { logoPlugin } from "@sportsdataverse/sdvplot/uplot";
+ *
+ * await loadLeague("nfl");
+ * // the 2024 Chiefs and Bills: points for (x) against points against (y)
+ * const rows = [
+ *   { team: "KC", pf: 385, pa: 326 },
+ *   { team: "BUF", pf: 525, pa: 368 },
+ * ];
+ * const plugin = logoPlugin(rows, { x: "pf", y: "pa", team: "team", league: "nfl", height: 0.15 });
+ * // in the browser: new uPlot({ width: 640, height: 320, series, plugins: [plugin] }, data, element)
+ * Object.keys(plugin.hooks);
+ * ```
+ */
+declare function logoPlugin(rows: readonly Row[] | ((u: UPlotLike) => readonly Row[]), o: UPlotLogoOptions): UPlotPlugin;
+/** Test hook: [teamId, x, y, height, url] per logo the chart's `logoPlugin`s last drew, `height` a fraction of the
+ *  plot area. */
+declare function drawnMarks(u: UPlotLike): DrawnMark[];
+/** `withTeamSeries` options. */
+interface UPlotSeriesOptions {
+    /** Name of the row column holding the team (abbreviation, name or id; see `idSystem`). */
+    team: string;
+    /** The league the teams belong to, e.g. "nfl". */
+    league: League;
+    /** The season the teams are 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 an unresolved team. Default "#808080". */
+    fallback?: string;
+    /**
+     * The chart's background. Given, a team colour under 3:1 contrast against it is swapped for the team's other
+     * colour, else moved towards white (on a dark background) or black (a light one) until it reads: dark mode. A
+     * colour that would then sit too close to an earlier team's (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;
+    /** Also fill the area under each line in its colour, at this opacity in [0, 1]. Default: no fill. */
+    fill?: number;
+}
+/**
+ * Team colours for a uPlot chart's series: row `i`'s team strokes `series[i + 1]` (series 0 is uPlot's x), and with
+ * `fill` also fills the area under it. The rest of each series is kept and the options are copied, never changed. With
+ * `background`, every colour keeps 3:1 contrast against it (dark mode) and aims to stay distinct from the others (when
+ * it cannot, it keeps the readable colour and warns once).
+ *
+ * @example
+ * ```ts
+ * import { loadLeague } from "@sportsdataverse/sdvplot";
+ * import { withTeamSeries } from "@sportsdataverse/sdvplot/uplot";
+ *
+ * await loadLeague("nfl");
+ * withTeamSeries(
+ *   { width: 640, height: 320, series: [{}, { label: "Kansas City" }, { label: "Buffalo" }] },
+ *   [{ team: "KC" }, { team: "BUF" }],
+ *   { team: "team", league: "nfl", background: "#181a1b" },
+ * );
+ * ```
+ */
+declare function withTeamSeries<F extends object>(opts: F, rows: readonly Row[], o: UPlotSeriesOptions): F;
+
+export { DrawnMark, MarkOptions, Row, type UPlotLike, type UPlotLogoOptions, type UPlotPlugin, type UPlotSeriesOptions, drawnMarks, logoPlugin, withTeamSeries };

package/dist/uplot.js

@@ -0,0 +1,110 @@
+import { aspect, colorPalette, markPlacements } from './chunk-UL5M6KDE.js';
+import { checkHeight, checkAlpha } from './chunk-7ULOCCFL.js';
+import './chunk-ZAEQXFJM.js';
+import { hex6 } from './chunk-J6R2LEJ7.js';
+import { UnsupportedTargetError, InputError, warn } from './chunk-E7G7VSLV.js';
+
+// src/uplot.ts
+var drawn = /* @__PURE__ */ new WeakMap();
+function logoPlugin(rows, o) {
+  const h = checkHeight(o.height ?? 0.1);
+  const a = checkAlpha(o.alpha ?? 1);
+  const yScale = o.scale ?? "y";
+  let placed;
+  const placements = (rs) => {
+    if (placed?.rows !== rs) placed = { rows: rs, ps: markPlacements(rs, "logo", o) };
+    return placed.ps;
+  };
+  const token = {};
+  const charts = /* @__PURE__ */ new Set();
+  const images = /* @__PURE__ */ new Map();
+  const load = (url) => {
+    if (images.has(url) || typeof Image === "undefined") return images.get(url);
+    const img = new Image();
+    img.crossOrigin = "anonymous";
+    images.set(url, img);
+    img.onload = () => {
+      for (const u of charts) u.redraw(false);
+    };
+    img.onerror = () => {
+      images.set(url, null);
+      warn(`uplot:image:${url}`, `could not load ${url}, so it is not drawn`);
+    };
+    img.src = url;
+    return img;
+  };
+  const preload = () => {
+    if (typeof rows !== "function") for (const p of placements(rows)) load(p.url);
+  };
+  if (typeof rows !== "function") placements(rows);
+  return {
+    hooks: {
+      init(u) {
+        charts.add(u);
+        preload();
+      },
+      destroy(u) {
+        charts.delete(u);
+      },
+      draw(u) {
+        const { ctx, bbox } = u;
+        const out = [];
+        const ph = h * bbox.height;
+        ctx.save();
+        ctx.globalAlpha = a;
+        for (const p of placements(typeof rows === "function" ? rows(u) : rows)) {
+          const img = load(p.url);
+          if (!img?.complete || img.naturalWidth === 0) continue;
+          const cx = u.valToPos(Number(p.x), "x", true);
+          const cy = u.valToPos(Number(p.y), yScale, true);
+          const inside = cx >= bbox.left && cx <= bbox.left + bbox.width && cy >= bbox.top && cy <= bbox.top + bbox.height;
+          if (!inside) 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();
+        const byPlugin = drawn.get(u) ?? /* @__PURE__ */ new Map();
+        byPlugin.set(token, out);
+        drawn.set(u, byPlugin);
+      }
+    }
+  };
+}
+function drawnMarks(u) {
+  return [...drawn.get(u)?.values() ?? []].flat();
+}
+var rgba = (hex, alpha) => {
+  const n = Number.parseInt(hex.slice(1), 16);
+  return `rgba(${n >> 16}, ${n >> 8 & 255}, ${n & 255}, ${alpha})`;
+};
+function withTeamSeries(opts, rows, o) {
+  const series = opts?.series;
+  if (typeof opts !== "object" || opts === null || !Array.isArray(series))
+    throw new UnsupportedTargetError("sdvplot/uplot colours a uPlot options object with a `series` array");
+  if (rows.length > series.length - 1)
+    throw new InputError(
+      `${rows.length} rows for ${series.length - 1} data series: row i colours series[i + 1] (series[0] is x)`
+    );
+  const fill = o.fill === void 0 ? void 0 : checkAlpha(o.fill);
+  const teams = rows.map((r) => r[o.team]);
+  if (rows.length > 0 && !rows.some((r) => o.team in r))
+    throw new InputError(`team column ${JSON.stringify(o.team)} is not in rows`);
+  const strokes = colorPalette(o.league, teams, {
+    ...o.season === void 0 ? {} : { season: o.season },
+    ...o.idSystem === void 0 ? {} : { idSystem: o.idSystem },
+    ...o.which === void 0 ? {} : { which: o.which },
+    ...o.fallback === void 0 ? {} : { fallback: o.fallback },
+    ...o.background === void 0 ? {} : { background: o.background }
+  }).map((c) => hex6(c, { dropAlpha: true }));
+  const out = series.map((s, i) => {
+    const stroke = strokes[i - 1];
+    if (stroke === void 0) return s;
+    return { ...s, stroke, ...fill === void 0 ? {} : { fill: rgba(stroke, fill) } };
+  });
+  return { ...opts, series: out };
+}
+
+export { drawnMarks, logoPlugin, withTeamSeries };
+//# sourceMappingURL=uplot.js.map
+//# sourceMappingURL=uplot.js.map

package/dist/uplot.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/uplot.ts"],"names":[],"mappings":"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","file":"uplot.js","sourcesContent":["/**\n * The uPlot adapter: team colours for each series' `stroke` / `fill`, and team logos drawn on uPlot's canvas by a\n * plugin (its `draw` hook), at points in data units. Pure: uplot is never imported (the types here are structural,\n * read from uplot 1.6.31 and later), so the options can be built anywhere, a server included; only `new uPlot(...)`\n * needs a browser. Call after `loadLeague(league)` / `preloadAll()`.\n */\nimport {\n  type MarkOptions,\n  type Row,\n  aspect,\n  checkAlpha,\n  checkHeight,\n  colorPalette,\n  markPlacements,\n} from \"./_web.js\";\nimport type { DrawnMark } from \"./_web.js\";\nimport { hex6 } from \"./contrast.js\";\nimport { InputError, UnsupportedTargetError, warn } from \"./errors.js\";\nimport type { Placement } from \"./placement.js\";\nimport type { IdSystem, League, SeasonInput, Which } from \"./types.js\";\nexport type { DrawnMark, MarkOptions, Row } from \"./_web.js\";\n\n/** The subset of a uPlot chart this adapter reads: `new uPlot(...)` is one. */\nexport interface UPlotLike {\n  /** The canvas' 2D context. */\n  readonly ctx: CanvasRenderingContext2D;\n  /** The plot area in canvas pixels. */\n  readonly bbox: { left: number; top: number; width: number; height: number };\n  /** The chart's data: x values first, then one array per series. */\n  readonly data: readonly ArrayLike<number | null | undefined>[];\n  /** A value on scale `scaleKey` as a position (canvas pixels with `canvasPixels`). */\n  valToPos(val: number, scaleKey: string, canvasPixels?: boolean): number;\n  /** Redraws the chart (`rebuildPaths: false` reuses the series paths). */\n  redraw(rebuildPaths?: boolean, recalcAxes?: boolean): void;\n}\n/** A uPlot plugin: put it in the options' `plugins`. */\nexport interface UPlotPlugin {\n  /** `init` registers the chart (for redraws as images land), `draw` paints the logos, `destroy` forgets the chart. */\n  hooks: {\n    init: (u: UPlotLike) => void;\n    draw: (u: UPlotLike) => void;\n    destroy: (u: UPlotLike) => void;\n  };\n}\n\n/** `logoPlugin` options: the spec adapters' mark options, less `embed`, plus the y scale. */\nexport interface UPlotLogoOptions extends Omit<MarkOptions, \"embed\"> {\n  /** The scale key the `y` values are on. Default \"y\". (`x` is on uPlot's \"x\" scale; a time scale counts seconds.) */\n  scale?: string;\n}\n\n// ponytail: a WeakMap per chart of what each plugin last drew, so drawnMarks reads what reached the canvas\nconst drawn = new WeakMap<object, Map<object, DrawnMark[]>>();\n\n/**\n * Team logos on a uPlot chart: a plugin whose `draw` hook paints each row's logo centred on its `x` / `y` (data units,\n * placed with uPlot's own `valToPos`), `height` of the plot area tall (a fraction, as in the spec adapters), over the\n * series. The images start loading when the chart starts (uPlot's `init` hook, before its first draw), and the\n * chart redraws as each one lands; building the plugin fetches nothing. A team with no logo draws nothing and warns\n * once, as `sdvplot/echarts` does; an image that fails to load is never drawn and warns once; a point outside the plot\n * area (after a zoom) is not drawn over the axes.\n *\n * `rows` can also be a function of the chart, read at every draw: give it `u.data` and the logos follow live data\n * (`u.setData(...)`), such as a logo at each line's newest point.\n *\n * @example\n * ```ts\n * import { loadLeague } from \"@sportsdataverse/sdvplot\";\n * import { logoPlugin } from \"@sportsdataverse/sdvplot/uplot\";\n *\n * await loadLeague(\"nfl\");\n * // the 2024 Chiefs and Bills: points for (x) against points against (y)\n * const rows = [\n *   { team: \"KC\", pf: 385, pa: 326 },\n *   { team: \"BUF\", pf: 525, pa: 368 },\n * ];\n * const plugin = logoPlugin(rows, { x: \"pf\", y: \"pa\", team: \"team\", league: \"nfl\", height: 0.15 });\n * // in the browser: new uPlot({ width: 640, height: 320, series, plugins: [plugin] }, data, element)\n * Object.keys(plugin.hooks);\n * ```\n */\nexport function logoPlugin(\n  rows: readonly Row[] | ((u: UPlotLike) => readonly Row[]),\n  o: UPlotLogoOptions,\n): UPlotPlugin {\n  const h = checkHeight(o.height ?? 0.1);\n  const a = checkAlpha(o.alpha ?? 1);\n  const yScale = o.scale ?? \"y\";\n  // ponytail: one cached placement per rows identity; a rows function returning a fresh array re-resolves its teams\n  // every draw, cheap for a few end logos (memoise by team if a feed ever draws hundreds)\n  let placed: { rows: readonly Row[]; ps: Placement[] } | undefined;\n  const placements = (rs: readonly Row[]): Placement[] => {\n    if (placed?.rows !== rs) placed = { rows: rs, ps: markPlacements(rs, \"logo\", o) };\n    return placed.ps;\n  };\n  const token = {}; // this plugin's key in `drawn`\n  const charts = new Set<UPlotLike>();\n  const images = new Map<string, HTMLImageElement | null>(); // null: it failed to load\n  const load = (url: string): HTMLImageElement | null | undefined => {\n    if (images.has(url) || typeof Image === \"undefined\") return images.get(url);\n    const img = new Image();\n    img.crossOrigin = \"anonymous\"; // keeps the canvas exportable\n    images.set(url, img);\n    img.onload = () => {\n      for (const u of charts) u.redraw(false);\n    };\n    img.onerror = () => {\n      images.set(url, null);\n      warn(`uplot:image:${url}`, `could not load ${url}, so it is not drawn`);\n    };\n    img.src = url;\n    return img;\n  };\n  const preload = (): void => {\n    if (typeof rows !== \"function\") for (const p of placements(rows)) load(p.url);\n  };\n  if (typeof rows !== \"function\") placements(rows); // validates the rows now, when the options are built\n  return {\n    hooks: {\n      init(u) {\n        charts.add(u);\n        preload();\n      },\n      destroy(u) {\n        charts.delete(u);\n      },\n      draw(u) {\n        const { ctx, bbox } = u;\n        const out: DrawnMark[] = [];\n        const ph = h * bbox.height;\n        ctx.save();\n        ctx.globalAlpha = a;\n        for (const p of placements(typeof rows === \"function\" ? rows(u) : rows)) {\n          const img = load(p.url);\n          if (!img?.complete || img.naturalWidth === 0) continue;\n          const cx = u.valToPos(Number(p.x), \"x\", true);\n          const cy = u.valToPos(Number(p.y), yScale, true);\n          const inside =\n            cx >= bbox.left && cx <= bbox.left + bbox.width && cy >= bbox.top && cy <= bbox.top + bbox.height;\n          if (!inside) 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        const byPlugin = drawn.get(u) ?? new Map<object, DrawnMark[]>();\n        byPlugin.set(token, out);\n        drawn.set(u, byPlugin);\n      },\n    },\n  };\n}\n\n/** Test hook: [teamId, x, y, height, url] per logo the chart's `logoPlugin`s last drew, `height` a fraction of the\n *  plot area. */\nexport function drawnMarks(u: UPlotLike): DrawnMark[] {\n  return [...(drawn.get(u)?.values() ?? [])].flat();\n}\n\n/** `withTeamSeries` options. */\nexport interface UPlotSeriesOptions {\n  /** Name of the row column holding the team (abbreviation, name or id; see `idSystem`). */\n  team: string;\n  /** The league the teams belong to, e.g. \"nfl\". */\n  league: League;\n  /** The season the teams are 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 an unresolved team. Default \"#808080\". */\n  fallback?: string;\n  /**\n   * The chart's background. Given, a team colour under 3:1 contrast against it is swapped for the team's other\n   * colour, else moved towards white (on a dark background) or black (a light one) until it reads: dark mode. A\n   * colour that would then sit too close to an earlier team's (CIE76 ΔE under 20) takes the team's other colour, or\n   * the nearest colour to its own (lightness, hue or chroma stepped) that is distinct and still reads; failing that it\n   * is kept, with one warning.\n   */\n  background?: string;\n  /** Also fill the area under each line in its colour, at this opacity in [0, 1]. Default: no fill. */\n  fill?: number;\n}\nconst rgba = (hex: string, alpha: number): string => {\n  const n = Number.parseInt(hex.slice(1), 16);\n  return `rgba(${n >> 16}, ${(n >> 8) & 255}, ${n & 255}, ${alpha})`;\n};\n\n/**\n * Team colours for a uPlot chart's series: row `i`'s team strokes `series[i + 1]` (series 0 is uPlot's x), and with\n * `fill` also fills the area under it. The rest of each series is kept and the options are copied, never changed. With\n * `background`, every colour keeps 3:1 contrast against it (dark mode) and aims to stay distinct from the others (when\n * it cannot, it keeps the readable colour and warns once).\n *\n * @example\n * ```ts\n * import { loadLeague } from \"@sportsdataverse/sdvplot\";\n * import { withTeamSeries } from \"@sportsdataverse/sdvplot/uplot\";\n *\n * await loadLeague(\"nfl\");\n * withTeamSeries(\n *   { width: 640, height: 320, series: [{}, { label: \"Kansas City\" }, { label: \"Buffalo\" }] },\n *   [{ team: \"KC\" }, { team: \"BUF\" }],\n *   { team: \"team\", league: \"nfl\", background: \"#181a1b\" },\n * );\n * ```\n */\nexport function withTeamSeries<F extends object>(opts: F, rows: readonly Row[], o: UPlotSeriesOptions): F {\n  const series = (opts as { series?: unknown } | null)?.series;\n  if (typeof opts !== \"object\" || opts === null || !Array.isArray(series))\n    throw new UnsupportedTargetError(\"sdvplot/uplot colours a uPlot options object with a `series` array\");\n  if (rows.length > series.length - 1)\n    throw new InputError(\n      `${rows.length} rows for ${series.length - 1} data series: row i colours series[i + 1] (series[0] is x)`,\n    );\n  const fill = o.fill === undefined ? undefined : checkAlpha(o.fill);\n  const teams = rows.map((r) => r[o.team]);\n  if (rows.length > 0 && !rows.some((r) => o.team in r))\n    throw new InputError(`team column ${JSON.stringify(o.team)} is not in rows`);\n  // the shared palette (over the resolved teams), as #rrggbb for the fill's rgba\n  const strokes = colorPalette(o.league, teams, {\n    ...(o.season === undefined ? {} : { season: o.season }),\n    ...(o.idSystem === undefined ? {} : { idSystem: o.idSystem }),\n    ...(o.which === undefined ? {} : { which: o.which }),\n    ...(o.fallback === undefined ? {} : { fallback: o.fallback }),\n    ...(o.background === undefined ? {} : { background: o.background }),\n  }).map((c) => hex6(c, { dropAlpha: true }));\n  const out = series.map((s: unknown, i) => {\n    const stroke = strokes[i - 1];\n    if (stroke === undefined) return s;\n    return { ...(s as object), stroke, ...(fill === undefined ? {} : { fill: rgba(stroke, fill) }) };\n  });\n  return { ...opts, series: out };\n}\n"]}

package/dist/vega.js

@@ -1,8 +1,8 @@
-import { markPlacements, axisLetter, axisPlacements, aspect, imageSources, colorList } from './chunk-SEBO35DV.js';
-export { embedSources } from './chunk-SEBO35DV.js';
-import { checkHeight, checkAlpha, placedName } from './chunk-RMT2GMFH.js';
-import './chunk-KKH6ABMA.js';
-import './chunk-TAXO3VXH.js';
+import { markPlacements, axisLetter, axisPlacements, aspect, imageSources, colorList } from './chunk-UL5M6KDE.js';
+export { embedSources } from './chunk-UL5M6KDE.js';
+import { checkHeight, checkAlpha, placedName } from './chunk-7ULOCCFL.js';
+import './chunk-ZAEQXFJM.js';
+import './chunk-J6R2LEJ7.js';
 import { InputError, UnsupportedTargetError } from './chunk-E7G7VSLV.js';
 
 // src/vega.ts

package/dist/victory.d.ts

@@ -0,0 +1,107 @@
+import { W as Which, S as SeasonInput, I as IdSystem, L as League } from './types-C7n6gJF3.js';
+export { e as embedSources } from './_web-D7Aa5Rd8.js';
+
+/** `teamColorPalette` options. */
+interface VictoryColorOptions {
+    /** "primary" (default) or "secondary" colour. */
+    which?: Which;
+    /** The season the teams are resolved for (a number or string). */
+    season?: SeasonInput;
+    /** How the team values are read. Default "auto". */
+    idSystem?: IdSystem;
+    /** The colour of an unresolved team. Default "#808080". */
+    fallback?: string;
+    /**
+     * The chart's background. Given, a team colour under 3:1 contrast against it is swapped for the team's other
+     * colour, else moved towards white (on a dark background) or black (a light one) until it reads: dark mode. A
+     * colour that would then sit too close to an earlier team's (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;
+}
+/**
+ * One colour per team, in order: a `colorScale` for a `VictoryGroup`, `VictoryStack`, `VictoryPie` or
+ * `VictoryLegend`, or a series' `style.data.stroke` / `fill`. With `background`, every colour keeps 3:1 contrast
+ * against it (dark mode) and aims to stay distinct from the others (when it cannot, it keeps the readable colour and
+ * warns once). It has the shape of `sdvplot/echarts`'
+ * `teamColorPalette`; `teamTheme` puts the same colours into a Victory theme.
+ *
+ * @example
+ * ```tsx
+ * import { loadLeague } from "@sportsdataverse/sdvplot";
+ * import { teamColorPalette } from "@sportsdataverse/sdvplot/victory";
+ *
+ * await loadLeague("nfl");
+ * teamColorPalette("nfl", ["KC", "LAC", "DEN", "LV"], { background: "#181a1b" });
+ * ```
+ */
+declare function teamColorPalette(league: League, teams: readonly unknown[], o?: VictoryColorOptions): string[];
+/** `teamTheme` options: the teams, in the order the chart draws them, and an optional theme to build on. */
+interface TeamThemeOptions<T extends object = Record<never, never>> extends VictoryColorOptions {
+    /** The league the teams belong to, e.g. "nfl". */
+    league: League;
+    /** Every team the chart draws, in order: a group's or stack's i-th child takes the i-th colour. */
+    teams: readonly unknown[];
+    /**
+     * The theme to build on, e.g. `VictoryTheme.clean`; its axes, fonts and every other key are kept. Default none: the
+     * result then holds only the colours, and Victory draws everything else unstyled.
+     */
+    base?: T;
+}
+type Scale = {
+    colorScale: string[];
+};
+type Painted<P extends string> = {
+    style: {
+        data: {
+            [K in P]: string;
+        };
+    };
+};
+/** What `teamTheme` writes into the theme. */
+interface TeamThemeColors {
+    group: Scale;
+    stack: Scale;
+    pie: Scale;
+    legend: Scale;
+    /** A lone series takes the first team's colour. */
+    line: Painted<"stroke">;
+    area: Painted<"fill">;
+    bar: Painted<"fill">;
+    scatter: Painted<"fill">;
+}
+/**
+ * A Victory theme from team colours (`teamColorPalette`): the palette as the `colorScale` of every group, stack, pie
+ * and legend, so each child of a `VictoryGroup` is drawn in its team's colour, and the first team's colour for a lone
+ * line, area, bar or scatter. Built over `base` (a Victory theme), whose other keys and styles are kept. Pass it as a
+ * `VictoryChart`'s `theme`. With `background`, every colour keeps 3:1 contrast against it and aims to stay distinct from
+ * the others (else the readable colour and one warning); the chart's own background and axis ink are the base theme's to set.
+ *
+ * @example
+ * ```tsx
+ * import { loadLeague } from "@sportsdataverse/sdvplot";
+ * import { teamTheme } from "@sportsdataverse/sdvplot/victory";
+ * import { VictoryBar, VictoryChart, VictoryGroup, VictoryTheme } from "victory";
+ *
+ * await loadLeague("nfl");
+ * const rows = [
+ *   { team: "KC", pf: 385 },
+ *   { team: "BUF", pf: 525 },
+ * ];
+ * // each of the group's bars in its team's colour
+ * <VictoryChart
+ *   theme={teamTheme({ league: "nfl", teams: rows.map((r) => r.team), base: VictoryTheme.clean })}
+ *   domainPadding={60}
+ * >
+ *   <VictoryGroup>
+ *     {rows.map((r) => (
+ *       <VictoryBar key={r.team} data={[r]} x="team" y="pf" />
+ *     ))}
+ *   </VictoryGroup>
+ * </VictoryChart>;
+ * ```
+ */
+declare function teamTheme<T extends object = Record<never, never>>(o: TeamThemeOptions<T>): T & TeamThemeColors;
+
+export { type TeamThemeColors, type TeamThemeOptions, type VictoryColorOptions, teamColorPalette, teamTheme };

package/dist/victory.js

@@ -0,0 +1,38 @@
+import { colorPalette } from './chunk-UL5M6KDE.js';
+export { embedSources } from './chunk-UL5M6KDE.js';
+import './chunk-7ULOCCFL.js';
+import './chunk-ZAEQXFJM.js';
+import './chunk-J6R2LEJ7.js';
+import { InputError } from './chunk-E7G7VSLV.js';
+
+// src/victory.ts
+function teamColorPalette(league, teams, o = {}) {
+  return colorPalette(league, teams, o);
+}
+function teamTheme(o) {
+  const { league, teams, base, ...co } = o;
+  if (teams.length === 0) throw new InputError("teamTheme needs at least one team");
+  const colors = teamColorPalette(league, teams, co);
+  const first = colors[0];
+  const b = base ?? {};
+  const scale = (k) => ({ ...b[k], colorScale: colors });
+  const paint = (k, prop) => ({
+    ...b[k],
+    style: { ...b[k]?.style, data: { ...b[k]?.style?.data, [prop]: first } }
+  });
+  return {
+    ...b,
+    group: scale("group"),
+    stack: scale("stack"),
+    pie: scale("pie"),
+    legend: scale("legend"),
+    line: paint("line", "stroke"),
+    area: paint("area", "fill"),
+    bar: paint("bar", "fill"),
+    scatter: paint("scatter", "fill")
+  };
+}
+
+export { teamColorPalette, teamTheme };
+//# sourceMappingURL=victory.js.map
+//# sourceMappingURL=victory.js.map

package/dist/victory.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/victory.ts"],"names":[],"mappings":";;;;;;;;AA8CO,SAAS,gBAAA,CACd,MAAA,EACA,KAAA,EACA,CAAA,GAAyB,EAAC,EAChB;AACV,EAAA,OAAO,YAAA,CAAa,MAAA,EAAQ,KAAA,EAAO,CAAC,CAAA;AACtC;AA4DO,SAAS,UACd,CAAA,EACqB;AACrB,EAAA,MAAM,EAAE,MAAA,EAAQ,KAAA,EAAO,IAAA,EAAM,GAAG,IAAG,GAAI,CAAA;AACvC,EAAA,IAAI,MAAM,MAAA,KAAW,CAAA,EAAG,MAAM,IAAI,WAAW,mCAAmC,CAAA;AAChF,EAAA,MAAM,MAAA,GAAS,gBAAA,CAAiB,MAAA,EAAQ,KAAA,EAAO,EAAE,CAAA;AACjD,EAAA,MAAM,KAAA,GAAQ,OAAO,CAAC,CAAA;AAEtB,EAAA,MAAM,CAAA,GAAK,QAAQ,EAAC;AACpB,EAAA,MAAM,KAAA,GAAQ,CAAC,CAAA,MAAsB,EAAE,GAAG,CAAA,CAAE,CAAC,CAAA,EAAG,UAAA,EAAY,MAAA,EAAO,CAAA;AACnE,EAAA,MAAM,KAAA,GAAQ,CAAC,CAAA,EAAW,IAAA,MAAoC;AAAA,IAC5D,GAAG,EAAE,CAAC,CAAA;AAAA,IACN,OAAO,EAAE,GAAG,EAAE,CAAC,CAAA,EAAG,OAAO,IAAA,EAAM,EAAE,GAAG,CAAA,CAAE,CAAC,GAAG,KAAA,EAAO,IAAA,EAAM,CAAC,IAAI,GAAG,OAAM;AAAE,GACzE,CAAA;AACA,EAAA,OAAO;AAAA,IACL,GAAG,CAAA;AAAA,IACH,KAAA,EAAO,MAAM,OAAO,CAAA;AAAA,IACpB,KAAA,EAAO,MAAM,OAAO,CAAA;AAAA,IACpB,GAAA,EAAK,MAAM,KAAK,CAAA;AAAA,IAChB,MAAA,EAAQ,MAAM,QAAQ,CAAA;AAAA,IACtB,IAAA,EAAM,KAAA,CAAM,MAAA,EAAQ,QAAQ,CAAA;AAAA,IAC5B,IAAA,EAAM,KAAA,CAAM,MAAA,EAAQ,MAAM,CAAA;AAAA,IAC1B,GAAA,EAAK,KAAA,CAAM,KAAA,EAAO,MAAM,CAAA;AAAA,IACxB,OAAA,EAAS,KAAA,CAAM,SAAA,EAAW,MAAM;AAAA,GAClC;AACF","file":"victory.js","sourcesContent":["/**\n * The Victory adapter: team colours as a Victory theme (`teamTheme`) or as a `colorScale` (`teamColorPalette`). Pure:\n * victory is never imported (the theme is a plain object, typed structurally and checked against victory 37.3's own\n * `VictoryThemeDefinition`). Call after `loadLeague(league)` / `preloadAll()`. The logos are components, `<LogoPoint>`\n * (a scatter's `dataComponent`) and `<LogoTick>` (an axis' `tickLabelComponent`), in `sdvplot/react`.\n */\nimport { colorPalette } from \"./_web.js\";\nimport { InputError } from \"./errors.js\";\nimport type { IdSystem, League, SeasonInput, Which } from \"./types.js\";\nexport { embedSources } from \"./_web.js\"; // public: build `<LogoPoint embed>` / `<LogoTick embed>` with it\n\n/** `teamColorPalette` options. */\nexport interface VictoryColorOptions {\n  /** \"primary\" (default) or \"secondary\" colour. */\n  which?: Which;\n  /** The season the teams are resolved for (a number or string). */\n  season?: SeasonInput;\n  /** How the team values are read. Default \"auto\". */\n  idSystem?: IdSystem;\n  /** The colour of an unresolved team. Default \"#808080\". */\n  fallback?: string;\n  /**\n   * The chart's background. Given, a team colour under 3:1 contrast against it is swapped for the team's other\n   * colour, else moved towards white (on a dark background) or black (a light one) until it reads: dark mode. A\n   * colour that would then sit too close to an earlier team's (CIE76 ΔE under 20) takes the team's other colour, or\n   * the nearest colour to its own (lightness, hue or chroma stepped) that is distinct and still reads; failing that it\n   * is kept, with one warning.\n   */\n  background?: string;\n}\n/**\n * One colour per team, in order: a `colorScale` for a `VictoryGroup`, `VictoryStack`, `VictoryPie` or\n * `VictoryLegend`, or a series' `style.data.stroke` / `fill`. With `background`, every colour keeps 3:1 contrast\n * against it (dark mode) and aims to stay distinct from the others (when it cannot, it keeps the readable colour and\n * warns once). It has the shape of `sdvplot/echarts`'\n * `teamColorPalette`; `teamTheme` puts the same colours into a Victory theme.\n *\n * @example\n * ```tsx\n * import { loadLeague } from \"@sportsdataverse/sdvplot\";\n * import { teamColorPalette } from \"@sportsdataverse/sdvplot/victory\";\n *\n * await loadLeague(\"nfl\");\n * teamColorPalette(\"nfl\", [\"KC\", \"LAC\", \"DEN\", \"LV\"], { background: \"#181a1b\" });\n * ```\n */\nexport function teamColorPalette(\n  league: League,\n  teams: readonly unknown[],\n  o: VictoryColorOptions = {},\n): string[] {\n  return colorPalette(league, teams, o);\n}\n\n/** `teamTheme` options: the teams, in the order the chart draws them, and an optional theme to build on. */\nexport interface TeamThemeOptions<T extends object = Record<never, never>> extends VictoryColorOptions {\n  /** The league the teams belong to, e.g. \"nfl\". */\n  league: League;\n  /** Every team the chart draws, in order: a group's or stack's i-th child takes the i-th colour. */\n  teams: readonly unknown[];\n  /**\n   * The theme to build on, e.g. `VictoryTheme.clean`; its axes, fonts and every other key are kept. Default none: the\n   * result then holds only the colours, and Victory draws everything else unstyled.\n   */\n  base?: T;\n}\ntype Scale = { colorScale: string[] };\ntype Painted<P extends string> = { style: { data: { [K in P]: string } } };\n/** What `teamTheme` writes into the theme. */\nexport interface TeamThemeColors {\n  group: Scale;\n  stack: Scale;\n  pie: Scale;\n  legend: Scale;\n  /** A lone series takes the first team's colour. */\n  line: Painted<\"stroke\">;\n  area: Painted<\"fill\">;\n  bar: Painted<\"fill\">;\n  scatter: Painted<\"fill\">;\n}\n\n/**\n * A Victory theme from team colours (`teamColorPalette`): the palette as the `colorScale` of every group, stack, pie\n * and legend, so each child of a `VictoryGroup` is drawn in its team's colour, and the first team's colour for a lone\n * line, area, bar or scatter. Built over `base` (a Victory theme), whose other keys and styles are kept. Pass it as a\n * `VictoryChart`'s `theme`. With `background`, every colour keeps 3:1 contrast against it and aims to stay distinct from\n * the others (else the readable colour and one warning); the chart's own background and axis ink are the base theme's to set.\n *\n * @example\n * ```tsx\n * import { loadLeague } from \"@sportsdataverse/sdvplot\";\n * import { teamTheme } from \"@sportsdataverse/sdvplot/victory\";\n * import { VictoryBar, VictoryChart, VictoryGroup, VictoryTheme } from \"victory\";\n *\n * await loadLeague(\"nfl\");\n * const rows = [\n *   { team: \"KC\", pf: 385 },\n *   { team: \"BUF\", pf: 525 },\n * ];\n * // each of the group's bars in its team's colour\n * <VictoryChart\n *   theme={teamTheme({ league: \"nfl\", teams: rows.map((r) => r.team), base: VictoryTheme.clean })}\n *   domainPadding={60}\n * >\n *   <VictoryGroup>\n *     {rows.map((r) => (\n *       <VictoryBar key={r.team} data={[r]} x=\"team\" y=\"pf\" />\n *     ))}\n *   </VictoryGroup>\n * </VictoryChart>;\n * ```\n */\nexport function teamTheme<T extends object = Record<never, never>>(\n  o: TeamThemeOptions<T>,\n): T & TeamThemeColors {\n  const { league, teams, base, ...co } = o;\n  if (teams.length === 0) throw new InputError(\"teamTheme needs at least one team\");\n  const colors = teamColorPalette(league, teams, co);\n  const first = colors[0] as string;\n  type Piece = { style?: { data?: object } };\n  const b = (base ?? {}) as Record<string, Piece | undefined>;\n  const scale = (k: string): Scale => ({ ...b[k], colorScale: colors });\n  const paint = (k: string, prop: \"stroke\" | \"fill\"): Piece => ({\n    ...b[k],\n    style: { ...b[k]?.style, data: { ...b[k]?.style?.data, [prop]: first } },\n  });\n  return {\n    ...b,\n    group: scale(\"group\"),\n    stack: scale(\"stack\"),\n    pie: scale(\"pie\"),\n    legend: scale(\"legend\"),\n    line: paint(\"line\", \"stroke\"),\n    area: paint(\"area\", \"fill\"),\n    bar: paint(\"bar\", \"fill\"),\n    scatter: paint(\"scatter\", \"fill\"),\n  } as T & TeamThemeColors;\n}\n"]}