@true-tech-team/react-components 0.0.5 → 0.0.7

package/lib/components/display/List/List.d.ts

@@ -0,0 +1,6 @@
+import { default as React } from 'react';
+import { ListProps } from './types';
+export declare const List: <T extends Record<string, unknown> = Record<string, unknown>>(props: ListProps<T> & {
+    ref?: React.ForwardedRef<HTMLDivElement>;
+}) => React.ReactElement;
+export default List;

package/lib/components/display/List/ListContext.d.ts

@@ -0,0 +1,15 @@
+import { ListContextValue } from './types';
+/**
+ * Context for sharing List state with child components
+ */
+export declare const ListContext: import('react').Context<ListContextValue<Record<string, unknown>> | null>;
+/**
+ * Hook to access List context (optional access)
+ * Returns null if used outside of List component
+ */
+export declare function useListContext<T = Record<string, unknown>>(): ListContextValue<T> | null;
+/**
+ * Hook to access List context (strict access)
+ * Throws error if used outside of List component
+ */
+export declare function useListContextStrict<T = Record<string, unknown>>(): ListContextValue<T>;

package/lib/components/display/List/ListEmpty.d.ts

@@ -0,0 +1,25 @@
+import { ReactNode } from 'react';
+export interface ListEmptyProps {
+    /**
+     * Content to display when list is empty
+     * @default 'No items to display'
+     */
+    content?: ReactNode;
+    /**
+     * Custom render function for empty state
+     */
+    renderEmpty?: () => ReactNode;
+    /**
+     * Whether this is a "no results" state (from filtering)
+     */
+    isNoResults?: boolean;
+    /**
+     * Search query (shown when isNoResults is true)
+     */
+    searchQuery?: string;
+}
+export declare function ListEmpty({ content, renderEmpty, isNoResults, searchQuery, }: ListEmptyProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace ListEmpty {
+    var displayName: string;
+}
+export default ListEmpty;

package/lib/components/display/List/ListGroup.d.ts

@@ -0,0 +1,36 @@
+import { ReactNode } from 'react';
+export interface ListGroupProps {
+    /**
+     * Group key (used for collapse state tracking)
+     */
+    groupKey: string;
+    /**
+     * Number of items in the group
+     */
+    itemCount: number;
+    /**
+     * Whether the group is collapsible
+     */
+    collapsible: boolean;
+    /**
+     * Whether the group is collapsed
+     */
+    isCollapsed: boolean;
+    /**
+     * Callback to toggle collapse state
+     */
+    onToggle: () => void;
+    /**
+     * Custom render function for the group header
+     */
+    renderHeader?: (groupKey: string, itemCount: number, isCollapsed: boolean) => ReactNode;
+    /**
+     * Children (the group items)
+     */
+    children: ReactNode;
+}
+export declare function ListGroup({ groupKey, itemCount, collapsible, isCollapsed, onToggle, renderHeader, children, }: ListGroupProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace ListGroup {
+    var displayName: string;
+}
+export default ListGroup;

package/lib/components/display/List/ListHeader.d.ts

@@ -0,0 +1,62 @@
+import { ReactNode } from 'react';
+import { BulkAction, SelectionMode } from './types';
+import { ComponentSize } from '../../../types';
+export interface ListHeaderProps<T extends Record<string, unknown> = Record<string, unknown>> {
+    /**
+     * Selection mode
+     */
+    selectionMode: SelectionMode;
+    /**
+     * Whether all items are selected
+     */
+    isAllSelected: boolean;
+    /**
+     * Whether selection is indeterminate
+     */
+    isIndeterminate: boolean;
+    /**
+     * Callback to select/deselect all
+     */
+    onSelectAll: (selected: boolean) => void;
+    /**
+     * Number of selected items
+     */
+    selectedCount: number;
+    /**
+     * Total number of items
+     */
+    totalCount: number;
+    /**
+     * Selected items data
+     */
+    selectedItems: T[];
+    /**
+     * Selected item keys
+     */
+    selectedKeys: string[];
+    /**
+     * Bulk actions configuration
+     */
+    bulkActions?: Array<BulkAction<T>>;
+    /**
+     * Custom render for bulk actions
+     */
+    renderBulkActions?: (selectedItems: T[], selectedKeys: string[], actions: Array<BulkAction<T>>) => ReactNode;
+    /**
+     * Position of header (for sticky behavior)
+     */
+    position: 'top' | 'bottom' | 'sticky-top' | 'sticky-bottom';
+    /**
+     * Size variant
+     */
+    size: ComponentSize;
+    /**
+     * Search component to render
+     */
+    searchComponent?: ReactNode;
+}
+export declare function ListHeader<T extends Record<string, unknown>>({ selectionMode, isAllSelected, isIndeterminate, onSelectAll, selectedCount, totalCount, selectedItems, selectedKeys, bulkActions, renderBulkActions, position, size, searchComponent, }: ListHeaderProps<T>): import("react/jsx-runtime").JSX.Element | null;
+export declare namespace ListHeader {
+    var displayName: string;
+}
+export default ListHeader;

package/lib/components/display/List/ListItem.d.ts

@@ -0,0 +1,19 @@
+import { default as React } from 'react';
+export interface ListItemProps<T extends Record<string, unknown> = Record<string, unknown>> {
+    /**
+     * The item data
+     */
+    item: T;
+    /**
+     * Index of the item in the list
+     */
+    index: number;
+    /**
+     * Actual index in filtered data (may differ due to grouping)
+     */
+    filteredIndex: number;
+}
+export declare const ListItem: <T extends Record<string, unknown> = Record<string, unknown>>(props: ListItemProps<T> & {
+    ref?: React.ForwardedRef<HTMLDivElement>;
+}) => React.ReactElement;
+export default ListItem;

package/lib/components/display/List/ListSearch.d.ts

@@ -0,0 +1,32 @@
+export interface ListSearchProps {
+    /**
+     * Current search query
+     */
+    value: string;
+    /**
+     * Callback when search query changes
+     */
+    onChange: (value: string) => void;
+    /**
+     * Placeholder text
+     * @default 'Search...'
+     */
+    placeholder?: string;
+    /**
+     * Whether the search is currently filtering (debounce active)
+     */
+    isFiltering?: boolean;
+    /**
+     * Auto focus the input on mount
+     */
+    autoFocus?: boolean;
+    /**
+     * Callback when input is cleared
+     */
+    onClear?: () => void;
+}
+export declare function ListSearch({ value, onChange, placeholder, isFiltering: _isFiltering, autoFocus, onClear, }: ListSearchProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace ListSearch {
+    var displayName: string;
+}
+export default ListSearch;

package/lib/components/display/List/ListSkeleton.d.ts

@@ -0,0 +1,27 @@
+import { ComponentSize } from '../../../types';
+export interface ListSkeletonProps {
+    /**
+     * Number of skeleton rows to display
+     * @default 5
+     */
+    rows?: number;
+    /**
+     * Whether to show avatar placeholder
+     * @default true
+     */
+    showAvatar?: boolean;
+    /**
+     * Whether to show secondary text placeholder
+     * @default true
+     */
+    showSecondaryText?: boolean;
+    /**
+     * Size variant (affects dimensions)
+     */
+    size?: ComponentSize;
+}
+export declare function ListSkeleton({ rows, showAvatar, showSecondaryText, size, }: ListSkeletonProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace ListSkeleton {
+    var displayName: string;
+}
+export default ListSkeleton;

package/lib/components/display/List/hooks/index.d.ts

@@ -0,0 +1,5 @@
+export { useListSelection } from './useListSelection';
+export { useListExpand } from './useListExpand';
+export { useListFilter } from './useListFilter';
+export { useListKeyboardNav } from './useListKeyboardNav';
+export { useListGroups } from './useListGroups';

package/lib/components/display/List/hooks/useListExpand.d.ts

@@ -0,0 +1,6 @@
+import { UseListExpandOptions, UseListExpandReturn } from '../types';
+/**
+ * Hook for managing expandable list items
+ * Supports controlled/uncontrolled patterns
+ */
+export declare function useListExpand({ expandedKeys: controlledKeys, defaultExpandedKeys, onExpandChange, }: UseListExpandOptions): UseListExpandReturn;

package/lib/components/display/List/hooks/useListFilter.d.ts

@@ -0,0 +1,6 @@
+import { UseListFilterOptions, UseListFilterReturn } from '../types';
+/**
+ * Hook for filtering list items with optional debounce
+ * Supports controlled/uncontrolled patterns and custom filter functions
+ */
+export declare function useListFilter<T extends Record<string, unknown>>({ data, searchQuery: controlledQuery, defaultSearchQuery, onSearchChange, searchFields, searchFn, debounceMs, }: UseListFilterOptions<T>): UseListFilterReturn<T>;

package/lib/components/display/List/hooks/useListGroups.d.ts

@@ -0,0 +1,6 @@
+import { UseListGroupsOptions, UseListGroupsReturn } from '../types';
+/**
+ * Hook for grouping list items with collapsible support
+ * Supports controlled/uncontrolled patterns for collapsed state
+ */
+export declare function useListGroups<T extends Record<string, unknown>>({ data, groupBy, collapsedGroups: controlledCollapsed, defaultCollapsedGroups, onCollapsedGroupsChange, }: UseListGroupsOptions<T>): UseListGroupsReturn<T>;

package/lib/components/display/List/hooks/useListKeyboardNav.d.ts

@@ -0,0 +1,6 @@
+import { UseListKeyboardNavOptions, UseListKeyboardNavReturn } from '../types';
+/**
+ * Hook for keyboard navigation in lists
+ * Supports vertical, horizontal, and grid navigation patterns
+ */
+export declare function useListKeyboardNav({ itemCount, onItemAction, onEscape, loop, orientation, columns, disabled, }: UseListKeyboardNavOptions): UseListKeyboardNavReturn;

package/lib/components/display/List/hooks/useListSelection.d.ts

@@ -0,0 +1,6 @@
+import { UseListSelectionOptions, UseListSelectionReturn } from '../types';
+/**
+ * Hook for managing list item selection
+ * Supports single and multiple selection modes with controlled/uncontrolled patterns
+ */
+export declare function useListSelection({ selectionMode, selectedKeys: controlledKeys, defaultSelectedKeys, onSelectionChange, allItemKeys, }: UseListSelectionOptions): UseListSelectionReturn;

package/lib/components/display/List/index.d.ts

@@ -0,0 +1,11 @@
+export { List, default } from './List';
+export { ListItem } from './ListItem';
+export { ListHeader } from './ListHeader';
+export { ListGroup } from './ListGroup';
+export { ListSearch } from './ListSearch';
+export { ListSkeleton } from './ListSkeleton';
+export { ListEmpty } from './ListEmpty';
+export { ListContext, useListContext, useListContextStrict } from './ListContext';
+export { useListSelection, useListExpand, useListFilter, useListKeyboardNav, useListGroups, } from './hooks';
+export type { ListProps, ListItemRenderContext, ListContextValue, SelectionMode, SelectionState, BulkAction, ItemAction, ListInfiniteScrollConfig, ListSkeletonConfig, ResponsiveColumns, UseListSelectionOptions, UseListSelectionReturn, UseListExpandOptions, UseListExpandReturn, UseListFilterOptions, UseListFilterReturn, UseListKeyboardNavOptions, UseListKeyboardNavReturn, UseListGroupsOptions, UseListGroupsReturn, ListGroup as ListGroupType, } from './types';
+export { getNestedValue, formatValue, generateItemKey, searchItems, groupItems, sortItems, } from './utils';