@sportsdataverse/sdvplot 0.0.0-stage → 0.2.0

package/dist/unovis.d.ts

@@ -0,0 +1,127 @@
+import { E as EspnHeadshotLeague } from './headshots-B2J_LOO8.js';
+import { W as Which, S as SeasonInput, I as IdSystem, H as HeadshotIdSystem, V as Variant, L as League } from './types-C7n6gJF3.js';
+import './resolve-CQW-jzvr.js';
+
+/** `teamColorPalette` / `teamColorScale` options. */
+interface UnovisColorOptions {
+    /** "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 that is distinct and still reads; failing that it is kept, with one warning.
+     */
+    background?: string;
+}
+/**
+ * One colour per team, in order: an XY component's `color` (one per `y` accessor), or anything else that takes
+ * colours by position. With `background`, every colour keeps 3:1 contrast against it (dark mode) and aims to stay
+ * distinct from the others. `teamColorScale` gives the same colours keyed by team, for accessors.
+ *
+ * @example
+ * ```ts
+ * import { loadLeague } from "@sportsdataverse/sdvplot";
+ * import { teamColorPalette } from "@sportsdataverse/sdvplot/unovis";
+ *
+ * await loadLeague("nfl");
+ * // new Line({ x, y: [kc, phi], color: <this> })
+ * teamColorPalette("nfl", ["KC", "PHI"], { background: "#111827" });
+ * ```
+ */
+declare function teamColorPalette(league: League, teams: readonly unknown[], o?: UnovisColorOptions): string[];
+/** A team's colour: call it from a Unovis colour accessor with the team value the datum holds. */
+interface UnovisTeamColorScale<T = unknown> {
+    /** The colour of `team`: its own for a team of the domain (by any value naming it), else `fallback`. */
+    (team: unknown): string;
+    /** The team values exactly as given (numbers stay numbers), each once and in order. */
+    readonly domain: readonly T[];
+    /** Their colours, in the same order. */
+    readonly range: readonly string[];
+}
+/**
+ * Team colours for Unovis's colour accessors: `color(d.team)` from a Graph's `nodeFill`, `nodeStroke` or
+ * `linkStroke`, a Sankey's `nodeColor` or `linkColor`, a Chord's `nodeColor`. Give every team the chart draws, so
+ * the colours are worked out together: with `background` they read on it (dark mode) and stay distinct. The domain
+ * keeps the values as the data holds them (12 and "12" are both kept); the colours are the resolved team's, so 12,
+ * "12" and "KC" draw in one colour. A value outside the domain gets `fallback`, with one warning.
+ *
+ * @example
+ * ```ts
+ * import { loadLeague } from "@sportsdataverse/sdvplot";
+ * import { teamColorScale } from "@sportsdataverse/sdvplot/unovis";
+ *
+ * await loadLeague("nfl");
+ * const color = teamColorScale("nfl", ["KC", "PHI"]);
+ * // new Sankey({ linkColor: (l) => color(l.team), ... })
+ * [color("KC"), color(21), color.range];
+ * ```
+ */
+declare function teamColorScale<T>(league: League, teams: readonly T[], o?: UnovisColorOptions): UnovisTeamColorScale<T>;
+/** `logoIcons` options. */
+interface UnovisLogoOptions {
+    /** The season the teams are resolved for (a number or string). */
+    season?: SeasonInput;
+    /** Logo variant, e.g. "dark". Default "default". */
+    variant?: Variant;
+    /** How the team values are read. Default "auto". */
+    idSystem?: IdSystem;
+}
+/** `headshotIcons` options. */
+interface UnovisHeadshotOptions {
+    /** ESPN athlete ids, or nflverse gsis ids (needs `loadGsis()` first). Default "espn". */
+    idSystem?: HeadshotIdSystem;
+}
+/** Images for a Graph's node icons: call it from `nodeIcon` with the team (or player) the node holds. */
+interface UnovisIcons<T = unknown> {
+    /** `#<symbol id>` of the image of `value` (by any value naming the same team or player), else undefined. */
+    (value: unknown): string | undefined;
+    /** The values that have an image, as given (numbers stay numbers), each once and in order. */
+    readonly domain: readonly T[];
+    /** Their `#<symbol id>`s, in the same order. */
+    readonly range: readonly string[];
+    /** One `<symbol>` per image: the chart container's `svgDefs` (join two sets' with `+`). */
+    readonly svgDefs: string;
+}
+/**
+ * Team logos for a Unovis Graph's nodes: `nodeIcon: (n) => logos(n.team)`, with
+ * `svgDefs: logos.svgDefs` on the container. Unovis draws each icon as a `<use>` of the logo's `<symbol>`, `nodeIconSize` px across, the logo
+ * fitted inside, uncut; a node's fill shows round it. A team with no logo has no icon, with one warning. Every value
+ * naming a team finds its logo (12, "12" and "KC").
+ *
+ * @example
+ * ```ts
+ * import { loadLeague } from "@sportsdataverse/sdvplot";
+ * import { logoIcons } from "@sportsdataverse/sdvplot/unovis";
+ *
+ * await loadLeague("nfl");
+ * const logos = logoIcons("nfl", ["KC", "LV"], { variant: "dark" });
+ * // new SingleContainer(el, { component: new Graph({ nodeIcon: (n) => logos(n.team), nodeIconSize: 28 }),
+ * //   svgDefs: logos.svgDefs }, data)
+ * [logos("KC"), logos.range];
+ * ```
+ */
+declare function logoIcons<T>(league: League, teams: readonly T[], o?: UnovisLogoOptions): UnovisIcons<T>;
+/**
+ * ESPN player headshots for a Unovis Graph's nodes, as `logoIcons`: `nodeIcon: (n) => heads(n.player)`, with the
+ * container's `svgDefs: heads.svgDefs`. A gsis id with no headshot has no icon, with one warning; an ESPN id's URL is
+ * built without checking the image exists, so an id ESPN has no photo for keeps an empty icon, with no warning.
+ *
+ * @example
+ * ```ts
+ * import { headshotIcons } from "@sportsdataverse/sdvplot/unovis";
+ *
+ * // Patrick Mahomes and Travis Kelce, by ESPN athlete id
+ * const heads = headshotIcons("nfl", [3139477, 15847]);
+ * [heads(3139477), heads.svgDefs.length > 0];
+ * ```
+ */
+declare function headshotIcons<T>(league: EspnHeadshotLeague, players: readonly T[], o?: UnovisHeadshotOptions): UnovisIcons<T>;
+
+export { type UnovisColorOptions, type UnovisHeadshotOptions, type UnovisIcons, type UnovisLogoOptions, type UnovisTeamColorScale, headshotIcons, logoIcons, teamColorPalette, teamColorScale };

