@nar-bus/lena-ui-shared 1.3.4 → 1.3.5

package/dist/index.d.ts

@@ -16,17 +16,23 @@ 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';
+import { Feature } from 'geojson';
+import { FeatureCollection } from 'geojson';
 import { FieldPath } from 'react-hook-form';
 import { FieldValues } from 'react-hook-form';
 import { Group } from 'react-resizable-panels';
 import { JSX } from 'react/jsx-runtime';
+import { default as L_2 } from 'leaflet';
 import * as LabelPrimitive from '@radix-ui/react-label';
+import { Layer } from 'leaflet';
+import { LeafletMouseEvent } from 'leaflet';
 import { LucideIcon } from 'lucide-react';
+import { MultiPolygon } from 'geojson';
 import { NamedExoticComponent } from 'react';
 import { Panel } from 'react-resizable-panels';
+import { Polygon } from 'geojson';
 import * as PopoverPrimitive from '@radix-ui/react-popover';
 import * as ProgressPrimitive from '@radix-ui/react-progress';
-import { QueryKey } from '@tanstack/react-query';
 import * as RadioGroupPrimitive from '@radix-ui/react-radio-group';
 import * as React_2 from 'react';
 import { ReactNode } from 'react';
@@ -41,11 +47,15 @@ import * as TabsPrimitive from '@radix-ui/react-tabs';
 import { ToasterProps } from 'sonner';
 import * as ToggleGroupPrimitive from '@radix-ui/react-toggle-group';
 import * as TogglePrimitive from '@radix-ui/react-toggle';
+import { TooltipOptions } from 'leaflet';
 import * as TooltipPrimitive from '@radix-ui/react-tooltip';
 import { UseBoundStore } from 'zustand';
+import { useMap } from 'react-leaflet';
 import { VariantProps } from 'class-variance-authority';
 import { z } from 'zod';
 
+declare type AccentPosition = 'left' | 'top';
+
 export declare function Accordion({ ...props }: React_2.ComponentProps<typeof AccordionPrimitive.Root>): JSX.Element;
 
 export declare function AccordionContent({ className, children, ...props }: React_2.ComponentProps<typeof AccordionPrimitive.Content>): JSX.Element;
@@ -178,6 +188,28 @@ export declare interface AppSidebarProps {
     groups?: SidebarNavGroup[];
 }
 
+/** Configuration for a single area series */
+export declare interface AreaSeriesConfig {
+    /** Data key matching a field in the data array */
+    dataKey: string;
+    /** Display name (shown in tooltip/legend) */
+    name: string;
+    /** Stroke color */
+    color: string;
+    /** Fill gradient colors: [topColor, bottomColor] */
+    gradient: GradientPair;
+    /** Top gradient stop opacity (default: 0.3) */
+    topOpacity?: number;
+    /** Bottom gradient stop opacity (default: 0) */
+    bottomOpacity?: number;
+    /** Stroke width (default: 2) */
+    strokeWidth?: number;
+    /** Stroke dash pattern (e.g. "6 3") */
+    strokeDasharray?: string;
+    /** Curve interpolation type (default: "monotone") */
+    type?: 'monotone' | 'linear' | 'basis' | 'natural' | 'step';
+}
+
 /**
  * Operators that use the `values` array instead of single `value`
  */
@@ -230,6 +262,26 @@ export declare const badgeVariants: (props?: ({
     variant?: "link" | "default" | "destructive" | "outline" | "secondary" | "ghost" | null | undefined;
 } & ClassProp) | undefined) => string;
 
+/** Configuration for a single bar series */
+export declare interface BarSeriesConfig {
+    /** Data key matching a field in the data array */
+    dataKey: string;
+    /** Display name (shown in tooltip/legend) */
+    name: string;
+    /** Gradient colors: [topColor, bottomColor] */
+    gradient: GradientPair;
+    /** Top gradient stop opacity (default: 0.95) */
+    topOpacity?: number;
+    /** Bottom gradient stop opacity (default: 0.8) */
+    bottomOpacity?: number;
+    /** Stack ID for stacked bars */
+    stackId?: string;
+    /** Border radius [topLeft, topRight, bottomLeft, bottomRight] */
+    radius?: [number, number, number, number];
+    /** Maximum bar width in px (default: 28) */
+    maxBarSize?: number;
+}
+
 /**
  * Boolean cell for displaying true/false values.
  * Shows check/X icons with consistent styling.
@@ -347,6 +399,29 @@ export declare function CardTitle({ className, ...props }: React_2.ComponentProp
  */
 export declare function CellNullState(): JSX.Element;
 
