@oxyhq/bloom 0.24.1 → 0.25.0

package/lib/module/list/index.web.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["React","StyleSheet","View","useWindowVirtualizer","jsxs","_jsxs","jsx","_jsx","DEFAULT_ESTIMATED_ITEM_SIZE","DEFAULT_OVERSCAN","ROW_REF_CACHE_CAP","renderSlot","slot","VirtualListWebInner","props","ref","data","renderItem","keyExtractor","ListHeaderComponent","ListEmptyComponent","ListFooterComponent","style","contentContainerStyle","estimatedItemSize","overscan","testID","items","count","length","wrapperRef","useRef","scrollMargin","setScrollMargin","useState","measureScrollMargin","useCallback","node","current","window","top","getBoundingClientRect","scrollY","prev","useLayoutEffect","estimate","virtualizer","estimateSize","getItemKey","index","item","undefined","useEffect","sync","measure","addEventListener","removeEventListener","useImperativeHandle","scrollToOffset","params","scrollTo","offset","behavior","animated","y","measureElement","rowRefCallbacks","Map","getRowRef","key","cache","existing","get","size","clear","cb","set","flatStyle","flatten","flatContentStyle","header","footer","minHeight","children","virtualItems","getVirtualItems","totalSize","getTotalSize","lastItem","lastItemEnd","start","options","spacerHeight","Math","max","height","width","position","map","virtualRow","String","left","transform","VirtualList","forwardRef"],"sourceRoot":"../../../src","sources":["list/index.web.tsx"],"mappings":"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","ignoreList":[]}

package/lib/module/list/types.js

@@ -0,0 +1,4 @@
+"use strict";
+
+export {};
+//# sourceMappingURL=types.js.map

package/lib/module/list/types.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["list/types.ts"],"mappings":"","ignoreList":[]}

package/lib/typescript/commonjs/list/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * `VirtualList` — the canonical cross-platform virtualized list for the Oxy
+ * ecosystem. Every app uses this ONE implementation for grouped/stacked row
+ * lists (who-to-follow, starter packs, connections, settings rows, …) so the
+ * virtualization behaviour is identical everywhere.
+ *
+ * NATIVE variant: a thin, correctly-typed wrapper over React Native `FlatList`.
+ * The consumer lists this component replaces are short and uniform, so the
+ * platform's own virtualization is the simplest robust choice — no
+ * `@legendapp/list`, no app-specific scroll bridge, nothing for a consumer to
+ * wire up. Bloom stays app-agnostic.
+ *
+ * WEB variant (`index.web.tsx`, selected via the `"browser"` export condition):
+ * a document-scroll window virtualizer built on `@tanstack/react-virtual`.
+ *
+ * This default file has NO platform-only imports, so consumer `tsc` and web
+ * bundlers resolve it cleanly (mirrors the `../scroll` / `../content-panel`
+ * fork pattern). The public API is shared via `./types`, so both forks expose
+ * an identical, generic, strongly-typed surface.
+ */
+import * as React from 'react';
+import type { VirtualListHandle, VirtualListProps } from './types';
+export type { VirtualListHandle, VirtualListProps, VirtualListRenderItem, VirtualListRenderItemInfo, VirtualListSlot, } from './types';
+declare const VirtualList: <T>(props: VirtualListProps<T> & {
+    ref?: React.Ref<VirtualListHandle>;
+}) => React.ReactElement;
+export { VirtualList };
+export default VirtualList;
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/commonjs/list/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/list/index.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EAEjB,MAAM,SAAS,CAAC;AAEjB,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACrB,yBAAyB,EACzB,eAAe,GAChB,MAAM,SAAS,CAAC;AAgFjB,QAAA,MAAM,WAAW,EAA+C,CAAC,CAAC,EAChE,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG;IAAE,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAA;CAAE,KAChE,KAAK,CAAC,YAAY,CAAC;AAExB,OAAO,EAAE,WAAW,EAAE,CAAC;AACvB,eAAe,WAAW,CAAC"}

package/lib/typescript/commonjs/list/index.web.d.ts