package/dist/unovis.js

@@ -0,0 +1,108 @@
+import { contentId } from './chunk-WQT4IVLX.js';
+import { colorPalette, imageSource, aspect } from './chunk-UL5M6KDE.js';
+import { placeSync } from './chunk-7ULOCCFL.js';
+import { resolveSync, normValue } from './chunk-ZAEQXFJM.js';
+import './chunk-J6R2LEJ7.js';
+import { warn } from './chunk-E7G7VSLV.js';
+
+// src/unovis.ts
+function teamColorPalette(league, teams, o = {}) {
+  return colorPalette(league, teams, o);
+}
+var keyOf = (v) => `${typeof v}:${String(v)}`;
+function distinct(values) {
+  const seen = /* @__PURE__ */ new Map();
+  for (const v of values) if (!seen.has(keyOf(v))) seen.set(keyOf(v), v);
+  return [...seen.values()];
+}
+var shown = (v) => typeof v === "string" ? JSON.stringify(v) : String(v);
+function teamColorScale(league, teams, o = {}) {
+  const domain = distinct(teams);
+  const ro = {
+    ...o.season === void 0 ? {} : { season: o.season },
+    ...o.idSystem === void 0 ? {} : { idSystem: o.idSystem }
+  };
+  const fallback = o.fallback ?? "#808080";
+  const ids = resolveSync(domain, league, ro);
+  const known = [...new Set(ids.filter((id) => id !== void 0))];
+  const palette = colorPalette(league, known, {
+    ...ro,
+    idSystem: "team_id",
+    ...o.which === void 0 ? {} : { which: o.which },
+    ...o.background === void 0 ? {} : { background: o.background },
+    fallback
+  });
+  const byTeam = new Map(known.map((id, j) => [id, palette[j]]));
+  const memo = new Map(domain.map((t, i) => [keyOf(t), byTeam.get(ids[i]) ?? fallback]));
+  const scale = (team) => {
+    const k = keyOf(team);
+    let c = memo.get(k);
+    if (c === void 0) {
+      const id = resolveSync(team, league, ro);
+      c = id === void 0 ? void 0 : byTeam.get(id);
+      if (c === void 0)
+        warn(
+          `unovis:${league}:color:${k}`,
+          `teamColorScale: ${shown(team)} is not one of its teams; drawn in ${fallback}`
+        );
+      c ??= fallback;
+      memo.set(k, c);
+    }
+    return c;
+  };
+  return Object.assign(scale, { domain, range: domain.map((t) => memo.get(keyOf(t))) });
+}
+var escapeAttr = (s) => s.replace(/[&<>"]/g, (c) => `&#${c.charCodeAt(0)};`);
+var n = (v) => String(Math.round(v * 1e4) / 1e4);
+function icons(kind, league, values, o) {
+  const given = distinct(values);
+  const at = given.map(() => 0);
+  const placed = placeSync(at, at, given, {
+    league,
+    kind,
+    ...o.season === void 0 ? {} : { season: o.season },
+    ...o.variant === void 0 ? {} : { variant: o.variant },
+    ...o.idSystem === void 0 ? {} : { idSystem: o.idSystem }
+  });
+  const idOf = (v) => kind === "headshot" ? o.idSystem === "gsis" ? String(v).trim() : normValue(v) ?? void 0 : resolveSync(v, league, {
+    ...o.season === void 0 ? {} : { season: o.season },
+    ...o.idSystem === void 0 ? {} : { idSystem: o.idSystem }
+  });
+  const byId = /* @__PURE__ */ new Map();
+  let svgDefs = "";
+  for (const p of placed) {
+    if (byId.has(p.id)) continue;
+    const href = imageSource(p);
+    const id = contentId(`sdv-${kind}`, href);
+    const w = 100 * aspect(p);
+    if (!svgDefs.includes(`id="${id}"`))
+      svgDefs += `<symbol id="${id}" viewBox="0 0 ${n(w)} 100" preserveAspectRatio="xMidYMid meet"><image href="${escapeAttr(href)}" width="${n(w)}" height="100" preserveAspectRatio="xMidYMid meet"/></symbol>`;
+    byId.set(p.id, `#${id}`);
+  }
+  const memo = new Map(
+    placed.map((p) => [keyOf(given[p.index]), byId.get(p.id)])
+  );
+  const icon = (value) => {
+    const k = keyOf(value);
+    if (!memo.has(k)) {
+      const id = value === null || value === void 0 ? void 0 : idOf(value);
+      memo.set(k, id === void 0 ? void 0 : byId.get(id));
+    }
+    return memo.get(k);
+  };
+  return Object.assign(icon, {
+    domain: placed.map((p) => given[p.index]),
+    range: placed.map((p) => byId.get(p.id)),
+    svgDefs
+  });
+}
+function logoIcons(league, teams, o = {}) {
+  return icons("logo", league, teams, o);
+}
+function headshotIcons(league, players, o = {}) {
+  return icons("headshot", league, players, o);
+}
+
+export { headshotIcons, logoIcons, teamColorPalette, teamColorScale };
+//# sourceMappingURL=unovis.js.map
+//# sourceMappingURL=unovis.js.map

package/dist/unovis.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/unovis.ts"],"names":[],"mappings":"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","file":"unovis.js","sourcesContent":["/**\n * The Unovis 1.7 adapter: accessor helpers in Unovis's own idiom, for `@unovis/ts` (plain JavaScript, Svelte, any\n * framework) and `@unovis/react`. Team colours as a function a colour accessor calls (`teamColorScale`: a Graph's\n * `nodeFill` / `nodeStroke` / `linkStroke`, a Sankey's `nodeColor` / `linkColor`, a Chord's `nodeColor`), or as a list\n * (`teamColorPalette`, for an XY component's `color`). Logos and headshots for a Graph's nodes (`logoIcons`,\n * `headshotIcons`): Unovis draws a node icon that starts with `#` as an SVG `<use>` of that id, and the icons' `svgDefs`\n * (for the container's `svgDefs`) hold one `<symbol>` per image. A Sankey's node icon is text only, so a Sankey takes\n * team colours, not logos. Pure: `@unovis/*` is never imported. Call after `loadLeague(league)` / `preloadAll()`.\n */\nimport { aspect, colorPalette, imageSource } from \"./_web.js\";\nimport { contentId } from \"./content-id.js\";\nimport { warn } from \"./errors.js\";\nimport type { EspnHeadshotLeague } from \"./headshots.js\";\nimport { normValue } from \"./normalize.js\";\nimport { type Kind, placeSync } from \"./placement.js\";\nimport { type Value, resolveSync } from \"./resolve.js\";\nimport type { HeadshotIdSystem, IdSystem, League, SeasonInput, Variant, Which } from \"./types.js\";\n\n/** `teamColorPalette` / `teamColorScale` options. */\nexport interface UnovisColorOptions {\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 that is distinct and still reads; failing that it is kept, with one warning.\n   */\n  background?: string;\n}\n\n/**\n * One colour per team, in order: an XY component's `color` (one per `y` accessor), or anything else that takes\n * colours by position. With `background`, every colour keeps 3:1 contrast against it (dark mode) and aims to stay\n * distinct from the others. `teamColorScale` gives the same colours keyed by team, for accessors.\n *\n * @example\n * ```ts\n * import { loadLeague } from \"@sportsdataverse/sdvplot\";\n * import { teamColorPalette } from \"@sportsdataverse/sdvplot/unovis\";\n *\n * await loadLeague(\"nfl\");\n * // new Line({ x, y: [kc, phi], color: <this> })\n * teamColorPalette(\"nfl\", [\"KC\", \"PHI\"], { background: \"#111827\" });\n * ```\n */\nexport function teamColorPalette(\n  league: League,\n  teams: readonly unknown[],\n  o: UnovisColorOptions = {},\n): string[] {\n  return colorPalette(league, teams, o);\n}\n\n/** A value's key as the data holds it: 12 and \"12\" are two keys, each kept. */\nconst keyOf = (v: unknown): string => `${typeof v}:${String(v)}`;\nfunction distinct<T>(values: readonly T[]): T[] {\n  const seen = new Map<string, T>();\n  for (const v of values) if (!seen.has(keyOf(v))) seen.set(keyOf(v), v);\n  return [...seen.values()];\n}\nconst shown = (v: unknown): string => (typeof v === \"string\" ? JSON.stringify(v) : String(v));\n\n/** A team's colour: call it from a Unovis colour accessor with the team value the datum holds. */\nexport interface UnovisTeamColorScale<T = unknown> {\n  /** The colour of `team`: its own for a team of the domain (by any value naming it), else `fallback`. */\n  (team: unknown): string;\n  /** The team values exactly as given (numbers stay numbers), each once and in order. */\n  readonly domain: readonly T[];\n  /** Their colours, in the same order. */\n  readonly range: readonly string[];\n}\n/**\n * Team colours for Unovis's colour accessors: `color(d.team)` from a Graph's `nodeFill`, `nodeStroke` or\n * `linkStroke`, a Sankey's `nodeColor` or `linkColor`, a Chord's `nodeColor`. Give every team the chart draws, so\n * the colours are worked out together: with `background` they read on it (dark mode) and stay distinct. The domain\n * keeps the values as the data holds them (12 and \"12\" are both kept); the colours are the resolved team's, so 12,\n * \"12\" and \"KC\" draw in one colour. A value outside the domain gets `fallback`, with one warning.\n *\n * @example\n * ```ts\n * import { loadLeague } from \"@sportsdataverse/sdvplot\";\n * import { teamColorScale } from \"@sportsdataverse/sdvplot/unovis\";\n *\n * await loadLeague(\"nfl\");\n * const color = teamColorScale(\"nfl\", [\"KC\", \"PHI\"]);\n * // new Sankey({ linkColor: (l) => color(l.team), ... })\n * [color(\"KC\"), color(21), color.range];\n * ```\n */\nexport function teamColorScale<T>(\n  league: League,\n  teams: readonly T[],\n  o: UnovisColorOptions = {},\n): UnovisTeamColorScale<T> {\n  const domain = distinct(teams);\n  const ro = {\n    ...(o.season === undefined ? {} : { season: o.season }),\n    ...(o.idSystem === undefined ? {} : { idSystem: o.idSystem }),\n  };\n  const fallback = o.fallback ?? \"#808080\";\n  const ids = resolveSync(domain as readonly Value[], league, ro);\n  // keyed by the resolved team: a team named twice (12 and \"KC\") is one team, with one colour\n  const known = [...new Set(ids.filter((id) => id !== undefined))];\n  const palette = colorPalette(league, known, {\n    ...ro,\n    idSystem: \"team_id\",\n    ...(o.which === undefined ? {} : { which: o.which }),\n    ...(o.background === undefined ? {} : { background: o.background }),\n    fallback,\n  });\n  const byTeam = new Map<string, string>(known.map((id, j) => [id, palette[j] as string]));\n  const memo = new Map(domain.map((t, i) => [keyOf(t), byTeam.get(ids[i] as string) ?? fallback]));\n  const scale = (team: unknown): string => {\n    const k = keyOf(team);\n    let c = memo.get(k);\n    if (c === undefined) {\n      const id = resolveSync(team as Value, league, ro);\n      c = id === undefined ? undefined : byTeam.get(id);\n      if (c === undefined)\n        warn(\n          `unovis:${league}:color:${k}`,\n          `teamColorScale: ${shown(team)} is not one of its teams; drawn in ${fallback}`,\n        );\n      c ??= fallback;\n      memo.set(k, c);\n    }\n    return c;\n  };\n  return Object.assign(scale, { domain, range: domain.map((t) => memo.get(keyOf(t)) as string) });\n}\n\n/** `logoIcons` options. */\nexport interface UnovisLogoOptions {\n  /** The season the teams are resolved for (a number or string). */\n  season?: SeasonInput;\n  /** Logo variant, e.g. \"dark\". Default \"default\". */\n  variant?: Variant;\n  /** How the team values are read. Default \"auto\". */\n  idSystem?: IdSystem;\n}\n/** `headshotIcons` options. */\nexport interface UnovisHeadshotOptions {\n  /** ESPN athlete ids, or nflverse gsis ids (needs `loadGsis()` first). Default \"espn\". */\n  idSystem?: HeadshotIdSystem;\n}\n/** Images for a Graph's node icons: call it from `nodeIcon` with the team (or player) the node holds. */\nexport interface UnovisIcons<T = unknown> {\n  /** `#<symbol id>` of the image of `value` (by any value naming the same team or player), else undefined. */\n  (value: unknown): string | undefined;\n  /** The values that have an image, as given (numbers stay numbers), each once and in order. */\n  readonly domain: readonly T[];\n  /** Their `#<symbol id>`s, in the same order. */\n  readonly range: readonly string[];\n  /** One `<symbol>` per image: the chart container's `svgDefs` (join two sets' with `+`). */\n  readonly svgDefs: string;\n}\n\nconst escapeAttr = (s: string): string => s.replace(/[&<>\"]/g, (c) => `&#${c.charCodeAt(0)};`);\nconst n = (v: number): string => String(Math.round(v * 1e4) / 1e4);\n\nfunction icons<T>(\n  kind: Kind,\n  league: League,\n  values: readonly T[],\n  o: { season?: SeasonInput; variant?: Variant; idSystem?: IdSystem | HeadshotIdSystem },\n): UnovisIcons<T> {\n  const given = distinct(values);\n  const at = given.map(() => 0); // a node's place is Unovis's layout: placeSync only pairs each value with its image\n  const placed = placeSync(at, at, given as readonly Value[], {\n    league,\n    kind,\n    ...(o.season === undefined ? {} : { season: o.season }),\n    ...(o.variant === undefined ? {} : { variant: o.variant }),\n    ...(o.idSystem === undefined ? {} : { idSystem: o.idSystem }),\n  });\n  // a node's value -> the id its image is keyed by: the resolved team, or the player id as placeSync normalises it\n  const idOf = (v: unknown): string | undefined =>\n    kind === \"headshot\"\n      ? o.idSystem === \"gsis\"\n        ? String(v).trim()\n        : (normValue(v) ?? undefined)\n      : resolveSync(v as Value, league, {\n          ...(o.season === undefined ? {} : { season: o.season }),\n          ...(o.idSystem === undefined ? {} : { idSystem: o.idSystem as IdSystem }),\n        });\n  const byId = new Map<string, string>();\n  let svgDefs = \"\";\n  for (const p of placed) {\n    if (byId.has(p.id)) continue;\n    const href = imageSource(p);\n    const id = contentId(`sdv-${kind}`, href);\n    // the symbol's box is the image's own aspect: a `<use>` of it fits the image, uncut, in nodeIconSize\n    const w = 100 * aspect(p);\n    if (!svgDefs.includes(`id=\"${id}\"`))\n      svgDefs += `<symbol id=\"${id}\" viewBox=\"0 0 ${n(w)} 100\" preserveAspectRatio=\"xMidYMid meet\"><image href=\"${escapeAttr(href)}\" width=\"${n(w)}\" height=\"100\" preserveAspectRatio=\"xMidYMid meet\"/></symbol>`;\n    byId.set(p.id, `#${id}`);\n  }\n  const memo = new Map<string, string | undefined>(\n    placed.map((p) => [keyOf(given[p.index]), byId.get(p.id)]),\n  );\n  const icon = (value: unknown): string | undefined => {\n    const k = keyOf(value);\n    if (!memo.has(k)) {\n      const id = value === null || value === undefined ? undefined : idOf(value);\n      memo.set(k, id === undefined ? undefined : byId.get(id));\n    }\n    return memo.get(k);\n  };\n  return Object.assign(icon, {\n    domain: placed.map((p) => given[p.index] as T),\n    range: placed.map((p) => byId.get(p.id) as string),\n    svgDefs,\n  });\n}\n\n/**\n * Team logos for a Unovis Graph's nodes: `nodeIcon: (n) => logos(n.team)`, with\n * `svgDefs: logos.svgDefs` on the container. Unovis draws each icon as a `<use>` of the logo's `<symbol>`, `nodeIconSize` px across, the logo\n * fitted inside, uncut; a node's fill shows round it. A team with no logo has no icon, with one warning. Every value\n * naming a team finds its logo (12, \"12\" and \"KC\").\n *\n * @example\n * ```ts\n * import { loadLeague } from \"@sportsdataverse/sdvplot\";\n * import { logoIcons } from \"@sportsdataverse/sdvplot/unovis\";\n *\n * await loadLeague(\"nfl\");\n * const logos = logoIcons(\"nfl\", [\"KC\", \"LV\"], { variant: \"dark\" });\n * // new SingleContainer(el, { component: new Graph({ nodeIcon: (n) => logos(n.team), nodeIconSize: 28 }),\n * //   svgDefs: logos.svgDefs }, data)\n * [logos(\"KC\"), logos.range];\n * ```\n */\nexport function logoIcons<T>(league: League, teams: readonly T[], o: UnovisLogoOptions = {}): UnovisIcons<T> {\n  return icons(\"logo\", league, teams, o);\n}\n\n/**\n * ESPN player headshots for a Unovis Graph's nodes, as `logoIcons`: `nodeIcon: (n) => heads(n.player)`, with the\n * container's `svgDefs: heads.svgDefs`. A gsis id with no headshot has no icon, with one warning; an ESPN id's URL is\n * built without checking the image exists, so an id ESPN has no photo for keeps an empty icon, with no warning.\n *\n * @example\n * ```ts\n * import { headshotIcons } from \"@sportsdataverse/sdvplot/unovis\";\n *\n * // Patrick Mahomes and Travis Kelce, by ESPN athlete id\n * const heads = headshotIcons(\"nfl\", [3139477, 15847]);\n * [heads(3139477), heads.svgDefs.length > 0];\n * ```\n */\nexport function headshotIcons<T>(\n  league: EspnHeadshotLeague,\n  players: readonly T[],\n  o: UnovisHeadshotOptions = {},\n): UnovisIcons<T> {\n  return icons(\"headshot\", league, players, o);\n}\n"]}

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/usfl-4CR5RMZJ.js