+/** Configuration for a single centroid label on the map */
+export declare interface CentroidLabelConfig {
+    /** Label position [lat, lng] */
+    position: [number, number];
+    /**
+     * HTML content for the label.
+     * @security Bu değer doğrudan innerHTML olarak render edilir.
+     * Kullanıcı girdisi ASLA doğrudan geçilmemeli — sanitize edin.
+     */
+    html: string;
+    /** Icon size [width, height] (default: [50, 18]) */
+    iconSize?: [number, number];
+}
+
+/** Renders HTML labels at specified positions using Leaflet divIcon markers */
+export declare function CentroidLabels({ labels }: CentroidLabelsProps): null;
+
+/** Props for CentroidLabels component */
+export declare interface CentroidLabelsProps {
+    /** Array of label configurations */
+    labels: CentroidLabelConfig[];
+}
+
 export declare function Checkbox({ className, ...props }: React_2.ComponentProps<typeof CheckboxPrimitive.Root>): JSX.Element;
 
 export declare function CheckboxField<TFieldValues extends FieldValues>({ name, control, label, description, disabled, className, cols, }: CheckboxFieldProps<TFieldValues>): JSX.Element;
@@ -472,6 +547,13 @@ export declare interface CommonLabels {
     addNew: string;
 }
 
+/** Compact number formatter for chart Y-axis (1500→"1,5B" TR / "1.5K" EN) */
+export declare function compactNumber(v: number, locale?: 'tr' | 'en'): string;
+
+declare function Content({ children, padding, className }: LenaPanelContentProps): JSX.Element;
+
+declare type ContentPadding = 'none' | 'compact' | 'sm' | 'md' | 'lg';
+
 export declare function ContextMenu({ ...props }: React_2.ComponentProps<typeof ContextMenuPrimitive.Root>): JSX.Element;
 
 export declare function ContextMenuCheckboxItem({ className, children, checked, ...props }: React_2.ComponentProps<typeof ContextMenuPrimitive.CheckboxItem>): JSX.Element;
