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.mdindex 6ca4cb5f96..6936504997 100644--- a/docs/architecture/list-windowing.md+++ b/docs/architecture/list-windowing.md@@ -6,8 +6,8 @@ id: architecture:list-windowingauthority: currentarchive_reason: nullsuperseded_by: null-approved_by: cixzhang-approved_at: 2026-11-06+approved_by: humbertovirtudes+approved_at: 2026-11-08owners: [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 everymessage.@@ -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 modulestays private while OQ1 is open.## Open questions