Skip to content

An open source design system that's fully customizable and agent ready

TypeScript

docs(specs): Table row virtualization adopts the shared list-windowing module first (#10665)

Humberto Virtudes7045020adfc9
diff --git a/docs/architecture/list-windowing.md b/docs/architecture/list-windowing.md
index 6ca4cb5f96..6936504997 100644
--- a/docs/architecture/list-windowing.md
+++ b/docs/architecture/list-windowing.md
@@ -6,8 +6,8 @@ id: architecture:list-windowing
authority: current
archive_reason: null
superseded_by: null
-approved_by: cixzhang
-approved_at: 2026-11-06
+approved_by: humbertovirtudes
+approved_at: 2026-11-08
owners: [cixzhang]
applies_to:
[
@@ -26,10 +26,10 @@ deciding_specs: []
| Area | Contract |
| ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Governing contract | None. Each consumer's record owns what a person sees and hears in its long list; this record owns only which module computes the window. |
-| System behavior | One shared internal windowing module owns long-list windowing in Core. Selector is its first consumer, then Table virtualization, then Chat. The module is not public API (INV1, INV2). |
+| System behavior | One shared internal windowing module owns long-list windowing in Core. Table virtualization is its first consumer, then Selector, then Chat. The module is not public API (INV1, INV2). |
| End-user impact | None yet: the module does not exist, and Selector renders every option. Once it ships, people opening a long list wait less, and every windowed list behaves the same way. |
| Builder impact | A Core component that windows a long list calls the one module instead of building its own. No public windowing hook exists while OQ1 is open. |
-| Compatibility/readiness | Additive and internal. Spec only: the build has not started (Current-state impact). Table's approved virtualization hook keeps its public shape. |
+| Compatibility/readiness | Additive and internal. Spec only: no module exists yet (Current-state impact). Table's approved virtualization hook keeps its public shape. |
| Review checks | Reject a second windowing implementation in Core, a public export of the module, or a change to Table's public virtualization shape made to adopt it. |
| Governing rules | DEC-1. |
@@ -51,8 +51,8 @@ how it exposes the full list to assistive technology.
Consumers, in adoption order:
-1. Selector's option list.
-2. Table's row virtualization, behind `module:Table/useTableRowsVirtualization`.
+1. Table's row virtualization, behind `module:Table/useTableRowsVirtualization`.
+2. Selector's option list.
3. Chat's message list.
## Boundaries and invariants
@@ -74,8 +74,8 @@ Consumers, in adoption order:
## Current-state impact
-- **No module exists yet.** The build has not started. Selector renders every
- option when it opens. Table's virtualization hook is specified in
+- **No module exists yet.** Selector renders every option when it opens.
+ Table's virtualization hook is specified in
`module:Table/useTableRowsVirtualization` but not built; Chat renders every
message.
@@ -87,9 +87,9 @@ windowing symbol.
## Owning code
-- `packages/core/src/Selector/` — the first consumer.
- `module:Table/useTableRowsVirtualization` — Table's public virtualization
- hook, the second consumer; it has no code yet (Current-state impact).
+ hook, the first consumer; it has no code yet (Current-state impact).
+- `packages/core/src/Selector/` — the second consumer.
- `packages/core/src/Chat/` — the third consumer.
The module itself has no path yet (Current-state impact).
@@ -99,10 +99,10 @@ The module itself has no path yet (Current-state impact).
### DEC-1 — One shared private windowing module
**Reference:** `architecture:list-windowing/DEC-1`
-**Decider:** `cixzhang`, `2026-11-06`
+**Decider:** `humbertovirtudes`, `2026-11-08`
One shared private windowing module owns long-list windowing in Core; spec
-only. Selector adopts it first, then Table virtualization and Chat. The module
+only. Table virtualization adopts it first, then Selector and Chat. The module
stays private while OQ1 is open.
## Open questions