@sportsdataverse/sdvplot 0.0.0-stage → 0.2.0

package/dist/d3.d.ts

@@ -0,0 +1,234 @@
+import { Selection, BaseType, ScaleOrdinal } from 'd3';
+import { E as EspnHeadshotLeague } from './headshots-B2J_LOO8.js';
+import { V as Value } from './resolve-CQW-jzvr.js';
+import { S as SurfaceSceneOptions } from './surfaces-W-odWLpT.js';
+import { L as League, S as SeasonInput, V as Variant, I as IdSystem, H as HeadshotIdSystem, W as Which } from './types-C7n6gJF3.js';
+import { BinShape } from './bins.js';
+import { DiffScale, SignaturePoint } from './shots.js';
+import '@sportsdataverse/sporty';
+
+/** Face options for `appendHeadshots` (blazing-the-nets `main` scatter "faces", `lib/charts/scatterChart.ts:139-191`). */
+interface FaceOptions {
+    /**
+     * `"circle"`: the headshot inside a circle whose diameter is `height` × `frameHeight`. The image is drawn 2.3 R tall
+     * so the head fills the circle, so `drawnMarks` reports 1.15 × `height` for a face.
+     */
+    clip?: "circle";
+    /** Ring colour per player id (e.g. the team colour; `:183-188`, 1.5 px). Default none. */
+    ring?: string | ((id: string) => string);
+    /** A disc behind the face at 0.35 opacity, still there if the image fails (`:169-172`). Default none. */
+    placeholder?: string | ((id: string) => string);
+}
+
+/** Any `<g>` selection, whatever its datum (d3's `Selection` is invariant in it; see `Sel` in ./index.ts). */
+type G<D> = Selection<SVGGElement, D, BaseType, unknown>;
+/** Options for `appendLegend`. */
+interface AppendLegendOptions {
+    /** Top-left corner of the legend in px; default (0, 0). */
+    x?: number;
+    /** See `x`. */
+    y?: number;
+    /** Space available, which the text wraps to; the bar is at most 240 px (theme.ts:122). */
+    width?: number;
+    /**
+     * Diffs the bar spans; default the scale's end stops. `master`'s legend spanned [-0.30, 0.30]
+     * (`ShootingSignature/Legend.js:36-38`): `{ domain: [-0.3, 0.3], ticks: [-0.3, -0.15, 0, 0.15, 0.3] }`.
+     */
+    domain?: readonly [lo: number, hi: number];
+    /** Tick diffs; default the domain's ends, and 0 when it lies inside them. */
+    ticks?: readonly number[];
+    /** Tick text; default signed points, "0" at 0 (theme.ts:140). */
+    format?: (d: number) => string;
+    /** Caption and key in words (theme.ts:35, :120); `null` for none. */
+    caption?: readonly string[] | null;
+    /** More lines under the caption, wrapped to `width` (e.g. a shrinkage note). */
+    notes?: readonly string[];
+    /** A cell size key under the colour key: pixel size per attempt count and the counts (`sizeCells(...).steps`). */
+    size?: {
+        readonly px: (attempts: number) => number;
+        readonly steps: readonly number[];
+        /** The key's cell shape; default `"hex"`. */
+        readonly shape?: BinShape;
+        /** Default `"hex size: attempts"` or `"square size: attempts"`. */
+        readonly note?: string;
+    };
+}
+/**
+ * A diff-colour legend for d3 charts: gradient bar, ticks, caption, notes and an optional cell size key
+ * (blazing-the-nets `main` `lib/charts/theme.ts:109-143`, `lib/charts/hexShotChart.ts:196-213`). It replaces
+ * `master`'s static PNG ramp (`ShootingSignature/Legend.js:45-50`, `rgy5.png`) with a gradient generated from the
+ * scale, whose id is a hash of its stops. Nothing is measured (text wraps at an estimated 6.2 px per character), so
+ * it renders the same in jsdom and SSR. Returns the height used. Plot users: `Plot.legend({ color: scale.plot })`.
+ *
+ * @example
+ * ```ts
+ * import { create } from "d3";
+ * import { appendLegend } from "@sportsdataverse/sdvplot/d3";
+ * import { diffScale } from "@sportsdataverse/sdvplot/shots";
+ *
+ * const svg = create("svg").attr("viewBox", "0 0 300 80");
+ * appendLegend(svg.append("g"), diffScale(), { width: 280 });
+ * svg.node();
+ * ```
+ */
+declare function appendLegend<D>(g: G<D>, scale?: DiffScale, o?: AppendLegendOptions): number;
+/** Options for `appendSignature`. */
+interface AppendSignatureOptions {
+    /** The caller's scale from distance (ft) to px. */
+    x: (distance: number) => number;
+    /** The caller's scale from FG% (0-1) to px; a clamped scale clamps the ribbon's centre. */
+    y: (fgPct: number) => number;
+    /** Colour of `colourDiff`; default `diffScale()`. */
+    fill?: DiffScale;
+    /** `"monotone-x"` (default, `main`) or `"basis"` (`master` `ShootingSignature/index.js:96`). */
+    curve?: "monotone-x" | "basis";
+    /** Ribbon half-width in PIXELS; default `main`'s `max(share / maxShare * 20, 0.75)` (`shootingSignature.ts:131-132`). */
+    halfWidth?: (p: SignaturePoint, maxShare: number) => number;
+    /** The dashed league line, faint everywhere and full strength under the ribbon (`:165-181`); default true. */
+    league?: boolean;
+}
+/**
+ * The d3 twin of `sdvplot/plot`'s `shootingSignature`: the dashed league line and the ribbon along FG% by distance,
+ * as wide as the shot share and coloured along x by the shrunk FG% vs league (blazing-the-nets `main`
+ * `lib/charts/shootingSignature.ts:165-211`). The same points give the Plot mark's ribbon and league paths, gradient
+ * stops and gradient id when the scales match (with a 190 px [0, 1] y axis for the default half-width). A null
+ * `fgPct` is a gap. The gradient id hashes its stops and its pixel x range, so two signatures on a page, or one at
+ * two widths, never share one. y goes through the caller's `y` as it is: the ribbon's edges are
+ * `y(fgPct) ± halfWidth`, and a clamped scale clamps the centre (as `main` does). Returns the `<g>` it appended.
+ *
+ * @example
+ * ```ts
+ * import { create, scaleLinear } from "d3";
+ * import { appendSignature } from "@sportsdataverse/sdvplot/d3";
+ * import { fgPctByDistance, signaturePoints, vsLeague } from "@sportsdataverse/sdvplot/shots";
+ *
+ * // Brooklyn shots from the sportsdataverse-data nba_stats_shots release, 2025-26
+ * const shots = [
+ *   { x_legacy: -1, y_legacy: 7, shot_distance: 1, shot_value: 2, shot_result: "Made" },
+ *   { x_legacy: 0, y_legacy: 0, shot_distance: 0, shot_value: 2, shot_result: "Missed" },
+ *   { x_legacy: -44, y_legacy: 252, shot_distance: 26, shot_value: 3, shot_result: "Made" },
+ * ];
+ * // the makes against all three attempts, which stand in for the league (the gallery's uses the 2025-26 league)
+ * const made = fgPctByDistance(shots.filter((s) => s.shot_result === "Made"));
+ * const points = signaturePoints(vsLeague(made, fgPctByDistance(shots)), { minAttempts: 1 });
+ * const svg = create("svg").attr("viewBox", "0 0 400 200");
+ * appendSignature(svg.append("g"), points, { x: scaleLinear([0, 35], [0, 400]), y: scaleLinear([0, 1], [200, 0]) });
+ * svg.node();
+ * ```
+ */
+declare function appendSignature<D>(sel: G<D>, points: readonly SignaturePoint[], o: AppendSignatureOptions): G<D>;
+
+/**
+ * A selection of `G` with any datum `D` and any parent. d3's `Selection` is invariant in its datum, so a helper typed
+ * with `unknown` would reject `create("svg").append("g")` (datum `undefined`) and every bound datum.
+ */
+type Sel<G extends Element, D> = Selection<G, D, BaseType, unknown>;
+/** Where d3 draws: the caller's scales, plus the pixel height the `height` fraction refers to (d3 has no figure). */
+interface Frame {
+    x: (v: Value) => number;
+    y: (v: Value) => number;
+    frameHeight: number;
+    height?: number;
+    alpha?: number;
+    /**
+     * Each image's accessible name from its input value and index; default the team ("KC logo", whatever id system the
+     * values use) or the player id ("3139477 headshot").
+     */
+    ariaLabel?: (value: Value, i: number) => string;
+}
+interface D3MarkOptions extends Frame {
+    league: League;
+    season?: SeasonInput | readonly SeasonInput[];
+    variant?: Variant;
+    idSystem?: IdSystem;
+}
+interface D3HeadshotOptions extends Frame, FaceOptions {
+    league: EspnHeadshotLeague;
+    /** "espn" (default) or "gsis". "gsis" needs `loadGsis()` to have run first, else this throws InputError. */
+    idSystem?: HeadshotIdSystem;
+}
+type AppendTeamMarks = <G extends SVGElement, D>(sel: Sel<G, D>, xs: ArrayLike<Value>, ys: ArrayLike<Value>, teams: readonly Value[], o: D3MarkOptions) => Sel<SVGGElement, D>;
+/**
+ * Append `<g class="sdv-logos">` of team logos at (x, y) through the caller's scale functions. Needs
+ * `loadLeague(league)` first.
+ *
+ * @example
+ * ```ts
+ * import { loadLeague } from "@sportsdataverse/sdvplot";
+ * import { appendLogos } from "@sportsdataverse/sdvplot/d3";
+ * import * as d3 from "d3";
+ *
+ * await loadLeague("nfl");
+ * const x = d3.scaleLinear([250, 550], [0, 480]);
+ * const y = d3.scaleLinear([280, 420], [240, 0]);
+ * const svg = d3.select(document.createElement("div")).append("svg").attr("viewBox", [0, 0, 480, 240]);
+ * appendLogos(svg, [385, 525, 425], [326, 368, 311], ["KC", "BUF", "DEN"], {
+ *   league: "nfl",
+ *   x: (v) => x(Number(v)),
+ *   y: (v) => y(Number(v)),
+ *   frameHeight: 240,
+ *   height: 0.2,
+ * });
+ * svg.node();
+ * ```
+ */
+declare const appendLogos: AppendTeamMarks;
+/** As `appendLogos`, with wordmarks. */
+declare const appendWordmarks: AppendTeamMarks;
+/**
+ * Append `<g class="sdv-headshots">` of ESPN player headshots; `idSystem: "gsis"` needs `loadGsis()` first.
+ * `clip: "circle"` makes circular faces (`height` is then the circle's diameter), with an optional `ring` and `placeholder`.
+ *
+ * @example
+ * ```ts
+ * import { appendHeadshots } from "@sportsdataverse/sdvplot/d3";
+ * import * as d3 from "d3";
+ *
+ * const x = d3.scaleLinear([0, 10], [0, 480]);
+ * const y = d3.scaleLinear([0, 10], [240, 0]);
+ * const svg = d3.select(document.createElement("div")).append("svg").attr("viewBox", [0, 0, 480, 240]);
+ * const team: Record<string, string> = { "3139477": "#e31837", "4374302": "#0076b6", "4429160": "#008e97" };
+ * appendHeadshots(svg, [2, 5, 8], [4, 6, 3], ["3139477", "4374302", "4429160"], {
+ *   league: "nfl",
+ *   x: (v) => x(Number(v)),
+ *   y: (v) => y(Number(v)),
+ *   frameHeight: 240,
+ *   height: 0.25,
+ *   clip: "circle",
+ *   ring: (id) => team[id] ?? "grey",
+ *   placeholder: (id) => team[id] ?? "grey",
+ * });
+ * svg.node();
+ * ```
+ */
+declare function appendHeadshots<G extends SVGElement, D>(sel: Sel<G, D>, xs: ArrayLike<Value>, ys: ArrayLike<Value>, players: readonly Value[], o: D3HeadshotOptions): Sel<SVGGElement, D>;
+/**
+ * A d3 ordinal scale from team (id or abbr) to team colour; anything unresolved maps to `naValue` (default "grey").
+ *
+ * @example
+ * ```ts
+ * import { loadLeague } from "@sportsdataverse/sdvplot";
+ * import { teamColorScale } from "@sportsdataverse/sdvplot/d3";
+ *
+ * await loadLeague("nba");
+ * const color = teamColorScale("nba", { values: ["LAL", "BOS"] });
+ * ["LAL", "BOS", "not a team"].map(color);
+ * ```
+ */
+declare function teamColorScale(league: League, o?: {
+    which?: Which;
+    season?: SeasonInput;
+    idSystem?: IdSystem;
+    naValue?: string;
+    values?: readonly Value[];
+}): ScaleOrdinal<string, string, string>;
+interface D3SurfaceOptions extends SurfaceSceneOptions {
+    x: (v: number) => number;
+    y: (v: number) => number;
+    /** Describes the surface for assistive technology; default sporty's ("nba basketball surface" and so on). */
+    ariaDescription?: string;
+}
+/** Paint a surface key's surface (in `team`'s colours) into `sel` through the caller's x/y scales. Throws InputError for a key with no surface (see `SURFACES`). */
+declare function appendSurface<G extends SVGGElement | SVGSVGElement, D>(sel: Sel<G, D>, league: League | (string & {}), o: D3SurfaceOptions): Sel<SVGGElement, D>;
+
+export { type AppendLegendOptions, type AppendSignatureOptions, type AppendTeamMarks, type D3HeadshotOptions, type D3MarkOptions, type D3SurfaceOptions, type FaceOptions, appendHeadshots, appendLegend, appendLogos, appendSignature, appendSurface, appendWordmarks, teamColorScale };

