@sportsdataverse/sdvplot 0.0.0-stage → 0.2.0

package/dist/perspective.d.ts

@@ -0,0 +1,198 @@
+import { L as League, S as SeasonInput, I as IdSystem, V as Variant } from './types-C7n6gJF3.js';
+
+/** A row: column name to value, as `perspective.table(rows)` takes them. */
+type PerspectiveRow = Readonly<Record<string, unknown>>;
+/** A Perspective column type, as `await table.schema()` gives it. */
+type PerspectiveType = "integer" | "float" | "string" | "boolean" | "date" | "datetime";
+/** A Perspective schema: column name to type, as `await table.schema()` gives it. */
+type PerspectiveSchema = Readonly<Record<string, PerspectiveType>>;
+/** A `number_format`: Intl.NumberFormat options, e.g. `{ maximumFractionDigits: 2 }`. */
+type PerspectiveNumberFormat = {
+    readonly [option: string]: string | number | boolean;
+};
+/** One column's entry in `columns_config`: the keys sdvplot sets. */
+type PerspectiveColumnConfig = {
+    /** The Datagrid's cell fill: "series", one palette colour per distinct value. */
+    bg_mode?: "series";
+    /** The Datagrid's series palette: `linear-gradient(to right, #rrggbb, …)`. */
+    bg_color?: string;
+    /** A chart's series palette (on a value column) or a scatter's Color slot palette (on the team column). */
+    palette?: string;
+    number_format?: PerspectiveNumberFormat;
+    /** The Datagrid shows a URL column as links. */
+    link?: true;
+    /** The Datagrid's number colours (a registry theme's): `linear-gradient(to right, <neg> 0%, <pos> 100%)`. */
+    fg_color?: string;
+    /** The Datagrid's font for a number column: a registry theme's numeric face, when it is not the body face. */
+    font_family?: string;
+};
+/** The Datagrid's own settings: a registry theme's body face and size. */
+type PerspectivePluginConfig = {
+    font_family: string;
+    font_size: number;
+};
+/** What `perspectiveConfig` returns: pass it to `viewer.restore()`, with your own view keys merged in. */
+type PerspectiveConfig = {
+    plugin: string;
+    /** Perspective's own theme: "Pro Light" or "Pro Dark" (load `@perspective-dev/viewer/dist/css/pro.css` / `pro-dark.css`). */
+    theme: "Pro Light" | "Pro Dark";
+    /** The Datagrid with a registry `theme` only. */
+    plugin_config?: PerspectivePluginConfig;
+    columns_config: Record<string, PerspectiveColumnConfig>;
+};
+/**
+ * The parts of a registry table theme `perspectiveConfig` reads. A `TableThemeSpec` (sdvtables'
+ * `tableThemeSpec(name, mode)`, Python's `table_theme_spec`) is one; sdvplot does not ship the registry itself.
+ */
+interface PerspectiveTheme {
+    /** `body`: the grid's face. `numeric`: the number columns' face, when it is not `body`. */
+    readonly fonts: {
+        readonly body?: string;
+        readonly numeric?: string;
+    };
+    /** `body`: the grid's font size in px. */
+    readonly sizes: {
+        readonly body: number;
+    };
+    /** The number colours: `neg` (low) to `pos` (high). */
+    readonly palette: {
+        readonly neg: string;
+        readonly pos: string;
+    };
+}
+/** `perspectiveConfig` options. */
+interface PerspectiveConfigOptions {
+    /** The column holding the team identifiers (any id system `resolve` reads). */
+    teamCol: string;
+    /** The SDV league key, e.g. "nfl". */
+    league: League;
+    /** The plugin: "Datagrid" (the default) or a chart's name ("Y Bar", "X Bar", "Y Line", "X/Y Scatter", …). */
+    plugin?: string;
+    /** "light" (default) or "dark": the Perspective theme, "Pro Light" or "Pro Dark". */
+    mode?: "light" | "dark";
+    /**
+     * A registry table theme: best as a function of the mode, `(m) => tableThemeSpec(name, m)` from
+     * `@sportsdataverse/sdvtables`, called with this call's `mode` on every plugin (so a light-only theme in dark mode
+     * throws, as in Python). A spec object works too; it does not say its mode, so resolve it in the same `mode`.
+     * The Datagrid takes its body face and size (`plugin_config`), its sign colours on every number column (`fg_color`;
+     * Perspective reads only `#hex` and `rgb()` colours there) and, when the numeric face is not the body face, that face
+     * on the number columns. Perspective takes each face as one family name, so the page loads the font (Google Fonts)
+     * or the browser draws its default. A chart takes none of it.
+     */
+    theme?: PerspectiveTheme | ((mode: "light" | "dark") => PerspectiveTheme);
+    /** A logo URL column (`perspectiveLogoColumn`) to show as links on the Datagrid, which draws no images. */
+    logoCol?: string;
+    /** The colour the teams must read against. Default: the Perspective theme's (#ffffff Pro Light, #242526 Pro Dark). */
+    background?: string;
+    /** Per column, a `number_format` to use instead of the default, or null for none. */
+    formats?: Readonly<Record<string, PerspectiveNumberFormat | null>>;
+    /** One season for every team. */
+    season?: SeasonInput;
+    /** How the team values are read. Default "auto". */
+    idSystem?: IdSystem;
+    /** Throw UnresolvedTeamError for a team that does not resolve, instead of one warning and #808080. */
+    strict?: boolean;
+    /**
+     * The column types, as `await table.schema()` gives them. Default: worked out from the rows as Perspective does
+     * (numbers, and strings that read as numbers, are "integer" or "float"; anything else is not a number). Pass it when
+     * you load the table with a schema of your own.
+     */
+    schema?: PerspectiveSchema;
+}
+/**
+ * A Perspective viewer config that colours each team by its own colours, for the Datagrid or a chart: the argument of
+ * `viewer.restore()`, as Python's `perspective_sdv_config` builds it (same keys, same colours, same order).
+ *
+ * The colours are the shared team palette (every adapter's, and Python's), taken over the teams in sorted order: each
+ * team's colour, made 3:1 against the background and ΔE 20 from every earlier team's, so a team keeps one colour
+ * whatever the rows' order. Perspective takes a palette, not a colour per value, so each palette lists those colours in
+ * the order Perspective hands colours out (checked in Chromium on Perspective 5.5.1):
+ *
+ * - `plugin: "Datagrid"`: the team column's cells are filled (`bg_mode` "series"), in the order the grid first draws
+ *   each value: the rows' order. Keep the grid in the rows' order (no `sort`) and to about one row per team. Null
+ *   cells take no colour and no slot. Only a text team column is filled: Perspective fills no number column, so
+ *   numeric team ids get none, with one warning.
+ * - a chart: split a bar, line or area chart by the team (`split_by: [teamCol]`) and each series takes its colour
+ *   from every number column's `palette`, in sorted order (Perspective sorts split values; a null series comes first,
+ *   so the palette then starts with the fallback grey). Put the team column in an "X/Y Scatter"'s Color slot (its
+ *   third column) and each team's points take theirs from the team column's `palette`, in the rows' order.
+ *
+ * Every number column also gets a `number_format` (Intl.NumberFormat options): 3 decimals for a float, 1 for a float
+ * named as a percentage (`pct`, `percent`), and an integer plain (2024, not 2,024). `formats` overrides them.
+ *
+ * @param rows - the rows the viewer shows (what `perspective.table(rows)` loads). With no rows and no `schema` no column is
+ *   known: the config has `plugin` and `theme` and an empty `columns_config`, without an error (pass the table's
+ *   `schema` for its number formats, as Python's empty frame keeps its columns).
+ * @returns `plugin`, `theme` and `columns_config`; merge your own `group_by`, `split_by`, `columns` and the rest in.
+ * @throws InputError for a column the rows do not have (`teamCol`, `logoCol` or a `formats` key), a team column that
+ *   mixes numbers and strings, an unknown `mode`, a `theme` that is not a spec (or a function returning one), or a
+ *   season outside the league's. UnresolvedTeamError with `strict: true`. A `theme` function's own errors pass through
+ *   (sdvtables' TableSpecError for a light-only theme in dark mode).
+ *
+ * @example
+ * ```ts
+ * import { loadLeague } from "@sportsdataverse/sdvplot";
+ * import { perspectiveConfig } from "@sportsdataverse/sdvplot/perspective";
+ *
+ * await loadLeague("nfl");
+ * // 2024 regular season, offence: EPA per play (nflverse play-by-play)
+ * const epa = [
+ *   { posteam: "BAL", epa_per_play: 0.218 },
+ *   { posteam: "BUF", epa_per_play: 0.1885 },
+ *   { posteam: "DET", epa_per_play: 0.1592 },
+ * ];
+ * const grid = perspectiveConfig(epa, { teamCol: "posteam", league: "nfl" });
+ * const bars = {
+ *   ...perspectiveConfig(epa, { teamCol: "posteam", league: "nfl", plugin: "Y Bar" }),
+ *   group_by: ["posteam"],
+ *   split_by: ["posteam"],
+ *   columns: ["epa_per_play"],
+ * };
+ * // in the browser: await viewer.load(await worker.table(epa)); await viewer.restore(grid)
+ * [grid.columns_config.posteam?.bg_color, bars.columns_config.epa_per_play?.palette];
+ * ```
+ */
+declare function perspectiveConfig(rows: readonly PerspectiveRow[], o: PerspectiveConfigOptions): PerspectiveConfig;
+/** `perspectiveLogoColumn` options. */
+interface PerspectiveLogoOptions {
+    /** The SDV league key, e.g. "nfl". */
+    league: League;
+    /** The new column's name. Default: `${teamCol}_logo`. It must not be a column already. */
+    name?: string;
+    /** One season for every team: the logo of that season (relocations and rebrands). */
+    season?: SeasonInput;
+    /** "default", "dark", or a named variant from `marks()`. */
+    variant?: Variant;
+    /** How the team values are read. Default "auto". */
+    idSystem?: IdSystem;
+    /** Throw UnresolvedTeamError for a team that does not resolve, instead of warning. */
+    strict?: boolean;
+}
+/**
+ * The rows with a column of each team's logo URL, right after the team column, as Python's `perspective_logo_column`
+ * adds it. Each distinct team is resolved once. A team that does not resolve, or has no archived logo, gets a null URL,
+ * with one warning for each reason. Show the column as links with `perspectiveConfig(rows, { logoCol })`: Perspective
+ * 5.5's Datagrid draws no images. The rows given are not changed.
+ *
+ * @returns new rows, each with the URL (a string, or null) in `name`.
+ * @throws InputError for a `teamCol` no row has, a `name` a row already has, or a season outside the league's.
+ *   UnresolvedTeamError with `strict: true`.
+ *
+ * @example
+ * ```ts
+ * import { loadLeague } from "@sportsdataverse/sdvplot";
+ * import { perspectiveConfig, perspectiveLogoColumn } from "@sportsdataverse/sdvplot/perspective";
+ *
+ * await loadLeague("nfl");
+ * const epa = [
+ *   { posteam: "BAL", epa_per_play: 0.218 },
+ *   { posteam: "BUF", epa_per_play: 0.1885 },
+ * ];
+ * const rows = perspectiveLogoColumn(epa, "posteam", { league: "nfl" });
+ * const config = perspectiveConfig(rows, { teamCol: "posteam", league: "nfl", logoCol: "posteam_logo" });
+ * [Object.keys(rows[0] ?? {}), config.columns_config.posteam_logo];
+ * ```
+ */
+declare function perspectiveLogoColumn<R extends PerspectiveRow>(rows: readonly R[], teamCol: string, o: PerspectiveLogoOptions): (R & Record<string, string | null>)[];
+
+export { type PerspectiveColumnConfig, type PerspectiveConfig, type PerspectiveConfigOptions, type PerspectiveLogoOptions, type PerspectiveNumberFormat, type PerspectivePluginConfig, type PerspectiveRow, type PerspectiveSchema, type PerspectiveTheme, type PerspectiveType, perspectiveConfig, perspectiveLogoColumn };

