@sportsdataverse/sdvplot 0.1.0 → 0.2.0

package/dist/recharts.d.ts

@@ -0,0 +1,162 @@
+import { ReactElement } from 'react';
+import { E as EspnHeadshotLeague } from './headshots-B2J_LOO8.js';
+import { W as Which, S as SeasonInput, I as IdSystem, H as HeadshotIdSystem, L as League, V as Variant, M as MarkType } from './types-C7n6gJF3.js';
+export { R as Row, e as embedSources } from './_web-D7Aa5Rd8.js';
+import './resolve-CQW-jzvr.js';
+
+/**
+ * The Recharts adapter: team logos and player headshots as Recharts render props (a series' `dot` or `shape`, an
+ * axis' `tick`), and team colours for the series' `stroke` / `fill`. Pure: recharts is never imported (the prop types
+ * here are structural, read from recharts 3.8 and later); React's `createElement` builds the SVG `<image>` each prop
+ * returns. Call after `loadLeague(league)` / `preloadAll()`. The court / field / rink backdrop is a component,
+ * `<SurfaceBackdrop>` in `sdvplot/react`.
+ */
+
+/** What Recharts hands a series' `dot` (Line, Area, Radar) or `shape` (Scatter) render prop: the subset read here. */
+interface RechartsDotProps {
+    /** The point's centre in px. */
+    cx?: number | string | undefined;
+    cy?: number | string | undefined;
+    /** The point's index in its series. */
+    index?: number | undefined;
+    /** The series' points (a Line's or Area's `dot`), so `last` can find the final one. */
+    points?: readonly unknown[] | undefined;
+    /** The data row the point was drawn from. */
+    payload?: any;
+}
+/** What Recharts hands an axis' `tick` render prop: the subset read here. */
+interface RechartsTickProps {
+    /** The tick label's anchor in px. */
+    x?: number | string | undefined;
+    y?: number | string | undefined;
+    /** The tick: `value` is the category the axis shows (a team). */
+    payload?: {
+        value?: any;
+    } | undefined;
+    /** Which side of the plot the axis is on. Default "bottom". */
+    orientation?: string | undefined;
+    /** The axis' tick text colour, kept for a category drawn as text. */
+    fill?: string | undefined;
+}
+/** A render prop for a series' `dot` or `shape`: an `<image>`, or nothing where no image can be drawn. */
+type DotRenderer = (props: RechartsDotProps) => ReactElement | null;
+/** A render prop for an axis' `tick`: an `<image>`, or the category's own text where no image can be drawn. */
+type TickRenderer = (props: RechartsTickProps) => ReactElement;
+interface Shared {
+    /** Image height in px, 1 or more (Recharts hands a render prop no plot height to take a fraction of). Default 24. */
+    size?: number;
+    /** Opacity in [0, 1]. Default 1. */
+    alpha?: number;
+    /**
+     * Draw only at the series' last point: an end-dot on a trend line. Default false. It needs the series' `points`,
+     * which Recharts hands a Line's or Area's `dot` but not a Scatter's `shape`: there every point is drawn, with one
+     * warning.
+     */
+    last?: boolean;
+    /** url → data URI map from `embedSources`, to inline the images. */
+    embed?: ReadonlyMap<string, string>;
+}
+/** `logoDot` options. */
+interface RechartsMarkOptions extends Shared {
+    /** Name of the data row column holding the team (abbreviation, name or id; see `idSystem`). */
+    team: string;
+    /** The league the teams belong to, e.g. "nba". */
+    league: League;
+    /** A season (number or string) for every row, or the name of a row column holding each row's season. */
+    season?: SeasonInput;
+    /** Logo variant, e.g. "dark". Default "default". */
+    variant?: Variant;
+    /** How the `team` values are read. Default "auto". */
+    idSystem?: IdSystem;
+}
+/** `headshotDot` options. */
+interface RechartsHeadshotOptions extends Shared {
+    /** Name of the data row column holding the player id. */
+    player: string;
+    /** The league the players belong to, e.g. "nfl". */
+    league: EspnHeadshotLeague;
+    /** ESPN athlete ids, or nflverse gsis ids (needs `loadGsis()` first). Default "espn". */
+    idSystem?: HeadshotIdSystem;
+}
+/** `logoTick` options: the axis' categories are the teams. */
+interface RechartsTickOptions {
+    /** The league the teams belong to, e.g. "nba". */
+    league: League;
+    /** The season the axis' teams are resolved for. */
+    season?: SeasonInput;
+    /** Image height in px, 1 or more. Default 24. */
+    size?: number;
+    /** Logo variant, e.g. "dark". Default "default". */
+    variant?: Variant;
+    /** "logo" (default) or "wordmark". */
+    markType?: MarkType;
+    /** How the axis categories are read. Default "auto". */
+    idSystem?: IdSystem;
+    /** url → data URI map from `embedSources`, to inline the images. */
+    embed?: ReadonlyMap<string, string>;
+}
+/**
+ * Team logos as a series' points: the `dot` of a `<Line>` / `<Area>`, or the `shape` of a `<Scatter>`. Each point
+ * draws the logo of its data row's `team` column, `size` px tall and centred on the point; `last: true` draws only
+ * the series' final point (an end-dot). A team with no logo draws nothing and warns once, as `sdvplot/echarts` does.
+ *
+ * @example
+ * ```tsx
+ * import { loadLeague } from "@sportsdataverse/sdvplot";
+ * import { logoDot } from "@sportsdataverse/sdvplot/recharts";
+ * import { Scatter, ScatterChart, XAxis, YAxis } from "recharts";
+ *
+ * await loadLeague("nfl");
+ * const rows = [
+ *   { team: "KC", pf: 385, pa: 326 },
+ *   { team: "LAC", pf: 402, pa: 301 },
+ * ];
+ * <ScatterChart width={400} height={300}>
+ *   <XAxis dataKey="pf" type="number" domain={[350, 450]} />
+ *   <YAxis dataKey="pa" type="number" domain={[280, 350]} />
+ *   <Scatter data={rows} shape={logoDot({ team: "team", league: "nfl", size: 32 })} />
+ * </ScatterChart>;
+ * ```
+ */
+declare function logoDot(o: RechartsMarkOptions): DotRenderer;
+/** ESPN player headshots as a series' points (`dot` or `shape`), from the data row's `player` column; an id with no
+ *  headshot draws nothing and warns once. `idSystem: "gsis"` needs `loadGsis()` first. */
+declare function headshotDot(o: RechartsHeadshotOptions): DotRenderer;
+/**
+ * Team logos as an axis' tick labels: the `tick` of a category `<XAxis>` / `<YAxis>` whose values are teams. The
+ * logo sits where the label would (under a bottom axis, left of a left one). A category that resolves to no logo keeps
+ * its text label, as `sdvplot/echarts`' `withAxisLogos` does.
+ */
+declare function logoTick(o: RechartsTickOptions): TickRenderer;
+/** `teamColorPalette` options. */
+interface RechartsColorOptions {
+    which?: Which;
+    season?: SeasonInput;
+    idSystem?: IdSystem;
+    /** The colour of an unresolved team. Default "#808080". */
+    fallback?: string;
+    /**
+     * The chart's background. Given, a team colour under 3:1 contrast against it is swapped for the team's other
+     * colour, else moved towards white (on a dark background) or black (a light one) until it reads: dark mode. A
+     * colour that would then sit too close to an earlier team's (CIE76 ΔE under 20) takes the team's other colour, or
+     * the nearest colour to its own (lightness, hue or chroma stepped) that is distinct and still reads; failing that it
+     * is kept, with one warning.
+     */
+    background?: string;
+}
+/**
+ * One colour per team, in order, for each series' `stroke` / `fill`. With `background`, every colour keeps 3:1
+ * contrast against it (dark mode) and stays distinct from the others.
+ *
+ * @example
+ * ```tsx
+ * import { loadLeague } from "@sportsdataverse/sdvplot";
+ * import { teamColorPalette } from "@sportsdataverse/sdvplot/recharts";
+ *
+ * await loadLeague("nba");
+ * teamColorPalette("nba", ["Clippers", "Suns", "Lakers"], { background: "#181a1b" });
+ * ```
+ */
+declare function teamColorPalette(league: League, teams: readonly unknown[], o?: RechartsColorOptions): string[];
+
+export { type DotRenderer, type RechartsColorOptions, type RechartsDotProps, type RechartsHeadshotOptions, type RechartsMarkOptions, type RechartsTickOptions, type RechartsTickProps, type TickRenderer, headshotDot, logoDot, logoTick, teamColorPalette };