@@ -0,0 +1,32 @@
+// src/data/aliases/usfl.ts
+var aliases = [
+  { "id_system": "mark", "value": "fox:birmingham-stallions", "team_id": "birmingham-stallions", "valid_from": null, "valid_to": null },
+  { "id_system": "mark", "value": "fox:houston-gamblers", "team_id": "houston-gamblers", "valid_from": null, "valid_to": null },
+  { "id_system": "mark", "value": "fox:memphis-showboats", "team_id": "memphis-showboats", "valid_from": null, "valid_to": null },
+  { "id_system": "mark", "value": "fox:michigan-panthers", "team_id": "michigan-panthers", "valid_from": null, "valid_to": null },
+  { "id_system": "mark", "value": "fox:new-jersey-generals", "team_id": "new-jersey-generals", "valid_from": null, "valid_to": null },
+  { "id_system": "mark", "value": "fox:new-orleans-breakers", "team_id": "new-orleans-breakers", "valid_from": null, "valid_to": null },
+  { "id_system": "mark", "value": "fox:philadelphia-stars", "team_id": "philadelphia-stars", "valid_from": null, "valid_to": null },
+  { "id_system": "mark", "value": "fox:pittsburgh-maulers", "team_id": "pittsburgh-maulers", "valid_from": null, "valid_to": null },
+  { "id_system": "mark", "value": "fox:tampa-bay-bandits", "team_id": "tampa-bay-bandits", "valid_from": null, "valid_to": null },
+  { "id_system": "name", "value": "Birmingham Stallions", "team_id": "birmingham-stallions", "valid_from": null, "valid_to": null },
+  { "id_system": "name", "value": "Houston Gamblers", "team_id": "houston-gamblers", "valid_from": null, "valid_to": null },
+  { "id_system": "name", "value": "Memphis Showboats", "team_id": "memphis-showboats", "valid_from": null, "valid_to": null },
+  { "id_system": "name", "value": "Michigan Panthers", "team_id": "michigan-panthers", "valid_from": null, "valid_to": null },
+  { "id_system": "name", "value": "New Jersey Generals", "team_id": "new-jersey-generals", "valid_from": null, "valid_to": null },
+  { "id_system": "name", "value": "New Orleans Breakers", "team_id": "new-orleans-breakers", "valid_from": null, "valid_to": null },
+  { "id_system": "name", "value": "Philadelphia Stars", "team_id": "philadelphia-stars", "valid_from": null, "valid_to": null },
+  { "id_system": "name", "value": "Pittsburgh Maulers", "team_id": "pittsburgh-maulers", "valid_from": null, "valid_to": null },
+  { "id_system": "name", "value": "Tampa Bay Bandits", "team_id": "tampa-bay-bandits", "valid_from": null, "valid_to": null },
+  { "id_system": "team_id", "value": "birmingham-stallions", "team_id": "birmingham-stallions", "valid_from": null, "valid_to": null },
+  { "id_system": "team_id", "value": "houston-gamblers", "team_id": "houston-gamblers", "valid_from": null, "valid_to": null },
+  { "id_system": "team_id", "value": "memphis-showboats", "team_id": "memphis-showboats", "valid_from": null, "valid_to": null },
+  { "id_system": "team_id", "value": "michigan-panthers", "team_id": "michigan-panthers", "valid_from": null, "valid_to": null },
+  { "id_system": "team_id", "value": "new-jersey-generals", "team_id": "new-jersey-generals", "valid_from": null, "valid_to": null },
+  { "id_system": "team_id", "value": "new-orleans-breakers", "team_id": "new-orleans-breakers", "valid_from": null, "valid_to": null },
+  { "id_system": "team_id", "value": "philadelphia-stars", "team_id": "philadelphia-stars", "valid_from": null, "valid_to": null },
+  { "id_system": "team_id", "value": "pittsburgh-maulers", "team_id": "pittsburgh-maulers", "valid_from": null, "valid_to": null },
+  { "id_system": "team_id", "value": "tampa-bay-bandits", "team_id": "tampa-bay-bandits", "valid_from": null, "valid_to": null }
+];
+
+export { aliases };