package/dist/perspective.js

@@ -0,0 +1,171 @@
+import { colorPalette } from './chunk-UL5M6KDE.js';
+import { placeSync } from './chunk-7ULOCCFL.js';
+import { normSeason } from './chunk-ZAEQXFJM.js';
+import { hex6 } from './chunk-J6R2LEJ7.js';
+import { InputError, warn } from './chunk-E7G7VSLV.js';
+
+// src/perspective.ts
+var PRO = { light: ["Pro Light", "#ffffff"], dark: ["Pro Dark", "#242526"] };
+var FALLBACK = "#808080";
+var PERCENT = /(^|_)(pct|percent|perc)(_|$)/i;
+function numberFormat(name, type) {
+  if (type === "integer") return { useGrouping: false, maximumFractionDigits: 0 };
+  const n = PERCENT.test(name) ? 1 : 3;
+  return { minimumFractionDigits: n, maximumFractionDigits: n };
+}
+var INT = /^\s*-?\d+\s*$/;
+var FLOAT = /^\s*-?(\d+\.?\d*|\.\d+)([eE][-+]?\d+)?\s*$/;
+function kindOf(v) {
+  if (v === null || v === void 0) return null;
+  if (typeof v === "bigint") return "integer";
+  if (typeof v === "number") {
+    if (!Number.isFinite(v)) return "other";
+    return Number.isInteger(v) && Math.abs(v) < 2 ** 31 ? "integer" : "float";
+  }
+  if (typeof v === "string") return INT.test(v) ? "integer" : FLOAT.test(v) ? "float" : "other";
+  return "other";
+}
+function inferSchema(rows) {
+  const kinds = /* @__PURE__ */ new Map();
+  for (const r of rows)
+    for (const [k, v] of Object.entries(r)) {
+      const s = kinds.get(k) ?? kinds.set(k, /* @__PURE__ */ new Set()).get(k);
+      const kind = kindOf(v);
+      if (kind !== null) s.add(kind);
+    }
+  return Object.fromEntries(
+    [...kinds].map(([k, s]) => [
+      k,
+      s.size === 0 || s.has("other") ? "string" : s.has("float") ? "float" : "integer"
+    ])
+  );
+}
+var isNumber = (t) => t === "integer" || t === "float";
+var quote = (s) => `'${s}'`;
+var isObj = (v) => typeof v === "object" && v !== null;
+var isFace = (v) => v === void 0 || typeof v === "string";
+var isTheme = (t) => isObj(t) && isObj(t.fonts) && isFace(t.fonts.body) && isFace(t.fonts.numeric) && isObj(t.sizes) && typeof t.sizes.body === "number" && isObj(t.palette) && typeof t.palette.neg === "string" && typeof t.palette.pos === "string";
+function checkColumns(schema, cols) {
+  const names = Object.keys(schema);
+  for (const c of cols)
+    if (c !== void 0 && !Object.hasOwn(schema, c))
+      throw new InputError(`the rows have no column ${quote(c)} (columns: ${names.join(", ")})`);
+}
+function teamOrders(values, numeric, col) {
+  const first = [...new Set(values.filter((v) => v !== null && v !== void 0))];
+  const types = new Set(first.map((v) => typeof v === "bigint" ? "number" : typeof v));
+  if (types.size > 1)
+    throw new InputError(
+      `the team column ${quote(col)} mixes ${[...types].sort().join(" and ")} values: use one id system`
+    );
+  const key = numeric ? (v) => Number(v) : (v) => String(v);
+  const sorted = [...first].sort((a, b) => {
+    const [x, y] = [key(a), key(b)];
+    return x < y ? -1 : x > y ? 1 : 0;
+  });
+  return [first, sorted];
+}
+var gradient = (colors) => `linear-gradient(to right, ${colors.join(", ")})`;
+function perspectiveConfig(rows, o) {
+  const mode = o.mode ?? "light";
+  if (mode !== "light" && mode !== "dark")
+    throw new InputError(`mode must be 'light' or 'dark', not ${quote(String(mode))}`);
+  const resolved = typeof o.theme === "function" ? o.theme(mode) : o.theme;
+  if (o.theme !== void 0 && !isTheme(resolved))
+    throw new InputError(
+      `theme must be a table theme spec or a function of the mode, not ${quote(String(resolved))}: pass (m) => tableThemeSpec(name, m) from @sportsdataverse/sdvtables`
+    );
+  const schema = o.schema ?? inferSchema(rows);
+  const { teamCol, logoCol } = o;
+  if (o.schema !== void 0 || rows.length > 0)
+    checkColumns(schema, [teamCol, logoCol, ...Object.keys(o.formats ?? {})]);
+  const [pro, proBg] = PRO[mode];
+  const bg = o.background === void 0 ? proBg : hex6(o.background);
+  const season = normSeason(o.season, o.league);
+  const text = !isNumber(schema[teamCol]);
+  const numeric = Object.keys(schema).filter((c) => c !== teamCol && isNumber(schema[c]));
+  const grid = (o.plugin ?? "Datagrid") === "Datagrid";
+  const values = rows.map((r) => r[teamCol]);
+  const [first, ascending] = teamOrders(values, !text, teamCol);
+  const pal = colorPalette(o.league, ascending, {
+    ...season === null ? {} : { season },
+    background: bg,
+    idSystem: o.idSystem ?? "auto",
+    strict: o.strict ?? false,
+    fallback: FALLBACK
+  });
+  const color = new Map(ascending.map((v, i) => [v, pal[i]]));
+  const nulls = values.some((v) => v === null || v === void 0) ? [FALLBACK] : [];
+  const byAppearance = gradient(first.map((v) => color.get(v)));
+  const byValue = gradient([...nulls, ...pal]);
+  let columns = {};
+  for (const c of numeric) {
+    const fmt = o.formats !== void 0 && Object.hasOwn(o.formats, c) ? o.formats[c] : numberFormat(c, schema[c]);
+    columns[c] = fmt === null || fmt === void 0 ? {} : { number_format: fmt };
+  }
+  if (first.length > 0 && !grid) {
+    for (const c of numeric) columns[c].palette = byValue;
+    if (text) columns = { [teamCol]: { palette: byAppearance }, ...columns };
+  } else if (first.length > 0 && text) {
+    columns = { [teamCol]: { bg_mode: "series", bg_color: byAppearance }, ...columns };
+  } else if (first.length > 0) {
+    warn(
+      `perspective:numeric-team:${teamCol}`,
+      `no team colors on the Datagrid: the team column ${quote(teamCol)} is numeric, and team colors need a string or categorical team column (Perspective fills only text cells)`
+    );
+  }
+  const theme = grid ? resolved : void 0;
+  if (theme !== void 0) {
+    const { body, numeric: face } = theme.fonts;
+    const sign = `linear-gradient(to right, ${theme.palette.neg} 0%, ${theme.palette.pos} 100%)`;
+    for (const c of numeric) {
+      columns[c].fg_color = sign;
+      if (face && face !== body) columns[c].font_family = face;
+    }
+  }
+  if (grid && logoCol !== void 0) columns[logoCol] = { link: true };
+  const gridFace = theme?.fonts.body;
+  return {
+    plugin: o.plugin ?? "Datagrid",
+    theme: pro,
+    ...theme !== void 0 && gridFace ? { plugin_config: { font_family: gridFace, font_size: theme.sizes.body } } : {},
+    columns_config: Object.fromEntries(Object.entries(columns).filter(([, v]) => Object.keys(v).length > 0))
+  };
+}
+function perspectiveLogoColumn(rows, teamCol, o) {
+  const name = o.name ?? `${teamCol}_logo`;
+  if (rows.length > 0 && !rows.some((r) => Object.hasOwn(r, teamCol)))
+    throw new InputError(`the rows have no column ${quote(teamCol)}`);
+  if (rows.some((r) => Object.hasOwn(r, name)))
+    throw new InputError(`the rows already have a column ${quote(name)}: pass another name`);
+  const values = [...new Set(rows.map((r) => r[teamCol]).filter((v) => v !== null && v !== void 0))];
+  const at = values.map((_, i) => i);
+  const placed = placeSync(
+    at,
+    at.map(() => 0),
+    values,
+    {
+      league: o.league,
+      season: normSeason(o.season, o.league),
+      kind: "logo",
+      variant: o.variant ?? "default",
+      idSystem: o.idSystem ?? "auto",
+      strict: o.strict ?? false
+    }
+  );
+  const urls = new Map(placed.map((p) => [values[p.index], p.url]));
+  return rows.map((r) => {
+    const out = {};
+    const url = urls.get(r[teamCol]) ?? null;
+    for (const [k, v] of Object.entries(r)) {
+      out[k] = v;
+      if (k === teamCol) out[name] = url;
+    }
+    if (!Object.hasOwn(out, name)) out[name] = url;
+    return out;
+  });
+}
+
+export { perspectiveConfig, perspectiveLogoColumn };
+//# sourceMappingURL=perspective.js.map
+//# sourceMappingURL=perspective.js.map

