@nar-bus/lena-ui-shared 1.3.10 → 1.3.12

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;
@@ -1283,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
@@ -1756,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
  */
@@ -2351,6 +2420,43 @@ export declare function PopoverContent({ className, align, sideOffset, ...props
 
 export declare function PopoverTrigger({ ...props }: React_2.ComponentProps<typeof PopoverPrimitive.Trigger>): JSX.Element;
 
+export declare function PreviewSection({ title, children, className }: PreviewSectionProps): JSX.Element;
+
+export declare interface PreviewSectionProps {
+    title: string;
+    children: ReactNode;
+    className?: string;
+}
+
+export declare function PreviewSheet({ open, onOpenChange, title, icon: Icon, headerGradient, badge, headerActions, footerActions, children, className, maxWidth, isLoading, closeLabel, }: PreviewSheetProps): JSX.Element;
+
+export declare interface PreviewSheetProps {
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    title: string;
+    /** Icon component rendered in the gradient header */
+    icon?: ComponentType<{
+        className?: string;
+        style?: CSSProperties;
+    }>;
+    /** Gradient color theme for the header */
+    headerGradient?: FormSheetGradient;
+    /** Optional badge rendered next to the title */
+    badge?: ReactNode;
+    /** Action buttons rendered in the header (right side, replaces close button) */
+    headerActions?: ReactNode;
+    /** Action buttons rendered in the footer (right side) */
+    footerActions?: ReactNode;
+    children: ReactNode;
+    className?: string;
+    /** Sheet max width — defaults to 'lg' */
+    maxWidth?: 'lg' | 'xl' | '2xl';
+    /** Shows a centered loading spinner instead of children */
+    isLoading?: boolean;
+    /** Close button label override */
+    closeLabel?: string;
+}
+
 export declare const priorityColors: {
     readonly HIGH: "bg-status-error/10 text-status-error border-status-error/30 ring-status-error/30";
     readonly MEDIUM: "bg-status-warning/10 text-status-warning border-status-warning/30 ring-status-warning/30";
@@ -2431,6 +2537,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.
@@ -2446,6 +2558,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;
@@ -3174,6 +3292,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
  */
@@ -3344,6 +3465,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 {
@@ -3527,6 +3677,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.
  *