package/dist/d3.js

@@ -0,0 +1,198 @@
+import { teamColorDomain, stampImage } from './chunk-OIILARXI.js';
+import { diffScale, signatureGradient, SIGNATURE_NAME } from './chunk-H2C3FMMA.js';
+import { contentId } from './chunk-WQT4IVLX.js';
+import { cellPath } from './chunk-C2CDY5OG.js';
+import { checkHeight, checkAlpha, placeSync, placedName } from './chunk-7ULOCCFL.js';
+import { surfaceScene } from './chunk-57WFSI4Q.js';
+import './chunk-ZAEQXFJM.js';
+import './chunk-J6R2LEJ7.js';
+import { InputError } from './chunk-E7G7VSLV.js';
+import { appendSurface as appendSurface$1 } from '@sportsdataverse/sporty/d3';
+import { curveBasis, curveMonotoneX, line, area, scaleOrdinal } from 'd3';
+
+// src/d3/faces.ts
+var NS = "http://www.w3.org/2000/svg";
+var pick = (c, id) => typeof c === "function" ? c(id) : c;
+function clipFaces(g, o) {
+  if (o.clip !== "circle") return;
+  for (const img of g.selectAll("image").nodes()) {
+    const doc = img.ownerDocument;
+    const id = img.getAttribute("data-sdv-id") ?? "";
+    const w0 = Number(img.getAttribute("width"));
+    const h0 = Number(img.getAttribute("height"));
+    const cx = Number(img.getAttribute("x")) + w0 / 2;
+    const cy = Number(img.getAttribute("y")) + h0 / 2;
+    const r = h0 / 2;
+    const h = 2.3 * r;
+    const w = h0 > 0 ? h * w0 / h0 : 0;
+    img.setAttribute("width", String(w));
+    img.setAttribute("height", String(h));
+    img.setAttribute("x", String(cx - w / 2));
+    img.setAttribute("y", String(cy - 1.05 * r));
+    const clipId = contentId("sdv-face", `${id}|${cx}|${cy}|${r}`);
+    const clip = doc.createElementNS(NS, "clipPath");
+    clip.setAttribute("id", clipId);
+    const disc = doc.createElementNS(NS, "circle");
+    disc.setAttribute("cx", String(cx));
+    disc.setAttribute("cy", String(cy));
+    disc.setAttribute("r", String(r));
+    clip.appendChild(disc);
+    img.setAttribute("clip-path", `url(#${clipId})`);
+    img.before(clip);
+    const fill = pick(o.placeholder, id);
+    if (fill !== void 0) {
+      const ph = disc.cloneNode();
+      ph.setAttribute("fill", fill);
+      ph.setAttribute("fill-opacity", "0.35");
+      img.before(ph);
+    }
+    const stroke = pick(o.ring, id);
+    if (stroke !== void 0) {
+      const ring = disc.cloneNode();
+      ring.setAttribute("fill", "none");
+      ring.setAttribute("stroke", stroke);
+      ring.setAttribute("stroke-width", "1.5");
+      img.after(ring);
+    }
+  }
+}
+var FONT_PX = 11;
+var CHAR_PX = 6.2;
+var LINE_H = 15;
+var MUTED = "var(--sdv-muted, currentColor)";
+var fmtPts = (v) => `${v >= 0 ? "+" : "\u2212"}${Math.abs(v * 100).toFixed(1)}`;
+function wrap(text, maxWidth) {
+  const perLine = Math.max(8, Math.floor(maxWidth / CHAR_PX));
+  const lines = [];
+  let cur = "";
+  for (const word of text.split(" ")) {
+    if (cur && cur.length + 1 + word.length > perLine) {
+      lines.push(cur);
+      cur = word;
+    } else cur = cur ? `${cur} ${word}` : word;
+  }
+  if (cur) lines.push(cur);
+  return lines;
+}
+function appendLegend(g, scale = diffScale(), o = {}) {
+  const x = o.x ?? 0;
+  const y = o.y ?? 0;
+  const maxWidth = o.width ?? 240;
+  const width = Math.min(maxWidth, 240);
+  const [lo, hi] = o.domain ?? [scale.stops[0] ?? 0, scale.stops.at(-1) ?? 0];
+  if (!(Number.isFinite(lo) && Number.isFinite(hi) && hi > lo))
+    throw new InputError(`appendLegend domain must be finite and run low to high, got [${lo}, ${hi}]`);
+  const at = [lo, ...scale.stops.filter((d) => d > lo && d < hi), hi];
+  const stops = at.map((d) => [(d - lo) / (hi - lo) * 100, scale(d)]);
+  const id = contentId("sdv-legend", stops.map((s) => s.join(" ")).join(";"));
+  const grad = g.append("defs").append("linearGradient").attr("id", id);
+  for (const [offset, colour] of stops)
+    grad.append("stop").attr("offset", `${offset}%`).attr("stop-color", colour);
+  const format = o.format ?? ((d) => d === 0 ? "0" : fmtPts(d));
+  g.append("rect").attr("x", x).attr("y", y).attr("width", width).attr("height", 8).attr("rx", 2).attr("aria-label", `colour key, FG% vs league: ${format(lo)} to ${format(hi)}`).style("fill", `url(#${id})`);
+  for (const d of o.ticks ?? (lo < 0 && hi > 0 ? [lo, 0, hi] : [lo, hi])) {
+    g.append("text").attr("x", x + (d - lo) / (hi - lo) * width).attr("y", y + 8 + FONT_PX + 2).attr("text-anchor", d === lo ? "start" : d === hi ? "end" : "middle").style("font-size", `${FONT_PX}px`).style("fill", MUTED).text(format(d));
+  }
+  let used = 8 + FONT_PX + 6;
+  const caption = o.caption === void 0 ? ["FG% vs league (points)", "red: above league \xB7 blue: below"] : o.caption ?? [];
+  const lines = [...caption, ...o.notes ?? []].flatMap((n) => wrap(n, maxWidth));
+  lines.forEach((t, i) => {
+    g.append("text").attr("x", x).attr("y", y + used + FONT_PX + i * LINE_H).style("font-size", `${FONT_PX}px`).style("fill", MUTED).text(t);
+  });
+  used += lines.length * LINE_H;
+  const size = o.size;
+  if (size) {
+    const shape = size.shape ?? "hex";
+    const key = g.append("g").attr("transform", `translate(${x},${y + used + 8})`);
+    size.steps.forEach((n, i) => {
+      const cx = 12 + i * 34;
+      key.append("path").attr("transform", `translate(${cx},10)`).attr("d", cellPath(shape, size.px(n))).style("fill", MUTED);
+      key.append("text").attr("x", cx).attr("y", 36).attr("text-anchor", "middle").style("font-size", `${FONT_PX}px`).style("fill", MUTED).text(i === size.steps.length - 1 ? `${n}+` : String(n));
+    });
+    const note = wrap(size.note ?? `${shape} size: attempts`, maxWidth - 118);
+    note.forEach((t, i) => {
+      key.append("text").attr("x", 118).attr("y", 4 + FONT_PX + i * LINE_H).style("font-size", `${FONT_PX}px`).style("fill", MUTED).text(t);
+    });
+    used += 8 + Math.max(42, 8 + note.length * LINE_H);
+  }
+  return used;
+}
+function appendSignature(sel, points, o) {
+  const curve = (o.curve ?? "monotone-x") === "basis" ? curveBasis : curveMonotoneX;
+  const { maxShare, maxFt, stops, id: gradientId } = signatureGradient(points, o.fill ?? diffScale());
+  const half = o.halfWidth ?? ((p, m) => Math.max(p.share / m * 20, 0.75));
+  const g = sel.append("g").attr("class", "sdv-signature");
+  if (o.league ?? true) {
+    for (const strong of [false, true]) {
+      const l = line().defined((p) => p.leagueFgPct !== null && (!strong || p.fgPct !== null)).x((p) => o.x(p.distance)).y((p) => o.y(p.leagueFgPct ?? 0)).curve(curve);
+      g.append("path").attr("d", l([...points]) ?? "").style("fill", "none").style("stroke", MUTED).style("stroke-opacity", strong ? 1 : 0.4).style("stroke-dasharray", "3 3");
+    }
+  }
+  const [x1, x2] = [String(o.x(0)), String(o.x(maxFt))];
+  const id = gradientId(x1, x2);
+  const grad = g.append("defs").append("linearGradient").attr("id", id).attr("gradientUnits", "userSpaceOnUse").attr("x1", x1).attr("x2", x2).attr("y1", "0").attr("y2", "0");
+  for (const [offset, colour] of stops)
+    grad.append("stop").attr("offset", `${offset}%`).attr("stop-color", colour);
+  const ribbon = area().defined((p) => p.fgPct !== null).x((p) => o.x(p.distance)).y0((p) => o.y(p.fgPct ?? 0) + half(p, maxShare)).y1((p) => o.y(p.fgPct ?? 0) - half(p, maxShare)).curve(curve);
+  g.append("path").attr("d", ribbon([...points]) ?? "").attr("aria-label", SIGNATURE_NAME).style("fill", `url(#${id})`).style("stroke", "currentColor").style("stroke-opacity", 0.2).style("stroke-width", 0.5);
+  return g;
+}
+
+// src/d3/index.ts
+function draw(sel, xs, ys, ids, o, kind, place) {
+  const h = checkHeight(o.height ?? 0.1);
+  const alpha = checkAlpha(o.alpha ?? 1);
+  if (!(Number.isFinite(o.frameHeight) && o.frameHeight > 0)) {
+    throw new InputError(`frameHeight is the plot height in px, got ${String(o.frameHeight)}`);
+  }
+  const px = h * o.frameHeight;
+  const placed = placeSync(Array.from(xs), Array.from(ys), ids, place);
+  const g = sel.append("g").attr("class", `sdv-${kind}s`).attr("opacity", alpha);
+  for (const p of placed) {
+    const img = g.append("image").attr("href", p.url).attr("preserveAspectRatio", "xMidYMid meet");
+    const node = img.node();
+    if (node === null) continue;
+    stampImage(node, p, kind, px, o.frameHeight, o.x(p.x), o.y(p.y));
+    img.attr("data-sdv-x", String(p.x)).attr("data-sdv-y", String(p.y));
+    const raw = ids[p.index];
+    img.attr("aria-label", o.ariaLabel?.(raw, p.index) ?? `${placedName(p, place.league, raw)} ${kind}`);
+  }
+  return g;
+}
+var teamMark = (kind) => (sel, xs, ys, teams, o) => draw(sel, xs, ys, teams, o, kind, {
+  league: o.league,
+  kind,
+  variant: o.variant ?? "default",
+  ...o.idSystem === void 0 ? {} : { idSystem: o.idSystem },
+  ...o.season === void 0 ? {} : { season: o.season }
+});
+var appendLogos = teamMark("logo");
+var appendWordmarks = teamMark("wordmark");
+function appendHeadshots(sel, xs, ys, players, o) {
+  const g = draw(sel, xs, ys, players, o, "headshot", {
+    league: o.league,
+    kind: "headshot",
+    idSystem: o.idSystem ?? "espn"
+  });
+  clipFaces(g, o);
+  return g;
+}
+function teamColorScale(league, o = {}) {
+  const na = o.naValue ?? "grey";
+  const { domain, colors } = teamColorDomain(league, o);
+  return scaleOrdinal().domain(domain).range(colors.map((c) => c ?? na)).unknown(na);
+}
+function appendSurface(sel, league, o) {
+  const { x, y, ariaDescription, ...scene } = o;
+  return appendSurface$1(
+    sel,
+    surfaceScene(league, scene),
+    x,
+    y,
+    ariaDescription === void 0 ? {} : { ariaDescription }
+  );
+}
+
+export { appendHeadshots, appendLegend, appendLogos, appendSignature, appendSurface, appendWordmarks, teamColorScale };
+//# sourceMappingURL=d3.js.map
+//# sourceMappingURL=d3.js.map

