@sportsdataverse/sdvplot 0.0.0-stage → 0.2.0

package/dist/cytoscape.d.ts

@@ -0,0 +1,188 @@
+import { R as Row } from './_web-D7Aa5Rd8.js';
+import { S as SeasonInput, I as IdSystem, W as Which, L as League } from './types-C7n6gJF3.js';
+
+/**
+ * The Cytoscape.js adapter: passing networks as Cytoscape elements and a team-coloured stylesheet. Pure: it never
+ * imports cytoscape (3.34.3 or later is an optional peer), so the network can be built anywhere, a server included,
+ * and handed to the library as plain JSON: `cytoscape({ container, elements, style, layout: { name: "preset" } })`.
+ * Sizes are Cytoscape style units, px at zoom 1: a node's diameter, an edge's width. Synchronous: call after
+ * `loadLeague(league)` / `preloadAll()` (and `loadGsis()` for gsis headshots).
+ */
+
+/** A player node. `classes` is "headshot" (its image drawn as the node) or "initials" (team colour and initials). */
+interface CyNode {
+    data: {
+        /** The player id, as text. */
+        id: string;
+        /** The player's name, else the id. */
+        label: string;
+        /** The first letters of the name's first and last words, else the id. */
+        initials: string;
+        /** The resolved team id; absent when the team does not resolve (the node keeps the fallback colour). */
+        team?: string;
+        /** The headshot URL, on a headshot node only. */
+        image?: string;
+    };
+    /** Where the player stood (with the x/y/xend/yend options): model px, y down. */
+    position?: {
+        x: number;
+        y: number;
+    };
+    classes: "headshot" | "initials";
+}
+/** A directed edge from passer to receiver. */
+interface CyEdge {
+    data: {
+        /** The source and target ids joined by an arrow, as in 5485-\>3099 (Varane to Lloris). */
+        id: string;
+        /** The passer's node id. */
+        source: string;
+        /** The receiver's node id. */
+        target: string;
+        /** The pair's passes (or summed `weight`). */
+        weight: number;
+        /**
+         * The edge's width in px: `edgeWidth` for the heaviest pair, the others in proportion to their weight; 0 for a pair
+         * whose weight is 0 or less (a summed xT can be negative), since Cytoscape takes no negative width.
+         */
+        width: number;
+        /** The passer's resolved team id; absent when it does not resolve. */
+        team?: string;
+    };
+}
+/** One stylesheet block, Cytoscape's `{ selector, style }` JSON. */
+interface StyleBlock {
+    selector: string;
+    style: Record<string, string | number>;
+}
+/** `passNetwork`'s result: what `cytoscape({ elements, style })` takes. */
+interface PassNetwork {
+    elements: {
+        nodes: CyNode[];
+        edges: CyEdge[];
+    };
+    style: StyleBlock[];
+}
+/** The colour options `teamStylesheet` and `passNetwork` share. */
+interface CyColorOptions {
+    /** The season the teams are resolved for. */
+    season?: SeasonInput;
+    /** How the team values are read. Default "auto". */
+    idSystem?: IdSystem;
+    /** The team colour drawn, "primary" (default) or "secondary". */
+    which?: Which;
+    /**
+     * The background the network is drawn on (Cytoscape's container). Given, every team colour keeps 3:1 contrast
+     * against it (dark mode) and aims to stay distinct (CIE76 ΔE of 20 or more) from every other team's, through the
+     * shared team palette, as `teamColorPalette` does in the other adapters (when it cannot, it keeps the readable colour
+     * and warns once); a headshot node's name takes the ink that reads on it.
+     */
+    background?: string;
+    /** The colour of an element whose team does not resolve, or has no colour. Default "#808080". */
+    fallback?: string;
+    /** A node's diameter in px, 1 or more. Default 40. */
+    nodeSize?: number;
+}
+/** `teamStylesheet` options. */
+interface TeamStylesheetOptions extends CyColorOptions {
+    /** The league the teams belong to, e.g. "soccer". */
+    league: League;
+    /** The teams to colour, as the elements name them before resolving (see `idSystem`). */
+    teams: readonly unknown[];
+}
+/** `passNetwork` options. */
+interface PassNetworkOptions extends CyColorOptions {
+    /** Name of the row column holding the passer's player id. */
+    from: string;
+    /** Name of the row column holding the receiver's player id. */
+    to: string;
+    /** Name of the row column holding the passing team (abbreviation, name or id; see `idSystem`). */
+    team: string;
+    /** The league the teams belong to, e.g. "soccer"; also the league of the headshots. */
+    league: League;
+    /** Name of the row column holding the passer's name (the node's label and initials). Default: the id. */
+    fromName?: string;
+    /** Name of the row column holding the receiver's name. Default: the id. */
+    toName?: string;
+    /** Name of a row column summed per pair in place of counting rows. */
+    weight?: string;
+    /**
+     * Given, pairs whose weight (passes, or the summed `weight` column) is smaller are left out; every player stays.
+     * Default: none, so no pair is left out (a fractional weight such as xT keeps every pair). 2 or 3 is the usual
+     * threshold for a pass map.
+     */
+    minWeight?: number;
+    /** With `y`, `xend` and `yend`: the row columns of each pass's start (x, y) and end; all four or none. */
+    x?: string;
+    /** The pass start's y (up, as on a plot). */
+    y?: string;
+    /** The pass end's x. */
+    xend?: string;
+    /** The pass end's y. */
+    yend?: string;
+    /** Model px per data unit of x and y, more than 0. Default 10 (a 105 m pitch is 1,050 px across at zoom 1). */
+    scale?: number;
+    /**
+     * Which ids `from` and `to` hold, for headshots: "espn" (default; ESPN athlete ids) or "gsis" (nflverse; needs
+     * `loadGsis()` first). `false` draws every player as initials and warns about none. A player with no headshot (a
+     * league without ESPN headshots, such as soccer, or an id that does not resolve) is drawn as initials, with one
+     * warning naming them.
+     */
+    headshots?: "espn" | "gsis" | false;
+    /** The heaviest pair's edge width in px, 1 or more. Default 10. */
+    edgeWidth?: number;
+}
+/**
+ * A Cytoscape stylesheet that draws elements in team colours: a node whose `data.team` is a team's id is filled with
+ * its colour (a headshot node shows the colour as its border), its initials in the ink that reads on it, and an edge
+ * with that `data.team` is stroked in it, arrow included. The base blocks draw `passNetwork`'s elements: node size,
+ * headshot nodes (`data.image` as the background, the name below), initials nodes, directed bezier edges as wide as
+ * `data.width` px. Elements whose team does not resolve take `fallback`. `data.team` holds the resolved team id, as
+ * `passNetwork` writes it; for your own elements, resolve the ids first (or pass `idSystem: "team_id"`).
+ *
+ * @example
+ * ```ts
+ * import { loadLeague } from "@sportsdataverse/sdvplot";
+ * import { teamStylesheet } from "@sportsdataverse/sdvplot/cytoscape";
+ *
+ * await loadLeague("nfl");
+ * const style = teamStylesheet({ league: "nfl", teams: ["KC", "PHI"], background: "#181a1b" });
+ * // in the browser: cytoscape({ container, elements, style })
+ * style.length;
+ * ```
+ */
+declare function teamStylesheet(o: TeamStylesheetOptions): StyleBlock[];
+/**
+ * A passing network as Cytoscape elements and stylesheet: one node per player, one directed edge per passer to
+ * receiver pair, weighted by its passes (a row is a pass; `weight` sums a column instead) and as wide as that weight
+ * (`edgeWidth` px for the heaviest pair, the others in proportion), stroked in the passing team's colour with an arrow at
+ * the receiver. A player whose headshot resolves is drawn as it (`background-image`), with the name below; any other is
+ * a node in the team's colour with the name's initials, the clean fallback, with one warning naming those players
+ * (soccer has no headshots, so every soccer player is this node; `headshots: false` asks for none). With x, y, xend and
+ * yend, each node sits at the mean of where the player passed from and received (y up, flipped for Cytoscape's y-down
+ * model, `scale` px per unit): draw it with the `preset` layout. Without them, use a layout such as `cose`. A row with
+ * no passer, no receiver or a missing coordinate is left out with one warning. The stylesheet is `teamStylesheet`'s.
+ *
+ * @example
+ * ```ts
+ * import { loadLeague } from "@sportsdataverse/sdvplot";
+ * import { passNetwork } from "@sportsdataverse/sdvplot/cytoscape";
+ *
+ * await loadLeague("nfl");
+ * // Patrick Mahomes to Xavier Worthy, a Super Bowl LIX touchdown (ESPN athlete ids)
+ * const pass = { from: 3139477, from_name: "Patrick Mahomes", to: 4683062, to_name: "Xavier Worthy", team: "KC" };
+ * const { elements, style } = passNetwork([pass], {
+ *   from: "from",
+ *   to: "to",
+ *   fromName: "from_name",
+ *   toName: "to_name",
+ *   team: "team",
+ *   league: "nfl",
+ * });
+ * // in the browser: cytoscape({ container, elements, style, layout: { name: "cose" } })
+ * elements.nodes[0]?.data.image;
+ * ```
+ */
+declare function passNetwork(rows: readonly Row[], o: PassNetworkOptions): PassNetwork;
+
+export { type CyColorOptions, type CyEdge, type CyNode, type PassNetwork, type PassNetworkOptions, Row, type StyleBlock, type TeamStylesheetOptions, passNetwork, teamStylesheet };