package/dist/usfl-LD7HP2YK.js

@@ -0,0 +1,14 @@
+// src/data/teams/usfl.ts
+var teams = [
+  { "league": "usfl", "team_id": "birmingham-stallions", "abbr": null, "name": "Birmingham Stallions", "short_name": null, "location": null, "program": "pro", "conference_id": null, "conference": null, "color_primary": "#a32035", "color_secondary": "#ceb795", "color_source": "logo" },
+  { "league": "usfl", "team_id": "houston-gamblers", "abbr": null, "name": "Houston Gamblers", "short_name": null, "location": null, "program": "pro", "conference_id": null, "conference": null, "color_primary": "#ea0029", "color_secondary": "#000000", "color_source": "logo" },
+  { "league": "usfl", "team_id": "memphis-showboats", "abbr": null, "name": "Memphis Showboats", "short_name": null, "location": null, "program": "pro", "conference_id": null, "conference": null, "color_primary": "#12284c", "color_secondary": "#ffb71c", "color_source": "logo" },
+  { "league": "usfl", "team_id": "michigan-panthers", "abbr": null, "name": "Michigan Panthers", "short_name": null, "location": null, "program": "pro", "conference_id": null, "conference": null, "color_primary": "#702e3e", "color_secondary": "#c6b784", "color_source": "logo" },
+  { "league": "usfl", "team_id": "new-jersey-generals", "abbr": null, "name": "New Jersey Generals", "short_name": null, "location": null, "program": "pro", "conference_id": null, "conference": null, "color_primary": "#001a41", "color_secondary": "#cb9f54", "color_source": "logo" },
+  { "league": "usfl", "team_id": "new-orleans-breakers", "abbr": null, "name": "New Orleans Breakers", "short_name": null, "location": null, "program": "pro", "conference_id": null, "conference": null, "color_primary": "#4298cc", "color_secondary": "#003595", "color_source": "logo" },
+  { "league": "usfl", "team_id": "philadelphia-stars", "abbr": null, "name": "Philadelphia Stars", "short_name": null, "location": null, "program": "pro", "conference_id": null, "conference": null, "color_primary": "#c10230", "color_secondary": "#fba02d", "color_source": "logo" },
+  { "league": "usfl", "team_id": "pittsburgh-maulers", "abbr": null, "name": "Pittsburgh Maulers", "short_name": null, "location": null, "program": "pro", "conference_id": null, "conference": null, "color_primary": "#ffb71b", "color_secondary": "#000000", "color_source": "logo" },
+  { "league": "usfl", "team_id": "tampa-bay-bandits", "abbr": null, "name": "Tampa Bay Bandits", "short_name": null, "location": null, "program": "pro", "conference_id": null, "conference": null, "color_primary": "#c10230", "color_secondary": "#000000", "color_source": "logo" }
+];
+
+export { teams };

