@sportsdataverse/sdvplot 0.0.0-stage → 0.2.0

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}

package/dist/svelte/Marks.svelte.d.ts

@@ -0,0 +1,10 @@
+import { type HeadshotMarkProps, type LayerChart, type LogoMarkProps } from "../svelte-core.js";
+type $$ComponentProps = {
+    lc: LayerChart;
+    kind: "logo" | "wordmark" | "headshot";
+    options: LogoMarkProps | HeadshotMarkProps;
+};
+declare const Marks: import("svelte").Component<$$ComponentProps, {}, "">;
+type Marks = ReturnType<typeof Marks>;
+export default Marks;
+//# sourceMappingURL=Marks.svelte.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Marks.svelte.d.ts","sourceRoot":"","sources":["../../src/svelte/Marks.svelte.ts"],"names":[],"mappings":"AAKA,OAAO,EACH,KAAK,iBAAiB,EACtB,KAAK,UAAU,EACf,KAAK,aAAa,EAEnB,MAAM,mBAAmB,CAAC;AAE5B,KAAK,gBAAgB,GAAI;IAAE,EAAE,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,UAAU,CAAC;IAAC,OAAO,EAAE,aAAa,GAAG,iBAAiB,CAAA;CAAE,CAAC;AAwBjI,QAAA,MAAM,KAAK,sDAAwC,CAAC;AACpD,KAAK,KAAK,GAAG,UAAU,CAAC,OAAO,KAAK,CAAC,CAAC;AACtC,eAAe,KAAK,CAAC"}

package/dist/svelte/Surface.svelte

