@sportsdataverse/sdvplot 0.0.0-stage → 0.2.0

package/dist/maplibre.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/maplibre.ts"],"names":[],"mappings":"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","file":"maplibre.js","sourcesContent":["/**\n * The MapLibre GL JS 6 adapter: team logos as a native `symbol` layer (`logoSymbols`, with `addLogoImages` to load\n * each logo once into the map's images), team-coloured travel lines as a `line` layer (`routeLines`), and a free,\n * keyless basemap (`basemap`, OpenFreeMap). Each builder returns plain style JSON: a GeoJSON source and a layer that\n * reads it, for `map.addSource(set.id, set.source)` and `map.addLayer(set.layer)`. Pure: `maplibre-gl` (an optional\n * peer, 6.14 or later) is never imported at runtime, only its types; the map is passed in. For deck.gl layers on a\n * MapLibre map, hand `@sportsdataverse/sdvplot/deckgl`'s `logoIconLayer` / `passArcLayer` props to deck.gl's layers\n * inside `@deck.gl/mapbox`'s `MapboxOverlay`. Synchronous builders: call after `loadLeague(league)` / `preloadAll()`.\n */\nimport type {\n  GeoJSONSourceSpecification,\n  LineLayerSpecification,\n  Map as MapLibreMap,\n  SymbolLayerSpecification,\n} from \"maplibre-gl\";\nimport { type DrawnMark, type Row, checkAlpha, colorPalette, column, markPlacements } from \"./_web.js\";\nimport { contentId } from \"./content-id.js\";\nimport { InputError, warn } from \"./errors.js\";\nimport { normValue } from \"./normalize.js\";\nimport { type Value, resolveSync } from \"./resolve.js\";\nimport type { IdSystem, League, SeasonInput, Variant, Which } from \"./types.js\";\n\nexport type { DrawnMark, Row } from \"./_web.js\";\n\n/** `logoSymbols` options. */\nexport interface LogoSymbolOptions {\n  /** Name of the row column holding each logo's longitude. */\n  x: string;\n  /** Name of the row column holding each logo's latitude. */\n  y: string;\n  /** Name of the row column holding the team (abbreviation, name or id, a number or a string; see `idSystem`). */\n  team: string;\n  /** The league the teams belong to, e.g. \"nfl\". */\n  league: League;\n  /** A season (number or string) for every row, or the name of a row column holding each row's season. */\n  season?: SeasonInput;\n  /** Logo variant, e.g. \"dark\". Default \"default\". */\n  variant?: Variant;\n  /** How the `team` values are read. Default \"auto\". */\n  idSystem?: IdSystem;\n  /** The logo's height on screen in px, 1 or more. Default 32. */\n  size?: number;\n  /** The logos' opacity in [0, 1] (`icon-opacity`). Default 1. */\n  alpha?: number;\n  /** The source and layer id. Default \"sdvplot-logos\". */\n  id?: string;\n}\n/** A logo feature's properties. */\nexport interface LogoProperties {\n  /** The resolved team id. */\n  team: string;\n  /** The map image the symbol draws (`icon-image`), one per logo and size. */\n  icon: string;\n  /** The logo's URL. */\n  url: string;\n  /** The row's position in the input (left-out rows leave gaps). */\n  index: number;\n}\n/** One logo the map needs as an image: `addLogoImages` loads `url` and adds it as `id`, drawn `height` px tall. */\nexport interface LogoImage {\n  id: string;\n  url: string;\n  height: number;\n}\n/** A GeoJSON point: [longitude, latitude]. */\nexport interface PointGeometry {\n  type: \"Point\";\n  coordinates: [lon: number, lat: number];\n}\n/** A GeoJSON line through [longitude, latitude] positions. */\nexport interface LineGeometry {\n  type: \"LineString\";\n  coordinates: [lon: number, lat: number][];\n}\n/** A GeoJSON feature; its id is the row's index in the input. */\nexport interface Feature<G, P> {\n  type: \"Feature\";\n  id: number;\n  geometry: G;\n  properties: P;\n}\n/** A GeoJSON source holding a feature collection: `map.addSource(id, source)`. */\nexport type FeatureSource<G, P> = GeoJSONSourceSpecification & {\n  type: \"geojson\";\n  data: { type: \"FeatureCollection\"; features: Feature<G, P>[] };\n};\n/** `logoSymbols`' result: a source and a symbol layer for the map, and the images that layer draws. */\nexport interface LogoSymbols {\n  /** The source id (the layer's own id too). */\n  id: string;\n  /** One point feature per drawn row; the feature id is the row's index. */\n  source: FeatureSource<PointGeometry, LogoProperties>;\n  layer: SymbolLayerSpecification;\n  /** One per distinct logo: what `addLogoImages` loads. */\n  images: LogoImage[];\n}\n\n/** `routeLines` options. */\nexport interface RouteLineOptions {\n  /** Name of the row column holding each leg's start longitude. */\n  x: string;\n  /** Name of the row column holding each leg's start latitude. */\n  y: string;\n  /** Name of the row column holding each leg's end longitude. */\n  xend: string;\n  /** Name of the row column holding each leg's end latitude. */\n  yend: string;\n  /** Name of the row column holding the team the leg is coloured by. */\n  team: string;\n  /** The league the teams belong to, e.g. \"nfl\". */\n  league: League;\n  /** The season the teams are resolved for. */\n  season?: SeasonInput;\n  /** How the `team` values are read. Default \"auto\". */\n  idSystem?: IdSystem;\n  /** \"primary\" (default) or \"secondary\" colour. */\n  which?: Which;\n  /**\n   * The basemap's background (`basemap(\"dark\").background` under the dark basemap). Given, every team colour keeps 3:1\n   * contrast against it and aims to stay distinct from the other teams' (CIE76 ΔE of 20 or more), through the shared\n   * team palette, as `teamColorPalette` does in the other adapters.\n   */\n  background?: string;\n  /** The colour of a team that does not resolve, or has no colour. Default \"#808080\". */\n  fallback?: string;\n  /** The line's width in px, 1 or more. Default 3. */\n  width?: number;\n  /** The lines' opacity in [0, 1] (`line-opacity`). Default 1. */\n  alpha?: number;\n  /** The source and layer id. Default \"sdvplot-routes\". */\n  id?: string;\n}\n/** A route feature's properties. */\nexport interface RouteProperties {\n  /** The resolved team id, or the row's own value as text when it does not resolve. */\n  team: string;\n  /** The line's colour, `#rrggbb`. */\n  color: string;\n  /** The row's position in the input (left-out rows leave gaps). */\n  index: number;\n}\n/** `routeLines`' result: a source and a line layer for the map. */\nexport interface RouteLines {\n  id: string;\n  /** One two-point line per drawn row; the feature id is the row's index. */\n  source: FeatureSource<LineGeometry, RouteProperties>;\n  layer: LineLayerSpecification;\n}\n\n/** The map methods `addLogoImages` calls: a MapLibre `Map`. */\nexport type LogoImageMap = Pick<MapLibreMap, \"loadImage\" | \"addImage\" | \"hasImage\">;\n\nconst real = (v: unknown): v is number => typeof v === \"number\" && Number.isFinite(v);\n/**\n * A longitude or latitude as a number: a finite number, or a string that reads as one (\"-94.7\", as a CSV gives it).\n * Anything else (missing, blank, not a number, infinite) is null: the row is left out.\n */\nfunction coord(v: unknown): number | null {\n  const n = typeof v === \"number\" ? v : typeof v === \"string\" && v.trim() !== \"\" ? Number(v) : Number.NaN;\n  return Number.isFinite(n) ? n : null;\n}\n/** One warning for the rows left out for a coordinate, naming their teams. */\nfunction skippedRows(key: string, what: string, teams: readonly Value[]): void {\n  if (teams.length === 0) return;\n  const shown =\n    teams.slice(0, 10).map(String).join(\", \") + (teams.length > 10 ? ` and ${teams.length - 10} more` : \"\");\n  warn(`${key}:${shown}`, `skipped ${teams.length} ${what} with a missing coordinate: ${shown}`);\n}\nfunction checkPx(name: string, v: unknown): number {\n  if (!real(v) || v < 1) throw new InputError(`${name} is in px, 1 or more, got ${String(v)}`);\n  return v;\n}\n\n/**\n * Each row's team logo at its (longitude, latitude), as a GeoJSON source and a MapLibre `symbol` layer: one point\n * feature per row (its `id` is the row's index; `team`, `icon`, `url` and `index` are its properties), and a layer\n * drawing `icon-image: [\"get\", \"icon\"]`, every logo shown even where two overlap. A team with no logo (or one that\n * does not resolve) is left out with one warning; so is a row with a missing, non-numeric or infinite coordinate (a\n * numeric string such as \"-94.7\" is read as its number). Team values may be numbers or strings (ESPN ids,\n * abbreviations, names). The map needs the logos as images first:\n * `await addLogoImages(map, logos)`, then `map.addSource(logos.id, logos.source)` and `map.addLayer(logos.layer)`.\n *\n * @example\n * ```ts\n * import { loadLeague } from \"@sportsdataverse/sdvplot\";\n * import { logoSymbols } from \"@sportsdataverse/sdvplot/maplibre\";\n *\n * await loadLeague(\"nfl\");\n * // Kansas City's home airport, from nflverse's nfldata airports.csv\n * const logos = logoSymbols([{ team: \"KC\", lon: -94.714, lat: 39.297 }], {\n *   x: \"lon\",\n *   y: \"lat\",\n *   team: \"team\",\n *   league: \"nfl\",\n *   size: 40,\n * });\n * // in the browser: await addLogoImages(map, logos); map.addSource(logos.id, logos.source); map.addLayer(logos.layer)\n * logos.source.data.features[0]?.properties.icon;\n * ```\n */\nexport function logoSymbols(rows: readonly Row[], o: LogoSymbolOptions): LogoSymbols {\n  const size = checkPx(\"size\", o.size ?? 32);\n  const opacity = checkAlpha(o.alpha ?? 1);\n  const id = o.id ?? \"sdvplot-logos\";\n  const images = new Map<string, LogoImage>();\n  // placeSync leaves out a null or NaN coordinate; a value that is not a number, or not finite, is left out here\n  const placed = markPlacements(rows, \"logo\", o);\n  const at = placed.map((p) => [coord(p.x), coord(p.y)] as const);\n  skippedRows(\n    `maplibre:logos:${o.league}:missing`,\n    \"logo(s)\",\n    placed.filter((_, k) => at[k]?.includes(null)).map((p) => p.id),\n  );\n  const features = placed.flatMap((p, k): Feature<PointGeometry, LogoProperties>[] => {\n    const [lon, lat] = at[k] as readonly [number | null, number | null];\n    if (lon === null || lat === null) return [];\n    const icon = `${contentId(\"sdv-logo\", p.url)}-${size}`;\n    if (!images.has(icon)) images.set(icon, { id: icon, url: p.url, height: size });\n    return [\n      {\n        type: \"Feature\",\n        id: p.index,\n        geometry: { type: \"Point\", coordinates: [lon, lat] },\n        properties: { team: p.id, icon, url: p.url, index: p.index },\n      },\n    ];\n  });\n  return {\n    id,\n    source: { type: \"geojson\", data: { type: \"FeatureCollection\", features } },\n    layer: {\n      id,\n      type: \"symbol\",\n      source: id,\n      layout: {\n        \"icon-image\": [\"get\", \"icon\"],\n        \"icon-allow-overlap\": true,\n        \"icon-ignore-placement\": true,\n      },\n      paint: { \"icon-opacity\": opacity },\n    },\n    images: [...images.values()],\n  };\n}\n\n/**\n * Loads each logo of `logoSymbols` sets into the map's images, once: `map.loadImage(url)`, then\n * `map.addImage(id, image, { pixelRatio })`, the pixel ratio making the image draw `size` px tall at icon size 1 (and\n * stay sharp on a high-density screen). An image the map already has is skipped, so calling it again adds nothing\n * twice. `map.setStyle` drops the map's images, sources and layers: on the map's `style.load` event, call it again\n * (it adds back only what the new style lacks) and re-add the source and layer. A logo that fails to load is left undrawn with one\n * warning. Resolves when every image is in. Call it before adding the layers that draw them.\n *\n * @example\n * ```ts\n * import { loadLeague } from \"@sportsdataverse/sdvplot\";\n * import { addLogoImages, logoSymbols } from \"@sportsdataverse/sdvplot/maplibre\";\n *\n * await loadLeague(\"nfl\");\n * const logos = logoSymbols([{ team: \"KC\", lon: -94.714, lat: 39.297 }], { x: \"lon\", y: \"lat\", team: \"team\", league: \"nfl\" });\n * // a stand-in for a MapLibre map (in the browser: the map from `new maplibregl.Map(...)`, once it has loaded)\n * const added: string[] = [];\n * const map = {\n *   hasImage: (id: string) => added.includes(id),\n *   loadImage: async () => ({ data: { width: 500, height: 500 } as ImageBitmap }),\n *   addImage(id: string) {\n *     added.push(id);\n *     return this;\n *   },\n * };\n * await addLogoImages(map as never, logos);\n * added;\n * ```\n */\nexport async function addLogoImages(map: LogoImageMap, ...sets: readonly LogoSymbols[]): Promise<void> {\n  const want = new Map(sets.flatMap((s) => s.images).map((im) => [im.id, im]));\n  await Promise.all(\n    [...want.values()].map(async (im) => {\n      if (map.hasImage(im.id)) return;\n      let image: HTMLImageElement | ImageBitmap;\n      try {\n        image = (await map.loadImage(im.url)).data;\n      } catch (e) {\n        warn(`maplibre:image:${im.url}`, `could not load the logo ${im.url}: ${String(e)}`);\n        return;\n      }\n      if (map.hasImage(im.id)) return; // another call added it while this one loaded\n      map.addImage(im.id, image, { pixelRatio: image.height / im.height });\n    }),\n  );\n}\n\n/** An unresolved team value as text: a number without \".0\", a missing one empty (as `./deckgl`'s arcs). */\nconst label = (t: unknown): string =>\n  t === null || t === undefined ? \"\" : typeof t === \"number\" ? (normValue(t) ?? \"\") : String(t);\n\n/**\n * Team-coloured travel legs as a GeoJSON source and a MapLibre `line` layer: one straight line per row from (x, y) to\n * (xend, yend) in longitude and latitude, in the team's colour (`line-color: [\"get\", \"color\"]`). Each team keeps one\n * colour, from the shared team palette; with `background` the colours read on the basemap (dark mode) and stay\n * distinct. A team that does not resolve takes `fallback`. A coordinate may be a number or a numeric string, as for\n * `logoSymbols`; a row with a missing, non-numeric or infinite one is left out with one warning. The feature id is the row's index. The same rows feed `./deckgl`'s `passArcLayer` for arcs instead.\n *\n * @example\n * ```ts\n * import { loadLeague } from \"@sportsdataverse/sdvplot\";\n * import { routeLines } from \"@sportsdataverse/sdvplot/maplibre\";\n *\n * await loadLeague(\"nfl\");\n * // Kansas City to Buffalo, airport to airport (nflverse nfldata airports.csv): week 11 of 2024\n * const leg = { team: \"KC\", lon: -94.714, lat: 39.297, lon_end: -78.732, lat_end: 42.94 };\n * const routes = routeLines([leg], { x: \"lon\", y: \"lat\", xend: \"lon_end\", yend: \"lat_end\", team: \"team\", league: \"nfl\" });\n * // in the browser: map.addSource(routes.id, routes.source); map.addLayer(routes.layer)\n * routes.source.data.features[0]?.properties.color;\n * ```\n */\nexport function routeLines(rows: readonly Row[], o: RouteLineOptions): RouteLines {\n  const width = checkPx(\"width\", o.width ?? 3);\n  const opacity = checkAlpha(o.alpha ?? 1);\n  const id = o.id ?? \"sdvplot-routes\";\n  const cols = [o.x, o.y, o.xend, o.yend].map((c, k) =>\n    column(rows, c, [\"x\", \"y\", \"xend\", \"yend\"][k] as string),\n  );\n  const teams = column(rows, o.team, \"team\");\n  // each row's four coordinates as numbers (a numeric string is read as one), or null\n  const at = rows.map((_, i) => cols.map((c) => coord(c[i])));\n  const keep = rows.flatMap((_, i) => (at[i]?.includes(null) ? [] : [i]));\n  skippedRows(\n    `maplibre:routes:${o.league}:missing`,\n    \"route leg(s)\",\n    rows.flatMap((_, i) => (at[i]?.includes(null) ? [teams[i] as Value] : [])),\n  );\n  const kept = keep.map((i) => teams[i] as Value);\n  const ro = {\n    ...(o.season === undefined ? {} : { season: o.season }),\n    ...(o.idSystem === undefined ? {} : { idSystem: o.idSystem }),\n  };\n  const resolved = resolveSync(kept, o.league, ro);\n  // keyed by the resolved team, so 12 and \"12\" (or \"KC\" and 12) are one team with one colour\n  const keys = kept.map((t, j) => resolved[j] ?? `?${label(t)}`);\n  const distinct = [...new Set(keys)];\n  const known = distinct.filter((k) => !k.startsWith(\"?\"));\n  const palette = colorPalette(o.league, known, {\n    ...ro,\n    idSystem: \"team_id\",\n    ...(o.which === undefined ? {} : { which: o.which }),\n    ...(o.background === undefined ? {} : { background: o.background }),\n    ...(o.fallback === undefined ? {} : { fallback: o.fallback }),\n  });\n  const colorOf = new Map(known.map((k, j) => [k, palette[j] as string]));\n  const fallback = o.fallback ?? \"#808080\";\n  const features = keep.map((i, j): Feature<LineGeometry, RouteProperties> => {\n    const c = at[i] as number[];\n    return {\n      type: \"Feature\",\n      id: i,\n      geometry: {\n        type: \"LineString\",\n        coordinates: [\n          [c[0] as number, c[1] as number],\n          [c[2] as number, c[3] as number],\n        ],\n      },\n      properties: {\n        team: resolved[j] ?? label(kept[j]),\n        color: colorOf.get(keys[j] as string) ?? fallback,\n        index: i,\n      },\n    };\n  });\n  return {\n    id,\n    source: { type: \"geojson\", data: { type: \"FeatureCollection\", features } },\n    layer: {\n      id,\n      type: \"line\",\n      source: id,\n      layout: { \"line-cap\": \"round\", \"line-join\": \"round\" },\n      paint: { \"line-color\": [\"get\", \"color\"], \"line-width\": width, \"line-opacity\": opacity },\n    },\n  };\n}\n\n/** OpenFreeMap's credit, exactly as its TileJSON (`https://tiles.openfreemap.org/planet`) gives it (read 2026-10-27). */\nconst OPENFREEMAP_ATTRIBUTION =\n  '<a href=\"https://openfreemap.org\" target=\"_blank\">OpenFreeMap</a> <a href=\"https://www.openmaptiles.org/\" target=\"_blank\">&copy; OpenMapTiles</a> Data from <a href=\"https://www.openstreetmap.org/copyright\" target=\"_blank\">OpenStreetMap</a>';\n\n/** `basemap`'s result. */\nexport interface Basemap {\n  /** The style URL, for the map's `style` option. */\n  style: string;\n  /**\n   * The provider's credit (HTML). MapLibre shows it by itself from the style's source, in its attribution control (on\n   * by default; keep it). Anything else that draws these tiles, or a static export of the map, must show it.\n   */\n  attribution: string;\n  /**\n   * The colour of the style's `background` layer, the land (read from the style on 2026-10-27), for `routeLines`' and\n   * `passArcLayer`'s `background` (dark mode). Their 3:1 contrast is measured against it, not against the water,\n   * which is a little lighter on the dark style (#1b1b1d) and a little darker on the light one (#c2c8ca).\n   */\n  background: string;\n}\nconst STYLES = {\n  light: { style: \"https://tiles.openfreemap.org/styles/positron\", background: \"#f2f3f0\" },\n  dark: { style: \"https://tiles.openfreemap.org/styles/dark\", background: \"#0c0c0c\" },\n} as const;\n\n/**\n * A free basemap that needs no API key: OpenFreeMap's `positron` (light) or `dark` vector style, built from\n * OpenStreetMap data. Pass `style` to `new maplibregl.Map({ style })`. OpenFreeMap's public instance asks for no\n * registration or key and sets no request limit; the credit is required, and MapLibre's attribution control shows it\n * from the style's source (`attribution` is the same text, for anything else). Each map view requests the\n * provider's tiles: build or test pages without a map, or serve a local style.\n *\n * @example\n * ```ts\n * import { basemap } from \"@sportsdataverse/sdvplot/maplibre\";\n *\n * const { style, background } = basemap(\"dark\");\n * // in the browser: new maplibregl.Map({ container, style, center: [-96, 38], zoom: 3 })\n * [style, background];\n * ```\n */\nexport function basemap(theme: \"light\" | \"dark\" = \"light\"): Basemap {\n  const s = STYLES[theme];\n  if (s === undefined) throw new InputError(`theme is \"light\" or \"dark\", got ${JSON.stringify(theme)}`);\n  return { ...s, attribution: OPENFREEMAP_ATTRIBUTION };\n}\n\n/**\n * What `logoSymbols` sets draw, as `[team, longitude, latitude, px, url]` per feature, in order: the module's test\n * hook, as the other adapters' `drawnMarks`.\n *\n * @example\n * ```ts\n * import { loadLeague } from \"@sportsdataverse/sdvplot\";\n * import { drawnMarks, logoSymbols } from \"@sportsdataverse/sdvplot/maplibre\";\n *\n * await loadLeague(\"nfl\");\n * // 12 is Kansas City's ESPN team id\n * drawnMarks(logoSymbols([{ team: 12, lon: -94.714, lat: 39.297 }], { x: \"lon\", y: \"lat\", team: \"team\", league: \"nfl\" }));\n * ```\n */\nexport function drawnMarks(...sets: readonly LogoSymbols[]): DrawnMark[] {\n  return sets.flatMap((s) => {\n    const px = new Map(s.images.map((im) => [im.id, im.height]));\n    return s.source.data.features.map(\n      (f): DrawnMark => [\n        f.properties.team,\n        f.geometry.coordinates[0],\n        f.geometry.coordinates[1],\n        px.get(f.properties.icon) as number,\n        f.properties.url,\n      ],\n    );\n  });\n}\n"]}

