@nar-bus/lena-ui-shared 1.3.9 → 1.3.11

package/dist/index.d.ts

@@ -34,6 +34,7 @@ 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 { QueryClient } from '@tanstack/react-query';
 import * as RadioGroupPrimitive from '@radix-ui/react-radio-group';
 import * as React_2 from 'react';
 import { ReactNode } from 'react';
@@ -246,6 +247,21 @@ export declare function AvatarFallback({ className, ...props }: React_2.Componen
 
 export declare function AvatarImage({ className, ...props }: React_2.ComponentProps<typeof AvatarPrimitive.Image>): JSX.Element;
 
+/** Backend EnumDefinitionResponse (sadece ihtiyacımız olan alanlar) */
+declare interface BackendEnumDefinition {
+    code: string;
+    name: string;
+    enumValues: CachedEnumValue[] | null;
+}
+
+/** Backend PagedResponse wrapper */
+declare interface BackendPagedResponse {
+    status: number;
+    success: boolean;
+    message: string;
+    data: BackendEnumDefinition[];
+}
+
 export declare function Badge({ className, variant, asChild, ...props }: React_2.ComponentProps<"span"> & VariantProps<typeof badgeVariants> & {
     asChild?: boolean;
 }): JSX.Element;
@@ -382,6 +398,26 @@ export declare const buttonVariants: (props?: ({
     size?: "default" | "xs" | "sm" | "lg" | "icon" | "icon-xs" | "icon-sm" | "icon-lg" | null | undefined;
 } & ClassProp) | undefined) => string;
 
+/** Bir enum grubunun cache'lenmiş hali */
+export declare interface CachedEnumDefinition {
+    code: string;
+    name: string;
+    values: CachedEnumValue[];
+}
+
+/**
+ * Enum Cache Types
+ * Backend EnumDefinitionResponse / EnumValueItem ile uyumlu cache yapısı.
+ */
+/** Backend EnumValueItem — key/value çifti */
+export declare interface CachedEnumValue {
+    key: string;
+    value: string;
+    sortOrder?: number;
+    description?: string;
+    relationKey?: string;
+}
+
 export declare function Calendar({ className, classNames, showOutsideDays, captionLayout, buttonVariant, formatters, components, ...props }: React_2.ComponentProps<typeof DayPicker> & {
     buttonVariant?: React_2.ComponentProps<typeof Button>["variant"];
 }): JSX.Element;
@@ -831,7 +867,7 @@ export declare interface DataRowProps {
     size?: 'sm' | 'md';
 }
 
-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;
+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, zebra, meta, headerColor, headerTextColor, }: DataTableComponentProps<TData>): JSX.Element;
 
 declare interface DataTableActions {
     setGeneralSearch: (value: string) => void;
@@ -905,10 +941,14 @@ declare interface DataTableComponentProps<TData> {
     emptyTitle?: string;
     emptyDescription?: string;
     onRowClick?: (row: TData) => void;
-    rowClassName?: (row: TData) => string;
+    rowClassName?: (row: TData, index: number) => string;
+    /** Enable alternating row background colors */
+    zebra?: boolean;
     meta?: Record<string, unknown>;
     /** Custom header color (CSS color value). Overrides --table-header variable */
     headerColor?: string;
+    /** Custom header text color (CSS color value). Used with headerColor for gradient backgrounds */
+    headerTextColor?: string;
 }
 
 /** Customization props */
@@ -920,7 +960,9 @@ export declare interface DataTableCustomizationProps<TData> {
     emptyTitle?: string;
     emptyDescription?: string;
     onRowClick?: (row: TData) => void;
-    rowClassName?: (row: TData) => string;
+    rowClassName?: (row: TData, index: number) => string;
+    /** Enable alternating row background colors */
+    zebra?: boolean;
 }
 
 /** Data props for the table */
@@ -1277,6 +1319,33 @@ declare interface EntityDeleteDialogProps {
     description?: string;
 }
 
+/** Tüm enum cache: code → definition */
+export declare type EnumCache = Record<string, CachedEnumDefinition>;
+
+/**
+ * Dışarıdan sağlanabilen fetcher tipi.
+ * EnumPrefetcher'a `fetcher` prop olarak verilir.
+ * Parametresiz çağrılırsa tüm enum'ları, parametreli çağrılırsa filtrelenmiş sonuç döner.
+ */
+export declare type EnumFetcher = (params?: EnumFetchParams) => Promise<BackendPagedResponse>;
+
+/** Enum fetch parametreleri */
+export declare interface EnumFetchParams {
+    generalSearch?: string;
+    size?: number;
+}
+
+export declare const enumKeys: {
+    readonly all: readonly ["enums"];
+};
+
+export declare function EnumPrefetcher({ fetcher }: EnumPrefetcherProps): null;
+
+export declare interface EnumPrefetcherProps {
+    /** Enum verilerini çeken fonksiyon. */
+    fetcher: EnumFetcher;
+}
+
 /**
  * Error Boundary Component
  * Catches JavaScript errors in child component tree and displays fallback UI
@@ -1750,6 +1819,12 @@ export declare interface InfoSectionProps {
 
 export declare function Input({ className, type, ...props }: React_2.ComponentProps<"input">): JSX.Element;
 
+/**
+ * Tüm enum cache'ini temizler.
+ * Sonraki EnumPrefetcher renderında tümü yeniden çekilir.
+ */
+export declare function invalidateEnumCache(queryClient: QueryClient): void;
+
 /**
  * Check if a filter has a valid value
  */
@@ -2425,6 +2500,12 @@ declare interface RadioOption {
     icon?: React.ReactNode;
 }
 
+/**
+ * Tek bir enum'u backend'den çekip cache'e merge eder.
+ * CRUD başarılı olduktan sonra çağrılır.
+ */
+export declare function refreshEnum(queryClient: QueryClient, code: string): Promise<void>;
+
 /**
  * Relative time cell for displaying "time ago" values.
  * Changes color based on how old the timestamp is.
@@ -2440,6 +2521,12 @@ declare interface RelativeTimeCellProps {
     errorThresholdMs?: number;
 }
 
+/**
+ * Cache'den tek bir enum'u kaldırır (silme sonrası).
+ * Backend'e istek atmaz.
+ */
+export declare function removeEnumFromCache(queryClient: QueryClient, code: string): void;
+
 export declare function ResizableHandle({ withHandle, className, ...props }: React.ComponentProps<typeof Separator_2> & {
     withHandle?: boolean;
 }): JSX.Element;
@@ -2709,7 +2796,7 @@ export declare interface SidebarNavItem {
     children?: SidebarNavItem[];
 }
 
-export declare function SimpleDataTable<TData>({ columns, data, getRowId, isLoading, error, meta, enableSearch, searchPlaceholder: searchPlaceholderProp, searchColumn, emptyIcon, emptyTitle: emptyTitleProp, emptyDescription, onRowClick, rowClassName, className, loadingRows, headerColor, }: SimpleDataTableProps<TData>): JSX.Element;
+export declare function SimpleDataTable<TData>({ columns, data, getRowId, isLoading, error, meta, enableSearch, searchPlaceholder: searchPlaceholderProp, searchColumn, emptyIcon, emptyTitle: emptyTitleProp, emptyDescription, onRowClick, rowClassName, zebra, className, loadingRows, headerColor, headerTextColor, }: SimpleDataTableProps<TData>): JSX.Element;
 
 declare interface SimpleDataTableProps<TData> {
     /** Column definitions */
@@ -2739,13 +2826,17 @@ declare interface SimpleDataTableProps<TData> {
     /** Row click handler */
     onRowClick?: (row: TData) => void;
     /** Custom row class */
-    rowClassName?: (row: TData) => string;
+    rowClassName?: (row: TData, index: number) => string;
+    /** Enable alternating row background colors */
+    zebra?: boolean;
     /** Container class */
     className?: string;
     /** Number of skeleton rows for loading state */
     loadingRows?: number;
     /** Custom header color (CSS color value). Overrides --table-header variable */
     headerColor?: string;
+    /** Custom header text color (CSS color value). Used with headerColor for gradient backgrounds */
+    headerTextColor?: string;
 }
 
 export declare function Skeleton({ className, ...props }: React.ComponentProps<"div">): JSX.Element;
@@ -3164,6 +3255,9 @@ export declare function TooltipProvider({ delayDuration, ...props }: React_2.Com
 
 export declare function TooltipTrigger({ ...props }: React_2.ComponentProps<typeof TooltipPrimitive.Trigger>): JSX.Element;
 
+/** CachedEnumValue[] → SelectOption[] dönüşümü */
+export declare function toSelectOptions(values: CachedEnumValue[]): SelectOption[];
+
 /**
  * Convert UrlSearchParams to URLSearchParams for navigation
  */
@@ -3334,6 +3428,35 @@ export declare interface UseDoubleClickHandlerOptions<T> {
     delay?: number;
 }
 
+/**
+ * Tüm enum tanımlarının listesini döner.
+ */
+export declare function useEnumDefinitions(): CachedEnumDefinition[];
+
+/**
+ * Belirli bir enum code'unun SelectOption[] listesini döner.
+ *
+ * @example
+ * ```tsx
+ * const { options } = useEnumOptions('METER_TYPE');
+ * <SelectField options={options} />
+ * ```
+ */
+export declare function useEnumOptions(key: string, fallback?: SelectOption[]): {
+    options: SelectOption[];
+    isLoading: boolean;
+};
+
+/**
+ * Belirli bir enum code'unun ham CachedEnumValue[] değerlerini döner.
+ */
+export declare function useEnumValues(key: string): CachedEnumValue[];
+
+/**
+ * Tüm enum cache'ini temizler.
+ */
+export declare function useInvalidateEnumCache(): () => void;
+
 export declare function useJsonTree({ value, onChange }: UseJsonTreeOptions): UseJsonTreeReturn;
 
 declare interface UseJsonTreeOptions {
@@ -3517,6 +3640,22 @@ export declare function useOptimisticPageResponse<T extends {
     deleteItem: (id: number | string) => void;
 };
 
+/**
+ * Tek bir enum'u yeniden çeker ve cache'e merge eder.
+ *
+ * @example
+ * ```tsx
+ * const refresh = useRefreshEnum();
+ * if (result.success) await refresh(data.code);
+ * ```
+ */
+export declare function useRefreshEnum(): (code: string) => Promise<void>;
+
+/**
+ * Cache'den tek bir enum'u kaldırır (silme sonrası).
+ */
+export declare function useRemoveEnumFromCache(): (code: string) => void;
+
 /**
  * useTabUrlSync — Synchronizes active tab state with URL search params.
  *