@juspay/blend-design-system 0.0.19-beta → 0.0.20-beta

package/dist/components/StatCard/types.d.ts

@@ -24,9 +24,11 @@ export type StatCardAxisConfig = {
     type?: AxisType;
     tickFormatter?: (value: string | number) => string;
     dateOnly?: boolean;
-    smart?: boolean;
-    timeZone?: string;
-    hour12?: boolean;
+    useUTC?: boolean;
+    formatString?: string;
+    timeOnly?: boolean;
+    showYear?: boolean;
+    smartDateTimeFormat?: boolean;
 };
 export type StatCardProps = {
     title: string;

package/dist/components/Tooltip/Tooltip.d.ts

@@ -1,3 +1,3 @@
 import { TooltipProps } from './types';
-export declare const Tooltip: ({ children: trigger, content, side, align, showArrow, size, slot, slotDirection, delayDuration, offset, open, }: TooltipProps) => import("react/jsx-runtime").JSX.Element;
+export declare const Tooltip: ({ children: trigger, content, side, align, showArrow, size, slot, slotDirection, delayDuration, offset, open, maxWidth, }: TooltipProps) => import("react/jsx-runtime").JSX.Element;
 export default Tooltip;

package/dist/components/Tooltip/types.d.ts

@@ -30,4 +30,5 @@ export type TooltipProps = {
     slotDirection?: TooltipSlotDirection;
     delayDuration?: number;
     offset?: number;
+    maxWidth?: string;
 };

package/dist/components/VirtualList/VirtualList.d.ts

@@ -0,0 +1,4 @@
+import { default as React } from 'react';
+import { VirtualListProps, VirtualListRef, VirtualListItem } from './types';
+declare const VirtualList: React.ForwardRefExoticComponent<VirtualListProps<VirtualListItem> & React.RefAttributes<VirtualListRef>>;
+export default VirtualList;

package/dist/components/VirtualList/index.d.ts

@@ -0,0 +1,3 @@
+export { default as VirtualList } from './VirtualList';
+export { useVirtualList } from './utils';
+export type { VirtualListItem, VirtualListProps, VirtualListRef, VirtualListRenderParams, UseVirtualListParams, UseVirtualListReturn, } from './types';

package/dist/components/VirtualList/types.d.ts

@@ -0,0 +1,79 @@
+import { default as React } from 'react';
+export type VirtualListItem = {
+    id: string | number;
+    height?: number;
+    data?: Record<string, unknown>;
+};
+export type VirtualListRenderParams<T extends VirtualListItem> = {
+    item: T;
+    index: number;
+    style: React.CSSProperties;
+};
+export type ScrollAlignment = 'start' | 'center' | 'end' | 'auto';
+export type VisibleRange = {
+    startIndex: number;
+    endIndex: number;
+};
+export type VirtualListProps<T extends VirtualListItem> = {
+    items: T[];
+    itemHeight?: number | ((item: T, index: number) => number);
+    containerHeight?: number;
+    overscan?: number;
+    onScroll?: (scrollTop: number) => void;
+    renderItem: (params: VirtualListRenderParams<T>) => React.ReactNode;
+    className?: string;
+    style?: React.CSSProperties;
+    getItemHeight?: (item: T, index: number) => number;
+    dynamicHeight?: boolean;
+    estimatedItemHeight?: number;
+    ssrMode?: boolean;
+    ariaRole?: 'listbox' | 'menu' | 'table' | 'list';
+    onKeyDown?: (event: React.KeyboardEvent) => void;
+    emptyState?: React.ReactNode;
+    throttleScrollMs?: number;
+    onEndReached?: () => void;
+    endReachedThreshold?: number;
+    isLoading?: boolean;
+    loadingComponent?: React.ReactNode;
+    hasMore?: boolean;
+    onRangeChange?: (range: VisibleRange) => void;
+    initialScrollOffset?: number;
+    initialScrollIndex?: number;
+    scrollAlignment?: ScrollAlignment;
+    itemsToRender?: number;
+    minHeight?: number;
+    maxHeight?: number;
+    maintainScrollPosition?: boolean;
+};
+export type VirtualListRef = {
+    scrollTo: (scrollTop: number, smooth?: boolean) => void;
+    scrollToIndex: (index: number, alignment?: ScrollAlignment, smooth?: boolean) => void;
+    getScrollOffset: () => number;
+    recalculateHeights: () => void;
+    getVisibleRange: () => VisibleRange;
+    measureItem: (index: number) => void;
+};
+export type UseVirtualListParams<T extends VirtualListItem> = {
+    items: T[];
+    itemHeight?: number | ((item: T, index: number) => number);
+    containerHeight: number;
+    overscan?: number;
+    getItemHeight?: (item: T, index: number) => number;
+    dynamicHeight?: boolean;
+    ssrMode?: boolean;
+    estimatedItemHeight?: number;
+    itemsToRender?: number;
+    minHeight?: number;
+    maxHeight?: number;
+};
+export type UseVirtualListReturn = {
+    scrollTop: number;
+    setScrollTop: React.Dispatch<React.SetStateAction<number>>;
+    totalHeight: number;
+    itemOffsets: number[];
+    itemHeights: number[];
+    recalculateHeights: () => void;
+    startIndex: number;
+    endIndex: number;
+    measureItem: (index: number, height: number) => void;
+};

package/dist/components/VirtualList/utils.d.ts

@@ -0,0 +1,30 @@
+import { VirtualListItem, UseVirtualListParams, UseVirtualListReturn, ScrollAlignment } from './types';
+export declare function throttle<T extends (...args: unknown[]) => unknown>(func: T, wait: number): (...args: Parameters<T>) => void;
+export declare const isBrowser: boolean;
+export declare const findEndIndexBinarySearch: (startIndex: number, viewportBottom: number, itemOffsets: number[], itemsLength: number, overscan: number) => number;
+export declare const calculateFixedHeightRange: (scrollTop: number, containerHeight: number, itemHeight: number, itemsLength: number, overscan: number, itemsToRender?: number) => {
+    startIndex: number;
+    endIndex: number;
+};
+export declare const calculateDynamicHeightRange: (scrollTop: number, containerHeight: number, itemOffsets: number[], itemsLength: number, overscan: number, itemsToRender?: number) => {
+    startIndex: number;
+    endIndex: number;
+};
+export declare const calculateItemHeights: <T extends VirtualListItem>(items: T[], itemHeight?: number | ((item: T, index: number) => number), getItemHeight?: (item: T, index: number) => number, estimatedItemHeight?: number, minHeight?: number, maxHeight?: number, measuredHeights?: Map<number, number>) => number[];
+export declare const constrainHeight: (height: number, minHeight?: number, maxHeight?: number) => number;
+export declare const calculateItemOffsets: (itemHeights: number[]) => {
+    totalHeight: number;
+    itemOffsets: number[];
+};
+export declare function useVirtualList<T extends VirtualListItem>({ items, itemHeight, containerHeight, overscan, getItemHeight, ssrMode, estimatedItemHeight, itemsToRender, minHeight, maxHeight, }: UseVirtualListParams<T>): UseVirtualListReturn;
+export declare const handleVirtualListKeyDown: (e: React.KeyboardEvent<HTMLDivElement>, ariaRole: string, totalHeight: number, containerRef: React.RefObject<HTMLDivElement | null>, onKeyDown?: (event: React.KeyboardEvent) => void) => void;
+export declare const calculateScrollForAlignment: (index: number, alignment: ScrollAlignment, containerHeight: number, itemOffsets: number[], itemHeights: number[], itemsLength: number) => number;
+export declare const scrollToPosition: (containerRef: React.RefObject<HTMLDivElement | null>, scrollTop: number, smooth?: boolean) => void;
+export declare const scrollToIndex: (containerRef: React.RefObject<HTMLDivElement | null>, index: number, itemOffsets: number[], itemHeights: number[], itemsLength: number, containerHeight: number, alignment?: ScrollAlignment, smooth?: boolean) => void;
+export declare const createVirtualItemStyle: (top: number, height: number, useAbsolute?: boolean) => React.CSSProperties;
+export declare const setupResizeObserver: (dynamicHeight: boolean, isMounted: boolean, containerRef: React.RefObject<HTMLDivElement | null>, measureItem: (index: number, height: number) => void) => (() => void) | undefined;
+export declare const checkEndReached: (scrollTop: number, totalHeight: number, containerHeight: number, threshold: number) => boolean;
+export declare const usePreviousRange: (startIndex: number, endIndex: number, onRangeChange?: (range: {
+    startIndex: number;
+    endIndex: number;
+}) => void) => void;

package/dist/main.d.ts

@@ -31,6 +31,7 @@ export * from './components/ProgressBar';
 export * from './components/Drawer';
 export * from './components/Skeleton';
 export * from './components/KeyValuePair';
+export * from './components/VirtualList';
 export * from './components/ButtonGroup';
 export * from './components/Button';
 export * from './context';