package/dist/cytoscape.js

@@ -0,0 +1,219 @@
+import { colorList, teamPalette, column } from './chunk-UL5M6KDE.js';
+import './chunk-7ULOCCFL.js';
+import { resolveSync, ESPN_HEADSHOT_LEAGUES, headshotUrl } from './chunk-ZAEQXFJM.js';
+import { hex6, onColor } from './chunk-J6R2LEJ7.js';
+import { InputError, warn } from './chunk-E7G7VSLV.js';
+
+// src/cytoscape.ts
+var real = (v) => typeof v === "number" && Number.isFinite(v);
+function checkPx(name, v) {
+  if (!real(v) || v < 1)
+    throw new InputError(
+      `${name} is in px (Cytoscape style units), 1 or more, not a fraction; got ${String(v)}`
+    );
+  return v;
+}
+function playerId(v) {
+  if (v === null || v === void 0 || typeof v === "number" && !Number.isFinite(v)) return null;
+  const s = String(v).trim();
+  return s === "" ? null : s;
+}
+function initialsOf(name) {
+  const words = name.split(/\s+/).filter((w) => w !== "");
+  return words.filter((_, i) => i === 0 || i === words.length - 1).map((w) => Array.from(w)[0].toUpperCase()).join("");
+}
+var shownList = (v) => v.slice(0, 10).map(String).join(", ") + (v.length > 10 ? ` and ${v.length - 10} more` : "");
+function teamStylesheet(o) {
+  const size = checkPx("nodeSize", o.nodeSize ?? 40);
+  const fallback = hex6(o.fallback ?? "#808080", { dropAlpha: true });
+  const ink = onColor(hex6(o.background ?? "#ffffff"));
+  const ro = {
+    ...o.season === void 0 ? {} : { season: o.season },
+    ...o.idSystem === void 0 ? {} : { idSystem: o.idSystem }
+  };
+  const ids = [];
+  for (const id of resolveSync(o.teams, o.league, ro))
+    if (id !== void 0 && !ids.includes(id)) ids.push(id);
+  const which = o.which ?? "primary";
+  const co = { idSystem: "team_id", ...o.season === void 0 ? {} : { season: o.season } };
+  const main = colorList(o.league, ids, { ...co, which });
+  const other = colorList(o.league, ids, { ...co, which: which === "primary" ? "secondary" : "primary" });
+  let colors = main.map((c, i) => hex6(c ?? other[i] ?? fallback, { dropAlpha: true }));
+  if (o.background !== void 0) colors = teamPalette(colors, other, hex6(o.background), ids);
+  const base = [
+    {
+      selector: "node",
+      style: {
+        width: size,
+        height: size,
+        "background-color": fallback,
+        "border-width": 3,
+        "border-color": fallback,
+        "font-size": 12
+      }
+    },
+    {
+      selector: "node.initials",
+      style: {
+        label: "data(initials)",
+        "text-valign": "center",
+        "text-halign": "center",
+        "font-size": Math.max(8, Math.round(size * 0.36)),
+        "font-weight": "bold",
+        color: onColor(fallback)
+      }
+    },
+    {
+      selector: "node.headshot",
+      style: {
+        "background-image": "data(image)",
+        "background-fit": "cover",
+        "background-clip": "node",
+        label: "data(label)",
+        "text-valign": "bottom",
+        "text-halign": "center",
+        "text-margin-y": 4,
+        color: ink
+      }
+    },
+    {
+      selector: "edge",
+      style: {
+        "curve-style": "bezier",
+        "target-arrow-shape": "triangle",
+        "line-color": fallback,
+        "target-arrow-color": fallback
+      }
+    },
+    { selector: "edge[width]", style: { width: "data(width)" } }
+  ];
+  const teams = ids.flatMap((id, i) => {
+    const c = colors[i];
+    const at = `[team = ${JSON.stringify(id)}]`;
+    return [
+      { selector: `node${at}`, style: { "background-color": c, "border-color": c } },
+      { selector: `node.initials${at}`, style: { color: onColor(c) } },
+      { selector: `edge${at}`, style: { "line-color": c, "target-arrow-color": c } }
+    ];
+  });
+  return [...base, ...teams];
+}
+function passNetwork(rows, o) {
+  const edgeWidth = checkPx("edgeWidth", o.edgeWidth ?? 10);
+  checkPx("nodeSize", o.nodeSize ?? 40);
+  const minWeight = o.minWeight;
+  if (minWeight !== void 0 && (!real(minWeight) || minWeight < 0))
+    throw new InputError(`minWeight is 0 or more, got ${String(minWeight)}`);
+  const at = [o.x, o.y, o.xend, o.yend];
+  const placed = at.every((c) => c !== void 0);
+  if (!placed && at.some((c) => c !== void 0))
+    throw new InputError("x, y, xend and yend place the players together: give all four or none");
+  const scale = o.scale ?? 10;
+  if (!real(scale) || scale <= 0)
+    throw new InputError(`scale is px per data unit, more than 0, got ${String(scale)}`);
+  const from = column(rows, o.from, "from");
+  const to = column(rows, o.to, "to");
+  const teams = column(rows, o.team, "team");
+  const names = (c, what) => c === void 0 ? void 0 : column(rows, c, what);
+  const fromName = names(o.fromName, "fromName");
+  const toName = names(o.toName, "toName");
+  const weights = o.weight === void 0 ? void 0 : column(rows, o.weight, "weight");
+  const xy = placed ? at.map((c, k) => column(rows, c, ["x", "y", "xend", "yend"][k])) : [];
+  const ro = {
+    ...o.season === void 0 ? {} : { season: o.season },
+    ...o.idSystem === void 0 ? {} : { idSystem: o.idSystem }
+  };
+  const resolved = resolveSync(teams, o.league, ro);
+  const players = /* @__PURE__ */ new Map();
+  const pairs = /* @__PURE__ */ new Map();
+  const skipped = [];
+  const meet = (id, name, team, x, y) => {
+    let p = players.get(id);
+    if (p === void 0) {
+      const n = name === null || name === void 0 ? "" : String(name).trim();
+      p = { label: n === "" ? id : n, team, xs: [], ys: [] };
+      players.set(id, p);
+    }
+    if (x !== void 0 && y !== void 0) {
+      p.xs.push(x);
+      p.ys.push(y);
+    }
+  };
+  rows.forEach((_, i) => {
+    const a = playerId(from[i]);
+    const b = playerId(to[i]);
+    const c = xy.map((col) => col[i]);
+    const w = weights === void 0 ? 1 : weights[i];
+    if (a === null || b === null || !c.every(real) || !real(w)) {
+      skipped.push(a ?? b ?? i);
+      return;
+    }
+    const team = resolved[i];
+    const [x0, y0, x1, y1] = c;
+    meet(a, fromName?.[i], team, x0, y0);
+    meet(b, toName?.[i], team, x1, y1);
+    const key = `${a}->${b}`;
+    const pair = pairs.get(key) ?? { source: a, target: b, weight: 0, team };
+    pair.weight += w;
+    pairs.set(key, pair);
+  });
+  if (skipped.length > 0)
+    warn(
+      `cytoscape:passes:${o.league}:${shownList(skipped)}`,
+      `skipped ${skipped.length} pass(es) with no passer, no receiver, or a missing coordinate or weight: ${shownList(skipped)}`
+    );
+  const hl = o.headshots === false || !Object.hasOwn(ESPN_HEADSHOT_LEAGUES, o.league) ? void 0 : o.league;
+  const noImage = [];
+  const mean = (v) => v.reduce((s, x) => s + x, 0) / v.length;
+  const nodes = [...players].map(([id, p]) => {
+    const image = hl === void 0 ? void 0 : headshotUrl(id, hl, { idSystem: o.headshots === "gsis" ? "gsis" : "espn" });
+    if (image === void 0 && o.headshots !== false) noImage.push(p.label);
+    return {
+      data: {
+        id,
+        label: p.label,
+        initials: p.label === id ? id : initialsOf(p.label),
+        ...p.team === void 0 ? {} : { team: p.team },
+        ...image === void 0 ? {} : { image }
+      },
+      ...placed ? { position: { x: scale * mean(p.xs), y: -scale * mean(p.ys) } } : {},
+      classes: image === void 0 ? "initials" : "headshot"
+    };
+  });
+  if (noImage.length > 0)
+    warn(
+      `cytoscape:headshots:${o.league}:${shownList(noImage)}`,
+      `drew ${noImage.length} player(s) with no headshot as team-coloured initials: ${shownList(noImage)}`
+    );
+  const kept = [...pairs.values()].filter((p) => minWeight === void 0 || p.weight >= minWeight);
+  const heaviest = Math.max(0, ...kept.map((p) => p.weight));
+  const edges = kept.map(
+    (p) => ({
+      data: {
+        id: `${p.source}->${p.target}`,
+        source: p.source,
+        target: p.target,
+        weight: p.weight,
+        // a pair whose summed weight is 0 or less (xT can be negative) is 0 px wide: Cytoscape refuses a negative width
+        width: heaviest > 0 ? edgeWidth * Math.max(0, p.weight) / heaviest : edgeWidth,
+        ...p.team === void 0 ? {} : { team: p.team }
+      }
+    })
+  );
+  const colors = Object.fromEntries(
+    ["season", "which", "background", "fallback", "nodeSize"].flatMap(
+      (k) => o[k] === void 0 ? [] : [[k, o[k]]]
+    )
+  );
+  const style = teamStylesheet({
+    ...colors,
+    league: o.league,
+    teams: [...new Set(resolved)].filter((t) => t !== void 0),
+    idSystem: "team_id"
+  });
+  return { elements: { nodes, edges }, style };
+}
+
+export { passNetwork, teamStylesheet };
+//# sourceMappingURL=cytoscape.js.map
+//# sourceMappingURL=cytoscape.js.map

