@nar-bus/lena-ui-shared 1.3.6 → 1.3.8

package/dist/index.d.ts

@@ -26,6 +26,7 @@ import { default as L_2 } from 'leaflet';
 import * as LabelPrimitive from '@radix-ui/react-label';
 import { Layer } from 'leaflet';
 import { LeafletMouseEvent } from 'leaflet';
+import { Locale } from 'date-fns';
 import { LucideIcon } from 'lucide-react';
 import { MultiPolygon } from 'geojson';
 import { NamedExoticComponent } from 'react';
@@ -208,7 +209,7 @@ export declare interface AreaSeriesConfig {
     /** Stroke dash pattern (e.g. "6 3") */
     strokeDasharray?: string;
     /** Curve interpolation type (default: "monotone") */
-    type?: 'monotone' | 'linear' | 'basis' | 'natural' | 'step';
+    type?: BaseCurveType;
 }
 
 /**
@@ -283,6 +284,9 @@ export declare interface BarSeriesConfig {
     maxBarSize?: number;
 }
 
+/** Shared curve interpolation types supported by Recharts */
+declare type BaseCurveType = 'monotone' | 'linear' | 'basis' | 'natural' | 'step';
+
 /**
  * Boolean cell for displaying true/false values.
  * Shows check/X icons with consistent styling.
@@ -1079,9 +1083,6 @@ declare type DateInput = number | string | Date | null | undefined;
 
 declare type DateInput_2 = number | string | Date | null | undefined;
 
-/**
- * Shared date formatting utilities for detail pages and table cells
- */
 declare type DateInput_3 = number | string | Date | null | undefined;
 
 export declare function DateRangeField<TFieldValues extends FieldValues>({ name, control, label, description, required, placeholder, minDate, maxDate, dateFormat, disabled, className, cols, clearable, errorHint, }: DateRangeFieldProps<TFieldValues>): JSX.Element;