package/dist/perspective.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/perspective.ts"],"names":[],"mappings":"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","file":"perspective.js","sourcesContent":["/**\n * Perspective 5.5 (`@perspective-dev/viewer`, with the `-datagrid` and `-charts` plugins): team colours, number formats,\n * a registry table theme's fonts and sign colours, and a logo column for a `<perspective-viewer>`, the JavaScript side of sdvplot's Python `sdvplot.perspective`. Both\n * functions return plain data: a viewer config (the argument of `viewer.restore()`) and rows with a logo URL column.\n * Given the same rows and options, `perspectiveConfig` returns what Python's `perspective_sdv_config` returns\n * (fixtures/perspective/oracle.json holds the Python answers; packages/sdvplot/test/perspective-parity.test.ts compares).\n * Pure: Perspective is never imported, not even its types. Call after `loadLeague(league)` / `preloadAll()`.\n */\nimport { colorPalette } from \"./_web.js\";\nimport { hex6 } from \"./contrast.js\";\nimport { InputError, warn } from \"./errors.js\";\nimport { normSeason } from \"./normalize.js\";\nimport { placeSync } from \"./placement.js\";\nimport type { Value } from \"./resolve.js\";\nimport type { IdSystem, League, SeasonInput, Variant } from \"./types.js\";\n\n/** A row: column name to value, as `perspective.table(rows)` takes them. */\nexport type PerspectiveRow = Readonly<Record<string, unknown>>;\n/** A Perspective column type, as `await table.schema()` gives it. */\nexport type PerspectiveType = \"integer\" | \"float\" | \"string\" | \"boolean\" | \"date\" | \"datetime\";\n/** A Perspective schema: column name to type, as `await table.schema()` gives it. */\nexport type PerspectiveSchema = Readonly<Record<string, PerspectiveType>>;\n/** A `number_format`: Intl.NumberFormat options, e.g. `{ maximumFractionDigits: 2 }`. */\nexport type PerspectiveNumberFormat = { readonly [option: string]: string | number | boolean };\n/** One column's entry in `columns_config`: the keys sdvplot sets. */\nexport type PerspectiveColumnConfig = {\n  /** The Datagrid's cell fill: \"series\", one palette colour per distinct value. */\n  bg_mode?: \"series\";\n  /** The Datagrid's series palette: `linear-gradient(to right, #rrggbb, …)`. */\n  bg_color?: string;\n  /** A chart's series palette (on a value column) or a scatter's Color slot palette (on the team column). */\n  palette?: string;\n  number_format?: PerspectiveNumberFormat;\n  /** The Datagrid shows a URL column as links. */\n  link?: true;\n  /** The Datagrid's number colours (a registry theme's): `linear-gradient(to right, <neg> 0%, <pos> 100%)`. */\n  fg_color?: string;\n  /** The Datagrid's font for a number column: a registry theme's numeric face, when it is not the body face. */\n  font_family?: string;\n};\n/** The Datagrid's own settings: a registry theme's body face and size. */\nexport type PerspectivePluginConfig = { font_family: string; font_size: number };\n/** What `perspectiveConfig` returns: pass it to `viewer.restore()`, with your own view keys merged in. */\nexport type PerspectiveConfig = {\n  plugin: string;\n  /** Perspective's own theme: \"Pro Light\" or \"Pro Dark\" (load `@perspective-dev/viewer/dist/css/pro.css` / `pro-dark.css`). */\n  theme: \"Pro Light\" | \"Pro Dark\";\n  /** The Datagrid with a registry `theme` only. */\n  plugin_config?: PerspectivePluginConfig;\n  columns_config: Record<string, PerspectiveColumnConfig>;\n};\n/**\n * The parts of a registry table theme `perspectiveConfig` reads. A `TableThemeSpec` (sdvtables'\n * `tableThemeSpec(name, mode)`, Python's `table_theme_spec`) is one; sdvplot does not ship the registry itself.\n */\nexport interface PerspectiveTheme {\n  /** `body`: the grid's face. `numeric`: the number columns' face, when it is not `body`. */\n  readonly fonts: { readonly body?: string; readonly numeric?: string };\n  /** `body`: the grid's font size in px. */\n  readonly sizes: { readonly body: number };\n  /** The number colours: `neg` (low) to `pos` (high). */\n  readonly palette: { readonly neg: string; readonly pos: string };\n}\n\n/** `perspectiveConfig` options. */\nexport interface PerspectiveConfigOptions {\n  /** The column holding the team identifiers (any id system `resolve` reads). */\n  teamCol: string;\n  /** The SDV league key, e.g. \"nfl\". */\n  league: League;\n  /** The plugin: \"Datagrid\" (the default) or a chart's name (\"Y Bar\", \"X Bar\", \"Y Line\", \"X/Y Scatter\", …). */\n  plugin?: string;\n  /** \"light\" (default) or \"dark\": the Perspective theme, \"Pro Light\" or \"Pro Dark\". */\n  mode?: \"light\" | \"dark\";\n  /**\n   * A registry table theme: best as a function of the mode, `(m) => tableThemeSpec(name, m)` from\n   * `@sportsdataverse/sdvtables`, called with this call's `mode` on every plugin (so a light-only theme in dark mode\n   * throws, as in Python). A spec object works too; it does not say its mode, so resolve it in the same `mode`.\n   * The Datagrid takes its body face and size (`plugin_config`), its sign colours on every number column (`fg_color`;\n   * Perspective reads only `#hex` and `rgb()` colours there) and, when the numeric face is not the body face, that face\n   * on the number columns. Perspective takes each face as one family name, so the page loads the font (Google Fonts)\n   * or the browser draws its default. A chart takes none of it.\n   */\n  theme?: PerspectiveTheme | ((mode: \"light\" | \"dark\") => PerspectiveTheme);\n  /** A logo URL column (`perspectiveLogoColumn`) to show as links on the Datagrid, which draws no images. */\n  logoCol?: string;\n  /** The colour the teams must read against. Default: the Perspective theme's (#ffffff Pro Light, #242526 Pro Dark). */\n  background?: string;\n  /** Per column, a `number_format` to use instead of the default, or null for none. */\n  formats?: Readonly<Record<string, PerspectiveNumberFormat | null>>;\n  /** One season for every team. */\n  season?: SeasonInput;\n  /** How the team values are read. Default \"auto\". */\n  idSystem?: IdSystem;\n  /** Throw UnresolvedTeamError for a team that does not resolve, instead of one warning and #808080. */\n  strict?: boolean;\n  /**\n   * The column types, as `await table.schema()` gives them. Default: worked out from the rows as Perspective does\n   * (numbers, and strings that read as numbers, are \"integer\" or \"float\"; anything else is not a number). Pass it when\n   * you load the table with a schema of your own.\n   */\n  schema?: PerspectiveSchema;\n}\n\n// Perspective's two built-in themes and their --psp--background-color (5.5.1's pro.css and pro-dark.css)\nconst PRO = { light: [\"Pro Light\", \"#ffffff\"], dark: [\"Pro Dark\", \"#242526\"] } as const;\nconst FALLBACK = \"#808080\";\n// A float column whose name says it is a percentage (fg_pct, pct_complete, win_percent) shows 1 decimal; any other\n// float (a rate, EPA) shows 3; an integer is shown as typed (1039 and 2024, not 1,039 or 2,024)\nconst PERCENT = /(^|_)(pct|percent|perc)(_|$)/i;\n\nfunction numberFormat(name: string, type: PerspectiveType): PerspectiveNumberFormat {\n  if (type === \"integer\") return { useGrouping: false, maximumFractionDigits: 0 };\n  const n = PERCENT.test(name) ? 1 : 3;\n  return { minimumFractionDigits: n, maximumFractionDigits: n };\n}\n\nconst INT = /^\\s*-?\\d+\\s*$/;\nconst FLOAT = /^\\s*-?(\\d+\\.?\\d*|\\.\\d+)([eE][-+]?\\d+)?\\s*$/;\n/** A value's Perspective number type, or \"other\" (null for a missing value). */\nfunction kindOf(v: unknown): \"integer\" | \"float\" | \"other\" | null {\n  if (v === null || v === undefined) return null;\n  if (typeof v === \"bigint\") return \"integer\";\n  if (typeof v === \"number\") {\n    if (!Number.isFinite(v)) return \"other\";\n    return Number.isInteger(v) && Math.abs(v) < 2 ** 31 ? \"integer\" : \"float\";\n  }\n  if (typeof v === \"string\") return INT.test(v) ? \"integer\" : FLOAT.test(v) ? \"float\" : \"other\";\n  return \"other\";\n}\n\n/**\n * The rows' schema, as `perspective.table(rows)` works it out for the number columns (checked against Perspective\n * 5.5.1 in test/perspective.test.ts). ponytail: a non-number column is \"string\" here, whatever Perspective makes of it\n * (a boolean, a date): sdvplot only asks whether a column is a number.\n */\nfunction inferSchema(rows: readonly PerspectiveRow[]): Record<string, PerspectiveType> {\n  const kinds = new Map<string, Set<string>>();\n  for (const r of rows)\n    for (const [k, v] of Object.entries(r)) {\n      const s = kinds.get(k) ?? kinds.set(k, new Set()).get(k)!;\n      const kind = kindOf(v);\n      if (kind !== null) s.add(kind);\n    }\n  return Object.fromEntries(\n    [...kinds].map(([k, s]) => [\n      k,\n      s.size === 0 || s.has(\"other\") ? \"string\" : s.has(\"float\") ? \"float\" : \"integer\",\n    ]),\n  );\n}\n\nconst isNumber = (t: PerspectiveType | undefined): boolean => t === \"integer\" || t === \"float\";\nconst quote = (s: string): string => `'${s}'`;\nconst isObj = (v: unknown): v is Record<string, unknown> => typeof v === \"object\" && v !== null;\nconst isFace = (v: unknown): boolean => v === undefined || typeof v === \"string\";\n/** A given theme (or what its function returned) must have every field perspectiveConfig reads. */\nconst isTheme = (t: unknown): t is PerspectiveTheme =>\n  isObj(t) &&\n  isObj(t.fonts) &&\n  isFace(t.fonts.body) &&\n  isFace(t.fonts.numeric) &&\n  isObj(t.sizes) &&\n  typeof t.sizes.body === \"number\" &&\n  isObj(t.palette) &&\n  typeof t.palette.neg === \"string\" &&\n  typeof t.palette.pos === \"string\";\n\nfunction checkColumns(schema: PerspectiveSchema, cols: readonly (string | undefined)[]): void {\n  const names = Object.keys(schema);\n  for (const c of cols)\n    if (c !== undefined && !Object.hasOwn(schema, c))\n      throw new InputError(`the rows have no column ${quote(c)} (columns: ${names.join(\", \")})`);\n}\n\n/**\n * The distinct non-null team values in the order a grid or a scatter's Color slot meets them (first appearance), and in\n * a chart's split order: sorted, numerically for a number column, else by code unit as Perspective sorts strings\n * (upper case first). InputError for numbers and strings mixed.\n */\nfunction teamOrders(values: readonly unknown[], numeric: boolean, col: string): [unknown[], unknown[]] {\n  const first = [...new Set(values.filter((v) => v !== null && v !== undefined))];\n  const types = new Set(first.map((v) => (typeof v === \"bigint\" ? \"number\" : typeof v)));\n  if (types.size > 1)\n    throw new InputError(\n      `the team column ${quote(col)} mixes ${[...types].sort().join(\" and \")} values: use one id system`,\n    );\n  const key = numeric ? (v: unknown) => Number(v) : (v: unknown) => String(v);\n  const sorted = [...first].sort((a, b) => {\n    const [x, y] = [key(a), key(b)];\n    return x < y ? -1 : x > y ? 1 : 0;\n  });\n  return [first, sorted];\n}\n\nconst gradient = (colors: readonly string[]): string => `linear-gradient(to right, ${colors.join(\", \")})`;\n\n/**\n * A Perspective viewer config that colours each team by its own colours, for the Datagrid or a chart: the argument of\n * `viewer.restore()`, as Python's `perspective_sdv_config` builds it (same keys, same colours, same order).\n *\n * The colours are the shared team palette (every adapter's, and Python's), taken over the teams in sorted order: each\n * team's colour, made 3:1 against the background and ΔE 20 from every earlier team's, so a team keeps one colour\n * whatever the rows' order. Perspective takes a palette, not a colour per value, so each palette lists those colours in\n * the order Perspective hands colours out (checked in Chromium on Perspective 5.5.1):\n *\n * - `plugin: \"Datagrid\"`: the team column's cells are filled (`bg_mode` \"series\"), in the order the grid first draws\n *   each value: the rows' order. Keep the grid in the rows' order (no `sort`) and to about one row per team. Null\n *   cells take no colour and no slot. Only a text team column is filled: Perspective fills no number column, so\n *   numeric team ids get none, with one warning.\n * - a chart: split a bar, line or area chart by the team (`split_by: [teamCol]`) and each series takes its colour\n *   from every number column's `palette`, in sorted order (Perspective sorts split values; a null series comes first,\n *   so the palette then starts with the fallback grey). Put the team column in an \"X/Y Scatter\"'s Color slot (its\n *   third column) and each team's points take theirs from the team column's `palette`, in the rows' order.\n *\n * Every number column also gets a `number_format` (Intl.NumberFormat options): 3 decimals for a float, 1 for a float\n * named as a percentage (`pct`, `percent`), and an integer plain (2024, not 2,024). `formats` overrides them.\n *\n * @param rows - the rows the viewer shows (what `perspective.table(rows)` loads). With no rows and no `schema` no column is\n *   known: the config has `plugin` and `theme` and an empty `columns_config`, without an error (pass the table's\n *   `schema` for its number formats, as Python's empty frame keeps its columns).\n * @returns `plugin`, `theme` and `columns_config`; merge your own `group_by`, `split_by`, `columns` and the rest in.\n * @throws InputError for a column the rows do not have (`teamCol`, `logoCol` or a `formats` key), a team column that\n *   mixes numbers and strings, an unknown `mode`, a `theme` that is not a spec (or a function returning one), or a\n *   season outside the league's. UnresolvedTeamError with `strict: true`. A `theme` function's own errors pass through\n *   (sdvtables' TableSpecError for a light-only theme in dark mode).\n *\n * @example\n * ```ts\n * import { loadLeague } from \"@sportsdataverse/sdvplot\";\n * import { perspectiveConfig } from \"@sportsdataverse/sdvplot/perspective\";\n *\n * await loadLeague(\"nfl\");\n * // 2024 regular season, offence: EPA per play (nflverse play-by-play)\n * const epa = [\n *   { posteam: \"BAL\", epa_per_play: 0.218 },\n *   { posteam: \"BUF\", epa_per_play: 0.1885 },\n *   { posteam: \"DET\", epa_per_play: 0.1592 },\n * ];\n * const grid = perspectiveConfig(epa, { teamCol: \"posteam\", league: \"nfl\" });\n * const bars = {\n *   ...perspectiveConfig(epa, { teamCol: \"posteam\", league: \"nfl\", plugin: \"Y Bar\" }),\n *   group_by: [\"posteam\"],\n *   split_by: [\"posteam\"],\n *   columns: [\"epa_per_play\"],\n * };\n * // in the browser: await viewer.load(await worker.table(epa)); await viewer.restore(grid)\n * [grid.columns_config.posteam?.bg_color, bars.columns_config.epa_per_play?.palette];\n * ```\n */\nexport function perspectiveConfig(\n  rows: readonly PerspectiveRow[],\n  o: PerspectiveConfigOptions,\n): PerspectiveConfig {\n  const mode = o.mode ?? \"light\";\n  if (mode !== \"light\" && mode !== \"dark\")\n    throw new InputError(`mode must be 'light' or 'dark', not ${quote(String(mode))}`);\n  // resolved before the plugin is known, as Python resolves theme= on every plugin (a light-only theme in dark throws)\n  const resolved = typeof o.theme === \"function\" ? o.theme(mode) : o.theme;\n  if (o.theme !== undefined && !isTheme(resolved))\n    throw new InputError(\n      `theme must be a table theme spec or a function of the mode, not ${quote(String(resolved))}: pass (m) => tableThemeSpec(name, m) from @sportsdataverse/sdvtables`,\n    );\n  const schema = o.schema ?? inferSchema(rows);\n  const { teamCol, logoCol } = o;\n  // no rows and no schema: no column is known, so none is missing (Python's empty frame still has its columns)\n  if (o.schema !== undefined || rows.length > 0)\n    checkColumns(schema, [teamCol, logoCol, ...Object.keys(o.formats ?? {})]);\n  const [pro, proBg] = PRO[mode];\n  const bg = o.background === undefined ? proBg : hex6(o.background);\n  const season = normSeason(o.season, o.league);\n  const text = !isNumber(schema[teamCol]); // Perspective fills a string column's cells, never a number column's\n  const numeric = Object.keys(schema).filter((c) => c !== teamCol && isNumber(schema[c]));\n  const grid = (o.plugin ?? \"Datagrid\") === \"Datagrid\";\n  const values = rows.map((r) => r[teamCol]);\n  const [first, ascending] = teamOrders(values, !text, teamCol);\n  // the shared team palette every adapter uses (Python's perspective._palette): unresolved values grey, out of it\n  const pal = colorPalette(o.league, ascending, {\n    ...(season === null ? {} : { season }),\n    background: bg,\n    idSystem: o.idSystem ?? \"auto\",\n    strict: o.strict ?? false,\n    fallback: FALLBACK,\n  });\n  const color = new Map(ascending.map((v, i) => [v, pal[i] as string]));\n  // a null split series comes first: palette entry 0\n  const nulls = values.some((v) => v === null || v === undefined) ? [FALLBACK] : [];\n  const byAppearance = gradient(first.map((v) => color.get(v) as string));\n  const byValue = gradient([...nulls, ...pal]);\n  let columns: Record<string, PerspectiveColumnConfig> = {};\n  for (const c of numeric) {\n    const fmt =\n      o.formats !== undefined && Object.hasOwn(o.formats, c) ? o.formats[c] : numberFormat(c, schema[c]!);\n    columns[c] = fmt === null || fmt === undefined ? {} : { number_format: fmt };\n  }\n  // no teams (no rows) means no palette at all: an empty palette is not a valid CSS value\n  if (first.length > 0 && !grid) {\n    for (const c of numeric) columns[c]!.palette = byValue;\n    if (text) columns = { [teamCol]: { palette: byAppearance }, ...columns }; // a number Color slot is a gradient\n  } else if (first.length > 0 && text) {\n    columns = { [teamCol]: { bg_mode: \"series\", bg_color: byAppearance }, ...columns };\n  } else if (first.length > 0) {\n    warn(\n      `perspective:numeric-team:${teamCol}`,\n      `no team colors on the Datagrid: the team column ${quote(teamCol)} is numeric, and team colors need a string or categorical team column (Perspective fills only text cells)`,\n    );\n  }\n  const theme = grid ? resolved : undefined; // a chart takes no fonts from a config\n  if (theme !== undefined) {\n    const { body, numeric: face } = theme.fonts;\n    const sign = `linear-gradient(to right, ${theme.palette.neg} 0%, ${theme.palette.pos} 100%)`;\n    for (const c of numeric) {\n      columns[c]!.fg_color = sign;\n      if (face && face !== body) columns[c]!.font_family = face;\n    }\n  }\n  if (grid && logoCol !== undefined) columns[logoCol] = { link: true };\n  const gridFace = theme?.fonts.body;\n  return {\n    plugin: o.plugin ?? \"Datagrid\",\n    theme: pro,\n    ...(theme !== undefined && gridFace\n      ? { plugin_config: { font_family: gridFace, font_size: theme.sizes.body } }\n      : {}),\n    columns_config: Object.fromEntries(Object.entries(columns).filter(([, v]) => Object.keys(v).length > 0)),\n  };\n}\n\n/** `perspectiveLogoColumn` options. */\nexport interface PerspectiveLogoOptions {\n  /** The SDV league key, e.g. \"nfl\". */\n  league: League;\n  /** The new column's name. Default: `${teamCol}_logo`. It must not be a column already. */\n  name?: string;\n  /** One season for every team: the logo of that season (relocations and rebrands). */\n  season?: SeasonInput;\n  /** \"default\", \"dark\", or a named variant from `marks()`. */\n  variant?: Variant;\n  /** How the team values are read. Default \"auto\". */\n  idSystem?: IdSystem;\n  /** Throw UnresolvedTeamError for a team that does not resolve, instead of warning. */\n  strict?: boolean;\n}\n\n/**\n * The rows with a column of each team's logo URL, right after the team column, as Python's `perspective_logo_column`\n * adds it. Each distinct team is resolved once. A team that does not resolve, or has no archived logo, gets a null URL,\n * with one warning for each reason. Show the column as links with `perspectiveConfig(rows, { logoCol })`: Perspective\n * 5.5's Datagrid draws no images. The rows given are not changed.\n *\n * @returns new rows, each with the URL (a string, or null) in `name`.\n * @throws InputError for a `teamCol` no row has, a `name` a row already has, or a season outside the league's.\n *   UnresolvedTeamError with `strict: true`.\n *\n * @example\n * ```ts\n * import { loadLeague } from \"@sportsdataverse/sdvplot\";\n * import { perspectiveConfig, perspectiveLogoColumn } from \"@sportsdataverse/sdvplot/perspective\";\n *\n * await loadLeague(\"nfl\");\n * const epa = [\n *   { posteam: \"BAL\", epa_per_play: 0.218 },\n *   { posteam: \"BUF\", epa_per_play: 0.1885 },\n * ];\n * const rows = perspectiveLogoColumn(epa, \"posteam\", { league: \"nfl\" });\n * const config = perspectiveConfig(rows, { teamCol: \"posteam\", league: \"nfl\", logoCol: \"posteam_logo\" });\n * [Object.keys(rows[0] ?? {}), config.columns_config.posteam_logo];\n * ```\n */\nexport function perspectiveLogoColumn<R extends PerspectiveRow>(\n  rows: readonly R[],\n  teamCol: string,\n  o: PerspectiveLogoOptions,\n): (R & Record<string, string | null>)[] {\n  const name = o.name ?? `${teamCol}_logo`;\n  if (rows.length > 0 && !rows.some((r) => Object.hasOwn(r, teamCol)))\n    throw new InputError(`the rows have no column ${quote(teamCol)}`);\n  if (rows.some((r) => Object.hasOwn(r, name)))\n    throw new InputError(`the rows already have a column ${quote(name)}: pass another name`);\n  const values = [...new Set(rows.map((r) => r[teamCol]).filter((v) => v !== null && v !== undefined))];\n  const at = values.map((_, i) => i);\n  const placed = placeSync(\n    at,\n    at.map(() => 0),\n    values as Value[],\n    {\n      league: o.league,\n      season: normSeason(o.season, o.league),\n      kind: \"logo\",\n      variant: o.variant ?? \"default\",\n      idSystem: o.idSystem ?? \"auto\",\n      strict: o.strict ?? false,\n    },\n  );\n  const urls = new Map<unknown, string>(placed.map((p) => [values[p.index], p.url]));\n  return rows.map((r) => {\n    const out: Record<string, unknown> = {};\n    const url = urls.get(r[teamCol]) ?? null;\n    for (const [k, v] of Object.entries(r)) {\n      out[k] = v;\n      if (k === teamCol) out[name] = url;\n    }\n    if (!Object.hasOwn(out, name)) out[name] = url;\n    return out as R & Record<string, string | null>;\n  });\n}\n"]}