@@ -0,0 +1,29 @@
+<svelte:options namespace="svg" />
+
+<script lang="ts">
+  // Internal: the backdrop once its code has loaded (the chart context is read here, during setup inside the chart).
+  import { type SurfaceBackdropProps, type SurfaceKit, surfaceMarkup } from "../svelte-core.js";
+
+  let { kit, options }: { kit: SurfaceKit; options: SurfaceBackdropProps } = $props();
+  // svelte-ignore state_referenced_locally
+  const ctx = kit.lc.getChartContext(); // once, at setup: a context is only readable then (kit never changes)
+  const uid = $props.id();
+  const clip = `sdv-surface-${uid.replace(/[^\w-]/g, "")}`;
+  const scene = $derived.by(() => {
+    const { league, ...o } = options;
+    return kit.scene(league, o as never);
+  });
+  const markup = $derived(surfaceMarkup(ctx, kit, scene));
+</script>
+
+{#if markup !== null}
+  <g data-sdv-surface="" class="sdv-surface">
+    <defs>
+      <clipPath id={clip}>
+        <rect x="0" y="0" width={ctx.width} height={ctx.height} />
+      </clipPath>
+    </defs>
+    <!-- sporty's own SVG, its text and colours escaped by toSVG -->
+    <g clip-path="url(#{clip})">{@html markup}</g>
+  </g>
+{/if}

package/dist/svelte/Surface.svelte.d.ts

@@ -0,0 +1,9 @@
+import { type SurfaceBackdropProps, type SurfaceKit } from "../svelte-core.js";
+type $$ComponentProps = {
+    kit: SurfaceKit;
+    options: SurfaceBackdropProps;
+};
+declare const Surface: import("svelte").Component<$$ComponentProps, {}, "">;
+type Surface = ReturnType<typeof Surface>;
+export default Surface;
+//# sourceMappingURL=Surface.svelte.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Surface.svelte.d.ts","sourceRoot":"","sources":["../../src/svelte/Surface.svelte.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,oBAAoB,EAAE,KAAK,UAAU,EAAiB,MAAM,mBAAmB,CAAC;AAE7F,KAAK,gBAAgB,GAAI;IAAE,GAAG,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,oBAAoB,CAAA;CAAE,CAAC;AAiC7E,QAAA,MAAM,OAAO,sDAAwC,CAAC;AACtD,KAAK,OAAO,GAAG,UAAU,CAAC,OAAO,OAAO,CAAC,CAAC;AAC1C,eAAe,OAAO,CAAC"}

package/dist/svelte/SurfaceBackdrop.svelte

@@ -0,0 +1,26 @@
+<!--
+@component
+  A team-painted court, field or rink under a LayerChart chart's marks: a child of its `<Svg>` layer, before the
+  marks. It is drawn in the chart's x/y units: set `xDomain` / `yDomain` to the surface's bbox (sporty's
+  `surface(...).bbox`) to fill the plot area. Both scales must be linear and unreversed (otherwise nothing is drawn,
+  with one warning). layerchart and `@sportsdataverse/sporty` load on first render; either missing throws then.
+-->
+<script lang="ts">
+  import { type SurfaceBackdropProps, type SurfaceKit, loadSurfaceKit, raise } from "../svelte-core.js";
+  import Surface from "./Surface.svelte";
+
+  let props: SurfaceBackdropProps = $props();
+  let kit = $state<SurfaceKit>();
+  let failed = $state<{ error: unknown }>();
+  // a failed import is rethrown from the template (an effect), where a <svelte:boundary> catches it
+  loadSurfaceKit().then(
+    (k) => (kit = k),
+    (error: unknown) => (failed = { error }),
+  );
+</script>
+
+{#if failed}
+  {raise(failed.error)}
+{:else if kit}
+  <Surface {kit} options={props} />
+{/if}

package/dist/svelte/SurfaceBackdrop.svelte.d.ts

@@ -0,0 +1,11 @@
+import { type SurfaceBackdropProps } from "../svelte-core.js";
+/**
+ * A team-painted court, field or rink under a LayerChart chart's marks: a child of its `<Svg>` layer, before the
+ * marks. It is drawn in the chart's x/y units: set `xDomain` / `yDomain` to the surface's bbox (sporty's
+ * `surface(...).bbox`) to fill the plot area. Both scales must be linear and unreversed (otherwise nothing is drawn,
+ * with one warning). layerchart and `@sportsdataverse/sporty` load on first render; either missing throws then.
+ */
+declare const SurfaceBackdrop: import("svelte").Component<SurfaceBackdropProps, {}, "">;
+type SurfaceBackdrop = ReturnType<typeof SurfaceBackdrop>;
+export default SurfaceBackdrop;
+//# sourceMappingURL=SurfaceBackdrop.svelte.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SurfaceBackdrop.svelte.d.ts","sourceRoot":"","sources":["../../src/svelte/SurfaceBackdrop.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,oBAAoB,EAA0C,MAAM,mBAAmB,CAAC;AA0BtG;;;;;GAKG;AACH,QAAA,MAAM,eAAe,0DAAwC,CAAC;AAC9D,KAAK,eAAe,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC;AAC1D,eAAe,eAAe,CAAC"}

package/dist/svelte/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Svelte 5 components for LayerChart: team logos and player headshots as marks, a team-painted surface as a
+ * backdrop, and team colours for the series. Each component is a child of a LayerChart chart's `<Svg>` layer; it
+ * loads layerchart (an optional peer) when it first renders, never on import. Call `loadLeague(league)` /
+ * `preloadAll()` first, as for the other adapters.
+ * @packageDocumentation
+ */
+export { default as HeadshotMark } from "./HeadshotMark.svelte.js";
+export { default as LogoMark } from "./LogoMark.svelte.js";
+export { default as SurfaceBackdrop } from "./SurfaceBackdrop.svelte.js";
+export { embedSources, teamColorPalette } from "../svelte-core.js";
+export type { HeadshotMarkProps, LogoMarkProps, Row, SurfaceBackdropProps, TeamColorPaletteOptions, } from "../svelte-core.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/svelte/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACnE,YAAY,EACV,iBAAiB,EACjB,aAAa,EACb,GAAG,EACH,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,mBAAmB,CAAC"}

package/dist/svelte/index.js

@@ -0,0 +1,11 @@
+/**
+ * Svelte 5 components for LayerChart: team logos and player headshots as marks, a team-painted surface as a
+ * backdrop, and team colours for the series. Each component is a child of a LayerChart chart's `<Svg>` layer; it
+ * loads layerchart (an optional peer) when it first renders, never on import. Call `loadLeague(league)` /
+ * `preloadAll()` first, as for the other adapters.
+ * @packageDocumentation
+ */
+export { default as HeadshotMark } from "./HeadshotMark.svelte";
+export { default as LogoMark } from "./LogoMark.svelte";
+export { default as SurfaceBackdrop } from "./SurfaceBackdrop.svelte";
+export { embedSources, teamColorPalette } from "../svelte-core.js";

package/dist/svelte-core.d.ts

@@ -0,0 +1,139 @@
+import { H as HeadshotOptions, R as Row, M as MarkOptions } from './_web-D7Aa5Rd8.js';
+export { e as embedSources } from './_web-D7Aa5Rd8.js';
+import { K as Kind } from './placement-UWkqUzpa.js';
+import { S as SurfaceSceneOptions } from './surfaces-W-odWLpT.js';
+import { M as MarkType, L as League, S as SeasonInput, W as Which, I as IdSystem } from './types-C7n6gJF3.js';
+import './resolve-CQW-jzvr.js';
+import '@sportsdataverse/sporty';
+
+/**
+ * What the `sdvplot/svelte` components compute, as plain TypeScript (tsup builds it to dist/svelte-core.js, which the
+ * components built by svelte-package import as ../svelte-core.js). Internal: not a package subpath; `sdvplot/svelte`
+ * re-exports the public part. layerchart, sporty and the surface code are imported here only, and only lazily.
+ */
+
+/** `<LogoMark>` props: the shared mark options (`x`, `y`, `team`, `league`, `height` a fraction of the plot height,
+ *  ...) plus the rows to mark and the mark type. */
+interface LogoMarkProps extends MarkOptions {
+    /** The rows to mark. Default: the chart's own `data`. */
+    data?: readonly Row[];
+    /** "logo" (default) or "wordmark". */
+    markType?: MarkType;
+}
+/** `<HeadshotMark>` props: the shared headshot options (`x`, `y`, `player`, `league`, `height`, ...) plus the rows. */
+interface HeadshotMarkProps extends HeadshotOptions {
+    /** The rows to mark. Default: the chart's own `data`. */
+    data?: readonly Row[];
+}
+/**
+ * `<SurfaceBackdrop>` props: the league whose surface to draw and how to paint it (the options of sdvplot's other
+ * `surface` functions). The sporty-specific options are typed loosely, so these types never name
+ * `@sportsdataverse/sporty` (an optional peer); sporty checks them when the surface is built.
+ */
+interface SurfaceBackdropProps {
+    /** The league whose court, field or rink to draw, e.g. "nba". */
+    league: League;
+    /** The team whose colours paint the surface. */
+    team?: string | number;
+    /** The season the team's colours are taken from. */
+    season?: SeasonInput;
+    /** Overrides on top of the team painting, keyed by sporty colour key (e.g. `{ painted_area: "#0e2240" }`). */
+    colorUpdates?: Readonly<Record<string, string>>;
+    /** Degrees to rotate the surface by. */
+    rotation?: number;
+    /** A sporty display range for the league's sport, e.g. "defense"; one the sport does not know throws. */
+    displayRange?: string;
+    xlim?: readonly [number, number];
+    ylim?: readonly [number, number];
+    units?: "ft" | "m" | "yd" | "in" | "cm" | "mm";
+    /** Sporty parameter overrides for the league's surface. */
+    updates?: Readonly<Record<string, unknown>>;
+    arcResolution?: number;
+    xTrans?: number;
+    yTrans?: number;
+}
+/** A LayerChart scale: what the marks call (a d3 scale; a band scale has a bandwidth). */
+interface ChartScale {
+    (v: unknown): unknown;
+    domain(): unknown[];
+    bandwidth?: () => number;
+}
+/** The part of LayerChart's chart context the components read: the scales, the plot area's size and the data. */
+interface ChartContext {
+    xScale: ChartScale;
+    yScale: ChartScale;
+    width: number;
+    height: number;
+    data?: unknown;
+}
+/** The part of the layerchart module the components use. */
+interface LayerChart {
+    getChartContext(): ChartContext;
+}
+/** layerchart, imported on first use (never with `sdvplot/svelte`); a missing peer rejects with an install message. */
+declare function loadLayerChart(component: string): Promise<LayerChart>;
+/** Throws `e`: a component rethrows a failed import from its template (an effect), so a `<svelte:boundary>` catches
+ *  it (an error thrown from a promise callback would bypass the boundary). */
+declare function raise(e: unknown): never;
+/** An `<image>` to draw: its attributes, including the `data-sdv-*` stamps `sdvplot/testing`'s `drawnMarks` reads. */
+interface MarkImage {
+    key: string;
+    attrs: Record<string, string | number>;
+}
+/**
+ * The images a mark component draws in the chart `ctx`: one per row whose team (or player) has an image, centred on
+ * the row's scaled (x, y), `height` of the plot area tall. A row with no image is skipped with one warning (placeSync),
+ * as `sdvplot/echarts` does. Nothing is drawn before the chart has a size.
+ */
+declare function markImages(ctx: ChartContext, kind: Kind, o: LogoMarkProps | HeadshotMarkProps): MarkImage[];
+/** The surface code (sdvplot's surfaces, sporty's SVG writer) and layerchart, imported when a backdrop first renders. */
+interface SurfaceKit {
+    lc: LayerChart;
+    scene(league: League, o: SurfaceSceneOptions): {
+        bbox: readonly [number, number, number, number];
+    };
+    toSVG(scene: never, o: {
+        width: number;
+        height: number;
+    }): string;
+}
+declare function loadSurfaceKit(): Promise<SurfaceKit>;
+/**
+ * The backdrop's SVG over the plot area: the scene's bbox mapped through the chart's scales, so the surface's units
+ * land on the axes'. A scale that is not numeric, reversed or not linear draws nothing (one warning): a mirrored or
+ * stretched court would mislead.
+ */
+declare function surfaceMarkup(ctx: ChartContext, kit: SurfaceKit, scene: ReturnType<SurfaceKit["scene"]>): string | null;
+/** `teamColorPalette` options. */
+interface TeamColorPaletteOptions {
+    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: a LayerChart series' `color`, a `<Spline stroke>`, or the chart's `cRange`. With
+ * `background`, every colour keeps 3:1 contrast against it (dark mode) and aims to stay distinct from the others (when
+ * it cannot, it keeps the readable colour and warns once).
+ *
+ * @example
+ * ```ts
+ * import { loadLeague } from "@sportsdataverse/sdvplot";
+ * import { teamColorPalette } from "@sportsdataverse/sdvplot/svelte";
+ *
+ * await loadLeague("nfl");
+ * teamColorPalette("nfl", ["KC", "LAC", "DEN", "LV"], { background: "#181a1b" });
+ * ```
+ */
+declare function teamColorPalette(league: League, teams: readonly unknown[], o?: TeamColorPaletteOptions): string[];
+
+export { type ChartContext, type ChartScale, type HeadshotMarkProps, type LayerChart, type LogoMarkProps, type MarkImage, Row, type SurfaceBackdropProps, type SurfaceKit, type TeamColorPaletteOptions, loadLayerChart, loadSurfaceKit, markImages, raise, surfaceMarkup, teamColorPalette };

package/dist/svelte-core.js

@@ -0,0 +1,123 @@
+import { markPlacements, aspect, imageSource, colorPalette } from './chunk-UL5M6KDE.js';
+export { embedSources } from './chunk-UL5M6KDE.js';
+import { checkHeight, checkAlpha, placedName } from './chunk-7ULOCCFL.js';
+import './chunk-ZAEQXFJM.js';
+import './chunk-J6R2LEJ7.js';
+import { warn, OptionalDependencyError } from './chunk-E7G7VSLV.js';
+
+// src/svelte-core.ts
+var missing = (component, peer, e) => new OptionalDependencyError(
+  `${component} needs the optional peer ${peer}, which could not be loaded: pnpm add ${peer}`,
+  { cause: e }
+);
+var layerchart;
+function loadLayerChart(component) {
+  layerchart ??= import('layerchart');
+  return layerchart.catch((e) => {
+    layerchart = void 0;
+    throw missing(component, "layerchart", e);
+  });
+}
+function raise(e) {
+  throw e;
+}
+var finite = (v) => typeof v === "number" && Number.isFinite(v);
+function pixel(scale, v) {
+  const at = scale(v);
+  return finite(at) ? at + (scale.bandwidth?.() ?? 0) / 2 : void 0;
+}
+var stamp = (v) => String(v instanceof Date ? v.getTime() : v);
+function markImages(ctx, kind, o) {
+  const h = checkHeight(o.height ?? 0.1);
+  const alpha = checkAlpha(o.alpha ?? 1);
+  const rows = o.data ?? (Array.isArray(ctx.data) ? ctx.data : []);
+  if (!(ctx.height > 0)) return [];
+  const size = h * ctx.height;
+  const ps = markPlacements(rows, kind, o);
+  const raw = kind === "headshot" ? o.player : o.team;
+  return ps.flatMap((p) => {
+    const cx = pixel(ctx.xScale, p.x);
+    const cy = pixel(ctx.yScale, p.y);
+    if (cx === void 0 || cy === void 0) return [];
+    const w = size * aspect(p);
+    return [
+      {
+        key: `${p.index}:${p.id}`,
+        attrs: {
+          href: imageSource(p, o.embed),
+          x: cx - w / 2,
+          y: cy - size / 2,
+          width: w,
+          height: size,
+          preserveAspectRatio: "xMidYMid meet",
+          ...alpha === 1 ? {} : { opacity: alpha },
+          role: "img",
+          "aria-label": `${placedName(p, o.league, rows[p.index]?.[raw])} ${kind}`,
+          "data-sdv-id": p.id,
+          "data-sdv-kind": kind,
+          "data-sdv-x": stamp(p.x),
+          "data-sdv-y": stamp(p.y),
+          "data-sdv-frame": ctx.height
+        }
+      }
+    ];
+  });
+}
+async function loadSurfaceKit() {
+  const [lc, surfaces, svg] = await Promise.all([
+    loadLayerChart("SurfaceBackdrop"),
+    import('./surfaces-MIG7HOFU.js').catch((e) => {
+      throw missing("SurfaceBackdrop", "@sportsdataverse/sporty", e);
+    }),
+    import('@sportsdataverse/sporty/svg').catch((e) => {
+      throw missing("SurfaceBackdrop", "@sportsdataverse/sporty", e);
+    })
+  ]);
+  return {
+    lc,
+    scene: surfaces.surfaceScene,
+    toSVG: svg.toSVG
+  };
+}
+function surfaceMarkup(ctx, kit, scene) {
+  if (!(ctx.width > 0 && ctx.height > 0)) return null;
+  const [sx, sy] = [ctx.xScale, ctx.yScale];
+  const numeric = (s) => s.bandwidth === void 0 && s.domain().every(finite);
+  if (!numeric(sx) || !numeric(sy)) {
+    warn(
+      "svelte:SurfaceBackdrop:domain",
+      "SurfaceBackdrop draws nothing: both scales must be numeric (linear), in the surface's units"
+    );
+    return null;
+  }
+  const linear = (s, dir) => {
+    const [d0, d1] = s.domain();
+    const [a, m, b] = [d0, (d0 + d1) / 2, d1].map((v) => Number(s(v)));
+    return dir * (b - a) * Math.sign(d1 - d0) > 0 && Math.abs(m - (a + b) / 2) < 0.5;
+  };
+  if (!linear(sx, 1) || !linear(sy, -1)) {
+    warn(
+      "svelte:SurfaceBackdrop:scale",
+      "SurfaceBackdrop draws nothing on a reversed or log scale: use linear, unreversed scales"
+    );
+    return null;
+  }
+  const [x0, y0, x1, y1] = scene.bbox;
+  const [left, right, top, bottom] = [sx(x0), sx(x1), sy(y1), sy(y0)].map(Number);
+  const [width, height] = [right - left, bottom - top];
+  if (!(width > 0 && height > 0)) {
+    warn(
+      "svelte:SurfaceBackdrop:empty",
+      `SurfaceBackdrop draws nothing: the surface spans ${width} x ${height} px`
+    );
+    return null;
+  }
+  return kit.toSVG(scene, { width, height }).replace("<svg ", `<svg x="${left}" y="${top}" preserveAspectRatio="none" `);
+}
+function teamColorPalette(league, teams, o = {}) {
+  return colorPalette(league, teams, o);
+}
+
+export { loadLayerChart, loadSurfaceKit, markImages, raise, surfaceMarkup, teamColorPalette };
+//# sourceMappingURL=svelte-core.js.map
+//# sourceMappingURL=svelte-core.js.map

package/dist/svelte-core.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/svelte-core.ts"],"names":[],"mappings":"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","file":"svelte-core.js","sourcesContent":["/**\n * What the `sdvplot/svelte` components compute, as plain TypeScript (tsup builds it to dist/svelte-core.js, which the\n * components built by svelte-package import as ../svelte-core.js). Internal: not a package subpath; `sdvplot/svelte`\n * re-exports the public part. layerchart, sporty and the surface code are imported here only, and only lazily.\n */\nimport {\n  type HeadshotOptions,\n  type MarkOptions,\n  type Row,\n  aspect,\n  colorPalette,\n  imageSource,\n  markPlacements,\n} from \"./_web.js\";\nimport { OptionalDependencyError, warn } from \"./errors.js\";\nimport { type Kind, type Placement, checkAlpha, checkHeight, placedName } from \"./placement.js\";\nimport type { SurfaceSceneOptions } from \"./surfaces.js\";\nimport type { IdSystem, League, MarkType, SeasonInput, Which } from \"./types.js\";\nexport type { Row } from \"./_web.js\";\nexport { embedSources } from \"./_web.js\"; // public via sdvplot/svelte: build `embed` with it, as for the other adapters\n\n/** `<LogoMark>` props: the shared mark options (`x`, `y`, `team`, `league`, `height` a fraction of the plot height,\n *  ...) plus the rows to mark and the mark type. */\nexport interface LogoMarkProps extends MarkOptions {\n  /** The rows to mark. Default: the chart's own `data`. */\n  data?: readonly Row[];\n  /** \"logo\" (default) or \"wordmark\". */\n  markType?: MarkType;\n}\n/** `<HeadshotMark>` props: the shared headshot options (`x`, `y`, `player`, `league`, `height`, ...) plus the rows. */\nexport interface HeadshotMarkProps extends HeadshotOptions {\n  /** The rows to mark. Default: the chart's own `data`. */\n  data?: readonly Row[];\n}\n/**\n * `<SurfaceBackdrop>` props: the league whose surface to draw and how to paint it (the options of sdvplot's other\n * `surface` functions). The sporty-specific options are typed loosely, so these types never name\n * `@sportsdataverse/sporty` (an optional peer); sporty checks them when the surface is built.\n */\nexport interface SurfaceBackdropProps {\n  /** The league whose court, field or rink to draw, e.g. \"nba\". */\n  league: League;\n  /** The team whose colours paint the surface. */\n  team?: string | number;\n  /** The season the team's colours are taken from. */\n  season?: SeasonInput;\n  /** Overrides on top of the team painting, keyed by sporty colour key (e.g. `{ painted_area: \"#0e2240\" }`). */\n  colorUpdates?: Readonly<Record<string, string>>;\n  /** Degrees to rotate the surface by. */\n  rotation?: number;\n  /** A sporty display range for the league's sport, e.g. \"defense\"; one the sport does not know throws. */\n  displayRange?: string;\n  xlim?: readonly [number, number];\n  ylim?: readonly [number, number];\n  units?: \"ft\" | \"m\" | \"yd\" | \"in\" | \"cm\" | \"mm\";\n  /** Sporty parameter overrides for the league's surface. */\n  updates?: Readonly<Record<string, unknown>>;\n  arcResolution?: number;\n  xTrans?: number;\n  yTrans?: number;\n}\n\n/** A LayerChart scale: what the marks call (a d3 scale; a band scale has a bandwidth). */\nexport interface ChartScale {\n  (v: unknown): unknown;\n  domain(): unknown[];\n  bandwidth?: () => number;\n}\n/** The part of LayerChart's chart context the components read: the scales, the plot area's size and the data. */\nexport interface ChartContext {\n  xScale: ChartScale;\n  yScale: ChartScale;\n  width: number;\n  height: number;\n  data?: unknown;\n}\n/** The part of the layerchart module the components use. */\nexport interface LayerChart {\n  getChartContext(): ChartContext;\n}\n\nconst missing = (component: string, peer: string, e: unknown): OptionalDependencyError =>\n  new OptionalDependencyError(\n    `${component} needs the optional peer ${peer}, which could not be loaded: pnpm add ${peer}`,\n    { cause: e },\n  );\nlet layerchart: Promise<LayerChart> | undefined;\n/** layerchart, imported on first use (never with `sdvplot/svelte`); a missing peer rejects with an install message. */\nexport function loadLayerChart(component: string): Promise<LayerChart> {\n  layerchart ??= import(\"layerchart\") as Promise<LayerChart>;\n  return layerchart.catch((e: unknown) => {\n    layerchart = undefined; // installed later (a dev server): the next render tries again\n    throw missing(component, \"layerchart\", e);\n  });\n}\n/** Throws `e`: a component rethrows a failed import from its template (an effect), so a `<svelte:boundary>` catches\n *  it (an error thrown from a promise callback would bypass the boundary). */\nexport function raise(e: unknown): never {\n  throw e;\n}\n\n/** An `<image>` to draw: its attributes, including the `data-sdv-*` stamps `sdvplot/testing`'s `drawnMarks` reads. */\nexport interface MarkImage {\n  key: string;\n  attrs: Record<string, string | number>;\n}\nconst finite = (v: unknown): v is number => typeof v === \"number\" && Number.isFinite(v);\n/** A value's pixel on a scale: the middle of its band on a band scale. undefined off the scale. */\nfunction pixel(scale: ChartScale, v: unknown): number | undefined {\n  const at = scale(v);\n  return finite(at) ? at + (scale.bandwidth?.() ?? 0) / 2 : undefined;\n}\n/** A data value as the `data-sdv-x/y` text drawnMarks reads back: a Date as its time in ms (as sdvplot/plot). */\nconst stamp = (v: unknown): string => String(v instanceof Date ? v.getTime() : v);\n\n/**\n * The images a mark component draws in the chart `ctx`: one per row whose team (or player) has an image, centred on\n * the row's scaled (x, y), `height` of the plot area tall. A row with no image is skipped with one warning (placeSync),\n * as `sdvplot/echarts` does. Nothing is drawn before the chart has a size.\n */\nexport function markImages(ctx: ChartContext, kind: Kind, o: LogoMarkProps | HeadshotMarkProps): MarkImage[] {\n  const h = checkHeight(o.height ?? 0.1);\n  const alpha = checkAlpha(o.alpha ?? 1);\n  const rows = o.data ?? (Array.isArray(ctx.data) ? (ctx.data as Row[]) : []);\n  if (!(ctx.height > 0)) return [];\n  const size = h * ctx.height;\n  const ps: Placement[] = markPlacements(rows, kind, o);\n  const raw = kind === \"headshot\" ? (o as HeadshotMarkProps).player : (o as LogoMarkProps).team;\n  return ps.flatMap((p) => {\n    const cx = pixel(ctx.xScale, p.x);\n    const cy = pixel(ctx.yScale, p.y);\n    if (cx === undefined || cy === undefined) return [];\n    const w = size * aspect(p);\n    return [\n      {\n        key: `${p.index}:${p.id}`,\n        attrs: {\n          href: imageSource(p, o.embed),\n          x: cx - w / 2,\n          y: cy - size / 2,\n          width: w,\n          height: size,\n          preserveAspectRatio: \"xMidYMid meet\",\n          ...(alpha === 1 ? {} : { opacity: alpha }),\n          role: \"img\",\n          \"aria-label\": `${placedName(p, o.league, rows[p.index]?.[raw])} ${kind}`,\n          \"data-sdv-id\": p.id,\n          \"data-sdv-kind\": kind,\n          \"data-sdv-x\": stamp(p.x),\n          \"data-sdv-y\": stamp(p.y),\n          \"data-sdv-frame\": ctx.height,\n        },\n      },\n    ];\n  });\n}\n\n/** The surface code (sdvplot's surfaces, sporty's SVG writer) and layerchart, imported when a backdrop first renders. */\nexport interface SurfaceKit {\n  lc: LayerChart;\n  scene(league: League, o: SurfaceSceneOptions): { bbox: readonly [number, number, number, number] };\n  toSVG(scene: never, o: { width: number; height: number }): string;\n}\nexport async function loadSurfaceKit(): Promise<SurfaceKit> {\n  const [lc, surfaces, svg] = await Promise.all([\n    loadLayerChart(\"SurfaceBackdrop\"),\n    import(\"./surfaces.js\").catch((e: unknown) => {\n      throw missing(\"SurfaceBackdrop\", \"@sportsdataverse/sporty\", e);\n    }),\n    import(\"@sportsdataverse/sporty/svg\").catch((e: unknown) => {\n      throw missing(\"SurfaceBackdrop\", \"@sportsdataverse/sporty\", e);\n    }),\n  ]);\n  return {\n    lc,\n    scene: surfaces.surfaceScene,\n    toSVG: svg.toSVG as unknown as SurfaceKit[\"toSVG\"],\n  };\n}\n\n/**\n * The backdrop's SVG over the plot area: the scene's bbox mapped through the chart's scales, so the surface's units\n * land on the axes'. A scale that is not numeric, reversed or not linear draws nothing (one warning): a mirrored or\n * stretched court would mislead.\n */\nexport function surfaceMarkup(\n  ctx: ChartContext,\n  kit: SurfaceKit,\n  scene: ReturnType<SurfaceKit[\"scene\"]>,\n): string | null {\n  if (!(ctx.width > 0 && ctx.height > 0)) return null;\n  const [sx, sy] = [ctx.xScale, ctx.yScale];\n  const numeric = (s: ChartScale): boolean => s.bandwidth === undefined && s.domain().every(finite);\n  if (!numeric(sx) || !numeric(sy)) {\n    warn(\n      \"svelte:SurfaceBackdrop:domain\",\n      \"SurfaceBackdrop draws nothing: both scales must be numeric (linear), in the surface's units\",\n    );\n    return null;\n  }\n  // x grows left to right and y bottom to top in pixels, each linearly: its midpoint lands half way\n  const linear = (s: ChartScale, dir: 1 | -1): boolean => {\n    const [d0, d1] = s.domain() as [number, number];\n    const [a, m, b] = [d0, (d0 + d1) / 2, d1].map((v) => Number(s(v))) as [number, number, number];\n    return dir * (b - a) * Math.sign(d1 - d0) > 0 && Math.abs(m - (a + b) / 2) < 0.5;\n  };\n  if (!linear(sx, 1) || !linear(sy, -1)) {\n    warn(\n      \"svelte:SurfaceBackdrop:scale\",\n      \"SurfaceBackdrop draws nothing on a reversed or log scale: use linear, unreversed scales\",\n    );\n    return null;\n  }\n  const [x0, y0, x1, y1] = scene.bbox;\n  const [left, right, top, bottom] = [sx(x0), sx(x1), sy(y1), sy(y0)].map(Number) as [\n    number,\n    number,\n    number,\n    number,\n  ];\n  const [width, height] = [right - left, bottom - top];\n  if (!(width > 0 && height > 0)) {\n    warn(\n      \"svelte:SurfaceBackdrop:empty\",\n      `SurfaceBackdrop draws nothing: the surface spans ${width} x ${height} px`,\n    );\n    return null;\n  }\n  // toSVG maps the scene's bbox onto its own viewport; placed and stretched over the bbox's pixel rectangle, the\n  // surface's units land on the scales' (strokes stay 1 px: non-scaling)\n  return kit\n    .toSVG(scene as never, { width, height })\n    .replace(\"<svg \", `<svg x=\"${left}\" y=\"${top}\" preserveAspectRatio=\"none\" `);\n}\n\n/** `teamColorPalette` options. */\nexport interface TeamColorPaletteOptions {\n  which?: Which;\n  season?: SeasonInput;\n  idSystem?: IdSystem;\n  /** The colour of an unresolved team. Default \"#808080\". */\n  fallback?: string;\n  /**\n   * The chart's background. Given, a team colour under 3:1 contrast against it is swapped for the team's other\n   * colour, else moved towards white (on a dark background) or black (a light one) until it reads: dark mode. A\n   * colour that would then sit too close to an earlier team's (CIE76 ΔE under 20) takes the team's other colour, or\n   * the nearest colour to its own (lightness, hue or chroma stepped) that is distinct and still reads; failing that it\n   * is kept, with one warning.\n   */\n  background?: string;\n}\n/**\n * One colour per team, in order: a LayerChart series' `color`, a `<Spline stroke>`, or the chart's `cRange`. With\n * `background`, every colour keeps 3:1 contrast against it (dark mode) and aims to stay distinct from the others (when\n * it cannot, it keeps the readable colour and warns once).\n *\n * @example\n * ```ts\n * import { loadLeague } from \"@sportsdataverse/sdvplot\";\n * import { teamColorPalette } from \"@sportsdataverse/sdvplot/svelte\";\n *\n * await loadLeague(\"nfl\");\n * teamColorPalette(\"nfl\", [\"KC\", \"LAC\", \"DEN\", \"LV\"], { background: \"#181a1b\" });\n * ```\n */\nexport function teamColorPalette(\n  league: League,\n  teams: readonly unknown[],\n  o: TeamColorPaletteOptions = {},\n): string[] {\n  return colorPalette(league, teams, o);\n}\n"]}