package/dist/recharts.js

@@ -0,0 +1,8 @@
+export { headshotDot, logoDot, logoTick, teamColorPalette } from './chunk-M3XD2OSN.js';
+export { embedSources } from './chunk-UL5M6KDE.js';
+import './chunk-7ULOCCFL.js';
+import './chunk-ZAEQXFJM.js';
+import './chunk-J6R2LEJ7.js';
+import './chunk-E7G7VSLV.js';
+//# sourceMappingURL=recharts.js.map
+//# sourceMappingURL=recharts.js.map

package/dist/recharts.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"recharts.js"}

package/dist/shadcn.d.ts

@@ -0,0 +1,83 @@
+import { ComponentType } from 'react';
+import { W as Which, S as SeasonInput, I as IdSystem, L as League } from './types-C7n6gJF3.js';
+
+/**
+ * The shadcn/ui charts adapter. shadcn's charts are Recharts charts inside its copy-paste `chart.tsx`
+ * (`<ChartContainer config>`, `<ChartLegendContent>`, `<ChartTooltipContent>`), configured by a `ChartConfig`:
+ * `teamChartConfig` builds that config from teams, with CSS-safe keys, team colours for its light and dark themes,
+ * team names as labels and team logos as the legend's and tooltip's icons. Draw the series with `sdvplot/recharts`
+ * (`logoTick`, `logoDot`) as for any Recharts chart. Pure: shadcn is not a package (you copy `chart.tsx` into your
+ * app) and recharts is never imported, so the config's types are structural (read from shadcn's new-york-v4
+ * `chart.tsx`); React's `createElement` builds the icons. Call after `loadLeague(league)` / `preloadAll()`.
+ */
+
+/**
+ * One team's entry in the config: shadcn's `ChartConfig` item with a `theme` (never a single `color`), so
+ * `<ChartStyle>` writes the light colour under the chart and the dark one under `.dark`.
+ */
+interface TeamChartConfigItem {
+    /** The team's name, e.g. "Kansas City Chiefs" (its own value when it does not resolve). */
+    label: string;
+    /** The team's colour on a light chart and on a dark one, each 3:1 or more against that theme's background. */
+    theme: {
+        light: string;
+        dark: string;
+    };
+    /** The team's logo, at legend and tooltip size; absent when the team has no logo (shadcn draws its swatch). */
+    icon?: ComponentType;
+}
+/** What `teamChartConfig` returns. */
+interface TeamChartConfig {
+    /** shadcn's `ChartConfig`, keyed by `keys`: pass it to `<ChartContainer config>`. */
+    config: Record<string, TeamChartConfigItem>;
+    /**
+     * `keys[i]` is `teams[i]`'s key in `config`: name a series' `dataKey` with it, colour it `var(--color-<key>)`, and
+     * put it in a row column for `<ChartTooltipContent nameKey>`. A clash is numbered in the order of `teams` (`lal`,
+     * `lal-2`), so read the key here rather than recomputing it, and pass each team once.
+     */
+    keys: string[];
+}
+/** `teamChartConfig` options. */
+interface TeamChartConfigOptions {
+    /** The team colour taken first: "primary" (default) or "secondary". */
+    which?: Which;
+    /** The season the teams (their names, colours and logos) are resolved for. */
+    season?: SeasonInput;
+    /** How the `teams` values are read. Default "auto". */
+    idSystem?: IdSystem;
+    /**
+     * The chart backgrounds the colours must read on (3:1 contrast), as hex. Default shadcn's neutral theme: `light`
+     * #ffffff (its page and card), `dark` #171717 (its dark card, `oklch(0.205 0 0)`; a colour that reads on it reads
+     * on the darker dark page, #0a0a0a, too).
+     */
+    background?: {
+        light?: string;
+        dark?: string;
+    };
+    /** `false`: no logos, so shadcn draws its colour swatch for every team. Default true. */
+    icon?: boolean;
+    /** The logo's height in px, 1 or more, rounded to a whole px. Default 16. */
+    iconSize?: number;
+}
+/**
+ * shadcn's `ChartConfig` for teams: one entry per team, keyed for CSS (team names like "Trail Blazers" are not valid
+ * custom property names), with the team's name as `label`, its colour on shadcn's light and dark backgrounds as
+ * `theme` (3:1 contrast on each, and distinct from the other teams'), and its logo as `icon`, which
+ * `<ChartLegendContent>` and `<ChartTooltipContent>` draw in place of their colour swatch. A team with no logo has
+ * no `icon` (shadcn falls back to the swatch) and warns once. The icons are the same components for the same logo
+ * on every call, so building the config inside a component's render is safe.
+ *
+ * @example
+ * ```ts
+ * import { loadLeague } from "@sportsdataverse/sdvplot";
+ * import { teamChartConfig } from "@sportsdataverse/sdvplot/shadcn";
+ *
+ * await loadLeague("nba");
+ * // "Trail Blazers" is not a CSS name: its key is "trail-blazers", a series' dataKey and var(--color-trail-blazers)
+ * const { config, keys } = teamChartConfig("nba", ["Trail Blazers", "Lakers"]);
+ * [keys, config["trail-blazers"]?.label, config["trail-blazers"]?.theme];
+ * ```
+ */
+declare function teamChartConfig(league: League, teams: readonly unknown[], o?: TeamChartConfigOptions): TeamChartConfig;
+
+export { type TeamChartConfig, type TeamChartConfigItem, type TeamChartConfigOptions, teamChartConfig };

package/dist/shadcn.js