@@ -0,0 +1,45 @@
+/**
+ * `VirtualList` — WEB variant. A document-scroll (window) virtualizer built on
+ * `@tanstack/react-virtual`'s `useWindowVirtualizer`, mirroring the proven
+ * Mention feed virtualizer. The BODY scrolls (so scrolling works from anywhere,
+ * including over sticky side columns) and only the rows in the virtual window
+ * are mounted, so the DOM stays bounded.
+ *
+ * Why this exists (the bug it fixes): a previous app-local list used the same
+ * hook but rendered ZERO rows in production — the wrapper grew to the right
+ * height (`getTotalSize()` was correct) yet `getVirtualItems()` came back empty,
+ * so only the header painted. Root cause: `useWindowVirtualizer` can latch an
+ * initial frame in which the window rect measured as `0` (or `scrollMargin` was
+ * still stale), which leaves the computed range empty; a STATIC, finite list
+ * re-renders too few times to self-correct and sticks on that bad frame. (The
+ * feed only survived by incidental re-render churn — data/loading updates and
+ * scroll/intersection observers — which a plain list does not have.)
+ *
+ * This implementation is SELF-SUFFICIENT and does not rely on incidental churn:
+ *
+ *  1. `scrollMargin` (the wrapper's offset from the document top) is measured in
+ *     a layout effect AND re-synced on window `resize`.
+ *  2. An explicit post-mount recompute (`virtualizer.measure()`) forces the
+ *     range to be recomputed once the real viewport height + offset are known —
+ *     guaranteeing a short list mounts EVERY row in the first viewport even with
+ *     zero further re-renders. Re-run on resize.
+ *  3. The measured spacer is `Math.max(totalSize, lastItemEnd)`, so it always
+ *     contains every absolutely-positioned row even when `scrollMargin` is
+ *     momentarily stale; the document therefore always grows to the full content
+ *     height (keeping sticky side rails pinned) and the window-scroll geometry
+ *     the virtualizer reads stays consistent.
+ *  4. Per-row `measureElement` refs are STABLE (cached per key), so rows are not
+ *     detached/re-measured on every render.
+ *
+ * Native bundlers use `./index.tsx` (a `FlatList` wrapper); web bundlers select
+ * this file via the `"browser"` export condition in `package.json`.
+ */
+import * as React from 'react';
+import type { VirtualListHandle, VirtualListProps } from './types';
+export type { VirtualListHandle, VirtualListProps, VirtualListRenderItem, VirtualListRenderItemInfo, VirtualListSlot, } from './types';
+declare const VirtualList: <T>(props: VirtualListProps<T> & {
+    ref?: React.Ref<VirtualListHandle>;
+}) => React.ReactElement;
+export { VirtualList };
+export default VirtualList;
+//# sourceMappingURL=index.web.d.ts.map

package/lib/typescript/commonjs/list/index.web.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.web.d.ts","sourceRoot":"","sources":["../../../../src/list/index.web.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAK/B,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EAEjB,MAAM,SAAS,CAAC;AAEjB,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACrB,yBAAyB,EACzB,eAAe,GAChB,MAAM,SAAS,CAAC;AA0MjB,QAAA,MAAM,WAAW,EAA4C,CAAC,CAAC,EAC7D,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG;IAAE,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAA;CAAE,KAChE,KAAK,CAAC,YAAY,CAAC;AAExB,OAAO,EAAE,WAAW,EAAE,CAAC;AACvB,eAAe,WAAW,CAAC"}

package/lib/typescript/commonjs/list/types.d.ts