package/dist/phf-H7POU2KW.js

@@ -0,0 +1,32 @@
+// src/data/aliases/phf.ts
+var aliases = [
+  { "id_system": "mark", "value": "nwhl.co:6335", "team_id": "61638", "valid_from": null, "valid_to": null },
+  { "id_system": "mark", "value": "nwhl.co:6336", "team_id": "61635", "valid_from": null, "valid_to": null },
+  { "id_system": "mark", "value": "nwhl.co:6337", "team_id": "61637", "valid_from": null, "valid_to": null },
+  { "id_system": "mark", "value": "shiftstats:124984", "team_id": "124984", "valid_from": null, "valid_to": null },
+  { "id_system": "mark", "value": "shiftstats:207478", "team_id": "207478", "valid_from": null, "valid_to": null },
+  { "id_system": "mark", "value": "shiftstats:61635", "team_id": "61635", "valid_from": null, "valid_to": null },
+  { "id_system": "mark", "value": "shiftstats:61636", "team_id": "61636", "valid_from": null, "valid_to": null },
+  { "id_system": "mark", "value": "shiftstats:61637", "team_id": "61637", "valid_from": null, "valid_to": null },
+  { "id_system": "mark", "value": "shiftstats:61638", "team_id": "61638", "valid_from": null, "valid_to": null },
+  { "id_system": "mark", "value": "shiftstats:61639", "team_id": "61639", "valid_from": null, "valid_to": null },
+  { "id_system": "mark", "value": "shiftstats:79963", "team_id": "79963", "valid_from": null, "valid_to": null },
+  { "id_system": "name", "value": "Boston Pride", "team_id": "61638", "valid_from": null, "valid_to": null },
+  { "id_system": "name", "value": "Buffalo Beauts", "team_id": "61635", "valid_from": null, "valid_to": null },
+  { "id_system": "name", "value": "Connecticut Whale", "team_id": "61637", "valid_from": null, "valid_to": null },
+  { "id_system": "name", "value": "Metropolitan Riveters", "team_id": "124984", "valid_from": null, "valid_to": null },
+  { "id_system": "name", "value": "Metropolitan Riveters", "team_id": "61636", "valid_from": null, "valid_to": null },
+  { "id_system": "name", "value": "Minnesota Whitecaps", "team_id": "61639", "valid_from": null, "valid_to": null },
+  { "id_system": "name", "value": "Montreal Force", "team_id": "207478", "valid_from": null, "valid_to": null },
+  { "id_system": "name", "value": "Toronto Six", "team_id": "79963", "valid_from": null, "valid_to": null },
+  { "id_system": "team_id", "value": "124984", "team_id": "124984", "valid_from": null, "valid_to": null },
+  { "id_system": "team_id", "value": "207478", "team_id": "207478", "valid_from": null, "valid_to": null },
+  { "id_system": "team_id", "value": "61635", "team_id": "61635", "valid_from": null, "valid_to": null },
+  { "id_system": "team_id", "value": "61636", "team_id": "61636", "valid_from": null, "valid_to": null },
+  { "id_system": "team_id", "value": "61637", "team_id": "61637", "valid_from": null, "valid_to": null },
+  { "id_system": "team_id", "value": "61638", "team_id": "61638", "valid_from": null, "valid_to": null },
+  { "id_system": "team_id", "value": "61639", "team_id": "61639", "valid_from": null, "valid_to": null },
+  { "id_system": "team_id", "value": "79963", "team_id": "79963", "valid_from": null, "valid_to": null }
+];
+
+export { aliases };