@@ -0,0 +1,88 @@
+import { teamColorPalette } from './chunk-M3XD2OSN.js';
+import './chunk-UL5M6KDE.js';
+import { placeSync } from './chunk-7ULOCCFL.js';
+import { resolveSync, getLeagueSync } from './chunk-ZAEQXFJM.js';
+import './chunk-J6R2LEJ7.js';
+import { InputError, warn } from './chunk-E7G7VSLV.js';
+import { createElement } from 'react';
+
+var LIGHT = "#ffffff";
+var DARK = "#171717";
+function chartKeys(values) {
+  const used = /* @__PURE__ */ new Set();
+  return values.map((v) => {
+    const base = String(v).normalize("NFKD").replace(/\p{M}/gu, "").toLowerCase().replace(/[^\p{L}\p{N}]+/gu, "-").replace(/^-+|-+$/g, "") || "team";
+    let key = base;
+    for (let n = 2; used.has(key); n++) key = `${base}-${n}`;
+    used.add(key);
+    return key;
+  });
+}
+var icons = /* @__PURE__ */ new Map();
+function logoIcon(src, id, h, aspect) {
+  const k = `${h}|${src}`;
+  let icon = icons.get(k);
+  if (icon === void 0) {
+    const img = createElement("img", {
+      src,
+      alt: "",
+      width: Math.round(h * aspect),
+      height: h,
+      style: { height: h, width: "auto", flexShrink: 0 },
+      "data-sdv-id": id,
+      "data-sdv-kind": "logo"
+    });
+    const Logo = () => img;
+    Logo.displayName = "TeamLogoIcon";
+    icon = Logo;
+    icons.set(k, icon);
+  }
+  return icon;
+}
+function teamChartConfig(league, teams, o = {}) {
+  const size = o.iconSize ?? 16;
+  if (!(typeof size === "number" && Number.isFinite(size) && size >= 1))
+    throw new InputError(`iconSize is a logo height in px, 1 or more, got ${String(size)}`);
+  const h = Math.round(size);
+  const ro = {
+    ...o.season === void 0 ? {} : { season: o.season },
+    ...o.idSystem === void 0 ? {} : { idSystem: o.idSystem }
+  };
+  const co = { ...ro, ...o.which === void 0 ? {} : { which: o.which } };
+  const light = teamColorPalette(league, teams, { ...co, background: o.background?.light ?? LIGHT });
+  const dark = teamColorPalette(league, teams, { ...co, background: o.background?.dark ?? DARK });
+  const ids = resolveSync(teams, league, ro);
+  const names = new Map(getLeagueSync(league).teams.map((t) => [t.team_id, t.name ?? t.abbr]));
+  const logos = new Map(
+    o.icon === false ? [] : placeSync(
+      teams.map(() => 0),
+      teams.map(() => 0),
+      teams,
+      { league, kind: "logo", ...ro, warn: false }
+    ).map((p) => [p.index, p])
+  );
+  const keys = chartKeys(teams);
+  const noLogo = [];
+  const config = {};
+  keys.forEach((key, i) => {
+    const id = ids[i];
+    const item = {
+      label: (id === void 0 ? void 0 : names.get(id)) ?? String(teams[i]),
+      theme: { light: light[i], dark: dark[i] }
+    };
+    const p = logos.get(i);
+    if (p !== void 0) item.icon = logoIcon(p.url, p.id, h, p.aspect ?? 1);
+    else if (o.icon !== false && id !== void 0) noLogo.push(String(teams[i]));
+    config[key] = item;
+  });
+  if (noLogo.length > 0)
+    warn(
+      `shadcn:${league}:no-logo:${noLogo.join(",")}`,
+      `teamChartConfig: no logo for ${noLogo.join(", ")} (${league}); the legend and tooltip show its colour swatch`
+    );
+  return { config, keys };
+}
+
+export { teamChartConfig };
+//# sourceMappingURL=shadcn.js.map
+//# sourceMappingURL=shadcn.js.map

