peter
5bfcf5d83a
The app HAS a platform layer -- AnchoredPopover (22 importers, with arrows/typeahead/Escape/anchor-flip), QueryState (21), Modal (17), PageShell, DataTable, Tabs, Tooltip and ~26 more -- but it sat flat among ~160 feature components with nothing marking it as one. Several of those files describe themselves as 'the one place' or 'canonical' and were still bypassed by hand-rolled markup, because a layer nobody can see is a layer nobody uses; three separate inventory passes of this codebase misread it the same way. Moves the 33 domain-free modules into components/ui/, rewrites the imports in 89 files, and makes the boundary a lint rule rather than a convention: inside ui/ a one-level-up import (a feature component) and any lib/api slice are errors. The rule was verified to fire on both and to leave generic lib/ helpers alone. README.md states which side of the line a component belongs on and why. No behaviour change: 3x tsc, eslint, knip, prettier and 687 vitest tests all green; no backend file touched.
31 lines
1.7 KiB
TypeScript
31 lines
1.7 KiB
TypeScript
// Infinite-scroll read-ahead policy for VirtualGrid, extracted as a pure function so the decision is
|
|
// unit-testable without a layout engine.
|
|
//
|
|
// The next page is pulled once the last rendered row comes within `lookahead` rows of the loaded end,
|
|
// where lookahead scales with the number of rows the viewport currently renders (so it adapts to
|
|
// window height / column count / row height) but is clamped to a floor and a ceiling:
|
|
// - floor PREFETCH_ROWS: the finite-list / first-paint case where nothing is rendered yet.
|
|
// - ceiling MAX_LOOKAHEAD_ROWS: a tall window renders many rows, and an uncapped lookahead would
|
|
// eagerly prefetch several pages on every mount / filter change — wasted work on the app's
|
|
// heaviest query (the feed). The cap bounds that while still buffering a couple of screens ahead.
|
|
export const PREFETCH_ROWS = 4;
|
|
export const PREFETCH_VIEWPORTS = 2;
|
|
export const MAX_LOOKAHEAD_ROWS = 40;
|
|
|
|
/** How many rows ahead of the last rendered row to keep buffered, for a viewport rendering
|
|
* `renderedRows` rows. Clamped to [PREFETCH_ROWS, MAX_LOOKAHEAD_ROWS]. */
|
|
export function readAheadLookahead(renderedRows: number): number {
|
|
return Math.min(MAX_LOOKAHEAD_ROWS, Math.max(PREFETCH_ROWS, renderedRows * PREFETCH_VIEWPORTS));
|
|
}
|
|
|
|
/** Whether to fetch the next page: true once the last rendered row (`lastIndex`) is within the
|
|
* read-ahead window of the loaded end (`rowCount` total loaded rows). Because the caller re-runs
|
|
* this as each page settles, it chains — refilling the buffer as the user consumes it. */
|
|
export function shouldPrefetchNext(
|
|
lastIndex: number,
|
|
rowCount: number,
|
|
renderedRows: number,
|
|
): boolean {
|
|
return lastIndex >= rowCount - 1 - readAheadLookahead(renderedRows);
|
|
}
|