@hjmds/design-contracts 1.19.0 → 1.21.0

package/dist/data-table.d.ts

@@ -1,4 +1,5 @@
 import type { AsyncCollectionState, CheckboxState, CollectionKey, CollectionSelectionModel } from "./behaviors.js";
+import { type TextVariant } from "./foundations.js";
 export type DataTableAlign = "start" | "center" | "end";
 export type DataTableColumnDescriptor<Key extends CollectionKey = CollectionKey> = Readonly<{
     id: Key;
@@ -8,6 +9,16 @@ export type DataTableColumnDescriptor<Key extends CollectionKey = CollectionKey>
     sortable?: boolean;
     /** Layout hint only (px or flex-basis); renderers may ignore or clamp it. */
     width?: number;
+    /**
+     * First press sorts descending (TanStack Table `sortDescFirst`). Stat tables read "highest first";
+     * lower-is-better columns (ERA, rank) leave it false. Added 2026-10-14 with the Native renderer.
+     */
+    sortDescFirst?: boolean;
+    /**
+     * Keeps the column visible while the others scroll horizontally (AG Grid / TanStack column
+     * pinning, start edge only). Only a leading run of pinned columns is honored.
+     */
+    pinned?: "start";
 }>;
 export declare const dataTableColumnDefaults: {
     readonly align: "start";
@@ -24,6 +35,8 @@ export declare function validateDataTableColumns<Key extends CollectionKey>(colu
 export type DataTableRowDescriptor<Key extends CollectionKey = CollectionKey> = Readonly<{
     id: Key;
     disabled?: boolean;
+    /** Sub-row nesting (TanStack `depth`): 1 indents a substitute under a starter. 0–3. */
+    depth?: number;
 }>;
 export declare function validateDataTableRows<Key extends CollectionKey>(rows: readonly DataTableRowDescriptor<Key>[]): void;
 /** Row selection is the unmodified Collection base contract — no DataTable-only selection shape. */
@@ -56,7 +69,34 @@ export declare function validateDataTableSortState<Key extends CollectionKey>(st
  * actually re-sorting rows (Combobox's local/external filtering split is the
  * same boundary — HJM judges intent, never executes the data operation).
  */
-export declare function getNextDataTableSortState<Key extends CollectionKey>(current: DataTableSortState<Key>, columnId: Key, cycle?: DataTableSortCycle): DataTableSortState<Key>;
+export declare function getNextDataTableSortState<Key extends CollectionKey>(current: DataTableSortState<Key>, columnId: Key, cycle?: DataTableSortCycle, firstDirection?: DataTableSortDirection): DataTableSortState<Key>;
+/** The first direction a column's header applies, from `sortDescFirst`. */
+export declare function dataTableFirstSortDirection(column: Pick<DataTableColumnDescriptor, "sortDescFirst">): DataTableSortDirection;
+export type DataTableSortValue = number | string | null | undefined;
+/**
+ * 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 declare function toDataTableSortValue(value: unknown): DataTableSortValue;
+/**
+ * Pure comparison: numbers numerically, strings with `localeCompare`, numbers before strings.
+ * Missing values are not compared here; `sortDataTableRows` always sinks them.
+ */
+export declare function compareDataTableValues(a: Exclude<DataTableSortValue, null | undefined>, b: Exclude<DataTableSortValue, null | undefined>, locale?: string): number;
+/**
+ * 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 declare function sortDataTableRows<Row, Key extends CollectionKey>(rows: readonly Row[], sort: DataTableSortState<Key>, getValue: (row: Row, columnId: Key) => DataTableSortValue, options?: Readonly<{
+    locale?: string;
+}>): Row[];
+/** Leading pinned columns (only an unbroken run from the start is pinned). */
+export declare function splitPinnedDataTableColumns<Column extends Pick<DataTableColumnDescriptor, "pinned">>(columns: readonly Column[]): Readonly<{
+    pinned: readonly Column[];
+    scrolling: readonly Column[];
+}>;
 /** The whole table's row-loading status — the unmodified Collection base async contract. */
 export type DataTableAsyncState = AsyncCollectionState;
 export type DataTableDensity = "compact" | "regular";
@@ -168,6 +208,7 @@ export declare const dataTableRecipe: {
         };
     };
 };
+export declare const dataTableFamilyScenarios: readonly ["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
@@ -194,10 +235,193 @@ export declare const dataTableBehavior: {
         readonly focus: "native";
     };
     readonly native: {
-        readonly roles: readonly [];
-        readonly states: readonly [];
-        readonly actions: readonly [];
+        readonly roles: readonly ["button", "header"];
+        readonly states: readonly ["selected"];
+        readonly actions: readonly ["activate"];
     };
-    readonly scenarios: readonly ["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", "sortable-header-is-a-button-inside-the-columnheader-not-the-header-itself", "sort-direction-values-pass-through-to-aria-sort-without-translation", "disabled-rows-are-excluded-from-select-all-accounting", "pagination-or-load-more-is-composed-beneath-the-table-not-owned-by-it", "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"];
+    readonly scenarios: readonly ["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", "sortable-header-is-a-button-inside-the-columnheader-not-the-header-itself", "sort-direction-values-pass-through-to-aria-sort-without-translation", "disabled-rows-are-excluded-from-select-all-accounting", "pagination-or-load-more-is-composed-beneath-the-table-not-owned-by-it", "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", "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"];
 };
+/** One header band above leaf columns. Columns not listed in any group get an empty placeholder cell. */
+export type DataTableColumnGroup<Key extends CollectionKey = CollectionKey> = Readonly<{
+    id: string;
+    header: string;
+    columns: readonly Key[];
+}>;
+export type DataTableHeaderBand = Readonly<{
+    id: string;
+    header: string | null;
+    span: number;
+    columnIds: readonly string[];
+}>;
+/**
+ * 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 declare function resolveDataTableHeaderBands<Key extends CollectionKey>(columns: readonly Pick<DataTableColumnDescriptor<Key>, "id">[], groups: readonly DataTableColumnGroup<Key>[]): DataTableHeaderBand[];
+/** Labeled row section (e.g. 선발 / 교체, 동부 / 서부). Rows not in any group render first, ungrouped. */
+export type DataTableRowGroup<Key extends CollectionKey = CollectionKey> = Readonly<{
+    id: string;
+    label: string;
+    rows: readonly Key[];
+}>;
+export type DataTableBodyItem<Key extends CollectionKey = CollectionKey> = Readonly<{
+    kind: "group";
+    id: string;
+    label: string;
+}> | Readonly<{
+    kind: "row";
+    id: Key;
+}>;
+/** Flattens rows + groups into the body order renderers draw. Unknown or duplicated ids throw. */
+export declare function resolveDataTableBody<Key extends CollectionKey>(rows: readonly DataTableRowDescriptor<Key>[], groups?: readonly DataTableRowGroup<Key>[]): DataTableBodyItem<Key>[];
+/**
+ * Semantic cell emphasis, decided by the product per cell (AG Grid cellClassRules):
+ * `leader` marks a league/table best, `positive`/`negative` a direction, `muted` a non-qualifying value.
+ */
+export type DataTableCellTone = "leader" | "positive" | "negative" | "muted";
+/** Percentile heat (Savant): `high` side toward the best values, `low` toward the worst; strength 1–3. */
+export type DataTableCellHeat = Readonly<{
+    side: "high" | "low";
+    strength: 1 | 2 | 3;
+}>;
+/**
+ * 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 declare function percentileRank(value: number | null | undefined, sample: readonly (number | null | undefined)[], options?: Readonly<{
+    lowerIsBetter?: boolean;
+}>): number | null;
+/** Maps a percentile to heat: ≥90/≥75/≥60 high, ≤10/≤25/≤40 low, the middle stays neutral (null). */
+export declare function percentileHeat(percentile: number | null): DataTableCellHeat | null;
+export declare const dataTableFamilyRecipe: {
+    /** Heat background alpha per strength, over the high/low base colors. */
+    readonly heatAlpha: {
+        readonly 1: 0.14;
+        readonly 2: 0.26;
+        readonly 3: 0.42;
+    };
+    readonly heat: {
+        readonly high: Readonly<{
+            source: "theme";
+            key: "danger";
+            alpha?: number;
+        }>;
+        readonly low: Readonly<{
+            source: "accent";
+            key: "info";
+            alpha?: number;
+        }>;
+    };
+    readonly tone: {
+        readonly leader: {
+            readonly color: Readonly<{
+                source: "theme";
+                key: "text";
+                alpha?: number;
+            }>;
+            readonly fontWeight: "700";
+        };
+        readonly positive: {
+            readonly color: Readonly<{
+                source: "theme";
+                key: "danger";
+                alpha?: number;
+            }>;
+            readonly fontWeight: "700";
+        };
+        readonly negative: {
+            readonly color: Readonly<{
+                source: "accent";
+                key: "info";
+                alpha?: number;
+            }>;
+            readonly fontWeight: "700";
+        };
+        readonly muted: {
+            readonly color: Readonly<{
+                source: "theme";
+                key: "textSub";
+                alpha?: number;
+            }>;
+            readonly fontWeight: "400";
+        };
+    };
+    readonly groupRow: {
+        readonly background: Readonly<{
+            source: "theme";
+            key: "surfaceAlt";
+            alpha?: number;
+        }>;
+        readonly color: Readonly<{
+            source: "theme";
+            key: "textMuted";
+            alpha?: number;
+        }>;
+        readonly textVariant: TextVariant;
+    };
+    /** Indent per sub-row depth level (substitutes under a starter, players under a team). */
+    readonly depthIndent: 16;
+    readonly headerBand: {
+        readonly color: Readonly<{
+            source: "theme";
+            key: "textMuted";
+            alpha?: number;
+        }>;
+        readonly borderBottom: Readonly<{
+            source: "theme";
+            key: "border";
+            alpha?: number;
+        }>;
+    };
+};
+export type LineScoreTeam = Readonly<{
+    id: string;
+    name: string;
+    /** Runs per period; null = not played yet, "X" = home team did not bat in the last inning. */
+    periods: readonly (number | "X" | null)[];
+    /** Totals in display order, e.g. { R: 5, H: 9, E: 0, B: 4 }. */
+    totals: Readonly<Record<string, number | null>>;
+}>;
+export type LineScoreColumn = Readonly<{
+    id: string;
+    header: string;
+    kind: "period" | "total";
+}>;
+/**
+ * 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 declare function resolveLineScore(teams: readonly LineScoreTeam[], options: Readonly<{
+    minPeriods?: number;
+    totals: readonly string[];
+    currentPeriod?: number | null;
+}>): Readonly<{
+    columns: LineScoreColumn[];
+    currentPeriod: number | null;
+    leaderId: string | null;
+}>;
+export declare function formatLineScoreCell(value: number | "X" | null | undefined): string;
+export type MatrixCell = Readonly<{
+    label: string;
+    tone?: DataTableCellTone | null;
+    heat?: DataTableCellHeat | null;
+}>;
+/**
+ * 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 declare function resolveMatrix<Key extends string>(ids: readonly Key[], getCell: (row: Key, column: Key) => MatrixCell | null): readonly (readonly (MatrixCell | "self" | null)[])[];
+export type ComparisonRow = Readonly<{
+    id: string;
+    label: string;
+    values: readonly [number | null, number | null];
+    /** Display strings; defaults to String(value). */
+    display?: readonly [string, string];
+    lowerIsBetter?: boolean;
+}>;
+/** Which side wins a row (null on ties/missing), and each side's bar share of the pair (0–1). */
+export declare function resolveComparisonRow(row: ComparisonRow): Readonly<{
+    winner: 0 | 1 | null;
+    shares: readonly [number, number];
+}>;
 //# sourceMappingURL=data-table.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"data-table.d.ts","sourceRoot":"","sources":["../src/data-table.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,oBAAoB,EAEpB,aAAa,EACb,aAAa,EACb,wBAAwB,EACzB,MAAM,gBAAgB,CAAC;AAKxB,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;AAExD,MAAM,MAAM,yBAAyB,CAAC,GAAG,SAAS,aAAa,GAAG,aAAa,IAAI,QAAQ,CAAC;IAC1F,EAAE,EAAE,GAAG,CAAC;IACR,2EAA2E;IAC3E,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;CAGuC,CAAC;AAQ5E,wBAAgB,wBAAwB,CAAC,GAAG,SAAS,aAAa,EAChE,OAAO,EAAE,SAAS,yBAAyB,CAAC,GAAG,CAAC,EAAE,GACjD,IAAI,CAgBN;AAED;;;;;;GAMG;AACH,MAAM,MAAM,sBAAsB,CAAC,GAAG,SAAS,aAAa,GAAG,aAAa,IAAI,QAAQ,CAAC;IACvF,EAAE,EAAE,GAAG,CAAC;IACR,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC,CAAC;AAEH,wBAAgB,qBAAqB,CAAC,GAAG,SAAS,aAAa,EAC7D,IAAI,EAAE,SAAS,sBAAsB,CAAC,GAAG,CAAC,EAAE,GAC3C,IAAI,CASN;AAED,oGAAoG;AACpG,MAAM,MAAM,kBAAkB,CAAC,GAAG,SAAS,aAAa,GAAG,aAAa,IACtE,wBAAwB,CAAC,GAAG,CAAC,CAAC;AAEhC;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAAC,GAAG,SAAS,aAAa,EACtE,IAAI,EAAE,SAAS,sBAAsB,CAAC,GAAG,CAAC,EAAE,EAC5C,YAAY,EAAE,WAAW,CAAC,GAAG,CAAC,GAC7B,aAAa,CAOf;AAED;;;;;GAKG;AACH,MAAM,MAAM,sBAAsB,GAAG,WAAW,GAAG,YAAY,CAAC;AAEhE,MAAM,MAAM,kBAAkB,CAAC,GAAG,SAAS,aAAa,GAAG,aAAa,IAAI,QAAQ,CAAC;IACnF,QAAQ,EAAE,GAAG,CAAC;IACd,SAAS,EAAE,sBAAsB,CAAC;CACnC,CAAC,GAAG,IAAI,CAAC;AAEV,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,aAAa,CAAC;AAE7D,eAAO,MAAM,iBAAiB;;CAEkC,CAAC;AAEjE,wBAAgB,0BAA0B,CAAC,GAAG,SAAS,aAAa,EAClE,KAAK,EAAE,kBAAkB,CAAC,GAAG,CAAC,EAC9B,OAAO,EAAE,SAAS,yBAAyB,CAAC,GAAG,CAAC,EAAE,GACjD,IAAI,CAYN;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,SAAS,aAAa,EACjE,OAAO,EAAE,kBAAkB,CAAC,GAAG,CAAC,EAChC,QAAQ,EAAE,GAAG,EACb,KAAK,GAAE,kBAAgD,GACtD,kBAAkB,CAAC,GAAG,CAAC,CAQzB;AAED,4FAA4F;AAC5F,MAAM,MAAM,mBAAmB,GAAG,oBAAoB,CAAC;AAEvD,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,SAAS,CAAC;AAErD;;;;GAIG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsF3B,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;CA4BO,CAAC"}
+{"version":3,"file":"data-table.d.ts","sourceRoot":"","sources":["../src/data-table.ts"],"names":[],"mappings":"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"}

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