@sportsdataverse/sdvplot 0.0.0-stage → 0.1.0

package/dist/export.js

@@ -0,0 +1,258 @@
+import { roundHalfEven, onColor } from './chunk-J6R2LEJ7.js';
+import { InputError, OptionalDependencyError, warn, DownloadError } from './chunk-E7G7VSLV.js';
+
+// src/export/index.ts
+var GRAVITY = [
+  "center",
+  "north",
+  "south",
+  "east",
+  "west",
+  "northwest",
+  "northeast",
+  "southwest",
+  "southeast"
+];
+function parseGravity(gravity) {
+  const g = String(gravity).toLowerCase();
+  const hit = GRAVITY.find((x) => x === g);
+  if (hit === void 0)
+    throw new InputError(`gravity must be one of ${GRAVITY.join(", ")}, got ${JSON.stringify(gravity)}`);
+  return hit;
+}
+function checkColor(name, value) {
+  if (!/^[#a-zA-Z0-9(),.%/ -]+$/.test(value))
+    throw new InputError(`${name} must be a CSS color, got ${JSON.stringify(value)}`);
+  return value;
+}
+var pyFloat = (s) => Number(typeof s === "string" ? s.replace(/(?<=\d)_(?=\d)/g, "") : s);
+function parseAspect(aspect) {
+  let ratio = Number.NaN;
+  if (typeof aspect === "string" && /[:x]/.test(aspect)) {
+    const parts = aspect.split(/[:x]/);
+    if (parts.length === 2) ratio = pyFloat(parts[0]) / pyFloat(parts[1]);
+  } else if (typeof aspect === "number" || typeof aspect === "string") ratio = pyFloat(aspect);
+  if (!(ratio > 0 && Number.isFinite(ratio))) {
+    throw new InputError(
+      `aspect could not be read as a ratio: got ${String(aspect)}; use "1:1", "16:9", "4x5" or a number like 1.91`
+    );
+  }
+  return ratio;
+}
+function canvasFor(width, height, ratio) {
+  return width / height > ratio ? [width, roundHalfEven(width / ratio)] : [roundHalfEven(height * ratio), height];
+}
+function offsetFor(dx, dy, gravity) {
+  const x = gravity.endsWith("west") ? 0 : gravity.endsWith("east") ? dx : Math.floor(dx / 2);
+  const y = gravity.startsWith("north") ? 0 : gravity.startsWith("south") ? dy : Math.floor(dy / 2);
+  return [x, y];
+}
+var SVG_NS = "http://www.w3.org/2000/svg";
+var XLINK_NS = "http://www.w3.org/1999/xlink";
+var OPEN_TAG = /<svg\b[^>]*>/i;
+var attrOf = (tag, name) => new RegExp(`\\s${name}=["']([^"']+)["']`, "i").exec(tag)?.[1];
+var userUnits = (v) => Number(v?.trim().replace(/px$/i, "") || Number.NaN);
+function svgSize(svg) {
+  const open = OPEN_TAG.exec(svg)?.[0];
+  if (!open) throw new InputError("socialCard: no <svg> root element");
+  const vb = attrOf(open, "viewBox");
+  const parts = vb?.trim().split(/[\s,]+/).map(Number);
+  const w = userUnits(attrOf(open, "width"));
+  const h = userUnits(attrOf(open, "height"));
+  const width = Number.isFinite(w) ? w : parts?.[2];
+  const height = Number.isFinite(h) ? h : parts?.[3];
+  if (width === void 0 || height === void 0 || !(width > 0) || !(height > 0)) {
+    throw new InputError("socialCard: the <svg> needs width/height attributes or a viewBox");
+  }
+  return { width, height, viewBox: vb ?? `0 0 ${width} ${height}` };
+}
+function socialCard(svg, { aspect = "1:1", padding = 60, background = "white", gravity = "center", color } = {}) {
+  const ratio = parseAspect(aspect);
+  const place = parseGravity(gravity);
+  checkColor("background", background);
+  if (color !== void 0) checkColor("color", color);
+  if (!(Number.isFinite(padding) && padding >= 0))
+    throw new InputError(`padding must be a non-negative number of pixels, got ${String(padding)}`);
+  const pad = Math.trunc(padding);
+  const { width, height, viewBox } = svgSize(svg);
+  const [cw, ch] = canvasFor(width + 2 * pad, height + 2 * pad, ratio);
+  const [ox, oy] = offsetFor(cw - (width + 2 * pad), ch - (height + 2 * pad), place);
+  const ink = color ?? (/^#(?:[0-9a-f]{3}){1,2}$/i.test(background) ? onColor(background) : void 0);
+  const open = OPEN_TAG.exec(svg)?.[0] ?? "<svg>";
+  const stripped = open.replace(/\s(?:x|y|width|height|viewBox)=["'][^"']*["']/gi, "");
+  const inner = svg.replace(
+    open,
+    () => stripped.replace(
+      /^<svg/i,
+      () => `<svg x="${ox + pad}" y="${oy + pad}" width="${width}" height="${height}" viewBox="${viewBox}"`
+    )
+  );
+  const inked = ink === void 0 ? "" : ` color="${ink}"`;
+  return `<svg xmlns="${SVG_NS}"${inked} width="${cw}" height="${ch}" viewBox="0 0 ${cw} ${ch}"><rect width="${cw}" height="${ch}" fill="${background}"/>${inner}</svg>`;
+}
+function peerMissing(e, name) {
+  const quoted = new RegExp(`['"]${name.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}['"]`);
+  return e instanceof Error && (/MODULE_NOT_FOUND/.test(String(e.code)) && quoted.test(e.message) || peerMissing(e.cause, name));
+}
+async function download(url) {
+  let r;
+  try {
+    r = await fetch(url);
+    if (r.ok) return new Uint8Array(await r.arrayBuffer());
+  } catch (e) {
+    throw Object.assign(new DownloadError(`toPNG could not download ${url}: ${String(e)}`, url), {
+      cause: e
+    });
+  }
+  throw new DownloadError(`toPNG could not download ${url}: it answered ${r.status}`, url, r.status);
+}
+var FETCH_LIMIT = 8;
+async function mapLimit(xs, limit, fn) {
+  const out = new Array(xs.length);
+  let next = 0;
+  const worker = async () => {
+    while (next < xs.length) {
+      const i = next++;
+      try {
+        out[i] = await fn(xs[i]);
+      } catch (e) {
+        next = xs.length;
+        throw e;
+      }
+    }
+  };
+  await Promise.all(Array.from({ length: Math.min(limit, xs.length) }, worker));
+  return out;
+}
+var hrefAttr = (url) => {
+  const re = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  return new RegExp(`(href=)(["'])(?:${re(url)}|${re(url.replaceAll("&", "&amp;"))})\\2`, "g");
+};
+async function toPNG(svg, { width, scale = 1, background, color, images = "fetch", fonts = {} } = {}) {
+  if (!(Number.isFinite(scale) && scale > 0))
+    throw new InputError(`scale must be a positive number, got ${String(scale)}`);
+  if (width !== void 0 && !(Number.isFinite(width) && width > 0))
+    throw new InputError(`width must be a positive number of pixels, got ${String(width)}`);
+  if (background !== void 0) checkColor("background", background);
+  if (color !== void 0) checkColor("color", color);
+  if (images !== "fetch" && images !== "skip")
+    throw new InputError(`images must be "fetch" or "skip", got ${JSON.stringify(images)}`);
+  const font = await fontOptions(fonts);
+  let text = typeof svg === "string" ? svg : svg.outerHTML;
+  const mod = await import('@resvg/resvg-js').catch((e) => {
+    throw new OptionalDependencyError(
+      peerMissing(e, "@resvg/resvg-js") ? "toPNG needs the optional peer @resvg/resvg-js, which is not installed: pnpm add @resvg/resvg-js" : `toPNG could not load the optional peer @resvg/resvg-js (installed, but it failed to load): ${String(e)}`,
+      { cause: e }
+    );
+  });
+  const fitTo = width !== void 0 ? { mode: "width", value: Math.round(width * scale) } : { mode: "zoom", value: scale };
+  const opts = { fitTo, font, ...background !== void 0 && { background } };
+  const open = OPEN_TAG.exec(text)?.[0];
+  if (open !== void 0) {
+    let add = "";
+    if (!/\sxmlns=/i.test(open)) add += ` xmlns="${SVG_NS}"`;
+    if (/\sxlink:[\w-]+=/i.test(text) && !/\sxmlns:xlink=/i.test(open)) add += ` xmlns:xlink="${XLINK_NS}"`;
+    let ink = color;
+    if (ink === void 0 && background !== void 0 && !/\scolor=/i.test(open) && /currentcolor/i.test(text)) {
+      const p = new mod.Resvg(`<svg xmlns="${SVG_NS}" width="1" height="1"/>`, { background }).render().pixels;
+      ink = onColor(`#${[p[0], p[1], p[2]].map((v) => (v ?? 0).toString(16).padStart(2, "0")).join("")}`);
+    }
+    let tag = open;
+    if (ink !== void 0) {
+      tag = tag.replace(/\scolor=["'][^"']*["']/i, "");
+      add += ` color="${ink}"`;
+    }
+    text = text.replace(open, () => tag.replace(/^<svg/i, () => `<svg${add}`));
+  }
+  const probe = new mod.Resvg(text, NO_FONTS);
+  const hrefs = [...new Set(probe.imagesToResolve())];
+  let bodies = [];
+  if (hrefs.length > 0 && images === "skip") {
+    warn(
+      `toPNG:skip:${hrefs.join(" ")}`,
+      `toPNG left out ${hrefs.length} remote image(s): ${hrefs.join(", ")}`
+    );
+  } else if (hrefs.length > 0) {
+    bodies = await mapLimit(hrefs, FETCH_LIMIT, download);
+    const zoom = fitTo.mode === "width" ? fitTo.value / probe.width : scale;
+    const tags = text.match(/<image\b[^>]*>/gi) ?? [];
+    for (const [i, href] of hrefs.entries()) {
+      const b = bodies[i];
+      let uri = dataURI(b);
+      const re = hrefAttr(href);
+      const small = shrink(
+        mod,
+        uri,
+        tags.filter((t) => t.search(re) >= 0),
+        zoom
+      );
+      if (small !== void 0) uri = dataURI(small);
+      text = text.replace(re, (_m, attr, q) => `${attr}${q}${uri}${q}`);
+    }
+  }
+  const resvg = new mod.Resvg(text, opts);
+  if (bodies.length > 0) {
+    const left = new Set(resvg.imagesToResolve());
+    for (const [i, href] of hrefs.entries())
+      if (left.has(href)) resvg.resolveImage(href, Buffer.from(bodies[i]));
+  }
+  return new Uint8Array(resvg.render().asPng());
+}
+var NO_FONTS = { font: { loadSystemFonts: false } };
+async function fontOptions(fonts) {
+  if (typeof fonts !== "object" || fonts === null || Array.isArray(fonts))
+    throw new InputError(
+      `fonts must be an object { files, defaultFamily, system }, got ${JSON.stringify(fonts)}`
+    );
+  const { files = [], defaultFamily, system = true } = fonts;
+  if (!Array.isArray(files) || files.some((f) => typeof f !== "string"))
+    throw new InputError(`fonts.files must be an array of font file paths, got ${JSON.stringify(files)}`);
+  if (defaultFamily !== void 0 && typeof defaultFamily !== "string")
+    throw new InputError(`fonts.defaultFamily must be a string, got ${JSON.stringify(defaultFamily)}`);
+  if (typeof system !== "boolean")
+    throw new InputError(`fonts.system must be a boolean, got ${JSON.stringify(system)}`);
+  if (files.length > 0) {
+    const { statSync } = await import('fs');
+    for (const f of files)
+      if (!statSync(f, { throwIfNoEntry: false })?.isFile())
+        throw new InputError(`fonts.files: no font file at ${JSON.stringify(f)}`);
+  }
+  return {
+    loadSystemFonts: system,
+    fontFiles: [...files],
+    ...defaultFamily !== void 0 && { defaultFontFamily: defaultFamily }
+  };
+}
+var OVERSAMPLE = 2;
+function shrink(mod, uri, uses, zoom) {
+  if (uses.length < 2) return void 0;
+  let side = 0;
+  for (const tag of uses) {
+    const w2 = userUnits(attrOf(tag, "width"));
+    const h2 = userUnits(attrOf(tag, "height"));
+    if (!(w2 > 0 && h2 > 0)) return void 0;
+    side = Math.max(side, w2, h2);
+  }
+  const own = new mod.Resvg(
+    `<svg xmlns="${SVG_NS}" width="1" height="1"><image href="${uri}"/></svg>`,
+    NO_FONTS
+  ).getBBox();
+  const k = own ? Math.ceil(OVERSAMPLE * zoom * side) / Math.max(own.width, own.height) : 1;
+  if (!own || !(k < 1)) return void 0;
+  const [w, h] = [Math.max(1, Math.round(own.width * k)), Math.max(1, Math.round(own.height * k))];
+  return new mod.Resvg(
+    `<svg xmlns="${SVG_NS}" width="${w}" height="${h}"><image href="${uri}" width="${w}" height="${h}" preserveAspectRatio="none"/></svg>`,
+    NO_FONTS
+  ).render().asPng();
+}
+var dataURI = (b) => `data:${imageType(b)};base64,${Buffer.from(b).toString("base64")}`;
+function imageType(b) {
+  if (new TextDecoder().decode(b.subarray(0, 64)).trimStart().startsWith("<")) return "image/svg+xml";
+  if (b[0] === 255 && b[1] === 216) return "image/jpeg";
+  if (b[0] === 71 && b[1] === 73 && b[2] === 70) return "image/gif";
+  return "image/png";
+}
+
+export { canvasFor, checkColor, offsetFor, parseAspect, parseGravity, peerMissing, socialCard, svgSize, toPNG };
+//# sourceMappingURL=export.js.map
+//# sourceMappingURL=export.js.map

package/dist/export.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/export/index.ts"],"names":["w","h"],"mappings":"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","file":"export.js","sourcesContent":["import { onColor, roundHalfEven } from \"../contrast.js\";\nimport { DownloadError, InputError, OptionalDependencyError, warn } from \"../errors.js\";\n\n/** A canvas ratio, width to height: `\"16:9\"`, `\"4x5\"`, a number such as 1.91, or a numeric string such as `\"1.91\"`. */\nexport type Aspect = \"1:1\" | \"16:9\" | \"4:5\" | \"9:16\" | \"1.91:1\" | number | (string & {});\n/** Where the figure sits on the canvas, as in ImageMagick (and sdvplot/sdvplotR `gt_social_crop`). */\nexport type Gravity =\n  | \"center\"\n  | \"north\"\n  | \"south\"\n  | \"east\"\n  | \"west\"\n  | \"northwest\"\n  | \"northeast\"\n  | \"southwest\"\n  | \"southeast\";\n/** Options for {@link toPNG}. */\nexport interface ToPNGOptions {\n  /** output width in CSS pixels, the height following (multiplied by `scale`); absent: the SVG's own size */\n  width?: number;\n  /** device-pixel multiplier, a positive number; default 1 */\n  scale?: number;\n  /** a color painted under transparent areas; absent: transparent */\n  background?: string;\n  /**\n   * the root `color`, which `currentColor` (Plot's axes and text) resolves to; absent: the SVG's own root `color`, else\n   * black or white, whichever contrasts more with `background` (black when there is no background)\n   */\n  color?: string;\n  /**\n   * remote `<image href=\"http(s)://…\">` (logos, headshots): `\"fetch\"` (default) downloads each once with the global\n   * `fetch` and draws it, a failed download throwing `DownloadError`; `\"skip\"` leaves them out with one warning\n   */\n  images?: \"fetch\" | \"skip\";\n  /**\n   * the fonts `<text>` is drawn with. resvg draws text only in fonts it has loaded, and with none (a host without\n   * system fonts: slim Docker images, minimal CI runners) every label renders as nothing, with no error. `files`: font\n   * files (.ttf, .otf, .ttc) on disk to load, each checked to exist; `defaultFamily`: the family for text whose own\n   * families are not loaded (absent: resvg's choice, the first font loaded); `system`: also load the system fonts,\n   * default true. Absent: the system fonts only.\n   */\n  fonts?: { files?: readonly string[]; defaultFamily?: string; system?: boolean };\n}\n/** Options for {@link socialCard}; defaults are Python/R `gt_social_crop`'s. */\nexport interface SocialCardOptions {\n  /** the canvas ratio; default `\"1:1\"` */\n  aspect?: Aspect;\n  /** pixels left around the figure before the canvas grows to the ratio (truncated to an integer); default 60 */\n  padding?: number;\n  /** the canvas color; default `\"white\"` */\n  background?: string;\n  /** where the padded figure sits on the canvas; default `\"center\"` */\n  gravity?: Gravity;\n  /**\n   * the canvas root `color`, which the figure's `currentColor` (Plot's axes and text) inherits; absent: black or white,\n   * whichever contrasts more with a hex `background` (none for a named background: give `color`, or a hex)\n   */\n  color?: string;\n}\n/** An SVG's size, from its `width`/`height` attributes or else its `viewBox`. */\nexport interface SvgSize {\n  /** user units: the width attribute, else the viewBox width */\n  width: number;\n  /** user units: the height attribute, else the viewBox height */\n  height: number;\n  /** the root viewBox, else `0 0 width height` */\n  viewBox: string;\n}\n\nconst GRAVITY: readonly Gravity[] = [\n  \"center\",\n  \"north\",\n  \"south\",\n  \"east\",\n  \"west\",\n  \"northwest\",\n  \"northeast\",\n  \"southwest\",\n  \"southeast\",\n];\n/** Port of Python `_check_gravity`: one of the nine magick gravities, case-insensitive; anything else is an InputError. */\nexport function parseGravity(gravity: string): Gravity {\n  const g = String(gravity).toLowerCase();\n  const hit = GRAVITY.find((x) => x === g);\n  if (hit === undefined)\n    throw new InputError(`gravity must be one of ${GRAVITY.join(\", \")}, got ${JSON.stringify(gravity)}`);\n  return hit;\n}\n/**\n * A CSS color written into markup: names, hex, rgb()/hsl() (with `/` alpha too); never a quote, angle bracket,\n * semicolon or equals sign.\n */\nexport function checkColor(name: string, value: string): string {\n  if (!/^[#a-zA-Z0-9(),.%/ -]+$/.test(value))\n    throw new InputError(`${name} must be a CSS color, got ${JSON.stringify(value)}`);\n  return value;\n}\n\n/** Python `float()` of a string: an underscore is allowed only between two digits (\"1_0\" is 10). */\nconst pyFloat = (s: string | number): number =>\n  Number(typeof s === \"string\" ? s.replace(/(?<=\\d)_(?=\\d)/g, \"\") : s);\n\n/** Port of Python `_ratio`: \"16:9\", \"4x5\" (exactly two parts) or a positive finite number, numeric strings included. */\nexport function parseAspect(aspect: Aspect): number {\n  let ratio = Number.NaN;\n  if (typeof aspect === \"string\" && /[:x]/.test(aspect)) {\n    const parts = aspect.split(/[:x]/);\n    if (parts.length === 2) ratio = pyFloat(parts[0] as string) / pyFloat(parts[1] as string); // Python `a, b = re.split(...)`\n  } else if (typeof aspect === \"number\" || typeof aspect === \"string\") ratio = pyFloat(aspect); // Python float(\"1.91\")\n  if (!(ratio > 0 && Number.isFinite(ratio))) {\n    throw new InputError(\n      `aspect could not be read as a ratio: got ${String(aspect)}; use \"1:1\", \"16:9\", \"4x5\" or a number like 1.91`,\n    );\n  }\n  return ratio;\n}\n\n/** Port of Python `_canvas`: expand the short side until the ratio is met; never shrink. Rounds half to even (Python/R `round`). */\nexport function canvasFor(width: number, height: number, ratio: number): [number, number] {\n  return width / height > ratio\n    ? [width, roundHalfEven(width / ratio)]\n    : [roundHalfEven(height * ratio), height];\n}\n\n/** Port of Python `_extent` placement: the offset of a figure with `dx`/`dy` spare pixels around it. */\nexport function offsetFor(dx: number, dy: number, gravity: Gravity): [number, number] {\n  const x = gravity.endsWith(\"west\") ? 0 : gravity.endsWith(\"east\") ? dx : Math.floor(dx / 2);\n  const y = gravity.startsWith(\"north\") ? 0 : gravity.startsWith(\"south\") ? dy : Math.floor(dy / 2);\n  return [x, y];\n}\n\nconst SVG_NS = \"http://www.w3.org/2000/svg\";\nconst XLINK_NS = \"http://www.w3.org/1999/xlink\";\nconst OPEN_TAG = /<svg\\b[^>]*>/i;\nconst attrOf = (tag: string, name: string): string | undefined =>\n  new RegExp(`\\\\s${name}=[\"']([^\"']+)[\"']`, \"i\").exec(tag)?.[1];\n/** A plain or `px` length; a percent or relative unit (`em`) is NaN, so the size comes from the viewBox. */\nconst userUnits = (v: string | undefined): number => Number(v?.trim().replace(/px$/i, \"\") || Number.NaN);\n\n/**\n * The root `<svg>`'s size: `width`/`height` attributes in user units or px, else the viewBox's (D3 output often has\n * only a viewBox; a `100%` size is relative to a container a standalone SVG does not have).\n */\nexport function svgSize(svg: string): SvgSize {\n  const open = OPEN_TAG.exec(svg)?.[0];\n  if (!open) throw new InputError(\"socialCard: no <svg> root element\");\n  const vb = attrOf(open, \"viewBox\");\n  const parts = vb\n    ?.trim()\n    .split(/[\\s,]+/)\n    .map(Number);\n  const w = userUnits(attrOf(open, \"width\"));\n  const h = userUnits(attrOf(open, \"height\"));\n  const width = Number.isFinite(w) ? w : parts?.[2];\n  const height = Number.isFinite(h) ? h : parts?.[3];\n  if (width === undefined || height === undefined || !(width > 0) || !(height > 0)) {\n    throw new InputError(\"socialCard: the <svg> needs width/height attributes or a viewBox\");\n  }\n  return { width, height, viewBox: vb ?? `0 0 ${width} ${height}` };\n}\n\n/**\n * Port of sdvplot/sdvplotR `gt_social_crop` framing for an SVG figure: pad, then extend the short side to the ratio\n * (the figure is never cropped). Arguments are checked in Python's order (ratio, gravity, background, padding) before\n * anything is built. A final rescale (`width=` in Python/R) is `toPNG(socialCard(svg), { width })`.\n */\nexport function socialCard(\n  svg: string,\n  { aspect = \"1:1\", padding = 60, background = \"white\", gravity = \"center\", color }: SocialCardOptions = {},\n): string {\n  const ratio = parseAspect(aspect);\n  const place = parseGravity(gravity);\n  checkColor(\"background\", background);\n  if (color !== undefined) checkColor(\"color\", color);\n  if (!(Number.isFinite(padding) && padding >= 0))\n    throw new InputError(`padding must be a non-negative number of pixels, got ${String(padding)}`);\n  const pad = Math.trunc(padding); // Python _pixels: int(whitespace)\n  const { width, height, viewBox } = svgSize(svg);\n  const [cw, ch] = canvasFor(width + 2 * pad, height + 2 * pad, ratio);\n  const [ox, oy] = offsetFor(cw - (width + 2 * pad), ch - (height + 2 * pad), place);\n  // ponytail: contrast is judged for an opaque hex background only; a named one needs `color` (no CSS name table here)\n  const ink = color ?? (/^#(?:[0-9a-f]{3}){1,2}$/i.test(background) ? onColor(background) : undefined);\n  const open = OPEN_TAG.exec(svg)?.[0] ?? \"<svg>\";\n  const stripped = open.replace(/\\s(?:x|y|width|height|viewBox)=[\"'][^\"']*[\"']/gi, \"\");\n  // replacer functions: a `$&`, `$'` or `` $` `` in the figure's own attributes is text, not a replacement pattern\n  const inner = svg.replace(open, () =>\n    stripped.replace(\n      /^<svg/i,\n      () => `<svg x=\"${ox + pad}\" y=\"${oy + pad}\" width=\"${width}\" height=\"${height}\" viewBox=\"${viewBox}\"`,\n    ),\n  );\n  const inked = ink === undefined ? \"\" : ` color=\"${ink}\"`;\n  return `<svg xmlns=\"${SVG_NS}\"${inked} width=\"${cw}\" height=\"${ch}\" viewBox=\"0 0 ${cw} ${ch}\"><rect width=\"${cw}\" height=\"${ch}\" fill=\"${background}\"/>${inner}</svg>`;\n}\n\n/**\n * True when `e` is Node's \"cannot find\" (`ERR_MODULE_NOT_FOUND` / `MODULE_NOT_FOUND`) for the optional peer `name`\n * itself, on the error or under a loader's wrapper (vitest's mock error, say); a file missing inside an installed peer\n * is not.\n *\n * @example\n * ```ts\n * import { createRequire } from \"node:module\";\n * import { peerMissing } from \"@sportsdataverse/sdvplot/export\";\n *\n * // Node's resolver, asked for a package that is not installed, throws MODULE_NOT_FOUND naming it\n * const name = \"@sportsdataverse/no-such-peer\";\n * let error: unknown;\n * try {\n *   createRequire(import.meta.url).resolve(name);\n * } catch (e) {\n *   error = e;\n * }\n * peerMissing(error, name); // true; peerMissing(error, \"@resvg/resvg-js\") is false\n * ```\n */\nexport function peerMissing(e: unknown, name: string): boolean {\n  const quoted = new RegExp(`['\"]${name.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\")}['\"]`);\n  return (\n    e instanceof Error &&\n    ((/MODULE_NOT_FOUND/.test(String((e as { code?: unknown }).code)) && quoted.test(e.message)) ||\n      peerMissing(e.cause, name))\n  );\n}\n\n/** The bytes at `url`; a network failure or a non-2xx answer is a DownloadError. */\nasync function download(url: string): Promise<Uint8Array> {\n  let r: Response;\n  try {\n    r = await fetch(url);\n    if (r.ok) return new Uint8Array(await r.arrayBuffer());\n  } catch (e) {\n    throw Object.assign(new DownloadError(`toPNG could not download ${url}: ${String(e)}`, url), {\n      cause: e,\n    });\n  }\n  throw new DownloadError(`toPNG could not download ${url}: it answered ${r.status}`, url, r.status);\n}\n\n/** At most this many image downloads in flight at once: a figure with hundreds of logos must not open hundreds of sockets. */\nconst FETCH_LIMIT = 8;\n\n/** `fn` over `xs` with at most `limit` calls in flight; results keep input order, and the first failure stops new calls. */\nasync function mapLimit<T, R>(xs: readonly T[], limit: number, fn: (x: T) => Promise<R>): Promise<R[]> {\n  const out = new Array<R>(xs.length);\n  let next = 0;\n  const worker = async (): Promise<void> => {\n    while (next < xs.length) {\n      const i = next++;\n      try {\n        out[i] = await fn(xs[i] as T);\n      } catch (e) {\n        next = xs.length;\n        throw e;\n      }\n    }\n  };\n  await Promise.all(Array.from({ length: Math.min(limit, xs.length) }, worker));\n  return out;\n}\n\n/** `href=\"url\"` / `xlink:href='url'` attributes, the URL as written or with `&` escaped as `&amp;`. */\nconst hrefAttr = (url: string): RegExp => {\n  const re = (s: string) => s.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n  return new RegExp(`(href=)([\"'])(?:${re(url)}|${re(url.replaceAll(\"&\", \"&amp;\"))})\\\\2`, \"g\");\n};\n\n/**\n * Rasterize an SVG with `@resvg/resvg-js` (optional peer; Node only). Throws OptionalDependencyError when it is missing.\n * An HTML-serialized figure (a DOM element or its `outerHTML`, as Observable Plot makes) gets the `xmlns` (and\n * `xmlns:xlink`) declarations it lacks. Remote images are downloaded and drawn unless `images` is `\"skip\"`. Text is\n * drawn in the system fonts; on a host without any, pass `fonts.files` or every label comes out blank.\n *\n * @example\n * ```ts\n * import { dirname, join } from \"node:path\";\n * import { fileURLToPath } from \"node:url\";\n * import { toPNG } from \"@sportsdataverse/sdvplot/export\";\n *\n * // any .ttf/.otf on disk; this one is Source Sans 3 (OFL) from the sdvplot-js repo's examples/fonts\n * const font = join(dirname(fileURLToPath(import.meta.url)), \"../../../../fonts/SourceSans3-Regular.ttf\");\n * const svg = `<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"240\" height=\"60\"><text x=\"8\" y=\"42\" font-size=\"32\">Giants 27</text></svg>`;\n * // the same pixels with or without system fonts: only the given file is loaded\n * await toPNG(svg, { background: \"white\", fonts: { files: [font], system: false } });\n * ```\n */\nexport async function toPNG(\n  svg: string | { outerHTML: string },\n  { width, scale = 1, background, color, images = \"fetch\", fonts = {} }: ToPNGOptions = {},\n): Promise<Uint8Array> {\n  if (!(Number.isFinite(scale) && scale > 0))\n    throw new InputError(`scale must be a positive number, got ${String(scale)}`);\n  if (width !== undefined && !(Number.isFinite(width) && width > 0))\n    throw new InputError(`width must be a positive number of pixels, got ${String(width)}`);\n  if (background !== undefined) checkColor(\"background\", background);\n  if (color !== undefined) checkColor(\"color\", color);\n  if (images !== \"fetch\" && images !== \"skip\")\n    throw new InputError(`images must be \"fetch\" or \"skip\", got ${JSON.stringify(images)}`);\n  const font = await fontOptions(fonts);\n  let text = typeof svg === \"string\" ? svg : svg.outerHTML;\n  const mod = await import(\"@resvg/resvg-js\").catch((e: unknown) => {\n    throw new OptionalDependencyError(\n      peerMissing(e, \"@resvg/resvg-js\")\n        ? \"toPNG needs the optional peer @resvg/resvg-js, which is not installed: pnpm add @resvg/resvg-js\"\n        : `toPNG could not load the optional peer @resvg/resvg-js (installed, but it failed to load): ${String(e)}`,\n      { cause: e },\n    );\n  });\n  const fitTo =\n    width !== undefined\n      ? { mode: \"width\" as const, value: Math.round(width * scale) }\n      : { mode: \"zoom\" as const, value: scale };\n  const opts = { fitTo, font, ...(background !== undefined && { background }) };\n\n  const open = OPEN_TAG.exec(text)?.[0];\n  if (open !== undefined) {\n    let add = \"\";\n    if (!/\\sxmlns=/i.test(open)) add += ` xmlns=\"${SVG_NS}\"`; // resvg parses XML; HTML serialization drops xmlns\n    if (/\\sxlink:[\\w-]+=/i.test(text) && !/\\sxmlns:xlink=/i.test(open)) add += ` xmlns:xlink=\"${XLINK_NS}\"`;\n    let ink = color;\n    if (\n      ink === undefined &&\n      background !== undefined &&\n      !/\\scolor=/i.test(open) &&\n      /currentcolor/i.test(text)\n    ) {\n      // the background as resvg paints it (names and rgb() too): a 1x1 render\n      // ponytail: pixels are premultiplied, so a translucent background is judged as if over black\n      const p = new mod.Resvg(`<svg xmlns=\"${SVG_NS}\" width=\"1\" height=\"1\"/>`, { background }).render()\n        .pixels;\n      ink = onColor(`#${[p[0], p[1], p[2]].map((v) => (v ?? 0).toString(16).padStart(2, \"0\")).join(\"\")}`);\n    }\n    let tag = open;\n    if (ink !== undefined) {\n      tag = tag.replace(/\\scolor=[\"'][^\"']*[\"']/i, \"\"); // an explicit `color` option replaces the figure's own\n      add += ` color=\"${ink}\"`;\n    }\n    text = text.replace(open, () => tag.replace(/^<svg/i, () => `<svg${add}`));\n  }\n\n  // the remote hrefs resvg cannot load itself, from a parse without the system-font scan (text does not change them)\n  const probe = new mod.Resvg(text, NO_FONTS);\n  const hrefs = [...new Set(probe.imagesToResolve())];\n  let bodies: Uint8Array[] = [];\n  if (hrefs.length > 0 && images === \"skip\") {\n    warn(\n      `toPNG:skip:${hrefs.join(\" \")}`,\n      `toPNG left out ${hrefs.length} remote image(s): ${hrefs.join(\", \")}`,\n    );\n  } else if (hrefs.length > 0) {\n    bodies = await mapLimit(hrefs, FETCH_LIMIT, download);\n    const zoom = fitTo.mode === \"width\" ? fitTo.value / probe.width : scale;\n    const tags = text.match(/<image\\b[^>]*>/gi) ?? [];\n    // every image goes in as a data URI, so ONE Resvg draws them all: resolveImage costs ~150 ms a call\n    for (const [i, href] of hrefs.entries()) {\n      const b = bodies[i] as Uint8Array;\n      let uri = dataURI(b);\n      const re = hrefAttr(href);\n      const small = shrink(\n        mod,\n        uri,\n        tags.filter((t) => t.search(re) >= 0),\n        zoom,\n      );\n      if (small !== undefined) uri = dataURI(small);\n      text = text.replace(re, (_m, attr: string, q: string) => `${attr}${q}${uri}${q}`);\n    }\n  }\n  const resvg = new mod.Resvg(text, opts);\n  if (bodies.length > 0) {\n    // an href escaped in a way hrefAttr does not match is still drawn, the slow way (resolveImage: raster only)\n    const left = new Set(resvg.imagesToResolve());\n    for (const [i, href] of hrefs.entries())\n      if (left.has(href)) resvg.resolveImage(href, Buffer.from(bodies[i] as Uint8Array));\n  }\n  return new Uint8Array(resvg.render().asPng());\n}\n\nconst NO_FONTS = { font: { loadSystemFonts: false } };\n\n/** `fonts` as resvg's `font` option; a missing font file is an InputError (resvg would skip it, drawing no text). */\nasync function fontOptions(fonts: ToPNGOptions[\"fonts\"]) {\n  if (typeof fonts !== \"object\" || fonts === null || Array.isArray(fonts))\n    throw new InputError(\n      `fonts must be an object { files, defaultFamily, system }, got ${JSON.stringify(fonts)}`,\n    );\n  const { files = [], defaultFamily, system = true } = fonts;\n  if (!Array.isArray(files) || files.some((f) => typeof f !== \"string\"))\n    throw new InputError(`fonts.files must be an array of font file paths, got ${JSON.stringify(files)}`);\n  if (defaultFamily !== undefined && typeof defaultFamily !== \"string\")\n    throw new InputError(`fonts.defaultFamily must be a string, got ${JSON.stringify(defaultFamily)}`);\n  if (typeof system !== \"boolean\")\n    throw new InputError(`fonts.system must be a boolean, got ${JSON.stringify(system)}`);\n  if (files.length > 0) {\n    const { statSync } = await import(\"node:fs\"); // ponytail: loaded only when files are given; /export is Node-only\n    for (const f of files)\n      if (!statSync(f, { throwIfNoEntry: false })?.isFile())\n        throw new InputError(`fonts.files: no font file at ${JSON.stringify(f)}`);\n  }\n  return {\n    loadSystemFonts: system,\n    fontFiles: [...files],\n    ...(defaultFamily !== undefined && { defaultFontFamily: defaultFamily }),\n  };\n}\n/** A shared image's one raster is this many times its largest box: headroom for a transform that enlarges it. */\nconst OVERSAMPLE = 2;\n\n/**\n * resvg decodes an `<image>` per element, at the image's own size: 2000 uses of a 500 px logo held 2 GB for 6 s (a\n * `<use>` or resolveImage costs the same). An image used more than once is therefore drawn once, at OVERSAMPLE times its\n * largest box in output pixels, and every use inlines that small PNG. A single use keeps the original.\n */\nfunction shrink(\n  mod: typeof import(\"@resvg/resvg-js\"),\n  uri: string,\n  uses: readonly string[],\n  zoom: number,\n): Uint8Array | undefined {\n  if (uses.length < 2) return undefined;\n  let side = 0;\n  for (const tag of uses) {\n    const w = userUnits(attrOf(tag, \"width\"));\n    const h = userUnits(attrOf(tag, \"height\"));\n    // ponytail: a use without a numeric size (auto, %) keeps the full image, and its per-use decode\n    if (!(w > 0 && h > 0)) return undefined;\n    side = Math.max(side, w, h);\n  }\n  // the image's own size, read from its header (an image with no width/height is drawn at it)\n  const own = new mod.Resvg(\n    `<svg xmlns=\"${SVG_NS}\" width=\"1\" height=\"1\"><image href=\"${uri}\"/></svg>`,\n    NO_FONTS,\n  ).getBBox();\n  const k = own ? Math.ceil(OVERSAMPLE * zoom * side) / Math.max(own.width, own.height) : 1;\n  if (!own || !(k < 1)) return undefined;\n  const [w, h] = [Math.max(1, Math.round(own.width * k)), Math.max(1, Math.round(own.height * k))];\n  return new mod.Resvg(\n    `<svg xmlns=\"${SVG_NS}\" width=\"${w}\" height=\"${h}\"><image href=\"${uri}\" width=\"${w}\" height=\"${h}\" preserveAspectRatio=\"none\"/></svg>`,\n    NO_FONTS,\n  )\n    .render()\n    .asPng();\n}\n\nconst dataURI = (b: Uint8Array): string => `data:${imageType(b)};base64,${Buffer.from(b).toString(\"base64\")}`;\n\n/** A downloaded image's data-URI type from its first bytes: SVG markup, JPEG, GIF, else PNG. */\nfunction imageType(b: Uint8Array): string {\n  if (new TextDecoder().decode(b.subarray(0, 64)).trimStart().startsWith(\"<\")) return \"image/svg+xml\";\n  if (b[0] === 0xff && b[1] === 0xd8) return \"image/jpeg\";\n  if (b[0] === 0x47 && b[1] === 0x49 && b[2] === 0x46) return \"image/gif\";\n  return \"image/png\";\n}\n"]}

package/dist/headshots-B2J_LOO8.d.ts

@@ -0,0 +1,40 @@
+import { V as Value } from './resolve-CQW-jzvr.js';
+import { H as HeadshotIdSystem } from './types-C7n6gJF3.js';
+
+/** Port of `_headshots.ESPN_HEADSHOT_LEAGUES`. */
+declare const ESPN_HEADSHOT_LEAGUES: {
+    readonly nfl: "nfl";
+    readonly nba: "nba";
+    readonly wnba: "wnba";
+    readonly mlb: "mlb";
+    readonly nhl: "nhl";
+    readonly cfb: "college-football";
+    readonly mbb: "mens-college-basketball";
+    readonly wbb: "womens-college-basketball";
+};
+/** Leagues with ESPN headshots (gsis ids are nfl-only, and nfl is one of these). */
+type EspnHeadshotLeague = keyof typeof ESPN_HEADSHOT_LEAGUES;
+/** Width / height of a headshot image box (the ESPN combiner crop). */
+declare const HEADSHOT_ASPECT: number;
+declare function nbaHeadshotUrl(id: string | number): string;
+declare function wnbaHeadshotUrl(id: string | number): string;
+declare function mlbHeadshotUrl(id: string | number): string;
+declare function nhlHeadshotUrl(id: string | number): string;
+/** Loads the bundled nflverse gsis map (its own ~3 MB chunk, imported only on demand); required before `headshotUrl(…, { idSystem: "gsis" })`. Nothing is downloaded. */
+declare function loadGsis(): Promise<void>;
+/**
+ * Sync port of `_headshots.headshot_url`. ESPN ids need no data; gsis ids need `await loadGsis()` (or `preloadAll()`)
+ * first.
+ *
+ * @example
+ * ```ts
+ * import { headshotUrl } from "@sportsdataverse/sdvplot";
+ *
+ * headshotUrl("3139477", "nfl"); // Patrick Mahomes, by ESPN athlete id
+ * ```
+ */
+declare function headshotUrl(playerId: Value, league: EspnHeadshotLeague, { idSystem }?: {
+    idSystem?: HeadshotIdSystem;
+}): string | undefined;
+
+export { type EspnHeadshotLeague as E, HEADSHOT_ASPECT as H, ESPN_HEADSHOT_LEAGUES as a, nhlHeadshotUrl as b, headshotUrl as h, loadGsis as l, mlbHeadshotUrl as m, nbaHeadshotUrl as n, wnbaHeadshotUrl as w };

package/dist/index.d.ts

@@ -0,0 +1,182 @@
+import { A as Alias, a as MarkRow, S as SeasonInput, L as League, b as LeagueData, c as Team } from './types-C7n6gJF3.js';
+export { E as EXPLICIT_ONLY, H as HeadshotIdSystem, d as INDEX_VERSION, I as IdSystem, e as LEAGUES, M as MarkType, P as PRIORITY, T as TeamId, f as VARIANTS, V as Variant, W as Which } from './types-C7n6gJF3.js';
+import { R as ResolveOptions, V as Value } from './resolve-CQW-jzvr.js';
+export { a as Resolved, r as resolve, b as resolveSync, s as suggest } from './resolve-CQW-jzvr.js';
+export { C as ColorOptions, a as ColorResult, L as LogoUrlOptions, S as SelectOptions, l as logoUrl, b as logoUrlSync, m as marks, p as palette, s as selectMark, c as selectMarkSync, t as teamColors, d as teamColorsSync } from './marks-DH-tQIP-.js';
+export { K as Kind, b as PlaceOptions, P as Placement, c as TIERS_SUBTITLE, d as TIER_DESC, e as TIER_THEMES, a as TierRow, f as Tiers, T as TiersOptions, g as checkAlpha, h as checkHeight, p as place, i as placeSync, j as prepareTiers, w as wrapLabel } from './tiers-B6pUBPcE.js';
+export { a as ESPN_HEADSHOT_LEAGUES, E as EspnHeadshotLeague, H as HEADSHOT_ASPECT, h as headshotUrl, l as loadGsis, m as mlbHeadshotUrl, n as nbaHeadshotUrl, b as nhlHeadshotUrl, w as wnbaHeadshotUrl } from './headshots-B2J_LOO8.js';
+export { C as Cursor, R as RowFilter, b as SelectionPatch, a as SelectionState, S as SelectionStore, c as createSelection, f as focusIds, s as sameCursor, d as sameIds, t as toId } from './selection-D4T3PkRt.js';
+
+declare const MANIFEST_URL = "https://sdv.nyc3.cdn.digitaloceanspaces.com/assets/public/manifest/marks.csv";
+interface ManifestRow {
+    level: string;
+    league: string;
+    entity_id: string;
+    mark_type: string;
+    variant: string;
+    valid_from: string;
+    valid_to: string;
+    source: string;
+    sha256: string;
+    ext: string;
+    width: string;
+    height: string;
+    archive_url: string;
+    first_seen: string;
+}
+/** RFC 4180 over the whole text (quoted commas, doubled quotes, embedded newlines; CRLF or LF); rows keyed by header name. */
+declare function parseManifestCsv(text: string): ManifestRow[];
+/** Alias-mapped, safe-URL-filtered, ranked marks of one league; `archive_url` is derived, never copied. Not deduped. */
+declare function manifestMarks(league: string, rows: readonly ManifestRow[], aliases: readonly Alias[]): MarkRow[];
+declare function resetManifestCache(): void;
+/** The CDN manifest, fetched once per process (a failure is not cached). */
+declare function fetchManifest(o?: {
+    fetch?: typeof fetch;
+}): Promise<ManifestRow[]>;
+
+interface Rankable {
+    source_rank: number;
+    valid_from: number | null;
+    valid_to: number | null;
+    first_seen: string;
+    sha256: string;
+}
+/** Python `_ranked`: source_rank asc, open-ended (valid_to null) first, valid_to desc, first_seen desc, valid_from desc, sha256 asc; nulls last. */
+declare function compareMarks(a: Rankable, b: Rankable): number;
+
+declare class SdvplotError extends Error {
+    constructor(message: string, options?: ErrorOptions);
+}
+declare class InputError extends SdvplotError {
+}
+declare class UnresolvedTeamError extends SdvplotError {
+}
+declare class UnsupportedTargetError extends SdvplotError {
+}
+/** An optional peer dependency (resvg, playwright, react) is not installed. */
+declare class OptionalDependencyError extends SdvplotError {
+}
+declare class OfflineError extends SdvplotError {
+}
+declare class DownloadError extends OfflineError {
+    readonly url: string;
+    readonly status?: number | undefined;
+    constructor(message: string, url: string, status?: number | undefined);
+}
+type WarningHandler = (message: string) => void;
+declare function setWarningHandler(fn: WarningHandler | null): void;
+declare function resetWarnings(): void;
+/** One warning per `key` per process (spec §4.3): a 10k-row join must not print 10k lines. */
+declare function warn(key: string, message: string): void;
+
+/** Port of `_normalize.norm_value`: trimmed, accents + typographic punctuation folded, case-folded, integral numbers without ".0". */
+declare function normValue(value: unknown): string | null;
+declare function normSeason(value: SeasonInput, league?: League): number | null;
+
+/**
+ * Load a league's bundled teams, aliases and marks (one code-split chunk; nothing is downloaded). Every `*Sync`
+ * function needs it first. Async throughout: an unknown league rejects (never throws synchronously); a failed chunk
+ * load can be retried.
+ *
+ * @example
+ * ```ts
+ * import { loadLeague } from "@sportsdataverse/sdvplot";
+ *
+ * const nfl = await loadLeague("nfl");
+ * nfl.teams.find((t) => t.abbr === "KC");
+ * ```
+ */
+declare function loadLeague(league: League): Promise<LeagueData>;
+/** Every league shard plus the gsis map, so every *Sync variant works afterwards. */
+declare function preloadAll(): Promise<void>;
+/** Port of `_index.season_bounds`: [first, last]; last = max(latest alias season, next year). */
+declare function seasonBounds(league?: League): readonly [number, number] | null;
+/**
+ * The latest season any dated alias of `league` names (the last relocation or rename the index records), or `null`
+ * when no alias is dated. It is not the current season: the NHL's is 1997. A value resolved without a season is
+ * matched at this season first.
+ */
+declare const latestSeason: (league: League) => number | null;
+
+/** All teams for one league, or every league (in `LEAGUES` order) when omitted. */
+declare function teams(league?: League): Promise<readonly Team[]>;
+
+/** Column form → `Row[]` (flat objects, one per index). Columns must be equal length; `{}` → `[]`. */
+declare function rowsFrom(columns: Record<string, readonly unknown[]>): Record<string, unknown>[];
+
+/** Options for {@link matchupColors}: the league, how to resolve the two teams, and the backgrounds. */
+interface MatchupColorOptions extends ResolveOptions {
+    /** The league both teams belong to. */
+    league: League;
+    /** The background each theme's pair must read on; default `{ light: "#ffffff", dark: "#181a1b" }` (Game on Paper's pages). */
+    theme?: {
+        light?: string;
+        dark?: string;
+    };
+}
+/** One `[teamA, teamB]` colour pair per theme, as lowercase `#rrggbb`. */
+interface MatchupColors {
+    /** The pair for a light background. */
+    light: [string, string];
+    /** The pair for a dark background. */
+    dark: [string, string];
+}
+/**
+ * {@link matchupColors} once the league is loaded (`loadLeague` or `preloadAll`).
+ *
+ * @example
+ * ```ts
+ * import { loadLeague, matchupColorsSync } from "@sportsdataverse/sdvplot";
+ *
+ * await loadLeague("cfb");
+ * matchupColorsSync("Alabama", "Georgia", { league: "cfb" });
+ * ```
+ */
+declare function matchupColorsSync(teamA: Value, teamB: Value, opts: MatchupColorOptions): MatchupColors;
+/**
+ * Two team colours that tell the teams apart on a chart: Game on Paper's "game colours" picker.
+ *
+ * @remarks
+ * One pair per theme, each the first candidate whose colours are at least 20 apart in CIEDE2000 and each
+ * at least 2.5:1 (WCAG) against that theme's background. Candidates, in order: both primaries, teamB's
+ * secondary, teamA's secondary, both secondaries; so a team keeps its primary whenever it works, and teamA
+ * (Game on Paper's home team) keeps it first. When no candidate works, an unreadable colour's L* moves just
+ * far enough to read; then both colours' L* move, least total movement first, until they separate; failing
+ * that, the widest readable separation found. A team with no colour gets `#2394fd`. Deterministic.
+ *
+ * @example
+ * ```ts
+ * import { matchupColors } from "@sportsdataverse/sdvplot";
+ *
+ * // two crimson teams; light: ["#9e1b32", "#2c2a29"] (Georgia's secondary), dark: ["#ffffff", "#ba0c2f"]
+ * // in a page, pick the pair for the theme:
+ * // const [alabama, georgia] = window.matchMedia("(prefers-color-scheme: dark)").matches ? dark : light;
+ * await matchupColors("Alabama", "Georgia", { league: "cfb" });
+ * ```
+ */
+declare function matchupColors(teamA: Value, teamB: Value, opts: MatchupColorOptions): Promise<MatchupColors>;
+
+/** A color as lowercase `#rrggbb`: accepts `#rgb`, `#rrggbb`, `#rgba`, `#rrggbbaa` (`#` optional). Transparency throws unless `dropAlpha`. */
+declare function hex6(color: string, opts?: {
+    dropAlpha?: boolean;
+}): string;
+/** WCAG relative luminance, 0 (black) to 1 (white). */
+declare function luminance(color: string): number;
+/** WCAG contrast ratio, 1 (same) to 21 (black on white). */
+declare function contrast(a: string, b: string): number;
+/** Black or white, whichever reads better on `background`. */
+declare function onColor(background: string): string;
+/** The color `t` of the way from `a` to `b` in sRGB (`t` in [0, 1]). */
+declare function mix(a: string, b: string, t: number): string;
+/** The opaque `#rrggbb` a hex color shows as over `background`: a translucent color is alpha-composited onto it. */
+declare function solid(color: string, background?: string): string;
+
+declare function versions(): {
+    sdvplot: string;
+    index: string;
+    manifestLastModified: string;
+};
+
+declare const VERSION: string;
+
+export { Alias, DownloadError, InputError, League, LeagueData, MANIFEST_URL, type ManifestRow, MarkRow, type MatchupColorOptions, type MatchupColors, OfflineError, OptionalDependencyError, type Rankable, ResolveOptions, SdvplotError, SeasonInput, Team, UnresolvedTeamError, UnsupportedTargetError, VERSION, Value, type WarningHandler, compareMarks, contrast, fetchManifest, hex6, latestSeason, loadLeague, luminance, manifestMarks, matchupColors, matchupColorsSync, mix, normSeason, normValue, onColor, parseManifestCsv, preloadAll, resetManifestCache, resetWarnings, rowsFrom, seasonBounds, setWarningHandler, solid, teams, versions, warn };

package/dist/index.js

@@ -0,0 +1,10 @@
+export { VERSION, matchupColors, matchupColorsSync, rowsFrom, teams, versions } from './chunk-JJFTD4VB.js';
+export { TIERS_SUBTITLE, TIER_DESC, TIER_THEMES, prepareTiers, wrapLabel } from './chunk-NLPH2VZT.js';
+export { createSelection, focusIds, sameCursor, sameIds, toId } from './chunk-4C3GX6QO.js';
+export { checkAlpha, checkHeight, place, placeSync } from './chunk-RMT2GMFH.js';
+export { MANIFEST_URL, compareMarks, fetchManifest, logoUrl, logoUrlSync, manifestMarks, marks, parseManifestCsv, resetManifestCache, selectMark, selectMarkSync } from './chunk-KKH6ABMA.js';
+export { contrast, hex6, luminance, mix, onColor, solid } from './chunk-J6R2LEJ7.js';
+export { ESPN_HEADSHOT_LEAGUES, EXPLICIT_ONLY, HEADSHOT_ASPECT, INDEX_VERSION, LEAGUES, PRIORITY, VARIANTS, headshotUrl, latestSeason, loadGsis, loadLeague, mlbHeadshotUrl, nbaHeadshotUrl, nhlHeadshotUrl, normSeason, normValue, palette, preloadAll, resolve, resolveSync, seasonBounds, suggest, teamColors, teamColorsSync, wnbaHeadshotUrl } from './chunk-TAXO3VXH.js';
+export { DownloadError, InputError, OfflineError, OptionalDependencyError, SdvplotError, UnresolvedTeamError, UnsupportedTargetError, resetWarnings, setWarningHandler, warn } from './chunk-E7G7VSLV.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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