package/dist/phf-K5IFMZUM.js

@@ -0,0 +1,13 @@
+// src/data/teams/phf.ts
+var teams = [
+  { "league": "phf", "team_id": "124984", "abbr": null, "name": "Metropolitan Riveters", "short_name": null, "location": null, "program": "pro", "conference_id": null, "conference": null, "color_primary": "#0e2039", "color_secondary": "#47485b", "color_source": "logo" },
+  { "league": "phf", "team_id": "207478", "abbr": null, "name": "Montreal Force", "short_name": null, "location": null, "program": "pro", "conference_id": null, "conference": null, "color_primary": "#901b39", "color_secondary": "#a46d86", "color_source": "logo" },
+  { "league": "phf", "team_id": "61635", "abbr": null, "name": "Buffalo Beauts", "short_name": null, "location": null, "program": "pro", "conference_id": null, "conference": null, "color_primary": "#7f7f7f", "color_secondary": "#000000", "color_source": "logo" },
+  { "league": "phf", "team_id": "61636", "abbr": null, "name": "Metropolitan Riveters", "short_name": null, "location": null, "program": "pro", "conference_id": null, "conference": null, "color_primary": "#f6dfa4", "color_secondary": "#00609c", "color_source": "logo" },
+  { "league": "phf", "team_id": "61637", "abbr": null, "name": "Connecticut Whale", "short_name": null, "location": null, "program": "pro", "conference_id": null, "conference": null, "color_primary": "#1a6492", "color_secondary": "#006f3c", "color_source": "logo" },
+  { "league": "phf", "team_id": "61638", "abbr": null, "name": "Boston Pride", "short_name": null, "location": null, "program": "pro", "conference_id": null, "conference": null, "color_primary": "#897d61", "color_secondary": "#bda87d", "color_source": "logo" },
+  { "league": "phf", "team_id": "61639", "abbr": null, "name": "Minnesota Whitecaps", "short_name": null, "location": null, "program": "pro", "conference_id": null, "conference": null, "color_primary": "#1b449c", "color_secondary": "#7b91c1", "color_source": "logo" },
+  { "league": "phf", "team_id": "79963", "abbr": null, "name": "Toronto Six", "short_name": null, "location": null, "program": "pro", "conference_id": null, "conference": null, "color_primary": "#ed2229", "color_secondary": null, "color_source": "logo" }
+];
+
+export { teams };