package/dist/d3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/d3/faces.ts","../src/d3/shots.ts","../src/d3/index.ts"],"names":["sportyAppendSurface"],"mappings":"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","file":"d3.js","sourcesContent":["import type { BaseType, Selection } from \"d3\";\nimport { contentId } from \"../content-id.js\";\n\n/** Face options for `appendHeadshots` (blazing-the-nets `main` scatter \"faces\", `lib/charts/scatterChart.ts:139-191`). */\nexport interface FaceOptions {\n  /**\n   * `\"circle\"`: the headshot inside a circle whose diameter is `height` × `frameHeight`. The image is drawn 2.3 R tall\n   * so the head fills the circle, so `drawnMarks` reports 1.15 × `height` for a face.\n   */\n  clip?: \"circle\";\n  /** Ring colour per player id (e.g. the team colour; `:183-188`, 1.5 px). Default none. */\n  ring?: string | ((id: string) => string);\n  /** A disc behind the face at 0.35 opacity, still there if the image fails (`:169-172`). Default none. */\n  placeholder?: string | ((id: string) => string);\n}\n\nconst NS = \"http://www.w3.org/2000/svg\";\nconst pick = (c: FaceOptions[\"ring\"], id: string): string | undefined =>\n  typeof c === \"function\" ? c(id) : c;\n\n/** Turn `appendHeadshots`' images into circular faces in place. */\nexport function clipFaces<D>(g: Selection<SVGGElement, D, BaseType, unknown>, o: FaceOptions): void {\n  if (o.clip !== \"circle\") return;\n  for (const img of g.selectAll<SVGImageElement, unknown>(\"image\").nodes()) {\n    const doc = img.ownerDocument;\n    const id = img.getAttribute(\"data-sdv-id\") ?? \"\";\n    const w0 = Number(img.getAttribute(\"width\"));\n    const h0 = Number(img.getAttribute(\"height\"));\n    const cx = Number(img.getAttribute(\"x\")) + w0 / 2;\n    const cy = Number(img.getAttribute(\"y\")) + h0 / 2;\n    const r = h0 / 2;\n    const h = 2.3 * r; // the head fills the circle: image 2.3 R tall, top 1.05 R above centre (:177-181)\n    const w = h0 > 0 ? (h * w0) / h0 : 0;\n    img.setAttribute(\"width\", String(w));\n    img.setAttribute(\"height\", String(h));\n    img.setAttribute(\"x\", String(cx - w / 2));\n    img.setAttribute(\"y\", String(cy - 1.05 * r));\n    const clipId = contentId(\"sdv-face\", `${id}|${cx}|${cy}|${r}`);\n    const clip = doc.createElementNS(NS, \"clipPath\");\n    clip.setAttribute(\"id\", clipId);\n    const disc = doc.createElementNS(NS, \"circle\");\n    disc.setAttribute(\"cx\", String(cx));\n    disc.setAttribute(\"cy\", String(cy));\n    disc.setAttribute(\"r\", String(r));\n    clip.appendChild(disc);\n    img.setAttribute(\"clip-path\", `url(#${clipId})`);\n    img.before(clip);\n    const fill = pick(o.placeholder, id);\n    if (fill !== undefined) {\n      const ph = disc.cloneNode() as Element;\n      ph.setAttribute(\"fill\", fill);\n      ph.setAttribute(\"fill-opacity\", \"0.35\");\n      img.before(ph);\n    }\n    const stroke = pick(o.ring, id);\n    if (stroke !== undefined) {\n      const ring = disc.cloneNode() as Element;\n      ring.setAttribute(\"fill\", \"none\");\n      ring.setAttribute(\"stroke\", stroke);\n      ring.setAttribute(\"stroke-width\", \"1.5\");\n      img.after(ring);\n    }\n  }\n}\n","// d3 twins of the shot-chart marks: blazing-the-nets `main` lib/charts/theme.ts (legend), hexShotChart.ts (size key)\n// and shootingSignature.ts (@31427b8), which are d3 themselves. Never imports ../plot/*.\nimport { type BaseType, type Selection, area, curveBasis, curveMonotoneX, line } from \"d3\";\nimport { type BinShape, cellPath } from \"../bins/index.js\";\nimport { contentId } from \"../content-id.js\";\nimport { InputError } from \"../errors.js\";\nimport { type DiffScale, diffScale } from \"../shots/diff.js\";\nimport { SIGNATURE_NAME, type SignaturePoint, signatureGradient } from \"../shots/signature.js\";\n\n/** Any `<g>` selection, whatever its datum (d3's `Selection` is invariant in it; see `Sel` in ./index.ts). */\ntype G<D> = Selection<SVGGElement, D, BaseType, unknown>;\nconst FONT_PX = 11; // blazing-the-nets main lib/charts/theme.ts:24\nconst CHAR_PX = 6.2; // theme.ts:26\nconst LINE_H = 15; // theme.ts:92\nconst MUTED = \"var(--sdv-muted, currentColor)\"; // main's TOKENS.muted where the page sets it, else the page's ink\n\n/** Signed points from a fraction (blazing-the-nets `main` `lib/format.ts:8`): 0.042 → \"+4.2\", -0.042 → \"−4.2\". */\nconst fmtPts = (v: number): string => `${v >= 0 ? \"+\" : \"−\"}${Math.abs(v * 100).toFixed(1)}`;\n\n/** Greedy word wrap at an estimated 6.2 px per character (theme.ts:77-90): no measuring, so SSR-safe. */\nfunction wrap(text: string, maxWidth: number): string[] {\n  const perLine = Math.max(8, Math.floor(maxWidth / CHAR_PX));\n  const lines: string[] = [];\n  let cur = \"\";\n  for (const word of text.split(\" \")) {\n    if (cur && cur.length + 1 + word.length > perLine) {\n      lines.push(cur);\n      cur = word;\n    } else cur = cur ? `${cur} ${word}` : word;\n  }\n  if (cur) lines.push(cur);\n  return lines;\n}\n\n/** Options for `appendLegend`. */\nexport interface AppendLegendOptions {\n  /** Top-left corner of the legend in px; default (0, 0). */\n  x?: number;\n  /** See `x`. */\n  y?: number;\n  /** Space available, which the text wraps to; the bar is at most 240 px (theme.ts:122). */\n  width?: number;\n  /**\n   * Diffs the bar spans; default the scale's end stops. `master`'s legend spanned [-0.30, 0.30]\n   * (`ShootingSignature/Legend.js:36-38`): `{ domain: [-0.3, 0.3], ticks: [-0.3, -0.15, 0, 0.15, 0.3] }`.\n   */\n  domain?: readonly [lo: number, hi: number];\n  /** Tick diffs; default the domain's ends, and 0 when it lies inside them. */\n  ticks?: readonly number[];\n  /** Tick text; default signed points, \"0\" at 0 (theme.ts:140). */\n  format?: (d: number) => string;\n  /** Caption and key in words (theme.ts:35, :120); `null` for none. */\n  caption?: readonly string[] | null;\n  /** More lines under the caption, wrapped to `width` (e.g. a shrinkage note). */\n  notes?: readonly string[];\n  /** A cell size key under the colour key: pixel size per attempt count and the counts (`sizeCells(...).steps`). */\n  size?: {\n    readonly px: (attempts: number) => number;\n    readonly steps: readonly number[];\n    /** The key's cell shape; default `\"hex\"`. */\n    readonly shape?: BinShape;\n    /** Default `\"hex size: attempts\"` or `\"square size: attempts\"`. */\n    readonly note?: string;\n  };\n}\n\n/**\n * A diff-colour legend for d3 charts: gradient bar, ticks, caption, notes and an optional cell size key\n * (blazing-the-nets `main` `lib/charts/theme.ts:109-143`, `lib/charts/hexShotChart.ts:196-213`). It replaces\n * `master`'s static PNG ramp (`ShootingSignature/Legend.js:45-50`, `rgy5.png`) with a gradient generated from the\n * scale, whose id is a hash of its stops. Nothing is measured (text wraps at an estimated 6.2 px per character), so\n * it renders the same in jsdom and SSR. Returns the height used. Plot users: `Plot.legend({ color: scale.plot })`.\n *\n * @example\n * ```ts\n * import { create } from \"d3\";\n * import { appendLegend } from \"@sportsdataverse/sdvplot/d3\";\n * import { diffScale } from \"@sportsdataverse/sdvplot/shots\";\n *\n * const svg = create(\"svg\").attr(\"viewBox\", \"0 0 300 80\");\n * appendLegend(svg.append(\"g\"), diffScale(), { width: 280 });\n * svg.node();\n * ```\n */\nexport function appendLegend<D>(\n  g: G<D>,\n  scale: DiffScale = diffScale(),\n  o: AppendLegendOptions = {},\n): number {\n  const x = o.x ?? 0;\n  const y = o.y ?? 0;\n  const maxWidth = o.width ?? 240;\n  const width = Math.min(maxWidth, 240);\n  const [lo, hi] = o.domain ?? [scale.stops[0] ?? 0, scale.stops.at(-1) ?? 0];\n  if (!(Number.isFinite(lo) && Number.isFinite(hi) && hi > lo))\n    throw new InputError(`appendLegend domain must be finite and run low to high, got [${lo}, ${hi}]`);\n  // The domain's ends plus every scale stop inside it: exact for a piecewise-linear scale (master), 5 samples of RdBu.\n  const at = [lo, ...scale.stops.filter((d) => d > lo && d < hi), hi];\n  const stops = at.map((d) => [((d - lo) / (hi - lo)) * 100, scale(d)] as const);\n  const id = contentId(\"sdv-legend\", stops.map((s) => s.join(\" \")).join(\";\"));\n  const grad = g.append(\"defs\").append(\"linearGradient\").attr(\"id\", id);\n  for (const [offset, colour] of stops)\n    grad.append(\"stop\").attr(\"offset\", `${offset}%`).attr(\"stop-color\", colour);\n  const format = o.format ?? ((d: number) => (d === 0 ? \"0\" : fmtPts(d)));\n  g.append(\"rect\")\n    .attr(\"x\", x)\n    .attr(\"y\", y)\n    .attr(\"width\", width)\n    .attr(\"height\", 8)\n    .attr(\"rx\", 2)\n    .attr(\"aria-label\", `colour key, FG% vs league: ${format(lo)} to ${format(hi)}`)\n    .style(\"fill\", `url(#${id})`);\n  for (const d of o.ticks ?? (lo < 0 && hi > 0 ? [lo, 0, hi] : [lo, hi])) {\n    g.append(\"text\")\n      .attr(\"x\", x + ((d - lo) / (hi - lo)) * width)\n      .attr(\"y\", y + 8 + FONT_PX + 2)\n      .attr(\"text-anchor\", d === lo ? \"start\" : d === hi ? \"end\" : \"middle\")\n      .style(\"font-size\", `${FONT_PX}px`)\n      .style(\"fill\", MUTED)\n      .text(format(d));\n  }\n  let used = 8 + FONT_PX + 6;\n  const caption =\n    o.caption === undefined\n      ? [\"FG% vs league (points)\", \"red: above league · blue: below\"]\n      : (o.caption ?? []);\n  const lines = [...caption, ...(o.notes ?? [])].flatMap((n) => wrap(n, maxWidth));\n  lines.forEach((t, i) => {\n    g.append(\"text\")\n      .attr(\"x\", x)\n      .attr(\"y\", y + used + FONT_PX + i * LINE_H)\n      .style(\"font-size\", `${FONT_PX}px`)\n      .style(\"fill\", MUTED)\n      .text(t);\n  });\n  used += lines.length * LINE_H;\n  const size = o.size;\n  if (size) {\n    const shape = size.shape ?? \"hex\";\n    const key = g.append(\"g\").attr(\"transform\", `translate(${x},${y + used + 8})`);\n    size.steps.forEach((n, i) => {\n      const cx = 12 + i * 34;\n      key\n        .append(\"path\")\n        .attr(\"transform\", `translate(${cx},10)`)\n        .attr(\"d\", cellPath(shape, size.px(n)))\n        .style(\"fill\", MUTED);\n      key\n        .append(\"text\")\n        .attr(\"x\", cx)\n        .attr(\"y\", 36)\n        .attr(\"text-anchor\", \"middle\")\n        .style(\"font-size\", `${FONT_PX}px`)\n        .style(\"fill\", MUTED)\n        .text(i === size.steps.length - 1 ? `${n}+` : String(n));\n    });\n    // main's drawNotes(key, 118, 4, width - 24 - 118, …) (hexShotChart.ts:212): wrapped, 8 characters a line at the least\n    const note = wrap(size.note ?? `${shape} size: attempts`, maxWidth - 118);\n    note.forEach((t, i) => {\n      key\n        .append(\"text\")\n        .attr(\"x\", 118)\n        .attr(\"y\", 4 + FONT_PX + i * LINE_H)\n        .style(\"font-size\", `${FONT_PX}px`)\n        .style(\"fill\", MUTED)\n        .text(t);\n    });\n    used += 8 + Math.max(42, 8 + note.length * LINE_H);\n  }\n  return used;\n}\n\n/** Options for `appendSignature`. */\nexport interface AppendSignatureOptions {\n  /** The caller's scale from distance (ft) to px. */\n  x: (distance: number) => number;\n  /** The caller's scale from FG% (0-1) to px; a clamped scale clamps the ribbon's centre. */\n  y: (fgPct: number) => number;\n  /** Colour of `colourDiff`; default `diffScale()`. */\n  fill?: DiffScale;\n  /** `\"monotone-x\"` (default, `main`) or `\"basis\"` (`master` `ShootingSignature/index.js:96`). */\n  curve?: \"monotone-x\" | \"basis\";\n  /** Ribbon half-width in PIXELS; default `main`'s `max(share / maxShare * 20, 0.75)` (`shootingSignature.ts:131-132`). */\n  halfWidth?: (p: SignaturePoint, maxShare: number) => number;\n  /** The dashed league line, faint everywhere and full strength under the ribbon (`:165-181`); default true. */\n  league?: boolean;\n}\n\n/**\n * The d3 twin of `sdvplot/plot`'s `shootingSignature`: the dashed league line and the ribbon along FG% by distance,\n * as wide as the shot share and coloured along x by the shrunk FG% vs league (blazing-the-nets `main`\n * `lib/charts/shootingSignature.ts:165-211`). The same points give the Plot mark's ribbon and league paths, gradient\n * stops and gradient id when the scales match (with a 190 px [0, 1] y axis for the default half-width). A null\n * `fgPct` is a gap. The gradient id hashes its stops and its pixel x range, so two signatures on a page, or one at\n * two widths, never share one. y goes through the caller's `y` as it is: the ribbon's edges are\n * `y(fgPct) ± halfWidth`, and a clamped scale clamps the centre (as `main` does). Returns the `<g>` it appended.\n *\n * @example\n * ```ts\n * import { create, scaleLinear } from \"d3\";\n * import { appendSignature } from \"@sportsdataverse/sdvplot/d3\";\n * import { fgPctByDistance, signaturePoints, vsLeague } from \"@sportsdataverse/sdvplot/shots\";\n *\n * // Brooklyn shots from the sportsdataverse-data nba_stats_shots release, 2025-26\n * const shots = [\n *   { x_legacy: -1, y_legacy: 7, shot_distance: 1, shot_value: 2, shot_result: \"Made\" },\n *   { x_legacy: 0, y_legacy: 0, shot_distance: 0, shot_value: 2, shot_result: \"Missed\" },\n *   { x_legacy: -44, y_legacy: 252, shot_distance: 26, shot_value: 3, shot_result: \"Made\" },\n * ];\n * // the makes against all three attempts, which stand in for the league (the gallery's uses the 2025-26 league)\n * const made = fgPctByDistance(shots.filter((s) => s.shot_result === \"Made\"));\n * const points = signaturePoints(vsLeague(made, fgPctByDistance(shots)), { minAttempts: 1 });\n * const svg = create(\"svg\").attr(\"viewBox\", \"0 0 400 200\");\n * appendSignature(svg.append(\"g\"), points, { x: scaleLinear([0, 35], [0, 400]), y: scaleLinear([0, 1], [200, 0]) });\n * svg.node();\n * ```\n */\nexport function appendSignature<D>(\n  sel: G<D>,\n  points: readonly SignaturePoint[],\n  o: AppendSignatureOptions,\n): G<D> {\n  const curve = (o.curve ?? \"monotone-x\") === \"basis\" ? curveBasis : curveMonotoneX;\n  const { maxShare, maxFt, stops, id: gradientId } = signatureGradient(points, o.fill ?? diffScale());\n  const half = o.halfWidth ?? ((p: SignaturePoint, m: number) => Math.max((p.share / m) * 20, 0.75));\n  const g = sel.append(\"g\").attr(\"class\", \"sdv-signature\");\n  if (o.league ?? true) {\n    for (const strong of [false, true]) {\n      const l = line<SignaturePoint>()\n        .defined((p) => p.leagueFgPct !== null && (!strong || p.fgPct !== null))\n        .x((p) => o.x(p.distance))\n        .y((p) => o.y(p.leagueFgPct ?? 0))\n        .curve(curve);\n      g.append(\"path\")\n        .attr(\"d\", l([...points]) ?? \"\")\n        .style(\"fill\", \"none\")\n        .style(\"stroke\", MUTED)\n        .style(\"stroke-opacity\", strong ? 1 : 0.4)\n        .style(\"stroke-dasharray\", \"3 3\");\n    }\n  }\n  const [x1, x2] = [String(o.x(0)), String(o.x(maxFt))];\n  const id = gradientId(x1, x2);\n  const grad = g\n    .append(\"defs\")\n    .append(\"linearGradient\")\n    .attr(\"id\", id)\n    .attr(\"gradientUnits\", \"userSpaceOnUse\")\n    .attr(\"x1\", x1)\n    .attr(\"x2\", x2)\n    .attr(\"y1\", \"0\")\n    .attr(\"y2\", \"0\");\n  for (const [offset, colour] of stops)\n    grad.append(\"stop\").attr(\"offset\", `${offset}%`).attr(\"stop-color\", colour);\n  const ribbon = area<SignaturePoint>()\n    .defined((p) => p.fgPct !== null)\n    .x((p) => o.x(p.distance))\n    .y0((p) => o.y(p.fgPct ?? 0) + half(p, maxShare))\n    .y1((p) => o.y(p.fgPct ?? 0) - half(p, maxShare))\n    .curve(curve);\n  g.append(\"path\")\n    .attr(\"d\", ribbon([...points]) ?? \"\")\n    .attr(\"aria-label\", SIGNATURE_NAME)\n    .style(\"fill\", `url(#${id})`)\n    .style(\"stroke\", \"currentColor\")\n    .style(\"stroke-opacity\", 0.2)\n    .style(\"stroke-width\", 0.5);\n  return g;\n}\n","import { appendSurface as sportyAppendSurface } from \"@sportsdataverse/sporty/d3\";\nimport { type BaseType, type ScaleOrdinal, type Selection, scaleOrdinal } from \"d3\";\nimport { InputError } from \"../errors.js\";\nimport type { EspnHeadshotLeague } from \"../headshots.js\";\nimport { type Kind, checkAlpha, checkHeight, placeSync, placedName } from \"../placement.js\";\nimport type { Value } from \"../resolve.js\";\nimport { stampImage } from \"../stamp.js\";\nimport { type SurfaceSceneOptions, surfaceScene } from \"../surfaces.js\";\nimport { teamColorDomain } from \"../team-color-domain.js\";\nimport type { HeadshotIdSystem, IdSystem, League, SeasonInput, Variant, Which } from \"../types.js\";\nimport { type FaceOptions, clipFaces } from \"./faces.js\";\n\n/**\n * A selection of `G` with any datum `D` and any parent. d3's `Selection` is invariant in its datum, so a helper typed\n * with `unknown` would reject `create(\"svg\").append(\"g\")` (datum `undefined`) and every bound datum.\n */\ntype Sel<G extends Element, D> = Selection<G, D, BaseType, unknown>;\n/** Where d3 draws: the caller's scales, plus the pixel height the `height` fraction refers to (d3 has no figure). */\ninterface Frame {\n  x: (v: Value) => number;\n  y: (v: Value) => number;\n  frameHeight: number;\n  height?: number;\n  alpha?: number;\n  /**\n   * Each image's accessible name from its input value and index; default the team (\"KC logo\", whatever id system the\n   * values use) or the player id (\"3139477 headshot\").\n   */\n  ariaLabel?: (value: Value, i: number) => string;\n}\nexport interface D3MarkOptions extends Frame {\n  league: League;\n  season?: SeasonInput | readonly SeasonInput[];\n  variant?: Variant;\n  idSystem?: IdSystem;\n}\nexport interface D3HeadshotOptions extends Frame, FaceOptions {\n  league: EspnHeadshotLeague;\n  /** \"espn\" (default) or \"gsis\". \"gsis\" needs `loadGsis()` to have run first, else this throws InputError. */\n  idSystem?: HeadshotIdSystem;\n}\n\nfunction draw<G extends SVGElement, D>(\n  sel: Sel<G, D>,\n  xs: ArrayLike<Value>,\n  ys: ArrayLike<Value>,\n  ids: readonly Value[],\n  o: Frame,\n  kind: Kind,\n  place: Parameters<typeof placeSync>[3],\n): Sel<SVGGElement, D> {\n  const h = checkHeight(o.height ?? 0.1);\n  const alpha = checkAlpha(o.alpha ?? 1);\n  if (!(Number.isFinite(o.frameHeight) && o.frameHeight > 0)) {\n    throw new InputError(`frameHeight is the plot height in px, got ${String(o.frameHeight)}`);\n  }\n  const px = h * o.frameHeight;\n  const placed = placeSync(Array.from(xs), Array.from(ys), ids, place);\n  const g = sel.append(\"g\").attr(\"class\", `sdv-${kind}s`).attr(\"opacity\", alpha);\n  for (const p of placed) {\n    const img = g.append(\"image\").attr(\"href\", p.url).attr(\"preserveAspectRatio\", \"xMidYMid meet\");\n    const node = img.node();\n    if (node === null) continue;\n    stampImage(node, p, kind, px, o.frameHeight, o.x(p.x), o.y(p.y));\n    img.attr(\"data-sdv-x\", String(p.x)).attr(\"data-sdv-y\", String(p.y));\n    const raw = ids[p.index] as Value;\n    img.attr(\"aria-label\", o.ariaLabel?.(raw, p.index) ?? `${placedName(p, place.league, raw)} ${kind}`);\n  }\n  return g;\n}\nexport type AppendTeamMarks = <G extends SVGElement, D>(\n  sel: Sel<G, D>,\n  xs: ArrayLike<Value>,\n  ys: ArrayLike<Value>,\n  teams: readonly Value[],\n  o: D3MarkOptions,\n) => Sel<SVGGElement, D>;\nconst teamMark =\n  (kind: \"logo\" | \"wordmark\"): AppendTeamMarks =>\n  (sel, xs, ys, teams, o) =>\n    draw(sel, xs, ys, teams, o, kind, {\n      league: o.league,\n      kind,\n      variant: o.variant ?? \"default\",\n      ...(o.idSystem === undefined ? {} : { idSystem: o.idSystem }),\n      ...(o.season === undefined ? {} : { season: o.season }),\n    });\n/**\n * Append `<g class=\"sdv-logos\">` of team logos at (x, y) through the caller's scale functions. Needs\n * `loadLeague(league)` first.\n *\n * @example\n * ```ts\n * import { loadLeague } from \"@sportsdataverse/sdvplot\";\n * import { appendLogos } from \"@sportsdataverse/sdvplot/d3\";\n * import * as d3 from \"d3\";\n *\n * await loadLeague(\"nfl\");\n * const x = d3.scaleLinear([250, 550], [0, 480]);\n * const y = d3.scaleLinear([280, 420], [240, 0]);\n * const svg = d3.select(document.createElement(\"div\")).append(\"svg\").attr(\"viewBox\", [0, 0, 480, 240]);\n * appendLogos(svg, [385, 525, 425], [326, 368, 311], [\"KC\", \"BUF\", \"DEN\"], {\n *   league: \"nfl\",\n *   x: (v) => x(Number(v)),\n *   y: (v) => y(Number(v)),\n *   frameHeight: 240,\n *   height: 0.2,\n * });\n * svg.node();\n * ```\n */\nexport const appendLogos: AppendTeamMarks = teamMark(\"logo\");\n/** As `appendLogos`, with wordmarks. */\nexport const appendWordmarks: AppendTeamMarks = teamMark(\"wordmark\");\n/**\n * Append `<g class=\"sdv-headshots\">` of ESPN player headshots; `idSystem: \"gsis\"` needs `loadGsis()` first.\n * `clip: \"circle\"` makes circular faces (`height` is then the circle's diameter), with an optional `ring` and `placeholder`.\n *\n * @example\n * ```ts\n * import { appendHeadshots } from \"@sportsdataverse/sdvplot/d3\";\n * import * as d3 from \"d3\";\n *\n * const x = d3.scaleLinear([0, 10], [0, 480]);\n * const y = d3.scaleLinear([0, 10], [240, 0]);\n * const svg = d3.select(document.createElement(\"div\")).append(\"svg\").attr(\"viewBox\", [0, 0, 480, 240]);\n * const team: Record<string, string> = { \"3139477\": \"#e31837\", \"4374302\": \"#0076b6\", \"4429160\": \"#008e97\" };\n * appendHeadshots(svg, [2, 5, 8], [4, 6, 3], [\"3139477\", \"4374302\", \"4429160\"], {\n *   league: \"nfl\",\n *   x: (v) => x(Number(v)),\n *   y: (v) => y(Number(v)),\n *   frameHeight: 240,\n *   height: 0.25,\n *   clip: \"circle\",\n *   ring: (id) => team[id] ?? \"grey\",\n *   placeholder: (id) => team[id] ?? \"grey\",\n * });\n * svg.node();\n * ```\n */\nexport function appendHeadshots<G extends SVGElement, D>(\n  sel: Sel<G, D>,\n  xs: ArrayLike<Value>,\n  ys: ArrayLike<Value>,\n  players: readonly Value[],\n  o: D3HeadshotOptions,\n): Sel<SVGGElement, D> {\n  const g = draw(sel, xs, ys, players, o, \"headshot\", {\n    league: o.league,\n    kind: \"headshot\",\n    idSystem: o.idSystem ?? \"espn\",\n  });\n  clipFaces(g, o);\n  return g;\n}\n\n/**\n * A d3 ordinal scale from team (id or abbr) to team colour; anything unresolved maps to `naValue` (default \"grey\").\n *\n * @example\n * ```ts\n * import { loadLeague } from \"@sportsdataverse/sdvplot\";\n * import { teamColorScale } from \"@sportsdataverse/sdvplot/d3\";\n *\n * await loadLeague(\"nba\");\n * const color = teamColorScale(\"nba\", { values: [\"LAL\", \"BOS\"] });\n * [\"LAL\", \"BOS\", \"not a team\"].map(color);\n * ```\n */\nexport function teamColorScale(\n  league: League,\n  o: {\n    which?: Which;\n    season?: SeasonInput;\n    idSystem?: IdSystem;\n    naValue?: string;\n    values?: readonly Value[];\n  } = {},\n): ScaleOrdinal<string, string, string> {\n  const na = o.naValue ?? \"grey\";\n  const { domain, colors } = teamColorDomain(league, o);\n  return scaleOrdinal<string, string>()\n    .domain(domain)\n    .range(colors.map((c) => c ?? na))\n    .unknown(na);\n}\n\nexport interface D3SurfaceOptions extends SurfaceSceneOptions {\n  x: (v: number) => number;\n  y: (v: number) => number;\n  /** Describes the surface for assistive technology; default sporty's (\"nba basketball surface\" and so on). */\n  ariaDescription?: string;\n}\n/** Paint a surface key's surface (in `team`'s colours) into `sel` through the caller's x/y scales. Throws InputError for a key with no surface (see `SURFACES`). */\nexport function appendSurface<G extends SVGGElement | SVGSVGElement, D>(\n  sel: Sel<G, D>,\n  league: League | (string & {}),\n  o: D3SurfaceOptions,\n): Sel<SVGGElement, D> {\n  const { x, y, ariaDescription, ...scene } = o;\n  return sportyAppendSurface(\n    sel,\n    surfaceScene(league, scene),\n    x,\n    y,\n    ariaDescription === undefined ? {} : { ariaDescription },\n  );\n}\nexport { appendLegend, appendSignature } from \"./shots.js\";\nexport type { AppendLegendOptions, AppendSignatureOptions } from \"./shots.js\";\nexport type { FaceOptions } from \"./faces.js\";\n"]}