An open source design system that's fully customizable and agent ready
TypeScript
docs(spec): TableRow and the Table sections record their shipped contract as current (#9143)
Cindy Zhanga62ce8592fc6
diff --git a/docs/specs/components/Table/Table.spec.md b/docs/specs/components/Table/Table.spec.mdindex 03f788ec06..6295bc5bc7 100644--- a/docs/specs/components/Table/Table.spec.md+++ b/docs/specs/components/Table/Table.spec.md@@ -110,6 +110,9 @@ Consumer migration instructions belong in consumer docs and release notes.target-reachability gaps.- New public API, theme target, or alias, beyond `useTableRowExpansion`'soptional `animatedLayout` option (FR15).+- TableHeader, TableBody, TableFooter, and TableRow element contracts;+ `component:TableHeader`, `component:TableBody`, `component:TableFooter`, and+ `component:TableRow` own them.## Public conceptsdiff --git a/docs/specs/components/Table/TableBody.spec.md b/docs/specs/components/Table/TableBody.spec.mdnew file mode 100644index 0000000000..550c073132--- /dev/null+++ b/docs/specs/components/Table/TableBody.spec.md@@ -0,0 +1,148 @@+---+schema_version: 3+template_version: 7+kind: component+id: component:TableBody+authority: current+archive_reason: null+superseded_by: null+approved_by: cixzhang+approved_at: 2026-11-01+owners: [cixzhang]+review_triggers: [public-api, behavior, theming, accessibility]+verified_by:+ [+ packages/core/src/Table/Table.test.tsx,+ packages/core/src/theme/themingTargets.test.ts,+ scripts/check-knowledge.mjs,+ ]+modules: []+families: []+design_specs: []+architecture:+ [architecture:component-theming-surface, architecture:public-component-api]+contributing: []+system_specs: []+---++# TableBody component contract++## Contract at a glance++| Area | Contract |+| ----------------------- | -------------------------------------------------------------------------------------------- |+| Public contract | `children`, root `BaseProps`, and a `ref`. |+| Behavior | Renders the table's body section as a native `tbody` carrying the `table-body` target. |+| End-user impact | Assistive technology reads the body section as part of the table's structure. |+| Builder impact | None; the record describes shipped behavior. |+| Compatibility/readiness | Released behavior recorded as current; no API, default, or output changes. |+| Review checks | Reject a non-`tbody` element, a lost target, or caller props or `ref` that miss the element. |+| Governing rules | `architecture:public-component-api` INV5–INV8; `architecture:component-theming-surface`. |++This table is a review projection; the body below is authoritative.++## Intent++TableBody is the body section a caller composes inside a children-mode Table. It+owns the native `tbody` element; the caller owns the rows inside it.++Consumer syntax and examples belong in `TableBody.doc.mjs`.++## Compatibility and migration++- Released default preserved: `yes`+- Compatibility class: records shipped behavior; no public prop, default, DOM,+ target, or styling output changes.+- Controlled/uncontrolled behavior: not applicable+- Migration decision: none++Consumer migration instructions belong in consumer docs and release notes.++## Ownership boundary++**Owns**++- The `tbody` element, which carries the `table-body` target that `component:Table`+ owns and maps.++**Does not own / non-goals**++- Rows — owned by `component:TableRow`; cells — owned by `component:Table`; and+ the caller's content.+- Table appearance, data mode, and plugins — owned by `component:Table`.++## Public concepts++| Concept | Closed values or states | Meaning | Availability by variant/orientation/state | Default | Owner | Stability | Invalid-value behavior |+| ------- | ----------------------- | ----------------------------- | ----------------------------------------- | ------- | ------ | --------- | ---------------------- |+| Content | ReactNode (rows) | The rows of the body section. | Children-mode Table | none | caller | Stable | — |++## Behavioral and layout contract++| ID | Invariant | Basis |+| --- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------- |+| FR1 | TableBody renders one `tbody` carrying the `table-body` target and holding its children, and adds no styles of its own. | Current source and tests |+| FR2 | `ref` reaches the `tbody`; supported DOM, data, ARIA, and event props reach it after the component's attributes; `xstyle`, `className`, and `style` compose on it. | Current source and tests; `architecture:public-component-api` INV5–INV8 |++### Allowed variation++- **AV1 — Rows.** Any rows may fill the body section.++### Representative states++| State | Required invariant | Allowed variation |+| ---------- | ---------------------------------- | ----------------- |+| In a Table | A `tbody` in the table's children. | Rows. |++### Transformation and precedence order++- **ORD1 — Root composition.** Target and caller styling compose, then caller+ props apply.++### Performance and resources++- **PR1 — No resources.** TableBody holds no state and adds no listener or+ observer.++## Accessibility contract++- **AR1 — Native section semantics.** The `tbody` keeps its native table+ section role; TableBody adds no role of its own.++## Design relationships++| Anatomy or state | Design requirement | Representation authority | Hierarchy role | Component contract |+| ---------------- | ------------------------- | ------------------------ | -------------- | ------------------ |+| Body section | The table's body section. | Current source and docs | Supporting | FR1 |++Theming: the `tbody` carries the `table-body` target, which `Table.doc.mjs`+maps as the Body section part of `component:Table`. `TableBody.doc.mjs` declares no+anatomy of its own, so no anatomy-theming block is declared here.++## Family and system relationships++- `component:Table` owns appearance, data mode, plugins, and the target+ mapping.+- `architecture:public-component-api` owns caller-input routing; FR2 applies+ it.++## Verification map++| Contract | Verification | Representative states | Mutation or failure expectation | Audit section |+| --------- | ---------------------------------------------------------------------- | --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------- |+| FR1, AR1 | `Table.test.tsx` children-mode section tests; `themingTargets.test.ts` | Children mode | A missing `tbody` in the table's children fails. Gap: no test asserts the `table-body` class or that TableBody adds no role or styles. `themingTargets.test.ts` catches only a renamed or undocumented target. | `audit:TableBody/anatomy` |+| FR2, ORD1 | `Table.test.tsx` section rest-forwarding test | `data-testid`, `id` | A dropped `data-testid` or `id` fails. Gap: no test covers `ref`, event props, `className`, `style`, or `xstyle`. | `audit:TableBody/api` |+| PR1 | Source review | Every state | Gap: no automated check fails if TableBody adds state or a listener. | `audit:TableBody/behavior` |++## Decision log++None recorded. The record describes shipped behavior.++## Open questions++None.++## Content boundary++This file does not duplicate consumer prop tables/examples, current audit+results, implementation steps, or Table rules. It links to their owners.diff --git a/docs/specs/components/Table/TableFooter.spec.md b/docs/specs/components/Table/TableFooter.spec.mdnew file mode 100644index 0000000000..5fb78349f9--- /dev/null+++ b/docs/specs/components/Table/TableFooter.spec.md@@ -0,0 +1,148 @@+---+schema_version: 3+template_version: 7+kind: component+id: component:TableFooter+authority: current+archive_reason: null+superseded_by: null+approved_by: cixzhang+approved_at: 2026-11-01+owners: [cixzhang]+review_triggers: [public-api, behavior, theming, accessibility]+verified_by:+ [+ packages/core/src/Table/Table.test.tsx,+ packages/core/src/theme/themingTargets.test.ts,+ scripts/check-knowledge.mjs,+ ]+modules: []+families: []+design_specs: []+architecture:+ [architecture:component-theming-surface, architecture:public-component-api]+contributing: []+system_specs: []+---++# TableFooter component contract++## Contract at a glance++| Area | Contract |+| ----------------------- | -------------------------------------------------------------------------------------------- |+| Public contract | `children`, root `BaseProps`, and a `ref`. |+| Behavior | Renders the table's footer section as a native `tfoot` carrying the `table-footer` target. |+| End-user impact | Assistive technology reads the footer section as part of the table's structure. |+| Builder impact | None; the record describes shipped behavior. |+| Compatibility/readiness | Released behavior recorded as current; no API, default, or output changes. |+| Review checks | Reject a non-`tfoot` element, a lost target, or caller props or `ref` that miss the element. |+| Governing rules | `architecture:public-component-api` INV5–INV8; `architecture:component-theming-surface`. |++This table is a review projection; the body below is authoritative.++## Intent++TableFooter is the footer section a caller composes inside a children-mode Table. It+owns the native `tfoot` element; the caller owns the rows inside it.++Consumer syntax and examples belong in `TableFooter.doc.mjs`.++## Compatibility and migration++- Released default preserved: `yes`+- Compatibility class: records shipped behavior; no public prop, default, DOM,+ target, or styling output changes.+- Controlled/uncontrolled behavior: not applicable+- Migration decision: none++Consumer migration instructions belong in consumer docs and release notes.++## Ownership boundary++**Owns**++- The `tfoot` element, which carries the `table-footer` target that `component:Table`+ owns and maps.++**Does not own / non-goals**++- Rows — owned by `component:TableRow`; cells — owned by `component:Table`; and+ the caller's content.+- Table appearance, data mode, and plugins — owned by `component:Table`.++## Public concepts++| Concept | Closed values or states | Meaning | Availability by variant/orientation/state | Default | Owner | Stability | Invalid-value behavior |+| ------- | ----------------------- | ------------------------------- | ----------------------------------------- | ------- | ------ | --------- | ---------------------- |+| Content | ReactNode (rows) | The rows of the footer section. | Children-mode Table | none | caller | Stable | — |++## Behavioral and layout contract++| ID | Invariant | Basis |+| --- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------- |+| FR1 | TableFooter renders one `tfoot` carrying the `table-footer` target and holding its children, and adds no styles of its own. | Current source and tests |+| FR2 | `ref` reaches the `tfoot`; supported DOM, data, ARIA, and event props reach it after the component's attributes; `xstyle`, `className`, and `style` compose on it. | Current source and tests; `architecture:public-component-api` INV5–INV8 |++### Allowed variation++- **AV1 — Rows.** Any rows may fill the footer section.++### Representative states++| State | Required invariant | Allowed variation |+| ---------- | ---------------------------------- | ----------------- |+| In a Table | A `tfoot` in the table's children. | Rows. |++### Transformation and precedence order++- **ORD1 — Root composition.** Target and caller styling compose, then caller+ props apply.++### Performance and resources++- **PR1 — No resources.** TableFooter holds no state and adds no listener or+ observer.++## Accessibility contract++- **AR1 — Native section semantics.** The `tfoot` keeps its native table+ section role; TableFooter adds no role of its own.++## Design relationships++| Anatomy or state | Design requirement | Representation authority | Hierarchy role | Component contract |+| ---------------- | --------------------------- | ------------------------ | -------------- | ------------------ |+| Footer section | The table's footer section. | Current source and docs | Supporting | FR1 |++Theming: the `tfoot` carries the `table-footer` target, which `Table.doc.mjs`+maps as the Footer section part of `component:Table`. `TableFooter.doc.mjs` declares no+anatomy of its own, so no anatomy-theming block is declared here.++## Family and system relationships++- `component:Table` owns appearance, data mode, plugins, and the target+ mapping.+- `architecture:public-component-api` owns caller-input routing; FR2 applies+ it.++## Verification map++| Contract | Verification | Representative states | Mutation or failure expectation | Audit section |+| --------- | ----------------------------------------------------------------------- | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------- |+| FR1, AR1 | `Table.test.tsx` section rest-forwarding test; `themingTargets.test.ts` | Inside a plain `table` | A missing `tfoot` fails. Gap: no test renders TableFooter inside a Table, asserts its `table-footer` class, or asserts that it adds no role or styles. `themingTargets.test.ts` catches only a renamed or undocumented target. | `audit:TableFooter/anatomy` |+| FR2, ORD1 | `Table.test.tsx` section rest-forwarding test | `data-testid`, `id` | A dropped `data-testid` or `id` fails. Gap: no test covers `ref`, event props, `className`, `style`, or `xstyle`. | `audit:TableFooter/api` |+| PR1 | Source review | Every state | Gap: no automated check fails if TableFooter adds state or a listener. | `audit:TableFooter/behavior` |++## Decision log++None recorded. The record describes shipped behavior.++## Open questions++None.++## Content boundary++This file does not duplicate consumer prop tables/examples, current audit+results, implementation steps, or Table rules. It links to their owners.diff --git a/docs/specs/components/Table/TableHeader.spec.md b/docs/specs/components/Table/TableHeader.spec.mdnew file mode 100644index 0000000000..baed759630--- /dev/null+++ b/docs/specs/components/Table/TableHeader.spec.md@@ -0,0 +1,148 @@+---+schema_version: 3+template_version: 7+kind: component+id: component:TableHeader+authority: current+archive_reason: null+superseded_by: null+approved_by: cixzhang+approved_at: 2026-11-01+owners: [cixzhang]+review_triggers: [public-api, behavior, theming, accessibility]+verified_by:+ [+ packages/core/src/Table/Table.test.tsx,+ packages/core/src/theme/themingTargets.test.ts,+ scripts/check-knowledge.mjs,+ ]+modules: []+families: []+design_specs: []+architecture:+ [architecture:component-theming-surface, architecture:public-component-api]+contributing: []+system_specs: []+---++# TableHeader component contract++## Contract at a glance++| Area | Contract |+| ----------------------- | -------------------------------------------------------------------------------------------- |+| Public contract | `children`, root `BaseProps`, and a `ref`. |+| Behavior | Renders the table's header section as a native `thead` carrying the `table-header` target. |+| End-user impact | Assistive technology reads the header section as part of the table's structure. |+| Builder impact | None; the record describes shipped behavior. |+| Compatibility/readiness | Released behavior recorded as current; no API, default, or output changes. |+| Review checks | Reject a non-`thead` element, a lost target, or caller props or `ref` that miss the element. |+| Governing rules | `architecture:public-component-api` INV5–INV8; `architecture:component-theming-surface`. |++This table is a review projection; the body below is authoritative.++## Intent++TableHeader is the header section a caller composes inside a children-mode Table. It+owns the native `thead` element; the caller owns the rows inside it.++Consumer syntax and examples belong in `TableHeader.doc.mjs`.++## Compatibility and migration++- Released default preserved: `yes`+- Compatibility class: records shipped behavior; no public prop, default, DOM,+ target, or styling output changes.+- Controlled/uncontrolled behavior: not applicable+- Migration decision: none++Consumer migration instructions belong in consumer docs and release notes.++## Ownership boundary++**Owns**++- The `thead` element, which carries the `table-header` target that `component:Table`+ owns and maps.++**Does not own / non-goals**++- Rows — owned by `component:TableRow`; cells — owned by `component:Table`; and+ the caller's content.+- Table appearance, data mode, and plugins — owned by `component:Table`.++## Public concepts++| Concept | Closed values or states | Meaning | Availability by variant/orientation/state | Default | Owner | Stability | Invalid-value behavior |+| ------- | ----------------------- | ------------------------------- | ----------------------------------------- | ------- | ------ | --------- | ---------------------- |+| Content | ReactNode (rows) | The rows of the header section. | Children-mode Table | none | caller | Stable | — |++## Behavioral and layout contract++| ID | Invariant | Basis |+| --- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------- |+| FR1 | TableHeader renders one `thead` carrying the `table-header` target and holding its children, and adds no styles of its own. | Current source and tests |+| FR2 | `ref` reaches the `thead`; supported DOM, data, ARIA, and event props reach it after the component's attributes; `xstyle`, `className`, and `style` compose on it. | Current source and tests; `architecture:public-component-api` INV5–INV8 |++### Allowed variation++- **AV1 — Rows.** Any rows may fill the header section.++### Representative states++| State | Required invariant | Allowed variation |+| ---------- | ---------------------------------- | ----------------- |+| In a Table | A `thead` in the table's children. | Rows. |++### Transformation and precedence order++- **ORD1 — Root composition.** Target and caller styling compose, then caller+ props apply.++### Performance and resources++- **PR1 — No resources.** TableHeader holds no state and adds no listener or+ observer.++## Accessibility contract++- **AR1 — Native section semantics.** The `thead` keeps its native table+ section role; TableHeader adds no role of its own.++## Design relationships++| Anatomy or state | Design requirement | Representation authority | Hierarchy role | Component contract |+| ---------------- | --------------------------- | ------------------------ | -------------- | ------------------ |+| Header section | The table's header section. | Current source and docs | Supporting | FR1 |++Theming: the `thead` carries the `table-header` target, which `Table.doc.mjs`+maps as the Header section part of `component:Table`. `TableHeader.doc.mjs` declares no+anatomy of its own, so no anatomy-theming block is declared here.++## Family and system relationships++- `component:Table` owns appearance, data mode, plugins, and the target+ mapping.+- `architecture:public-component-api` owns caller-input routing; FR2 applies+ it.++## Verification map++| Contract | Verification | Representative states | Mutation or failure expectation | Audit section |+| --------- | ---------------------------------------------------------------------- | --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------- |+| FR1, AR1 | `Table.test.tsx` children-mode section tests; `themingTargets.test.ts` | Children mode | A missing `thead` in the table's children fails. Gap: no test asserts the `table-header` class or that TableHeader adds no role or styles. `themingTargets.test.ts` catches only a renamed or undocumented target. | `audit:TableHeader/anatomy` |+| FR2, ORD1 | `Table.test.tsx` section rest-forwarding test | `data-testid`, `id` | A dropped `data-testid` or `id` fails. Gap: no test covers `ref`, event props, `className`, `style`, or `xstyle`. | `audit:TableHeader/api` |+| PR1 | Source review | Every state | Gap: no automated check fails if TableHeader adds state or a listener. | `audit:TableHeader/behavior` |++## Decision log++None recorded. The record describes shipped behavior.++## Open questions++None.++## Content boundary++This file does not duplicate consumer prop tables/examples, current audit+results, implementation steps, or Table rules. It links to their owners.diff --git a/docs/specs/components/Table/TableRow.spec.md b/docs/specs/components/Table/TableRow.spec.mdnew file mode 100644index 0000000000..6d27bd46f6--- /dev/null+++ b/docs/specs/components/Table/TableRow.spec.md@@ -0,0 +1,160 @@+---+schema_version: 3+template_version: 7+kind: component+id: component:TableRow+authority: current+archive_reason: null+superseded_by: null+approved_by: cixzhang+approved_at: 2026-11-01+owners: [cixzhang]+review_triggers: [public-api, behavior, theming, accessibility]+verified_by:+ [+ packages/core/src/Table/Table.test.tsx,+ packages/core/src/theme/themingTargets.test.ts,+ scripts/check-knowledge.mjs,+ ]+modules: []+families: []+design_specs: []+architecture:+ [architecture:component-theming-surface, architecture:public-component-api]+contributing: []+system_specs: []+---++# TableRow component contract++## Contract at a glance++| Area | Contract |+| ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |+| Public contract | `children`, `isHeaderRow`, `xstyle` (a list of StyleX styles), root `BaseProps`, and a `ref`. |+| Behavior | A native `tr` carrying the `table-row` target that takes the enclosing Table's striping and hover treatment and holds its cells' divider during a glide. |+| End-user impact | People can follow a row across the table by its stripe or hover highlight, and assistive technology reads it as a row. |+| Builder impact | None; the record describes shipped behavior. |+| Compatibility/readiness | Released behavior recorded as current; no API, default, or output changes. |+| Review checks | Reject striping that counts an expansion panel, hover or striping on a header row, a lost target, or caller props that miss the row. |+| Governing rules | `architecture:public-component-api` INV5–INV8; `architecture:component-theming-surface`. |++This table is a review projection; the body below is authoritative.++## Intent++TableRow is the row a caller composes inside a children-mode Table, and the row+Table renders in data mode. It owns the `tr` and the row treatment the Table+asks for; the caller owns the cells.++Consumer syntax and examples belong in `TableRow.doc.mjs`.++## Compatibility and migration++- Released default preserved: `yes` — a body row.+- Compatibility class: records shipped behavior; no public prop, default, DOM,+ target, or styling output changes.+- Controlled/uncontrolled behavior: not applicable+- Migration decision: none++Consumer migration instructions belong in consumer docs and release notes.++## Ownership boundary++**Owns**++- The `tr` element, which carries the `table-row` target that `component:Table`+ owns and maps.+- Applying the Table's striping and hover treatment to the row, and holding its+ cells' stand-in divider while a glide moves it.++**Does not own / non-goals**++- Whether the Table is striped, hoverable, or divided — owned by+ `component:Table`.+- Cells, which draw the row divider — owned by `component:Table` and the caller.++## Public concepts++| Concept | Closed values or states | Meaning | Availability by variant/orientation/state | Default | Owner | Stability | Invalid-value behavior |+| -------- | ----------------------- | ------------------------------------ | ----------------------------------------- | ------- | -------------------- | --------- | ---------------------- |+| Row kind | body; header | Header rows skip striping and hover. | Inside a Table | body | `component:TableRow` | Stable | — |+| Content | ReactNode (cells) | The row's cells. | Always | — | caller | Stable | — |++## Behavioral and layout contract++| ID | Invariant | Basis |+| --- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------- |+| FR1 | TableRow renders one `tr` carrying the `table-row` target and holding its children. Outside a Table it adds no row treatment. | Current source and tests |+| FR2 | Inside a Table, a body row takes the Table's treatment: with striping, every even body row paints `--color-background-muted`, counting body rows only, so an expansion panel row does not shift the stripes; with hover, a hover-capable pointer paints `--color-overlay-hover`; with both, the hover color replaces the stripe; a row with `aria-disabled="true"` takes no hover. A header row (`isHeaderRow`) takes neither. | Current source and tests |+| FR3 | Inside a Table with `rows` or `grid` dividers, every row, header rows included, is the containing block for its cells' stand-in divider while a glide moves it; the cells draw the divider (`component:Table` FR14). | Current source; `component:Table` FR14 |+| FR4 | `ref` reaches the `tr`; supported DOM, data, ARIA, and event props reach it before the component's target and styles; `xstyle`, `className`, and `style` compose on it. | Current source and tests; `architecture:public-component-api` INV5–INV8 |++### Allowed variation++- **AV1 — Cells.** Any cells may fill the row.++### Representative states++| State | Required invariant | Allowed variation |+| ---------------- | --------------------------------------------------- | ----------------- |+| Standalone | A `tr` with the target and no treatment. | — |+| Striped body row | Even body rows muted; expansion panels not counted. | — |+| Hover body row | Hover overlay under a hover-capable pointer. | — |+| Header row | No striping or hover. | — |++### Transformation and precedence order++- **ORD1 — Treatment.** Header row → no striping or hover; otherwise striping,+ then hover, from the Table; every row → the glide's containing block for its+ cells' divider; then the caller's `xstyle`, `className`, and `style`.++### Performance and resources++- **PR1 — No resources.** TableRow reads the Table's appearance and holds no+ state.++## Accessibility contract++- **AR1 — Native row semantics.** The `tr` keeps its native row role; striping+ and hover are visual only.++## Design relationships++| Anatomy or state | Design requirement | Representation authority | Hierarchy role | Component contract |+| ---------------- | ------------------------------------------- | ------------------------ | -------------- | ------------------ |+| Row | A table row with optional stripe and hover. | Current source and docs | Supporting | FR1–FR3 |++Theming: the `tr` carries the `table-row` target, which `Table.doc.mjs` maps as+the Row part of `component:Table`. `TableRow.doc.mjs` declares no anatomy of+its own, so no anatomy-theming block is declared here.++## Family and system relationships++- `component:Table` owns striping, hover, and divider settings and the target+ mapping.+- `architecture:public-component-api` owns caller-input routing; FR4 applies+ it.++## Verification map++| Contract | Verification | Representative states | Mutation or failure expectation | Audit section |+| --------- | --------------------------------------------------------------------------------------------- | -------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------- |+| FR1, AR1 | `Table.test.tsx` row-count, row-class, and standalone-row tests; `themingTargets.test.ts` | Data mode; standalone | A missing row or lost `table-row` class fails. `themingTargets.test.ts` catches only a renamed or undocumented target; no check fails if a standalone row stops carrying its target. | `audit:TableRow/anatomy` |+| FR2, ORD1 | `Table.test.tsx` header-hover and striped tests | Hover on; striped | A header row that takes hover styling fails. Gap: the striped test asserts only that rows render, and no test covers stripe parity around an expansion panel or the stripe and hover colors. No test covers the hover color replacing the stripe or a row with `aria-disabled="true"` taking no hover. | `audit:TableRow/visual` |+| FR3 | Source review | Rows and grid dividers; a glide; a header row | Gap: no test covers the row as its cells' divider containing block during a glide; `component:Table` FR14's real-browser divider checks are pending. | `audit:TableRow/visual` |+| FR4 | `Table.test.tsx` row className and style tests, and the TableRow ref and HTML-attribute tests | Inside a Table; standalone; `ref`; `aria-label`, `data-testid` | A caller class, style, ref, or DOM attribute that misses the row fails. Gap: no test covers `xstyle` or the order in which caller styles follow the Table's treatment. | `audit:TableRow/api` |+| PR1 | Source review | Every state | Gap: no automated check fails if TableRow adds state or a listener. | `audit:TableRow/behavior` |++## Decision log++None recorded. The record describes shipped behavior.++## Open questions++None.++## Content boundary++This file does not duplicate consumer prop tables/examples, current audit+results, implementation steps, or Table rules. It links to their owners.