@nar-bus/lena-ui-shared 1.1.4 → 1.2.1

package/dist/index.d.ts

@@ -9,8 +9,10 @@ import { Column } from '@tanstack/react-table';
 import { ColumnDef } from '@tanstack/react-table';
 import { Command as Command_2 } from 'cmdk';
 import { Component } from 'react';
+import { ComponentType } from 'react';
 import * as ContextMenuPrimitive from '@radix-ui/react-context-menu';
 import { Control } from 'react-hook-form';
+import { CSSProperties } from 'react';
 import { DayPicker } from 'react-day-picker';
 import * as DialogPrimitive from '@radix-ui/react-dialog';
 import * as DropdownMenuPrimitive from '@radix-ui/react-dropdown-menu';
@@ -122,7 +124,7 @@ export declare interface ApiResponse<T> {
     meta: MetaInfo;
 }
 
-export declare function AppHeader({ breadcrumbs, theme, onThemeChange, locale, onLocaleChange, user, isAuthenticated, onLogout, onLogin, homeHref, className, }: AppHeaderProps): JSX.Element;
+export declare function AppHeader({ breadcrumbs, theme, onThemeChange, locale, onLocaleChange, user, isAuthenticated, onLogout, onLogin, homeHref, centerSlot, className, }: AppHeaderProps): JSX.Element;
 
 export declare interface AppHeaderProps {
     breadcrumbs: BreadcrumbItem[];
@@ -135,6 +137,7 @@ export declare interface AppHeaderProps {
     onLogout: () => void;
     onLogin?: () => void;
     homeHref?: string;
+    centerSlot?: ReactNode;
     className?: string;
 }
 
@@ -154,6 +157,7 @@ export declare interface AppSidebarProps {
         title: string;
         subtitle?: string;
         letter?: string;
+        imageSrc?: string;
     };
     version?: string;
 }