@@ -0,0 +1,77 @@
+import type { ReactElement } from 'react';
+import type { StyleProp, ViewStyle } from 'react-native';
+/** Info passed to {@link VirtualListProps.renderItem} for each row. */
+export interface VirtualListRenderItemInfo<T> {
+    item: T;
+    index: number;
+}
+/** Row renderer. Returns the element for a single item (or `null` to skip). */
+export type VirtualListRenderItem<T> = (info: VirtualListRenderItemInfo<T>) => ReactElement | null;
+/**
+ * A header / empty / footer slot. Either a ready element or a thunk that
+ * produces one — both `<X />` and `() => <X />` call sites are supported,
+ * matching React Native `FlatList` slot ergonomics.
+ */
+export type VirtualListSlot = ReactElement | (() => ReactElement | null) | null | undefined;
+/**
+ * Props for {@link VirtualList} — the canonical cross-platform virtualized list
+ * for the Oxy ecosystem. The shape is a precise drop-in for the `FlatList` /
+ * `@legendapp/list` call sites it replaces: every accepted prop is listed
+ * explicitly (no index signature, no `any`).
+ */
+export interface VirtualListProps<T> {
+    /** Row data. */
+    data?: readonly T[] | null;
+    /** Renders one row. */
+    renderItem?: VirtualListRenderItem<T>;
+    /** Stable key for a row; strongly recommended for correct virtualization. */
+    keyExtractor?: (item: T, index: number) => string;
+    /** Rendered above the rows; scrolls away with the content. */
+    ListHeaderComponent?: VirtualListSlot;
+    /** Rendered (in place of rows) when `data` is empty. */
+    ListEmptyComponent?: VirtualListSlot;
+    /** Rendered below the rows. */
+    ListFooterComponent?: VirtualListSlot;
+    /** Style for the outer list container. */
+    style?: StyleProp<ViewStyle>;
+    /** Style for the inner content wrapper (e.g. padding). */
+    contentContainerStyle?: StyleProp<ViewStyle>;
+    /**
+     * First-paint row-height estimate (px) used before a row is measured. On web
+     * each row is measured after mount and this is only the initial guess.
+     */
+    estimatedItemSize?: number;
+    /** Web: extra rows mounted beyond the viewport (virtualization overscan). */
+    overscan?: number;
+    /** Called when the end of the list is approached (native pagination). */
+    onEndReached?: () => void;
+    /** Native: viewport-relative distance from the end that fires `onEndReached`. */
+    onEndReachedThreshold?: number;
+    /** Pull-to-refresh active flag (native). */
+    refreshing?: boolean;
+    /** Pull-to-refresh handler (native). */
+    onRefresh?: () => void;
+    /** Test id applied to the outer container. */
+    testID?: string;
+    removeClippedSubviews?: boolean;
+    maxToRenderPerBatch?: number;
+    windowSize?: number;
+    initialNumToRender?: number;
+    recycleItems?: boolean;
+    maintainVisibleContentPosition?: boolean;
+}
+/** Imperative handle exposed via `ref`. */
+export interface VirtualListHandle {
+    /** Scroll to an absolute offset (px). Web scrolls the document. */
+    scrollToOffset: (params?: {
+        offset?: number;
+        animated?: boolean;
+    }) => void;
+    /** Scroll to a coordinate. Web scrolls the document to `y`. */
+    scrollTo: (params?: {
+        x?: number;
+        y?: number;
+        animated?: boolean;
+    }) => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/typescript/commonjs/list/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/list/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAC1C,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzD,uEAAuE;AACvE,MAAM,WAAW,yBAAyB,CAAC,CAAC;IAC1C,IAAI,EAAE,CAAC,CAAC;IACR,KAAK,EAAE,MAAM,CAAC;CACf;AAED,+EAA+E;AAC/E,MAAM,MAAM,qBAAqB,CAAC,CAAC,IAAI,CACrC,IAAI,EAAE,yBAAyB,CAAC,CAAC,CAAC,KAC/B,YAAY,GAAG,IAAI,CAAC;AAEzB;;;;GAIG;AACH,MAAM,MAAM,eAAe,GACvB,YAAY,GACZ,CAAC,MAAM,YAAY,GAAG,IAAI,CAAC,GAC3B,IAAI,GACJ,SAAS,CAAC;AAEd;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,gBAAgB;IAChB,IAAI,CAAC,EAAE,SAAS,CAAC,EAAE,GAAG,IAAI,CAAC;IAC3B,uBAAuB;IACvB,UAAU,CAAC,EAAE,qBAAqB,CAAC,CAAC,CAAC,CAAC;IACtC,6EAA6E;IAC7E,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IAClD,8DAA8D;IAC9D,mBAAmB,CAAC,EAAE,eAAe,CAAC;IACtC,wDAAwD;IACxD,kBAAkB,CAAC,EAAE,eAAe,CAAC;IACrC,+BAA+B;IAC/B,mBAAmB,CAAC,EAAE,eAAe,CAAC;IACtC,0CAA0C;IAC1C,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,0DAA0D;IAC1D,qBAAqB,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7C;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,iFAAiF;IACjF,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,4CAA4C;IAC5C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC;IAMhB,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,8BAA8B,CAAC,EAAE,OAAO,CAAC;CAC1C;AAED,2CAA2C;AAC3C,MAAM,WAAW,iBAAiB;IAChC,mEAAmE;IACnE,cAAc,EAAE,CAAC,MAAM,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IAC3E,+DAA+D;IAC/D,QAAQ,EAAE,CAAC,MAAM,CAAC,EAAE;QAAE,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;CAC7E"}

package/lib/typescript/module/list/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * `VirtualList` — the canonical cross-platform virtualized list for the Oxy
+ * ecosystem. Every app uses this ONE implementation for grouped/stacked row
+ * lists (who-to-follow, starter packs, connections, settings rows, …) so the
+ * virtualization behaviour is identical everywhere.
+ *
+ * NATIVE variant: a thin, correctly-typed wrapper over React Native `FlatList`.
+ * The consumer lists this component replaces are short and uniform, so the
+ * platform's own virtualization is the simplest robust choice — no
+ * `@legendapp/list`, no app-specific scroll bridge, nothing for a consumer to
+ * wire up. Bloom stays app-agnostic.
+ *
+ * WEB variant (`index.web.tsx`, selected via the `"browser"` export condition):
+ * a document-scroll window virtualizer built on `@tanstack/react-virtual`.
+ *
+ * This default file has NO platform-only imports, so consumer `tsc` and web
+ * bundlers resolve it cleanly (mirrors the `../scroll` / `../content-panel`
+ * fork pattern). The public API is shared via `./types`, so both forks expose
+ * an identical, generic, strongly-typed surface.
+ */
+import * as React from 'react';
+import type { VirtualListHandle, VirtualListProps } from './types';
+export type { VirtualListHandle, VirtualListProps, VirtualListRenderItem, VirtualListRenderItemInfo, VirtualListSlot, } from './types';
+declare const VirtualList: <T>(props: VirtualListProps<T> & {
+    ref?: React.Ref<VirtualListHandle>;
+}) => React.ReactElement;
+export { VirtualList };
+export default VirtualList;
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/list/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/list/index.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EAEjB,MAAM,SAAS,CAAC;AAEjB,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACrB,yBAAyB,EACzB,eAAe,GAChB,MAAM,SAAS,CAAC;AAgFjB,QAAA,MAAM,WAAW,EAA+C,CAAC,CAAC,EAChE,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG;IAAE,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAA;CAAE,KAChE,KAAK,CAAC,YAAY,CAAC;AAExB,OAAO,EAAE,WAAW,EAAE,CAAC;AACvB,eAAe,WAAW,CAAC"}

package/lib/typescript/module/list/index.web.d.ts

@@ -0,0 +1,45 @@
+/**
+ * `VirtualList` — WEB variant. A document-scroll (window) virtualizer built on
+ * `@tanstack/react-virtual`'s `useWindowVirtualizer`, mirroring the proven
+ * Mention feed virtualizer. The BODY scrolls (so scrolling works from anywhere,
+ * including over sticky side columns) and only the rows in the virtual window
+ * are mounted, so the DOM stays bounded.
+ *
+ * Why this exists (the bug it fixes): a previous app-local list used the same
+ * hook but rendered ZERO rows in production — the wrapper grew to the right
+ * height (`getTotalSize()` was correct) yet `getVirtualItems()` came back empty,
+ * so only the header painted. Root cause: `useWindowVirtualizer` can latch an
+ * initial frame in which the window rect measured as `0` (or `scrollMargin` was
+ * still stale), which leaves the computed range empty; a STATIC, finite list
+ * re-renders too few times to self-correct and sticks on that bad frame. (The
+ * feed only survived by incidental re-render churn — data/loading updates and
+ * scroll/intersection observers — which a plain list does not have.)
+ *
+ * This implementation is SELF-SUFFICIENT and does not rely on incidental churn:
+ *
+ *  1. `scrollMargin` (the wrapper's offset from the document top) is measured in
+ *     a layout effect AND re-synced on window `resize`.
+ *  2. An explicit post-mount recompute (`virtualizer.measure()`) forces the
+ *     range to be recomputed once the real viewport height + offset are known —
+ *     guaranteeing a short list mounts EVERY row in the first viewport even with
+ *     zero further re-renders. Re-run on resize.
+ *  3. The measured spacer is `Math.max(totalSize, lastItemEnd)`, so it always
+ *     contains every absolutely-positioned row even when `scrollMargin` is
+ *     momentarily stale; the document therefore always grows to the full content
+ *     height (keeping sticky side rails pinned) and the window-scroll geometry
+ *     the virtualizer reads stays consistent.
+ *  4. Per-row `measureElement` refs are STABLE (cached per key), so rows are not
+ *     detached/re-measured on every render.
+ *
+ * Native bundlers use `./index.tsx` (a `FlatList` wrapper); web bundlers select
+ * this file via the `"browser"` export condition in `package.json`.
+ */
+import * as React from 'react';
+import type { VirtualListHandle, VirtualListProps } from './types';
+export type { VirtualListHandle, VirtualListProps, VirtualListRenderItem, VirtualListRenderItemInfo, VirtualListSlot, } from './types';
+declare const VirtualList: <T>(props: VirtualListProps<T> & {
+    ref?: React.Ref<VirtualListHandle>;
+}) => React.ReactElement;
+export { VirtualList };
+export default VirtualList;
+//# sourceMappingURL=index.web.d.ts.map

package/lib/typescript/module/list/index.web.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.web.d.ts","sourceRoot":"","sources":["../../../../src/list/index.web.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAK/B,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EAEjB,MAAM,SAAS,CAAC;AAEjB,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACrB,yBAAyB,EACzB,eAAe,GAChB,MAAM,SAAS,CAAC;AA0MjB,QAAA,MAAM,WAAW,EAA4C,CAAC,CAAC,EAC7D,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG;IAAE,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAA;CAAE,KAChE,KAAK,CAAC,YAAY,CAAC;AAExB,OAAO,EAAE,WAAW,EAAE,CAAC;AACvB,eAAe,WAAW,CAAC"}

package/lib/typescript/module/list/types.d.ts

@@ -0,0 +1,77 @@
+import type { ReactElement } from 'react';
+import type { StyleProp, ViewStyle } from 'react-native';
+/** Info passed to {@link VirtualListProps.renderItem} for each row. */
+export interface VirtualListRenderItemInfo<T> {
+    item: T;
+    index: number;
+}
+/** Row renderer. Returns the element for a single item (or `null` to skip). */
+export type VirtualListRenderItem<T> = (info: VirtualListRenderItemInfo<T>) => ReactElement | null;
+/**
+ * A header / empty / footer slot. Either a ready element or a thunk that
+ * produces one — both `<X />` and `() => <X />` call sites are supported,
+ * matching React Native `FlatList` slot ergonomics.
+ */
+export type VirtualListSlot = ReactElement | (() => ReactElement | null) | null | undefined;
+/**
+ * Props for {@link VirtualList} — the canonical cross-platform virtualized list
+ * for the Oxy ecosystem. The shape is a precise drop-in for the `FlatList` /
+ * `@legendapp/list` call sites it replaces: every accepted prop is listed
+ * explicitly (no index signature, no `any`).
+ */
+export interface VirtualListProps<T> {
+    /** Row data. */
+    data?: readonly T[] | null;
+    /** Renders one row. */
+    renderItem?: VirtualListRenderItem<T>;
+    /** Stable key for a row; strongly recommended for correct virtualization. */
+    keyExtractor?: (item: T, index: number) => string;
+    /** Rendered above the rows; scrolls away with the content. */
+    ListHeaderComponent?: VirtualListSlot;
+    /** Rendered (in place of rows) when `data` is empty. */
+    ListEmptyComponent?: VirtualListSlot;
+    /** Rendered below the rows. */
+    ListFooterComponent?: VirtualListSlot;
+    /** Style for the outer list container. */
+    style?: StyleProp<ViewStyle>;
+    /** Style for the inner content wrapper (e.g. padding). */
+    contentContainerStyle?: StyleProp<ViewStyle>;
+    /**
+     * First-paint row-height estimate (px) used before a row is measured. On web
+     * each row is measured after mount and this is only the initial guess.
+     */
+    estimatedItemSize?: number;
+    /** Web: extra rows mounted beyond the viewport (virtualization overscan). */
+    overscan?: number;
+    /** Called when the end of the list is approached (native pagination). */
+    onEndReached?: () => void;
+    /** Native: viewport-relative distance from the end that fires `onEndReached`. */
+    onEndReachedThreshold?: number;
+    /** Pull-to-refresh active flag (native). */
+    refreshing?: boolean;
+    /** Pull-to-refresh handler (native). */
+    onRefresh?: () => void;
+    /** Test id applied to the outer container. */
+    testID?: string;
+    removeClippedSubviews?: boolean;
+    maxToRenderPerBatch?: number;
+    windowSize?: number;
+    initialNumToRender?: number;
+    recycleItems?: boolean;
+    maintainVisibleContentPosition?: boolean;
+}
+/** Imperative handle exposed via `ref`. */
+export interface VirtualListHandle {
+    /** Scroll to an absolute offset (px). Web scrolls the document. */
+    scrollToOffset: (params?: {
+        offset?: number;
+        animated?: boolean;
+    }) => void;
+    /** Scroll to a coordinate. Web scrolls the document to `y`. */
+    scrollTo: (params?: {
+        x?: number;
+        y?: number;
+        animated?: boolean;
+    }) => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/typescript/module/list/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/list/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAC1C,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzD,uEAAuE;AACvE,MAAM,WAAW,yBAAyB,CAAC,CAAC;IAC1C,IAAI,EAAE,CAAC,CAAC;IACR,KAAK,EAAE,MAAM,CAAC;CACf;AAED,+EAA+E;AAC/E,MAAM,MAAM,qBAAqB,CAAC,CAAC,IAAI,CACrC,IAAI,EAAE,yBAAyB,CAAC,CAAC,CAAC,KAC/B,YAAY,GAAG,IAAI,CAAC;AAEzB;;;;GAIG;AACH,MAAM,MAAM,eAAe,GACvB,YAAY,GACZ,CAAC,MAAM,YAAY,GAAG,IAAI,CAAC,GAC3B,IAAI,GACJ,SAAS,CAAC;AAEd;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,gBAAgB;IAChB,IAAI,CAAC,EAAE,SAAS,CAAC,EAAE,GAAG,IAAI,CAAC;IAC3B,uBAAuB;IACvB,UAAU,CAAC,EAAE,qBAAqB,CAAC,CAAC,CAAC,CAAC;IACtC,6EAA6E;IAC7E,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IAClD,8DAA8D;IAC9D,mBAAmB,CAAC,EAAE,eAAe,CAAC;IACtC,wDAAwD;IACxD,kBAAkB,CAAC,EAAE,eAAe,CAAC;IACrC,+BAA+B;IAC/B,mBAAmB,CAAC,EAAE,eAAe,CAAC;IACtC,0CAA0C;IAC1C,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,0DAA0D;IAC1D,qBAAqB,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7C;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,iFAAiF;IACjF,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,4CAA4C;IAC5C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC;IAMhB,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,8BAA8B,CAAC,EAAE,OAAO,CAAC;CAC1C;AAED,2CAA2C;AAC3C,MAAM,WAAW,iBAAiB;IAChC,mEAAmE;IACnE,cAAc,EAAE,CAAC,MAAM,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IAC3E,+DAA+D;IAC/D,QAAQ,EAAE,CAAC,MAAM,CAAC,EAAE;QAAE,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;CAC7E"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oxyhq/bloom",
-  "version": "0.24.1",
+  "version": "0.25.0",
   "description": "Bloom UI — Oxy ecosystem component library for React Native + Expo + Web",
   "main": "lib/commonjs/index.js",
   "module": "lib/module/index.js",
@@ -805,6 +805,22 @@
         "default": "./lib/commonjs/content-panel/index.js"
       }
     },
