@hjmds/design-contracts 1.20.0 → 1.21.0

package/dist/data-table.js

@@ -1,3 +1,4 @@
+import { accentColor, themeColor } from "./color-references.js";
 import { collectionItemContract, focusIndicatorContract } from "./component-contracts.js";
 import { control, fontWeight, spacing } from "./foundations.js";
 import { semanticColors } from "./semantic-colors.js";
@@ -35,6 +36,9 @@ export function validateDataTableRows(rows) {
             throw new TypeError(`Duplicate DataTable row id: ${row.id}`);
         }
         ids.add(row.id);
+        if (row.depth !== undefined && (!Number.isInteger(row.depth) || row.depth < 0 || row.depth > 3)) {
+            throw new RangeError(`DataTable row "${String(row.id)}" depth must be an integer from 0 to 3`);
+        }
     }
 }
 /**
@@ -76,14 +80,76 @@ export function validateDataTableSortState(state, columns) {
  * actually re-sorting rows (Combobox's local/external filtering split is the
  * same boundary — HJM judges intent, never executes the data operation).
  */
-export function getNextDataTableSortState(current, columnId, cycle = dataTableDefaults.sortCycle) {
+export function getNextDataTableSortState(current, columnId, cycle = dataTableDefaults.sortCycle, firstDirection = "ascending") {
+    const second = firstDirection === "ascending" ? "descending" : "ascending";
     if (current === null || current.columnId !== columnId) {
-        return { columnId, direction: "ascending" };
+        return { columnId, direction: firstDirection };
     }
-    if (current.direction === "ascending") {
-        return { columnId, direction: "descending" };
+    if (current.direction === firstDirection) {
+        return { columnId, direction: second };
     }
-    return cycle === "three-state" ? null : { columnId, direction: "ascending" };
+    return cycle === "three-state" ? null : { columnId, direction: firstDirection };
+}
+/** The first direction a column's header applies, from `sortDescFirst`. */
+export function dataTableFirstSortDirection(column) {
+    return column.sortDescFirst ? "descending" : "ascending";
+}
+/**
+ * Sort key for a displayed cell string: "0.340", ".340", "36 ⅓", "13.5억", "61.0%" → numbers;
+ * text such as "7승0무3패" or names stay strings; "—", "-" and "" are missing.
+ */
+export function toDataTableSortValue(value) {
+    if (value === null || value === undefined)
+        return null;
+    if (typeof value === "number")
+        return Number.isFinite(value) ? value : null;
+    const text = String(value).trim();
+    if (!text || text === "—" || text === "-" || text === "–")
+        return null;
+    // Two or more letters (any script) mean a label, not a number with a unit.
+    if (/\p{L}.*\p{L}/u.test(text.replace(/[⅓⅔]/g, "")))
+        return text;
+    const number = Number.parseFloat(text.replace(/[^0-9.+-]/g, ""));
+    return Number.isFinite(number) ? number : text;
+}
+/**
+ * Pure comparison: numbers numerically, strings with `localeCompare`, numbers before strings.
+ * Missing values are not compared here; `sortDataTableRows` always sinks them.
+ */
+export function compareDataTableValues(a, b, locale) {
+    if (typeof a === "number" && typeof b === "number")
+        return a - b;
+    if (typeof a === "number")
+        return -1;
+    if (typeof b === "number")
+        return 1;
+    return a.localeCompare(b, locale);
+}
+/**
+ * Optional row-model helper (TanStack `getSortedRowModel` with `sortUndefined: "last"`): stable,
+ * missing values always last in both directions. 1.20 left all sorting to products; Yajalal and
+ * other stat tables reimplemented the same rules, so the shared helper exists now. Products with
+ * server-side sorting keep calling `getNextDataTableSortState` only.
+ */
+export function sortDataTableRows(rows, sort, getValue, options = {}) {
+    const indexed = rows.map((row, index) => ({ row, index }));
+    if (!sort)
+        return indexed.map(item => item.row);
+    const sign = sort.direction === "ascending" ? 1 : -1;
+    return indexed.sort((x, y) => {
+        const a = getValue(x.row, sort.columnId), b = getValue(y.row, sort.columnId);
+        const missingA = a === null || a === undefined, missingB = b === null || b === undefined;
+        if (missingA || missingB)
+            return missingA === missingB ? x.index - y.index : missingA ? 1 : -1;
+        return sign * compareDataTableValues(a, b, options.locale) || x.index - y.index;
+    }).map(item => item.row);
+}
+/** Leading pinned columns (only an unbroken run from the start is pinned). */
+export function splitPinnedDataTableColumns(columns) {
+    let count = 0;
+    while (count < columns.length && columns[count].pinned === "start")
+        count++;
+    return { pinned: columns.slice(0, count), scrolling: columns.slice(count) };
 }
 /**
  * Reuses `collectionItemContract`'s hover/selected/focus tokens instead of a
@@ -144,6 +210,16 @@ export const dataTableRecipe = {
         focus: focusIndicatorContract,
     },
 };
+export const dataTableFamilyScenarios = [
+    "header-groups-span-contiguous-leaf-columns-and-pad-ungrouped-columns",
+    "row-groups-insert-a-section-label-before-their-rows",
+    "cell-tone-and-heat-are-product-decided-semantic-emphasis",
+    "percentile-rank-flips-for-lower-is-better-stats-and-ties-take-the-midpoint",
+    "bounded-height-tables-keep-the-header-fixed-while-the-body-scrolls",
+    "line-score-pads-to-nine-periods-and-extends-for-extra-periods",
+    "matrix-diagonal-is-a-blank-self-cell",
+    "comparison-bars-favor-the-better-side-even-when-lower-is-better",
+];
 /**
  * No roving-tabindex grid keyboard navigation (arrow keys between cells):
  * no product using this contract has measured demand for full ARIA-grid
@@ -165,8 +241,11 @@ export const dataTableBehavior = {
         keyboard: ["Tab", "Enter", "Space"],
         focus: "native",
     },
-    native: { roles: [], states: [], actions: [] },
+    native: { roles: ["button", "header"], states: ["selected"], actions: ["activate"] },
     scenarios: [
+        "sort-desc-first-columns-start-descending-and-cycle-back",
+        "missing-values-sink-to-the-bottom-in-both-directions",
+        "pinned-start-columns-stay-visible-while-the-rest-scrolls",
         "row-selection-reuses-the-shared-collection-selection-model-unchanged",
         "select-all-reuses-the-shared-tri-state-checkbox-value",
         "async-state-reuses-the-shared-collection-async-state-unchanged",
@@ -177,6 +256,163 @@ export const dataTableBehavior = {
         "row-expansion-is-not-owned-here-compose-the-disclosure-group-contract-per-row",
         "a-data-cell-exposes-at-most-one-focusable-control",
         "no-roving-tabindex-grid-navigation-is-implied",
+        ...dataTableFamilyScenarios,
     ],
 };
+/**
+ * Resolves group bands over the given (already pinned-split) column order. A group must cover a
+ * contiguous run; columns outside every group become placeholder bands so leaf widths still line up.
+ */
+export function resolveDataTableHeaderBands(columns, groups) {
+    const owner = new Map();
+    for (const group of groups) {
+        assertNonEmpty(group.id, "column group id");
+        assertNonEmpty(group.header, `column group "${group.id}" header`);
+        for (const id of group.columns) {
+            if (owner.has(id))
+                throw new TypeError(`DataTable column "${String(id)}" belongs to two groups`);
+            owner.set(id, group);
+        }
+    }
+    const bands = [];
+    for (const column of columns) {
+        const group = owner.get(column.id) ?? null;
+        const last = bands.at(-1);
+        if (group && last && last.id === group.id) {
+            last.columnIds.push(column.id);
+            continue;
+        }
+        if (group && bands.some((band) => band.id === group.id))
+            throw new TypeError(`DataTable column group "${group.id}" must be contiguous`);
+        bands.push({ id: group ? group.id : `placeholder-${column.id}`, header: group ? group.header : null, columnIds: [column.id] });
+    }
+    return bands.map((band) => ({ ...band, span: band.columnIds.length }));
+}
+/** Flattens rows + groups into the body order renderers draw. Unknown or duplicated ids throw. */
+export function resolveDataTableBody(rows, groups = []) {
+    if (groups.length === 0)
+        return rows.map((row) => ({ kind: "row", id: row.id }));
+    const known = new Set(rows.map((row) => row.id)), placed = new Set();
+    const grouped = [];
+    for (const group of groups) {
+        assertNonEmpty(group.id, "row group id");
+        assertNonEmpty(group.label, `row group "${group.id}" label`);
+        grouped.push({ kind: "group", id: group.id, label: group.label });
+        for (const id of group.rows) {
+            if (!known.has(id))
+                throw new TypeError(`DataTable row group "${group.id}" references unknown row id: ${String(id)}`);
+            if (placed.has(id))
+                throw new TypeError(`DataTable row "${String(id)}" belongs to two row groups`);
+            placed.add(id);
+            grouped.push({ kind: "row", id });
+        }
+    }
+    const loose = rows.filter((row) => !placed.has(row.id)).map((row) => ({ kind: "row", id: row.id }));
+    return [...loose, ...grouped];
+}
+/**
+ * Percentile rank (0–100, best = 100) of `value` among `sample`. `lowerIsBetter` flips ERA-style stats.
+ * Ties take the midpoint rank, missing values return null. A one-value sample is the 50th percentile.
+ */
+export function percentileRank(value, sample, options = {}) {
+    if (value === null || value === undefined || !Number.isFinite(value))
+        return null;
+    const values = sample.filter((item) => item !== null && item !== undefined && Number.isFinite(item));
+    if (values.length <= 1)
+        return 50;
+    let below = 0, equal = 0;
+    for (const item of values) {
+        const better = options.lowerIsBetter ? item > value : item < value;
+        if (item === value)
+            equal++;
+        else if (better)
+            below++;
+    }
+    return Math.round(((below + (equal - 1) / 2) / (values.length - 1)) * 100);
+}
+/** Maps a percentile to heat: ≥90/≥75/≥60 high, ≤10/≤25/≤40 low, the middle stays neutral (null). */
+export function percentileHeat(percentile) {
+    if (percentile === null)
+        return null;
+    if (percentile >= 90)
+        return { side: "high", strength: 3 };
+    if (percentile >= 75)
+        return { side: "high", strength: 2 };
+    if (percentile >= 60)
+        return { side: "high", strength: 1 };
+    if (percentile <= 10)
+        return { side: "low", strength: 3 };
+    if (percentile <= 25)
+        return { side: "low", strength: 2 };
+    if (percentile <= 40)
+        return { side: "low", strength: 1 };
+    return null;
+}
+export const dataTableFamilyRecipe = {
+    /** Heat background alpha per strength, over the high/low base colors. */
+    heatAlpha: { 1: 0.14, 2: 0.26, 3: 0.42 },
+    heat: { high: themeColor("danger"), low: accentColor("info") },
+    tone: {
+        leader: { color: semanticColors.content.primary, fontWeight: fontWeight.bold },
+        positive: { color: themeColor("danger"), fontWeight: fontWeight.bold },
+        negative: { color: accentColor("info"), fontWeight: fontWeight.bold },
+        muted: { color: semanticColors.content.tertiary, fontWeight: fontWeight.regular },
+    },
+    groupRow: { background: semanticColors.surface.sunken, color: semanticColors.content.secondary, textVariant: "label" },
+    /** Indent per sub-row depth level (substitutes under a starter, players under a team). */
+    depthIndent: spacing.md,
+    headerBand: { color: semanticColors.content.secondary, borderBottom: semanticColors.border.subtle },
+};
+/**
+ * Period columns are padded to `minPeriods` (9 innings) and extend for extra innings; totals follow.
+ * The current period (live game) is reported so renderers can highlight it.
+ */
+export function resolveLineScore(teams, options) {
+    if (teams.length < 2)
+        throw new TypeError("LineScore needs at least two teams");
+    const ids = new Set();
+    for (const team of teams) {
+        assertNonEmpty(team.id, "line score team id");
+        if (ids.has(team.id))
+            throw new TypeError(`Duplicate LineScore team id: ${team.id}`);
+        ids.add(team.id);
+    }
+    const played = Math.max(...teams.map((team) => team.periods.length));
+    const count = Math.max(options.minPeriods ?? 9, played);
+    const columns = Array.from({ length: count }, (_, i) => ({ id: `p${i + 1}`, header: String(i + 1), kind: "period" }));
+    for (const total of options.totals)
+        columns.push({ id: `t-${total}`, header: total, kind: "total" });
+    const runs = options.totals[0];
+    let leaderId = null;
+    if (runs) {
+        const scores = teams.map((team) => ({ id: team.id, value: team.totals[runs] ?? null }));
+        const best = Math.max(...scores.map((score) => score.value ?? -Infinity));
+        const leaders = scores.filter((score) => score.value === best && Number.isFinite(best));
+        leaderId = leaders.length === 1 ? leaders[0].id : null;
+    }
+    const current = options.currentPeriod ?? null;
+    return { columns, currentPeriod: current !== null && current >= 1 && current <= count ? current : null, leaderId };
+}
+export function formatLineScoreCell(value) {
+    return value === null || value === undefined ? "" : String(value);
+}
+/**
+ * Square cross table (team × team head-to-head). Rows and columns share one id list; the diagonal is
+ * a self cell and renders blank. `getCell(row, column)` returns null for no record.
+ */
+export function resolveMatrix(ids, getCell) {
+    if (new Set(ids).size !== ids.length)
+        throw new TypeError("Matrix ids must be unique");
+    return ids.map((row) => ids.map((column) => (row === column ? "self" : getCell(row, column))));
+}
+/** Which side wins a row (null on ties/missing), and each side's bar share of the pair (0–1). */
+export function resolveComparisonRow(row) {
+    const [a, b] = row.values;
+    if (a === null || b === null || !Number.isFinite(a) || !Number.isFinite(b))
+        return { winner: null, shares: [a === null ? 0 : 0.5, b === null ? 0 : 0.5] };
+    const winner = a === b ? null : (row.lowerIsBetter ? a < b : a > b) ? 0 : 1;
+    // Lower-is-better rows invert the magnitudes so the better side still draws the longer bar.
+    const left = Math.abs(row.lowerIsBetter ? b : a), right = Math.abs(row.lowerIsBetter ? a : b), sum = left + right;
+    return { winner, shares: sum === 0 ? [0.5, 0.5] : [left / sum, right / sum] };
+}
 //# sourceMappingURL=data-table.js.map

package/dist/data-table.js.map

@@ -1 +1 @@
-{"version":3,"file":"data-table.js","sourceRoot":"","sources":["../src/data-table.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ColorReference } from \"./color-references.js\";\nimport type {\n  AsyncCollectionState,\n  BehaviorContract,\n  CheckboxState,\n  CollectionKey,\n  CollectionSelectionModel,\n} from \"./behaviors.js\";\nimport { collectionItemContract, focusIndicatorContract } from \"./component-contracts.js\";\nimport { control, fontWeight, spacing, type FontWeightValue, type TextVariant } from \"./foundations.js\";\nimport { semanticColors } from \"./semantic-colors.js\";\n\nexport type DataTableAlign = \"start\" | \"center\" | \"end\";\n\nexport type DataTableColumnDescriptor<Key extends CollectionKey = CollectionKey> = Readonly<{\n  id: Key;\n  /** Visible column header text; also the columnheader's accessible name. */\n  header: string;\n  align?: DataTableAlign;\n  sortable?: boolean;\n  /** Layout hint only (px or flex-basis); renderers may ignore or clamp it. */\n  width?: number;\n}>;\n\nexport const dataTableColumnDefaults = {\n  align: \"start\",\n  sortable: false,\n} as const satisfies Readonly<{ align: DataTableAlign; sortable: boolean }>;\n\nfunction assertNonEmpty(value: string, field: string): void {\n  if (typeof value !== \"string\" || value.trim().length === 0) {\n    throw new TypeError(`DataTable ${field} must not be empty`);\n  }\n}\n\nexport function validateDataTableColumns<Key extends CollectionKey>(\n  columns: readonly DataTableColumnDescriptor<Key>[],\n): void {\n  if (columns.length === 0) {\n    throw new TypeError(\"DataTable must declare at least one column\");\n  }\n  const ids = new Set<Key>();\n  for (const column of columns) {\n    assertNonEmpty(column.id, \"column id\");\n    if (ids.has(column.id)) {\n      throw new TypeError(`Duplicate DataTable column id: ${column.id}`);\n    }\n    ids.add(column.id);\n    assertNonEmpty(column.header, `column \"${column.id}\" header`);\n    if (column.width !== undefined && (!Number.isFinite(column.width) || column.width <= 0)) {\n      throw new RangeError(`DataTable column \"${column.id}\" width must be a positive finite number`);\n    }\n  }\n}\n\n/**\n * Row identity and selection deliberately do NOT reuse `CollectionItemDescriptor`\n * verbatim: a table row has no single visible `label`/`textValue` the way a\n * Menu or Select item does — its \"content\" is however many columns the\n * product renders per row. Only the parts of the Collection base contract\n * that are genuinely row-shaped (`CollectionKey` identity, `disabled`) apply.\n */\nexport type DataTableRowDescriptor<Key extends CollectionKey = CollectionKey> = Readonly<{\n  id: Key;\n  disabled?: boolean;\n}>;\n\nexport function validateDataTableRows<Key extends CollectionKey>(\n  rows: readonly DataTableRowDescriptor<Key>[],\n): void {\n  const ids = new Set<Key>();\n  for (const row of rows) {\n    assertNonEmpty(row.id, \"row id\");\n    if (ids.has(row.id)) {\n      throw new TypeError(`Duplicate DataTable row id: ${row.id}`);\n    }\n    ids.add(row.id);\n  }\n}\n\n/** Row selection is the unmodified Collection base contract — no DataTable-only selection shape. */\nexport type DataTableSelection<Key extends CollectionKey = CollectionKey> =\n  CollectionSelectionModel<Key>;\n\n/**\n * Header \"select all\" state as the same tri-state `CheckboxState` the\n * selection column's checkbox already renders (check/dash), instead of a new\n * `\"none\" | \"some\" | \"all\"` enum the recipe would have to translate again.\n * Disabled rows are excluded from both the denominator and the count.\n */\nexport function resolveDataTableSelectAllState<Key extends CollectionKey>(\n  rows: readonly DataTableRowDescriptor<Key>[],\n  selectedKeys: ReadonlySet<Key>,\n): CheckboxState {\n  const selectable = rows.filter((row) => !row.disabled);\n  if (selectable.length === 0) return false;\n  const selectedCount = selectable.filter((row) => selectedKeys.has(row.id)).length;\n  if (selectedCount === 0) return false;\n  if (selectedCount === selectable.length) return true;\n  return \"mixed\";\n}\n\n/**\n * Values are the literal `aria-sort` vocabulary (minus `\"none\"`, which is\n * `null`) so the Web renderer passes them through without a translation\n * table — the same \"pass the platform value through\" choice Slider makes\n * for `valueText`.\n */\nexport type DataTableSortDirection = \"ascending\" | \"descending\";\n\nexport type DataTableSortState<Key extends CollectionKey = CollectionKey> = Readonly<{\n  columnId: Key;\n  direction: DataTableSortDirection;\n}> | null;\n\nexport type DataTableSortCycle = \"two-state\" | \"three-state\";\n\nexport const dataTableDefaults = {\n  sortCycle: \"three-state\",\n} as const satisfies Readonly<{ sortCycle: DataTableSortCycle }>;\n\nexport function validateDataTableSortState<Key extends CollectionKey>(\n  state: DataTableSortState<Key>,\n  columns: readonly DataTableColumnDescriptor<Key>[],\n): void {\n  if (state === null) return;\n  if (state.direction !== \"ascending\" && state.direction !== \"descending\") {\n    throw new TypeError(`Unsupported DataTable sort direction: ${String(state.direction)}`);\n  }\n  const column = columns.find((candidate) => candidate.id === state.columnId);\n  if (!column) {\n    throw new TypeError(`DataTable sort references unknown column id: ${String(state.columnId)}`);\n  }\n  if (!column.sortable) {\n    throw new TypeError(`DataTable column \"${String(state.columnId)}\" is not sortable`);\n  }\n}\n\n/**\n * Pure toggle: does not read or write product data. The product still owns\n * actually re-sorting rows (Combobox's local/external filtering split is the\n * same boundary — HJM judges intent, never executes the data operation).\n */\nexport function getNextDataTableSortState<Key extends CollectionKey>(\n  current: DataTableSortState<Key>,\n  columnId: Key,\n  cycle: DataTableSortCycle = dataTableDefaults.sortCycle,\n): DataTableSortState<Key> {\n  if (current === null || current.columnId !== columnId) {\n    return { columnId, direction: \"ascending\" };\n  }\n  if (current.direction === \"ascending\") {\n    return { columnId, direction: \"descending\" };\n  }\n  return cycle === \"three-state\" ? null : { columnId, direction: \"ascending\" };\n}\n\n/** The whole table's row-loading status — the unmodified Collection base async contract. */\nexport type DataTableAsyncState = AsyncCollectionState;\n\nexport type DataTableDensity = \"compact\" | \"regular\";\n\n/**\n * Reuses `collectionItemContract`'s hover/selected/focus tokens instead of a\n * second set of row-interaction colors — Menu, Select, and DataTable rows\n * stay one visual vocabulary.\n */\nexport const dataTableRecipe = {\n  slots: [\n    \"root\",\n    \"header\",\n    \"headerCell\",\n    \"sortButton\",\n    \"sortIcon\",\n    \"row\",\n    \"cell\",\n    \"selectionCell\",\n    \"emptyState\",\n    \"errorState\",\n  ] as const,\n  defaults: { density: \"regular\" },\n  density: {\n    compact: { paddingVertical: spacing.xs, paddingHorizontal: spacing.sm },\n    regular: { paddingVertical: spacing.sm, paddingHorizontal: spacing.md },\n  },\n  header: {\n    background: semanticColors.canvas,\n    color: semanticColors.content.secondary,\n    textVariant: \"label\",\n    fontWeight: fontWeight.bold,\n    borderBottom: semanticColors.border.default,\n  },\n  row: {\n    borderBottom: semanticColors.border.subtle,\n    hoverBackground: collectionItemContract.highlightedBackground,\n    selectedBackground: collectionItemContract.selectedBackground,\n  },\n  cell: {\n    color: semanticColors.content.body,\n    textVariant: \"body\",\n  },\n  sortButton: {\n    minTarget: control.minTouchTarget,\n    color: semanticColors.content.secondary,\n    activeColor: semanticColors.content.brand,\n  },\n  selectionCell: {\n    width: control.minTouchTarget,\n  },\n  emptyState: {\n    color: semanticColors.content.secondary,\n    textVariant: \"body\",\n  },\n  errorState: {\n    color: semanticColors.content.danger,\n    textVariant: \"body\",\n  },\n  states: {\n    focus: focusIndicatorContract,\n  },\n} as const satisfies {\n  slots: readonly [\n    \"root\",\n    \"header\",\n    \"headerCell\",\n    \"sortButton\",\n    \"sortIcon\",\n    \"row\",\n    \"cell\",\n    \"selectionCell\",\n    \"emptyState\",\n    \"errorState\",\n  ];\n  defaults: { density: DataTableDensity };\n  density: Record<DataTableDensity, { paddingVertical: number; paddingHorizontal: number }>;\n  header: {\n    background: ColorReference;\n    color: ColorReference;\n    textVariant: TextVariant;\n    fontWeight: FontWeightValue;\n    borderBottom: ColorReference;\n  };\n  row: {\n    borderBottom: ColorReference;\n    hoverBackground: ColorReference;\n    selectedBackground: ColorReference;\n  };\n  cell: { color: ColorReference; textVariant: TextVariant };\n  sortButton: { minTarget: number; color: ColorReference; activeColor: ColorReference };\n  selectionCell: { width: number };\n  emptyState: { color: ColorReference; textVariant: TextVariant };\n  errorState: { color: ColorReference; textVariant: TextVariant };\n  states: { focus: typeof focusIndicatorContract };\n};\n\n/**\n * No roving-tabindex grid keyboard navigation (arrow keys between cells):\n * no product using this contract has measured demand for full ARIA-grid\n * traversal, and it is a materially bigger accessibility surface than a\n * sortable header button plus native checkbox/radio tab stops.\n */\nexport const dataTableBehavior = {\n  controlled: [\"selection\"],\n  inputs: [\"columns\", \"rows\", \"sortState\", \"asyncState\"],\n  events: [\"onSortChange\"],\n  configuration: { sortCycle: [\"two-state\", \"three-state\"] },\n  defaults: dataTableDefaults,\n  stateAxes: {\n    value: [\"selected\"],\n    content: [\"idle\", \"loading\", \"loadingMore\", \"empty\", \"error\"],\n  },\n  web: {\n    roles: [\"table\", \"row\", \"columnheader\", \"cell\", \"button\", \"checkbox\", \"radio\"],\n    keyboard: [\"Tab\", \"Enter\", \"Space\"],\n    focus: \"native\",\n  },\n  native: { roles: [], states: [], actions: [] },\n  scenarios: [\n    \"row-selection-reuses-the-shared-collection-selection-model-unchanged\",\n    \"select-all-reuses-the-shared-tri-state-checkbox-value\",\n    \"async-state-reuses-the-shared-collection-async-state-unchanged\",\n    \"sortable-header-is-a-button-inside-the-columnheader-not-the-header-itself\",\n    \"sort-direction-values-pass-through-to-aria-sort-without-translation\",\n    \"disabled-rows-are-excluded-from-select-all-accounting\",\n    \"pagination-or-load-more-is-composed-beneath-the-table-not-owned-by-it\",\n    \"row-expansion-is-not-owned-here-compose-the-disclosure-group-contract-per-row\",\n    \"a-data-cell-exposes-at-most-one-focusable-control\",\n    \"no-roving-tabindex-grid-navigation-is-implied\",\n  ],\n} as const satisfies BehaviorContract;\n"]}
+{"version":3,"file":"data-table.js","sourceRoot":"","sources":["../src/data-table.ts"],"names":[],"mappings":"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","sourcesContent":["import { accentColor, themeColor, type ColorReference } from \"./color-references.js\";\nimport type {\n  AsyncCollectionState,\n  BehaviorContract,\n  CheckboxState,\n  CollectionKey,\n  CollectionSelectionModel,\n} from \"./behaviors.js\";\nimport { collectionItemContract, focusIndicatorContract } from \"./component-contracts.js\";\nimport { control, fontWeight, spacing, type FontWeightValue, type TextVariant } from \"./foundations.js\";\nimport { semanticColors } from \"./semantic-colors.js\";\n\nexport type DataTableAlign = \"start\" | \"center\" | \"end\";\n\nexport type DataTableColumnDescriptor<Key extends CollectionKey = CollectionKey> = Readonly<{\n  id: Key;\n  /** Visible column header text; also the columnheader's accessible name. */\n  header: string;\n  align?: DataTableAlign;\n  sortable?: boolean;\n  /** Layout hint only (px or flex-basis); renderers may ignore or clamp it. */\n  width?: number;\n  /**\n   * First press sorts descending (TanStack Table `sortDescFirst`). Stat tables read \"highest first\";\n   * lower-is-better columns (ERA, rank) leave it false. Added 2026-10-14 with the Native renderer.\n   */\n  sortDescFirst?: boolean;\n  /**\n   * Keeps the column visible while the others scroll horizontally (AG Grid / TanStack column\n   * pinning, start edge only). Only a leading run of pinned columns is honored.\n   */\n  pinned?: \"start\";\n}>;\n\nexport const dataTableColumnDefaults = {\n  align: \"start\",\n  sortable: false,\n} as const satisfies Readonly<{ align: DataTableAlign; sortable: boolean }>;\n\nfunction assertNonEmpty(value: string, field: string): void {\n  if (typeof value !== \"string\" || value.trim().length === 0) {\n    throw new TypeError(`DataTable ${field} must not be empty`);\n  }\n}\n\nexport function validateDataTableColumns<Key extends CollectionKey>(\n  columns: readonly DataTableColumnDescriptor<Key>[],\n): void {\n  if (columns.length === 0) {\n    throw new TypeError(\"DataTable must declare at least one column\");\n  }\n  const ids = new Set<Key>();\n  for (const column of columns) {\n    assertNonEmpty(column.id, \"column id\");\n    if (ids.has(column.id)) {\n      throw new TypeError(`Duplicate DataTable column id: ${column.id}`);\n    }\n    ids.add(column.id);\n    assertNonEmpty(column.header, `column \"${column.id}\" header`);\n    if (column.width !== undefined && (!Number.isFinite(column.width) || column.width <= 0)) {\n      throw new RangeError(`DataTable column \"${column.id}\" width must be a positive finite number`);\n    }\n  }\n}\n\n/**\n * Row identity and selection deliberately do NOT reuse `CollectionItemDescriptor`\n * verbatim: a table row has no single visible `label`/`textValue` the way a\n * Menu or Select item does — its \"content\" is however many columns the\n * product renders per row. Only the parts of the Collection base contract\n * that are genuinely row-shaped (`CollectionKey` identity, `disabled`) apply.\n */\nexport type DataTableRowDescriptor<Key extends CollectionKey = CollectionKey> = Readonly<{\n  id: Key;\n  disabled?: boolean;\n  /** Sub-row nesting (TanStack `depth`): 1 indents a substitute under a starter. 0–3. */\n  depth?: number;\n}>;\n\nexport function validateDataTableRows<Key extends CollectionKey>(\n  rows: readonly DataTableRowDescriptor<Key>[],\n): void {\n  const ids = new Set<Key>();\n  for (const row of rows) {\n    assertNonEmpty(row.id, \"row id\");\n    if (ids.has(row.id)) {\n      throw new TypeError(`Duplicate DataTable row id: ${row.id}`);\n    }\n    ids.add(row.id);\n    if (row.depth !== undefined && (!Number.isInteger(row.depth) || row.depth < 0 || row.depth > 3)) {\n      throw new RangeError(`DataTable row \"${String(row.id)}\" depth must be an integer from 0 to 3`);\n    }\n  }\n}\n\n/** Row selection is the unmodified Collection base contract — no DataTable-only selection shape. */\nexport type DataTableSelection<Key extends CollectionKey = CollectionKey> =\n  CollectionSelectionModel<Key>;\n\n/**\n * Header \"select all\" state as the same tri-state `CheckboxState` the\n * selection column's checkbox already renders (check/dash), instead of a new\n * `\"none\" | \"some\" | \"all\"` enum the recipe would have to translate again.\n * Disabled rows are excluded from both the denominator and the count.\n */\nexport function resolveDataTableSelectAllState<Key extends CollectionKey>(\n  rows: readonly DataTableRowDescriptor<Key>[],\n  selectedKeys: ReadonlySet<Key>,\n): CheckboxState {\n  const selectable = rows.filter((row) => !row.disabled);\n  if (selectable.length === 0) return false;\n  const selectedCount = selectable.filter((row) => selectedKeys.has(row.id)).length;\n  if (selectedCount === 0) return false;\n  if (selectedCount === selectable.length) return true;\n  return \"mixed\";\n}\n\n/**\n * Values are the literal `aria-sort` vocabulary (minus `\"none\"`, which is\n * `null`) so the Web renderer passes them through without a translation\n * table — the same \"pass the platform value through\" choice Slider makes\n * for `valueText`.\n */\nexport type DataTableSortDirection = \"ascending\" | \"descending\";\n\nexport type DataTableSortState<Key extends CollectionKey = CollectionKey> = Readonly<{\n  columnId: Key;\n  direction: DataTableSortDirection;\n}> | null;\n\nexport type DataTableSortCycle = \"two-state\" | \"three-state\";\n\nexport const dataTableDefaults = {\n  sortCycle: \"three-state\",\n} as const satisfies Readonly<{ sortCycle: DataTableSortCycle }>;\n\nexport function validateDataTableSortState<Key extends CollectionKey>(\n  state: DataTableSortState<Key>,\n  columns: readonly DataTableColumnDescriptor<Key>[],\n): void {\n  if (state === null) return;\n  if (state.direction !== \"ascending\" && state.direction !== \"descending\") {\n    throw new TypeError(`Unsupported DataTable sort direction: ${String(state.direction)}`);\n  }\n  const column = columns.find((candidate) => candidate.id === state.columnId);\n  if (!column) {\n    throw new TypeError(`DataTable sort references unknown column id: ${String(state.columnId)}`);\n  }\n  if (!column.sortable) {\n    throw new TypeError(`DataTable column \"${String(state.columnId)}\" is not sortable`);\n  }\n}\n\n/**\n * Pure toggle: does not read or write product data. The product still owns\n * actually re-sorting rows (Combobox's local/external filtering split is the\n * same boundary — HJM judges intent, never executes the data operation).\n */\nexport function getNextDataTableSortState<Key extends CollectionKey>(\n  current: DataTableSortState<Key>,\n  columnId: Key,\n  cycle: DataTableSortCycle = dataTableDefaults.sortCycle,\n  firstDirection: DataTableSortDirection = \"ascending\",\n): DataTableSortState<Key> {\n  const second: DataTableSortDirection = firstDirection === \"ascending\" ? \"descending\" : \"ascending\";\n  if (current === null || current.columnId !== columnId) {\n    return { columnId, direction: firstDirection };\n  }\n  if (current.direction === firstDirection) {\n    return { columnId, direction: second };\n  }\n  return cycle === \"three-state\" ? null : { columnId, direction: firstDirection };\n}\n\n/** The first direction a column's header applies, from `sortDescFirst`. */\nexport function dataTableFirstSortDirection(column: Pick<DataTableColumnDescriptor, \"sortDescFirst\">): DataTableSortDirection {\n  return column.sortDescFirst ? \"descending\" : \"ascending\";\n}\n\nexport type DataTableSortValue = number | string | null | undefined;\n\n/**\n * Sort key for a displayed cell string: \"0.340\", \".340\", \"36 ⅓\", \"13.5억\", \"61.0%\" → numbers;\n * text such as \"7승0무3패\" or names stay strings; \"—\", \"-\" and \"\" are missing.\n */\nexport function toDataTableSortValue(value: unknown): DataTableSortValue {\n  if (value === null || value === undefined) return null;\n  if (typeof value === \"number\") return Number.isFinite(value) ? value : null;\n  const text = String(value).trim();\n  if (!text || text === \"—\" || text === \"-\" || text === \"–\") return null;\n  // Two or more letters (any script) mean a label, not a number with a unit.\n  if (/\\p{L}.*\\p{L}/u.test(text.replace(/[⅓⅔]/g, \"\"))) return text;\n  const number = Number.parseFloat(text.replace(/[^0-9.+-]/g, \"\"));\n  return Number.isFinite(number) ? number : text;\n}\n\n/**\n * Pure comparison: numbers numerically, strings with `localeCompare`, numbers before strings.\n * Missing values are not compared here; `sortDataTableRows` always sinks them.\n */\nexport function compareDataTableValues(a: Exclude<DataTableSortValue, null | undefined>, b: Exclude<DataTableSortValue, null | undefined>, locale?: string): number {\n  if (typeof a === \"number\" && typeof b === \"number\") return a - b;\n  if (typeof a === \"number\") return -1;\n  if (typeof b === \"number\") return 1;\n  return a.localeCompare(b, locale);\n}\n\n/**\n * Optional row-model helper (TanStack `getSortedRowModel` with `sortUndefined: \"last\"`): stable,\n * missing values always last in both directions. 1.20 left all sorting to products; Yajalal and\n * other stat tables reimplemented the same rules, so the shared helper exists now. Products with\n * server-side sorting keep calling `getNextDataTableSortState` only.\n */\nexport function sortDataTableRows<Row, Key extends CollectionKey>(\n  rows: readonly Row[],\n  sort: DataTableSortState<Key>,\n  getValue: (row: Row, columnId: Key) => DataTableSortValue,\n  options: Readonly<{ locale?: string }> = {},\n): Row[] {\n  const indexed = rows.map((row, index) => ({ row, index }));\n  if (!sort) return indexed.map(item => item.row);\n  const sign = sort.direction === \"ascending\" ? 1 : -1;\n  return indexed.sort((x, y) => {\n    const a = getValue(x.row, sort.columnId), b = getValue(y.row, sort.columnId);\n    const missingA = a === null || a === undefined, missingB = b === null || b === undefined;\n    if (missingA || missingB) return missingA === missingB ? x.index - y.index : missingA ? 1 : -1;\n    return sign * compareDataTableValues(a, b, options.locale) || x.index - y.index;\n  }).map(item => item.row);\n}\n\n/** Leading pinned columns (only an unbroken run from the start is pinned). */\nexport function splitPinnedDataTableColumns<Column extends Pick<DataTableColumnDescriptor, \"pinned\">>(columns: readonly Column[]): Readonly<{ pinned: readonly Column[]; scrolling: readonly Column[] }> {\n  let count = 0;\n  while (count < columns.length && columns[count]!.pinned === \"start\") count++;\n  return { pinned: columns.slice(0, count), scrolling: columns.slice(count) };\n}\n\n/** The whole table's row-loading status — the unmodified Collection base async contract. */\nexport type DataTableAsyncState = AsyncCollectionState;\n\nexport type DataTableDensity = \"compact\" | \"regular\";\n\n/**\n * Reuses `collectionItemContract`'s hover/selected/focus tokens instead of a\n * second set of row-interaction colors — Menu, Select, and DataTable rows\n * stay one visual vocabulary.\n */\nexport const dataTableRecipe = {\n  slots: [\n    \"root\",\n    \"header\",\n    \"headerCell\",\n    \"sortButton\",\n    \"sortIcon\",\n    \"row\",\n    \"cell\",\n    \"selectionCell\",\n    \"emptyState\",\n    \"errorState\",\n  ] as const,\n  defaults: { density: \"regular\" },\n  density: {\n    compact: { paddingVertical: spacing.xs, paddingHorizontal: spacing.sm },\n    regular: { paddingVertical: spacing.sm, paddingHorizontal: spacing.md },\n  },\n  header: {\n    background: semanticColors.canvas,\n    color: semanticColors.content.secondary,\n    textVariant: \"label\",\n    fontWeight: fontWeight.bold,\n    borderBottom: semanticColors.border.default,\n  },\n  row: {\n    borderBottom: semanticColors.border.subtle,\n    hoverBackground: collectionItemContract.highlightedBackground,\n    selectedBackground: collectionItemContract.selectedBackground,\n  },\n  cell: {\n    color: semanticColors.content.body,\n    textVariant: \"body\",\n  },\n  sortButton: {\n    minTarget: control.minTouchTarget,\n    color: semanticColors.content.secondary,\n    activeColor: semanticColors.content.brand,\n  },\n  selectionCell: {\n    width: control.minTouchTarget,\n  },\n  emptyState: {\n    color: semanticColors.content.secondary,\n    textVariant: \"body\",\n  },\n  errorState: {\n    color: semanticColors.content.danger,\n    textVariant: \"body\",\n  },\n  states: {\n    focus: focusIndicatorContract,\n  },\n} as const satisfies {\n  slots: readonly [\n    \"root\",\n    \"header\",\n    \"headerCell\",\n    \"sortButton\",\n    \"sortIcon\",\n    \"row\",\n    \"cell\",\n    \"selectionCell\",\n    \"emptyState\",\n    \"errorState\",\n  ];\n  defaults: { density: DataTableDensity };\n  density: Record<DataTableDensity, { paddingVertical: number; paddingHorizontal: number }>;\n  header: {\n    background: ColorReference;\n    color: ColorReference;\n    textVariant: TextVariant;\n    fontWeight: FontWeightValue;\n    borderBottom: ColorReference;\n  };\n  row: {\n    borderBottom: ColorReference;\n    hoverBackground: ColorReference;\n    selectedBackground: ColorReference;\n  };\n  cell: { color: ColorReference; textVariant: TextVariant };\n  sortButton: { minTarget: number; color: ColorReference; activeColor: ColorReference };\n  selectionCell: { width: number };\n  emptyState: { color: ColorReference; textVariant: TextVariant };\n  errorState: { color: ColorReference; textVariant: TextVariant };\n  states: { focus: typeof focusIndicatorContract };\n};\n\nexport const dataTableFamilyScenarios = [\n  \"header-groups-span-contiguous-leaf-columns-and-pad-ungrouped-columns\",\n  \"row-groups-insert-a-section-label-before-their-rows\",\n  \"cell-tone-and-heat-are-product-decided-semantic-emphasis\",\n  \"percentile-rank-flips-for-lower-is-better-stats-and-ties-take-the-midpoint\",\n  \"bounded-height-tables-keep-the-header-fixed-while-the-body-scrolls\",\n  \"line-score-pads-to-nine-periods-and-extends-for-extra-periods\",\n  \"matrix-diagonal-is-a-blank-self-cell\",\n  \"comparison-bars-favor-the-better-side-even-when-lower-is-better\",\n] as const;\n\n/**\n * No roving-tabindex grid keyboard navigation (arrow keys between cells):\n * no product using this contract has measured demand for full ARIA-grid\n * traversal, and it is a materially bigger accessibility surface than a\n * sortable header button plus native checkbox/radio tab stops.\n */\nexport const dataTableBehavior = {\n  controlled: [\"selection\"],\n  inputs: [\"columns\", \"rows\", \"sortState\", \"asyncState\"],\n  events: [\"onSortChange\"],\n  configuration: { sortCycle: [\"two-state\", \"three-state\"] },\n  defaults: dataTableDefaults,\n  stateAxes: {\n    value: [\"selected\"],\n    content: [\"idle\", \"loading\", \"loadingMore\", \"empty\", \"error\"],\n  },\n  web: {\n    roles: [\"table\", \"row\", \"columnheader\", \"cell\", \"button\", \"checkbox\", \"radio\"],\n    keyboard: [\"Tab\", \"Enter\", \"Space\"],\n    focus: \"native\",\n  },\n  native: { roles: [\"button\", \"header\"], states: [\"selected\"], actions: [\"activate\"] },\n  scenarios: [\n    \"sort-desc-first-columns-start-descending-and-cycle-back\",\n    \"missing-values-sink-to-the-bottom-in-both-directions\",\n    \"pinned-start-columns-stay-visible-while-the-rest-scrolls\",\n    \"row-selection-reuses-the-shared-collection-selection-model-unchanged\",\n    \"select-all-reuses-the-shared-tri-state-checkbox-value\",\n    \"async-state-reuses-the-shared-collection-async-state-unchanged\",\n    \"sortable-header-is-a-button-inside-the-columnheader-not-the-header-itself\",\n    \"sort-direction-values-pass-through-to-aria-sort-without-translation\",\n    \"disabled-rows-are-excluded-from-select-all-accounting\",\n    \"pagination-or-load-more-is-composed-beneath-the-table-not-owned-by-it\",\n    \"row-expansion-is-not-owned-here-compose-the-disclosure-group-contract-per-row\",\n    \"a-data-cell-exposes-at-most-one-focusable-control\",\n    \"no-roving-tabindex-grid-navigation-is-implied\",\n    ...dataTableFamilyScenarios,\n  ],\n} as const satisfies BehaviorContract;\n\n/* ------------------------------------------------------------------------------------------------\n * Table family, 2026-10-14 (user request: research table libraries and absorb several table types).\n * Concepts re-derived, nothing vendored:\n * - column header groups (TanStack Table `getHeaderGroups`, AG Grid column groups),\n * - row groups with a section label and indented sub-rows (AG Grid row grouping, TanStack expanding),\n * - conditional cell tone and percentile heat (AG Grid `cellClassRules`/cellStyle heatmaps,\n *   Baseball Savant percentile color: deeper red toward the best, deeper blue toward the worst),\n * - a vertically bounded body with a fixed header (react-native-sticky-table, CSS sticky headers),\n * - sports layouts that products kept hand-building: line score (period columns + totals, MLB/ESPN),\n *   cross-table matrix (head-to-head records), and two-sided comparison rows (ESPN matchup).\n * ---------------------------------------------------------------------------------------------- */\n\n/** One header band above leaf columns. Columns not listed in any group get an empty placeholder cell. */\nexport type DataTableColumnGroup<Key extends CollectionKey = CollectionKey> = Readonly<{\n  id: string;\n  header: string;\n  columns: readonly Key[];\n}>;\n\nexport type DataTableHeaderBand = Readonly<{ id: string; header: string | null; span: number; columnIds: readonly string[] }>;\n\n/**\n * Resolves group bands over the given (already pinned-split) column order. A group must cover a\n * contiguous run; columns outside every group become placeholder bands so leaf widths still line up.\n */\nexport function resolveDataTableHeaderBands<Key extends CollectionKey>(\n  columns: readonly Pick<DataTableColumnDescriptor<Key>, \"id\">[],\n  groups: readonly DataTableColumnGroup<Key>[],\n): DataTableHeaderBand[] {\n  const owner = new Map<Key, DataTableColumnGroup<Key>>();\n  for (const group of groups) {\n    assertNonEmpty(group.id, \"column group id\");\n    assertNonEmpty(group.header, `column group \"${group.id}\" header`);\n    for (const id of group.columns) {\n      if (owner.has(id)) throw new TypeError(`DataTable column \"${String(id)}\" belongs to two groups`);\n      owner.set(id, group);\n    }\n  }\n  const bands: { id: string; header: string | null; columnIds: string[] }[] = [];\n  for (const column of columns) {\n    const group = owner.get(column.id) ?? null;\n    const last = bands.at(-1);\n    if (group && last && last.id === group.id) { last.columnIds.push(column.id); continue; }\n    if (group && bands.some((band) => band.id === group.id)) throw new TypeError(`DataTable column group \"${group.id}\" must be contiguous`);\n    bands.push({ id: group ? group.id : `placeholder-${column.id}`, header: group ? group.header : null, columnIds: [column.id] });\n  }\n  return bands.map((band) => ({ ...band, span: band.columnIds.length }));\n}\n\n/** Labeled row section (e.g. 선발 / 교체, 동부 / 서부). Rows not in any group render first, ungrouped. */\nexport type DataTableRowGroup<Key extends CollectionKey = CollectionKey> = Readonly<{\n  id: string;\n  label: string;\n  rows: readonly Key[];\n}>;\n\nexport type DataTableBodyItem<Key extends CollectionKey = CollectionKey> =\n  | Readonly<{ kind: \"group\"; id: string; label: string }>\n  | Readonly<{ kind: \"row\"; id: Key }>;\n\n/** Flattens rows + groups into the body order renderers draw. Unknown or duplicated ids throw. */\nexport function resolveDataTableBody<Key extends CollectionKey>(\n  rows: readonly DataTableRowDescriptor<Key>[],\n  groups: readonly DataTableRowGroup<Key>[] = [],\n): DataTableBodyItem<Key>[] {\n  if (groups.length === 0) return rows.map((row) => ({ kind: \"row\", id: row.id }));\n  const known = new Set(rows.map((row) => row.id)), placed = new Set<Key>();\n  const grouped: DataTableBodyItem<Key>[] = [];\n  for (const group of groups) {\n    assertNonEmpty(group.id, \"row group id\");\n    assertNonEmpty(group.label, `row group \"${group.id}\" label`);\n    grouped.push({ kind: \"group\", id: group.id, label: group.label });\n    for (const id of group.rows) {\n      if (!known.has(id)) throw new TypeError(`DataTable row group \"${group.id}\" references unknown row id: ${String(id)}`);\n      if (placed.has(id)) throw new TypeError(`DataTable row \"${String(id)}\" belongs to two row groups`);\n      placed.add(id);\n      grouped.push({ kind: \"row\", id });\n    }\n  }\n  const loose: DataTableBodyItem<Key>[] = rows.filter((row) => !placed.has(row.id)).map((row) => ({ kind: \"row\", id: row.id }));\n  return [...loose, ...grouped];\n}\n\n/**\n * Semantic cell emphasis, decided by the product per cell (AG Grid cellClassRules):\n * `leader` marks a league/table best, `positive`/`negative` a direction, `muted` a non-qualifying value.\n */\nexport type DataTableCellTone = \"leader\" | \"positive\" | \"negative\" | \"muted\";\n\n/** Percentile heat (Savant): `high` side toward the best values, `low` toward the worst; strength 1–3. */\nexport type DataTableCellHeat = Readonly<{ side: \"high\" | \"low\"; strength: 1 | 2 | 3 }>;\n\n/**\n * Percentile rank (0–100, best = 100) of `value` among `sample`. `lowerIsBetter` flips ERA-style stats.\n * Ties take the midpoint rank, missing values return null. A one-value sample is the 50th percentile.\n */\nexport function percentileRank(value: number | null | undefined, sample: readonly (number | null | undefined)[], options: Readonly<{ lowerIsBetter?: boolean }> = {}): number | null {\n  if (value === null || value === undefined || !Number.isFinite(value)) return null;\n  const values = sample.filter((item): item is number => item !== null && item !== undefined && Number.isFinite(item));\n  if (values.length <= 1) return 50;\n  let below = 0, equal = 0;\n  for (const item of values) {\n    const better = options.lowerIsBetter ? item > value : item < value;\n    if (item === value) equal++;\n    else if (better) below++;\n  }\n  return Math.round(((below + (equal - 1) / 2) / (values.length - 1)) * 100);\n}\n\n/** Maps a percentile to heat: ≥90/≥75/≥60 high, ≤10/≤25/≤40 low, the middle stays neutral (null). */\nexport function percentileHeat(percentile: number | null): DataTableCellHeat | null {\n  if (percentile === null) return null;\n  if (percentile >= 90) return { side: \"high\", strength: 3 };\n  if (percentile >= 75) return { side: \"high\", strength: 2 };\n  if (percentile >= 60) return { side: \"high\", strength: 1 };\n  if (percentile <= 10) return { side: \"low\", strength: 3 };\n  if (percentile <= 25) return { side: \"low\", strength: 2 };\n  if (percentile <= 40) return { side: \"low\", strength: 1 };\n  return null;\n}\n\nexport const dataTableFamilyRecipe = {\n  /** Heat background alpha per strength, over the high/low base colors. */\n  heatAlpha: { 1: 0.14, 2: 0.26, 3: 0.42 },\n  heat: { high: themeColor(\"danger\"), low: accentColor(\"info\") },\n  tone: {\n    leader: { color: semanticColors.content.primary, fontWeight: fontWeight.bold },\n    positive: { color: themeColor(\"danger\"), fontWeight: fontWeight.bold },\n    negative: { color: accentColor(\"info\"), fontWeight: fontWeight.bold },\n    muted: { color: semanticColors.content.tertiary, fontWeight: fontWeight.regular },\n  },\n  groupRow: { background: semanticColors.surface.sunken, color: semanticColors.content.secondary, textVariant: \"label\" as TextVariant },\n  /** Indent per sub-row depth level (substitutes under a starter, players under a team). */\n  depthIndent: spacing.md,\n  headerBand: { color: semanticColors.content.secondary, borderBottom: semanticColors.border.subtle },\n} as const;\n\n/* ---------------------------------------------- Line score ------------------------------------- */\n\nexport type LineScoreTeam = Readonly<{\n  id: string;\n  name: string;\n  /** Runs per period; null = not played yet, \"X\" = home team did not bat in the last inning. */\n  periods: readonly (number | \"X\" | null)[];\n  /** Totals in display order, e.g. { R: 5, H: 9, E: 0, B: 4 }. */\n  totals: Readonly<Record<string, number | null>>;\n}>;\n\nexport type LineScoreColumn = Readonly<{ id: string; header: string; kind: \"period\" | \"total\" }>;\n\n/**\n * Period columns are padded to `minPeriods` (9 innings) and extend for extra innings; totals follow.\n * The current period (live game) is reported so renderers can highlight it.\n */\nexport function resolveLineScore(teams: readonly LineScoreTeam[], options: Readonly<{ minPeriods?: number; totals: readonly string[]; currentPeriod?: number | null }>): Readonly<{ columns: LineScoreColumn[]; currentPeriod: number | null; leaderId: string | null }> {\n  if (teams.length < 2) throw new TypeError(\"LineScore needs at least two teams\");\n  const ids = new Set<string>();\n  for (const team of teams) {\n    assertNonEmpty(team.id, \"line score team id\");\n    if (ids.has(team.id)) throw new TypeError(`Duplicate LineScore team id: ${team.id}`);\n    ids.add(team.id);\n  }\n  const played = Math.max(...teams.map((team) => team.periods.length));\n  const count = Math.max(options.minPeriods ?? 9, played);\n  const columns: LineScoreColumn[] = Array.from({ length: count }, (_, i) => ({ id: `p${i + 1}`, header: String(i + 1), kind: \"period\" }));\n  for (const total of options.totals) columns.push({ id: `t-${total}`, header: total, kind: \"total\" });\n  const runs = options.totals[0];\n  let leaderId: string | null = null;\n  if (runs) {\n    const scores = teams.map((team) => ({ id: team.id, value: team.totals[runs] ?? null }));\n    const best = Math.max(...scores.map((score) => score.value ?? -Infinity));\n    const leaders = scores.filter((score) => score.value === best && Number.isFinite(best));\n    leaderId = leaders.length === 1 ? leaders[0]!.id : null;\n  }\n  const current = options.currentPeriod ?? null;\n  return { columns, currentPeriod: current !== null && current >= 1 && current <= count ? current : null, leaderId };\n}\n\nexport function formatLineScoreCell(value: number | \"X\" | null | undefined): string {\n  return value === null || value === undefined ? \"\" : String(value);\n}\n\n/* ---------------------------------------------- Matrix table ----------------------------------- */\n\nexport type MatrixCell = Readonly<{ label: string; tone?: DataTableCellTone | null; heat?: DataTableCellHeat | null }>;\n\n/**\n * Square cross table (team × team head-to-head). Rows and columns share one id list; the diagonal is\n * a self cell and renders blank. `getCell(row, column)` returns null for no record.\n */\nexport function resolveMatrix<Key extends string>(ids: readonly Key[], getCell: (row: Key, column: Key) => MatrixCell | null): readonly (readonly (MatrixCell | \"self\" | null)[])[] {\n  if (new Set(ids).size !== ids.length) throw new TypeError(\"Matrix ids must be unique\");\n  return ids.map((row) => ids.map((column) => (row === column ? \"self\" : getCell(row, column))));\n}\n\n/* ---------------------------------------------- Comparison table ------------------------------- */\n\nexport type ComparisonRow = Readonly<{\n  id: string;\n  label: string;\n  values: readonly [number | null, number | null];\n  /** Display strings; defaults to String(value). */\n  display?: readonly [string, string];\n  lowerIsBetter?: boolean;\n}>;\n\n/** Which side wins a row (null on ties/missing), and each side's bar share of the pair (0–1). */\nexport function resolveComparisonRow(row: ComparisonRow): Readonly<{ winner: 0 | 1 | null; shares: readonly [number, number] }> {\n  const [a, b] = row.values;\n  if (a === null || b === null || !Number.isFinite(a) || !Number.isFinite(b)) return { winner: null, shares: [a === null ? 0 : 0.5, b === null ? 0 : 0.5] };\n  const winner = a === b ? null : (row.lowerIsBetter ? a < b : a > b) ? 0 : 1;\n  // Lower-is-better rows invert the magnitudes so the better side still draws the longer bar.\n  const left = Math.abs(row.lowerIsBetter ? b : a), right = Math.abs(row.lowerIsBetter ? a : b), sum = left + right;\n  return { winner, shares: sum === 0 ? [0.5, 0.5] : [left / sum, right / sum] };\n}\n\n"]}

package/dist/data-workflows.d.ts

@@ -0,0 +1,70 @@
+export type WorkflowField = Readonly<{
+    id: string;
+    label: string;
+    required?: boolean;
+}>;
+export type ImportMapping = Readonly<Record<string, string | null>>;
+export declare function resolveImportMapping(sources: readonly WorkflowField[], targets: readonly WorkflowField[], mapping: ImportMapping): {
+    valid: boolean;
+    duplicateTargets: string[];
+    missingTargets: string[];
+    skipKey: string;
+    mapping: ImportMapping;
+};
+export type FunnelStage = Readonly<{
+    id: string;
+    label: string;
+    count: number;
+    reason?: string;
+}>;
+export declare function resolveFunnel(stages: readonly FunnelStage[]): {
+    conversion: number | null;
+    previousConversion: number | null;
+    lost: number | null;
+    id: string;
+    label: string;
+    count: number;
+    reason?: string;
+}[];
+export type Cohort = Readonly<{
+    id: string;
+    label: string;
+    size: number;
+    retained: readonly (number | null)[];
+}>;
+export declare function resolveCohorts(rows: readonly Cohort[], periodCount: number): {
+    retained: (number | null)[];
+    rates: (number | null)[];
+    id: string;
+    label: string;
+    size: number;
+}[];
+export type CorrelationData = Readonly<{
+    variables: readonly WorkflowField[];
+    values: readonly (readonly (number | null)[])[];
+}>;
+export declare function validateCorrelation({ variables, values }: CorrelationData): void;
+export declare function resolveTarget(actual: number, target: number): {
+    actual: number;
+    target: number;
+    difference: number;
+    ratio: number | null;
+    progress: number | null;
+};
+export type HistogramBin = Readonly<{
+    id: string;
+    lower: number;
+    upper: number;
+    includesUpper: boolean;
+    count: number;
+}>;
+export declare function binHistogram(samples: readonly (number | null)[], binCount: number, domain?: readonly [number, number]): {
+    bins: readonly HistogramBin[];
+    domain: readonly [number, number];
+    underflow: number;
+    overflow: number;
+    observed: number;
+    missing: number;
+    maxCount: number;
+};
+//# sourceMappingURL=data-workflows.d.ts.map

package/dist/data-workflows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-workflows.d.ts","sourceRoot":"","sources":["../src/data-workflows.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,aAAa,GAAG,QAAQ,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC;AACxF,MAAM,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC;AACpE,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,EAAE,OAAO,EAAE,SAAS,aAAa,EAAE,EAAE,OAAO,EAAE,aAAa;;;;;aAiBf,aAAa;EAC9H;AAED,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAClG,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE;;;;QADnB,MAAM;WAAS,MAAM;WAAS,MAAM;aAAW,MAAM;IAY7F;AAED,MAAM,MAAM,MAAM,GAAG,QAAQ,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAA;CAAE,CAAC,CAAC;AACjH,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,WAAW,EAAE,MAAM;;;QADvC,MAAM;WAAS,MAAM;UAAQ,MAAM;IAYtE;AAED,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC;IAAE,SAAS,EAAE,SAAS,aAAa,EAAE,CAAC;IAAC,MAAM,EAAE,SAAS,CAAC,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC,EAAE,CAAA;CAAE,CAAC,CAAC;AACjI,wBAAgB,mBAAmB,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,eAAe,GAAG,IAAI,CAUhF;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;;;;;;EAK3D;AAED,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AACzH,wBAAgB,YAAY,CAAC,OAAO,EAAE,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC;UAiB7F,SAAS,YAAY,EAAE;;;;;;;EAE/C"}

package/dist/data-workflows.js

@@ -0,0 +1,109 @@
+import { assertDistinctIds } from "./collection-editing.js";
+export function resolveImportMapping(sources, targets, mapping) {
+    assertDistinctIds(sources);
+    assertDistinctIds(targets);
+    const sourceIds = new Set(sources.map(field => field.id)), targetIds = new Set(targets.map(field => field.id));
+    if (Object.keys(mapping).some(id => !sourceIds.has(id)))
+        throw new TypeError("Mapping references an unknown source");
+    const assigned = new Map();
+    for (const source of sources) {
+        const target = mapping[source.id] ?? null;
+        if (target === null)
+            continue;
+        if (!targetIds.has(target))
+            throw new TypeError("Mapping references an unknown target");
+        assigned.set(target, [...(assigned.get(target) ?? []), source.id]);
+    }
+    const duplicateTargets = [...assigned].filter(([, ids]) => ids.length > 1).map(([id]) => id);
+    const missingTargets = targets.filter(field => field.required && !assigned.has(field.id)).map(field => field.id);
+    let skipKey = "__hjm_skip__";
+    while (targetIds.has(skipKey))
+        skipKey += "_";
+    return { valid: assigned.size > 0 && !duplicateTargets.length && !missingTargets.length, duplicateTargets, missingTargets, skipKey,
+        // Snapshot source ids too: a pending import must not acquire new columns or edits.
+        mapping: Object.freeze(Object.fromEntries(sources.map(source => [source.id, mapping[source.id] ?? null]))) };
+}
+export function resolveFunnel(stages) {
+    assertDistinctIds(stages);
+    return stages.map((stage, index) => {
+        const previous = stages[index - 1]?.count, first = stages[0].count;
+        if (!Number.isSafeInteger(stage.count) || stage.count < 0 || (previous !== undefined && stage.count > previous)) {
+            throw new RangeError("Sequential funnel counts must be nonnegative integers that never increase");
+        }
+        return { ...stage, conversion: first === 0 ? null : stage.count / first,
+            previousConversion: previous === undefined || previous === 0 ? null : stage.count / previous,
+            lost: previous === undefined ? null : previous - stage.count };
+    });
+}
+export function resolveCohorts(rows, periodCount) {
+    assertDistinctIds(rows);
+    if (!Number.isSafeInteger(periodCount) || periodCount < 1)
+        throw new RangeError("Cohorts require a positive period count");
+    return rows.map(row => {
+        if (!Number.isSafeInteger(row.size) || row.size < 0 || row.retained.length > periodCount)
+            throw new RangeError("Invalid cohort denominator or period count");
+        const retained = Array.from({ length: periodCount }, (_, index) => row.retained[index] ?? null);
+        if (retained.some(value => value !== null && (!Number.isSafeInteger(value) || value < 0 || value > row.size))) {
+            throw new RangeError("Retained count must be observed, nonnegative and no larger than cohort size");
+        }
+        return { ...row, retained, rates: retained.map(count => count === null || row.size === 0 ? null : count / row.size) };
+    });
+}
+export function validateCorrelation({ variables, values }) {
+    assertDistinctIds(variables);
+    if (values.length !== variables.length || values.some(row => row.length !== variables.length))
+        throw new RangeError("Correlation matrix must be square");
+    for (let row = 0; row < values.length; row++)
+        for (let column = 0; column < values.length; column++) {
+            const value = values[row][column];
+            if (value !== null && (!Number.isFinite(value) || value < -1 || value > 1))
+                throw new RangeError("Correlation must be null or between -1 and 1");
+            const mirror = values[column][row];
+            if ((value === null) !== (mirror === null) || (value !== null && mirror !== null && Math.abs(value - mirror) > 1e-10))
+                throw new RangeError("Correlation matrix must be symmetric");
+            if (row === column && value !== null && value !== 1)
+                throw new RangeError("Observed self correlation must be one");
+        }
+}
+export function resolveTarget(actual, target) {
+    if (![actual, target].every(value => Number.isFinite(value) && value >= 0))
+        throw new RangeError("Actual and target must be finite and nonnegative");
+    // A zero target has no percentage denominator. Never manufacture 100% completion.
+    return { actual, target, difference: actual - target, ratio: target === 0 ? null : actual / target,
+        progress: target === 0 ? null : Math.min(1, actual / target) };
+}
+export function binHistogram(samples, binCount, domain) {
+    if (!Number.isSafeInteger(binCount) || binCount < 1 || binCount > 100)
+        throw new RangeError("Histogram bin count must be between 1 and 100");
+    const observed = samples.filter((value) => value !== null);
+    if (observed.some(value => !Number.isFinite(value)))
+        throw new RangeError("Histogram samples must be finite or null");
+    let lower = domain?.[0] ?? (observed.length ? observed.reduce((low, value) => Math.min(low, value), Infinity) : 0);
+    let upper = domain?.[1] ?? (observed.length ? observed.reduce((high, value) => Math.max(high, value), -Infinity) : 1);
+    if (!domain && upper === lower) {
+        const padding = Math.max(Math.abs(lower) * .01, .5);
+        lower -= padding;
+        upper += padding;
+    }
+    if (![lower, upper].every(Number.isFinite) || upper <= lower || !Number.isFinite(upper - lower))
+        throw new RangeError("Histogram domain must have a positive finite span");
+    const width = (upper - lower) / binCount;
+    if (width <= 0)
+        throw new RangeError("Histogram bins are below numeric precision");
+    const bins = Array.from({ length: binCount }, (_, index) => ({ id: `bin-${index}`, lower: lower + index * width, upper: lower + (index + 1) * width, includesUpper: index === binCount - 1, count: 0 }));
+    let underflow = 0, overflow = 0;
+    for (const value of observed) {
+        if (value < lower) {
+            underflow++;
+            continue;
+        }
+        if (value > upper) {
+            overflow++;
+            continue;
+        }
+        bins[Math.min(binCount - 1, Math.floor((value - lower) / width))].count++;
+    }
+    return { bins: bins, domain: [lower, upper], underflow, overflow,
+        observed: observed.length, missing: samples.length - observed.length, maxCount: Math.max(1, ...bins.map(bin => bin.count)) };
+}
+//# sourceMappingURL=data-workflows.js.map