package/dist/usfl-VU4YSJQD.js

@@ -0,0 +1,19 @@
+// src/data/marks/usfl.ts
+var marks = [
+  { "team_id": "tampa-bay-bandits", "mark_type": "logo", "variant": "default", "valid_from": null, "valid_to": null, "source": "fox", "first_seen": "2026-09-30", "sha256": "2440865ff13ecaffcc45ed16431f83a4bd429b37f836eeee9053cdd807354d05", "ext": "png", "width": 800, "height": 800, "source_rank": 1 },
+  { "team_id": "philadelphia-stars", "mark_type": "logo", "variant": "alternate", "valid_from": null, "valid_to": null, "source": "fox", "first_seen": "2026-09-30", "sha256": "4f796ada74fd249cf196a6fac977630d1d5bfbb744cadf3100d5ebbfacd25582", "ext": "png", "width": 800, "height": 800, "source_rank": 1 },
+  { "team_id": "birmingham-stallions", "mark_type": "logo", "variant": "default", "valid_from": null, "valid_to": null, "source": "fox", "first_seen": "2026-09-30", "sha256": "4fe31310c59a8bd5df2bcbc5548f1d78dc5d87d519c5a22c2cece5f01777b6b8", "ext": "png", "width": 800, "height": 800, "source_rank": 1 },
+  { "team_id": "philadelphia-stars", "mark_type": "logo", "variant": "default", "valid_from": null, "valid_to": null, "source": "fox", "first_seen": "2026-09-30", "sha256": "5214cb1a8f10eaac4f7baa3a9cc6e36663a60ab768c7d04ba7e837b6ffa753b5", "ext": "png", "width": 800, "height": 800, "source_rank": 1 },
+  { "team_id": "new-orleans-breakers", "mark_type": "logo", "variant": "default", "valid_from": null, "valid_to": null, "source": "fox", "first_seen": "2026-09-30", "sha256": "5665151bd9551ef7d7a83d129639653cc9adcb9456343cd424f4487407760739", "ext": "png", "width": 800, "height": 800, "source_rank": 1 },
+  { "team_id": "new-orleans-breakers", "mark_type": "logo", "variant": "alternate", "valid_from": null, "valid_to": null, "source": "fox", "first_seen": "2026-09-30", "sha256": "5c45ab13ea22476b52ce7793da485e6000c3610c0dc3d98162e3cb8e681d95be", "ext": "png", "width": 800, "height": 800, "source_rank": 1 },
+  { "team_id": "houston-gamblers", "mark_type": "logo", "variant": "default", "valid_from": null, "valid_to": null, "source": "fox", "first_seen": "2026-09-30", "sha256": "69fffa26b1e0a94ce9608b9cf5ae7b73bb0abf4c51f920fb99fe5c2ba8e94c40", "ext": "png", "width": 800, "height": 800, "source_rank": 1 },
+  { "team_id": "new-jersey-generals", "mark_type": "logo", "variant": "alternate", "valid_from": null, "valid_to": null, "source": "fox", "first_seen": "2026-09-30", "sha256": "9e28a94988b21ab3cca96f8cec540c9d27f559b8d16e1ddd2b60bfe881441e5d", "ext": "png", "width": 800, "height": 800, "source_rank": 1 },
+  { "team_id": "michigan-panthers", "mark_type": "logo", "variant": "default", "valid_from": null, "valid_to": null, "source": "fox", "first_seen": "2026-09-30", "sha256": "b9575fa9a603fc4ff31baec4803bee500a978e1fd06f91be44da07caab2f4aa9", "ext": "png", "width": 800, "height": 800, "source_rank": 1 },
+  { "team_id": "memphis-showboats", "mark_type": "logo", "variant": "default", "valid_from": null, "valid_to": null, "source": "fox", "first_seen": "2026-09-30", "sha256": "c925fa79e4ac6d372d98a8f8920bb15de22f374bc5b244b56d7f559d38961aa0", "ext": "png", "width": 800, "height": 800, "source_rank": 1 },
+  { "team_id": "houston-gamblers", "mark_type": "logo", "variant": "alternate", "valid_from": null, "valid_to": null, "source": "fox", "first_seen": "2026-09-30", "sha256": "cb0a8ad787c5f05f7d69bacdf3bf634056c309636b453925121ec9e6acde87ab", "ext": "png", "width": 800, "height": 800, "source_rank": 1 },
+  { "team_id": "pittsburgh-maulers", "mark_type": "logo", "variant": "default", "valid_from": null, "valid_to": null, "source": "fox", "first_seen": "2026-09-30", "sha256": "e0af9b27a604e33ff8fcf7038ddfaaaa555e02d6ac747b40a7eb864147d25c4f", "ext": "png", "width": 800, "height": 800, "source_rank": 1 },
+  { "team_id": "memphis-showboats", "mark_type": "logo", "variant": "alternate", "valid_from": null, "valid_to": null, "source": "fox", "first_seen": "2026-09-30", "sha256": "f573b5cc5b15673a25b9e623beacc82da39e3028962bc422ee38482dc5d14a0a", "ext": "png", "width": 800, "height": 800, "source_rank": 1 },
+  { "team_id": "new-jersey-generals", "mark_type": "logo", "variant": "default", "valid_from": null, "valid_to": null, "source": "fox", "first_seen": "2026-09-30", "sha256": "fb6b19fee5a8099537c0dcb7a2a791814a9cb020d4a8eb72e159d89ee12e0454", "ext": "png", "width": 800, "height": 800, "source_rank": 1 }
+];
+
+export { marks };