package/dist/shadcn.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/shadcn.ts"],"names":[],"mappings":"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","file":"shadcn.js","sourcesContent":["/**\n * The shadcn/ui charts adapter. shadcn's charts are Recharts charts inside its copy-paste `chart.tsx`\n * (`<ChartContainer config>`, `<ChartLegendContent>`, `<ChartTooltipContent>`), configured by a `ChartConfig`:\n * `teamChartConfig` builds that config from teams, with CSS-safe keys, team colours for its light and dark themes,\n * team names as labels and team logos as the legend's and tooltip's icons. Draw the series with `sdvplot/recharts`\n * (`logoTick`, `logoDot`) as for any Recharts chart. Pure: shadcn is not a package (you copy `chart.tsx` into your\n * app) and recharts is never imported, so the config's types are structural (read from shadcn's new-york-v4\n * `chart.tsx`); React's `createElement` builds the icons. Call after `loadLeague(league)` / `preloadAll()`.\n */\nimport { type ComponentType, type ReactElement, createElement } from \"react\";\nimport { place } from \"./_web.js\";\nimport { InputError, warn } from \"./errors.js\";\nimport { getLeagueSync } from \"./index-data.js\";\nimport { teamColorPalette } from \"./recharts.js\";\nimport { type Value, resolveSync } from \"./resolve.js\";\nimport type { IdSystem, League, SeasonInput, Which } from \"./types.js\";\n\n/**\n * One team's entry in the config: shadcn's `ChartConfig` item with a `theme` (never a single `color`), so\n * `<ChartStyle>` writes the light colour under the chart and the dark one under `.dark`.\n */\nexport interface TeamChartConfigItem {\n  /** The team's name, e.g. \"Kansas City Chiefs\" (its own value when it does not resolve). */\n  label: string;\n  /** The team's colour on a light chart and on a dark one, each 3:1 or more against that theme's background. */\n  theme: { light: string; dark: string };\n  /** The team's logo, at legend and tooltip size; absent when the team has no logo (shadcn draws its swatch). */\n  icon?: ComponentType;\n}\n/** What `teamChartConfig` returns. */\nexport interface TeamChartConfig {\n  /** shadcn's `ChartConfig`, keyed by `keys`: pass it to `<ChartContainer config>`. */\n  config: Record<string, TeamChartConfigItem>;\n  /**\n   * `keys[i]` is `teams[i]`'s key in `config`: name a series' `dataKey` with it, colour it `var(--color-<key>)`, and\n   * put it in a row column for `<ChartTooltipContent nameKey>`. A clash is numbered in the order of `teams` (`lal`,\n   * `lal-2`), so read the key here rather than recomputing it, and pass each team once.\n   */\n  keys: string[];\n}\n/** `teamChartConfig` options. */\nexport interface TeamChartConfigOptions {\n  /** The team colour taken first: \"primary\" (default) or \"secondary\". */\n  which?: Which;\n  /** The season the teams (their names, colours and logos) are resolved for. */\n  season?: SeasonInput;\n  /** How the `teams` values are read. Default \"auto\". */\n  idSystem?: IdSystem;\n  /**\n   * The chart backgrounds the colours must read on (3:1 contrast), as hex. Default shadcn's neutral theme: `light`\n   * #ffffff (its page and card), `dark` #171717 (its dark card, `oklch(0.205 0 0)`; a colour that reads on it reads\n   * on the darker dark page, #0a0a0a, too).\n   */\n  background?: { light?: string; dark?: string };\n  /** `false`: no logos, so shadcn draws its colour swatch for every team. Default true. */\n  icon?: boolean;\n  /** The logo's height in px, 1 or more, rounded to a whole px. Default 16. */\n  iconSize?: number;\n}\n\n/** shadcn's neutral theme (new-york-v4 `registry/themes.ts`): light background and card, and the dark card. */\nconst LIGHT = \"#ffffff\";\nconst DARK = \"#171717\";\n\n/**\n * A CSS-safe key for each value, in order: diacritics dropped, lower-cased, each run of anything but letters and\n * digits made one \"-\" (\"Trail Blazers\" -> \"trail-blazers\", \"Montréal\" -> \"montreal\"; other scripts' letters stay,\n * which a custom property name allows), \"team\" when nothing is left, and \"-2\", \"-3\", ... on a key already taken.\n */\nfunction chartKeys(values: readonly unknown[]): string[] {\n  const used = new Set<string>();\n  return values.map((v) => {\n    const base =\n      String(v)\n        .normalize(\"NFKD\")\n        .replace(/\\p{M}/gu, \"\")\n        .toLowerCase()\n        .replace(/[^\\p{L}\\p{N}]+/gu, \"-\")\n        .replace(/^-+|-+$/g, \"\") || \"team\";\n    let key = base;\n    for (let n = 2; used.has(key); n++) key = `${base}-${n}`;\n    used.add(key);\n    return key;\n  });\n}\n\n// ponytail: one icon component per (logo, size) for the process, so a config rebuilt on every render hands shadcn the\n// same component and React keeps the <img>; bounded by the logos a page draws times the whole-px sizes asked for.\nconst icons = new Map<string, ComponentType>();\nfunction logoIcon(src: string, id: string, h: number, aspect: number): ComponentType {\n  const k = `${h}|${src}`;\n  let icon = icons.get(k);\n  if (icon === undefined) {\n    // alt \"\": shadcn puts the team's label beside it in the legend and the tooltip\n    const img = createElement(\"img\", {\n      src,\n      alt: \"\",\n      width: Math.round(h * aspect),\n      height: h,\n      style: { height: h, width: \"auto\", flexShrink: 0 },\n      \"data-sdv-id\": id,\n      \"data-sdv-kind\": \"logo\",\n    });\n    const Logo = (): ReactElement => img;\n    Logo.displayName = \"TeamLogoIcon\";\n    icon = Logo;\n    icons.set(k, icon);\n  }\n  return icon;\n}\n\n/**\n * shadcn's `ChartConfig` for teams: one entry per team, keyed for CSS (team names like \"Trail Blazers\" are not valid\n * custom property names), with the team's name as `label`, its colour on shadcn's light and dark backgrounds as\n * `theme` (3:1 contrast on each, and distinct from the other teams'), and its logo as `icon`, which\n * `<ChartLegendContent>` and `<ChartTooltipContent>` draw in place of their colour swatch. A team with no logo has\n * no `icon` (shadcn falls back to the swatch) and warns once. The icons are the same components for the same logo\n * on every call, so building the config inside a component's render is safe.\n *\n * @example\n * ```ts\n * import { loadLeague } from \"@sportsdataverse/sdvplot\";\n * import { teamChartConfig } from \"@sportsdataverse/sdvplot/shadcn\";\n *\n * await loadLeague(\"nba\");\n * // \"Trail Blazers\" is not a CSS name: its key is \"trail-blazers\", a series' dataKey and var(--color-trail-blazers)\n * const { config, keys } = teamChartConfig(\"nba\", [\"Trail Blazers\", \"Lakers\"]);\n * [keys, config[\"trail-blazers\"]?.label, config[\"trail-blazers\"]?.theme];\n * ```\n */\nexport function teamChartConfig(\n  league: League,\n  teams: readonly unknown[],\n  o: TeamChartConfigOptions = {},\n): TeamChartConfig {\n  const size = o.iconSize ?? 16;\n  if (!(typeof size === \"number\" && Number.isFinite(size) && size >= 1))\n    throw new InputError(`iconSize is a logo height in px, 1 or more, got ${String(size)}`);\n  const h = Math.round(size); // whole px: a fractional size would add an icon (and a cache entry) per value\n  const ro = {\n    ...(o.season === undefined ? {} : { season: o.season }),\n    ...(o.idSystem === undefined ? {} : { idSystem: o.idSystem }),\n  };\n  const co = { ...ro, ...(o.which === undefined ? {} : { which: o.which }) };\n  const light = teamColorPalette(league, teams, { ...co, background: o.background?.light ?? LIGHT });\n  const dark = teamColorPalette(league, teams, { ...co, background: o.background?.dark ?? DARK });\n  const ids = resolveSync(teams as readonly Value[], league, ro);\n  const names = new Map(getLeagueSync(league).teams.map((t) => [t.team_id, t.name ?? t.abbr]));\n  const logos = new Map(\n    o.icon === false\n      ? []\n      : place(\n          teams.map(() => 0),\n          teams.map(() => 0),\n          teams as readonly Value[],\n          { league, kind: \"logo\", ...ro, warn: false },\n        ).map((p) => [p.index, p]),\n  );\n  const keys = chartKeys(teams);\n  const noLogo: string[] = [];\n  const config: Record<string, TeamChartConfigItem> = {};\n  keys.forEach((key, i) => {\n    const id = ids[i];\n    const item: TeamChartConfigItem = {\n      label: (id === undefined ? undefined : names.get(id)) ?? String(teams[i]),\n      theme: { light: light[i] as string, dark: dark[i] as string },\n    };\n    const p = logos.get(i);\n    if (p !== undefined) item.icon = logoIcon(p.url, p.id, h, p.aspect ?? 1);\n    else if (o.icon !== false && id !== undefined) noLogo.push(String(teams[i])); // unresolved: the resolver warned\n    config[key] = item;\n  });\n  if (noLogo.length > 0)\n    warn(\n      `shadcn:${league}:no-logo:${noLogo.join(\",\")}`,\n      `teamChartConfig: no logo for ${noLogo.join(\", \")} (${league}); the legend and tooltip show its colour swatch`,\n    );\n  return { config, keys };\n}\n"]}

package/dist/shots.js

@@ -1,5 +1,6 @@
-import { made, split, binShots } from './chunk-QY65DUEF.js';
-export { LEAGUE_PRIOR_ATTEMPTS, binShots, cellsVsLeague, diffScale, leagueIndex, shrunkDiff, signaturePoints, sizeCells, statsByZone } from './chunk-QY65DUEF.js';
+import { made, split, binShots } from './chunk-H2C3FMMA.js';
+export { LEAGUE_PRIOR_ATTEMPTS, binShots, cellsVsLeague, diffScale, leagueIndex, shrunkDiff, signaturePoints, sizeCells, statsByZone } from './chunk-H2C3FMMA.js';
+import './chunk-WQT4IVLX.js';
 export { binner, cellPath, cellPoints, hexagonPath, hexbin, squarePath, squarebin } from './chunk-C2CDY5OG.js';
 import { InputError } from './chunk-E7G7VSLV.js';
 