@@ -1380,7 +1381,7 @@ declare interface FileFieldProps<TFieldValues extends FieldValues> {
 
 export declare const FILTER_CONTAINER_CLASSES = "flex flex-wrap items-center gap-2";
 
-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 function FilterableListLayout({ fieldConfig, filters, onFiltersChange, filterPanelOpen, onFilterPanelToggle, searchValue, onSearchChange, searchPlaceholder, onRefresh, isRefreshing, activeFilterCount, toolbarStart, addButton, filterLabel, refreshLabel, children, className, gradient, }: FilterableListLayoutProps): JSX.Element;
 
 export declare interface FilterableListLayoutProps {
     /** FieldConfig array for FilterSidePanel + ActiveFiltersBar */
@@ -1416,6 +1417,8 @@ export declare interface FilterableListLayoutProps {
     children: ReactNode;
     /** Additional className for the outer container */
     className?: string;
+    /** Gradient theme for the filter panel header — matches LenaPanel gradient presets */
+    gradient?: HeaderGradient;
 }
 
 export declare function FilterFieldRow({ fieldConfig, filter, onFilterChange }: FilterFieldRowProps): JSX.Element;
@@ -1438,12 +1441,16 @@ export declare interface FilterPanelLabels {
     empty: string;
     notEmpty: string;
     select: string;
+    datePlaceholder: string;
+    multiSelectPlaceholder: string;
+    minPlaceholder: string;
+    maxPlaceholder: string;
     yes: string;
     no: string;
     operators: Record<string, string>;
 }
 
-export declare function FilterSidePanel({ open, onClose, fieldConfig, filters, onFiltersChange, }: FilterSidePanelProps): JSX.Element;
+export declare function FilterSidePanel({ open, onClose, fieldConfig, filters, onFiltersChange, gradient, }: FilterSidePanelProps): JSX.Element;
 
 export declare interface FilterSidePanelProps {
     open: boolean;
@@ -1451,6 +1458,8 @@ export declare interface FilterSidePanelProps {
     fieldConfig: FieldConfig[];
     filters: FilterState[];
     onFiltersChange: (filters: FilterState[]) => void;
+    /** Gradient theme for the panel header — matches LenaPanel gradient presets */
+    gradient?: HeaderGradient;
 }
 
 export declare interface FilterState {
@@ -1473,17 +1482,17 @@ declare function Footer({ children, className }: LenaPanelFooterProps): JSX.Elem
 /**
  * Format backend timestamp to short datetime (e.g., "27 Oca 00:44")
  */
-export declare function formatBackendTimestamp(timestamp: number | string | null | undefined): string;
+export declare function formatBackendTimestamp(timestamp: number | string | null | undefined, locale?: Locale): string;
 
 /**
  * Format a timestamp to a short date string (e.g., "Jan 1, 2024")
  */
-export declare function formatDate(timestamp: DateInput_3): string;
+export declare function formatDate(timestamp: DateInput_3, locale?: Locale): string;
 
 /**
  * Format a timestamp to date with time (e.g., "Jan 1, 2024 14:30")
  */
-export declare function formatDateTime(timestamp: DateInput_3): string;
+export declare function formatDateTime(timestamp: DateInput_3, locale?: Locale): string;
 
 /**
  * Format a timestamp to compact date with time (e.g., "27.03.26 15:30")
@@ -1498,7 +1507,7 @@ export declare function formatDateTimeCompactFull(timestamp: DateInput_3): strin
 /**
  * Format a timestamp to full date with seconds (e.g., "Jan 1, 2024 14:30:45")
  */
-export declare function formatDateTimeFull(timestamp: DateInput_3): string;
+export declare function formatDateTimeFull(timestamp: DateInput_3, locale?: Locale): string;
 
 /**
  * Format a timestamp to ISO string (e.g., "2024-01-01T14:30:00Z")
@@ -1508,7 +1517,7 @@ export declare function formatISODate(timestamp: DateInput_3): string;
 /**
  * Format a timestamp to relative time (e.g., "2 hours ago")
  */
-export declare function formatRelativeTime(timestamp: DateInput_3, locale?: 'en' | 'tr'): string;
+export declare function formatRelativeTime(timestamp: DateInput_3, locale?: Locale): string;
 
 /**
  * Format a timestamp to a short time string (e.g., "14:30")
@@ -1570,7 +1579,7 @@ declare interface FormSectionProps {
 
 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';
+export declare type FormSheetGradient = 'navy' | 'cherry' | 'emerald' | 'amber' | 'teal' | 'violet' | 'rose' | 'indigo' | 'orange';
 
 export declare interface FormSheetProps {
     open: boolean;
@@ -1635,7 +1644,7 @@ 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 type HeaderGradient = 'teal' | 'navy' | 'cherry' | 'emerald' | 'amber' | 'violet' | 'rose' | 'indigo' | 'orange';
 
 export declare function HeaderQuickSearch({ placeholder, value, onValueChange, open, onOpenChange, loading, shortcutKey, shouldFilter, className, children, }: HeaderQuickSearchProps): JSX.Element;
 
@@ -1938,6 +1947,20 @@ export declare interface LenaChoroplethMapProps {
     className?: string;
 }
 
+export declare function LenaComposedChart<T extends object>({ data, barSeries, lineSeries, xAxisDataKey, height, showLegend, yAxisWidth, yAxisTickFormatter, tooltipItemColor, margin, barCategoryGap, barGap, className, }: LenaComposedChartProps<T>): JSX.Element;
+
+/** Props for LenaComposedChart (bar + line overlay) */
+export declare interface LenaComposedChartProps<T extends object> extends LenaChartBaseProps<T> {
+    /** Bar series configurations */
+    barSeries: BarSeriesConfig[];
+    /** Line series configurations (rendered on top of bars) */
+    lineSeries: LineSeriesConfig[];
+    /** Gap between bar categories (default: "20%") */
+    barCategoryGap?: string;
+    /** Gap between bars in same category */
+    barGap?: number;
+}
+
 export declare const LenaPanel: typeof _LenaPanel & {
     Header: typeof Header;
     Content: typeof Content;
@@ -2016,6 +2039,33 @@ export declare interface LenaUIProviderProps {
     children: ReactNode;
 }
 
+/** Extended curve types (Line supports additional step variants) */
+declare type LineCurveType = BaseCurveType | 'stepAfter' | 'stepBefore';
+
+/** Configuration for a single line series (used in ComposedChart) */
+export declare interface LineSeriesConfig {
+    /** Data key matching a field in the data array */
+    dataKey: string;
+    /** Display name (shown in tooltip/legend) */
+    name: string;
+    /** Stroke color */
+    color: string;
+    /** Stroke width (default: 2) */
+    strokeWidth?: number;
+    /** Stroke dash pattern (e.g. "6 3") */
+    strokeDasharray?: string;
+    /** Curve interpolation type (default: "monotone") */
+    type?: LineCurveType;
+    /** Custom active dot config */
+    activeDot?: {
+        r: number;
+        strokeWidth: number;
+        fill: string;
+    };
+    /** Whether to show in legend (default: true) */
+    showInLegend?: boolean;
+}
+
 /**
  * Link cell for navigable table values.
  * Shows external link icon on hover and supports different hover colors.
@@ -2903,6 +2953,8 @@ export declare interface TabConfig {
     description?: string;
     /** Per-tab mount strategy override (only used when lazyMount is enabled) */
     mountStrategy?: MountStrategy;
+    /** Per-tab accent color override — gradient name (e.g. 'teal', 'indigo', 'orange') */
+    accentColor?: string;
 }
 
 export declare function Table({ className, ...props }: React_2.ComponentProps<"table">): JSX.Element;
@@ -2911,7 +2963,7 @@ export declare const TABLE_CELL_CLASSES = "px-2.5 py-1.5 text-xs";
 
 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";
+export declare const TABLE_HEADER_CLASSES = "px-2 py-0.5 text-xs font-semibold tracking-wider transition-colors";
 
 export declare const TABLE_HEADER_ROW_CLASSES = "hover:bg-transparent border-b border-border/80";
 
@@ -3085,7 +3137,7 @@ export declare interface ToolbarEntityLabelProps {
 }
 
 /** Available toolbar color variants */
-declare type ToolbarVariant = 'dark' | 'cherry' | 'emerald' | 'amber';
+declare type ToolbarVariant = 'dark' | 'navy' | 'cherry' | 'emerald' | 'amber' | 'teal' | 'violet' | 'rose' | 'indigo' | 'orange';
 
 export declare function Tooltip({ ...props }: React_2.ComponentProps<typeof TooltipPrimitive.Root>): JSX.Element;
 
@@ -3532,6 +3584,13 @@ export declare interface ValidationStatusProps {
     showDetails?: boolean;
 }
 
+/**
+ * Adds monthly average fields to chart data.
+ * Date format: "dd/MM" — groups by month part, calculates average per key.
+ * Each data point receives a `{key}_avg` field with its month's average.
+ */
+export declare function withMonthlyAvg<T extends Record<string, unknown>>(data: T[], dateKey: string, valueKeys: string[]): (T & Record<string, number>)[];
+
 export { }