package/dist/phf-TWJI3BOW.js

@@ -0,0 +1,20 @@
+// src/data/marks/phf.ts
+var marks = [
+  { "team_id": "79963", "mark_type": "logo", "variant": "medium", "valid_from": null, "valid_to": null, "source": "shiftstats", "first_seen": "2026-09-30", "sha256": "099ff3ddfda22129777813def6c25a066ddffbfd34c26467d0fbd85c2794684d", "ext": "png", "width": 55, "height": 45, "source_rank": 4 },
+  { "team_id": "61637", "mark_type": "logo", "variant": "alternate", "valid_from": null, "valid_to": null, "source": "nwhl.co", "first_seen": "2026-09-30", "sha256": "f004fc4b1a48c3bad2f40457fbd27a7df9c593b527e4dae1e900d5f4488ddba5", "ext": "png", "width": 680, "height": 616, "source_rank": 4 },
+  { "team_id": "207478", "mark_type": "logo", "variant": "large", "valid_from": 2023, "valid_to": 2023, "source": "shiftstats", "first_seen": "2026-09-30", "sha256": "cb447e8c1bbc1e3ba14b259a1ec2ec2145bc4a88ea58b67ea9b239bc57d1f729", "ext": "png", "width": 115, "height": 95, "source_rank": 4 },
+  { "team_id": "124984", "mark_type": "logo", "variant": "large", "valid_from": 2022, "valid_to": 2023, "source": "shiftstats", "first_seen": "2026-09-30", "sha256": "f0070a6a350f4551dc439d37a4350c0a53c5c8579e9c1c7f2be4f05ec5a3f5ad", "ext": "png", "width": 115, "height": 95, "source_rank": 4 },
+  { "team_id": "79963", "mark_type": "logo", "variant": "large", "valid_from": 2021, "valid_to": 2023, "source": "shiftstats", "first_seen": "2026-09-30", "sha256": "518f97a7fa5277f1ea25305b6f4b3b50b77ff35adf3bb9a91d2b8006beaca018", "ext": "png", "width": 115, "height": 95, "source_rank": 4 },
+  { "team_id": "61639", "mark_type": "logo", "variant": "large", "valid_from": 2019, "valid_to": 2023, "source": "shiftstats", "first_seen": "2026-09-30", "sha256": "b589e3a1705ded8554666ec4675bf78be889f7d4bd8f840c667d9f59640f0b4d", "ext": "svg", "width": null, "height": null, "source_rank": 4 },
+  { "team_id": "61637", "mark_type": "logo", "variant": "medium", "valid_from": 2017, "valid_to": 2023, "source": "shiftstats", "first_seen": "2026-09-30", "sha256": "47ca405c65b3eccf3b115cf163925e04998ff4dd011925ce8eee1c69112ff359", "ext": "svg", "width": null, "height": null, "source_rank": 4 },
+  { "team_id": "61635", "mark_type": "logo", "variant": "medium", "valid_from": 2017, "valid_to": 2023, "source": "shiftstats", "first_seen": "2026-09-30", "sha256": "6cf0a82ec98b3332e4476a9e920117782d686785474da9d220e3955c757aa3b9", "ext": "svg", "width": null, "height": null, "source_rank": 4 },
+  { "team_id": "61638", "mark_type": "logo", "variant": "medium", "valid_from": 2017, "valid_to": 2023, "source": "shiftstats", "first_seen": "2026-09-30", "sha256": "a4fc8fc96dd81c2e29da89dab6371c2c36db86528e0d23b9452147ba59febf63", "ext": "svg", "width": null, "height": null, "source_rank": 4 },
+  { "team_id": "61636", "mark_type": "logo", "variant": "medium", "valid_from": 2017, "valid_to": 2021, "source": "shiftstats", "first_seen": "2026-09-30", "sha256": "e934e1421bf1aad308318e391195418bfc5d7b207e663b555cb7f088bb769410", "ext": "svg", "width": null, "height": null, "source_rank": 4 },
+  { "team_id": "61635", "mark_type": "wordmark", "variant": "default", "valid_from": 2016, "valid_to": 2016, "source": "nwhl.co", "first_seen": "2026-09-30", "sha256": "88db9e8018962a2b5cff735fe5857107bf586cdd257d4aa2f70417b86853cc55", "ext": "png", "width": 680, "height": 267, "source_rank": 4 },
+  { "team_id": "61637", "mark_type": "logo", "variant": "default", "valid_from": 2016, "valid_to": 2016, "source": "nwhl.co", "first_seen": "2026-09-30", "sha256": "b6417b2623d6c9d12e173efefc43fa85f3acaac5ef5761fdc2dd95f8004a1b82", "ext": "png", "width": 680, "height": 639, "source_rank": 4 },
+  { "team_id": "61635", "mark_type": "logo", "variant": "default", "valid_from": 2016, "valid_to": 2016, "source": "nwhl.co", "first_seen": "2026-09-30", "sha256": "cacf3c1c989af45ee947eea0304a3fb3f9b632a8a9c0028afeee75bab5feef79", "ext": "png", "width": 586, "height": 498, "source_rank": 4 },
+  { "team_id": "61638", "mark_type": "logo", "variant": "default", "valid_from": 2016, "valid_to": 2016, "source": "nwhl.co", "first_seen": "2026-09-30", "sha256": "cf2e36cc271ca9af358ae5629aa48832098df389cc9c496d98edcde469c0003a", "ext": "png", "width": 487, "height": 271, "source_rank": 4 },
+  { "team_id": "61635", "mark_type": "logo", "variant": "dark", "valid_from": 2016, "valid_to": 2016, "source": "nwhl.co", "first_seen": "2026-09-30", "sha256": "fb60f47920f3b8d18ab63d75a314d1505e967f9fd62c7e7d453df50cab409c0b", "ext": "png", "width": 617, "height": 478, "source_rank": 4 }
+];
+
+export { marks };