package/dist/shots.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/shots/distance.ts"],"names":[],"mappings":"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","file":"shots.js","sourcesContent":["// Distance and side bins, ported from blazing-the-nets `main` lib/data/aggregate.ts (@31427b8), plus `master`'s\n// distance baseline for cells (src/components/Hexagon/index.js @35dfda6). Pure; the parity gate is fixtures/shots/oracle.json.\nimport type { BinnerOptions } from \"../bins/index.js\";\nimport { InputError } from \"../errors.js\";\nimport { type CellVsLeague, type ShotRow, type Split, binShots, made, split } from \"./aggregate.js\";\n\n/** One `fgPctByDistance` bin: the counts of the shots `distance` to `distance + binFt` ft out, and their share. */\nexport interface DistanceBin extends Split {\n  /** First foot of the bin; `shot_distance` is rounded, so a 1-ft bin is centred on it. */\n  readonly distance: number;\n  /** Share of the attempts within `maxFt`. */\n  readonly share: number;\n}\n\n/** The number of `binFt` bins from 0 to `maxFt`; both must be finite numbers above 0 (else InputError, naming it). */\nfunction binCount(binFt: number, maxFt: number): number {\n  for (const [name, v] of Object.entries({ binFt, maxFt }))\n    if (!(Number.isFinite(v) && v > 0))\n      throw new InputError(`${name} must be a finite number > 0, got ${String(v)}`);\n  return Math.floor(maxFt / binFt) + 1;\n}\n\n/**\n * FG% by `shot_distance` in `binFt` bins from 0 to `maxFt`; longer attempts are left out (aggregate.ts:177-192).\n * The total within `maxFt` is the sum of `attempts`. `binFt` and `maxFt` must be finite numbers above 0 (else\n * InputError).\n *\n * @example\n * ```ts\n * import { fgPctByDistance } 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 * fgPctByDistance(shots, 3)[0];\n * ```\n */\nexport function fgPctByDistance(shots: readonly ShotRow[], binFt = 1, maxFt = 35): DistanceBin[] {\n  const bins = Array.from({ length: binCount(binFt, maxFt) }, () => ({ attempts: 0, makes: 0 }));\n  let total = 0;\n  for (const s of shots) {\n    if (s.shot_distance > maxFt) continue;\n    const b = bins[Math.floor(s.shot_distance / binFt)];\n    if (b === undefined) continue; // a negative distance\n    b.attempts += 1;\n    if (made(s)) b.makes += 1;\n    total += 1;\n  }\n  return bins.map((b, i) => ({\n    distance: i * binFt,\n    ...split(b.attempts, b.makes),\n    share: total ? b.attempts / total : 0,\n  }));\n}\n\n/** A player distance bin with the league's FG% at the same distance and the difference (`vsLeague`). */\nexport interface DistanceVsLeague extends DistanceBin {\n  readonly leagueFgPct: number | null;\n  /** Player minus league FG% (a fraction), null when either side has no attempts. */\n  readonly diff: number | null;\n}\n\n/**\n * Pair player and league distance bins (same `binFt` and `maxFt`, else InputError) and take the difference\n * (aggregate.ts:200-209).\n *\n * @example\n * ```ts\n * import { fgPctByDistance, vsLeague } from \"@sportsdataverse/sdvplot/shots\";\n *\n * // Brooklyn shots from the sportsdataverse-data nba_stats_shots release, 2025-26\n * const made = { x_legacy: 0, y_legacy: 0, shot_distance: 0, shot_value: 2, shot_result: \"Made\" };\n * const missed = { ...made, shot_result: \"Missed\" };\n * vsLeague(fgPctByDistance([made]), fgPctByDistance([made, missed]))[0];\n * ```\n */\nexport function vsLeague(player: readonly DistanceBin[], league: readonly DistanceBin[]): DistanceVsLeague[] {\n  if (player.length !== league.length || player.some((b, i) => b.distance !== league[i]?.distance)) {\n    throw new InputError(\"vsLeague: player and league bins differ (use the same binFt and maxFt)\");\n  }\n  return player.map((b, i) => {\n    const leagueFgPct = league[i]?.fgPct ?? null;\n    return {\n      ...b,\n      leagueFgPct,\n      diff: b.fgPct !== null && leagueFgPct !== null ? b.fgPct - leagueFgPct : null,\n    };\n  });\n}\n\n/** One `statsBySide` bin: left, centre and right of the hoop for the shots in the bin that starts `distance` ft out. */\nexport interface SideBin {\n  readonly distance: number;\n  readonly left: Split;\n  readonly centre: Split;\n  readonly right: Split;\n}\n\n/**\n * Left / centre / right of the hoop by distance (aggregate.ts:218-240): left is `x < -centreHalfWidth`, right is\n * `x > centreHalfWidth`. The default 0 puts `x == 0` in centre (`main`); `false` drops it, as `master`'s\n * `binLeftRight` did (`src/utils/visuals/bin.ts:36-42`). `binFt` and `maxFt` as for `fgPctByDistance`; a\n * `centreHalfWidth` that is negative or not finite throws InputError.\n *\n * @example\n * ```ts\n * import { statsBySide } 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 * statsBySide(shots, 3, 35, 7.5)[0];\n * ```\n */\nexport function statsBySide(\n  shots: readonly ShotRow[],\n  binFt = 1,\n  maxFt = 35,\n  centreHalfWidth: number | false = 0,\n): SideBin[] {\n  if (centreHalfWidth !== false && !(Number.isFinite(centreHalfWidth) && centreHalfWidth >= 0))\n    throw new InputError(\n      `statsBySide centreHalfWidth must be a finite number >= 0 or false, got ${String(centreHalfWidth)}`,\n    );\n  const half = centreHalfWidth === false ? 0 : centreHalfWidth;\n  const acc = Array.from({ length: binCount(binFt, maxFt) }, () => ({\n    left: [0, 0],\n    centre: [0, 0],\n    right: [0, 0],\n  }));\n  for (const s of shots) {\n    if (s.shot_distance > maxFt) continue;\n    const bin = acc[Math.floor(s.shot_distance / binFt)];\n    if (bin === undefined) continue;\n    const x = s.x_legacy;\n    const side =\n      x < -half ? bin.left : x > half ? bin.right : centreHalfWidth === false ? undefined : bin.centre;\n    if (side === undefined) continue;\n    side[0] = (side[0] ?? 0) + 1;\n    if (made(s)) side[1] = (side[1] ?? 0) + 1;\n  }\n  return acc.map((b, i) => ({\n    distance: i * binFt,\n    left: split(b.left[0] ?? 0, b.left[1] ?? 0),\n    centre: split(b.centre[0] ?? 0, b.centre[1] ?? 0),\n    right: split(b.right[0] ?? 0, b.right[1] ?? 0),\n  }));\n}\n\n/**\n * Player cells against the league FG% at the cell centre's distance, `floor(|centre| / 10)` ft, falling back one\n * foot when that bin is empty (blazing-the-nets `master` `src/components/Hexagon/index.js:44-49`). `cell` is a\n * hexagon radius (default 10, master's) or any `binner` lattice, e.g. `{ shape: \"square\", side: 10 }`. `byFoot` is\n * read as feet, so it must be 1-ft bins from 0 (`fgPctByDistance(league)`), else InputError.\n *\n * The distance is `Math.hypot(x, y)`, a deliberate divergence from master's `Math.sqrt(x ** 2 + y ** 2)`\n * (`src/lib/distance.js:3-4`). On a hexagon centre exactly a whole number of feet out, such as (15√3, 15) at 3 ft,\n * master's sqrt returns 29.999…96 and reads the foot below; hypot reads the true foot. On the real BKN fixture at\n * radius 10 that is 13 of 374 cells, among them the cells beside the rim (0.572 at 3 ft, where master reads 0.669\n * at 2 ft). Every other cell reads master's foot.\n *\n * @example\n * ```ts\n * import { cellsVsDistance, fgPctByDistance } from \"@sportsdataverse/sdvplot/shots\";\n *\n * // Brooklyn shots from the sportsdataverse-data nba_stats_shots release, 2025-26\n * const made = { x_legacy: 0, y_legacy: 0, shot_distance: 0, shot_value: 2, shot_result: \"Made\" };\n * const missed = { ...made, shot_result: \"Missed\" };\n * cellsVsDistance([made], fgPctByDistance([made, missed]), { shape: \"square\", side: 10 });\n * ```\n */\nexport function cellsVsDistance(\n  player: readonly ShotRow[],\n  byFoot: readonly DistanceBin[],\n  cell: number | BinnerOptions = 10,\n): CellVsLeague[] {\n  const bad = byFoot.findIndex((b, i) => b.distance !== i);\n  if (bad >= 0)\n    throw new InputError(\n      `cellsVsDistance needs 1-ft distance bins from 0 (fgPctByDistance(shots, 1)); bin ${bad} is at ${String(byFoot[bad]?.distance)} ft`,\n    );\n  return binShots(player, cell).map((h) => {\n    // hypot, not master's sqrt(x ** 2 + y ** 2) (distance.js:3-4), which reads a whole-foot centre one foot short\n    const d = Math.floor(Math.hypot(h.x, h.y) / 10);\n    return { ...h, leagueFgPct: byFoot[d]?.fgPct ?? byFoot[d - 1]?.fgPct ?? null };\n  });\n}\n"]}
+{"version":3,"sources":["../src/shots/distance.ts"],"names":[],"mappings":"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","file":"shots.js","sourcesContent":["// Distance and side bins, ported from blazing-the-nets `main` lib/data/aggregate.ts (@31427b8), plus `master`'s\n// distance baseline for cells (src/components/Hexagon/index.js @35dfda6). Pure; the parity gate is fixtures/shots/oracle.json.\nimport type { BinnerOptions } from \"../bins/index.js\";\nimport { InputError } from \"../errors.js\";\nimport { type CellVsLeague, type ShotRow, type Split, binShots, made, split } from \"./aggregate.js\";\n\n/** One `fgPctByDistance` bin: the counts of the shots `distance` to `distance + binFt` ft out, and their share. */\nexport interface DistanceBin extends Split {\n  /** First foot of the bin; `shot_distance` is rounded, so a 1-ft bin is centred on it. */\n  readonly distance: number;\n  /** Share of the attempts within `maxFt`. */\n  readonly share: number;\n}\n\n/** The number of `binFt` bins from 0 to `maxFt`; both must be finite numbers above 0 (else InputError, naming it). */\nfunction binCount(binFt: number, maxFt: number): number {\n  for (const [name, v] of Object.entries({ binFt, maxFt }))\n    if (!(Number.isFinite(v) && v > 0))\n      throw new InputError(`${name} must be a finite number > 0, got ${String(v)}`);\n  return Math.floor(maxFt / binFt) + 1;\n}\n\n/**\n * FG% by `shot_distance` in `binFt` bins from 0 to `maxFt`; longer attempts are left out (aggregate.ts:177-192).\n * The total within `maxFt` is the sum of `attempts`. `binFt` and `maxFt` must be finite numbers above 0 (else\n * InputError).\n *\n * @example\n * ```ts\n * import { fgPctByDistance } 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 * fgPctByDistance(shots, 3)[0];\n * ```\n */\nexport function fgPctByDistance(shots: readonly ShotRow[], binFt = 1, maxFt = 35): DistanceBin[] {\n  const bins = Array.from({ length: binCount(binFt, maxFt) }, () => ({ attempts: 0, makes: 0 }));\n  let total = 0;\n  for (const s of shots) {\n    if (s.shot_distance > maxFt) continue;\n    const b = bins[Math.floor(s.shot_distance / binFt)];\n    if (b === undefined) continue; // a negative distance\n    b.attempts += 1;\n    if (made(s)) b.makes += 1;\n    total += 1;\n  }\n  return bins.map((b, i) => ({\n    distance: i * binFt,\n    ...split(b.attempts, b.makes),\n    share: total ? b.attempts / total : 0,\n  }));\n}\n\n/** A player distance bin with the league's FG% at the same distance and the difference (`vsLeague`). */\nexport interface DistanceVsLeague extends DistanceBin {\n  readonly leagueFgPct: number | null;\n  /** Player minus league FG% (a fraction), null when either side has no attempts. */\n  readonly diff: number | null;\n}\n\n/**\n * Pair player and league distance bins (same `binFt` and `maxFt`, else InputError) and take the difference\n * (aggregate.ts:200-209).\n *\n * @example\n * ```ts\n * import { fgPctByDistance, vsLeague } from \"@sportsdataverse/sdvplot/shots\";\n *\n * // Brooklyn shots from the sportsdataverse-data nba_stats_shots release, 2025-26\n * const made = { x_legacy: 0, y_legacy: 0, shot_distance: 0, shot_value: 2, shot_result: \"Made\" };\n * const missed = { ...made, shot_result: \"Missed\" };\n * vsLeague(fgPctByDistance([made]), fgPctByDistance([made, missed]))[0];\n * ```\n */\nexport function vsLeague(player: readonly DistanceBin[], league: readonly DistanceBin[]): DistanceVsLeague[] {\n  if (player.length !== league.length || player.some((b, i) => b.distance !== league[i]?.distance)) {\n    throw new InputError(\"vsLeague: player and league bins differ (use the same binFt and maxFt)\");\n  }\n  return player.map((b, i) => {\n    const leagueFgPct = league[i]?.fgPct ?? null;\n    return {\n      ...b,\n      leagueFgPct,\n      diff: b.fgPct !== null && leagueFgPct !== null ? b.fgPct - leagueFgPct : null,\n    };\n  });\n}\n\n/** One `statsBySide` bin: left, centre and right of the hoop for the shots in the bin that starts `distance` ft out. */\nexport interface SideBin {\n  readonly distance: number;\n  readonly left: Split;\n  readonly centre: Split;\n  readonly right: Split;\n}\n\n/**\n * Left / centre / right of the hoop by distance (aggregate.ts:218-240): left is `x < -centreHalfWidth`, right is\n * `x > centreHalfWidth`. The default 0 puts `x == 0` in centre (`main`); `false` drops it, as `master`'s\n * `binLeftRight` did (`src/utils/visuals/bin.ts:36-42`). `binFt` and `maxFt` as for `fgPctByDistance`; a\n * `centreHalfWidth` that is negative or not finite throws InputError.\n *\n * @example\n * ```ts\n * import { statsBySide } 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 * statsBySide(shots, 3, 35, 7.5)[0];\n * ```\n */\nexport function statsBySide(\n  shots: readonly ShotRow[],\n  binFt = 1,\n  maxFt = 35,\n  centreHalfWidth: number | false = 0,\n): SideBin[] {\n  if (centreHalfWidth !== false && !(Number.isFinite(centreHalfWidth) && centreHalfWidth >= 0))\n    throw new InputError(\n      `statsBySide centreHalfWidth must be a finite number >= 0 or false, got ${String(centreHalfWidth)}`,\n    );\n  const half = centreHalfWidth === false ? 0 : centreHalfWidth;\n  const acc = Array.from({ length: binCount(binFt, maxFt) }, () => ({\n    left: [0, 0],\n    centre: [0, 0],\n    right: [0, 0],\n  }));\n  for (const s of shots) {\n    if (s.shot_distance > maxFt) continue;\n    const bin = acc[Math.floor(s.shot_distance / binFt)];\n    if (bin === undefined) continue;\n    const x = s.x_legacy;\n    const side =\n      x < -half ? bin.left : x > half ? bin.right : centreHalfWidth === false ? undefined : bin.centre;\n    if (side === undefined) continue;\n    side[0] = (side[0] ?? 0) + 1;\n    if (made(s)) side[1] = (side[1] ?? 0) + 1;\n  }\n  return acc.map((b, i) => ({\n    distance: i * binFt,\n    left: split(b.left[0] ?? 0, b.left[1] ?? 0),\n    centre: split(b.centre[0] ?? 0, b.centre[1] ?? 0),\n    right: split(b.right[0] ?? 0, b.right[1] ?? 0),\n  }));\n}\n\n/**\n * Player cells against the league FG% at the cell centre's distance, `floor(|centre| / 10)` ft, falling back one\n * foot when that bin is empty (blazing-the-nets `master` `src/components/Hexagon/index.js:44-49`). `cell` is a\n * hexagon radius (default 10, master's) or any `binner` lattice, e.g. `{ shape: \"square\", side: 10 }`. `byFoot` is\n * read as feet, so it must be 1-ft bins from 0 (`fgPctByDistance(league)`), else InputError.\n *\n * The distance is `Math.hypot(x, y)`, a deliberate divergence from master's `Math.sqrt(x ** 2 + y ** 2)`\n * (`src/lib/distance.js:3-4`). On a hexagon centre exactly a whole number of feet out, such as (15√3, 15) at 3 ft,\n * master's sqrt returns 29.999…96 and reads the foot below; hypot reads the true foot. On the real BKN fixture at\n * radius 10 that is 13 of 374 cells, among them the cells beside the rim (0.572 at 3 ft, where master reads 0.669\n * at 2 ft). Every other cell reads master's foot.\n *\n * @example\n * ```ts\n * import { cellsVsDistance, fgPctByDistance } from \"@sportsdataverse/sdvplot/shots\";\n *\n * // Brooklyn shots from the sportsdataverse-data nba_stats_shots release, 2025-26\n * const made = { x_legacy: 0, y_legacy: 0, shot_distance: 0, shot_value: 2, shot_result: \"Made\" };\n * const missed = { ...made, shot_result: \"Missed\" };\n * cellsVsDistance([made], fgPctByDistance([made, missed]), { shape: \"square\", side: 10 });\n * ```\n */\nexport function cellsVsDistance(\n  player: readonly ShotRow[],\n  byFoot: readonly DistanceBin[],\n  cell: number | BinnerOptions = 10,\n): CellVsLeague[] {\n  const bad = byFoot.findIndex((b, i) => b.distance !== i);\n  if (bad >= 0)\n    throw new InputError(\n      `cellsVsDistance needs 1-ft distance bins from 0 (fgPctByDistance(shots, 1)); bin ${bad} is at ${String(byFoot[bad]?.distance)} ft`,\n    );\n  return binShots(player, cell).map((h) => {\n    // hypot, not master's sqrt(x ** 2 + y ** 2) (distance.js:3-4), which reads a whole-foot centre one foot short\n    const d = Math.floor(Math.hypot(h.x, h.y) / 10);\n    return { ...h, leagueFgPct: byFoot[d]?.fgPct ?? byFoot[d - 1]?.fgPct ?? null };\n  });\n}\n"]}

