@parto-system-design/ui 1.1.2 → 1.1.4

package/dist/index.d.cts

@@ -41,10 +41,6 @@ import * as SwitchPrimitive from '@radix-ui/react-switch';
 import * as TabsPrimitive from '@radix-ui/react-tabs';
 import * as TogglePrimitive from '@radix-ui/react-toggle';
 import * as ToggleGroupPrimitive from '@radix-ui/react-toggle-group';
-import { LineSvgProps } from '@nivo/line';
-import { BarSvgProps } from '@nivo/bar';
-import { PieSvgProps } from '@nivo/pie';
-import { HeatMapSvgProps } from '@nivo/heatmap';
 
 declare function cn(...inputs: ClassValue[]): string;
 type SupportedLocale = 'fa' | 'ar' | 'en';
@@ -56,7 +52,7 @@ type SupportedLocale = 'fa' | 'ar' | 'en';
 declare function convertToLocalNumbers(text: string | number, locale: SupportedLocale): string;
 /**
  * Format large numbers with locale-aware suffixes (K/M/B).
- * @example formatLargeNumber(1500, 'fa') => '۱.۵ه'
+ * @example formatLargeNumber(1500, 'fa') => '۱.۵ هزار'
  * @example formatLargeNumber(1500, 'en') => '1.5K'
  */
 declare function formatLargeNumber(num: number, locale: SupportedLocale): string;
