@oxyhq/bloom 0.24.0 → 0.25.0

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

@@ -0,0 +1,211 @@
+"use strict";
+
+/**
+ * `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 { StyleSheet, View } from 'react-native';
+import { useWindowVirtualizer } from '@tanstack/react-virtual';
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+// Rows in these lists (user rows, pack cards) are short and fairly uniform; a
+// small estimate + per-row measurement keeps the mounted node count bounded.
+const DEFAULT_ESTIMATED_ITEM_SIZE = 72;
+const DEFAULT_OVERSCAN = 8;
+
+// Bound the per-key ref-callback cache so a very long scroll session does not
+// accumulate one closure per key forever.
+const ROW_REF_CACHE_CAP = 500;
+function renderSlot(slot) {
+  if (!slot) return null;
+  return typeof slot === 'function' ? slot() : slot;
+}
+function VirtualListWebInner(props, ref) {
+  const {
+    data,
+    renderItem,
+    keyExtractor,
+    ListHeaderComponent,
+    ListEmptyComponent,
+    ListFooterComponent,
+    style,
+    contentContainerStyle,
+    estimatedItemSize,
+    overscan,
+    testID
+  } = props;
+  const items = data ?? [];
+  const count = items.length;
+
+  // Wrapper element used as the virtualizer's measurement origin. The window is
+  // the scroller; `scrollMargin` is the wrapper's offset from the document top
+  // (everything above the rows), so virtual offsets map to page offsets.
+  const wrapperRef = React.useRef(null);
+  const [scrollMargin, setScrollMargin] = React.useState(0);
+  const measureScrollMargin = React.useCallback(() => {
+    const node = wrapperRef.current;
+    if (!node || typeof window === 'undefined') return;
+    const top = node.getBoundingClientRect().top + window.scrollY;
+    setScrollMargin(prev => prev !== top ? top : prev);
+  }, []);
+
+  // Read the wrapper's top offset synchronously after layout so the first
+  // virtual frame already positions rows correctly. Re-run when the row count
+  // changes (content above/below the window shifts the wrapper).
+  React.useLayoutEffect(() => {
+    measureScrollMargin();
+  }, [measureScrollMargin, count]);
+  const estimate = estimatedItemSize ?? DEFAULT_ESTIMATED_ITEM_SIZE;
+  const virtualizer = useWindowVirtualizer({
+    count,
+    estimateSize: () => estimate,
+    overscan: overscan ?? DEFAULT_OVERSCAN,
+    scrollMargin,
+    getItemKey: keyExtractor ? index => {
+      const item = items[index];
+      return item !== undefined ? keyExtractor(item, index) : index;
+    } : undefined
+  });
+
+  // Explicit post-mount recompute + resize re-sync. `useWindowVirtualizer` can
+  // latch a frame where the window rect read as 0 / `scrollMargin` was stale,
+  // leaving `getVirtualItems()` empty even though rows exist. A static list does
+  // not re-render enough to self-correct, so we force the range to recompute
+  // once the real viewport + offset are known — and again on every resize.
+  React.useEffect(() => {
+    if (typeof window === 'undefined') return;
+    const sync = () => {
+      measureScrollMargin();
+      virtualizer.measure();
+    };
+    sync();
+    window.addEventListener('resize', sync);
+    return () => window.removeEventListener('resize', sync);
+  }, [measureScrollMargin, virtualizer]);
+  React.useImperativeHandle(ref, () => ({
+    scrollToOffset: params => {
+      if (typeof window === 'undefined') return;
+      window.scrollTo({
+        top: params?.offset ?? 0,
+        behavior: params?.animated === false ? 'auto' : 'smooth'
+      });
+    },
+    scrollTo: params => {
+      if (typeof window === 'undefined') return;
+      window.scrollTo({
+        top: params?.y ?? 0,
+        behavior: params?.animated === false ? 'auto' : 'smooth'
+      });
+    }
+  }), []);
+
+  // Stable per-key ref factory wiring the virtualizer's measurement ref. A fresh
+  // inline arrow each render would make React detach/re-attach (and re-measure)
+  // every row on every render; the cached callback is reused for the same key so
+  // the ref only fires on real mount/unmount.
+  const measureElement = virtualizer.measureElement;
+  const rowRefCallbacks = React.useRef(new Map());
+  const getRowRef = React.useCallback(key => {
+    const cache = rowRefCallbacks.current;
+    const existing = cache.get(key);
+    if (existing) return existing;
+    if (cache.size > ROW_REF_CACHE_CAP) cache.clear();
+    const cb = node => measureElement(node);
+    cache.set(key, cb);
+    return cb;
+  }, [measureElement]);
+  const flatStyle = StyleSheet.flatten(style);
+  const flatContentStyle = StyleSheet.flatten(contentContainerStyle);
+  const header = renderSlot(ListHeaderComponent);
+  const footer = renderSlot(ListFooterComponent);
+  if (count === 0) {
+    return /*#__PURE__*/_jsxs(View, {
+      style: [{
+        minHeight: 0
+      }, flatStyle],
+      testID: testID,
+      children: [header, renderSlot(ListEmptyComponent), footer]
+    });
+  }
+  const virtualItems = virtualizer.getVirtualItems();
+  const totalSize = virtualizer.getTotalSize();
+
+  // The measured spacer MUST contain every absolutely-positioned row; size it to
+  // the MAX of `totalSize` and the rows' real extent so the document always
+  // grows to full content height even when `scrollMargin` is momentarily stale.
+  const lastItem = virtualItems.length > 0 ? virtualItems[virtualItems.length - 1] : undefined;
+  const lastItemEnd = lastItem ? lastItem.start + lastItem.size - virtualizer.options.scrollMargin : 0;
+  const spacerHeight = Math.max(totalSize, lastItemEnd);
+  return /*#__PURE__*/_jsxs(View, {
+    style: [{
+      minHeight: 0
+    }, flatStyle],
+    testID: testID,
+    children: [header, /*#__PURE__*/_jsx("div", {
+      style: flatContentStyle,
+      children: /*#__PURE__*/_jsx("div", {
+        ref: wrapperRef,
+        style: {
+          height: spacerHeight,
+          width: '100%',
+          position: 'relative'
+        },
+        children: virtualItems.map(virtualRow => {
+          const item = items[virtualRow.index];
+          if (item === undefined) return null;
+          return /*#__PURE__*/_jsx("div", {
+            ref: getRowRef(String(virtualRow.key)),
+            "data-index": virtualRow.index,
+            style: {
+              position: 'absolute',
+              top: 0,
+              left: 0,
+              width: '100%',
+              transform: `translateY(${virtualRow.start - virtualizer.options.scrollMargin}px)`
+            },
+            children: renderItem ? renderItem({
+              item,
+              index: virtualRow.index
+            }) : null
+          }, virtualRow.key);
+        })
+      })
+    }), footer]
+  });
+}
+const VirtualList = /*#__PURE__*/React.forwardRef(VirtualListWebInner);
+export { VirtualList };
+export default VirtualList;
+//# sourceMappingURL=index.web.js.map

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/link-preview/LinkPreviewCard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LinkPreviewCard.d.ts","sourceRoot":"","sources":["../../../../src/link-preview/LinkPreviewCard.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAqC,MAAM,OAAO,CAAC;AAY1D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AA0HpD,eAAO,MAAM,eAAe,kDAAiC,CAAC"}
+{"version":3,"file":"LinkPreviewCard.d.ts","sourceRoot":"","sources":["../../../../src/link-preview/LinkPreviewCard.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAqC,MAAM,OAAO,CAAC;AAY1D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AA8HpD,eAAO,MAAM,eAAe,kDAAiC,CAAC"}

package/lib/typescript/commonjs/link-preview/types.d.ts

@@ -22,6 +22,18 @@ export interface LinkPreviewCardProps {
     image?: string;
     /** Site / brand name shown above the title. Falls back to the URL hostname. */
     siteName?: string;
+    /**
+     * Fill-height mode for the cover image. Defaults to `false`.
+     *
+     * - `false` (default): the cover image keeps its fixed intrinsic height —
+     *   correct when the card sizes itself (e.g. a link rendered alone).
+     * - `true`: the cover image flexes (`flex: 1`, no fixed height) to fill
+     *   whatever vertical space the card is given, with the text block as a
+     *   compact intrinsic-height footer below it. The consumer supplies the
+     *   bounding height via `style` (e.g. `style={{ height: 180 }}`) so the card
+     *   fits a fixed-height row alongside other attachments without overflowing.
+     */
+    coverFill?: boolean;
     /** Press handler. When omitted, the card opens `url` via `Linking.openURL`. */
     onPress?: () => void;
     /** Extra NativeWind utilities merged onto the card surface. */

package/lib/typescript/commonjs/link-preview/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/link-preview/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzD;;;;;;;GAOG;AACH,MAAM,WAAW,oBAAoB;IACnC,iFAAiF;IACjF,GAAG,EAAE,MAAM,CAAC;IACZ,0EAA0E;IAC1E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+EAA+E;IAC/E,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;CAC9B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/link-preview/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzD;;;;;;;GAOG;AACH,MAAM,WAAW,oBAAoB;IACnC,iFAAiF;IACjF,GAAG,EAAE,MAAM,CAAC;IACZ,0EAA0E;IAC1E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;;;;;OAUG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,+EAA+E;IAC/E,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;CAC9B"}

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/link-preview/LinkPreviewCard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LinkPreviewCard.d.ts","sourceRoot":"","sources":["../../../../src/link-preview/LinkPreviewCard.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAqC,MAAM,OAAO,CAAC;AAY1D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AA0HpD,eAAO,MAAM,eAAe,kDAAiC,CAAC"}
+{"version":3,"file":"LinkPreviewCard.d.ts","sourceRoot":"","sources":["../../../../src/link-preview/LinkPreviewCard.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAqC,MAAM,OAAO,CAAC;AAY1D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AA8HpD,eAAO,MAAM,eAAe,kDAAiC,CAAC"}

package/lib/typescript/module/link-preview/types.d.ts

@@ -22,6 +22,18 @@ export interface LinkPreviewCardProps {
     image?: string;
     /** Site / brand name shown above the title. Falls back to the URL hostname. */
     siteName?: string;
+    /**
+     * Fill-height mode for the cover image. Defaults to `false`.
+     *
+     * - `false` (default): the cover image keeps its fixed intrinsic height —
+     *   correct when the card sizes itself (e.g. a link rendered alone).
+     * - `true`: the cover image flexes (`flex: 1`, no fixed height) to fill
+     *   whatever vertical space the card is given, with the text block as a
+     *   compact intrinsic-height footer below it. The consumer supplies the
+     *   bounding height via `style` (e.g. `style={{ height: 180 }}`) so the card
+     *   fits a fixed-height row alongside other attachments without overflowing.
+     */
+    coverFill?: boolean;
     /** Press handler. When omitted, the card opens `url` via `Linking.openURL`. */
     onPress?: () => void;
     /** Extra NativeWind utilities merged onto the card surface. */

package/lib/typescript/module/link-preview/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/link-preview/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzD;;;;;;;GAOG;AACH,MAAM,WAAW,oBAAoB;IACnC,iFAAiF;IACjF,GAAG,EAAE,MAAM,CAAC;IACZ,0EAA0E;IAC1E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+EAA+E;IAC/E,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;CAC9B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/link-preview/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzD;;;;;;;GAOG;AACH,MAAM,WAAW,oBAAoB;IACnC,iFAAiF;IACjF,GAAG,EAAE,MAAM,CAAC;IACZ,0EAA0E;IAC1E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;;;;;OAUG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,+EAA+E;IAC/E,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;CAC9B"}

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"}