@@ -202,7 +206,7 @@ export declare function BadgeCell({ value, variant, className, }: BadgeCellProps
 
 declare interface BadgeCellProps {
     value: string | number | null | undefined;
-    variant?: 'default' | 'accent';
+    variant?: 'default' | 'accent' | 'destructive';
     className?: string;
 }
 
@@ -707,7 +711,7 @@ export declare interface CRUDTabContentProps<T extends {
     onExternalCreateSheetOpenChange?: (open: boolean) => void;
 }
 
-export declare function DataRow({ label, value, mono, suffix, className }: DataRowProps): JSX.Element;
+export declare function DataRow({ label, value, mono, suffix, className, size }: DataRowProps): JSX.Element;
 
 export declare interface DataRowProps {
     label: string;
@@ -715,6 +719,7 @@ export declare interface DataRowProps {
     mono?: boolean;
     suffix?: string;
     className?: string;
+    size?: 'sm' | 'md';
 }
 
 export declare function DataTable<TData>({ columns, getRowId, data, isLoading, error, pagination, onPageChange, onPageSizeChange, onPrefetchPage, pageSizeOptions, sortBy, sortDirection, onSortChange, searchValue, onSearchChange, searchPlaceholder, searchDebounceMs, fieldConfig, filters, onFiltersChange, enableRowSelection, rowSelection, onRowSelectionChange, bulkActions, rowActions, toolbarStart, toolbarEnd, className, emptyIcon, emptyTitle, emptyDescription, onRowClick, onRowHover, rowClassName, meta, headerColor, }: DataTableComponentProps<TData>): JSX.Element;
@@ -854,6 +859,16 @@ export declare interface DataTableProps<TData> extends DataTableDataProps<TData>
     columns: ColumnDef<TData, unknown>[];
 }
 
+export declare function DataTableSearch({ value, onChange, placeholder, debounceMs, className, }: DataTableSearchInputProps): JSX.Element;
+
+export declare interface DataTableSearchInputProps {
+    value: string;
+    onChange: (value: string) => void;
+    placeholder?: string;
+    debounceMs?: number;
+    className?: string;
+}
+
 /** Search props */
 export declare interface DataTableSearchProps {
     searchValue: string;
@@ -974,6 +989,18 @@ export declare function dateStringToTimestamp(dateStr: string, endOfDay?: boolea
  */
 export declare const DEFAULT_PAGE_SIZE_OPTIONS: number[];
 
+/**
+ * Default pagination state — use as initial value when API hasn't responded yet
+ */
+export declare const DEFAULT_PAGINATION: {
+    readonly page: 0;
+    readonly size: 20;
+    readonly totalElements: 0;
+    readonly totalPages: 0;
+    readonly hasNext: false;
+    readonly hasPrevious: false;
+};
+
 /**
  * Default values
  */
@@ -1201,6 +1228,44 @@ declare interface FileFieldProps<TFieldValues extends FieldValues> {
     errorHint?: string;
 }
 
+export declare function FilterableListLayout({ fieldConfig, filters, onFiltersChange, filterPanelOpen, onFilterPanelToggle, searchValue, onSearchChange, searchPlaceholder, onRefresh, isRefreshing, activeFilterCount, toolbarStart, addButton, filterLabel, refreshLabel, children, className, }: FilterableListLayoutProps): JSX.Element;
+
+export declare interface FilterableListLayoutProps {
+    /** FieldConfig array for FilterSidePanel + ActiveFiltersBar */
+    fieldConfig: FieldConfig[];
+    /** Current filter state */
+    filters: FilterState[];
+    /** Filter change handler — passed to FilterSidePanel + ActiveFiltersBar */
+    onFiltersChange: (filters: FilterState[]) => void;
+    /** Whether the filter side panel is open */
+    filterPanelOpen: boolean;
+    /** Toggle filter panel */
+    onFilterPanelToggle: () => void;
+    /** Debounced search value */
+    searchValue: string;
+    /** Search change handler */
+    onSearchChange: (value: string) => void;
+    /** Search input placeholder */
+    searchPlaceholder?: string;
+    /** Refresh handler — typically queryClient.invalidateQueries */
+    onRefresh: () => void;
+    /** Shows spinning animation on refresh button */
+    isRefreshing?: boolean;
+    /** Number of active filters — shown as badge on filter button */
+    activeFilterCount?: number;
+    /** Slot: entity label (left side of toolbar) — e.g. ToolbarEntityLabel */
+    toolbarStart?: ReactNode;
+    /** Slot: add/create button (right side of toolbar) */
+    addButton?: ReactNode;
+    /** i18n labels */
+    filterLabel?: string;
+    refreshLabel?: string;
+    /** Main content — typically DataTable */
+    children: ReactNode;
+    /** Additional className for the outer container */
+    className?: string;
+}
+
 export declare function FilterFieldRow({ fieldConfig, filter, onFilterChange }: FilterFieldRowProps): JSX.Element;
 
 export declare interface FilterFieldRowProps {
@@ -1338,9 +1403,11 @@ declare interface FormSectionProps {
     icon?: ReactNode;
 }
 
-export declare function FormSheet({ open, onOpenChange, title, description, children, onSubmit, onCancel, isSubmitting, submitLabel, cancelLabel, side, className, icon, }: FormSheetProps): JSX.Element;
+export declare function FormSheet({ open, onOpenChange, title, description, children, onSubmit, onCancel, isSubmitting, submitLabel, cancelLabel, side, className, icon, variant, headerGradient, headerIcon: HeaderIcon, }: FormSheetProps): JSX.Element;
+
+export declare type FormSheetGradient = 'navy' | 'cherry' | 'emerald' | 'amber';
 
-declare interface FormSheetProps {
+export declare interface FormSheetProps {
     open: boolean;
     onOpenChange: (open: boolean) => void;
     title: string;
@@ -1354,6 +1421,15 @@ declare interface FormSheetProps {
     side?: 'top' | 'bottom' | 'left' | 'right';
     className?: string;
     icon?: ReactNode;
+    /** Use 'gradient' for entity-colored header with gradient background */
+    variant?: 'default' | 'gradient';
+    /** Gradient color for variant="gradient" */
+    headerGradient?: FormSheetGradient;
+    /** Icon component for variant="gradient" header */
+    headerIcon?: ComponentType<{
+        className?: string;
+        style?: CSSProperties;
+    }>;
 }
 
 /**
@@ -1389,6 +1465,21 @@ export declare function getStatusColor<T extends string>(value: T | null | undef
  */
 export declare function getTabDirection(tabIds: string[], fromTab: string | null, toTab: string): -1 | 0 | 1;
 
+export declare function HeaderQuickSearch({ placeholder, value, onValueChange, open, onOpenChange, loading, shortcutKey, shouldFilter, className, children, }: HeaderQuickSearchProps): JSX.Element;
+
+export declare interface HeaderQuickSearchProps {
+    placeholder?: string;
+    value: string;
+    onValueChange: (value: string) => void;
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    loading?: boolean;
+    shortcutKey?: string;
+    shouldFilter?: boolean;
+    className?: string;
+    children?: ReactNode;
+}
+
 export declare function HistoryList({ items, className }: HistoryListProps): JSX.Element;
 
 declare interface HistoryListItem {
@@ -1419,6 +1510,19 @@ declare interface IconTextCellProps {
     className?: string;
 }
 
+export declare function IconTooltipButton({ icon: Icon, tooltip, onClick, disabled, variant, size, className, spinning, }: IconTooltipButtonProps): JSX.Element;
+
+export declare interface IconTooltipButtonProps {
+    icon: LucideIcon;
+    tooltip: string;
+    onClick: () => void;
+    disabled?: boolean;
+    variant?: 'ghost' | 'outline';
+    size?: 'sm' | 'icon';
+    className?: string;
+    spinning?: boolean;
+}
+
 export declare function InfoCard({ icon, label, value, variant, iconColor, className, }: InfoCardProps): JSX.Element;
 
 export declare function InfoCardGrid({ children, columns, className, }: InfoCardGridProps): JSX.Element;
@@ -1724,13 +1828,14 @@ export declare interface OverviewPanelProps {
     className?: string;
 }
 
-export declare function OverviewPanelTopBar({ icon: Icon, segments, actions, className }: OverviewPanelTopBarProps): JSX.Element;
+export declare function OverviewPanelTopBar({ icon: Icon, segments, actions, className, variant }: OverviewPanelTopBarProps): JSX.Element;
 
 export declare interface OverviewPanelTopBarProps {
     icon: LucideIcon;
     segments: string[];
     actions?: ReactNode;
     className?: string;
+    variant?: 'default' | 'navy' | 'cherry' | 'emerald' | 'amber';
 }
 
 export declare interface PagedResponse<T> {
@@ -2154,9 +2259,10 @@ export declare function Sheet({ ...props }: React_2.ComponentProps<typeof Dialog
 
 export declare function SheetClose({ ...props }: React_2.ComponentProps<typeof DialogPrimitive.Close>): JSX.Element;
 
-export declare function SheetContent({ className, children, side, showCloseButton, ...props }: React_2.ComponentProps<typeof DialogPrimitive.Content> & {
+export declare function SheetContent({ className, children, side, showCloseButton, showOverlay, ...props }: React_2.ComponentProps<typeof DialogPrimitive.Content> & {
     side?: "top" | "right" | "bottom" | "left";
     showCloseButton?: boolean;
+    showOverlay?: boolean;
 }): JSX.Element;
 
 export declare function SheetDescription({ className, ...props }: React_2.ComponentProps<typeof DialogPrimitive.Description>): JSX.Element;
@@ -2592,6 +2698,16 @@ export declare const toggleVariants: (props?: ({
     size?: "default" | "sm" | "lg" | null | undefined;
 } & ClassProp) | undefined) => string;
 
+export declare function ToolbarEntityLabel({ icon: Icon, entityName, totalElements, countLabel, className, }: ToolbarEntityLabelProps): JSX.Element;
+
+export declare interface ToolbarEntityLabelProps {
+    icon: LucideIcon;
+    entityName: string;
+    totalElements: number;
+    countLabel?: string;
+    className?: string;
+}
+
 export declare function Tooltip({ ...props }: React_2.ComponentProps<typeof TooltipPrimitive.Root>): JSX.Element;
 
 export declare function TooltipContent({ className, sideOffset, children, ...props }: React_2.ComponentProps<typeof TooltipPrimitive.Content>): JSX.Element;
@@ -2625,6 +2741,17 @@ declare interface TreeNodeOperation {
 
 export declare const trLabels: LenaUILabels;
 
+export declare function UnderConstructionPage({ title, description, goBackLabel, homeLabel, onGoBack, onGoHome, }: UnderConstructionPageProps): JSX.Element;
+
+export declare interface UnderConstructionPageProps {
+    title?: string;
+    description?: string;
+    goBackLabel?: string;
+    homeLabel?: string;
+    onGoBack?: () => void;
+    onGoHome?: () => void;
+}
+
 /**
  * UnifiedTabs - Single tab component for both list and detail pages
  */
@@ -2691,7 +2818,7 @@ declare interface UseDataTableOptions<TData> extends CreateDataTableStoreOptions
     data?: TData[];
 }
 
-declare interface UseDataTableReturn<TData> {
+export declare interface UseDataTableReturn<TData> {
     /** Search request ready for API call (100% backend compatible) */
     searchRequest: SearchRequest;
     /** Pagination props to spread to DataTable */
@@ -2742,6 +2869,21 @@ declare interface UseDataTableUrlOptions {
     debounceMs?: number;
 }
 
+/**
+ * Debounces a value by the specified delay.
+ * Returns the debounced value that only updates after `delay` ms of inactivity.
+ */
+export declare function useDebounce<T>(value: T, delay?: number): T;
+
+export declare function useDoubleClickHandler<T>({ getRowId, onSingleClick, onDoubleClick, delay, }: UseDoubleClickHandlerOptions<T>): (row: T) => void;
+
+export declare interface UseDoubleClickHandlerOptions<T> {
+    getRowId: (row: T) => string | number;
+    onSingleClick: (row: T) => void;
+    onDoubleClick: (row: T) => void;
+    delay?: number;
+}
+
 export declare function useJsonTree({ value, onChange }: UseJsonTreeOptions): UseJsonTreeReturn;
 
 declare interface UseJsonTreeOptions {