package/dist/cytoscape.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cytoscape.ts"],"names":[],"mappings":"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","file":"cytoscape.js","sourcesContent":["/**\n * The Cytoscape.js adapter: passing networks as Cytoscape elements and a team-coloured stylesheet. Pure: it never\n * imports cytoscape (3.34.3 or later is an optional peer), so the network can be built anywhere, a server included,\n * and handed to the library as plain JSON: `cytoscape({ container, elements, style, layout: { name: \"preset\" } })`.\n * Sizes are Cytoscape style units, px at zoom 1: a node's diameter, an edge's width. Synchronous: call after\n * `loadLeague(league)` / `preloadAll()` (and `loadGsis()` for gsis headshots).\n */\nimport { type Row, colorList, column } from \"./_web.js\";\nimport { hex6, onColor } from \"./contrast.js\";\nimport { InputError, warn } from \"./errors.js\";\nimport { ESPN_HEADSHOT_LEAGUES, type EspnHeadshotLeague, headshotUrl } from \"./headshots.js\";\nimport { type Value, resolveSync } from \"./resolve.js\";\nimport { teamPalette } from \"./team-palette.js\";\nimport type { IdSystem, League, SeasonInput, Which } from \"./types.js\";\n\nexport type { Row } from \"./_web.js\";\n\n/** A player node. `classes` is \"headshot\" (its image drawn as the node) or \"initials\" (team colour and initials). */\nexport interface CyNode {\n  data: {\n    /** The player id, as text. */\n    id: string;\n    /** The player's name, else the id. */\n    label: string;\n    /** The first letters of the name's first and last words, else the id. */\n    initials: string;\n    /** The resolved team id; absent when the team does not resolve (the node keeps the fallback colour). */\n    team?: string;\n    /** The headshot URL, on a headshot node only. */\n    image?: string;\n  };\n  /** Where the player stood (with the x/y/xend/yend options): model px, y down. */\n  position?: { x: number; y: number };\n  classes: \"headshot\" | \"initials\";\n}\n/** A directed edge from passer to receiver. */\nexport interface CyEdge {\n  data: {\n    /** The source and target ids joined by an arrow, as in 5485-\\>3099 (Varane to Lloris). */\n    id: string;\n    /** The passer's node id. */\n    source: string;\n    /** The receiver's node id. */\n    target: string;\n    /** The pair's passes (or summed `weight`). */\n    weight: number;\n    /**\n     * The edge's width in px: `edgeWidth` for the heaviest pair, the others in proportion to their weight; 0 for a pair\n     * whose weight is 0 or less (a summed xT can be negative), since Cytoscape takes no negative width.\n     */\n    width: number;\n    /** The passer's resolved team id; absent when it does not resolve. */\n    team?: string;\n  };\n}\n/** One stylesheet block, Cytoscape's `{ selector, style }` JSON. */\nexport interface StyleBlock {\n  selector: string;\n  style: Record<string, string | number>;\n}\n/** `passNetwork`'s result: what `cytoscape({ elements, style })` takes. */\nexport interface PassNetwork {\n  elements: { nodes: CyNode[]; edges: CyEdge[] };\n  style: StyleBlock[];\n}\n\n/** The colour options `teamStylesheet` and `passNetwork` share. */\nexport interface CyColorOptions {\n  /** The season the teams are resolved for. */\n  season?: SeasonInput;\n  /** How the team values are read. Default \"auto\". */\n  idSystem?: IdSystem;\n  /** The team colour drawn, \"primary\" (default) or \"secondary\". */\n  which?: Which;\n  /**\n   * The background the network is drawn on (Cytoscape's container). Given, every team colour keeps 3:1 contrast\n   * against it (dark mode) and aims to stay distinct (CIE76 ΔE of 20 or more) from every other team's, through the\n   * shared team palette, as `teamColorPalette` does in the other adapters (when it cannot, it keeps the readable colour\n   * and warns once); a headshot node's name takes the ink that reads on it.\n   */\n  background?: string;\n  /** The colour of an element whose team does not resolve, or has no colour. Default \"#808080\". */\n  fallback?: string;\n  /** A node's diameter in px, 1 or more. Default 40. */\n  nodeSize?: number;\n}\n/** `teamStylesheet` options. */\nexport interface TeamStylesheetOptions extends CyColorOptions {\n  /** The league the teams belong to, e.g. \"soccer\". */\n  league: League;\n  /** The teams to colour, as the elements name them before resolving (see `idSystem`). */\n  teams: readonly unknown[];\n}\n/** `passNetwork` options. */\nexport interface PassNetworkOptions extends CyColorOptions {\n  /** Name of the row column holding the passer's player id. */\n  from: string;\n  /** Name of the row column holding the receiver's player id. */\n  to: string;\n  /** Name of the row column holding the passing team (abbreviation, name or id; see `idSystem`). */\n  team: string;\n  /** The league the teams belong to, e.g. \"soccer\"; also the league of the headshots. */\n  league: League;\n  /** Name of the row column holding the passer's name (the node's label and initials). Default: the id. */\n  fromName?: string;\n  /** Name of the row column holding the receiver's name. Default: the id. */\n  toName?: string;\n  /** Name of a row column summed per pair in place of counting rows. */\n  weight?: string;\n  /**\n   * Given, pairs whose weight (passes, or the summed `weight` column) is smaller are left out; every player stays.\n   * Default: none, so no pair is left out (a fractional weight such as xT keeps every pair). 2 or 3 is the usual\n   * threshold for a pass map.\n   */\n  minWeight?: number;\n  /** With `y`, `xend` and `yend`: the row columns of each pass's start (x, y) and end; all four or none. */\n  x?: string;\n  /** The pass start's y (up, as on a plot). */\n  y?: string;\n  /** The pass end's x. */\n  xend?: string;\n  /** The pass end's y. */\n  yend?: string;\n  /** Model px per data unit of x and y, more than 0. Default 10 (a 105 m pitch is 1,050 px across at zoom 1). */\n  scale?: number;\n  /**\n   * Which ids `from` and `to` hold, for headshots: \"espn\" (default; ESPN athlete ids) or \"gsis\" (nflverse; needs\n   * `loadGsis()` first). `false` draws every player as initials and warns about none. A player with no headshot (a\n   * league without ESPN headshots, such as soccer, or an id that does not resolve) is drawn as initials, with one\n   * warning naming them.\n   */\n  headshots?: \"espn\" | \"gsis\" | false;\n  /** The heaviest pair's edge width in px, 1 or more. Default 10. */\n  edgeWidth?: number;\n}\n\nconst real = (v: unknown): v is number => typeof v === \"number\" && Number.isFinite(v);\nfunction checkPx(name: string, v: unknown): number {\n  if (!real(v) || v < 1)\n    throw new InputError(\n      `${name} is in px (Cytoscape style units), 1 or more, not a fraction; got ${String(v)}`,\n    );\n  return v;\n}\n/** A player id as text: a number as JS prints it (no \".0\"), a string trimmed; missing or empty is null. */\nfunction playerId(v: unknown): string | null {\n  if (v === null || v === undefined || (typeof v === \"number\" && !Number.isFinite(v))) return null;\n  const s = String(v).trim();\n  return s === \"\" ? null : s;\n}\n/** The first letters of a name's first and last words (\"Kylian Mbappé\" KM, \"N'Golo Kanté\" NK); one word: its first. */\nfunction initialsOf(name: string): string {\n  const words = name.split(/\\s+/).filter((w) => w !== \"\");\n  return words\n    .filter((_, i) => i === 0 || i === words.length - 1)\n    .map((w) => (Array.from(w)[0] as string).toUpperCase())\n    .join(\"\");\n}\nconst shownList = (v: readonly unknown[]): string =>\n  v.slice(0, 10).map(String).join(\", \") + (v.length > 10 ? ` and ${v.length - 10} more` : \"\");\n\n/**\n * A Cytoscape stylesheet that draws elements in team colours: a node whose `data.team` is a team's id is filled with\n * its colour (a headshot node shows the colour as its border), its initials in the ink that reads on it, and an edge\n * with that `data.team` is stroked in it, arrow included. The base blocks draw `passNetwork`'s elements: node size,\n * headshot nodes (`data.image` as the background, the name below), initials nodes, directed bezier edges as wide as\n * `data.width` px. Elements whose team does not resolve take `fallback`. `data.team` holds the resolved team id, as\n * `passNetwork` writes it; for your own elements, resolve the ids first (or pass `idSystem: \"team_id\"`).\n *\n * @example\n * ```ts\n * import { loadLeague } from \"@sportsdataverse/sdvplot\";\n * import { teamStylesheet } from \"@sportsdataverse/sdvplot/cytoscape\";\n *\n * await loadLeague(\"nfl\");\n * const style = teamStylesheet({ league: \"nfl\", teams: [\"KC\", \"PHI\"], background: \"#181a1b\" });\n * // in the browser: cytoscape({ container, elements, style })\n * style.length;\n * ```\n */\nexport function teamStylesheet(o: TeamStylesheetOptions): StyleBlock[] {\n  const size = checkPx(\"nodeSize\", o.nodeSize ?? 40);\n  const fallback = hex6(o.fallback ?? \"#808080\", { dropAlpha: true });\n  const ink = onColor(hex6(o.background ?? \"#ffffff\"));\n  const ro = {\n    ...(o.season === undefined ? {} : { season: o.season }),\n    ...(o.idSystem === undefined ? {} : { idSystem: o.idSystem }),\n  };\n  // one rule per distinct team, in order of first appearance; a team that does not resolve gets none, so it never\n  // moves a real team's colour\n  const ids: string[] = [];\n  for (const id of resolveSync(o.teams as readonly Value[], o.league, ro))\n    if (id !== undefined && !ids.includes(id)) ids.push(id);\n  const which = o.which ?? \"primary\";\n  const co = { idSystem: \"team_id\" as const, ...(o.season === undefined ? {} : { season: o.season }) };\n  const main = colorList(o.league, ids, { ...co, which });\n  const other = colorList(o.league, ids, { ...co, which: which === \"primary\" ? \"secondary\" : \"primary\" });\n  let colors = main.map((c, i) => hex6(c ?? other[i] ?? fallback, { dropAlpha: true }));\n  if (o.background !== undefined) colors = teamPalette(colors, other, hex6(o.background), ids);\n  const base: StyleBlock[] = [\n    {\n      selector: \"node\",\n      style: {\n        width: size,\n        height: size,\n        \"background-color\": fallback,\n        \"border-width\": 3,\n        \"border-color\": fallback,\n        \"font-size\": 12,\n      },\n    },\n    {\n      selector: \"node.initials\",\n      style: {\n        label: \"data(initials)\",\n        \"text-valign\": \"center\",\n        \"text-halign\": \"center\",\n        \"font-size\": Math.max(8, Math.round(size * 0.36)),\n        \"font-weight\": \"bold\",\n        color: onColor(fallback),\n      },\n    },\n    {\n      selector: \"node.headshot\",\n      style: {\n        \"background-image\": \"data(image)\",\n        \"background-fit\": \"cover\",\n        \"background-clip\": \"node\",\n        label: \"data(label)\",\n        \"text-valign\": \"bottom\",\n        \"text-halign\": \"center\",\n        \"text-margin-y\": 4,\n        color: ink,\n      },\n    },\n    {\n      selector: \"edge\",\n      style: {\n        \"curve-style\": \"bezier\",\n        \"target-arrow-shape\": \"triangle\",\n        \"line-color\": fallback,\n        \"target-arrow-color\": fallback,\n      },\n    },\n    { selector: \"edge[width]\", style: { width: \"data(width)\" } },\n  ];\n  const teams = ids.flatMap((id, i): StyleBlock[] => {\n    const c = colors[i] as string;\n    const at = `[team = ${JSON.stringify(id)}]`;\n    return [\n      { selector: `node${at}`, style: { \"background-color\": c, \"border-color\": c } },\n      { selector: `node.initials${at}`, style: { color: onColor(c) } },\n      { selector: `edge${at}`, style: { \"line-color\": c, \"target-arrow-color\": c } },\n    ];\n  });\n  return [...base, ...teams];\n}\n\n/**\n * A passing network as Cytoscape elements and stylesheet: one node per player, one directed edge per passer to\n * receiver pair, weighted by its passes (a row is a pass; `weight` sums a column instead) and as wide as that weight\n * (`edgeWidth` px for the heaviest pair, the others in proportion), stroked in the passing team's colour with an arrow at\n * the receiver. A player whose headshot resolves is drawn as it (`background-image`), with the name below; any other is\n * a node in the team's colour with the name's initials, the clean fallback, with one warning naming those players\n * (soccer has no headshots, so every soccer player is this node; `headshots: false` asks for none). With x, y, xend and\n * yend, each node sits at the mean of where the player passed from and received (y up, flipped for Cytoscape's y-down\n * model, `scale` px per unit): draw it with the `preset` layout. Without them, use a layout such as `cose`. A row with\n * no passer, no receiver or a missing coordinate is left out with one warning. The stylesheet is `teamStylesheet`'s.\n *\n * @example\n * ```ts\n * import { loadLeague } from \"@sportsdataverse/sdvplot\";\n * import { passNetwork } from \"@sportsdataverse/sdvplot/cytoscape\";\n *\n * await loadLeague(\"nfl\");\n * // Patrick Mahomes to Xavier Worthy, a Super Bowl LIX touchdown (ESPN athlete ids)\n * const pass = { from: 3139477, from_name: \"Patrick Mahomes\", to: 4683062, to_name: \"Xavier Worthy\", team: \"KC\" };\n * const { elements, style } = passNetwork([pass], {\n *   from: \"from\",\n *   to: \"to\",\n *   fromName: \"from_name\",\n *   toName: \"to_name\",\n *   team: \"team\",\n *   league: \"nfl\",\n * });\n * // in the browser: cytoscape({ container, elements, style, layout: { name: \"cose\" } })\n * elements.nodes[0]?.data.image;\n * ```\n */\nexport function passNetwork(rows: readonly Row[], o: PassNetworkOptions): PassNetwork {\n  const edgeWidth = checkPx(\"edgeWidth\", o.edgeWidth ?? 10);\n  checkPx(\"nodeSize\", o.nodeSize ?? 40);\n  const minWeight = o.minWeight;\n  if (minWeight !== undefined && (!real(minWeight) || minWeight < 0))\n    throw new InputError(`minWeight is 0 or more, got ${String(minWeight)}`);\n  const at = [o.x, o.y, o.xend, o.yend];\n  const placed = at.every((c) => c !== undefined);\n  if (!placed && at.some((c) => c !== undefined))\n    throw new InputError(\"x, y, xend and yend place the players together: give all four or none\");\n  const scale = o.scale ?? 10;\n  if (!real(scale) || scale <= 0)\n    throw new InputError(`scale is px per data unit, more than 0, got ${String(scale)}`);\n  const from = column(rows, o.from, \"from\");\n  const to = column(rows, o.to, \"to\");\n  const teams = column(rows, o.team, \"team\");\n  const names = (c: string | undefined, what: string) =>\n    c === undefined ? undefined : column(rows, c, what);\n  const fromName = names(o.fromName, \"fromName\");\n  const toName = names(o.toName, \"toName\");\n  const weights = o.weight === undefined ? undefined : column(rows, o.weight, \"weight\");\n  const xy = placed\n    ? at.map((c, k) => column(rows, c as string, [\"x\", \"y\", \"xend\", \"yend\"][k] as string))\n    : [];\n  const ro = {\n    ...(o.season === undefined ? {} : { season: o.season }),\n    ...(o.idSystem === undefined ? {} : { idSystem: o.idSystem }),\n  };\n  const resolved = resolveSync(teams, o.league, ro);\n\n  type Player = { label: string; team: string | undefined; xs: number[]; ys: number[] };\n  const players = new Map<string, Player>();\n  const pairs = new Map<\n    string,\n    { source: string; target: string; weight: number; team: string | undefined }\n  >();\n  const skipped: Value[] = [];\n  const meet = (id: string, name: unknown, team: string | undefined, x?: number, y?: number): void => {\n    let p = players.get(id);\n    if (p === undefined) {\n      const n = name === null || name === undefined ? \"\" : String(name).trim();\n      p = { label: n === \"\" ? id : n, team, xs: [], ys: [] };\n      players.set(id, p);\n    }\n    if (x !== undefined && y !== undefined) {\n      p.xs.push(x);\n      p.ys.push(y);\n    }\n  };\n  rows.forEach((_, i) => {\n    const a = playerId(from[i]);\n    const b = playerId(to[i]);\n    const c = xy.map((col) => col[i]);\n    const w = weights === undefined ? 1 : weights[i];\n    if (a === null || b === null || !c.every(real) || !real(w)) {\n      skipped.push(a ?? b ?? i);\n      return;\n    }\n    const team = resolved[i];\n    const [x0, y0, x1, y1] = c as number[];\n    meet(a, fromName?.[i], team, x0, y0);\n    meet(b, toName?.[i], team, x1, y1);\n    const key = `${a}->${b}`;\n    const pair = pairs.get(key) ?? { source: a, target: b, weight: 0, team };\n    pair.weight += w;\n    pairs.set(key, pair);\n  });\n  if (skipped.length > 0)\n    warn(\n      `cytoscape:passes:${o.league}:${shownList(skipped)}`,\n      `skipped ${skipped.length} pass(es) with no passer, no receiver, or a missing coordinate or weight: ${shownList(skipped)}`,\n    );\n\n  const hl = o.headshots === false || !Object.hasOwn(ESPN_HEADSHOT_LEAGUES, o.league) ? undefined : o.league;\n  const noImage: string[] = [];\n  const mean = (v: readonly number[]): number => v.reduce((s, x) => s + x, 0) / v.length;\n  const nodes = [...players].map(([id, p]): CyNode => {\n    const image =\n      hl === undefined\n        ? undefined\n        : headshotUrl(id, hl as EspnHeadshotLeague, { idSystem: o.headshots === \"gsis\" ? \"gsis\" : \"espn\" });\n    if (image === undefined && o.headshots !== false) noImage.push(p.label);\n    return {\n      data: {\n        id,\n        label: p.label,\n        initials: p.label === id ? id : initialsOf(p.label),\n        ...(p.team === undefined ? {} : { team: p.team }),\n        ...(image === undefined ? {} : { image }),\n      },\n      ...(placed ? { position: { x: scale * mean(p.xs), y: -scale * mean(p.ys) } } : {}),\n      classes: image === undefined ? \"initials\" : \"headshot\",\n    };\n  });\n  if (noImage.length > 0)\n    warn(\n      `cytoscape:headshots:${o.league}:${shownList(noImage)}`,\n      `drew ${noImage.length} player(s) with no headshot as team-coloured initials: ${shownList(noImage)}`,\n    );\n  const kept = [...pairs.values()].filter((p) => minWeight === undefined || p.weight >= minWeight);\n  const heaviest = Math.max(0, ...kept.map((p) => p.weight));\n  const edges = kept.map(\n    (p): CyEdge => ({\n      data: {\n        id: `${p.source}->${p.target}`,\n        source: p.source,\n        target: p.target,\n        weight: p.weight,\n        // a pair whose summed weight is 0 or less (xT can be negative) is 0 px wide: Cytoscape refuses a negative width\n        width: heaviest > 0 ? (edgeWidth * Math.max(0, p.weight)) / heaviest : edgeWidth,\n        ...(p.team === undefined ? {} : { team: p.team }),\n      },\n    }),\n  );\n  const colors = Object.fromEntries(\n    ([\"season\", \"which\", \"background\", \"fallback\", \"nodeSize\"] as const).flatMap((k) =>\n      o[k] === undefined ? [] : [[k, o[k]]],\n    ),\n  ) as CyColorOptions;\n  const style = teamStylesheet({\n    ...colors,\n    league: o.league,\n    teams: [...new Set(resolved)].filter((t) => t !== undefined),\n    idSystem: \"team_id\",\n  });\n  return { elements: { nodes, edges }, style };\n}\n"]}