@@ -668,7 +750,7 @@ export declare function createEmptyFilter(field: string, operator?: FilterState[
 
 export declare function CRUDTabContent<T extends {
     id: number;
-}>({ isActive, columns, fieldConfig, defaultSortBy, getRowId, allQueryKey, detailKey, listKey, fetchDetail, fetchList, useSearchHook, deleteItem, isDeleting, detailPath, searchPlaceholder, emptyTitle, emptyDescription, entityType, getEntityName, viewLabel: viewLabelProp, deleteLabel: deleteLabelProp, refreshLabel: refreshLabelProp, createLabel: createLabelProp, CreateSheetComponent, hideToolbar, externalCreateSheetOpen, onExternalCreateSheetOpenChange, }: CRUDTabContentProps<T>): JSX.Element;
+}>({ isActive, columns, fieldConfig, defaultSortBy, getRowId, allQueryKey, useSearchHook, deleteItem, isDeleting, detailPath, searchPlaceholder, emptyTitle, emptyDescription, entityType, getEntityName, viewLabel: viewLabelProp, deleteLabel: deleteLabelProp, refreshLabel: refreshLabelProp, createLabel: createLabelProp, CreateSheetComponent, hideToolbar, externalCreateSheetOpen, onExternalCreateSheetOpenChange, }: CRUDTabContentProps<T>): JSX.Element;
 
 export declare interface CRUDTabContentProps<T extends {
     id: number;
@@ -685,14 +767,6 @@ export declare interface CRUDTabContentProps<T extends {
     getRowId?: (row: T) => string;
     /** Query key for invalidation */
     allQueryKey: readonly string[];
-    /** Detail query key factory */
-    detailKey: (id: number) => readonly unknown[];
-    /** List query key factory */
-    listKey: (params: SearchRequest) => readonly unknown[];
-    /** Fetch detail function for prefetch */
-    fetchDetail: (id: number) => Promise<T>;
-    /** Fetch list function for prefetch */
-    fetchList: (params: SearchRequest) => Promise<PagedResponse<T>>;
     /** Search hook factory */
     useSearchHook: (params: SearchRequest, enabled: boolean) => {
         data: PagedResponse<T> | undefined;
@@ -750,7 +824,7 @@ export declare interface DataRowProps {
     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, toolbarVariant, emptyIcon, emptyTitle, emptyDescription, onRowClick, onRowHover, rowClassName, meta, headerColor, }: DataTableComponentProps<TData>): JSX.Element;
+export declare function DataTable<TData>({ columns, getRowId, data, isLoading, error, pagination, onPageChange, onPageSizeChange, pageSizeOptions, sortBy, sortDirection, onSortChange, searchValue, onSearchChange, searchPlaceholder, searchDebounceMs, fieldConfig, filters, onFiltersChange, enableRowSelection, rowSelection, onRowSelectionChange, bulkActions, rowActions, toolbarStart, toolbarEnd, className, toolbarVariant, emptyIcon, emptyTitle, emptyDescription, onRowClick, rowClassName, meta, headerColor, }: DataTableComponentProps<TData>): JSX.Element;
 
 declare interface DataTableActions {
     setGeneralSearch: (value: string) => void;
@@ -799,7 +873,6 @@ declare interface DataTableComponentProps<TData> {
     pagination: PaginationInfo;
     onPageChange: (page: number) => void;
     onPageSizeChange: (size: number) => void;
-    onPrefetchPage?: (page: number) => void;
     pageSizeOptions?: number[];
     sortBy: string;
     sortDirection: 'ASC' | 'DESC';
@@ -825,7 +898,6 @@ declare interface DataTableComponentProps<TData> {
     emptyTitle?: string;
     emptyDescription?: string;
     onRowClick?: (row: TData) => void;
-    onRowHover?: (row: TData) => void;
     rowClassName?: (row: TData) => string;
     meta?: Record<string, unknown>;
     /** Custom header color (CSS color value). Overrides --table-header variable */
@@ -1038,6 +1110,14 @@ declare interface DateRangeFieldProps<TFieldValues extends FieldValues> {
  */
 export declare function dateStringToTimestamp(dateStr: string, endOfDay?: boolean): number;
 
+export declare const DEFAULT_HOVER_STYLE: {
+    readonly weight: 2.5;
+    readonly color: "var(--map-hover-color)";
+    readonly fillOpacity: 0.9;
+};
+
+export declare const DEFAULT_MAP_BG = "var(--map-bg)";
+
 /**
  * Default pagination options
  */
@@ -1055,6 +1135,8 @@ export declare const DEFAULT_PAGINATION: {
     readonly hasPrevious: false;
 };
 
+export declare const DEFAULT_TILE_URL = "https://{s}.basemaps.cartocdn.com/light_all/{z}/{x}/{y}{r}.png";
+
 /**
  * Default values
  */
@@ -1245,6 +1327,19 @@ declare interface ErrorBoundaryState {
     errorInfo: React.ErrorInfo | null;
 }
 
+export { Feature }
+
+export { FeatureCollection }
+
+/** Style object returned by the feature style function */
+export declare interface FeatureStyleResult {
+    fillColor: string;
+    weight: number;
+    opacity: number;
+    color: string;
+    fillOpacity: number;
+}
+
 export declare interface FieldConfig {
     /** API field path - supports dot notation (e.g., 'gatewayModel.id') */
     field: string;
@@ -1372,6 +1467,8 @@ export declare interface FilterState {
     enabled: boolean;
 }
 
+declare function Footer({ children, className }: LenaPanelFooterProps): JSX.Element;
+
 /**
  * Format backend timestamp to short datetime (e.g., "27 Oca 00:44")
  */
@@ -1532,6 +1629,13 @@ 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;
 
+/** Gradient stop pair: [topColor, bottomColor] */
+export declare type GradientPair = [topColor: string, bottomColor: string];
+
+declare function Header({ children, icon: Icon, iconClassName, subtitle, actions, gradient, className, }: LenaPanelHeaderProps): JSX.Element;
+
+export declare type HeaderGradient = 'teal' | 'navy' | 'cherry' | 'emerald' | 'amber' | 'violet';
+
 export declare function HeaderQuickSearch({ placeholder, value, onValueChange, open, onOpenChange, loading, shortcutKey, shouldFilter, className, children, }: HeaderQuickSearchProps): JSX.Element;
 
 export declare interface HeaderQuickSearchProps {
@@ -1743,8 +1847,134 @@ declare interface JsonViewerProps {
     className?: string;
 }
 
+export { L_2 as L }
+
 export declare function Label({ className, ...props }: React_2.ComponentProps<typeof LabelPrimitive.Root>): JSX.Element;
 
+export { Layer }
+
+export { LeafletMouseEvent }
+
+export declare function LenaAreaChart<T extends object>({ data, series, xAxisDataKey, height, showLegend, yAxisWidth, yAxisTickFormatter, tooltipItemColor, margin, className, }: LenaAreaChartProps<T>): JSX.Element;
+
+/** Props for LenaAreaChart */
+export declare interface LenaAreaChartProps<T extends object> extends LenaChartBaseProps<T> {
+    /** Area series configurations */
+    series: AreaSeriesConfig[];
+}
+
+export declare function LenaBarChart<T extends object>({ data, series, xAxisDataKey, height, showLegend, yAxisWidth, yAxisTickFormatter, tooltipItemColor, margin, barCategoryGap, barGap, className, }: LenaBarChartProps<T>): JSX.Element;
+
+/** Props for LenaBarChart */
+export declare interface LenaBarChartProps<T extends object> extends LenaChartBaseProps<T> {
+    /** Bar series configurations */
+    series: BarSeriesConfig[];
+    /** Gap between bar categories (default: "20%") */
+    barCategoryGap?: string;
+    /** Gap between bars in same category */
+    barGap?: number;
+}
+
+/** Common props shared by all Lena chart components */
+export declare interface LenaChartBaseProps<T extends object> {
+    /** Chart data array */
+    data: T[];
+    /** Key in data used for the X axis (category axis) */
+    xAxisDataKey: string;
+    /** Chart height in px (default: 180) */
+    height?: number;
+    /** Show legend below the chart */
+    showLegend?: boolean;
+    /** Y-axis width in px (default: 40) */
+    yAxisWidth?: number;
+    /** Custom tooltip item style color override */
+    tooltipItemColor?: string;
+    /** Chart margin override */
+    margin?: {
+        top?: number;
+        right?: number;
+        left?: number;
+        bottom?: number;
+    };
+    /** Custom Y-axis tick formatter (e.g. 420000 → "420K") */
+    yAxisTickFormatter?: (value: number) => string;
+    /** Additional CSS class on the outer container */
+    className?: string;
+}
+
+export declare function LenaChoroplethMap({ geojsonData, getFeatureStyle, onEachFeature, center, zoom, minZoom, maxZoom, tileUrl, height, interactive, background, geojsonKey, children, className, }: LenaChoroplethMapProps): JSX.Element;
+
+/** Props for LenaChoroplethMap */
+export declare interface LenaChoroplethMapProps {
+    /** GeoJSON FeatureCollection data */
+    geojsonData: FeatureCollection;
+    /** Style function called for each GeoJSON feature */
+    getFeatureStyle: (feature?: Feature) => FeatureStyleResult;
+    /** Event handler for each feature (tooltip binding, click etc.) */
+    onEachFeature?: (feature: Feature, layer: Layer) => void;
+    /** Map center [lat, lng] (default: Turkey center) */
+    center?: [number, number];
+    /** Initial zoom level (default: 6) */
+    zoom?: number;
+    /** Min zoom level */
+    minZoom?: number;
+    /** Max zoom level */
+    maxZoom?: number;
+    /** Tile layer URL template */
+    tileUrl?: string;
+    /** Map container height (default: '100%') */
+    height?: number | string;
+    /** Enable zoom/drag/scroll controls (default: false) */
+    interactive?: boolean;
+    /** Map background color (default: '#f8fafc') */
+    background?: string;
+    /** GeoJSON key for re-rendering when data/filter changes */
+    geojsonKey?: string | number;
+    /** Additional children rendered inside MapContainer (markers, labels etc.) */
+    children?: ReactNode;
+    /** CSS class for outer container */
+    className?: string;
+}
+
+export declare const LenaPanel: typeof _LenaPanel & {
+    Header: typeof Header;
+    Content: typeof Content;
+    Footer: typeof Footer;
+};
+
+declare function _LenaPanel({ variant, animation, animationDelay, accentBorder, accentColor, className, children, }: LenaPanelProps): JSX.Element;
+
+export declare interface LenaPanelContentProps {
+    children: ReactNode;
+    padding?: ContentPadding;
+    className?: string;
+}
+
+export declare interface LenaPanelFooterProps {
+    children: ReactNode;
+    className?: string;
+}
+
+export declare interface LenaPanelHeaderProps {
+    children: ReactNode;
+    icon?: LucideIcon;
+    iconClassName?: string;
+    subtitle?: string;
+    actions?: ReactNode;
+    gradient?: HeaderGradient;
+    className?: string;
+}
+
+export declare interface LenaPanelProps {
+    variant?: PanelVariant;
+    animation?: PanelAnimation;
+    animationDelay?: number;
+    accentBorder?: AccentPosition;
+    accentColor?: string;
+    className?: string;
+    children: ReactNode;
+}
+
 export declare interface LenaUILabels {
     dataTable: DataTableLabels;
     form: FormLabels;
@@ -1818,14 +2048,41 @@ export declare interface LocationMapProps {
     className?: string;
 }
 
+export declare const MAP_TOOLTIP_OPTIONS: Partial<TooltipOptions>;
+
+/** Fixes Leaflet map sizing when rendered inside hidden tabs or collapsible panels */
+export declare function MapSizeInvalidator(): null;
+
 export declare interface MetaInfo {
     timestamp: string;
     version: string;
     requestId: string;
 }
 
+export declare function MetricCard({ title, value, unit, trend, status, icon, sparklineData, className, animationDelay, isLoading, }: MetricCardProps): JSX.Element;
+
+export declare interface MetricCardProps {
+    title: string;
+    value: string | number;
+    unit?: string;
+    trend?: {
+        value: number;
+        direction: 'up' | 'down' | 'neutral';
+    };
+    status?: MetricStatus;
+    icon?: ReactNode;
+    sparklineData?: number[];
+    className?: string;
+    animationDelay?: number;
+    isLoading?: boolean;
+}
+
+export declare type MetricStatus = 'online' | 'warning' | 'error' | 'neutral';
+
 export declare type MountStrategy = 'eager' | 'lazy-persist' | 'lazy-remount';
 
+export { MultiPolygon }
+
 export declare function MultiSelectField<TFieldValues extends FieldValues>({ name, control, label, description, required, placeholder: placeholderProp, searchPlaceholder: searchPlaceholderProp, emptyText: emptyTextProp, options, maxItems, disabled, className, cols, errorHint, }: MultiSelectFieldProps<TFieldValues>): JSX.Element;
 
 declare interface MultiSelectFieldProps<TFieldValues extends FieldValues> {
@@ -1922,7 +2179,7 @@ export declare interface OverviewPanelTopBarProps {
     segments: string[];
     actions?: ReactNode;
     className?: string;
-    variant?: 'default' | 'navy' | 'cherry' | 'emerald' | 'amber';
+    variant?: 'default' | 'navy' | 'cherry' | 'emerald' | 'amber' | 'teal';
 }
 
 export declare interface PagedResponse<T> {
@@ -1980,6 +2237,10 @@ export declare function PaginationNext({ className, ...props }: React_2.Componen
 
 export declare function PaginationPrevious({ className, ...props }: React_2.ComponentProps<typeof PaginationLink>): JSX.Element;
 
+declare type PanelAnimation = 'slide-up' | 'slide-down' | 'fade' | 'none';
+
+declare type PanelVariant = 'elevated' | 'flat' | 'ghost';
+
 /**
  * Parse backend timestamp format (YYYYMMDDHHmmssSSS) to Date
  * Example: 20260127004431907 -> Date(2026, 0, 27, 0, 44, 31)
@@ -2007,6 +2268,8 @@ declare interface PasswordFieldProps<TFieldValues extends FieldValues> {
     errorHint?: string;
 }
 
+export { Polygon }
+
 export declare function Popover({ ...props }: React_2.ComponentProps<typeof PopoverPrimitive.Root>): JSX.Element;
 
 export declare function PopoverContent({ className, align, sideOffset, ...props }: React_2.ComponentProps<typeof PopoverPrimitive.Content>): JSX.Element;
@@ -2644,7 +2907,7 @@ export declare function Table({ className, ...props }: React_2.ComponentProps<"t
 
 export declare const TABLE_CELL_CLASSES = "px-2.5 py-1.5 text-xs";
 
-export declare const TABLE_CONTAINER_CLASSES = "rounded-lg border border-border/80 bg-card overflow-hidden shadow-sm";
+export declare const TABLE_CONTAINER_CLASSES = "isolate rounded-lg border border-border/80 bg-card overflow-clip shadow-sm";
 
 export declare const TABLE_HEADER_CLASSES = "px-2 py-0.5 text-xs font-semibold uppercase tracking-wider transition-colors";
 
@@ -2757,7 +3020,7 @@ declare interface TextFieldProps<TFieldValues extends FieldValues> {
     suggestions?: string[];
 }
 
-export declare function Timeline({ items, className, relativeTime, maxItems, emptyMessage, animated, animationDelay, }: TimelineProps): JSX.Element;
+export declare function Timeline({ items, className, relativeTime, maxItems, emptyMessage, animated, animationDelay, variant, formatDate: formatDateProp, }: TimelineProps): JSX.Element;
 
 export declare interface TimelineItem {
     id: string | number;
@@ -2783,6 +3046,10 @@ declare interface TimelineProps {
     animated?: boolean;
     /** Animation delay offset in ms */
     animationDelay?: number;
+    /** Timeline display variant */
+    variant?: 'default' | 'activity';
+    /** Custom date formatter (overrides built-in relative/absolute) */
+    formatDate?: (date: string | Date | number) => string;
 }
 
 /**
@@ -2851,6 +3118,10 @@ declare interface TreeNodeOperation {
 
 export declare const trLabels: LenaUILabels;
 
+export declare const TURKEY_CENTER: [number, number];
+
+export declare const TURKEY_ZOOM = 6;
+
 export declare function UnderConstructionPage({ title, description, homeLabel, onGoHome, }: UnderConstructionPageProps): JSX.Element;
 
 export declare interface UnderConstructionPageProps {
@@ -3062,6 +3333,8 @@ export declare interface UseLazyTabsReturn {
  */
 export declare function useLenaLabels<K extends keyof LenaUILabels>(namespace: K, overrides?: Partial<LenaUILabels[K]>): LenaUILabels[K];
 
+export { useMap }
+
 /**
  * Hook specifically for numeric ID params (most common case)
  * Returns validated numeric ID or redirects
@@ -3173,47 +3446,6 @@ export declare function useOptimisticPageResponse<T extends {
     deleteItem: (id: number | string) => void;
 };
 
-/**
- * Hook for prefetching list and detail data on hover.
- * Improves perceived performance by loading data before user navigates.
- *
- * @example
- * ```tsx
- * const { prefetchDetail, prefetchPage } = usePrefetch({
- *   detailKey: simCardKeys.detail,
- *   listKey: simCardKeys.list,
- *   fetchDetail: getSimCard,
- *   fetchList: searchSimCards,
- *   searchParams: table.searchRequest,
- * });
- *
- * <DataTable
- *   onRowHover={(row) => prefetchDetail(row.id)}
- *   onPrefetchPage={prefetchPage}
- * />
- * ```
- */
-export declare function usePrefetch<TData>({ detailKey, listKey, fetchDetail, fetchList, searchParams, staleTime, }: UsePrefetchOptions<TData>): {
-    prefetchDetail: (id: number) => void;
-    prefetchPage: (page: number) => void;
-    clearPrefetchCache: () => void;
-};
-
-declare interface UsePrefetchOptions<TData> {
-    /** Query key factory for detail queries */
-    detailKey: (id: number) => QueryKey;
-    /** Query key factory for list queries */
-    listKey: (params: SearchRequest) => QueryKey;
-    /** Function to fetch detail data */
-    fetchDetail?: (id: number) => Promise<TData>;
-    /** Function to fetch list data */
-    fetchList?: (params: SearchRequest) => Promise<unknown>;
-    /** Current search params (for pagination prefetch) */
-    searchParams?: SearchRequest;
-    /** Stale time for prefetched data (default: 30s) */
-    staleTime?: number;
-}
-
 /**
  * useTabUrlSync — Synchronizes active tab state with URL search params.
  *