@@ -72,11 +68,28 @@ declare function formatNumber(num: number | undefined, format?: 'exact' | 'short
  */
 declare function formatRelativeTime(date: Date | string | number): string;
 /**
- * Format date to absolute format (Persian)
+ * Format date to absolute format (Persian / Jalali)
+ * Uses date-fns-jalali for accurate Jalali conversion.
  * @example formatAbsoluteTime(new Date()) => '۱۵ دی ۱۴۰۳، ۱۵:۳۰'
  */
 declare function formatAbsoluteTime(date: Date | string | number): string;
 
+/**
+ * Persian (Jalali / Solar Hijri) calendar utilities.
+ *
+ * Backed by **date-fns-jalali** — a Jalali-native fork of date-fns v4.
+ * Chosen over moment-jalaali (unmaintained since 2019) because:
+ *   • Tree-shakeable, zero dependencies
+ *   • Built-in TypeScript types
+ *   • Tracks upstream date-fns releases
+ *   • Built-in fa-IR locale with month/weekday names
+ *   • ~5-10KB gzipped for typical usage
+ *
+ * DO NOT replace this library again. This decision was made after
+ * evaluating date-fns-jalali, jalaali-js, jalaliday (dayjs), moment-jalaali,
+ * and persian-date in April 2026. date-fns-jalali is the clear winner
+ * for a design system that needs formatting, parsing, and locale support.
+ */
 /**
  * Persian/Farsi month names
  */
@@ -102,9 +115,14 @@ declare function toPersianDigits(num: number | string): string;
  */
 declare function toEnglishDigits(str: string): string;
 /**
- * Format a Date object to Persian/Jalali date string
+ * Format a Date object to Persian/Jalali date string.
+ *
+ * Uses date-fns-jalali format tokens:
+ *   yyyy = Jalali year, MM = month (01-12), dd = day (01-31)
+ *   MMMM = full month name, EEEE = full weekday name
+ *   HH:mm = 24h time, hh:mm a = 12h time
  */
-declare function formatJalaliDate(date: Date, format?: string): string;
+declare function formatJalaliDate(date: Date, formatStr?: string): string;
 /**
  * Get Persian month name from a Date object
  */
@@ -161,6 +179,8 @@ interface EngagementRange {
     color: string;
     colorFaded: string;
     hoverColor: string;
+    /** Accessible text color for use on hoverColor background */
+    contrastText: string;
 }
 interface EngagementRangeWithDisplay extends EngagementRange {
     display: string;
@@ -181,6 +201,35 @@ declare function getFollowerGroup(followers: number): FollowerGroup;
 declare function getEngagementRanges(followers: number, locale: SupportedLocale): EngagementRangeWithDisplay[];
 declare function getCurrentRangeIndex(currentRate: number, ranges: EngagementRange[]): number;
 
+type Locale = SupportedLocale;
+/**
+ * Returns true for RTL locales (fa, ar).
+ */
+declare function isRTL(locale: SupportedLocale): boolean;
+/**
+ * UI string translations used by the EngagementRate component.
+ * Centralised here to avoid duplication between components.
+ */
+declare const engagementUiTranslations: Record<SupportedLocale, {
+    yourCategory: string;
+    influencer: string;
+    followers: string;
+    over: string;
+    to: string;
+    and: string;
+    lessThan: string;
+    you: string;
+    criteria: string;
+}>;
+/**
+ * Sentiment label translations used by the SentimentBadge component.
+ */
+declare const sentimentLabels: Record<SupportedLocale, {
+    positive: string;
+    negative: string;
+    neutral: string;
+    mixed: string;
+}>;
 /**
  * Default UI strings for components that need localized text.
  * Persian (fa) is the default locale for backward compatibility.
@@ -204,6 +253,44 @@ declare const UI_STRINGS: {
         readonly previous: "قبلی";
         readonly next: "بعدی";
         readonly actions: "عملیات";
+        readonly copy: "کپی";
+        readonly copied: "کپی شد";
+        readonly confirm: "تایید";
+        readonly cancel: "انصراف";
+        readonly areYouSure: "آیا مطمئن هستید؟";
+        readonly stepperLabel: "مراحل";
+        readonly stepCompleted: "تکمیل شده";
+        readonly stepCurrent: "مرحله فعلی";
+        readonly stepPending: "در انتظار";
+        readonly clearFilters: "پاک کردن فیلترها";
+        readonly activeFilters: "فیلترهای فعال";
+        readonly goBack: "بازگشت";
+        readonly gridView: "نمای شبکه‌ای";
+        readonly listView: "نمای لیستی";
+        readonly loading: "در حال بارگذاری...";
+        readonly unexpectedError: "خطای غیرمنتظره‌ای رخ داد";
+        readonly selectAll: "انتخاب همه";
+        readonly selectRow: "انتخاب ردیف";
+        readonly noDataToDisplay: "داده‌ای برای نمایش وجود ندارد";
+        readonly likesCount: "تعداد لایک";
+        readonly commentsCount: "تعداد کامنت";
+        readonly viewsCount: "تعداد بازدید";
+        readonly sharesCount: "تعداد اشتراک";
+        readonly postTypeLabel: "نوع پست";
+        readonly postTypePhoto: "عکس";
+        readonly postTypeVideo: "ویدیو";
+        readonly postTypeCarousel: "اسلاید";
+        readonly showMore: "بیشتر";
+        readonly showLess: "کمتر";
+        readonly noMediaAvailable: "رسانه‌ای موجود نیست";
+        readonly commentAnalysis: "تحلیل کامنت‌ها";
+        readonly commentAnalysisDisabled: "تحلیل کامنت‌ها (غیرفعال)";
+        readonly booster: "بوستر";
+        readonly boosterDisabled: "بوستر (غیرفعال)";
+        readonly aiAnalysis: "تحلیل هوش مصنوعی";
+        readonly aiAnalysisDisabled: "تحلیل هوش مصنوعی (غیرفعال)";
+        readonly openOnInstagram: "باز کردن در اینستاگرام";
+        readonly openOnInstagramDisabled: "باز کردن در اینستاگرام (غیرفعال)";
     };
     readonly ar: {
         readonly noResults: "لم يتم العثور على نتائج";
@@ -223,6 +310,44 @@ declare const UI_STRINGS: {
         readonly previous: "السابق";
         readonly next: "التالي";
         readonly actions: "إجراءات";
+        readonly copy: "نسخ";
+        readonly copied: "تم النسخ";
+        readonly confirm: "تأكيد";
+        readonly cancel: "إلغاء";
+        readonly areYouSure: "هل أنت متأكد؟";
+        readonly stepperLabel: "الخطوات";
+        readonly stepCompleted: "مكتمل";
+        readonly stepCurrent: "الخطوة الحالية";
+        readonly stepPending: "قيد الانتظار";
+        readonly clearFilters: "مسح الفلاتر";
+        readonly activeFilters: "الفلاتر النشطة";
+        readonly goBack: "رجوع";
+        readonly gridView: "عرض شبكي";
+        readonly listView: "عرض قائمة";
+        readonly loading: "جارٍ التحميل...";
+        readonly unexpectedError: "حدث خطأ غير متوقع";
+        readonly selectAll: "تحديد الكل";
+        readonly selectRow: "تحديد الصف";
+        readonly noDataToDisplay: "لا توجد بيانات للعرض";
+        readonly likesCount: "عدد الإعجابات";
+        readonly commentsCount: "عدد التعليقات";
+        readonly viewsCount: "عدد المشاهدات";
+        readonly sharesCount: "عدد المشاركات";
+        readonly postTypeLabel: "نوع المنشور";
+        readonly postTypePhoto: "صورة";
+        readonly postTypeVideo: "فيديو";
+        readonly postTypeCarousel: "شرائح";
+        readonly showMore: "المزيد";
+        readonly showLess: "أقل";
+        readonly noMediaAvailable: "لا توجد وسائط";
+        readonly commentAnalysis: "تحليل التعليقات";
+        readonly commentAnalysisDisabled: "تحليل التعليقات (معطل)";
+        readonly booster: "تعزيز";
+        readonly boosterDisabled: "تعزيز (معطل)";
+        readonly aiAnalysis: "تحليل الذكاء الاصطناعي";
+        readonly aiAnalysisDisabled: "تحليل الذكاء الاصطناعي (معطل)";
+        readonly openOnInstagram: "فتح في إنستاجرام";
+        readonly openOnInstagramDisabled: "فتح في إنستاجرام (معطل)";
     };
     readonly en: {
         readonly noResults: "No results found";
@@ -242,6 +367,44 @@ declare const UI_STRINGS: {
         readonly previous: "Previous";
         readonly next: "Next";
         readonly actions: "Actions";
+        readonly copy: "Copy";
+        readonly copied: "Copied";
+        readonly confirm: "Confirm";
+        readonly cancel: "Cancel";
+        readonly areYouSure: "Are you sure?";
+        readonly stepperLabel: "Steps";
+        readonly stepCompleted: "Completed";
+        readonly stepCurrent: "Current step";
+        readonly stepPending: "Pending";
+        readonly clearFilters: "Clear filters";
+        readonly activeFilters: "Active filters";
+        readonly goBack: "Go back";
+        readonly gridView: "Grid view";
+        readonly listView: "List view";
+        readonly loading: "Loading...";
+        readonly unexpectedError: "An unexpected error occurred";
+        readonly selectAll: "Select all";
+        readonly selectRow: "Select row";
+        readonly noDataToDisplay: "No data to display";
+        readonly likesCount: "Likes";
+        readonly commentsCount: "Comments";
+        readonly viewsCount: "Views";
+        readonly sharesCount: "Shares";
+        readonly postTypeLabel: "Post type";
+        readonly postTypePhoto: "Photo";
+        readonly postTypeVideo: "Video";
+        readonly postTypeCarousel: "Carousel";
+        readonly showMore: "More";
+        readonly showLess: "Less";
+        readonly noMediaAvailable: "No media available";
+        readonly commentAnalysis: "Comment Analysis";
+        readonly commentAnalysisDisabled: "Comment Analysis (disabled)";
+        readonly booster: "Booster";
+        readonly boosterDisabled: "Booster (disabled)";
+        readonly aiAnalysis: "AI Analysis";
+        readonly aiAnalysisDisabled: "AI Analysis (disabled)";
+        readonly openOnInstagram: "Open on Instagram";
+        readonly openOnInstagramDisabled: "Open on Instagram (disabled)";
     };
 };
 type UIStringKeys = keyof (typeof UI_STRINGS)['fa'];
@@ -255,21 +418,17 @@ declare function getUIStrings(locale?: SupportedLocale): UIStrings;
 /**
  * Standard size scale used across the design system.
  * Components should accept these values for their `size` prop.
- *
- * Primary:   xs | sm | md | lg | xl
- * Legacy:    tiny | small | medium | large | xlarge (deprecated, kept for backward compat)
  */
 type StandardSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+/** @deprecated Use `StandardSize` instead — legacy names have been removed */
+type LegacySize = StandardSize;
 /** @deprecated Use `StandardSize` instead */
-type LegacySize = 'tiny' | 'small' | 'medium' | 'large' | 'xlarge';
-/** Size type that accepts both standard and legacy names during migration */
-type SizeWithLegacy = StandardSize | LegacySize;
+type SizeWithLegacy = StandardSize;
 /**
- * Normalizes a size value to standard names (xs|sm|md|lg|xl).
- * Accepts both legacy and standard names.
- * Emits a console.warn in development for legacy names.
+ * Normalizes a size value to standard names.
+ * @deprecated All sizes are standard now — this function is a no-op passthrough.
  */
-declare function normalizeSize(size: SizeWithLegacy): StandardSize;
+declare function normalizeSize(size: StandardSize): StandardSize;
 
 type Icon = LucideIcon;
 /**
@@ -329,7 +488,7 @@ interface AutocompleteItem {
     label: string;
     [key: string]: unknown;
 }
-interface AutocompleteProps<T extends AutocompleteItem = AutocompleteItem> extends Omit<React$1.InputHTMLAttributes<HTMLInputElement>, "value" | "onChange" | "onSelect" | "size"> {
+interface AutocompleteProps<T extends AutocompleteItem = AutocompleteItem> extends Omit<React$1.InputHTMLAttributes<HTMLInputElement>, 'value' | 'onChange' | 'onSelect' | 'size'> {
     /**
      * مقدار ورودی
      * Input value
@@ -412,7 +571,7 @@ interface AutocompleteProps<T extends AutocompleteItem = AutocompleteItem> exten
      * جهت نمایش (RTL/LTR)
      * Direction
      */
-    dir?: "rtl" | "ltr";
+    dir?: 'rtl' | 'ltr';
     /**
      * Locale for default strings
      * @default "fa"
@@ -429,7 +588,7 @@ interface UserItem {
     followers: number;
     [key: string]: unknown;
 }
-interface UserAutocompleteProps extends Omit<React$1.InputHTMLAttributes<HTMLInputElement>, "value" | "onChange" | "onSelect" | "size"> {
+interface UserAutocompleteProps extends Omit<React$1.InputHTMLAttributes<HTMLInputElement>, 'value' | 'onChange' | 'onSelect' | 'size'> {
     /**
      * مقدار ورودی
      * Input value
@@ -502,7 +661,7 @@ interface UserAutocompleteProps extends Omit<React$1.InputHTMLAttributes<HTMLInp
      * جهت نمایش (RTL/LTR)
      * Direction
      */
-    dir?: "rtl" | "ltr";
+    dir?: 'rtl' | 'ltr';
     /**
      * Locale for default strings
      * @default "fa"
@@ -537,6 +696,23 @@ interface UserAutocompleteProps extends Omit<React$1.InputHTMLAttributes<HTMLInp
 }
 declare const UserAutocomplete: React$1.ForwardRefExoticComponent<UserAutocompleteProps & React$1.RefAttributes<HTMLInputElement>>;
 
+declare const appBarVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface AppBarProps extends React$1.HTMLAttributes<HTMLElement>, VariantProps<typeof appBarVariants> {
+    /** Logo or brand mark — rendered at the inline-start */
+    logo?: React$1.ReactNode;
+    /** Primary navigation links — rendered after logo */
+    nav?: React$1.ReactNode;
+    /** Search input or trigger — rendered in the center area */
+    search?: React$1.ReactNode;
+    /** Action buttons (notifications, help, etc.) — rendered before user slot */
+    actions?: React$1.ReactNode;
+    /** User avatar / menu — rendered at the inline-end */
+    user?: React$1.ReactNode;
+}
+declare const AppBar: React$1.ForwardRefExoticComponent<AppBarProps & React$1.RefAttributes<HTMLElement>>;
+
 declare function AspectRatio({ className, ...props }: React$1.ComponentProps<typeof AspectRatioPrimitive.Root>): react_jsx_runtime.JSX.Element;
 declare namespace AspectRatio {
     var displayName: string;
@@ -555,47 +731,75 @@ declare namespace AvatarFallback {
     var displayName: string;
 }
 
+declare const avatarGroupVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface AvatarGroupItem {
+    src?: string;
+    alt?: string;
+    fallback?: string;
+}
+interface AvatarGroupProps extends React$1.HTMLAttributes<HTMLDivElement>, VariantProps<typeof avatarGroupVariants> {
+    /** Array of avatar data to display */
+    items: AvatarGroupItem[];
+    /** Maximum number of avatars to show before the "+N" overflow */
+    max?: number;
+}
+declare const AvatarGroup: React$1.ForwardRefExoticComponent<AvatarGroupProps & React$1.RefAttributes<HTMLDivElement>>;
+
 declare const badgeVariants: (props?: ({
     variant?: "default" | "success" | "warning" | "destructive" | "secondary" | "outline" | "brand" | null | undefined;
-    size?: "xs" | "sm" | "md" | "lg" | "tiny" | "small" | "large" | null | undefined;
+    size?: "xs" | "sm" | "md" | "lg" | "small" | "tiny" | "large" | null | undefined;
     dot?: boolean | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
-interface BadgeProps extends React$1.HTMLAttributes<HTMLDivElement>, VariantProps<typeof badgeVariants> {
+interface BadgeProps extends React$1.HTMLAttributes<HTMLSpanElement>, VariantProps<typeof badgeVariants> {
     dot?: boolean;
-    dotPosition?: "start" | "end";
+    dotPosition?: 'start' | 'end';
 }
-declare function Badge({ className, variant, size, dot, dotPosition, children, ...props }: BadgeProps): react_jsx_runtime.JSX.Element;
-declare namespace Badge {
-    var displayName: string;
+declare const Badge: React$1.ForwardRefExoticComponent<BadgeProps & React$1.RefAttributes<HTMLSpanElement>>;
+
+declare const bannerVariants: (props?: ({
+    variant?: "info" | "success" | "warning" | "destructive" | "neutral" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface BannerProps extends React$1.HTMLAttributes<HTMLDivElement>, VariantProps<typeof bannerVariants> {
+    /** Whether the banner can be dismissed */
+    dismissible?: boolean;
+    /** Callback when the banner is dismissed */
+    onDismiss?: () => void;
+    /** Icon to show before the message */
+    icon?: React$1.ReactNode;
+    /** Action element (e.g., a button or link) */
+    action?: React$1.ReactNode;
 }
+declare const Banner: React$1.ForwardRefExoticComponent<BannerProps & React$1.RefAttributes<HTMLDivElement>>;
 
-declare function Breadcrumb({ ...props }: React$1.ComponentProps<"nav">): react_jsx_runtime.JSX.Element;
+declare function Breadcrumb({ ...props }: React$1.ComponentProps<'nav'>): react_jsx_runtime.JSX.Element;
 declare namespace Breadcrumb {
     var displayName: string;
 }
-declare function BreadcrumbList({ className, dir, ...props }: React$1.ComponentProps<"ol">): react_jsx_runtime.JSX.Element;
+declare function BreadcrumbList({ className, dir, ...props }: React$1.ComponentProps<'ol'>): react_jsx_runtime.JSX.Element;
 declare namespace BreadcrumbList {
     var displayName: string;
 }
-declare function BreadcrumbItem({ className, ...props }: React$1.ComponentProps<"li">): react_jsx_runtime.JSX.Element;
+declare function BreadcrumbItem({ className, ...props }: React$1.ComponentProps<'li'>): react_jsx_runtime.JSX.Element;
 declare namespace BreadcrumbItem {
     var displayName: string;
 }
-declare function BreadcrumbLink({ asChild, className, ...props }: React$1.ComponentProps<"a"> & {
+declare function BreadcrumbLink({ asChild, className, ...props }: React$1.ComponentProps<'a'> & {
     asChild?: boolean;
 }): react_jsx_runtime.JSX.Element;
 declare namespace BreadcrumbLink {
     var displayName: string;
 }
-declare function BreadcrumbPage({ className, ...props }: React$1.ComponentProps<"span">): react_jsx_runtime.JSX.Element;
+declare function BreadcrumbPage({ className, ...props }: React$1.ComponentProps<'span'>): react_jsx_runtime.JSX.Element;
 declare namespace BreadcrumbPage {
     var displayName: string;
 }
-declare function BreadcrumbSeparator({ children, className, ...props }: React$1.ComponentProps<"li">): react_jsx_runtime.JSX.Element;
+declare function BreadcrumbSeparator({ children, className, ...props }: React$1.ComponentProps<'li'>): react_jsx_runtime.JSX.Element;
 declare namespace BreadcrumbSeparator {
     var displayName: string;
 }
-declare function BreadcrumbEllipsis({ className, ...props }: React$1.ComponentProps<"span">): react_jsx_runtime.JSX.Element;
+declare function BreadcrumbEllipsis({ className, ...props }: React$1.ComponentProps<'span'>): react_jsx_runtime.JSX.Element;
 declare namespace BreadcrumbEllipsis {
     var displayName: string;
 }
@@ -604,10 +808,9 @@ type ButtonVariantProps = VariantProps<typeof buttonVariants>;
 declare const buttonVariants: (props?: ({
     variant?: "link" | "text" | "default" | "warning" | "destructive" | "primary" | "secondary" | "outline" | "dashed" | "danger" | "ghost" | null | undefined;
     block?: boolean | null | undefined;
-    size?: "xs" | "sm" | "md" | "lg" | "xl" | "tiny" | "small" | "medium" | "large" | "xlarge" | "default" | "icon" | null | undefined;
+    size?: "xs" | "sm" | "md" | "lg" | "xl" | "default" | "icon" | null | undefined;
     disabled?: boolean | null | undefined;
     rounded?: boolean | null | undefined;
-    defaultVariants?: "size" | "variant" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 type LoadingVariantProps = VariantProps<typeof loadingVariants>;
 declare const loadingVariants: (props?: ({
@@ -619,7 +822,11 @@ interface ButtonProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>
     type?: ButtonVariantProps['variant'] | React.ButtonHTMLAttributes<HTMLButtonElement>['type'];
     htmlType?: React.ButtonHTMLAttributes<HTMLButtonElement>['type'];
     icon?: React.ReactNode;
+    iconStart?: React.ReactNode;
+    iconEnd?: React.ReactNode;
+    /** @deprecated Use iconStart instead */
     iconLeft?: React.ReactNode;
+    /** @deprecated Use iconEnd instead */
     iconRight?: React.ReactNode;
     isLoading?: boolean;
     /** @deprecated Use `isLoading` instead */
@@ -637,17 +844,17 @@ declare const Separator: React$1.ForwardRefExoticComponent<SeparatorProps & Reac
 declare const buttonGroupVariants: (props?: ({
     orientation?: "horizontal" | "vertical" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
-declare function ButtonGroup({ className, orientation, ...props }: React.ComponentProps<"div"> & VariantProps<typeof buttonGroupVariants>): react_jsx_runtime.JSX.Element;
+declare function ButtonGroup({ className, orientation, ...props }: React$1.ComponentProps<'div'> & VariantProps<typeof buttonGroupVariants>): react_jsx_runtime.JSX.Element;
 declare namespace ButtonGroup {
     var displayName: string;
 }
-declare function ButtonGroupText({ className, asChild, ...props }: React.ComponentProps<"div"> & {
+declare function ButtonGroupText({ className, asChild, ...props }: React$1.ComponentProps<'div'> & {
     asChild?: boolean;
 }): react_jsx_runtime.JSX.Element;
 declare namespace ButtonGroupText {
     var displayName: string;
 }
-declare function ButtonGroupSeparator({ className, orientation, ...props }: React.ComponentProps<typeof Separator>): react_jsx_runtime.JSX.Element;
+declare function ButtonGroupSeparator({ className, orientation, ...props }: React$1.ComponentProps<typeof Separator>): react_jsx_runtime.JSX.Element;
 declare namespace ButtonGroupSeparator {
     var displayName: string;
 }
@@ -663,11 +870,11 @@ declare namespace Calendar {
     var displayName: string;
 }
 
-interface CardProps extends React$1.HTMLAttributes<HTMLDivElement> {
-    /** Visual variant */
-    variant?: "default" | "outlined" | "elevated" | "interactive";
-    /** Content density / padding size */
-    size?: "sm" | "md" | "lg";
+declare const cardVariants: (props?: ({
+    variant?: "default" | "outlined" | "elevated" | "interactive" | "glass" | null | undefined;
+    size?: "sm" | "md" | "lg" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface CardProps extends React$1.HTMLAttributes<HTMLDivElement>, VariantProps<typeof cardVariants> {
 }
 declare const Card: React$1.ForwardRefExoticComponent<CardProps & React$1.RefAttributes<HTMLDivElement>>;
 declare const CardHeader: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & React$1.RefAttributes<HTMLDivElement>>;
@@ -683,18 +890,18 @@ type CarouselPlugin = UseCarouselParameters[1];
 type CarouselProps = {
     opts?: CarouselOptions;
     plugins?: CarouselPlugin;
-    orientation?: "horizontal" | "vertical";
+    orientation?: 'horizontal' | 'vertical';
     setApi?: (api: CarouselApi) => void;
 };
-declare function Carousel({ orientation, opts, setApi, plugins, className, children, dir, ...props }: React$1.ComponentProps<"div"> & CarouselProps): react_jsx_runtime.JSX.Element;
+declare function Carousel({ orientation, opts, setApi, plugins, className, children, dir, ...props }: React$1.ComponentProps<'div'> & CarouselProps): react_jsx_runtime.JSX.Element;
 declare namespace Carousel {
     var displayName: string;
 }
-declare function CarouselContent({ className, ...props }: React$1.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
+declare function CarouselContent({ className, ...props }: React$1.ComponentProps<'div'>): react_jsx_runtime.JSX.Element;
 declare namespace CarouselContent {
     var displayName: string;
 }
-declare function CarouselItem({ className, ...props }: React$1.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
+declare function CarouselItem({ className, ...props }: React$1.ComponentProps<'div'>): react_jsx_runtime.JSX.Element;
 declare namespace CarouselItem {
     var displayName: string;
 }
@@ -707,10 +914,27 @@ declare namespace CarouselNext {
     var displayName: string;
 }
 
-declare function Checkbox({ className, ...props }: React$1.ComponentProps<typeof CheckboxPrimitive.Root>): react_jsx_runtime.JSX.Element;
-declare namespace Checkbox {
-    var displayName: string;
+declare const Checkbox: React$1.ForwardRefExoticComponent<Omit<CheckboxPrimitive.CheckboxProps & React$1.RefAttributes<HTMLButtonElement>, "ref"> & React$1.RefAttributes<HTMLButtonElement>>;
+
+interface CircularProgressProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    /** Progress value 0-100 */
+    value: number;
+    /** Diameter of the circle in px @default 120 */
+    diameter?: number;
+    /** Stroke width in px @default 8 */
+    strokeWidth?: number;
+    /** Color variant */
+    variant?: 'primary' | 'success' | 'warning' | 'destructive';
+    /** Show the numeric value in center @default true */
+    showValue?: boolean;
+    /** Label text below the value (inside circle) */
+    label?: string;
+    /** Locale for number formatting @default "fa" */
+    locale?: SupportedLocale;
+    /** Show loading skeleton */
+    isLoading?: boolean;
 }
+declare const CircularProgress: React$1.ForwardRefExoticComponent<CircularProgressProps & React$1.RefAttributes<HTMLDivElement>>;
 
 declare function Collapsible({ ...props }: React.ComponentProps<typeof CollapsiblePrimitive.Root>): react_jsx_runtime.JSX.Element;
 declare namespace Collapsible {
@@ -728,7 +952,7 @@ declare namespace CollapsibleContent {
 declare const Dialog: React$1.FC<DialogPrimitive.DialogProps>;
 declare const DialogTrigger: React$1.ForwardRefExoticComponent<DialogPrimitive.DialogTriggerProps & React$1.RefAttributes<HTMLButtonElement>>;
 declare const DialogPortal: React$1.FC<DialogPrimitive.DialogPortalProps>;
-declare const DialogClose: React$1.ForwardRefExoticComponent<DialogPrimitive.DialogCloseProps & React$1.RefAttributes<HTMLButtonElement>>;
+declare const DialogClose: React$1.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogCloseProps & React$1.RefAttributes<HTMLButtonElement>, "ref"> & React$1.RefAttributes<HTMLButtonElement>>;
 declare const DialogOverlay: React$1.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogOverlayProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 declare const DialogContent: React$1.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogContentProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 declare const DialogHeader: {
@@ -778,7 +1002,7 @@ declare function CommandItem({ className, ...props }: React$1.ComponentProps<typ
 declare namespace CommandItem {
     var displayName: string;
 }
-declare function CommandShortcut({ className, ...props }: React$1.ComponentProps<"span">): react_jsx_runtime.JSX.Element;
+declare function CommandShortcut({ className, ...props }: React$1.ComponentProps<'span'>): react_jsx_runtime.JSX.Element;
 declare namespace CommandShortcut {
     var displayName: string;
 }
@@ -786,32 +1010,55 @@ declare namespace CommandShortcut {
 interface CommentTag {
     title: string;
     probability: number;
-    color: string;
+    /** CSS var name (e.g. '--chart-1') or hex color. Auto-computed from title if omitted. */
+    color?: string;
 }
-interface CommentCardProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, 'id'> {
-    /**
-     * The comment text content
-     */
+interface CommentCardProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    /** The comment text */
     text: string;
-    /**
-     * Array of analysis tags with probability and color
-     */
+    /** Analysis tags with probability and color */
     tags: CommentTag[];
-    /**
-     * Sentiment of the comment
-     */
-    sentiment: "positive" | "negative" | "neutral";
-    /**
-     * Optional id for the comment
-     */
-    id?: number | string;
-    /**
-     * Show probability in Persian digits
-     */
+    /** Sentiment of the comment */
+    sentiment: 'positive' | 'negative' | 'neutral';
+    /** Locale for number formatting and labels @default "fa" */
+    locale?: SupportedLocale;
+    /** Show loading skeleton state @default false */
+    isLoading?: boolean;
+    /** @deprecated Use `locale` instead */
     usePersianDigits?: boolean;
 }
 declare const CommentCard: React$1.ForwardRefExoticComponent<CommentCardProps & React$1.RefAttributes<HTMLDivElement>>;
 
+interface ConfirmDialogProps {
+    /** The trigger element (button, etc.) */
+    trigger?: React$1.ReactNode;
+    /** Controlled open state */
+    open?: boolean;
+    /** Callback when open state changes */
+    onOpenChange?: (open: boolean) => void;
+    /** Dialog title */
+    title?: string;
+    /** Dialog description */
+    description: string;
+    /** Confirm button text */
+    confirmLabel?: string;
+    /** Cancel button text */
+    cancelLabel?: string;
+    /** Called when confirmed */
+    onConfirm: () => void;
+    /** Visual variant @default "default" */
+    variant?: 'default' | 'destructive';
+    /** Optional icon. Defaults to AlertTriangle for destructive. */
+    icon?: React$1.ReactNode;
+    /** Show icon @default true for destructive, false for default */
+    showIcon?: boolean;
+    /** Locale @default "fa" */
+    locale?: SupportedLocale;
+    /** Additional className for the content */
+    className?: string;
+}
+declare const ConfirmDialog: React$1.ForwardRefExoticComponent<ConfirmDialogProps & React$1.RefAttributes<HTMLDivElement>>;
+
 declare function ContextMenu({ ...props }: React$1.ComponentProps<typeof ContextMenuPrimitive.Root>): react_jsx_runtime.JSX.Element;
 declare namespace ContextMenu {
     var displayName: string;
@@ -880,6 +1127,18 @@ declare namespace ContextMenuShortcut {
     var displayName: string;
 }
 
+interface CopyButtonProps extends Omit<ButtonProps, 'onClick'> {
+    /** The text value to copy to clipboard */
+    value: string;
+    /** Duration in ms to show the "copied" state @default 2000 */
+    feedbackDuration?: number;
+    /** Locale for aria-label and tooltip text @default "fa" */
+    locale?: SupportedLocale;
+    /** Called after successful copy */
+    onCopy?: () => void;
+}
+declare const CopyButton: React$1.ForwardRefExoticComponent<CopyButtonProps & React$1.RefAttributes<HTMLButtonElement>>;
+
 interface DatePickerProps {
     /**
      * The selected date range
@@ -923,10 +1182,7 @@ interface DatePickerProps {
      */
     locale?: SupportedLocale;
 }
-declare function DatePicker({ value, onChange, usePersianCalendar, placeholder, className, disabled, numberOfMonths, showPresets, mode, locale, }: DatePickerProps): react_jsx_runtime.JSX.Element;
-declare namespace DatePicker {
-    var displayName: string;
-}
+declare const DatePicker: React$1.ForwardRefExoticComponent<DatePickerProps & React$1.RefAttributes<HTMLDivElement>>;
 
 interface DateRangePickerProps {
     /**
@@ -972,7 +1228,7 @@ interface DateRangePickerProps {
     /**
      * Show dropdown for year/month selection
      */
-    captionLayout?: "label" | "dropdown" | "dropdown-months" | "dropdown-years";
+    captionLayout?: 'label' | 'dropdown' | 'dropdown-months' | 'dropdown-years';
     /**
      * From year for dropdown (when captionLayout includes dropdown)
      */
@@ -982,14 +1238,12 @@ interface DateRangePickerProps {
      */
     toYear?: number;
 }
-declare function DateRangePicker({ value, onChange, label, placeholder, usePersianCalendar, numberOfMonths, minDate, maxDate, className, disabled, captionLayout, fromYear, toYear, }: DateRangePickerProps): react_jsx_runtime.JSX.Element;
-declare namespace DateRangePicker {
-    var displayName: string;
-}
+declare const DateRangePicker: React$1.ForwardRefExoticComponent<DateRangePickerProps & React$1.RefAttributes<HTMLDivElement>>;
+
 /**
  * Simplified version without label (inline usage)
  */
-declare function DateRangePickerInline({ value, onChange, placeholder, usePersianCalendar, numberOfMonths, minDate, maxDate, className, disabled, captionLayout, fromYear, toYear, }: Omit<DateRangePickerProps, "label">): react_jsx_runtime.JSX.Element;
+declare function DateRangePickerInline({ value, onChange, placeholder, usePersianCalendar, numberOfMonths, minDate, maxDate, className, disabled, captionLayout, fromYear, toYear, }: Omit<DateRangePickerProps, 'label'>): react_jsx_runtime.JSX.Element;
 declare namespace DateRangePickerInline {
     var displayName: string;
 }
@@ -1103,13 +1357,15 @@ declare namespace DropdownMenuSubContent {
     var displayName: string;
 }
 
-declare function Empty({ className, ...props }: React$1.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
-declare namespace Empty {
-    var displayName: string;
+interface EmptyProps extends React$1.ComponentProps<'div'> {
+    /** Minimum height of the empty state container. @default "400px" */
+    minHeight?: string;
 }
+declare const Empty: React$1.ForwardRefExoticComponent<Omit<EmptyProps, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 declare const EmptyIcon: React$1.ForwardRefExoticComponent<Omit<React$1.DetailedHTMLProps<React$1.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 declare const EmptyTitle: React$1.ForwardRefExoticComponent<Omit<React$1.DetailedHTMLProps<React$1.HTMLAttributes<HTMLHeadingElement>, HTMLHeadingElement>, "ref"> & React$1.RefAttributes<HTMLHeadingElement>>;
 declare const EmptyDescription: React$1.ForwardRefExoticComponent<Omit<React$1.DetailedHTMLProps<React$1.HTMLAttributes<HTMLParagraphElement>, HTMLParagraphElement>, "ref"> & React$1.RefAttributes<HTMLParagraphElement>>;
+declare const EmptyAction: React$1.ForwardRefExoticComponent<Omit<React$1.DetailedHTMLProps<React$1.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 
 interface ErrorStateProps extends React$1.HTMLAttributes<HTMLDivElement> {
     /** Error message displayed below the icon */
@@ -1119,7 +1375,7 @@ interface ErrorStateProps extends React$1.HTMLAttributes<HTMLDivElement> {
     /** Retry button label */
     retryLabel?: string;
     /** Size variant controlling padding and icon/text scale */
-    size?: "sm" | "md" | "lg";
+    size?: 'sm' | 'md' | 'lg';
     /** Locale for default strings @default "fa" */
     locale?: SupportedLocale;
 }
@@ -1138,11 +1394,11 @@ declare const FieldGroup: React$1.ForwardRefExoticComponent<Omit<React$1.Detaile
 declare const fieldVariants: (props?: ({
     orientation?: "horizontal" | "vertical" | "responsive" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
-declare function Field({ className, orientation, ...props }: React$1.ComponentProps<"div"> & VariantProps<typeof fieldVariants>): react_jsx_runtime.JSX.Element;
+declare function Field({ className, orientation, ...props }: React$1.ComponentProps<'div'> & VariantProps<typeof fieldVariants>): react_jsx_runtime.JSX.Element;
 declare namespace Field {
     var displayName: string;
 }
-declare function FieldContent({ className, ...props }: React$1.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
+declare function FieldContent({ className, ...props }: React$1.ComponentProps<'div'>): react_jsx_runtime.JSX.Element;
 declare namespace FieldContent {
     var displayName: string;
 }
@@ -1150,21 +1406,18 @@ declare function FieldLabel({ className, ...props }: React$1.ComponentProps<type
 declare namespace FieldLabel {
     var displayName: string;
 }
-declare function FieldTitle({ className, ...props }: React$1.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
-declare namespace FieldTitle {
-    var displayName: string;
-}
-declare function FieldDescription({ className, ...props }: React$1.ComponentProps<"p">): react_jsx_runtime.JSX.Element;
+declare const FieldTitle: React$1.ForwardRefExoticComponent<Omit<React$1.DetailedHTMLProps<React$1.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
+declare function FieldDescription({ className, ...props }: React$1.ComponentProps<'p'>): react_jsx_runtime.JSX.Element;
 declare namespace FieldDescription {
     var displayName: string;
 }
-declare function FieldSeparator({ children, className, ...props }: React$1.ComponentProps<"div"> & {
+declare function FieldSeparator({ children, className, ...props }: React$1.ComponentProps<'div'> & {
     children?: React$1.ReactNode;
 }): react_jsx_runtime.JSX.Element;
 declare namespace FieldSeparator {
     var displayName: string;
 }
-declare function FieldError({ className, children, errors, ...props }: React$1.ComponentProps<"div"> & {
+declare function FieldError({ className, children, errors, ...props }: React$1.ComponentProps<'div'> & {
     errors?: Array<{
         message?: string;
     } | undefined>;
@@ -1173,6 +1426,28 @@ declare namespace FieldError {
     var displayName: string;
 }
 
+interface FilterBarProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    /** Locale @default "fa" */
+    locale?: SupportedLocale;
+}
+declare const FilterBar: React$1.ForwardRefExoticComponent<FilterBarProps & React$1.RefAttributes<HTMLDivElement>>;
+interface FilterBarRowProps extends React$1.HTMLAttributes<HTMLDivElement> {
+}
+declare const FilterBarRow: React$1.ForwardRefExoticComponent<FilterBarRowProps & React$1.RefAttributes<HTMLDivElement>>;
+interface FilterBarActionsProps extends React$1.HTMLAttributes<HTMLDivElement> {
+}
+declare const FilterBarActions: React$1.ForwardRefExoticComponent<FilterBarActionsProps & React$1.RefAttributes<HTMLDivElement>>;
+interface FilterBarClearProps {
+    /** Callback when clear is clicked */
+    onClear: () => void;
+    className?: string;
+    children?: React$1.ReactNode;
+}
+declare const FilterBarClear: React$1.ForwardRefExoticComponent<FilterBarClearProps & React$1.RefAttributes<HTMLButtonElement>>;
+interface FilterBarActiveFiltersProps extends React$1.HTMLAttributes<HTMLDivElement> {
+}
+declare const FilterBarActiveFilters: React$1.ForwardRefExoticComponent<FilterBarActiveFiltersProps & React$1.RefAttributes<HTMLDivElement>>;
+
 declare const Form: <TFieldValues extends FieldValues, TContext = any, TTransformedValues = TFieldValues>(props: react_hook_form.FormProviderProps<TFieldValues, TContext, TTransformedValues>) => React$1.JSX.Element;
 declare const FormField: {
     <TFieldValues extends FieldValues = FieldValues, TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>>({ ...props }: ControllerProps<TFieldValues, TName>): react_jsx_runtime.JSX.Element;
@@ -1224,46 +1499,53 @@ declare namespace HoverCardContent {
     var displayName: string;
 }
 
-interface InputProps extends Omit<React$1.InputHTMLAttributes<HTMLInputElement>, 'size'>, VariantProps<typeof InputVariants> {
-}
+declare const inputVariants: (props?: ({
+    size?: "xs" | "sm" | "md" | "lg" | "xl" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+/** @deprecated Use inputVariants instead */
 declare const InputVariants: (props?: ({
-    size?: "xs" | "sm" | "md" | "lg" | "xl" | "tiny" | "small" | "medium" | "large" | "xlarge" | null | undefined;
+    size?: "xs" | "sm" | "md" | "lg" | "xl" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
+interface InputProps extends Omit<React$1.InputHTMLAttributes<HTMLInputElement>, 'size'>, VariantProps<typeof inputVariants> {
+}
 declare const Input: React$1.ForwardRefExoticComponent<InputProps & React$1.RefAttributes<HTMLInputElement>>;
 
+interface InputWithIconProps extends InputProps {
+    /** Icon rendered at the start (inline-start, respects RTL) */
+    startIcon?: React$1.ReactNode;
+    /** Icon rendered at the end (inline-end) */
+    endIcon?: React$1.ReactNode;
+    /** className for the outer wrapper div (for layout/sizing) */
+    wrapperClassName?: string;
+}
+declare const InputWithIcon: React$1.ForwardRefExoticComponent<InputWithIconProps & React$1.RefAttributes<HTMLInputElement>>;
+
 declare const tagInputVariants: (props?: ({
     variant?: "default" | "secondary" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
-interface TagInputProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, "onChange" | "defaultValue">, VariantProps<typeof tagInputVariants> {
+interface TagInputProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, 'onChange' | 'defaultValue'>, VariantProps<typeof tagInputVariants> {
     value?: string[];
     defaultValue?: string[];
     onChange?: (value: string[]) => void;
     placeholder?: string;
     disabled?: boolean;
     maxTags?: number;
+    /** Optional prefix shown on each tag badge (e.g. "#" for hashtags). Value is stored WITHOUT the prefix. */
+    prefix?: string;
+    /** Locale for sr-only remove label @default "fa" */
+    locale?: SupportedLocale;
 }
 declare const TagInput: React$1.ForwardRefExoticComponent<TagInputProps & React$1.RefAttributes<HTMLDivElement>>;
 
-declare const hashtagInputVariants: (props?: ({
-    variant?: "default" | "secondary" | null | undefined;
-} & class_variance_authority_types.ClassProp) | undefined) => string;
-interface HashtagInputProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, "onChange" | "defaultValue">, VariantProps<typeof hashtagInputVariants> {
-    value?: string[];
-    defaultValue?: string[];
-    onChange?: (value: string[]) => void;
-    placeholder?: string;
-    disabled?: boolean;
-    maxTags?: number;
-}
-declare const HashtagInput: React$1.ForwardRefExoticComponent<HashtagInputProps & React$1.RefAttributes<HTMLDivElement>>;
+declare const HashtagInput: React$1.ForwardRefExoticComponent<TagInputProps & React$1.RefAttributes<HTMLDivElement>>;
 
-interface InputGroupProps extends React$1.ComponentProps<"div"> {
+interface InputGroupProps extends React$1.ComponentProps<'div'> {
     /**
      * Direction of the input group.
      * Use "ltr" for URL, email, tel, or other LTR-only content.
      * @default undefined (inherits from parent)
      */
-    dir?: "ltr" | "rtl";
+    dir?: 'ltr' | 'rtl';
 }
 declare function InputGroup({ className, dir, ...props }: InputGroupProps): react_jsx_runtime.JSX.Element;
 declare namespace InputGroup {
@@ -1272,18 +1554,18 @@ declare namespace InputGroup {
 declare const inputGroupAddonVariants: (props?: ({
     align?: "inline-end" | "inline-start" | "block-end" | "block-start" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
-declare function InputGroupAddon({ className, align, ...props }: React$1.ComponentProps<"div"> & VariantProps<typeof inputGroupAddonVariants>): react_jsx_runtime.JSX.Element;
+declare function InputGroupAddon({ className, align, ...props }: React$1.ComponentProps<'div'> & VariantProps<typeof inputGroupAddonVariants>): react_jsx_runtime.JSX.Element;
 declare namespace InputGroupAddon {
     var displayName: string;
 }
 declare const inputGroupButtonVariants: (props?: ({
     size?: "xs" | "sm" | "icon-xs" | "icon-sm" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
-declare function InputGroupButton({ className, type, variant, size, ...props }: Omit<React$1.ComponentProps<typeof Button>, "size"> & VariantProps<typeof inputGroupButtonVariants>): react_jsx_runtime.JSX.Element;
+declare function InputGroupButton({ className, type, variant, size, ...props }: Omit<React$1.ComponentProps<typeof Button>, 'size'> & VariantProps<typeof inputGroupButtonVariants>): react_jsx_runtime.JSX.Element;
 declare namespace InputGroupButton {
     var displayName: string;
 }
-declare function InputGroupText({ className, ...props }: React$1.ComponentProps<"span">): react_jsx_runtime.JSX.Element;
+declare function InputGroupText({ className, ...props }: React$1.ComponentProps<'span'>): react_jsx_runtime.JSX.Element;
 declare namespace InputGroupText {
     var displayName: string;
 }
@@ -1291,7 +1573,7 @@ declare function InputGroupInput({ className, type, size, dir: dirProp, ...props
 declare namespace InputGroupInput {
     var displayName: string;
 }
-declare function InputGroupTextarea({ className, ...props }: React$1.ComponentProps<"textarea">): react_jsx_runtime.JSX.Element;
+declare function InputGroupTextarea({ className, ...props }: React$1.ComponentProps<'textarea'>): react_jsx_runtime.JSX.Element;
 declare namespace InputGroupTextarea {
     var displayName: string;
 }
@@ -1302,25 +1584,25 @@ declare function InputOTP({ className, containerClassName, dir, ...props }: Reac
 declare namespace InputOTP {
     var displayName: string;
 }
-declare function InputOTPGroup({ className, ...props }: React$1.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
+declare function InputOTPGroup({ className, ...props }: React$1.ComponentProps<'div'>): react_jsx_runtime.JSX.Element;
 declare namespace InputOTPGroup {
     var displayName: string;
 }
-declare function InputOTPSlot({ index, className, ...props }: React$1.ComponentProps<"div"> & {
+declare function InputOTPSlot({ index, className, ...props }: React$1.ComponentProps<'div'> & {
     index: number;
 }): react_jsx_runtime.JSX.Element;
 declare namespace InputOTPSlot {
     var displayName: string;
 }
-declare function InputOTPSeparator({ ...props }: React$1.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
+declare function InputOTPSeparator({ ...props }: React$1.ComponentProps<'div'>): react_jsx_runtime.JSX.Element;
 declare namespace InputOTPSeparator {
     var displayName: string;
 }
 
-type MediaType = "image" | "video" | "carousel";
-type AspectRatioType = "16:9" | "9:16" | "1:1" | "4:5" | "5:4";
+type MediaType = 'image' | 'video' | 'carousel';
+type AspectRatioType = '16:9' | '9:16' | '1:1' | '4:5' | '5:4';
 interface MediaItem {
-    type: "image" | "video";
+    type: 'image' | 'video';
     url: string;
     aspectRatio?: AspectRatioType;
 }
@@ -1330,8 +1612,8 @@ interface PostStats {
     views?: number;
     shares?: number;
 }
-type NumberFormat = "exact" | "short";
-type TimeFormat = "absolute" | "relative";
+type NumberFormat = 'exact' | 'short';
+type TimeFormat = 'absolute' | 'relative';
 interface InstagramProfileInfo {
     username: string;
     fullName?: string;
@@ -1339,10 +1621,10 @@ interface InstagramProfileInfo {
     avatarUrl?: string;
 }
 interface InstagramPostProps extends React$1.HTMLAttributes<HTMLDivElement>, VariantProps<typeof instagramPostVariants> {
-    dir?: "rtl" | "ltr";
+    dir?: 'rtl' | 'ltr';
     media?: MediaItem[];
     mediaType?: MediaType;
-    postType?: 0 | 1 | 2;
+    postType?: 'image' | 'video' | 'carousel';
     caption?: string;
     showCaption?: boolean;
     stats?: PostStats;
@@ -1357,6 +1639,8 @@ interface InstagramPostProps extends React$1.HTMLAttributes<HTMLDivElement>, Var
     showProfile?: boolean;
     avatarUrl?: string;
     showActions?: boolean;
+    /** Show loading skeleton state */
+    isLoading?: boolean;
     onCommentAnalyzer?: () => void;
     onBooster?: () => void;
     onAIAnalysis?: () => void;
@@ -1367,6 +1651,8 @@ interface InstagramPostProps extends React$1.HTMLAttributes<HTMLDivElement>, Var
     disableAIAnalysis?: boolean;
     disableOpenInstagram?: boolean;
     placeholderText?: string;
+    /** Locale for UI strings @default 'fa' */
+    locale?: SupportedLocale;
     /** Text for "show more" button @default "بیشتر" */
     showMoreText?: string;
     /** Text for "show less" button @default "کمتر" */
@@ -1377,26 +1663,11 @@ declare const instagramPostVariants: (props?: ({
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 declare const InstagramPost: React$1.ForwardRefExoticComponent<InstagramPostProps & React$1.RefAttributes<HTMLDivElement>>;
 
-interface ItemProps extends React$1.HTMLAttributes<HTMLDivElement> {
-    /** Render as child element */
-    asChild?: boolean;
-}
-declare const Item: React$1.ForwardRefExoticComponent<ItemProps & React$1.RefAttributes<HTMLDivElement>>;
-declare const ItemMedia: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & React$1.RefAttributes<HTMLDivElement>>;
-declare const ItemContent: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & React$1.RefAttributes<HTMLDivElement>>;
-declare const ItemTitle: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLParagraphElement> & React$1.RefAttributes<HTMLParagraphElement>>;
-declare const ItemDescription: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLParagraphElement> & React$1.RefAttributes<HTMLParagraphElement>>;
-interface ItemGroupProps extends React$1.HTMLAttributes<HTMLDivElement> {
-    /** Section label rendered above the group */
-    label?: string;
-}
-declare const ItemGroup: React$1.ForwardRefExoticComponent<ItemGroupProps & React$1.RefAttributes<HTMLDivElement>>;
-
-declare function Kbd({ className, ...props }: React$1.ComponentProps<"kbd">): react_jsx_runtime.JSX.Element;
+declare function Kbd({ className, ...props }: React$1.ComponentProps<'kbd'>): react_jsx_runtime.JSX.Element;
 declare namespace Kbd {
     var displayName: string;
 }
-declare function KbdGroup({ className, ...props }: React$1.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
+declare function KbdGroup({ className, ...props }: React$1.ComponentProps<'span'>): react_jsx_runtime.JSX.Element;
 declare namespace KbdGroup {
     var displayName: string;
 }
@@ -1431,7 +1702,7 @@ declare namespace MenubarContent {
 }
 declare function MenubarItem({ className, inset, variant, ...props }: React$1.ComponentProps<typeof MenubarPrimitive.Item> & {
     inset?: boolean;
-    variant?: "default" | "destructive";
+    variant?: 'default' | 'destructive';
 }): react_jsx_runtime.JSX.Element;
 declare namespace MenubarItem {
     var displayName: string;
@@ -1454,7 +1725,7 @@ declare function MenubarSeparator({ className, ...props }: React$1.ComponentProp
 declare namespace MenubarSeparator {
     var displayName: string;
 }
-declare function MenubarShortcut({ className, ...props }: React$1.ComponentProps<"span">): react_jsx_runtime.JSX.Element;
+declare function MenubarShortcut({ className, ...props }: React$1.ComponentProps<'span'>): react_jsx_runtime.JSX.Element;
 declare namespace MenubarShortcut {
     var displayName: string;
 }
@@ -1496,10 +1767,9 @@ interface MetricCardLabelProps extends React$1.HTMLAttributes<HTMLHeadingElement
     icon?: React$1.ReactNode;
 }
 interface MetricCardDifferentialProps extends React$1.HTMLAttributes<HTMLDivElement> {
-    /**
-     * Variant determines color: positive (green) or negative (red)
-     */
-    variant?: "positive" | "negative";
+    variant?: 'positive' | 'negative';
+    /** Optional sign to display ("+", "-"). Rendered after the value, dir=ltr. */
+    sign?: '+' | '-';
 }
 interface MetricCardSparklineProps {
     /**
@@ -1536,15 +1806,12 @@ declare const MetricCardValue: React$1.ForwardRefExoticComponent<React$1.HTMLAtt
 declare const MetricCardDifferential: React$1.ForwardRefExoticComponent<MetricCardDifferentialProps & React$1.RefAttributes<HTMLDivElement>>;
 declare const MetricCardSparkline: React$1.ForwardRefExoticComponent<MetricCardSparklineProps & React$1.RefAttributes<HTMLDivElement>>;
 
-declare function NativeSelect({ className, ...props }: React$1.ComponentProps<"select">): react_jsx_runtime.JSX.Element;
-declare namespace NativeSelect {
-    var displayName: string;
-}
-declare function NativeSelectOption({ ...props }: React$1.ComponentProps<"option">): react_jsx_runtime.JSX.Element;
+declare const NativeSelect: React$1.ForwardRefExoticComponent<Omit<React$1.DetailedHTMLProps<React$1.SelectHTMLAttributes<HTMLSelectElement>, HTMLSelectElement>, "ref"> & React$1.RefAttributes<HTMLSelectElement>>;
+declare function NativeSelectOption({ ...props }: React$1.ComponentProps<'option'>): react_jsx_runtime.JSX.Element;
 declare namespace NativeSelectOption {
     var displayName: string;
 }
-declare function NativeSelectOptGroup({ className, ...props }: React$1.ComponentProps<"optgroup">): react_jsx_runtime.JSX.Element;
+declare function NativeSelectOptGroup({ className, ...props }: React$1.ComponentProps<'optgroup'>): react_jsx_runtime.JSX.Element;
 declare namespace NativeSelectOptGroup {
     var displayName: string;
 }
@@ -1585,21 +1852,37 @@ declare namespace NavigationMenuIndicator {
     var displayName: string;
 }
 
-declare function Pagination({ className, dir, children, ...props }: React$1.ComponentProps<"nav">): react_jsx_runtime.JSX.Element;
+interface PageHeaderProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    /** Page title */
+    title: string;
+    /** Optional description below title */
+    description?: string;
+    /** Back button callback. When provided, shows a back arrow. */
+    onBack?: () => void;
+    /** Actions slot (buttons, etc.) rendered at inline-end */
+    actions?: React$1.ReactNode;
+    /** Breadcrumb slot rendered above the title */
+    breadcrumbs?: React$1.ReactNode;
+    /** Locale @default "fa" */
+    locale?: SupportedLocale;
+}
+declare const PageHeader: React$1.ForwardRefExoticComponent<PageHeaderProps & React$1.RefAttributes<HTMLDivElement>>;
+
+declare function Pagination({ className, dir, children, ...props }: React$1.ComponentProps<'nav'>): react_jsx_runtime.JSX.Element;
 declare namespace Pagination {
     var displayName: string;
 }
-declare function PaginationContent({ className, ...props }: React$1.ComponentProps<"ul">): react_jsx_runtime.JSX.Element;
+declare function PaginationContent({ className, ...props }: React$1.ComponentProps<'ul'>): react_jsx_runtime.JSX.Element;
 declare namespace PaginationContent {
     var displayName: string;
 }
-declare function PaginationItem({ ...props }: React$1.ComponentProps<"li">): react_jsx_runtime.JSX.Element;
+declare function PaginationItem({ ...props }: React$1.ComponentProps<'li'>): react_jsx_runtime.JSX.Element;
 declare namespace PaginationItem {
     var displayName: string;
 }
 type PaginationLinkProps = {
     isActive?: boolean;
-} & Pick<React$1.ComponentProps<typeof Button>, "size"> & React$1.ComponentProps<"a">;
+} & Pick<React$1.ComponentProps<typeof Button>, 'size'> & React$1.ComponentProps<'a'>;
 declare function PaginationLink({ className, isActive, size, dir, ...props }: PaginationLinkProps): react_jsx_runtime.JSX.Element;
 declare namespace PaginationLink {
     var displayName: string;
@@ -1612,7 +1895,7 @@ declare function PaginationNext({ className, ...props }: React$1.ComponentProps<
 declare namespace PaginationNext {
     var displayName: string;
 }
-declare function PaginationEllipsis({ className, ...props }: React$1.ComponentProps<"span">): react_jsx_runtime.JSX.Element;
+declare function PaginationEllipsis({ className, ...props }: React$1.ComponentProps<'span'>): react_jsx_runtime.JSX.Element;
 declare namespace PaginationEllipsis {
     var displayName: string;
 }
@@ -1655,9 +1938,10 @@ interface PaginationControlledProps {
      */
     className?: string;
     /**
-     * جهت متن (rtl/ltr)
+     * زبان برای تبدیل اعداد و جهت متن
+     * @default "fa"
      */
-    dir?: "rtl" | "ltr";
+    locale?: SupportedLocale;
 }
 /**
  * کامپوننت صفحه‌بندی با props استاندارد
@@ -1671,16 +1955,17 @@ interface PaginationControlledProps {
  * />
  * ```
  */
-declare function PaginationControlled({ currentPage, totalPages, onPageChange, siblingCount, showFirstLast, showPrevNext, showEllipsis, className, dir, }: PaginationControlledProps): react_jsx_runtime.JSX.Element;
-declare namespace PaginationControlled {
-    var displayName: string;
-}
+declare const PaginationControlled: React$1.ForwardRefExoticComponent<PaginationControlledProps & React$1.RefAttributes<HTMLElement>>;
 
 declare const Popover: React$1.FC<PopoverPrimitive.PopoverProps>;
 declare const PopoverTrigger: React$1.ForwardRefExoticComponent<PopoverPrimitive.PopoverTriggerProps & React$1.RefAttributes<HTMLButtonElement>>;
 declare const PopoverAnchor: React$1.ForwardRefExoticComponent<PopoverPrimitive.PopoverAnchorProps & React$1.RefAttributes<HTMLDivElement>>;
 declare const PopoverContent: React$1.ForwardRefExoticComponent<Omit<PopoverPrimitive.PopoverContentProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 
+declare const profileCardVariants: (props?: ({
+    variant?: "default" | "transparent" | "dark" | null | undefined;
+    size?: "sm" | "md" | "lg" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
 interface ProfileCardProps extends React$1.HTMLAttributes<HTMLDivElement> {
     /**
      * نام کامل کاربر
@@ -1717,15 +2002,15 @@ interface ProfileCardProps extends React$1.HTMLAttributes<HTMLDivElement> {
     /**
      * استایل حاشیه آواتار
      */
-    avatarBorderVariant?: "gold" | "primary" | "none";
+    avatarBorderVariant?: 'gold' | 'primary' | 'none';
     /**
      * اندازه کامپوننت
      */
-    size?: "sm" | "md" | "lg";
+    size?: 'sm' | 'md' | 'lg';
     /**
      * رنگ پس‌زمینه
      */
-    variant?: "default" | "dark" | "transparent";
+    variant?: 'default' | 'dark' | 'transparent';
     /**
      * نمایش حالت بارگذاری
      * Show loading skeleton state
@@ -1778,15 +2063,15 @@ interface ProfileInfoProps extends React$1.HTMLAttributes<HTMLDivElement> {
     /**
      * استایل حاشیه آواتار
      */
-    avatarBorderVariant?: "gold" | "primary" | "none";
+    avatarBorderVariant?: 'gold' | 'primary' | 'none';
     /**
      * اندازه کامپوننت
      */
-    size?: "sm" | "md" | "lg";
+    size?: 'sm' | 'md' | 'lg';
     /**
      * رنگ پس‌زمینه
      */
-    variant?: "default" | "dark" | "transparent";
+    variant?: 'default' | 'dark' | 'transparent';
     /**
      * Locale for default strings
      * @default "fa"
@@ -1868,22 +2153,13 @@ interface ProgressProps extends React$1.ComponentProps<typeof ProgressPrimitive.
     label?: string;
     showValue?: boolean;
 }
-declare function Progress({ className, value, size, variant, label, showValue, ...props }: ProgressProps): react_jsx_runtime.JSX.Element;
-declare namespace Progress {
-    var displayName: string;
-}
+declare const Progress: React$1.ForwardRefExoticComponent<Omit<ProgressProps, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 
-declare function RadioGroup({ className, ...props }: React$1.ComponentProps<typeof RadioGroupPrimitive.Root>): react_jsx_runtime.JSX.Element;
-declare namespace RadioGroup {
-    var displayName: string;
-}
-declare function RadioGroupItem({ className, ...props }: React$1.ComponentProps<typeof RadioGroupPrimitive.Item>): react_jsx_runtime.JSX.Element;
-declare namespace RadioGroupItem {
-    var displayName: string;
-}
+declare const RadioGroup: React$1.ForwardRefExoticComponent<Omit<RadioGroupPrimitive.RadioGroupProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
+declare const RadioGroupItem: React$1.ForwardRefExoticComponent<Omit<RadioGroupPrimitive.RadioGroupItemProps & React$1.RefAttributes<HTMLButtonElement>, "ref"> & React$1.RefAttributes<HTMLButtonElement>>;
 
 declare const RadioCards: React$1.ForwardRefExoticComponent<Omit<RadioGroupPrimitive.RadioGroupProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & {
-    columns?: number | Record<string, number>;
+    columns?: number;
     dir?: "rtl" | "ltr";
 } & React$1.RefAttributes<HTMLDivElement>>;
 declare const RadioCardItem: React$1.ForwardRefExoticComponent<Omit<RadioGroupPrimitive.RadioGroupItemProps & React$1.RefAttributes<HTMLButtonElement>, "ref"> & React$1.RefAttributes<HTMLButtonElement>>;
@@ -1917,10 +2193,14 @@ declare namespace ScrollBar {
 declare const Select: React$1.FC<SelectPrimitive.SelectProps>;
 declare const SelectGroup: React$1.ForwardRefExoticComponent<SelectPrimitive.SelectGroupProps & React$1.RefAttributes<HTMLDivElement>>;
 declare const SelectValue: React$1.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectValueProps & React$1.RefAttributes<HTMLSpanElement>, "ref"> & VariantProps<(props?: ({
-    size?: "xs" | "sm" | "md" | "lg" | "xl" | "tiny" | "small" | "medium" | "large" | "xlarge" | null | undefined;
+    size?: "xs" | "sm" | "md" | "lg" | "xl" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string> & React$1.RefAttributes<HTMLSpanElement>>;
+/** @deprecated Use selectTriggerVariants instead */
+declare const SelectTriggerVariants: (props?: ({
+    size?: "xs" | "sm" | "md" | "lg" | "xl" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
 declare const SelectTrigger: React$1.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectTriggerProps & React$1.RefAttributes<HTMLButtonElement>, "ref"> & VariantProps<(props?: ({
-    size?: "xs" | "sm" | "md" | "lg" | "xl" | "tiny" | "small" | "medium" | "large" | "xlarge" | null | undefined;
+    size?: "xs" | "sm" | "md" | "lg" | "xl" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string> & React$1.RefAttributes<HTMLButtonElement>>;
 declare const SelectScrollUpButton: React$1.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectScrollUpButtonProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 declare const SelectScrollDownButton: React$1.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectScrollDownButtonProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
@@ -1942,16 +2222,20 @@ declare namespace SheetClose {
     var displayName: string;
 }
 declare function SheetContent({ className, children, side, ...props }: React$1.ComponentProps<typeof DialogPrimitive.Content> & {
-    side?: "top" | "right" | "bottom" | "left";
+    side?: 'top' | 'right' | 'bottom' | 'left';
 }): react_jsx_runtime.JSX.Element;
 declare namespace SheetContent {
     var displayName: string;
 }
-declare function SheetHeader({ className, ...props }: React$1.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
+declare function SheetHeader({ className, ...props }: React$1.ComponentProps<'div'>): react_jsx_runtime.JSX.Element;
 declare namespace SheetHeader {
     var displayName: string;
 }
-declare function SheetFooter({ className, ...props }: React$1.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
+declare function SheetBody({ className, ...props }: React$1.ComponentProps<'div'>): react_jsx_runtime.JSX.Element;
+declare namespace SheetBody {
+    var displayName: string;
+}
+declare function SheetFooter({ className, ...props }: React$1.ComponentProps<'div'>): react_jsx_runtime.JSX.Element;
 declare namespace SheetFooter {
     var displayName: string;
 }
@@ -1969,16 +2253,16 @@ declare const Tooltip: React$1.FC<TooltipPrimitive.TooltipProps>;
 declare const TooltipTrigger: React$1.ForwardRefExoticComponent<TooltipPrimitive.TooltipTriggerProps & React$1.RefAttributes<HTMLButtonElement>>;
 interface TooltipContentProps extends React$1.ComponentPropsWithoutRef<typeof TooltipPrimitive.Content> {
     /** Visual variant */
-    variant?: "default" | "light" | "error";
+    variant?: 'default' | 'light' | 'error';
     /** Size */
-    size?: "sm" | "md";
+    size?: 'sm' | 'md';
     /** Show arrow/caret pointing to trigger */
     showArrow?: boolean;
 }
 declare const TooltipContent: React$1.ForwardRefExoticComponent<TooltipContentProps & React$1.RefAttributes<HTMLDivElement>>;
 
 type SidebarContextProps = {
-    state: "expanded" | "collapsed";
+    state: 'expanded' | 'collapsed';
     open: boolean;
     setOpen: (open: boolean) => void;
     openMobile: boolean;
@@ -1987,59 +2271,108 @@ type SidebarContextProps = {
     toggleSidebar: () => void;
 };
 declare function useSidebar(): SidebarContextProps;
-declare function SidebarProvider({ defaultOpen, open: openProp, onOpenChange: setOpenProp, className, style, children, ...props }: React$1.ComponentProps<"div"> & {
+declare function SidebarProvider({ defaultOpen, open: openProp, onOpenChange: setOpenProp, className, style, children, ...props }: React$1.ComponentProps<'div'> & {
     defaultOpen?: boolean;
     open?: boolean;
     onOpenChange?: (open: boolean) => void;
 }): react_jsx_runtime.JSX.Element;
-declare function Sidebar({ side, variant, collapsible, className, children, ...props }: React$1.ComponentProps<"div"> & {
-    side?: "left" | "right";
-    variant?: "sidebar" | "floating" | "inset";
-    collapsible?: "offcanvas" | "icon" | "none";
+declare function Sidebar({ side, variant, collapsible, className, children, ...props }: React$1.ComponentProps<'div'> & {
+    side?: 'left' | 'right';
+    variant?: 'sidebar' | 'floating' | 'inset';
+    collapsible?: 'offcanvas' | 'icon' | 'none';
 }): react_jsx_runtime.JSX.Element;
 declare function SidebarTrigger({ className, onClick, ...props }: React$1.ComponentProps<typeof Button>): react_jsx_runtime.JSX.Element;
-declare function SidebarRail({ className, ...props }: React$1.ComponentProps<"button">): react_jsx_runtime.JSX.Element;
-declare function SidebarInset({ className, ...props }: React$1.ComponentProps<"main">): react_jsx_runtime.JSX.Element;
+declare function SidebarRail({ className, ...props }: React$1.ComponentProps<'button'>): react_jsx_runtime.JSX.Element;
+declare function SidebarInset({ className, ...props }: React$1.ComponentProps<'main'>): react_jsx_runtime.JSX.Element;
 declare function SidebarInput({ className, ...props }: React$1.ComponentProps<typeof Input>): react_jsx_runtime.JSX.Element;
-declare function SidebarHeader({ className, ...props }: React$1.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
-declare function SidebarFooter({ className, ...props }: React$1.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
+declare function SidebarHeader({ className, ...props }: React$1.ComponentProps<'div'>): react_jsx_runtime.JSX.Element;
+declare function SidebarFooter({ className, ...props }: React$1.ComponentProps<'div'>): react_jsx_runtime.JSX.Element;
 declare function SidebarSeparator({ className, ...props }: React$1.ComponentProps<typeof Separator>): react_jsx_runtime.JSX.Element;
-declare function SidebarContent({ className, ...props }: React$1.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
-declare function SidebarGroup({ className, ...props }: React$1.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
-declare function SidebarGroupLabel({ className, asChild, ...props }: React$1.ComponentProps<"div"> & {
+declare function SidebarContent({ className, ...props }: React$1.ComponentProps<'div'>): react_jsx_runtime.JSX.Element;
+declare function SidebarGroup({ className, ...props }: React$1.ComponentProps<'div'>): react_jsx_runtime.JSX.Element;
+declare function SidebarGroupLabel({ className, asChild, ...props }: React$1.ComponentProps<'div'> & {
     asChild?: boolean;
 }): react_jsx_runtime.JSX.Element;
-declare function SidebarGroupAction({ className, asChild, ...props }: React$1.ComponentProps<"button"> & {
+declare function SidebarGroupAction({ className, asChild, ...props }: React$1.ComponentProps<'button'> & {
     asChild?: boolean;
 }): react_jsx_runtime.JSX.Element;
-declare function SidebarGroupContent({ className, ...props }: React$1.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
-declare function SidebarMenu({ className, ...props }: React$1.ComponentProps<"ul">): react_jsx_runtime.JSX.Element;
-declare function SidebarMenuItem({ className, ...props }: React$1.ComponentProps<"li">): react_jsx_runtime.JSX.Element;
+declare function SidebarGroupContent({ className, ...props }: React$1.ComponentProps<'div'>): react_jsx_runtime.JSX.Element;
+declare function SidebarMenu({ className, ...props }: React$1.ComponentProps<'ul'>): react_jsx_runtime.JSX.Element;
+declare function SidebarMenuItem({ className, ...props }: React$1.ComponentProps<'li'>): react_jsx_runtime.JSX.Element;
 declare const sidebarMenuButtonVariants: (props?: ({
     variant?: "default" | "outline" | null | undefined;
     size?: "sm" | "lg" | "default" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
-declare function SidebarMenuButton({ asChild, isActive, variant, size, tooltip, className, ...props }: React$1.ComponentProps<"button"> & {
+declare function SidebarMenuButton({ asChild, isActive, variant, size, tooltip, className, ...props }: React$1.ComponentProps<'button'> & {
     asChild?: boolean;
     isActive?: boolean;
     tooltip?: string | React$1.ComponentProps<typeof TooltipContent>;
 } & VariantProps<typeof sidebarMenuButtonVariants>): react_jsx_runtime.JSX.Element;
-declare function SidebarMenuAction({ className, asChild, showOnHover, ...props }: React$1.ComponentProps<"button"> & {
+declare function SidebarMenuAction({ className, asChild, showOnHover, ...props }: React$1.ComponentProps<'button'> & {
     asChild?: boolean;
     showOnHover?: boolean;
 }): react_jsx_runtime.JSX.Element;
-declare function SidebarMenuBadge({ className, ...props }: React$1.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
-declare function SidebarMenuSkeleton({ className, showIcon, ...props }: React$1.ComponentProps<"div"> & {
+declare function SidebarMenuBadge({ className, ...props }: React$1.ComponentProps<'div'>): react_jsx_runtime.JSX.Element;
+declare function SidebarMenuSkeleton({ className, showIcon, ...props }: React$1.ComponentProps<'div'> & {
     showIcon?: boolean;
 }): react_jsx_runtime.JSX.Element;
-declare function SidebarMenuSub({ className, ...props }: React$1.ComponentProps<"ul">): react_jsx_runtime.JSX.Element;
-declare function SidebarMenuSubItem({ className, ...props }: React$1.ComponentProps<"li">): react_jsx_runtime.JSX.Element;
-declare function SidebarMenuSubButton({ asChild, size, isActive, className, ...props }: React$1.ComponentProps<"a"> & {
+declare function SidebarMenuSub({ className, ...props }: React$1.ComponentProps<'ul'>): react_jsx_runtime.JSX.Element;
+declare function SidebarMenuSubItem({ className, ...props }: React$1.ComponentProps<'li'>): react_jsx_runtime.JSX.Element;
+declare function SidebarMenuSubButton({ asChild, size, isActive, className, ...props }: React$1.ComponentProps<'a'> & {
     asChild?: boolean;
-    size?: "sm" | "md";
+    size?: 'sm' | 'md';
     isActive?: boolean;
 }): react_jsx_runtime.JSX.Element;
 
+type NavRailContextProps = {
+    activeItem: string | null;
+    setActiveItem: (id: string | null) => void;
+    panelOpen: boolean;
+    setPanelOpen: (open: boolean) => void;
+    togglePanel: (itemId: string) => void;
+    openMobile: boolean;
+    setOpenMobile: (open: boolean) => void;
+    isMobile: boolean;
+};
+declare function useNavRail(): NavRailContextProps;
+declare function NavRailProvider({ defaultActiveItem, activeItem: activeItemProp, onActiveItemChange, defaultPanelOpen, panelOpen: panelOpenProp, onPanelOpenChange, className, style, children, ...props }: React$1.ComponentProps<'div'> & {
+    defaultActiveItem?: string | null;
+    activeItem?: string | null;
+    onActiveItemChange?: (id: string | null) => void;
+    defaultPanelOpen?: boolean;
+    panelOpen?: boolean;
+    onPanelOpenChange?: (open: boolean) => void;
+}): react_jsx_runtime.JSX.Element;
+declare namespace NavRailProvider {
+    var displayName: string;
+}
+declare const NavRail: React$1.ForwardRefExoticComponent<Omit<React$1.ClassAttributes<HTMLElement> & React$1.HTMLAttributes<HTMLElement> & {
+    side?: "start" | "end";
+}, "ref"> & React$1.RefAttributes<HTMLElement>>;
+declare const NavRailHeader: React$1.ForwardRefExoticComponent<Omit<React$1.DetailedHTMLProps<React$1.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
+declare const NavRailFooter: React$1.ForwardRefExoticComponent<Omit<React$1.DetailedHTMLProps<React$1.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
+declare const NavRailItem: React$1.ForwardRefExoticComponent<Omit<React$1.ClassAttributes<HTMLButtonElement> & React$1.ButtonHTMLAttributes<HTMLButtonElement> & {
+    itemId: string;
+    icon: React$1.ReactNode;
+    label: string;
+    isActive?: boolean;
+    asChild?: boolean;
+}, "ref"> & React$1.RefAttributes<HTMLButtonElement>>;
+declare const NavRailContent: React$1.ForwardRefExoticComponent<Omit<React$1.DetailedHTMLProps<React$1.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
+declare const NavRailSeparator: React$1.ForwardRefExoticComponent<Omit<React$1.DetailedHTMLProps<React$1.HTMLAttributes<HTMLHRElement>, HTMLHRElement>, "ref"> & React$1.RefAttributes<HTMLHRElement>>;
+declare const NavPanel: React$1.ForwardRefExoticComponent<Omit<React$1.ClassAttributes<HTMLElement> & React$1.HTMLAttributes<HTMLElement> & {
+    forItem: string;
+}, "ref"> & React$1.RefAttributes<HTMLElement>>;
+declare const NavPanelHeader: React$1.ForwardRefExoticComponent<Omit<React$1.ClassAttributes<HTMLDivElement> & React$1.HTMLAttributes<HTMLDivElement> & {
+    title?: string;
+    showClose?: boolean;
+}, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
+declare const NavPanelContent: React$1.ForwardRefExoticComponent<Omit<React$1.DetailedHTMLProps<React$1.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
+declare const NavPanelFooter: React$1.ForwardRefExoticComponent<Omit<React$1.DetailedHTMLProps<React$1.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
+declare const AppLayout: React$1.ForwardRefExoticComponent<Omit<React$1.DetailedHTMLProps<React$1.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
+declare const AppLayoutContent: React$1.ForwardRefExoticComponent<Omit<React$1.DetailedHTMLProps<React$1.HTMLAttributes<HTMLElement>, HTMLElement>, "ref"> & React$1.RefAttributes<HTMLElement>>;
+declare const NavRailTrigger: React$1.ForwardRefExoticComponent<Omit<ButtonProps & React$1.RefAttributes<HTMLButtonElement>, "ref"> & React$1.RefAttributes<HTMLButtonElement>>;
+
 declare const skeletonVariants: (props?: ({
     shape?: "circle" | "rect" | "line" | "text" | null | undefined;
     size?: "sm" | "md" | "lg" | null | undefined;
@@ -2062,10 +2395,10 @@ declare function MetricCardSkeleton({ className }: MetricCardSkeletonProps): rea
 declare namespace MetricCardSkeleton {
     var displayName: string;
 }
-interface ChartSkeletonProps {
+interface ChartSkeletonProps$1 {
     className?: string;
 }
-declare function ChartSkeleton({ className }: ChartSkeletonProps): react_jsx_runtime.JSX.Element;
+declare function ChartSkeleton({ className }: ChartSkeletonProps$1): react_jsx_runtime.JSX.Element;
 declare namespace ChartSkeleton {
     var displayName: string;
 }
@@ -2083,23 +2416,20 @@ declare namespace Slider {
     var displayName: string;
 }
 
-declare const SONNER_DEFAULT_DURATION = 4000;
-interface PartoToasterProps extends ToasterProps {
-    /**
-     * Override the theme directly instead of reading from next-themes.
-     * Useful for non-Next.js consumers.
-     */
-    theme?: ToasterProps["theme"];
-}
+type PartoToasterProps = ToasterProps;
 declare const Toaster: {
-    ({ dir, position, closeButton, theme: themeProp, toastOptions, ...props }: PartoToasterProps): react_jsx_runtime.JSX.Element;
+    ({ className, ...props }: PartoToasterProps): react_jsx_runtime.JSX.Element;
     displayName: string;
 };
 
-declare function Spinner({ className, ...props }: React$1.ComponentProps<"svg">): react_jsx_runtime.JSX.Element;
-declare namespace Spinner {
-    var displayName: string;
+declare const SONNER_DEFAULT_DURATION = 4000;
+
+declare const spinnerVariants: (props?: ({
+    size?: "xs" | "sm" | "md" | "lg" | "xl" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface SpinnerProps extends React$1.HTMLAttributes<HTMLSpanElement>, VariantProps<typeof spinnerVariants> {
 }
+declare const Spinner: React$1.ForwardRefExoticComponent<SpinnerProps & React$1.RefAttributes<HTMLSpanElement>>;
 
 declare const switchRootVariants: (props?: ({
     size?: "sm" | "md" | "lg" | "small" | "medium" | "large" | null | undefined;
@@ -2108,9 +2438,9 @@ interface SwitchProps extends React$1.ComponentPropsWithoutRef<typeof SwitchPrim
 }
 declare const Switch: React$1.ForwardRefExoticComponent<SwitchProps & React$1.RefAttributes<HTMLButtonElement>>;
 
-interface TableProps extends React$1.ComponentProps<"table"> {
+interface TableProps extends React$1.ComponentProps<'table'> {
     /** Size variant affecting cell padding and font size */
-    size?: "sm" | "md" | "lg";
+    size?: 'sm' | 'md' | 'lg';
     /** Zebra-striped rows */
     striped?: boolean;
     /** Bordered cells */
@@ -2122,37 +2452,41 @@ declare function Table({ className, size, striped, bordered, stickyHeader, ...pr
 declare namespace Table {
     var displayName: string;
 }
-declare function TableHeader({ className, ...props }: React$1.ComponentProps<"thead">): react_jsx_runtime.JSX.Element;
+declare function TableHeader({ className, ...props }: React$1.ComponentProps<'thead'>): react_jsx_runtime.JSX.Element;
 declare namespace TableHeader {
     var displayName: string;
 }
-declare function TableBody({ className, ...props }: React$1.ComponentProps<"tbody">): react_jsx_runtime.JSX.Element;
+declare function TableBody({ className, ...props }: React$1.ComponentProps<'tbody'>): react_jsx_runtime.JSX.Element;
 declare namespace TableBody {
     var displayName: string;
 }
-declare function TableFooter({ className, ...props }: React$1.ComponentProps<"tfoot">): react_jsx_runtime.JSX.Element;
+declare function TableFooter({ className, ...props }: React$1.ComponentProps<'tfoot'>): react_jsx_runtime.JSX.Element;
 declare namespace TableFooter {
     var displayName: string;
 }
-declare function TableRow({ className, ...props }: React$1.ComponentProps<"tr">): react_jsx_runtime.JSX.Element;
+declare function TableRow({ className, ...props }: React$1.ComponentProps<'tr'>): react_jsx_runtime.JSX.Element;
 declare namespace TableRow {
     var displayName: string;
 }
-declare function TableHead({ className, ...props }: React$1.ComponentProps<"th">): react_jsx_runtime.JSX.Element;
+interface TableHeadProps extends React$1.ComponentProps<'th'> {
+    /** Sort direction — sets aria-sort on the <th> element */
+    sortDirection?: 'asc' | 'desc' | 'none';
+}
+declare function TableHead({ className, sortDirection, ...props }: TableHeadProps): react_jsx_runtime.JSX.Element;
 declare namespace TableHead {
     var displayName: string;
 }
-declare function TableCell({ className, ...props }: React$1.ComponentProps<"td">): react_jsx_runtime.JSX.Element;
+declare function TableCell({ className, ...props }: React$1.ComponentProps<'td'>): react_jsx_runtime.JSX.Element;
 declare namespace TableCell {
     var displayName: string;
 }
-declare function TableCaption({ className, ...props }: React$1.ComponentProps<"caption">): react_jsx_runtime.JSX.Element;
+declare function TableCaption({ className, ...props }: React$1.ComponentProps<'caption'>): react_jsx_runtime.JSX.Element;
 declare namespace TableCaption {
     var displayName: string;
 }
-interface TableSortHeaderProps extends React$1.ComponentProps<"button"> {
+interface TableSortHeaderProps extends React$1.ComponentProps<'button'> {
     /** Current sort direction */
-    sorted?: "asc" | "desc" | false;
+    sorted?: 'asc' | 'desc' | false;
 }
 declare function TableSortHeader({ className, children, sorted, ...props }: TableSortHeaderProps): react_jsx_runtime.JSX.Element;
 declare namespace TableSortHeader {
@@ -2162,9 +2496,9 @@ declare namespace TableSortHeader {
 declare const Tabs: React$1.ForwardRefExoticComponent<TabsPrimitive.TabsProps & React$1.RefAttributes<HTMLDivElement>>;
 interface TabsListProps extends React$1.ComponentPropsWithoutRef<typeof TabsPrimitive.List> {
     /** Visual variant */
-    variant?: "default" | "underline" | "outline";
+    variant?: 'default' | 'underline' | 'outline';
     /** Size */
-    size?: "sm" | "md" | "lg";
+    size?: 'sm' | 'md' | 'lg';
 }
 declare const TabsList: React$1.ForwardRefExoticComponent<TabsListProps & React$1.RefAttributes<HTMLDivElement>>;
 interface TabsTriggerProps extends React$1.ComponentPropsWithoutRef<typeof TabsPrimitive.Trigger> {
@@ -2176,10 +2510,7 @@ interface TabsTriggerProps extends React$1.ComponentPropsWithoutRef<typeof TabsP
 declare const TabsTrigger: React$1.ForwardRefExoticComponent<TabsTriggerProps & React$1.RefAttributes<HTMLButtonElement>>;
 declare const TabsContent: React$1.ForwardRefExoticComponent<Omit<TabsPrimitive.TabsContentProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 
-declare function Textarea({ className, ...props }: React$1.ComponentProps<"textarea">): react_jsx_runtime.JSX.Element;
-declare namespace Textarea {
-    var displayName: string;
-}
+declare const Textarea: React$1.ForwardRefExoticComponent<Omit<React$1.DetailedHTMLProps<React$1.TextareaHTMLAttributes<HTMLTextAreaElement>, HTMLTextAreaElement>, "ref"> & React$1.RefAttributes<HTMLTextAreaElement>>;
 
 declare const toggleVariants: (props?: ({
     variant?: "default" | "outline" | null | undefined;
@@ -2199,13 +2530,26 @@ declare namespace ToggleGroupItem {
     var displayName: string;
 }
 
+type ViewMode = 'grid' | 'list';
+interface ViewToggleProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, 'onChange'> {
+    /** Current view mode */
+    value: ViewMode;
+    /** Callback when view changes */
+    onValueChange: (value: ViewMode) => void;
+    /** Size @default "sm" */
+    size?: 'sm' | 'default';
+    /** Locale @default "fa" */
+    locale?: SupportedLocale;
+}
+declare const ViewToggle: React$1.ForwardRefExoticComponent<ViewToggleProps & React$1.RefAttributes<HTMLDivElement>>;
+
 interface TrendIndicatorProps extends React$1.HTMLAttributes<HTMLSpanElement> {
     /** The percentage change value */
     value: number;
     /** Direction of the trend — auto-detected from value sign if not provided */
-    direction?: "up" | "down" | "neutral";
+    direction?: 'up' | 'down' | 'neutral';
     /** Size of the indicator */
-    size?: "sm" | "md" | "lg";
+    size?: 'sm' | 'md' | 'lg';
     /** Locale for number formatting */
     locale?: SupportedLocale;
     /** Show the percentage sign */
@@ -2219,9 +2563,9 @@ interface FilterChipProps extends React$1.HTMLAttributes<HTMLSpanElement> {
     /** Callback when the chip is removed */
     onRemove?: () => void;
     /** Visual variant */
-    variant?: "default" | "brand" | "warning" | "destructive";
+    variant?: 'default' | 'brand' | 'warning' | 'destructive';
     /** Size */
-    size?: "sm" | "md";
+    size?: 'sm' | 'md';
     /** Override the remove button's aria-label. Default: "حذف {label}" */
     removeAriaLabel?: string;
     /** Disables the chip and hides the remove button */
@@ -2233,9 +2577,14 @@ declare const FilterChip: React$1.ForwardRefExoticComponent<FilterChipProps & Re
 interface FilterChipGroupProps extends React$1.HTMLAttributes<HTMLDivElement> {
     /** Maximum visible chips before showing overflow count */
     maxVisible?: number;
+    /** Locale for overflow counter digits */
+    locale?: SupportedLocale;
 }
 declare const FilterChipGroup: React$1.ForwardRefExoticComponent<FilterChipGroupProps & React$1.RefAttributes<HTMLDivElement>>;
 
+declare const statDisplayVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
 interface StatDisplayProps extends React$1.HTMLAttributes<HTMLDivElement> {
     /** The main numeric value */
     value: number | string;
@@ -2246,7 +2595,7 @@ interface StatDisplayProps extends React$1.HTMLAttributes<HTMLDivElement> {
     /** Trend indicator element (use TrendIndicator component) */
     trend?: React$1.ReactNode;
     /** Size of the display */
-    size?: "sm" | "md" | "lg";
+    size?: 'sm' | 'md' | 'lg';
     /** Locale for number formatting */
     locale?: SupportedLocale;
     /** Optional icon displayed before the value */
@@ -2256,13 +2605,34 @@ interface StatDisplayProps extends React$1.HTMLAttributes<HTMLDivElement> {
 }
 declare const StatDisplay: React$1.ForwardRefExoticComponent<StatDisplayProps & React$1.RefAttributes<HTMLDivElement>>;
 
+interface StepperProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    /** Index of the currently active step (0-based) */
+    activeStep: number;
+    /** Layout direction @default "horizontal" */
+    orientation?: 'horizontal' | 'vertical';
+    /** Size @default "md" */
+    size?: 'sm' | 'md' | 'lg';
+    /** Locale @default "fa" */
+    locale?: SupportedLocale;
+}
+interface StepProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    /** Step label text */
+    label: string;
+    /** Optional description below label */
+    description?: string;
+    /** Optional icon to replace the step number */
+    icon?: React$1.ReactNode;
+}
+declare const Stepper: React$1.ForwardRefExoticComponent<StepperProps & React$1.RefAttributes<HTMLDivElement>>;
+declare const Step: React$1.ForwardRefExoticComponent<StepProps & React$1.RefAttributes<HTMLDivElement>>;
+
 interface SentimentBadgeProps extends React$1.HTMLAttributes<HTMLSpanElement> {
     /** Sentiment type */
-    sentiment: "positive" | "negative" | "neutral" | "mixed";
+    sentiment: 'positive' | 'negative' | 'neutral' | 'mixed';
     /** Optional count to display */
     count?: number;
     /** Size */
-    size?: "sm" | "md";
+    size?: 'sm' | 'md';
     /** Show text label alongside the icon */
     showLabel?: boolean;
     /** Locale for number/label formatting */
@@ -2305,10 +2675,7 @@ declare const MultiSelect: React$1.ForwardRefExoticComponent<MultiSelectProps &
 
 interface PeriodOption {
     value: string;
-    label: {
-        fa: string;
-        en: string;
-    };
+    label: Record<SupportedLocale, string>;
 }
 declare const DEFAULT_PERIODS: PeriodOption[];
 interface PeriodSelectorProps {
@@ -2319,9 +2686,9 @@ interface PeriodSelectorProps {
     /** Custom period options — defaults to the 6 standard periods */
     periods?: PeriodOption[];
     /** Display locale — affects label language */
-    locale?: "fa" | "en";
+    locale?: SupportedLocale;
     /** Size variant */
-    size?: "sm" | "md";
+    size?: 'sm' | 'md';
     /** Disables all periods */
     disabled?: boolean;
     /** Additional className */
@@ -2329,20 +2696,24 @@ interface PeriodSelectorProps {
 }
 declare const PeriodSelector: React$1.ForwardRefExoticComponent<PeriodSelectorProps & React$1.RefAttributes<HTMLDivElement>>;
 
-type SocialPlatform = "instagram" | "twitter" | "tiktok" | "youtube" | "linkedin" | "telegram" | "threads";
+type SocialPlatform = 'instagram' | 'twitter' | 'tiktok' | 'youtube' | 'linkedin' | 'telegram' | 'threads';
 interface SocialPlatformBadgeProps extends React$1.HTMLAttributes<HTMLSpanElement> {
     /** The social media platform to display */
     platform: SocialPlatform;
     /** Size of the badge */
-    size?: "xs" | "sm" | "md" | "lg";
+    size?: 'xs' | 'sm' | 'md' | 'lg';
     /** Show the platform name label */
     showLabel?: boolean;
     /** Visual style of the badge */
-    variant?: "flat" | "badge";
+    variant?: 'flat' | 'badge';
 }
+declare const socialPlatformBadgeVariants: (props?: ({
+    size?: "xs" | "sm" | "md" | "lg" | null | undefined;
+    variant?: "flat" | "badge" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
 declare const SocialPlatformBadge: React$1.ForwardRefExoticComponent<SocialPlatformBadgeProps & React$1.RefAttributes<HTMLSpanElement>>;
 
-interface SearchInputProps extends Omit<React$1.InputHTMLAttributes<HTMLInputElement>, "size">, VariantProps<typeof InputVariants> {
+interface SearchInputProps extends Omit<React$1.InputHTMLAttributes<HTMLInputElement>, 'size'>, VariantProps<typeof InputVariants> {
     /** Locale for placeholder and aria labels */
     locale?: SupportedLocale;
     /** Show a loading spinner instead of the clear button */
@@ -2364,12 +2735,13 @@ interface SentimentData {
     positive: number;
     negative: number;
     neutral: number;
+    mixed?: number;
 }
 interface SentimentDistributionProps extends React$1.HTMLAttributes<HTMLDivElement> {
     /** Sentiment counts (will be auto-normalized to 100%) */
     data: SentimentData;
     /** Display mode */
-    variant?: "bars" | "stacked" | "compact";
+    variant?: 'bars' | 'stacked' | 'compact';
     /** Show numeric count labels */
     showCounts?: boolean;
     /** Show percentage labels */
@@ -2413,35 +2785,349 @@ interface ComparisonCardProps extends React$1.HTMLAttributes<HTMLDivElement> {
 }
 declare const ComparisonCard: React$1.ForwardRefExoticComponent<ComparisonCardProps & React$1.RefAttributes<HTMLDivElement>>;
 
-interface PartoLineChartProps extends Omit<LineSvgProps<any>, 'theme' | 'width' | 'height'> {
+type SortDirection = 'asc' | 'desc';
+interface DataTableColumn<TData> {
+    /** Unique key identifying the column — used for sort callbacks */
+    id: string;
+    /** Column header label */
+    header: React$1.ReactNode;
+    /** Render function for cell content */
+    cell: (row: TData, rowIndex: number) => React$1.ReactNode;
+    /** Whether this column is sortable */
+    sortable?: boolean;
+    /** Additional className for both <th> and <td> */
     className?: string;
-    /** Show loading skeleton instead of chart */
+    /** Column alignment */
+    align?: 'start' | 'center' | 'end';
+}
+interface DataTablePagination {
+    currentPage: number;
+    totalPages: number;
+    onPageChange: (page: number) => void;
+}
+interface DataTableSort {
+    column: string | null;
+    direction: SortDirection | null;
+    onSort: (column: string, direction: SortDirection) => void;
+}
+interface DataTableSelection<TData> {
+    selectedRows: Set<number>;
+    onSelectionChange: (selectedRows: Set<number>) => void;
+    /** Function to get a unique key for each row (defaults to index) */
+    getRowKey?: (row: TData, index: number) => number;
+}
+interface DataTableProps<TData> {
+    /** Column definitions */
+    columns: DataTableColumn<TData>[];
+    /** Data rows */
+    data: TData[];
+    /** Table size variant */
+    size?: 'sm' | 'md' | 'lg';
+    /** Show loading skeleton */
     isLoading?: boolean;
+    /** Number of skeleton rows to show when loading */
+    loadingRows?: number;
+    /** Content to show when data is empty (not loading) */
+    emptyState?: React$1.ReactNode;
+    /** Pagination configuration */
+    pagination?: DataTablePagination;
+    /** Sort configuration */
+    sort?: DataTableSort;
+    /** Row selection configuration */
+    selection?: DataTableSelection<TData>;
+    /** Zebra-striped rows */
+    striped?: boolean;
+    /** Bordered cells */
+    bordered?: boolean;
+    /** Sticky header */
+    stickyHeader?: boolean;
+    /** Additional className for the root wrapper */
+    className?: string;
+    /** Caption text below the table */
+    caption?: string;
+    /** Total result count shown above table (e.g. "۲۴ نتیجه") */
+    resultCount?: React$1.ReactNode;
+    /** Locale for UI strings @default 'fa' */
+    locale?: SupportedLocale;
+}
+declare const DataTable: <TData>(props: DataTableProps<TData> & {
+    ref?: React$1.ForwardedRef<HTMLDivElement>;
+}) => React$1.ReactElement;
+
+interface DirectionalBoxProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    /**
+     * Override the detected document direction.
+     * When not provided, reads from `useDocumentDirection`.
+     */
+    dir?: 'rtl' | 'ltr';
+    /**
+     * Content rendered when direction is RTL.
+     * If not provided, renders `children` in both directions.
+     */
+    rtl?: React$1.ReactNode;
+    /**
+     * Content rendered when direction is LTR.
+     * If not provided, renders `children` in both directions.
+     */
+    ltr?: React$1.ReactNode;
 }
-declare function PartoLineChart({ className, isLoading, ...props }: PartoLineChartProps): react_jsx_runtime.JSX.Element;
+declare const DirectionalBox: React$1.ForwardRefExoticComponent<DirectionalBoxProps & React$1.RefAttributes<HTMLDivElement>>;
 
-interface PartoBarChartProps extends Omit<BarSvgProps<any>, 'theme' | 'width' | 'height'> {
+declare const pageLoaderVariants: (props?: ({
+    fullScreen?: boolean | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface PageLoaderProps extends React$1.HTMLAttributes<HTMLDivElement>, VariantProps<typeof pageLoaderVariants> {
+    /** Optional message displayed below the spinner */
+    message?: string;
+    /** Spinner size @default "lg" */
+    spinnerSize?: 'sm' | 'md' | 'lg' | 'xl';
+}
+declare const PageLoader: React$1.ForwardRefExoticComponent<PageLoaderProps & React$1.RefAttributes<HTMLDivElement>>;
+
+interface ErrorBoundaryProps {
+    children: React$1.ReactNode;
+    /** Custom fallback UI. Receives the error and a reset function. */
+    fallback?: React$1.ReactNode | ((props: {
+        error: Error;
+        reset: () => void;
+    }) => React$1.ReactNode);
+    /** Callback when an error is caught */
+    onError?: (error: Error, errorInfo: React$1.ErrorInfo) => void;
+    /** Optional className for the wrapper when error is shown */
     className?: string;
-    /** Show loading skeleton instead of chart */
-    isLoading?: boolean;
 }
-declare function PartoBarChart({ className, isLoading, ...props }: PartoBarChartProps): react_jsx_runtime.JSX.Element;
+interface ErrorBoundaryState {
+    error: Error | null;
+}
+declare class ErrorBoundary extends React$1.Component<ErrorBoundaryProps, ErrorBoundaryState> {
+    static displayName: string;
+    constructor(props: ErrorBoundaryProps);
+    static getDerivedStateFromError(error: Error): ErrorBoundaryState;
+    componentDidCatch(error: Error, errorInfo: React$1.ErrorInfo): void;
+    reset: () => void;
+    render(): React$1.ReactNode;
+}
 
-interface PartoPieChartProps extends Omit<PieSvgProps<any>, 'theme' | 'width' | 'height'> {
+interface SafeImageProps extends React$1.ImgHTMLAttributes<HTMLImageElement> {
+    /** Fallback content rendered when the image fails to load.
+     *  Defaults to a placeholder icon. */
+    fallback?: React$1.ReactNode;
+    /** Additional className for the wrapper div (applied when fallback is shown) */
+    wrapperClassName?: string;
+}
+declare const SafeImage: React$1.ForwardRefExoticComponent<SafeImageProps & React$1.RefAttributes<HTMLImageElement>>;
+
+declare const calloutVariants: (props?: ({
+    variant?: "info" | "success" | "warning" | "destructive" | "neutral" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface CalloutProps extends React$1.HTMLAttributes<HTMLDivElement>, VariantProps<typeof calloutVariants> {
+    /** Custom icon. Set to `null` to hide the icon. */
+    icon?: React$1.ReactNode | null;
+}
+declare const Callout: React$1.ForwardRefExoticComponent<CalloutProps & React$1.RefAttributes<HTMLDivElement>>;
+declare const CalloutTitle: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLParagraphElement> & React$1.RefAttributes<HTMLParagraphElement>>;
+declare const CalloutDescription: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLParagraphElement> & React$1.RefAttributes<HTMLParagraphElement>>;
+
+interface AnimatedNumberProps extends Omit<React$1.HTMLAttributes<HTMLSpanElement>, 'children'> {
+    /** The target value to animate to */
+    value: number;
+    /** Animation duration in milliseconds @default 600 */
+    duration?: number;
+    /** Number of decimal places @default 0 */
+    decimals?: number;
+    /** Format function applied to the final displayed number.
+     *  Receives the current animated value. */
+    formatFn?: (value: number) => string;
+    /** Whether to animate on value change or only on mount @default true */
+    animateOnChange?: boolean;
+}
+declare const AnimatedNumber: React$1.ForwardRefExoticComponent<AnimatedNumberProps & React$1.RefAttributes<HTMLSpanElement>>;
+
+interface SectionItem {
+    /** Unique identifier matching the target element's `id` attribute */
+    id: string;
+    /** Display label for the navigation link */
+    label: string;
+    /** Optional icon rendered before the label */
+    icon?: React$1.ReactNode;
+}
+interface SectionNavigatorProps extends React$1.HTMLAttributes<HTMLElement> {
+    /** List of sections to navigate between */
+    sections: SectionItem[];
+    /** Offset from top when calculating active section (e.g. sticky header height) @default 80 */
+    offset?: number;
+    /** Callback when a section link is clicked */
+    onSectionClick?: (sectionId: string) => void;
+}
+declare const SectionNavigator: React$1.ForwardRefExoticComponent<SectionNavigatorProps & React$1.RefAttributes<HTMLElement>>;
+
+interface PartoLineChartProps {
+    /** Row-oriented data: [{ name: "فروردین", series1: 50, series2: 30 }] */
+    data: Array<Record<string, any>>;
+    /** Keys for each line series (e.g. ['فروش', 'سود']) */
+    dataKeys: string[];
+    /** Field name for X axis (default: 'name') */
+    xAxisKey?: string;
+    /** Curve type */
+    curve?: 'monotone' | 'linear' | 'natural' | 'step';
+    /** Line width */
+    strokeWidth?: number;
+    /** Show dots on data points */
+    showDots?: boolean;
+    /** Show horizontal grid lines */
+    enableGridY?: boolean;
+    /** Show vertical grid lines */
+    enableGridX?: boolean;
+    /** Chart margins */
+    margin?: {
+        top?: number;
+        right?: number;
+        bottom?: number;
+        left?: number;
+    };
+    /** Custom X axis config */
+    axisBottom?: Record<string, any> | null;
+    /** Custom Y axis config */
+    axisLeft?: Record<string, any> | null;
+    /** Custom tooltip formatter */
+    tooltipFormatter?: (name: string, value: number) => React$1.ReactNode;
     className?: string;
-    /** Show loading skeleton instead of chart */
     isLoading?: boolean;
+    ariaLabel?: string;
+    /** Additional Recharts LineChart props */
+    chartProps?: Record<string, any>;
+}
+declare const PartoLineChart: React$1.ForwardRefExoticComponent<PartoLineChartProps & React$1.RefAttributes<HTMLDivElement>>;
+
+interface PartoBarChartProps {
+    /** Chart data — row-oriented array of objects */
+    data: Array<Record<string, any>>;
+    /** Data keys to render as bars (e.g. ['فروش', 'هزینه']) */
+    keys: string[];
+    /** Field name used for X axis categories (e.g. 'ماه') */
+    indexBy: string;
+    /** Stacked or grouped layout */
+    groupMode?: 'grouped' | 'stacked';
+    /** Bar layout direction */
+    layout?: 'vertical' | 'horizontal';
+    /** Chart margins */
+    margin?: {
+        top?: number;
+        right?: number;
+        bottom?: number;
+        left?: number;
+    };
+    /** Gap between category groups as percentage */
+    barCategoryGap?: string | number;
+    /** Gap between bars within a group */
+    barGap?: number;
+    /** Border radius for bar tops [topLeft, topRight, bottomRight, bottomLeft] */
+    radius?: [number, number, number, number];
+    /** Show horizontal grid lines */
+    enableGridY?: boolean;
+    /** Show vertical grid lines */
+    enableGridX?: boolean;
+    /** Show labels inside bars */
+    enableLabel?: boolean;
+    /** Custom X axis config */
+    axisBottom?: Record<string, any> | null;
+    /** Custom Y axis config */
+    axisLeft?: Record<string, any> | null;
+    /** Custom tooltip formatter */
+    tooltipFormatter?: (name: string, value: number) => React$1.ReactNode;
+    className?: string;
+    isLoading?: boolean;
+    ariaLabel?: string;
+    /** Additional Recharts BarChart props */
+    chartProps?: Record<string, any>;
 }
-declare function PartoPieChart({ className, isLoading, ...props }: PartoPieChartProps): react_jsx_runtime.JSX.Element;
+declare const PartoBarChart: React$1.ForwardRefExoticComponent<PartoBarChartProps & React$1.RefAttributes<HTMLDivElement>>;
 
-interface PartoHeatMapProps extends Omit<HeatMapSvgProps<any, any>, 'theme' | 'width' | 'height'> {
+interface PartoPieChartProps {
+    /** Data: [{ name: "محصول A", value: 40 }] */
+    data: Array<{
+        name: string;
+        value: number;
+        [key: string]: any;
+    }>;
+    /** Inner radius — 0 for full pie, "60%" for donut */
+    innerRadius?: number | string;
+    /** Outer radius */
+    outerRadius?: number | string;
+    /** Angle between slices in degrees */
+    paddingAngle?: number;
+    /** Corner radius of arc segments */
+    cornerRadius?: number;
+    /** Show arc link labels (lines from slices to text) */
+    showLabels?: boolean;
+    /** Skip labels for slices smaller than this angle */
+    labelSkipAngle?: number;
+    /** Chart margins */
+    margin?: {
+        top?: number;
+        right?: number;
+        bottom?: number;
+        left?: number;
+    };
+    /** Custom tooltip formatter */
+    tooltipFormatter?: (name: string, value: number) => React$1.ReactNode;
     className?: string;
+    isLoading?: boolean;
+    ariaLabel?: string;
+}
+declare const PartoPieChart: React$1.ForwardRefExoticComponent<PartoPieChartProps & React$1.RefAttributes<HTMLDivElement>>;
+
+/**
+ * PartoHeatMap — brand-tinted heatmap with rounded cells, clean axis,
+ * glassmorphic tooltip, and locale-aware formatting.
+ * Built with Visx scales + raw SVG for full control.
+ */
+interface HeatMapDatum {
+    x: string | number;
+    y: number;
+}
+interface HeatMapRow {
+    id: string;
+    data: HeatMapDatum[];
+}
+interface PartoHeatMapProps {
+    data: HeatMapRow[];
     locale?: 'fa' | 'en';
-    /** Show loading skeleton instead of chart */
+    className?: string;
     isLoading?: boolean;
+    ariaLabel?: string;
+    margin?: {
+        top: number;
+        right: number;
+        bottom: number;
+        left: number;
+    };
+    /** Custom color function: receives value and max → returns CSS color */
+    colorScale?: (value: number, max: number) => string;
+    /** Cell border radius */
+    cellRadius?: number;
+    /** Gap between cells */
+    cellGap?: number;
+    /** Custom tooltip content */
+    renderTooltip?: (cell: {
+        rowId: string;
+        x: string | number;
+        value: number;
+        color: string;
+    }) => React$1.ReactNode;
+    /** X axis label */
+    xAxisLabel?: string;
+    /** Y axis label */
+    yAxisLabel?: string;
+    /** Filter which x-axis ticks to show */
+    xTickFilter?: (value: string | number, index: number) => boolean;
 }
-declare function PartoHeatMap({ className, locale, isLoading, data, axisTop, axisBottom, axisLeft, axisRight, valueFormat, tooltip, margin, ...props }: PartoHeatMapProps): react_jsx_runtime.JSX.Element;
+declare const PartoHeatMap: React$1.ForwardRefExoticComponent<PartoHeatMapProps & React$1.RefAttributes<HTMLDivElement>>;
 
+/**
+ * PartoWordCloud — modern word cloud with smooth hover transitions,
+ * glassmorphic tooltip, and brand-harmonious coloring.
+ */
 interface WordData {
     text: string;
     value: number;
@@ -2464,9 +3150,231 @@ interface PartoWordCloudProps {
     onWordClick?: (word: WordData) => void;
     /** Show loading skeleton instead of word cloud */
     isLoading?: boolean;
+    /** Accessible label describing the chart content */
+    ariaLabel?: string;
+}
+declare function PartoWordCloud({ words, width: widthProp, height: heightProp, className, minFontSize, maxFontSize, padding, spiral, rotate, random, fontWeight, onWordClick, isLoading, ariaLabel, }: PartoWordCloudProps): react_jsx_runtime.JSX.Element;
+declare namespace PartoWordCloud {
+    var displayName: string;
+}
+
+interface PartoAreaChartProps {
+    /** Row-oriented data: [{ name: "فروردین", series1: 50, series2: 30 }] */
+    data: Array<Record<string, any>>;
+    /** Keys for each area series (e.g. ['فروش', 'سود']) */
+    dataKeys: string[];
+    /** Field name for X axis (default: 'name') */
+    xAxisKey?: string;
+    /** Curve type */
+    curve?: 'monotone' | 'linear' | 'natural' | 'step';
+    /** Line width */
+    strokeWidth?: number;
+    /** Area fill opacity */
+    fillOpacity?: number;
+    /** Show dots on data points */
+    showDots?: boolean;
+    /** Show horizontal grid lines */
+    enableGridY?: boolean;
+    /** Show vertical grid lines */
+    enableGridX?: boolean;
+    /** Chart margins */
+    margin?: {
+        top?: number;
+        right?: number;
+        bottom?: number;
+        left?: number;
+    };
+    /** Custom X axis config */
+    axisBottom?: Record<string, any> | null;
+    /** Custom Y axis config */
+    axisLeft?: Record<string, any> | null;
+    /** Custom tooltip formatter */
+    tooltipFormatter?: (name: string, value: number) => React$1.ReactNode;
+    className?: string;
+    isLoading?: boolean;
+    ariaLabel?: string;
+    /** Additional Recharts AreaChart props */
+    chartProps?: Record<string, any>;
+}
+declare const PartoAreaChart: React$1.ForwardRefExoticComponent<PartoAreaChartProps & React$1.RefAttributes<HTMLDivElement>>;
+
+interface PartoRadarChartProps {
+    /** Data: [{ subject: "سرعت", series1: 80, series2: 60 }] */
+    data: Array<Record<string, any>>;
+    /** Keys for each radar series */
+    dataKeys: string[];
+    /** Field name used for angle axis labels (default: 'subject') */
+    indexBy?: string;
+    /** Radar fill opacity */
+    fillOpacity?: number;
+    /** Radar stroke width */
+    strokeWidth?: number;
+    /** Show dots on vertices */
+    showDots?: boolean;
+    /** Dot radius */
+    dotRadius?: number;
+    /** Grid shape */
+    gridType?: 'polygon' | 'circle';
+    /** Chart margins */
+    margin?: {
+        top?: number;
+        right?: number;
+        bottom?: number;
+        left?: number;
+    };
+    /** Custom tooltip formatter */
+    tooltipFormatter?: (name: string, value: number) => React$1.ReactNode;
+    className?: string;
+    isLoading?: boolean;
+    ariaLabel?: string;
 }
-declare function PartoWordCloud({ words, width: widthProp, height: heightProp, className, minFontSize, maxFontSize, padding, spiral, rotate, random, fontWeight, onWordClick, isLoading, }: PartoWordCloudProps): react_jsx_runtime.JSX.Element;
+declare const PartoRadarChart: React$1.ForwardRefExoticComponent<PartoRadarChartProps & React$1.RefAttributes<HTMLDivElement>>;
+
+type Direction = 'ltr' | 'rtl';
+declare function useDocumentDirection(): Direction;
 
 declare function useIsMobile(): boolean;
 
-export { Accordion, AccordionContent, AccordionItem, AccordionTrigger, Alert, AlertDescription, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, AlertTitle, AspectRatio, type AspectRatioType, Autocomplete, type AutocompleteItem, type AutocompleteProps, Avatar, AvatarFallback, AvatarImage, Badge, type BadgeProps, Breadcrumb, BreadcrumbEllipsis, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator, Button, ButtonGroup, ButtonGroupSeparator, ButtonGroupText, type ButtonProps, type ButtonVariantProps, Calendar, type CalendarProps, Card, CardContent, CardDescription, CardFooter, CardHeader, type CardProps, CardTitle, Carousel, type CarouselApi, CarouselContent, CarouselItem, CarouselNext, CarouselPrevious, ChartSkeleton, type ChartSkeletonProps, Checkbox, Collapsible, CollapsibleContent, CollapsibleTrigger, Command, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, CommentCard, type CommentCardProps, type CommentTag, ComparisonCard, type ComparisonCardProps, ContextMenu, ContextMenuCheckboxItem, ContextMenuContent, ContextMenuGroup, ContextMenuItem, ContextMenuLabel, ContextMenuPortal, ContextMenuRadioGroup, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuShortcut, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger, DEFAULT_PERIODS, DatePicker, type DatePickerProps, DateRangePicker, DateRangePickerInline, type DateRangePickerProps, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, Drawer, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerOverlay, DrawerPortal, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, ENGAGEMENT_RANGES, Empty, EmptyDescription, EmptyIcon, EmptyTitle, type EngagementRange, type EngagementRangeWithDisplay, EngagementRate, EngagementRateBar, type EngagementRateBarProps, type EngagementRateProps, type EngagementTier, ErrorState, type ErrorStateProps, Field, FieldContent, FieldDescription, FieldError, FieldGroup, FieldLabel, FieldLegend, FieldSeparator, FieldSet, FieldTitle, FilterChip, FilterChipGroup, type FilterChipProps, type FollowerGroup, Form, FormControl, FormDescription, FormField, FormItem, FormLabel, FormMessage, GROUP_LABELS, HashtagInput, type HashtagInputProps, HoverCard, HoverCardContent, HoverCardTrigger, type Icon, Icons, Input, InputGroup, InputGroupAddon, InputGroupButton, InputGroupInput, InputGroupText, InputGroupTextarea, InputOTP, InputOTPGroup, InputOTPSeparator, InputOTPSlot, type InputProps, InputVariants, InstagramPost, type InstagramPostProps, type InstagramProfileInfo, Item, ItemContent, ItemDescription, ItemGroup, type ItemGroupProps, ItemMedia, type ItemProps, ItemTitle, Kbd, KbdGroup, Label, type LegacySize, type LoadingVariantProps, type MediaItem, type MediaType, Menubar, MenubarCheckboxItem, MenubarContent, MenubarGroup, MenubarItem, MenubarLabel, MenubarMenu, MenubarPortal, MenubarRadioGroup, MenubarRadioItem, MenubarSeparator, MenubarShortcut, MenubarSub, MenubarSubContent, MenubarSubTrigger, MenubarTrigger, MetricCard, MetricCardContent, MetricCardDifferential, MetricCardHeader, MetricCardLabel, MetricCardSkeleton, type MetricCardSkeletonProps, MetricCardSparkline, MetricCardValue, MultiSelect, type MultiSelectOption, type MultiSelectProps, NativeSelect, NativeSelectOptGroup, NativeSelectOption, NavigationMenu, NavigationMenuContent, NavigationMenuIndicator, NavigationMenuItem, NavigationMenuLink, NavigationMenuList, NavigationMenuTrigger, NavigationMenuViewport, type NumberFormat, PERSIAN_MONTHS, PERSIAN_MONTHS_SHORT, PERSIAN_WEEKDAYS, PERSIAN_WEEKDAYS_SHORT, Pagination, PaginationContent, PaginationControlled, type PaginationControlledProps, PaginationEllipsis, PaginationItem, PaginationLink, PaginationNext, PaginationPrevious, PartoBarChart, type PartoBarChartProps, PartoHeatMap, type PartoHeatMapProps, PartoLineChart, type PartoLineChartProps, PartoPieChart, type PartoPieChartProps, type PartoToasterProps, PartoWordCloud, type PartoWordCloudProps, type PeriodOption, PeriodSelector, type PeriodSelectorProps, Popover, PopoverAnchor, PopoverContent, PopoverTrigger, type PostStats, ProfileCard, type ProfileCardProps, ProfileInfo, type ProfileInfoProps, Progress, type ProgressProps, RadioCardDescription, RadioCardItem, RadioCardTitle, RadioCards, RadioGroup, RadioGroupItem, ResizableHandle, ResizablePanel, ResizablePanelGroup, SONNER_DEFAULT_DURATION, ScrollArea, ScrollBar, SearchInput, type SearchInputProps, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, SentimentBadge, type SentimentBadgeProps, type SentimentData, SentimentDistribution, type SentimentDistributionProps, Separator, Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetTitle, SheetTrigger, Sidebar, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupAction, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInput, SidebarInset, SidebarMenu, SidebarMenuAction, SidebarMenuBadge, SidebarMenuButton, SidebarMenuItem, SidebarMenuSkeleton, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubItem, SidebarProvider, SidebarRail, SidebarSeparator, SidebarTrigger, type SizeWithLegacy, Skeleton, type SkeletonProps, Slider, type SocialPlatform, SocialPlatformBadge, type SocialPlatformBadgeProps, Spinner, type StandardSize, StatDisplay, type StatDisplayProps, type SupportedLocale, Switch, type SwitchProps, TIER_LABELS, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, TableSkeleton, type TableSkeletonProps, TableSortHeader, Tabs, TabsContent, TabsList, TabsTrigger, TagInput, type TagInputProps, Textarea, type TimeFormat, Toaster, Toggle, ToggleGroup, ToggleGroupItem, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, TrendIndicator, type TrendIndicatorProps, type UIStringKeys, type UIStrings, UI_STRINGS, UserAutocomplete, type UserAutocompleteProps, type UserItem, type WordData, badgeVariants, buttonGroupVariants, buttonVariants, cn, convertToLocalNumbers, formatAbsoluteTime, formatJalaliDate, formatLargeNumber, formatNumber, formatPersianDateRange, formatRelativeTime, getCurrentRangeIndex, getEngagementRanges, getFollowerGroup, getPersianDay, getPersianMonth, getPersianMonthName, getPersianMonthNameShort, getPersianMonthsForDropdown, getPersianWeekdayName, getPersianYear, getPersianYearsForDropdown, getUIStrings, hashtagInputVariants, instagramPostVariants, jalaliToGregorian, navigationMenuTriggerStyle, normalizeSize, tagInputVariants, toEnglishDigits, toPersianDigits, toggleVariants, useFormField, useIsMobile, useSidebar };
+interface UseInfiniteScrollOptions {
+    /** Called when the sentinel enters the viewport */
+    onLoadMore: () => void;
+    /** Whether there are more items to load */
+    hasMore: boolean;
+    /** Whether a load is currently in progress (prevents double-firing) */
+    isLoading?: boolean;
+    /** IntersectionObserver rootMargin @default "200px" */
+    rootMargin?: string;
+    /** IntersectionObserver threshold @default 0 */
+    threshold?: number;
+}
+interface UseInfiniteScrollReturn {
+    /** Ref to attach to the sentinel element at the bottom of the list */
+    sentinelRef: React$1.RefCallback<HTMLElement>;
+}
+/**
+ * Hook for infinite scroll using IntersectionObserver.
+ *
+ * Attach `sentinelRef` to an empty element at the bottom of your list.
+ * When it enters the viewport, `onLoadMore` is called (unless `isLoading` or `!hasMore`).
+ *
+ * @example
+ * ```tsx
+ * const { sentinelRef } = useInfiniteScroll({
+ *   onLoadMore: () => fetchNextPage(),
+ *   hasMore: data.hasNextPage,
+ *   isLoading: isFetchingNextPage,
+ * })
+ *
+ * return (
+ *   <div>
+ *     {items.map(item => <Card key={item.id} {...item} />)}
+ *     <div ref={sentinelRef} />
+ *   </div>
+ * )
+ * ```
+ */
+declare function useInfiniteScroll({ onLoadMore, hasMore, isLoading, rootMargin, threshold, }: UseInfiniteScrollOptions): UseInfiniteScrollReturn;
+
+/**
+ * Returns a debounced version of `value` that only updates after
+ * `delay` ms of inactivity.
+ *
+ * @example
+ * const debouncedSearch = useDebounce(searchQuery, 300)
+ */
+declare function useDebounce<T>(value: T, delay: number): T;
+
+/**
+ * Sync state to localStorage with JSON serialization.
+ * SSR-safe: returns initialValue on server (window is undefined).
+ *
+ * @example
+ * const [theme, setTheme] = useLocalStorage('theme', 'light')
+ */
+declare function useLocalStorage<T>(key: string, initialValue: T): [T, (value: T | ((prev: T) => T)) => void];
+
+/**
+ * Returns a snapshot of the current document root computed styles and
+ * re-renders when the theme class or OS color scheme changes.
+ */
+declare function useRootStyles(): CSSStyleDeclaration | null;
+
+declare const CHART_FONT_FAMILY = "Yekan Bakh, system-ui, -apple-system, sans-serif";
+declare function useChartTheme(): {
+    chartColors: string[];
+    getColor: (variable: string, fallback: string) => string;
+    fontFamily: string;
+    axisTickStyle: {
+        fontFamily: string;
+        fill: string;
+        fontSize: number;
+        fontWeight: 400;
+    };
+    gridStyle: {
+        stroke: string;
+        strokeDasharray: string;
+        strokeOpacity: number;
+    };
+    tooltipStyle: React$1.CSSProperties;
+    crosshairStyle: {
+        stroke: string;
+        strokeWidth: number;
+        strokeDasharray: string;
+        strokeOpacity: number;
+    };
+};
+
+interface ChartContainerProps {
+    className?: string;
+    dataSlot: string;
+    ariaLabel?: string;
+    children: React$1.ReactNode;
+}
+declare const ChartContainer: React$1.ForwardRefExoticComponent<ChartContainerProps & React$1.RefAttributes<HTMLDivElement>>;
+interface ChartSkeletonProps {
+    className?: string;
+    shape?: 'rect' | 'circle';
+}
+declare function ChartLoadingSkeleton({ className, shape }: ChartSkeletonProps): react_jsx_runtime.JSX.Element;
+interface ChartTooltipProps {
+    active?: boolean;
+    payload?: Array<{
+        name: string;
+        value: number;
+        color: string;
+        dataKey?: string;
+    }>;
+    label?: string;
+    tooltipStyle: React$1.CSSProperties;
+    formatter?: (name: string, value: number) => React$1.ReactNode;
+}
+declare function ChartTooltip({ active, payload, label, tooltipStyle, formatter }: ChartTooltipProps): react_jsx_runtime.JSX.Element | null;
+/**
+ * Transforms Nivo line/area data format to Recharts row-oriented format.
+ * Useful for consumers migrating from Nivo data shape.
+ *
+ * @example
+ * // Nivo: [{ id: "فروش", data: [{ x: "فروردین", y: 50 }] }]
+ * // Recharts: [{ name: "فروردین", فروش: 50 }]
+ */
+declare function transformNivoLineData(nivoData: Array<{
+    id: string;
+    data: Array<{
+        x: string | number;
+        y: number;
+    }>;
+}>): {
+    data: Array<Record<string, string | number>>;
+    dataKeys: string[];
+};
+
+/**
+ * Locks document body scroll when `locked` is true.
+ * Restores original overflow on cleanup.
+ *
+ * @example
+ * useScrollLock(isModalOpen)
+ */
+declare function useScrollLock(locked: boolean): void;
+
+export { Accordion, AccordionContent, AccordionItem, AccordionTrigger, Alert, AlertDescription, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, AlertTitle, AnimatedNumber, type AnimatedNumberProps, AppBar, type AppBarProps, AppLayout, AppLayoutContent, AspectRatio, type AspectRatioType, Autocomplete, type AutocompleteItem, type AutocompleteProps, Avatar, AvatarFallback, AvatarGroup, type AvatarGroupItem, type AvatarGroupProps, AvatarImage, Badge, type BadgeProps, Banner, type BannerProps, Breadcrumb, BreadcrumbEllipsis, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator, Button, ButtonGroup, ButtonGroupSeparator, ButtonGroupText, type ButtonProps, type ButtonVariantProps, CHART_FONT_FAMILY, Calendar, type CalendarProps, Callout, CalloutDescription, type CalloutProps, CalloutTitle, Card, CardContent, CardDescription, CardFooter, CardHeader, type CardProps, CardTitle, Carousel, type CarouselApi, CarouselContent, CarouselItem, CarouselNext, CarouselPrevious, ChartContainer, ChartLoadingSkeleton, ChartSkeleton, type ChartSkeletonProps$1 as ChartSkeletonProps, ChartTooltip, Checkbox, CircularProgress, type CircularProgressProps, Collapsible, CollapsibleContent, CollapsibleTrigger, Command, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, CommentCard, type CommentCardProps, type CommentTag, ComparisonCard, type ComparisonCardProps, ConfirmDialog, type ConfirmDialogProps, ContextMenu, ContextMenuCheckboxItem, ContextMenuContent, ContextMenuGroup, ContextMenuItem, ContextMenuLabel, ContextMenuPortal, ContextMenuRadioGroup, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuShortcut, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger, CopyButton, type CopyButtonProps, DEFAULT_PERIODS, DataTable, type DataTableColumn, type DataTablePagination, type DataTableProps, type DataTableSelection, type DataTableSort, DatePicker, type DatePickerProps, DateRangePicker, DateRangePickerInline, type DateRangePickerProps, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, type Direction, DirectionalBox, type DirectionalBoxProps, Drawer, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerOverlay, DrawerPortal, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, ENGAGEMENT_RANGES, Empty, EmptyAction, EmptyDescription, EmptyIcon, EmptyTitle, type EngagementRange, type EngagementRangeWithDisplay, EngagementRate, EngagementRateBar, type EngagementRateBarProps, type EngagementRateProps, type EngagementTier, ErrorBoundary, type ErrorBoundaryProps, ErrorState, type ErrorStateProps, Field, FieldContent, FieldDescription, FieldError, FieldGroup, FieldLabel, FieldLegend, FieldSeparator, FieldSet, FieldTitle, FilterBar, FilterBarActions, type FilterBarActionsProps, FilterBarActiveFilters, type FilterBarActiveFiltersProps, FilterBarClear, type FilterBarClearProps, type FilterBarProps, FilterBarRow, type FilterBarRowProps, FilterChip, FilterChipGroup, type FilterChipProps, type FollowerGroup, Form, FormControl, FormDescription, FormField, FormItem, FormLabel, FormMessage, GROUP_LABELS, HashtagInput, type TagInputProps as HashtagInputProps, type HeatMapDatum, type HeatMapRow, HoverCard, HoverCardContent, HoverCardTrigger, type Icon, Icons, Input, InputGroup, InputGroupAddon, InputGroupButton, InputGroupInput, InputGroupText, InputGroupTextarea, InputOTP, InputOTPGroup, InputOTPSeparator, InputOTPSlot, type InputProps, InputVariants, InputWithIcon, type InputWithIconProps, InstagramPost, type InstagramPostProps, type InstagramProfileInfo, Kbd, KbdGroup, Label, type LegacySize, type LoadingVariantProps, type Locale, type MediaItem, type MediaType, Menubar, MenubarCheckboxItem, MenubarContent, MenubarGroup, MenubarItem, MenubarLabel, MenubarMenu, MenubarPortal, MenubarRadioGroup, MenubarRadioItem, MenubarSeparator, MenubarShortcut, MenubarSub, MenubarSubContent, MenubarSubTrigger, MenubarTrigger, MetricCard, MetricCardContent, MetricCardDifferential, MetricCardHeader, MetricCardLabel, MetricCardSkeleton, type MetricCardSkeletonProps, MetricCardSparkline, MetricCardValue, MultiSelect, type MultiSelectOption, type MultiSelectProps, NativeSelect, NativeSelectOptGroup, NativeSelectOption, NavPanel, NavPanelContent, NavPanelFooter, NavPanelHeader, NavRail, NavRailContent, NavRailFooter, NavRailHeader, NavRailItem, NavRailProvider, NavRailSeparator, NavRailTrigger, NavigationMenu, NavigationMenuContent, NavigationMenuIndicator, NavigationMenuItem, NavigationMenuLink, NavigationMenuList, NavigationMenuTrigger, NavigationMenuViewport, type NumberFormat, PERSIAN_MONTHS, PERSIAN_MONTHS_SHORT, PERSIAN_WEEKDAYS, PERSIAN_WEEKDAYS_SHORT, PageHeader, type PageHeaderProps, PageLoader, type PageLoaderProps, Pagination, PaginationContent, PaginationControlled, type PaginationControlledProps, PaginationEllipsis, PaginationItem, PaginationLink, PaginationNext, PaginationPrevious, PartoAreaChart, type PartoAreaChartProps, PartoBarChart, type PartoBarChartProps, PartoHeatMap, type PartoHeatMapProps, PartoLineChart, type PartoLineChartProps, PartoPieChart, type PartoPieChartProps, PartoRadarChart, type PartoRadarChartProps, type PartoToasterProps, PartoWordCloud, type PartoWordCloudProps, type PeriodOption, PeriodSelector, type PeriodSelectorProps, Popover, PopoverAnchor, PopoverContent, PopoverTrigger, type PostStats, ProfileCard, type ProfileCardProps, ProfileInfo, type ProfileInfoProps, Progress, type ProgressProps, RadioCardDescription, RadioCardItem, RadioCardTitle, RadioCards, RadioGroup, RadioGroupItem, ResizableHandle, ResizablePanel, ResizablePanelGroup, SONNER_DEFAULT_DURATION, SafeImage, type SafeImageProps, ScrollArea, ScrollBar, SearchInput, type SearchInputProps, type SectionItem, SectionNavigator, type SectionNavigatorProps, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectTriggerVariants, SelectValue, SentimentBadge, type SentimentBadgeProps, type SentimentData, SentimentDistribution, type SentimentDistributionProps, Separator, Sheet, SheetBody, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetTitle, SheetTrigger, Sidebar, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupAction, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInput, SidebarInset, SidebarMenu, SidebarMenuAction, SidebarMenuBadge, SidebarMenuButton, SidebarMenuItem, SidebarMenuSkeleton, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubItem, SidebarProvider, SidebarRail, SidebarSeparator, SidebarTrigger, type SizeWithLegacy, Skeleton, type SkeletonProps, Slider, type SocialPlatform, SocialPlatformBadge, type SocialPlatformBadgeProps, type SortDirection, Spinner, type SpinnerProps, type StandardSize, StatDisplay, type StatDisplayProps, Step, type StepProps, Stepper, type StepperProps, type SupportedLocale, Switch, type SwitchProps, TIER_LABELS, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, TableSkeleton, type TableSkeletonProps, TableSortHeader, Tabs, TabsContent, TabsList, TabsTrigger, TagInput, type TagInputProps, Textarea, type TimeFormat, Toaster, Toggle, ToggleGroup, ToggleGroupItem, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, TrendIndicator, type TrendIndicatorProps, type UIStringKeys, type UIStrings, UI_STRINGS, type UseInfiniteScrollOptions, type UseInfiniteScrollReturn, UserAutocomplete, type UserAutocompleteProps, type UserItem, type ViewMode, ViewToggle, type ViewToggleProps, type WordData, appBarVariants, avatarGroupVariants, badgeVariants, bannerVariants, buttonGroupVariants, buttonVariants, calloutVariants, cardVariants, cn, convertToLocalNumbers, engagementUiTranslations, formatAbsoluteTime, formatJalaliDate, formatLargeNumber, formatNumber, formatPersianDateRange, formatRelativeTime, getCurrentRangeIndex, getEngagementRanges, getFollowerGroup, getPersianDay, getPersianMonth, getPersianMonthName, getPersianMonthNameShort, getPersianMonthsForDropdown, getPersianWeekdayName, getPersianYear, getPersianYearsForDropdown, getUIStrings, tagInputVariants as hashtagInputVariants, inputVariants, instagramPostVariants, isRTL, jalaliToGregorian, navigationMenuTriggerStyle, normalizeSize, pageLoaderVariants, profileCardVariants, sentimentLabels, socialPlatformBadgeVariants, spinnerVariants, statDisplayVariants, tagInputVariants, toEnglishDigits, toPersianDigits, toggleVariants, transformNivoLineData, useChartTheme, useDebounce, useDocumentDirection, useFormField, useInfiniteScroll, useIsMobile, useLocalStorage, useNavRail, useRootStyles, useScrollLock, useSidebar };