From 65f5de566b91745fcb0b73a468ae3c00edc9d7d3 Mon Sep 17 00:00:00 2001 From: Cindy Zhang Date: Mon, 9 Nov 2026 06:19:55 -0800 Subject: [PATCH 01/14] docs(windowing): every virtualizer works in container and page scroll architecture:list-windowing gains INV4: every virtualizer, the shared engine and each consumer, works inside a container scroll area and with page (document) scroll. A Requirements section adds FR1-FR4 for the shared engine: configurable anchoring (first visible, end, item), an anchored row that keeps its position through streaming inserts and item resizes, variable row heights, and container and page scroll. The engine is chosen by a measured comparison on performance and row-position accuracy. DEC-2 and DEC-3 quote the owner's decisions. Current-state impact and Verification record Table's INV4 gap. --- docs/architecture/list-windowing.md | 61 ++++++++++++++++++++++++++--- 1 file changed, 55 insertions(+), 6 deletions(-) diff --git a/docs/architecture/list-windowing.md b/docs/architecture/list-windowing.md index 6936504997710..070e1ff1e2bc9 100644 --- a/docs/architecture/list-windowing.md +++ b/docs/architecture/list-windowing.md @@ -31,7 +31,7 @@ deciding_specs: [] | 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: 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. | +| Governing rules | DEC-1, DEC-2, DEC-3. | This table is a review projection; the body below is authoritative. @@ -55,6 +55,22 @@ Consumers, in adoption order: 2. Selector's option list. 3. Chat's message list. +## Requirements + +- **FR1 — Configurable anchoring.** The shared windowing engine anchors the + window to the first visible row, to the end (follow), or to a given item, as + the consumer configures. +- **FR2 — The anchored row keeps its position.** The anchored row keeps its + position through streaming inserts, above it or at the end, and through item + resizes. +- **FR3 — Variable row heights.** The engine positions rows of variable + height. +- **FR4 — Container and page scroll.** The engine works inside a container + scroll area and with page (document) scroll (INV4). + +The engine is chosen by a measured comparison of candidates on performance and +row-position accuracy (DEC-3). + ## Boundaries and invariants - **INV1 — One windowing module in Core.** In `@astryxdesign/core`, one shared @@ -71,6 +87,9 @@ Consumers, in adoption order: - **INV3 — Consumers keep their public shapes.** Adopting the module changes no consumer's public API. `module:Table/useTableRowsVirtualization` keeps its approved public shape and uses the module internally. +- **INV4 — Container and page scroll.** Every virtualizer, the shared engine + and each consumer, works both inside a container scroll area and with page + (document) scroll. ## Current-state impact @@ -78,6 +97,8 @@ Consumers, in adoption order: Table's virtualization hook is specified in `module:Table/useTableRowsVirtualization` but not built; Chat renders every message. +- **INV4 gap:** Table windows only inside its own bounded viewport; on a + scrolling page or inside an outer scroll container it renders every row. ## Change coupling @@ -105,6 +126,33 @@ One shared private windowing module owns long-list windowing in Core; spec only. Table virtualization adopts it first, then Selector and Chat. The module stays private while OQ1 is open. +### DEC-2 — Virtualizers work in container and page scroll + +**Reference:** `architecture:list-windowing/DEC-2` +**Decider:** `cixzhang`, `2026-11-09` + +> any visualizer engine needs to be able to attach to any scroll ref + +> i want to instead require that visualizers should work in both container +> scroll areas as well as page scroll + +The second statement refines the first; "visualizer" means virtualizer. Every +virtualizer works inside a container scroll area and with page (document) +scroll (INV4, FR4). No scroll-ref API is required. + +### DEC-3 — Common engine requirements + +**Reference:** `architecture:list-windowing/DEC-3` +**Decider:** `cixzhang`, `2026-11-09` + +> In the common visualizer, anchoring will need to be configurable, scroll +> positions keep properly with streaming data, then i want to pick the engine +> with best perf and accuracy for row positions with variable height + +"Visualizer" means virtualizer. The shared windowing engine meets FR1–FR4. The +engine is chosen by a measured comparison of candidates on performance and +row-position accuracy. + ## Open questions - **OQ1 — Is the windowing module public (a hook) or internal only?** Not @@ -112,8 +160,9 @@ stays private while OQ1 is open. ## Verification -| Invariant | Evidence | Failure signal | -| --------- | ------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------- | -| INV1 | Review of each Core list that windows (evidence gap: no module or automated check exists yet) | A Core component keeps its own windowing implementation beside the module | -| INV2 | Public export review of every package entry point (evidence gap: no module exists yet) | The module, or a type only it uses, is reachable from a public entry point | -| INV3 | The public-API report for `useTableRowsVirtualization` and each consumer (evidence gap: the hook is not built yet) | Adopting the module changes a consumer's public props, types, or exports | +| Invariant | Evidence | Failure signal | +| --------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- | +| INV1 | Review of each Core list that windows (evidence gap: no module or automated check exists yet) | A Core component keeps its own windowing implementation beside the module | +| INV2 | Public export review of every package entry point (evidence gap: no module exists yet) | The module, or a type only it uses, is reachable from a public entry point | +| INV3 | The public-API report for `useTableRowsVirtualization` and each consumer (evidence gap: the hook is not built yet) | Adopting the module changes a consumer's public props, types, or exports | +| INV4 | Each consumer's windowed list inside a container scroll area and on a scrolling page (evidence gap: Table windows only inside its own viewport) | A consumer renders every row, or places rows wrongly, when the page or an outer container scrolls | From b6c4a7c9e15ad5316ef9fc5409ac1015c7be21f4 Mon Sep 17 00:00:00 2001 From: cixzhang Date: Mon, 9 Nov 2026 08:46:52 -0800 Subject: [PATCH 02/14] docs(windowing): record the plain-Table size gap against INV5 --- docs/architecture/list-windowing.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/architecture/list-windowing.md b/docs/architecture/list-windowing.md index dba13a9dfae7e..a684a56e36a3a 100644 --- a/docs/architecture/list-windowing.md +++ b/docs/architecture/list-windowing.md @@ -101,6 +101,7 @@ row-position accuracy (DEC-3). - **INV4 gap:** Table windows only inside its own bounded viewport; on a scrolling page or inside an outer scroll container it renders every row. - **INV5 gap:** Table's adapter (controller and wiring) measures about 5.3 KB. +- **INV5 gap:** a plain Table that never windows carries about 6.2 KB minified and gzipped of the windowing stack. - **INV5 gap:** the chat virtualizer's own code measures 4.7 KB, with no split between shared engine and chat adapter. ## Change coupling From 72c69ef7d29c463f33bc1fed648d8e5795cff48f Mon Sep 17 00:00:00 2001 From: cixzhang Date: Mon, 9 Nov 2026 08:50:13 -0800 Subject: [PATCH 03/14] docs(windowing): define what an adapter's size counts (INV5) --- docs/architecture/list-windowing.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/architecture/list-windowing.md b/docs/architecture/list-windowing.md index a684a56e36a3a..8eeb05d600aa1 100644 --- a/docs/architecture/list-windowing.md +++ b/docs/architecture/list-windowing.md @@ -90,7 +90,7 @@ row-position accuracy (DEC-3). - **INV4 — Container and page scroll.** Every virtualizer, the shared engine and each consumer, works both inside a container scroll area and with page (document) scroll. -- **INV5 — Size budget.** The shared windowing engine stays at or under 4.9 KB minified and gzipped, the size of the smallest comparable full-featured library (virtua's Virtualizer plus WindowVirtualizer) built with the same settings (esbuild, ESM, minified, React external, gzip -9). Each component's adapter stays at or under 2 KB on the same measure. A change over either budget needs the owner's decision. +- **INV5 — Size budget.** The shared windowing engine stays at or under 4.9 KB minified and gzipped, the size of the smallest comparable full-featured library (virtua's Virtualizer plus WindowVirtualizer) built with the same settings (esbuild, ESM, minified, React external, gzip -9). Each component's adapter stays at or under 2 KB on the same measure. An adapter's size is what windowing adds to a bundle that already holds its host component and the engine: its own code plus the wiring it adds inside the host component, with the engine, React and Core helpers the host already uses left out. A change over either budget needs the owner's decision. ## Current-state impact From 9090e4ebceef8f5d9b65fe9d1268dcc57094bcba Mon Sep 17 00:00:00 2001 From: cixzhang Date: Mon, 9 Nov 2026 13:04:22 -0800 Subject: [PATCH 04/14] docs(windowing): record the owner's VA decision (DEC-6) --- docs/architecture/list-windowing.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/docs/architecture/list-windowing.md b/docs/architecture/list-windowing.md index 8eeb05d600aa1..9a8a49180a2fb 100644 --- a/docs/architecture/list-windowing.md +++ b/docs/architecture/list-windowing.md @@ -166,6 +166,19 @@ row-position accuracy. The owner approved the budget in INV5. It is set from the 2026-11-09 measurement of virtua's Virtualizer plus WindowVirtualizer, 4.9 KB with the same build settings. +### DEC-6 — Table's public windowing API changes only one name + +**Reference:** `architecture:list-windowing/DEC-6` +**Decider:** `cixzhang`, `2026-11-09` + +The owner said: "Va a". `useTableRowsVirtualization` keeps `rowHeight` and +renames `viewportHeight` to `initialViewportHeight`, which Table reads for the +first frame only. The shared vocabulary in DEC-3 (a scroll ref, exact or +estimated item sizes, an anchor) reaches Table's public API only through a +later owner decision. + +Rejected: adding the shared vocabulary to Table's public API now. + ## Open questions - **OQ1 — Is the windowing module public (a hook) or internal only?** Not From 4c9d42b9926959ddc384a2d610cd867a7cef206d Mon Sep 17 00:00:00 2001 From: cixzhang Date: Mon, 9 Nov 2026 15:42:54 -0800 Subject: [PATCH 05/14] docs(windowing): quote the owner's words verbatim in DEC-6 --- docs/architecture/list-windowing.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/architecture/list-windowing.md b/docs/architecture/list-windowing.md index 7695689796ac7..c774821a4b80a 100644 --- a/docs/architecture/list-windowing.md +++ b/docs/architecture/list-windowing.md @@ -173,7 +173,7 @@ The owner approved the budget in INV5. It is set from the 2026-11-09 measurement **Reference:** `architecture:list-windowing/DEC-6` **Decider:** `cixzhang`, `2026-11-09` -> For humberto the public api probably just needs the initialViewportHeight +> For humberto the public api probabyl just needs the initialViewportHeight > rename > Va a From 2b779289c31d2124b09d16948492018ea8a0a09d Mon Sep 17 00:00:00 2001 From: cixzhang Date: Mon, 9 Nov 2026 19:47:04 -0800 Subject: [PATCH 06/14] docs(windowing): DEC-6 records the owner's follow-up words (required; the hook reads the height) --- docs/architecture/list-windowing.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/architecture/list-windowing.md b/docs/architecture/list-windowing.md index c774821a4b80a..d5b61cf8a0197 100644 --- a/docs/architecture/list-windowing.md +++ b/docs/architecture/list-windowing.md @@ -186,6 +186,12 @@ later owner decision. Rejected: adding those options to Table's public API now. +The owner added: "We can keep it required", "It just needs a rename and to +remove it from affecting the actual height of the table", and "mainly because i +dont want the virtualization hook to define the height. It does need to read +the height". So `initialViewportHeight` stays required, and the hook reads the +measured height of Table's scroll area and never defines it. + ## Open questions - **OQ1 — Is the windowing module public (a hook) or internal only?** Not From 5529c312bc45739c76b681c6192d58c22a8fb3c0 Mon Sep 17 00:00:00 2001 From: Cindy Zhang Date: Wed, 18 Nov 2026 07:50:12 -0800 Subject: [PATCH 07/14] docs(windowing): FR3 is a gap against the fixed-pitch module; the page-scroll promise names Table's exception --- docs/architecture/list-windowing.md | 24 +++++++++++++----------- 1 file changed, 13 insertions(+), 11 deletions(-) diff --git a/docs/architecture/list-windowing.md b/docs/architecture/list-windowing.md index ced6b8993be10..fd18da0ce024f 100644 --- a/docs/architecture/list-windowing.md +++ b/docs/architecture/list-windowing.md @@ -25,15 +25,15 @@ deciding_specs: [] ## Contract at a glance -| 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. The module is not public API (INV1, INV2). | -| End-user impact | People opening a long windowed list wait less, and every windowed list behaves the same way, inside a container scroll area or on a scrolling page (INV4). | -| 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. The module is `packages/core/src/virtualization/`. Table's public virtualization hooks keep their shape except for DEC-6's one rename (INV3). | -| 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, other than DEC-6's one rename. | -| Governing rules | DEC-1, DEC-2, DEC-3, DEC-4, DEC-6. | +| 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. The module is not public API (INV1, INV2). | +| End-user impact | People opening a long windowed list wait less, and every windowed list behaves the same way, inside a container scroll area or on a scrolling page; Table windows only inside its own bounded scroll area (INV4). | +| 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. The module is `packages/core/src/virtualization/`. Table's public virtualization hooks keep their shape except for DEC-6's one rename (INV3). | +| 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, other than DEC-6's one rename. | +| Governing rules | DEC-1, DEC-2, DEC-3, DEC-4, DEC-6. | This table is a review projection; the body below is authoritative. @@ -51,8 +51,8 @@ windowing module computes which rows render and where the scroll range ends. Each consumer keeps its own records for when it windows, what it renders, and how it exposes the full list to assistive technology. -The module windows a list on either scroll axis. On the block axis, all rows -share one pitch. On the inline axis, each item has its own width. The +The module windows a list on either scroll axis. On the inline axis, each item +has its own width. The consumer names the viewport space that its pinned items cover at each edge, and the module plans only for the space between them. The module reads the inline scroll position as a distance from the inline start, so a @@ -117,6 +117,8 @@ row-position accuracy (DEC-3). virtualization (`module:Table/useTableColumnsVirtualization`) use it. Selector renders every option when it opens, and Core's Chat renders every message. +- **FR3 gap:** the shared module positions block-axis rows at one shared + pitch. - **INV4 gap:** Table windows only inside its own bounded viewport; when the page or an outer container is its scroller, it renders every row. - **INV5 gap:** Table's adapter (its virtualization plugin and column From c7058d7a9c836a6a41410e052bf0465715c0fd19 Mon Sep 17 00:00:00 2001 From: Cindy Zhang Date: Wed, 18 Nov 2026 07:51:12 -0800 Subject: [PATCH 08/14] docs(windowing): DEC-2 states the decision, with the scroll ref as its rejected alternative --- docs/architecture/list-windowing.md | 10 +++------- 1 file changed, 3 insertions(+), 7 deletions(-) diff --git a/docs/architecture/list-windowing.md b/docs/architecture/list-windowing.md index fd18da0ce024f..0a3661b32b793 100644 --- a/docs/architecture/list-windowing.md +++ b/docs/architecture/list-windowing.md @@ -163,14 +163,10 @@ module stays private while OQ1 is open. **Reference:** `architecture:list-windowing/DEC-2` **Decider:** `cixzhang`, `2026-11-09` -> any visualizer engine needs to be able to attach to any scroll ref +Every virtualizer works inside a container scroll area and with page +(document) scroll (INV4, FR4). No scroll-ref API is required. -> i want to instead require that visualizers should work in both container -> scroll areas as well as page scroll - -The second statement refines the first; "visualizer" means virtualizer. Every -virtualizer works inside a container scroll area and with page (document) -scroll (INV4, FR4). No scroll-ref API is required. +Rejected: a caller-provided scroll ref. ### DEC-3 — Common engine requirements From ff429942c2fc607c1d5d035b8c7a0dd2b8f046d3 Mon Sep 17 00:00:00 2001 From: Cindy Zhang Date: Wed, 18 Nov 2026 08:10:22 -0800 Subject: [PATCH 09/14] docs(windowing): FR1 gap: the shared module anchors only to the first visible row --- docs/architecture/list-windowing.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/architecture/list-windowing.md b/docs/architecture/list-windowing.md index 0a3661b32b793..85bbc52ad7f6a 100644 --- a/docs/architecture/list-windowing.md +++ b/docs/architecture/list-windowing.md @@ -117,6 +117,8 @@ row-position accuracy (DEC-3). virtualization (`module:Table/useTableColumnsVirtualization`) use it. Selector renders every option when it opens, and Core's Chat renders every message. +- **FR1 gap:** the shared module anchors the window only to the first visible + row; the end (follow) and given-item anchors are not available. - **FR3 gap:** the shared module positions block-axis rows at one shared pitch. - **INV4 gap:** Table windows only inside its own bounded viewport; when the From 39d0ce31d46b746a7eb85ea0036b6010bd4eca29 Mon Sep 17 00:00:00 2001 From: Cindy Zhang Date: Wed, 18 Nov 2026 08:29:52 -0800 Subject: [PATCH 10/14] docs(windowing): a plain Table's windowing carry is import-boundaries INV7's gap, not INV5's --- docs/architecture/list-windowing.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/docs/architecture/list-windowing.md b/docs/architecture/list-windowing.md index 85bbc52ad7f6a..c29d5028dbec3 100644 --- a/docs/architecture/list-windowing.md +++ b/docs/architecture/list-windowing.md @@ -125,8 +125,6 @@ row-position accuracy (DEC-3). page or an outer container is its scroller, it renders every row. - **INV5 gap:** Table's adapter (its virtualization plugin and column windowing, with their wiring) measures about 2.4 KB. -- **INV5 gap:** Table's adapter wiring lives in Table's own component code, so - a plain Table that never windows carries about 4.3 KB of the windowing stack. - **INV5 gap:** Lab's `ChatVirtualizer` measures about 5 KB in its own code. It does not use the shared engine, so it has no split between engine and chat adapter. From ecfd71a0c363502cd00850d811f424c60f602ab5 Mon Sep 17 00:00:00 2001 From: Cindy Zhang Date: Thu, 19 Nov 2026 14:02:25 -0800 Subject: [PATCH 11/14] docs(list-windowing): each Decider line names its decision's time; the owner's words are paraphrased --- docs/architecture/list-windowing.md | 35 +++++++++++------------------ 1 file changed, 13 insertions(+), 22 deletions(-) diff --git a/docs/architecture/list-windowing.md b/docs/architecture/list-windowing.md index c29d5028dbec3..48c31e037b9cc 100644 --- a/docs/architecture/list-windowing.md +++ b/docs/architecture/list-windowing.md @@ -161,7 +161,7 @@ module stays private while OQ1 is open. ### DEC-2 — Virtualizers work in container and page scroll **Reference:** `architecture:list-windowing/DEC-2` -**Decider:** `cixzhang`, `2026-11-09` +**Decider:** `cixzhang`, `2026-11-09 05:52 PT` Every virtualizer works inside a container scroll area and with page (document) scroll (INV4, FR4). No scroll-ref API is required. @@ -171,36 +171,29 @@ Rejected: a caller-provided scroll ref. ### DEC-3 — Common engine requirements **Reference:** `architecture:list-windowing/DEC-3` -**Decider:** `cixzhang`, `2026-11-09` +**Decider:** `cixzhang`, `2026-11-09 05:51 PT` -> In the common visualizer, anchoring will need to be configurable, scroll -> positions keep properly with streaming data, then i want to pick the engine -> with best perf and accuracy for row positions with variable height - -"Visualizer" means virtualizer. The shared windowing engine meets FR1–FR4. The +The owner set three requirements for the shared virtualizer: anchoring is +configurable, scroll positions hold while data streams in, and the engine is +the candidate with the best performance and row-position accuracy for rows of +variable height. The shared windowing engine meets FR1–FR4. The engine is chosen by a measured comparison of candidates on performance and row-position accuracy. ### DEC-4 — The windowing engine and its adapters have a size budget **Reference:** `architecture:list-windowing/DEC-4` -**Decider:** `cixzhang`, `2026-11-09` - -> Size budget ok +**Decider:** `cixzhang`, `2026-11-09 06:35 PT` The owner approved the budget in INV5. It is set from the 2026-11-09 measurement of virtua's Virtualizer plus WindowVirtualizer, 4.9 KB with the same build settings. ### DEC-6 — Table's public windowing API changes only one name **Reference:** `architecture:list-windowing/DEC-6` -**Decider:** `cixzhang`, `2026-11-09` - -> For humberto the public api probabyl just needs the initialViewportHeight -> rename - -> Va a +**Decider:** `cixzhang`, `2026-11-09 06:52 PT` -`useTableRowsVirtualization` keeps `rowHeight` and renames `viewportHeight` to +The owner decided that Table's public windowing API needs only the +`initialViewportHeight` rename. `useTableRowsVirtualization` keeps `rowHeight` and renames `viewportHeight` to `initialViewportHeight`, which Table reads for the first frame only. Other options the owner's card described for later (a callback scroll target, exact or estimated item sizes, an anchor) reach Table's public API only through a @@ -208,11 +201,9 @@ later owner decision. Rejected: adding those options to Table's public API now. -The owner added: "We can keep it required", "It just needs a rename and to -remove it from affecting the actual height of the table", and "mainly because i -dont want the virtualization hook to define the height. It does need to read -the height". So `initialViewportHeight` stays required, and the hook reads the -measured height of Table's scroll area and never defines it. +The option stays required. The rename also stops it from setting Table's +height: the hook reads the measured height of Table's scroll area and never +defines it. ## Open questions From 889abb2a62ec8e4618c3a3b1cd79f3d215281417 Mon Sep 17 00:00:00 2001 From: Cindy Zhang Date: Thu, 19 Nov 2026 14:25:39 -0800 Subject: [PATCH 12/14] docs(list-windowing): decisions state the system in the present tense; Table's adapter is over 2 KB --- docs/architecture/list-windowing.md | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/docs/architecture/list-windowing.md b/docs/architecture/list-windowing.md index 48c31e037b9cc..477cd7f7f9a47 100644 --- a/docs/architecture/list-windowing.md +++ b/docs/architecture/list-windowing.md @@ -124,7 +124,7 @@ row-position accuracy (DEC-3). - **INV4 gap:** Table windows only inside its own bounded viewport; when the page or an outer container is its scroller, it renders every row. - **INV5 gap:** Table's adapter (its virtualization plugin and column - windowing, with their wiring) measures about 2.4 KB. + windowing, with their wiring) measures over 2 KB. - **INV5 gap:** Lab's `ChatVirtualizer` measures about 5 KB in its own code. It does not use the shared engine, so it has no split between engine and chat adapter. @@ -173,10 +173,10 @@ Rejected: a caller-provided scroll ref. **Reference:** `architecture:list-windowing/DEC-3` **Decider:** `cixzhang`, `2026-11-09 05:51 PT` -The owner set three requirements for the shared virtualizer: anchoring is -configurable, scroll positions hold while data streams in, and the engine is -the candidate with the best performance and row-position accuracy for rows of -variable height. The shared windowing engine meets FR1–FR4. The +The shared virtualizer has configurable anchoring and holds scroll positions +while data streams in. Its engine is the candidate with the best performance +and row-position accuracy for rows of variable height. The shared windowing +engine meets FR1–FR4. The engine is chosen by a measured comparison of candidates on performance and row-position accuracy. @@ -185,17 +185,17 @@ row-position accuracy. **Reference:** `architecture:list-windowing/DEC-4` **Decider:** `cixzhang`, `2026-11-09 06:35 PT` -The owner approved the budget in INV5. It is set from the 2026-11-09 measurement of virtua's Virtualizer plus WindowVirtualizer, 4.9 KB with the same build settings. +INV5's budget is set from the 2026-11-09 measurement of virtua's Virtualizer plus WindowVirtualizer, 4.9 KB with the same build settings. ### DEC-6 — Table's public windowing API changes only one name **Reference:** `architecture:list-windowing/DEC-6` **Decider:** `cixzhang`, `2026-11-09 06:52 PT` -The owner decided that Table's public windowing API needs only the -`initialViewportHeight` rename. `useTableRowsVirtualization` keeps `rowHeight` and renames `viewportHeight` to -`initialViewportHeight`, which Table reads for the first frame only. Other -options the owner's card described for later (a callback scroll target, exact +Table's public windowing API changes only by the `initialViewportHeight` +rename. `useTableRowsVirtualization` keeps `rowHeight` and renames +`viewportHeight` to `initialViewportHeight`, which Table reads for the first frame only. Other +options described for later (a callback scroll target, exact or estimated item sizes, an anchor) reach Table's public API only through a later owner decision. From 003cb68249f76e75392ff5c82d73e507b3b0a05d Mon Sep 17 00:00:00 2001 From: Cindy Zhang Date: Thu, 19 Nov 2026 14:44:49 -0800 Subject: [PATCH 13/14] docs(list-windowing): DEC-6 names the later options without a dangling reference --- docs/architecture/list-windowing.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/architecture/list-windowing.md b/docs/architecture/list-windowing.md index 477cd7f7f9a47..d95c0f76722c3 100644 --- a/docs/architecture/list-windowing.md +++ b/docs/architecture/list-windowing.md @@ -195,7 +195,7 @@ INV5's budget is set from the 2026-11-09 measurement of virtua's Virtualizer plu Table's public windowing API changes only by the `initialViewportHeight` rename. `useTableRowsVirtualization` keeps `rowHeight` and renames `viewportHeight` to `initialViewportHeight`, which Table reads for the first frame only. Other -options described for later (a callback scroll target, exact +options (a callback scroll target, exact or estimated item sizes, an anchor) reach Table's public API only through a later owner decision. From 1954ea1a4dcde9d02eb350e34d8d2d3b39349dd2 Mon Sep 17 00:00:00 2001 From: Cindy Zhang Date: Thu, 19 Nov 2026 18:43:12 -0800 Subject: [PATCH 14/14] docs(list-windowing): each Decider line names its decision to the second --- docs/architecture/list-windowing.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/architecture/list-windowing.md b/docs/architecture/list-windowing.md index d95c0f76722c3..27e63f7de20ac 100644 --- a/docs/architecture/list-windowing.md +++ b/docs/architecture/list-windowing.md @@ -161,7 +161,7 @@ module stays private while OQ1 is open. ### DEC-2 — Virtualizers work in container and page scroll **Reference:** `architecture:list-windowing/DEC-2` -**Decider:** `cixzhang`, `2026-11-09 05:52 PT` +**Decider:** `cixzhang`, `2026-11-09 05:52:51 PT` Every virtualizer works inside a container scroll area and with page (document) scroll (INV4, FR4). No scroll-ref API is required. @@ -171,7 +171,7 @@ Rejected: a caller-provided scroll ref. ### DEC-3 — Common engine requirements **Reference:** `architecture:list-windowing/DEC-3` -**Decider:** `cixzhang`, `2026-11-09 05:51 PT` +**Decider:** `cixzhang`, `2026-11-09 05:51:04 PT` The shared virtualizer has configurable anchoring and holds scroll positions while data streams in. Its engine is the candidate with the best performance @@ -183,14 +183,14 @@ row-position accuracy. ### DEC-4 — The windowing engine and its adapters have a size budget **Reference:** `architecture:list-windowing/DEC-4` -**Decider:** `cixzhang`, `2026-11-09 06:35 PT` +**Decider:** `cixzhang`, `2026-11-09 06:35:51 PT` INV5's budget is set from the 2026-11-09 measurement of virtua's Virtualizer plus WindowVirtualizer, 4.9 KB with the same build settings. ### DEC-6 — Table's public windowing API changes only one name **Reference:** `architecture:list-windowing/DEC-6` -**Decider:** `cixzhang`, `2026-11-09 06:52 PT` +**Decider:** `cixzhang`, `2026-11-09 06:52:28 PT` Table's public windowing API changes only by the `initialViewportHeight` rename. `useTableRowsVirtualization` keeps `rowHeight` and renames