package/dist/surface-TR7YFJW3.js

@@ -0,0 +1,4 @@
+export { surfaceMesh } from './chunk-B2MP37SR.js';
+import './chunk-E7G7VSLV.js';
+//# sourceMappingURL=surface-TR7YFJW3.js.map
+//# sourceMappingURL=surface-TR7YFJW3.js.map

package/dist/surface-TR7YFJW3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"surface-TR7YFJW3.js"}

package/dist/surfaces-MIG7HOFU.js

@@ -0,0 +1,6 @@
+export { SURFACES, SURFACE_BASE, colorUpdates, surfaceScene } from './chunk-57WFSI4Q.js';
+import './chunk-ZAEQXFJM.js';
+import './chunk-J6R2LEJ7.js';
+import './chunk-E7G7VSLV.js';
+//# sourceMappingURL=surfaces-MIG7HOFU.js.map
+//# sourceMappingURL=surfaces-MIG7HOFU.js.map

package/dist/surfaces-MIG7HOFU.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"surfaces-MIG7HOFU.js"}

package/dist/surfaces-W-odWLpT.d.ts

@@ -0,0 +1,47 @@
+import { BaseballColorKey, BasketballColorKey, CurlingColorKey, FootballColorKey, HockeyColorKey, LacrosseColorKey, SoccerColorKey, SoftballColorKey, TennisColorKey, VolleyballColorKey, BaseballDisplayRange, BasketballDisplayRange, CurlingDisplayRange, FootballDisplayRange, HockeyDisplayRange, LacrosseDisplayRange, SoccerDisplayRange, SoftballDisplayRange, TennisDisplayRange, VolleyballDisplayRange, BaseballParamUpdates, BasketballParamUpdates, CurlingParamUpdates, FootballParamUpdates, HockeyParamUpdates, LacrosseParamUpdates, SoccerParamUpdates, SoftballParamUpdates, TennisParamUpdates, VolleyballParamUpdates, Sport } from '@sportsdataverse/sporty';
+import { V as Value } from './resolve-CQW-jzvr.js';
+import { S as SeasonInput } from './types-C7n6gJF3.js';
+
+type SurfaceSport = Sport;
+/**
+ * Maps an sdv surface key to `[sporty sport, sporty league key]`: the SDV surface-key table shared with sdvplot (Python
+ * `SURFACES`) and sdvplotR (`surface_map`). Keys that are also sdv team leagues (`nfl`, `ncaa_softball`, ...) take a `team`;
+ * the rest (`atp`, `fiba`, `nll`, ...) draw the plain surface.
+ */
+declare const SURFACES: Readonly<Record<string, readonly [SurfaceSport, string]>>;
+declare const SURFACE_BASE: {
+    readonly basketball: "#d2ab6f";
+    readonly football: "#196f0c";
+    readonly hockey: "#ffffff";
+};
+type Paint<K extends string> = Partial<Record<K, string>>;
+type AnyColorKey = BaseballColorKey | BasketballColorKey | CurlingColorKey | FootballColorKey | HockeyColorKey | LacrosseColorKey | SoccerColorKey | SoftballColorKey | TennisColorKey | VolleyballColorKey;
+/**
+ * Port of `_surface.color_updates`: the team colours a sport's surface takes, keyed by sporty colour key. Sports without a
+ * team painting (baseball, softball, soccer and the team-less surfaces) take none, as in sdvplotR.
+ */
+declare function colorUpdates(sport: "basketball", primary: string, secondary?: string): Paint<BasketballColorKey>;
+declare function colorUpdates(sport: "football", primary: string, secondary?: string): Paint<FootballColorKey>;
+declare function colorUpdates(sport: "hockey", primary: string, secondary?: string): Paint<HockeyColorKey>;
+declare function colorUpdates(sport: SurfaceSport, primary: string, secondary?: string): Record<string, string>;
+type AnyRange = BaseballDisplayRange | BasketballDisplayRange | CurlingDisplayRange | FootballDisplayRange | HockeyDisplayRange | LacrosseDisplayRange | SoccerDisplayRange | SoftballDisplayRange | TennisDisplayRange | VolleyballDisplayRange;
+interface SurfaceSceneOptions {
+    /** A team of the league, painting the surface; only for keys that are sdv team leagues (otherwise `InputError`). */
+    team?: Value;
+    season?: SeasonInput;
+    /** Overrides on top of the team painting, keyed by sporty colour key. */
+    colorUpdates?: Paint<AnyColorKey>;
+    rotation?: number;
+    /** A sporty display range for the league's sport; one the sport does not know throws sporty's UnknownDisplayRangeError. */
+    displayRange?: AnyRange;
+    xlim?: readonly [number, number];
+    ylim?: readonly [number, number];
+    units?: "ft" | "m" | "yd" | "in" | "cm" | "mm";
+    /** Sporty parameter overrides (intersected across sports so each sport's own keys type-check). */
+    updates?: BaseballParamUpdates & BasketballParamUpdates & CurlingParamUpdates & FootballParamUpdates & HockeyParamUpdates & LacrosseParamUpdates & SoccerParamUpdates & SoftballParamUpdates & TennisParamUpdates & VolleyballParamUpdates;
+    arcResolution?: number;
+    xTrans?: number;
+    yTrans?: number;
+}
+
+export { type SurfaceSceneOptions as S, SURFACES as a, SURFACE_BASE as b, colorUpdates as c };