package/dist/placement-UWkqUzpa.d.ts

@@ -0,0 +1,32 @@
+import { L as League, S as SeasonInput, V as Variant, I as IdSystem, H as HeadshotIdSystem, a as MarkRow } from './types-C7n6gJF3.js';
+import { V as Value } from './resolve-CQW-jzvr.js';
+
+type Kind = "logo" | "wordmark" | "headshot";
+/** One point to draw: the caller's own x/y, the image URL and its width / height ratio (null when unknown). `index` is the row's position in the input arrays (skipped rows leave gaps). */
+interface Placement {
+    index: number;
+    id: string;
+    x: Value;
+    y: Value;
+    url: string;
+    aspect: number | null;
+    mark: MarkRow | null;
+}
+interface PlaceOptions {
+    league: League;
+    season?: SeasonInput | readonly SeasonInput[];
+    kind?: Kind;
+    variant?: Variant;
+    /** Team id system for logos/wordmarks (default "auto"); "espn" or "gsis" for headshots (default "espn"). */
+    idSystem?: IdSystem | HeadshotIdSystem;
+    strict?: boolean;
+    warn?: boolean;
+}
+
+declare function checkHeight(height: unknown): number;
+declare function checkAlpha(alpha: unknown): number;
+/** Port of `_placement.place` (post-preload): pairs each (x, y) with its team's mark or player's headshot, dropping and warning (once per reason) on rows that cannot be drawn. Needs `loadLeague(league)` (or `preloadAll()`) first; gsis headshots also need `loadGsis()`. */
+declare function placeSync(xs: readonly Value[], ys: readonly Value[], teams: readonly Value[], o: PlaceOptions): Placement[];
+declare function place(xs: readonly Value[], ys: readonly Value[], teams: readonly Value[], o: PlaceOptions): Promise<Placement[]>;
+
+export { type Kind as K, type Placement as P, type PlaceOptions as a, checkHeight as b, checkAlpha as c, placeSync as d, place as p };