+    "./list": {
+      "react-native": "./src/list/index.tsx",
+      "browser": {
+        "types": "./lib/typescript/module/list/index.web.d.ts",
+        "import": "./lib/module/list/index.web.js",
+        "require": "./lib/commonjs/list/index.web.js"
+      },
+      "import": {
+        "types": "./lib/typescript/module/list/index.d.ts",
+        "default": "./lib/module/list/index.js"
+      },
+      "require": {
+        "types": "./lib/typescript/commonjs/list/index.d.ts",
+        "default": "./lib/commonjs/list/index.js"
+      }
+    },
     "./package.json": "./package.json"
   },
   "files": [
@@ -860,6 +876,8 @@
     "label",
     "kbd",
     "item",
+    "list",
+    "virtual-list",
     "ai"
   ],
   "repository": {
@@ -992,6 +1010,7 @@
     ]
   },
   "dependencies": {
+    "@tanstack/react-virtual": "^3.14.3",
     "nanoid": "^5.1.5",
     "react-native-css": "3.0.7",
     "react-remove-scroll-bar": "^2.3.8"

package/src/__tests__/VirtualList.native.test.tsx

@@ -0,0 +1,67 @@
+import React from 'react';
+import { Text } from 'react-native';
+import { render } from '@testing-library/react-native';
+
+import { VirtualList, type VirtualListHandle } from '../list';
+
+interface Row {
+  id: string;
+  label: string;
+}
+
+describe('VirtualList (native)', () => {
+  it('renders the header and every row through FlatList', () => {
+    const data: Row[] = [
+      { id: 'a', label: 'Alpha' },
+      { id: 'b', label: 'Bravo' },
+      { id: 'c', label: 'Charlie' },
+    ];
+
+    const { getByText } = render(
+      <VirtualList<Row>
+        data={data}
+        keyExtractor={(item) => item.id}
+        renderItem={({ item }) => <Text>{item.label}</Text>}
+        ListHeaderComponent={<Text>Header row</Text>}
+      />,
+    );
+
+    expect(getByText('Header row')).toBeTruthy();
+    expect(getByText('Alpha')).toBeTruthy();
+    expect(getByText('Bravo')).toBeTruthy();
+    expect(getByText('Charlie')).toBeTruthy();
+  });
+
+  it('renders the empty slot (and no rows) when data is empty', () => {
+    const { getByText, queryByText } = render(
+      <VirtualList<Row>
+        data={[]}
+        keyExtractor={(item) => item.id}
+        renderItem={({ item }) => <Text>{item.label}</Text>}
+        ListEmptyComponent={<Text>Nothing here</Text>}
+      />,
+    );
+
+    expect(getByText('Nothing here')).toBeTruthy();
+    expect(queryByText('Alpha')).toBeNull();
+  });
+
+  it('exposes an imperative scroll handle via ref', () => {
+    const ref = React.createRef<VirtualListHandle>();
+
+    render(
+      <VirtualList<Row>
+        ref={ref}
+        data={[{ id: 'a', label: 'Alpha' }]}
+        keyExtractor={(item) => item.id}
+        renderItem={({ item }) => <Text>{item.label}</Text>}
+      />,
+    );
+
+    expect(typeof ref.current?.scrollToOffset).toBe('function');
+    expect(typeof ref.current?.scrollTo).toBe('function');
+    // The FlatList mock does not implement scrollToOffset; calling the handle
+    // must be a safe no-op (optional-chained internal ref), never a throw.
+    expect(() => ref.current?.scrollToOffset({ offset: 0 })).not.toThrow();
+  });
+});

package/src/__tests__/VirtualList.web.test.tsx

@@ -0,0 +1,127 @@
+/**
+ * @jest-environment jsdom
+ */
+
+import React from 'react';
+import { act } from 'react';
+import { createRoot, type Root } from 'react-dom/client';
+import { getByText, queryByText } from '@testing-library/dom';
+import '@testing-library/jest-dom';
+
+import { VirtualList } from '../list/index.web';
+
+// `@tanstack/react-virtual` measures rows via ResizeObserver + getBoundingClientRect,
+// neither of which jsdom implements with a real layout engine. Stub both so the
+// window virtualizer computes a deterministic, non-empty range against jsdom's
+// default 768px-tall window — exactly the path that regressed in production
+// (rows present, wrapper sized, but `getVirtualItems()` came back empty).
+class ResizeObserverStub {
+  constructor(_cb: ResizeObserverCallback) {}
+  observe(): void {}
+  unobserve(): void {}
+  disconnect(): void {}
+}
+globalThis.ResizeObserver = ResizeObserverStub;
+
+const ROW_HEIGHT = 64;
+
+beforeAll(() => {
+  jest
+    .spyOn(Element.prototype, 'getBoundingClientRect')
+    .mockImplementation((): DOMRect => ({
+      x: 0,
+      y: 0,
+      top: 0,
+      left: 0,
+      right: 0,
+      bottom: ROW_HEIGHT,
+      width: 0,
+      height: ROW_HEIGHT,
+      toJSON: () => ({}),
+    }));
+});
+
+afterAll(() => {
+  jest.restoreAllMocks();
+});
+
+(globalThis as { IS_REACT_ACT_ENVIRONMENT?: boolean }).IS_REACT_ACT_ENVIRONMENT = true;
+
+let container: HTMLDivElement;
+let root: Root;
+
+function mount(ui: React.ReactElement): HTMLElement {
+  act(() => {
+    root.render(ui);
+  });
+  return container;
+}
+
+beforeEach(() => {
+  container = document.createElement('div');
+  document.body.appendChild(container);
+  root = createRoot(container);
+});
+
+afterEach(() => {
+  act(() => root.unmount());
+  container.remove();
+});
+
+interface Row {
+  id: string;
+  label: string;
+}
+
+describe('VirtualList (web)', () => {
+  it('mounts EVERY row of a short list in the first viewport (the empty-rows regression)', () => {
+    const data: Row[] = Array.from({ length: 5 }, (_, i) => ({
+      id: String(i),
+      label: `Row ${i}`,
+    }));
+
+    const c = mount(
+      <VirtualList<Row>
+        data={data}
+        keyExtractor={(item) => item.id}
+        renderItem={({ item }) => <span>{item.label}</span>}
+        ListHeaderComponent={<div>List header</div>}
+      />,
+    );
+
+    expect(getByText(c, 'List header')).toBeTruthy();
+    for (const row of data) {
+      expect(getByText(c, row.label)).toBeTruthy();
+    }
+  });
+
+  it('renders the header + empty slot (and no rows) when data is empty', () => {
+    const c = mount(
+      <VirtualList<Row>
+        data={[]}
+        keyExtractor={(item) => item.id}
+        renderItem={({ item }) => <span>{item.label}</span>}
+        ListHeaderComponent={<div>List header</div>}
+        ListEmptyComponent={<div>Nothing here</div>}
+      />,
+    );
+
+    expect(getByText(c, 'List header')).toBeTruthy();
+    expect(getByText(c, 'Nothing here')).toBeTruthy();
+    expect(queryByText(c, 'Row 0')).toBeNull();
+  });
+
+  it('supports a thunk slot for the header', () => {
+    const c = mount(
+      <VirtualList<Row>
+        data={[{ id: 'a', label: 'Only row' }]}
+        keyExtractor={(item) => item.id}
+        renderItem={({ item }) => <span>{item.label}</span>}
+        ListHeaderComponent={() => <div>Thunk header</div>}
+      />,
+    );
+
+    expect(getByText(c, 'Thunk header')).toBeTruthy();
+    expect(getByText(c, 'Only row')).toBeTruthy();
+  });
+});