package/dist/marks-DH-tQIP-.d.ts

@@ -0,0 +1,75 @@
+import { R as ResolveOptions, V as Value } from './resolve-CQW-jzvr.js';
+import { W as Which, L as League, S as SeasonInput, V as Variant, M as MarkType, I as IdSystem, a as MarkRow } from './types-C7n6gJF3.js';
+
+interface ColorOptions extends ResolveOptions {
+    which?: Which;
+}
+type ColorResult<T> = T extends readonly Value[] ? (string | undefined)[] : string | undefined;
+/**
+ * `{team: "#hex"}` for a league. Without `teams`: keyed by abbr, or team_id where abbr is null/shared (one warning).
+ * With `teams`: keyed by the caller's own values; first team wins on a reused value.
+ *
+ * @example
+ * ```ts
+ * import { palette } from "@sportsdataverse/sdvplot";
+ *
+ * await palette("nfl", ["KC", "BUF", "PHI"]);
+ * ```
+ */
+declare function palette(league: League, teams?: Value | readonly Value[], opts?: ColorOptions): Promise<Record<string, string>>;
+/** One `#hex` (or undefined) per team value, in the container the values came in. Call after the league is loaded. */
+declare function teamColorsSync<T extends Value | readonly Value[]>(league: League, teams: T, opts?: ColorOptions): ColorResult<T>;
+/**
+ * Team colour(s), loading the league first: one team gives one `#hex` (or `undefined`), an array gives one per team.
+ * `which: "secondary"` picks the second colour; an unknown team gives `undefined` and one warning.
+ *
+ * @example
+ * ```ts
+ * import { teamColors } from "@sportsdataverse/sdvplot";
+ *
+ * await teamColors("nba", ["LAL", "BOS"], { which: "secondary" });
+ * ```
+ */
+declare function teamColors<T extends Value | readonly Value[]>(league: League, teams: T, opts?: ColorOptions): Promise<ColorResult<T>>;
+
+interface SelectOptions {
+    season?: SeasonInput;
+    variant?: Variant;
+    markType?: MarkType;
+}
+interface LogoUrlOptions extends SelectOptions {
+    idSystem?: IdSystem;
+    strict?: boolean;
+}
+/** Port of `select_mark` (post-preload): requested variant, then (keeping polarity) default / polarity variants, then any; within each, season-covering rows (dated before open-ended), else the best row. Rows are already ranked best-first. */
+declare function selectMarkSync(team: Value, league: League, o?: SelectOptions): MarkRow | undefined;
+declare function selectMark(team: Value, league: League, o?: SelectOptions): Promise<MarkRow | undefined>;
+/** Port of `logo_url` (post-preload): archive URL of the team's logo/wordmark for the season; `undefined` for an unknown team (the resolver warns) or when no mark of that type exists (one warning). */
+declare function logoUrlSync(team: Value, league: League, o?: LogoUrlOptions): string | undefined;
+/**
+ * Archive URL of a team's logo (or wordmark, `markType`) for the season, loading the league first; `undefined` for an
+ * unknown team (the resolver warns) or when no mark of that type is archived (one warning).
+ *
+ * @example
+ * ```ts
+ * import { logoUrl } from "@sportsdataverse/sdvplot";
+ *
+ * await logoUrl("KC", "nfl", { markType: "wordmark" });
+ * ```
+ */
+declare function logoUrl(team: Value, league: League, o?: LogoUrlOptions): Promise<string | undefined>;
+/**
+ * Every archived mark for one team, best first (logos and wordmarks, every variant and source).
+ * Default: the committed shard (deduped, ranked rows). `full: true` fetches the CDN manifest lazily (once per process)
+ * and returns every manifest row for the team, including rows the shard dedupe dropped; a failed download throws
+ * `DownloadError`. Both paths filter on the team only. `fetch` overrides the global fetch for the manifest download.
+ * Throws `UnresolvedTeamError` when the team is null or does not resolve (strict, as Python).
+ */
+declare function marks(team: Value, league: League, o?: {
+    season?: SeasonInput;
+    idSystem?: IdSystem;
+    full?: boolean;
+    fetch?: typeof fetch;
+}): Promise<readonly MarkRow[]>;
+
+export { type ColorOptions as C, type LogoUrlOptions as L, type SelectOptions as S, type ColorResult as a, logoUrlSync as b, selectMarkSync as c, teamColorsSync as d, logoUrl as l, marks as m, palette as p, selectMark as s, teamColors as t };