package/dist/svelte/HeadshotMark.svelte

@@ -0,0 +1,25 @@
+<!--
+@component
+  ESPN player headshots as marks in a LayerChart chart: a child of its `<Svg>` layer. Each row draws its `player`'s
+  headshot centred on its scaled (`x`, `y`), `height` (a fraction of the plot area's height) tall. An id with no
+  headshot draws nothing and warns once. layerchart loads on first render; missing, it throws an install error then.
+-->
+<script lang="ts">
+  import { type HeadshotMarkProps, type LayerChart, loadLayerChart, raise } from "../svelte-core.js";
+  import Marks from "./Marks.svelte";
+
+  let props: HeadshotMarkProps = $props();
+  let lc = $state<LayerChart>();
+  let failed = $state<{ error: unknown }>();
+  // a failed import is rethrown from the template (an effect), where a <svelte:boundary> catches it
+  loadLayerChart("HeadshotMark").then(
+    (m) => (lc = m),
+    (error: unknown) => (failed = { error }),
+  );
+</script>
+
+{#if failed}
+  {raise(failed.error)}
+{:else if lc}
+  <Marks {lc} kind="headshot" options={props} />
+{/if}

package/dist/svelte/HeadshotMark.svelte.d.ts

@@ -0,0 +1,10 @@
+import { type HeadshotMarkProps } from "../svelte-core.js";
+/**
+ * ESPN player headshots as marks in a LayerChart chart: a child of its `<Svg>` layer. Each row draws its `player`'s
+ * headshot centred on its scaled (`x`, `y`), `height` (a fraction of the plot area's height) tall. An id with no
+ * headshot draws nothing and warns once. layerchart loads on first render; missing, it throws an install error then.
+ */
+declare const HeadshotMark: import("svelte").Component<HeadshotMarkProps, {}, "">;
+type HeadshotMark = ReturnType<typeof HeadshotMark>;
+export default HeadshotMark;
+//# sourceMappingURL=HeadshotMark.svelte.d.ts.map

package/dist/svelte/HeadshotMark.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HeadshotMark.svelte.d.ts","sourceRoot":"","sources":["../../src/svelte/HeadshotMark.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,iBAAiB,EAA0C,MAAM,mBAAmB,CAAC;AA0BnG;;;;GAIG;AACH,QAAA,MAAM,YAAY,uDAAwC,CAAC;AAC3D,KAAK,YAAY,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC;AACpD,eAAe,YAAY,CAAC"}

package/dist/svelte/LogoMark.svelte

@@ -0,0 +1,25 @@
+<!--
+@component
+  Team logos (or wordmarks) as marks in a LayerChart chart: a child of its `<Svg>` layer. Each row draws its
+  `team`'s logo centred on its scaled (`x`, `y`), `height` (a fraction of the plot area's height) tall. A team with no
+  logo draws nothing and warns once. layerchart loads on first render; missing, it throws an install error then.
+-->
+<script lang="ts">
+  import { type LayerChart, type LogoMarkProps, loadLayerChart, raise } from "../svelte-core.js";
+  import Marks from "./Marks.svelte";
+
+  let props: LogoMarkProps = $props();
+  let lc = $state<LayerChart>();
+  let failed = $state<{ error: unknown }>();
+  // a failed import is rethrown from the template (an effect), where a <svelte:boundary> catches it
+  loadLayerChart("LogoMark").then(
+    (m) => (lc = m),
+    (error: unknown) => (failed = { error }),
+  );
+</script>
+
+{#if failed}
+  {raise(failed.error)}
+{:else if lc}
+  <Marks {lc} kind={props.markType ?? "logo"} options={props} />
+{/if}

package/dist/svelte/LogoMark.svelte.d.ts

@@ -0,0 +1,10 @@
+import { type LogoMarkProps } from "../svelte-core.js";
+/**
+ * Team logos (or wordmarks) as marks in a LayerChart chart: a child of its `<Svg>` layer. Each row draws its
+ * `team`'s logo centred on its scaled (`x`, `y`), `height` (a fraction of the plot area's height) tall. A team with no
+ * logo draws nothing and warns once. layerchart loads on first render; missing, it throws an install error then.
+ */
+declare const LogoMark: import("svelte").Component<LogoMarkProps, {}, "">;
+type LogoMark = ReturnType<typeof LogoMark>;
+export default LogoMark;
+//# sourceMappingURL=LogoMark.svelte.d.ts.map

package/dist/svelte/LogoMark.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LogoMark.svelte.d.ts","sourceRoot":"","sources":["../../src/svelte/LogoMark.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,EAAmB,KAAK,aAAa,EAAyB,MAAM,mBAAmB,CAAC;AA0B/F;;;;GAIG;AACH,QAAA,MAAM,QAAQ,mDAAwC,CAAC;AACvD,KAAK,QAAQ,GAAG,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC;AAC5C,eAAe,QAAQ,CAAC"}

package/dist/svelte/Marks.svelte

@@ -0,0 +1,25 @@
+<svelte:options namespace="svg" />
+
+<script lang="ts">
+  // Internal: the images of a LogoMark or HeadshotMark, drawn once layerchart has loaded (its chart context is read
+  // here, during this component's setup inside the chart).
+  import {
+    type HeadshotMarkProps,
+    type LayerChart,
+    type LogoMarkProps,
+    markImages,
+  } from "../svelte-core.js";
+
+  let {
+    lc,
+    kind,
+    options,
+  }: { lc: LayerChart; kind: "logo" | "wordmark" | "headshot"; options: LogoMarkProps | HeadshotMarkProps } = $props();
+  // svelte-ignore state_referenced_locally
+  const ctx = lc.getChartContext(); // once, at setup: a context is only readable then (lc never changes)
+  const images = $derived(markImages(ctx, kind, options));
+</script>
+
+{#each images as m (m.key)}
+  <image {...m.attrs} />
+{/each}