@wakastellar/ui 3.5.0 → 4.0.0-dev.0

package/dist/components/waka-health-pulse/index.d.ts

@@ -0,0 +1,28 @@
+export type HealthStatus = "healthy" | "warning" | "critical" | "down" | "unknown";
+export interface WakaHealthPulseProps {
+    /** Current health status of the service */
+    status: HealthStatus;
+    /** Pulse rate in beats per minute (affects animation speed) */
+    pulseRate?: number;
+    /** Actual metric value to display */
+    value?: number;
+    /** Label for the health monitor */
+    label?: string;
+    /** Unit for the value (e.g., "req/s", "ms") */
+    unit?: string;
+    /** Size variant */
+    size?: "sm" | "md" | "lg";
+    /** Whether to show the value display */
+    showValue?: boolean;
+    /** Whether to animate the pulse */
+    animated?: boolean;
+    /** Custom colors per status */
+    colors?: Partial<Record<HealthStatus, string>>;
+    /** Additional CSS classes */
+    className?: string;
+}
+export declare function WakaHealthPulse({ status, pulseRate, value, label, unit, size, showValue, animated, colors, className, }: WakaHealthPulseProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace WakaHealthPulse {
+    var displayName: string;
+}
+export default WakaHealthPulse;

package/dist/components/waka-heatmap/index.d.ts

@@ -0,0 +1,135 @@
+export interface HeatmapCell {
+    /** Row index */
+    row: number;
+    /** Column index */
+    col: number;
+    /** Cell value */
+    value: number;
+    /** Optional custom label for the cell */
+    label?: string;
+}
+export interface HeatmapData {
+    /** 2D array of values (rows x cols) */
+    values: number[][];
+    /** Row labels */
+    rowLabels?: string[];
+    /** Column labels */
+    columnLabels?: string[];
+}
+export type ColorSchemeType = "sequential" | "diverging";
+export interface ColorScheme {
+    /** Type of color scheme */
+    type: ColorSchemeType;
+    /** Colors array (for sequential: low to high, for diverging: negative to neutral to positive) */
+    colors: string[];
+}
+export interface HeatmapSelection {
+    /** Selected cell row */
+    row: number;
+    /** Selected cell column */
+    col: number;
+    /** Cell value */
+    value: number;
+}
+export interface UseHeatmapOptions {
+    /** Initial zoom level */
+    initialZoom?: number;
+    /** Minimum zoom level */
+    minZoom?: number;
+    /** Maximum zoom level */
+    maxZoom?: number;
+    /** Initial pan position */
+    initialPan?: {
+        x: number;
+        y: number;
+    };
+    /** Callback when selection changes */
+    onSelectionChange?: (selection: HeatmapSelection | null) => void;
+}
+export interface UseHeatmapReturn {
+    /** Current zoom level */
+    zoom: number;
+    /** Current pan position */
+    pan: {
+        x: number;
+        y: number;
+    };
+    /** Currently selected cell */
+    selectedCell: HeatmapSelection | null;
+    /** Whether the user is currently panning */
+    isPanning: boolean;
+    /** Zoom in by a step */
+    zoomIn: () => void;
+    /** Zoom out by a step */
+    zoomOut: () => void;
+    /** Reset zoom to initial level */
+    resetZoom: () => void;
+    /** Set pan position */
+    setPan: (pan: {
+        x: number;
+        y: number;
+    }) => void;
+    /** Reset pan to initial position */
+    resetPan: () => void;
+    /** Select a cell */
+    selectCell: (selection: HeatmapSelection | null) => void;
+    /** Start panning */
+    startPanning: () => void;
+    /** Stop panning */
+    stopPanning: () => void;
+    /** Handle mouse movement for panning */
+    handlePanMove: (dx: number, dy: number) => void;
+}
+export interface WakaHeatmapProps {
+    /** Heatmap data */
+    data: HeatmapData;
+    /** Width of the heatmap container */
+    width?: number;
+    /** Height of the heatmap container */
+    height?: number;
+    /** Cell size in pixels */
+    cellSize?: number;
+    /** Gap between cells in pixels */
+    cellGap?: number;
+    /** Color scheme to use */
+    colorScheme?: ColorScheme;
+    /** Predefined color scheme name */
+    colorSchemeName?: "blues" | "greens" | "reds" | "viridis" | "plasma" | "coolwarm" | "rdylgn";
+    /** Show row labels */
+    showRowLabels?: boolean;
+    /** Show column labels */
+    showColumnLabels?: boolean;
+    /** Show color scale legend */
+    showLegend?: boolean;
+    /** Show min/max value indicators */
+    showMinMax?: boolean;
+    /** Show tooltip on hover */
+    showTooltip?: boolean;
+    /** Enable cell selection on click */
+    enableSelection?: boolean;
+    /** Enable zoom functionality */
+    enableZoom?: boolean;
+    /** Enable pan functionality when zoomed */
+    enablePan?: boolean;
+    /** Enable export as image */
+    enableExport?: boolean;
+    /** Initial zoom level */
+    initialZoom?: number;
+    /** Minimum zoom level */
+    minZoom?: number;
+    /** Maximum zoom level */
+    maxZoom?: number;
+    /** Custom value formatter for tooltip */
+    valueFormatter?: (value: number) => string;
+    /** Callback when a cell is clicked */
+    onCellClick?: (cell: HeatmapSelection) => void;
+    /** Callback when selection changes */
+    onSelectionChange?: (selection: HeatmapSelection | null) => void;
+    /** Additional CSS classes */
+    className?: string;
+    /** Heatmap title */
+    title?: string;
+}
+export declare function useHeatmap(options?: UseHeatmapOptions): UseHeatmapReturn;
+export declare function WakaHeatmap({ data, width, height, cellSize, cellGap, colorScheme, colorSchemeName, showRowLabels, showColumnLabels, showLegend, showMinMax, showTooltip, enableSelection, enableZoom, enablePan, enableExport, initialZoom, minZoom, maxZoom, valueFormatter, onCellClick, onSelectionChange, className, title, }: WakaHeatmapProps): import("react/jsx-runtime").JSX.Element;
+export default WakaHeatmap;

package/dist/components/waka-hotspot/index.d.ts

@@ -0,0 +1,111 @@
+import * as React from "react";
+export type HotspotVariant = "dot" | "icon" | "badge";
+export type HotspotSize = "sm" | "default" | "lg";
+export type HotspotPosition = "top" | "bottom" | "left" | "right" | "top-left" | "top-right" | "bottom-left" | "bottom-right";
+export type HotspotTrigger = "click" | "hover" | "both";
+export type HotspotIconType = "help" | "info" | "lightbulb" | "star" | "zap" | "alert";
+export interface WakaHotspotProps {
+    /** Unique identifier for seen state persistence */
+    id: string;
+    /** Tooltip content */
+    content: React.ReactNode;
+    /** Optional title for the tooltip */
+    title?: string;
+    /** Hotspot variant */
+    variant?: HotspotVariant;
+    /** Icon type for icon/badge variants */
+    iconType?: HotspotIconType;
+    /** Custom icon element */
+    customIcon?: React.ReactNode;
+    /** Size of the hotspot */
+    size?: HotspotSize;
+    /** Tooltip position relative to hotspot */
+    position?: HotspotPosition;
+    /** How to trigger the tooltip */
+    trigger?: HotspotTrigger;
+    /** Auto-dismiss tooltip after ms (0 to disable) */
+    autoDismissMs?: number;
+    /** Show only once (remember seen state in localStorage) */
+    showOnce?: boolean;
+    /** Storage key prefix for seen state */
+    storageKeyPrefix?: string;
+    /** Primary color for the hotspot */
+    color?: "primary" | "secondary" | "destructive" | "warning" | "success" | "info";
+    /** Custom color (CSS color value) */
+    customColor?: string;
+    /** Z-index for the hotspot and tooltip */
+    zIndex?: number;
+    /** Disable pulse animation */
+    disablePulse?: boolean;
+    /** Disable appear animation */
+    disableAppearAnimation?: boolean;
+    /** Called when hotspot is shown */
+    onShow?: () => void;
+    /** Called when hotspot is hidden */
+    onHide?: () => void;
+    /** Called when tooltip is dismissed */
+    onDismiss?: () => void;
+    /** Called when seen for first time (showOnce mode) */
+    onFirstSeen?: () => void;
+    /** Custom className for hotspot */
+    className?: string;
+    /** Custom className for tooltip */
+    tooltipClassName?: string;
+    /** Badge text (for badge variant) */
+    badgeText?: string;
+    /** Children to wrap (hotspot will be positioned relative to this) */
+    children?: React.ReactNode;
+}
+export interface HotspotState {
+    isVisible: boolean;
+    hasSeen: boolean;
+}
+/**
+ * @deprecated Since v3.6 — will be removed in v4.0.
+ * Use `WakaFancyButton variant="hotspot"` instead (futur, dans `@wakastellar/ui-effects-decorative`).
+ * See `docs/audit/remove-relocate.md` §2.1.
+ */
+export declare function WakaHotspot({ id, content, title, variant, iconType, customIcon, size, position, trigger, autoDismissMs, showOnce, storageKeyPrefix, color, customColor, zIndex, disablePulse, disableAppearAnimation, onShow, onHide, onDismiss, onFirstSeen, className, tooltipClassName, badgeText, children, }: WakaHotspotProps): import("react/jsx-runtime").JSX.Element;
+export interface UseHotspotOptions {
+    /** Unique identifier for the hotspot */
+    id: string;
+    /** Show only once (remember seen state) */
+    showOnce?: boolean;
+    /** Storage key prefix */
+    storageKeyPrefix?: string;
+    /** Auto-show on mount */
+    autoShow?: boolean;
+    /** Delay before auto-show (ms) */
+    autoShowDelay?: number;
+}
+export declare function useHotspot({ id, showOnce, storageKeyPrefix, autoShow, autoShowDelay, }: UseHotspotOptions): HotspotState & {
+    show: () => void;
+    hide: () => void;
+    dismiss: () => void;
+    reset: () => void;
+};
+export interface HotspotStep {
+    id: string;
+    content: React.ReactNode;
+    title?: string;
+    position?: HotspotPosition;
+}
+export interface WakaHotspotGroupProps {
+    /** Steps to show in sequence */
+    steps: HotspotStep[];
+    /** Whether the tour is active */
+    active: boolean;
+    /** Current step index */
+    currentStep?: number;
+    /** Called when step changes */
+    onStepChange?: (step: number) => void;
+    /** Called when tour completes */
+    onComplete?: () => void;
+    /** Called when tour is skipped */
+    onSkip?: () => void;
+    /** Show step indicator */
+    showStepIndicator?: boolean;
+    /** Common props for all hotspots */
+    hotspotProps?: Partial<WakaHotspotProps>;
+}
+export declare function WakaHotspotGroup({ steps, active, currentStep: controlledStep, onStepChange, onComplete, onSkip, showStepIndicator, hotspotProps, }: WakaHotspotGroupProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/waka-image/index.d.ts

@@ -0,0 +1,59 @@
+export interface WakaImageProps {
+    /** URL de l'image */
+    src: string;
+    /** Texte alternatif */
+    alt: string;
+    /** Largeur */
+    width?: number | string;
+    /** Hauteur */
+    height?: number | string;
+    /** Image placeholder (base64 ou URL) */
+    placeholder?: string;
+    /** Couleur de fond du placeholder */
+    placeholderColor?: string;
+    /** Activer le lazy loading */
+    lazy?: boolean;
+    /** Activer le zoom au clic */
+    zoomable?: boolean;
+    /** Niveau de zoom maximum */
+    maxZoom?: number;
+    /** Object fit */
+    objectFit?: "contain" | "cover" | "fill" | "none" | "scale-down";
+    /** Object position */
+    objectPosition?: string;
+    /** Arrondi des coins */
+    rounded?: "none" | "sm" | "md" | "lg" | "xl" | "full";
+    /** Afficher un indicateur de chargement */
+    showLoader?: boolean;
+    /** Callback quand l'image est chargée */
+    onLoad?: () => void;
+    /** Callback en cas d'erreur */
+    onError?: () => void;
+    /** Callback quand le zoom change */
+    onZoomChange?: (zoom: number) => void;
+    /** Classes CSS additionnelles */
+    className?: string;
+    /** Classes CSS pour le conteneur */
+    containerClassName?: string;
+    /** Ratio d'aspect (ex: "16/9", "4/3", "1/1") */
+    aspectRatio?: string;
+}
+export declare function WakaImage({ src, alt, width, height, placeholder, placeholderColor, lazy, zoomable, maxZoom, objectFit, objectPosition, rounded, showLoader, onLoad, onError, onZoomChange, className, containerClassName, aspectRatio, }: WakaImageProps): import("react/jsx-runtime").JSX.Element;
+export interface WakaImageGalleryProps {
+    /** Liste des images */
+    images: Array<{
+        src: string;
+        alt: string;
+        thumbnail?: string;
+    }>;
+    /** Nombre de colonnes */
+    columns?: number;
+    /** Gap entre les images */
+    gap?: number;
+    /** Aspect ratio des images */
+    aspectRatio?: string;
+    /** Classes CSS additionnelles */
+    className?: string;
+}
+export declare function WakaImageGallery({ images, columns, gap, aspectRatio, className, }: WakaImageGalleryProps): import("react/jsx-runtime").JSX.Element;
+export default WakaImage;

package/dist/components/waka-incident-timeline/index.d.ts

@@ -0,0 +1,38 @@
+export type IncidentSeverity = "critical" | "major" | "minor" | "info";
+export type IncidentStatus = "investigating" | "identified" | "monitoring" | "resolved";
+export interface IncidentUpdate {
+    message: string;
+    timestamp: Date;
+    status: string;
+}
+export interface IncidentImpact {
+    services?: number;
+    users?: number;
+}
+export interface Incident {
+    id: string;
+    title: string;
+    description?: string;
+    severity: IncidentSeverity;
+    status: IncidentStatus;
+    startedAt: Date;
+    resolvedAt?: Date;
+    impact?: IncidentImpact;
+    updates?: IncidentUpdate[];
+}
+export interface WakaIncidentTimelineProps {
+    /** List of incidents to display */
+    incidents: Incident[];
+    /** Callback when an incident is clicked */
+    onIncidentClick?: (id: string) => void;
+    /** Whether to show filter controls */
+    showFilters?: boolean;
+    /** Whether to show impact indicators */
+    showImpact?: boolean;
+    /** Maximum number of incidents to display */
+    maxItems?: number;
+    /** Additional CSS classes */
+    className?: string;
+}
+export declare function WakaIncidentTimeline({ incidents, onIncidentClick, showFilters, showImpact, maxItems, className, }: WakaIncidentTimelineProps): import("react/jsx-runtime").JSX.Element;
+export default WakaIncidentTimeline;

package/dist/components/waka-invoice-preview/index.d.ts

@@ -0,0 +1,137 @@
+export type InvoiceStatus = "paid" | "pending" | "overdue" | "draft";
+export type CurrencyCode = "USD" | "EUR" | "GBP" | "JPY" | "CAD" | "AUD" | "CHF" | "CNY" | "INR" | "BRL";
+export interface Address {
+    /** Company or person name */
+    name: string;
+    /** Street address line 1 */
+    street1: string;
+    /** Street address line 2 (optional) */
+    street2?: string;
+    /** City */
+    city: string;
+    /** State/Province/Region */
+    state?: string;
+    /** Postal/ZIP code */
+    postalCode: string;
+    /** Country */
+    country: string;
+}
+export interface CompanyInfo {
+    /** Company name */
+    name: string;
+    /** Company logo URL (optional) */
+    logo?: string;
+    /** Company address */
+    address: Address;
+    /** Company email */
+    email?: string;
+    /** Company phone */
+    phone?: string;
+    /** Tax ID / VAT number */
+    taxId?: string;
+    /** Website */
+    website?: string;
+}
+export interface LineItem {
+    /** Unique identifier */
+    id: string;
+    /** Item description */
+    description: string;
+    /** Quantity */
+    quantity: number;
+    /** Unit (optional, e.g., "hrs", "pcs", "units") */
+    unit?: string;
+    /** Unit price */
+    unitPrice: number;
+    /** Tax rate for this item (as decimal, e.g., 0.20 for 20%) */
+    taxRate?: number;
+    /** Discount for this item (as decimal, e.g., 0.10 for 10%) */
+    discount?: number;
+}
+export interface BankDetails {
+    /** Bank name */
+    bankName: string;
+    /** Account holder name */
+    accountName: string;
+    /** Account number or IBAN */
+    accountNumber: string;
+    /** Routing number / Sort code / BIC/SWIFT */
+    routingNumber?: string;
+    /** Additional reference */
+    reference?: string;
+}
+export interface InvoiceData {
+    /** Invoice number */
+    invoiceNumber: string;
+    /** Invoice date */
+    invoiceDate: Date | string;
+    /** Due date */
+    dueDate: Date | string;
+    /** Invoice status */
+    status: InvoiceStatus;
+    /** Company/Sender information */
+    company: CompanyInfo;
+    /** Bill to address */
+    billTo: Address;
+    /** Ship to address (optional, if different from bill to) */
+    shipTo?: Address;
+    /** Line items */
+    items: LineItem[];
+    /** Currency code */
+    currency: CurrencyCode;
+    /** Global tax rate (if not per-item) */
+    taxRate?: number;
+    /** Global discount amount */
+    discountAmount?: number;
+    /** Global discount percentage (as decimal) */
+    discountPercentage?: number;
+    /** Shipping cost */
+    shippingCost?: number;
+    /** Payment terms */
+    paymentTerms?: string;
+    /** Notes to customer */
+    notes?: string;
+    /** Bank details for payment */
+    bankDetails?: BankDetails;
+    /** Purchase order number */
+    poNumber?: string;
+}
+export interface WakaInvoicePreviewProps {
+    /** Invoice data */
+    invoice: InvoiceData;
+    /** Show print button */
+    showPrintButton?: boolean;
+    /** Show download button */
+    showDownloadButton?: boolean;
+    /** Callback when print is clicked */
+    onPrint?: () => void;
+    /** Callback when download is clicked */
+    onDownload?: () => void;
+    /** Compact mode for smaller displays */
+    compact?: boolean;
+    /** Show bank details section */
+    showBankDetails?: boolean;
+    /** Additional CSS classes */
+    className?: string;
+}
+declare function formatCurrency(amount: number, currency: CurrencyCode): string;
+declare function formatDate(date: Date | string, locale?: string): string;
+export declare function WakaInvoicePreview({ invoice, showPrintButton, showDownloadButton, onPrint, onDownload, compact, showBankDetails, className, }: WakaInvoicePreviewProps): import("react/jsx-runtime").JSX.Element;
+export interface UseInvoiceOptions {
+    items: LineItem[];
+    taxRate?: number;
+    discountAmount?: number;
+    discountPercentage?: number;
+    shippingCost?: number;
+}
+export declare function useInvoice({ items, taxRate, discountAmount, discountPercentage, shippingCost, }: UseInvoiceOptions): {
+    subtotal: number;
+    taxAmount: number;
+    discount: number;
+    shippingCost: number;
+    total: number;
+    itemCount: number;
+    totalQuantity: number;
+};
+export { formatCurrency, formatDate };
+export default WakaInvoicePreview;

package/dist/components/waka-kanban/index.d.ts

@@ -0,0 +1,68 @@
+import * as React from "react";
+export interface KanbanCard {
+    id: string;
+    title: string;
+    description?: string;
+    labels?: Array<{
+        id: string;
+        name: string;
+        color: string;
+    }>;
+    assignee?: {
+        id: string;
+        name: string;
+        avatar?: string;
+    };
+    priority?: "low" | "medium" | "high" | "urgent";
+    dueDate?: Date;
+    data?: Record<string, unknown>;
+}
+export interface KanbanColumn {
+    id: string;
+    title: string;
+    cards: KanbanCard[];
+    color?: string;
+    limit?: number;
+}
+export interface WakaKanbanProps {
+    /** Colonnes du kanban */
+    columns: KanbanColumn[];
+    /** Callback lors du déplacement d'une carte */
+    onCardMove?: (cardId: string, fromColumnId: string, toColumnId: string, newIndex: number) => void;
+    /** Callback lors du déplacement d'une colonne */
+    onColumnMove?: (columnId: string, newIndex: number) => void;
+    /** Callback lors de l'ajout d'une carte */
+    onCardAdd?: (columnId: string, card: Partial<KanbanCard>) => void;
+    /** Callback lors de la suppression d'une carte */
+    onCardDelete?: (cardId: string, columnId: string) => void;
+    /** Callback lors du clic sur une carte */
+    onCardClick?: (card: KanbanCard, columnId: string) => void;
+    /** Callback lors de l'ajout d'une colonne */
+    onColumnAdd?: (column: Partial<KanbanColumn>) => void;
+    /** Callback lors de la suppression d'une colonne */
+    onColumnDelete?: (columnId: string) => void;
+    /** Permettre l'ajout de cartes */
+    allowAddCard?: boolean;
+    /** Permettre l'ajout de colonnes */
+    allowAddColumn?: boolean;
+    /** Permettre le déplacement des colonnes */
+    allowColumnDrag?: boolean;
+    /** Fonction de rendu personnalisée pour les cartes */
+    renderCard?: (card: KanbanCard, columnId: string) => React.ReactNode;
+    /** Hauteur du kanban */
+    height?: number | string;
+    /** Classes CSS additionnelles */
+    className?: string;
+}
+export declare function WakaKanban({ columns, onCardMove, onColumnMove, onCardAdd, onCardDelete, onCardClick, onColumnAdd, onColumnDelete, allowAddCard, allowAddColumn, allowColumnDrag, renderCard, height, className, }: WakaKanbanProps): import("react/jsx-runtime").JSX.Element;
+export declare function useKanban(initialColumns: KanbanColumn[]): {
+    columns: KanbanColumn[];
+    setColumns: React.Dispatch<React.SetStateAction<KanbanColumn[]>>;
+    moveCard: (cardId: string, fromColumnId: string, toColumnId: string, newIndex: number) => void;
+    moveColumn: (columnId: string, newIndex: number) => void;
+    addCard: (columnId: string, card: Partial<KanbanCard>) => void;
+    deleteCard: (cardId: string, columnId: string) => void;
+    addColumn: (column: Partial<KanbanColumn>) => void;
+    deleteColumn: (columnId: string) => void;
+};
+export default WakaKanban;

package/dist/components/waka-kpi-dashboard/index.d.ts

@@ -0,0 +1,80 @@
+import * as React from "react";
+export type TrendDirection = "up" | "down" | "neutral";
+export type KPICardSize = "1x1" | "2x1" | "1x2" | "2x2";
+export interface SparklineData {
+    value: number;
+    timestamp?: number | Date;
+}
+export interface KPIData {
+    id: string;
+    title: string;
+    value: string | number;
+    previousValue?: string | number;
+    trend?: TrendDirection;
+    trendValue?: string;
+    unit?: string;
+    sparklineData?: SparklineData[];
+    target?: {
+        value: number;
+        label?: string;
+    };
+    color?: "default" | "primary" | "success" | "warning" | "destructive" | "blue" | "purple";
+    icon?: React.ReactNode;
+    size?: KPICardSize;
+    loading?: boolean;
+    lastUpdated?: Date;
+    data?: Record<string, unknown>;
+}
+export interface WakaKPIDashboardProps {
+    /** KPI data items */
+    kpis: KPIData[];
+    /** Number of columns in the grid */
+    columns?: 2 | 3 | 4 | 6;
+    /** Gap between cards */
+    gap?: "sm" | "md" | "lg";
+    /** Enable drag to reorder */
+    draggable?: boolean;
+    /** Callback when KPIs are reordered */
+    onReorder?: (kpis: KPIData[]) => void;
+    /** Callback to refresh a specific KPI */
+    onRefresh?: (kpiId: string) => void;
+    /** Callback when a KPI card is clicked */
+    onCardClick?: (kpi: KPIData) => void;
+    /** Show loading skeleton for all cards */
+    loading?: boolean;
+    /** Custom card renderer */
+    renderCard?: (kpi: KPIData) => React.ReactNode;
+    /** Additional CSS classes */
+    className?: string;
+}
+export interface KPICardProps {
+    kpi: KPIData;
+    onRefresh?: (kpiId: string) => void;
+    onClick?: (kpi: KPIData) => void;
+    draggable?: boolean;
+    onDragStart?: (e: React.DragEvent, kpiId: string) => void;
+}
+export declare function KPICard({ kpi, onRefresh, onClick, draggable, onDragStart, }: KPICardProps): import("react/jsx-runtime").JSX.Element;
+export declare function WakaKPIDashboard({ kpis, columns, gap, draggable, onReorder, onRefresh, onCardClick, loading, renderCard, className, }: WakaKPIDashboardProps): import("react/jsx-runtime").JSX.Element;
+export interface UseKPIDashboardOptions {
+    initialKPIs?: KPIData[];
+    refreshInterval?: number;
+    onRefresh?: (kpiId: string) => Promise<KPIData | null>;
+}
+export declare function useKPIDashboard(options?: UseKPIDashboardOptions): {
+    kpis: KPIData[];
+    setKPIs: React.Dispatch<React.SetStateAction<KPIData[]>>;
+    loading: boolean;
+    refreshKPI: (kpiId: string) => Promise<void>;
+    refreshAll: () => Promise<void>;
+    updateKPI: (kpiId: string, updates: Partial<KPIData>) => void;
+    addKPI: (kpi: KPIData) => void;
+    removeKPI: (kpiId: string) => void;
+    reorderKPIs: (newKPIs: KPIData[]) => void;
+    calculateTrend: (currentValue: number, previousValue: number) => {
+        direction: TrendDirection;
+        value: string;
+    };
+    isRefreshing: (kpiId: string) => boolean;
+};
+export default WakaKPIDashboard;