asma-ui-core 3.47.4 → 3.49.0

package/dist/src/components/data-display/virtualized-list/VirtualizedList.d.ts

@@ -0,0 +1,34 @@
+import { ReactNode } from 'react';
+/**
+ * Renders only the rows in view, for lists long enough that mounting all of them is the bottleneck.
+ *
+ * Lives here rather than in each consumer because `@tanstack/react-virtual` is already a dependency
+ * of this package (the table's column virtualizer uses it), and because the mechanism is the part
+ * that gets copied wrong: the spacer must carry the *full* scroll height or the scrollbar lies, rows
+ * must be positioned rather than laid out, and each row needs `measureElement` or variable heights
+ * drift. Encapsulating it keeps the virtualizer an implementation detail of this package instead of a
+ * dependency every app adds for itself.
+ *
+ * **This virtualizes RENDERING, not loading.** Every item must already be in memory — `items` is the
+ * complete list. A consumer that also wants to fetch lazily needs its own windowing on top, and
+ * should think hard about whether partial data still satisfies its own invariants.
+ *
+ * Variable row heights work without configuration: `estimatedItemHeight` only seeds the first paint,
+ * after which real heights are measured.
+ */
+export interface VirtualizedListProps<TItem> {
+    items: readonly TItem[];
+    /** Stable identity per row. Index-based keys would remount rows on reorder and lose focus. */
+    getItemKey: (item: TItem, index: number) => string;
+    renderItem: (item: TItem, index: number) => ReactNode;
+    /** First-paint estimate only; real heights are measured after mount. Defaults to 48. */
+    estimatedItemHeight?: number;
+    /** Rows kept mounted beyond the viewport, so scrolling does not reveal blank space. Defaults to 8. */
+    overscan?: number;
+    /** Applied to the scroll container — give it a bounded height, or nothing can scroll. */
+    className?: string;
+    dataTest?: string;
+    /** Rendered instead of the list when `items` is empty. */
+    emptyState?: ReactNode;
+}
+export declare function VirtualizedList<TItem>({ className, dataTest, emptyState, estimatedItemHeight, getItemKey, items, overscan, renderItem, }: VirtualizedListProps<TItem>): React.ReactElement | null;

package/dist/src/components/data-display/virtualized-list/index.d.ts

@@ -0,0 +1 @@
+export * from './VirtualizedList';

package/dist/src/index.d.ts

@@ -3,6 +3,7 @@ export * from './components/data-display/badge';
 export * from './components/data-display/chip';
 export * from './components/data-display/interactive-chip';
 export * from './components/data-display/tooltip';
+export * from './components/data-display/virtualized-list';
 export * from './components/icons';
 export * from './components/data-display/typography';
 export * from './components/data-display/form-label';

package/package.json

@@ -3,7 +3,7 @@
     "publishConfig": {
         "access": "public"
     },
-    "version": "3.47.4",
+    "version": "3.49.0",
     "type": "module",
     "sideEffects": [
         "**/*.css",