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

package/dist/index.d.ts

@@ -16,14 +16,21 @@ 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 * as RadioGroupPrimitive from '@radix-ui/react-radio-group';
@@ -40,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;
@@ -177,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`
  */
@@ -229,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.
@@ -346,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;
@@ -471,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;
@@ -1027,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
  */
@@ -1044,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
  */
@@ -1234,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;
@@ -1361,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")
  */
@@ -1376,6 +1484,16 @@ export declare function formatDate(timestamp: DateInput_3): string;
  */
 export declare function formatDateTime(timestamp: DateInput_3): string;
 
+/**
+ * Format a timestamp to compact date with time (e.g., "27.03.26 15:30")
+ */
+export declare function formatDateTimeCompact(timestamp: DateInput_3): string;
+
+/**
+ * Format a timestamp to compact date with time and seconds (e.g., "27.03.26 15:30:45")
+ */
+export declare function formatDateTimeCompactFull(timestamp: DateInput_3): string;
+
 /**
  * Format a timestamp to full date with seconds (e.g., "Jan 1, 2024 14:30:45")
  */
@@ -1511,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 {
@@ -1722,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;
@@ -1797,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> {
@@ -1901,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> {
@@ -1959,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)
@@ -1986,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;
@@ -2736,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;
@@ -2762,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;
 }
 
 /**
@@ -2830,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 {
@@ -3041,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