@parto-system-design/ui 1.1.4 → 1.1.7

package/dist/index.d.ts

@@ -1,4 +1,7 @@
-import { ClassValue } from 'clsx';
+import { S as SupportedLocale } from './utils-DlXWmDZ-.js';
+export { c as cn, a as convertToLocalNumbers, e as formatAbsoluteTime, f as formatLargeNumber, b as formatNumber, d as formatRelativeTime } from './utils-DlXWmDZ-.js';
+import { A as ActionStatusKey, a as ActionTypeKey, E as EntityHealthKey, J as JobStatusKey, S as StageStatusKey, b as EmotionKey, F as FlowKey, c as StatusKey, d as SeverityKey } from './i18n-ArS3mqj0.js';
+export { p as ACTION_STATUS_KEYS, w as ACTION_TYPE_KEYS, f as EMOTION_KEYS, z as ENTITY_HEALTH_KEYS, h as FLOW_KEYS, m as JOB_STATUS_KEYS, L as Locale, u as STAGE_STATUS_KEYS, G as UIStringKeys, H as UIStrings, U as UI_STRINGS, q as actionStatusLabels, x as actionTypeLabels, y as actionTypeVerbs, g as emotionLabels, e as engagementUiTranslations, B as entityHealthLabels, C as entityHealthPriority, j as flowLabels, r as formatRelativeLocaleTime, t as formatTimeRemaining, I as getUIStrings, o as isActiveJobStatus, D as isCriticalEntityHealth, i as isRTL, n as jobStatusLabels, s as sentimentLabels, l as severityLabels, v as stageStatusLabels, k as statusLabels } from './i18n-ArS3mqj0.js';
 import * as React$1 from 'react';
 import { LucideIcon } from 'lucide-react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
@@ -6,34 +9,54 @@ import * as AccordionPrimitive from '@radix-ui/react-accordion';
 import * as class_variance_authority_types from 'class-variance-authority/types';
 import { VariantProps } from 'class-variance-authority';
 import * as AlertDialogPrimitive from '@radix-ui/react-alert-dialog';
+export { AlertChannel, AlertRuleCard, AlertRuleCardProps } from './components/ui/alert-rule-card.js';
 import * as AspectRatioPrimitive from '@radix-ui/react-aspect-ratio';
-import * as AvatarPrimitive from '@radix-ui/react-avatar';
-import * as SeparatorPrimitive from '@radix-ui/react-separator';
-import { DayPicker, DateRange } from 'react-day-picker';
-import { DayPicker as DayPicker$1 } from 'react-day-picker/persian';
+export { Avatar, AvatarFallback, AvatarImage } from './components/ui/avatar.js';
+export { Badge, BadgeProps, badgeVariants } from './components/ui/badge.js';
+import { Button, ButtonProps } from './components/ui/button.js';
+export { ButtonVariantProps, LoadingVariantProps, buttonVariants } from './components/ui/button.js';
+import { Separator } from './components/ui/separator.js';
+export { Calendar, CalendarProps } from './components/ui/calendar.js';
+export { Card, CardContent, CardDescription, CardFooter, CardHeader, CardProps, CardTitle, cardVariants } from './components/ui/card.js';
 import useEmblaCarousel, { UseEmblaCarouselType } from 'embla-carousel-react';
 import * as CheckboxPrimitive from '@radix-ui/react-checkbox';
 import * as CollapsiblePrimitive from '@radix-ui/react-collapsible';
 import { Command as Command$1 } from 'cmdk';
-import * as DialogPrimitive from '@radix-ui/react-dialog';
+import { Dialog } from './components/ui/dialog.js';
+export { DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger } from './components/ui/dialog.js';
+import { HotkeyCombo } from './hooks/use-hotkeys.js';
+export { UseHotkeysOptions, formatHotkey, useHotkeys } from './hooks/use-hotkeys.js';
 import * as ContextMenuPrimitive from '@radix-ui/react-context-menu';
+import { S as SentimentData, F as FlowData } from './concept-card-CcOBb2Nz.js';
+export { C as ConceptCard, a as ConceptCardProps, b as FlowDistribution, c as FlowDistributionProps, d as SentimentDistribution, e as SentimentDistributionProps } from './concept-card-CcOBb2Nz.js';
+import { DateRange } from 'react-day-picker';
 import { Drawer as Drawer$1 } from 'vaul';
 import * as DropdownMenuPrimitive from '@radix-ui/react-dropdown-menu';
 import * as LabelPrimitive from '@radix-ui/react-label';
+import { FilterStateShape } from './components/ui/filter-provider.js';
+export { FilterContextValue, FilterProvider, FilterProviderProps, useFilterState, useFilterStateOptional } from './components/ui/filter-provider.js';
 import * as react_hook_form from 'react-hook-form';
 import { FieldValues, FieldPath, ControllerProps } from 'react-hook-form';
 import { Slot } from '@radix-ui/react-slot';
 import * as HoverCardPrimitive from '@radix-ui/react-hover-card';
+import { InputProps, Input, InputVariants } from './components/ui/input.js';
+export { inputVariants } from './components/ui/input.js';
+export { IranProvinceCell, IranProvinceHeat, IranProvinceHeatProps, IranProvinceHeatScale } from './components/ui/iran-province-heat.js';
 import { OTPInput } from 'input-otp';
 import * as MenubarPrimitive from '@radix-ui/react-menubar';
 import * as NavigationMenuPrimitive from '@radix-ui/react-navigation-menu';
-import * as PopoverPrimitive from '@radix-ui/react-popover';
+import { S as SocialPlatform } from './page-card-CO92oXkc.js';
+export { f as BotDetectionData, e as BotDetectionKey, B as BotDetectionMeter, g as BotDetectionMeterProps, P as PageCard, a as PageCardContentMix, b as PageCardProps, c as SocialPlatformBadge, d as SocialPlatformBadgeProps, s as socialPlatformBadgeVariants } from './page-card-CO92oXkc.js';
+export { Popover, PopoverAnchor, PopoverContent, PopoverTrigger } from './components/ui/popover.js';
 import * as ProgressPrimitive from '@radix-ui/react-progress';
 import * as RadioGroupPrimitive from '@radix-ui/react-radio-group';
 import * as ResizablePrimitive from 'react-resizable-panels';
 import * as ScrollAreaPrimitive from '@radix-ui/react-scroll-area';
 import * as SelectPrimitive from '@radix-ui/react-select';
-import * as TooltipPrimitive from '@radix-ui/react-tooltip';
+export { Sheet, SheetBody, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetTitle, SheetTrigger } from './components/ui/sheet.js';
+import { TooltipContent } from './components/ui/tooltip.js';
+export { Tooltip, TooltipProvider, TooltipTrigger } from './components/ui/tooltip.js';
+export { Sparkline, SparklineProps, SparklineTrend, SparklineVariant } from './components/ui/sparkline.js';
 import * as SliderPrimitive from '@radix-ui/react-slider';
 import { ToasterProps } from 'sonner';
 export { toast } from 'sonner';
@@ -41,38 +64,22 @@ 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';
-
-declare function cn(...inputs: ClassValue[]): string;
-type SupportedLocale = 'fa' | 'ar' | 'en';
-/**
- * Convert digits in a string to Persian/Arabic numerals based on locale.
- * @example convertToLocalNumbers('123', 'fa') => '۱۲۳'
- * @example convertToLocalNumbers('123', 'en') => '123'
- */
-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, 'en') => '1.5K'
- */
-declare function formatLargeNumber(num: number, locale: SupportedLocale): string;
-/**
- * Format number to Instagram-style short format (English only).
- * @example formatNumber(123456, 'short') => '123K'
- * @example formatNumber(123456, 'exact') => '123,456'
- */
-declare function formatNumber(num: number | undefined, format?: 'exact' | 'short'): string;
-/**
- * Format date to relative time with absolute on hover (Persian)
- * @example formatRelativeTime(new Date()) => '۲ ساعت پیش'
- */
-declare function formatRelativeTime(date: Date | string | number): string;
-/**
- * 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;
+import { DataTableColumn, DataTableColumnVisibility } from './components/ui/data-table.js';
+export { DataTable, DataTableExpansion, DataTableMultiSort, DataTablePagination, DataTableProps, DataTableSelection, DataTableSort, SortDirection, SortRule } from './components/ui/data-table.js';
+export { SavedQueryCard, SavedQueryCardProps, SavedQueryFilter } from './components/ui/saved-query-card.js';
+export { PartoLineChart, PartoLineChartProps } from './components/charts/PartoLineChart.js';
+export { PartoBarChart, PartoBarChartProps } from './components/charts/PartoBarChart.js';
+export { PartoPieChart, PartoPieChartProps } from './components/charts/PartoPieChart.js';
+export { PartoAreaChart, PartoAreaChartProps } from './components/charts/PartoAreaChart.js';
+import { RegisteredHotkey } from './hooks/use-hotkey-registry.js';
+export { HotkeyProvider, HotkeyProviderProps, useHotkey, useHotkeyRegistry } from './hooks/use-hotkey-registry.js';
+import 'clsx';
+import '@radix-ui/react-avatar';
+import '@radix-ui/react-separator';
+import 'react-day-picker/persian';
+import '@radix-ui/react-dialog';
+import '@radix-ui/react-popover';
+import '@radix-ui/react-tooltip';
 
 /**
  * Persian (Jalali / Solar Hijri) calendar utilities.
@@ -201,219 +208,66 @@ 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.
+ * Iran's 31 provinces with trilingual labels and ISO 3166-2 codes.
+ *
+ * Use as a stable identifier source for `IranProvinceHeat`, `RegionPicker`,
+ * and any public-opinion dashboard scoped by استان. The slug (`code`) is the
+ * canonical key — never rely on label string equality, since labels are
+ * locale-dependent and may evolve.
+ *
+ * Codes follow ISO 3166-2:IR (e.g. 'IR-07' for Tehran). The slug is the
+ * lowercased, hyphenated English name without diacritics, suitable for URLs
+ * and CSS selectors. Use `getProvinceLabel(code, locale)` to resolve a label.
  */
-declare const engagementUiTranslations: Record<SupportedLocale, {
-    yourCategory: string;
-    influencer: string;
-    followers: string;
-    over: string;
-    to: string;
-    and: string;
-    lessThan: string;
-    you: string;
-    criteria: string;
-}>;
+
+interface IranProvince {
+    /** Stable URL-safe slug. The canonical key for province lookups. */
+    slug: string;
+    /** ISO 3166-2:IR code (e.g. 'IR-07'). */
+    iso: string;
+    /** Trilingual labels — fa is the canonical/native form. */
+    labels: Record<SupportedLocale, string>;
+}
+declare const IRAN_PROVINCES: readonly IranProvince[];
+type IranProvinceSlug = (typeof IRAN_PROVINCES)[number]['slug'];
+/** Look up a province by slug or ISO code. Returns undefined for unknown codes. */
+declare function findProvince(codeOrSlug: string): IranProvince | undefined;
 /**
- * Sentiment label translations used by the SentimentBadge component.
+ * Resolve the locale-appropriate label for a province slug or ISO code.
+ * Falls back to fa for unknown locales and to the slug itself for unknown
+ * provinces (so the row still renders something instead of crashing).
  */
-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.
- */
-declare const UI_STRINGS: {
-    readonly fa: {
-        readonly noResults: "نتیجه‌ای یافت نشد";
-        readonly suggestions: "پیشنهادها";
-        readonly select: "انتخاب کنید";
-        readonly noOptionsFound: "موردی یافت نشد";
-        readonly search: "جستجو...";
-        readonly clearAll: "پاک کردن همه";
-        readonly selectDate: "انتخاب تاریخ";
-        readonly selectDateRange: "انتخاب بازه تاریخ";
-        readonly errorLoadingData: "خطا در بارگذاری داده‌ها";
-        readonly retry: "تلاش مجدد";
-        readonly remove: "حذف";
-        readonly noUsersFound: "کاربری یافت نشد";
-        readonly goToPreviousPage: "رفتن به صفحه قبلی";
-        readonly goToNextPage: "رفتن به صفحه بعدی";
-        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: "لم يتم العثور على نتائج";
-        readonly suggestions: "اقتراحات";
-        readonly select: "اختر";
-        readonly noOptionsFound: "لم يتم العثور على خيارات";
-        readonly search: "بحث...";
-        readonly clearAll: "مسح الكل";
-        readonly selectDate: "اختر تاريخ";
-        readonly selectDateRange: "اختر نطاق التاريخ";
-        readonly errorLoadingData: "خطأ في تحميل البيانات";
-        readonly retry: "إعادة المحاولة";
-        readonly remove: "حذف";
-        readonly noUsersFound: "لم يتم العثور على مستخدمين";
-        readonly goToPreviousPage: "الانتقال إلى الصفحة السابقة";
-        readonly goToNextPage: "الانتقال إلى الصفحة التالية";
-        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";
-        readonly suggestions: "Suggestions";
-        readonly select: "Select";
-        readonly noOptionsFound: "No options found";
-        readonly search: "Search...";
-        readonly clearAll: "Clear all";
-        readonly selectDate: "Select date";
-        readonly selectDateRange: "Select date range";
-        readonly errorLoadingData: "Error loading data";
-        readonly retry: "Retry";
-        readonly remove: "Remove";
-        readonly noUsersFound: "No users found";
-        readonly goToPreviousPage: "Go to previous page";
-        readonly goToNextPage: "Go to next page";
-        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'];
-type UIStrings = Record<UIStringKeys, string>;
+declare function getProvinceLabel(codeOrSlug: string, locale?: SupportedLocale): string;
+
 /**
- * Get UI strings for a given locale.
- * Falls back to 'fa' for unknown locales.
+ * Curated country list with trilingual labels + flag emoji.
+ *
+ * Scope: ISO 3166-1 alpha-2 codes for ~80 countries that recur in افکارسنجی
+ * and influencer dashboards we serve — neighbors of Iran, the Gulf, MENA,
+ * major Western markets, and Asian/African markets relevant to Persian-
+ * speaking audiences. The flag emoji is the regional-indicator pair for the
+ * code; modern OS fonts render it as a flag.
+ *
+ * This is NOT an exhaustive ISO 3166 dataset — for country-level analytics
+ * outside this scope, consumers should pass their own list to `CountryPicker`
+ * via the `options` prop.
  */
-declare function getUIStrings(locale?: SupportedLocale): UIStrings;
+
+interface Country {
+    /** ISO 3166-1 alpha-2 code (uppercase). The canonical key. */
+    code: string;
+    /** Trilingual labels — fa is the canonical/native form. */
+    labels: Record<SupportedLocale, string>;
+}
+/** Convert an ISO 3166-1 alpha-2 code to its flag-emoji pair. */
+declare function countryFlag(code: string): string;
+declare const COUNTRIES: readonly Country[];
+type CountryCode = (typeof COUNTRIES)[number]['code'];
+/** Look up a country by ISO 3166-1 alpha-2 code. Returns undefined for unknown codes. */
+declare function findCountry(code: string): Country | undefined;
+/** Resolve the locale-appropriate label for a country code. */
+declare function getCountryLabel(code: string, locale: SupportedLocale): string;
 
 /**
  * Standard size scale used across the design system.
@@ -465,8 +319,87 @@ declare namespace AccordionContent {
     var displayName: string;
 }
 
+interface ActionTimelineItemData {
+    /** Stable identifier */
+    id: string;
+    /** Outcome of the action. Drives the marker colour/icon when `leading` isn't set. @default "info" */
+    status?: ActionStatusKey;
+    /** Primary text — actor + verb + target. */
+    title: React$1.ReactNode;
+    /** Optional one-line description under the title. */
+    description?: React$1.ReactNode;
+    /** Optional preview (comment text, error message, diff snippet). Rendered in a muted box. */
+    preview?: React$1.ReactNode;
+    /** Optional small tag next to the timestamp (e.g. "Instagram", "AI", "System"). */
+    tag?: React$1.ReactNode;
+    /** Optional trailing actions (buttons, dropdown). */
+    actions?: React$1.ReactNode;
+    /** When this action happened. Accepts Date | ISO string | epoch ms. */
+    timestamp: Date | string | number;
+    /** Override the leading marker — pass an `<Avatar />`, custom icon, etc. */
+    leading?: React$1.ReactNode;
+}
+type ActionTimelineDensity = 'compact' | 'default' | 'spacious';
+type ActionTimelineGroupBy = 'none' | 'day';
+interface ActionTimelineProps extends Omit<React$1.OlHTMLAttributes<HTMLOListElement>, 'children'> {
+    /** Data-driven item list. Mutually exclusive with `children`. */
+    items?: ActionTimelineItemData[];
+    /** Composition API — pass `<ActionTimelineItem>` children. */
+    children?: React$1.ReactNode;
+    /** Visual density @default "default" */
+    density?: ActionTimelineDensity;
+    /** Group adjacent items under sticky day headers */
+    groupBy?: ActionTimelineGroupBy;
+    /** Locale for timestamp formatting + status aria-labels @default "fa" */
+    locale?: SupportedLocale;
+    /** Hide the vertical connector line between items @default false */
+    hideConnector?: boolean;
+    /** Maximum items to render. When set and exceeded, caller is responsible for pagination UI. */
+    limit?: number;
+    /** Fires when an item is clicked (anywhere outside the `actions` slot) */
+    onItemSelect?: (item: ActionTimelineItemData, index: number) => void;
+    /** Empty state when items is empty / undefined and no children provided */
+    emptyState?: React$1.ReactNode;
+}
+interface ActionTimelineItemProps extends ActionTimelineItemData {
+}
+/**
+ * Optional composition wrapper. Use inside `<ActionTimeline>` instead of the
+ * `items` prop — ActionTimeline injects the position metadata automatically.
+ * Throws if rendered outside <ActionTimeline>.
+ */
+declare function ActionTimelineItem(props: ActionTimelineItemProps): React$1.ReactElement;
+declare const ActionTimeline: React$1.ForwardRefExoticComponent<ActionTimelineProps & React$1.RefAttributes<HTMLOListElement>>;
+
+interface ActionTypeMeta {
+    /** CSS var fragment — read as `hsl(var(--action-type-foo))` */
+    token: string;
+    /** Lucide icon for the action */
+    icon: React$1.ComponentType<{
+        className?: string;
+    }>;
+}
+declare const ACTION_TYPE_META: Record<ActionTypeKey, ActionTypeMeta>;
+declare const actionTypeChipVariants: (props?: ({
+    size?: "xs" | "sm" | "md" | "lg" | null | undefined;
+    variant?: "flat" | "soft" | "solid" | "outline" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface ActionTypeChipProps extends Omit<React$1.HTMLAttributes<HTMLSpanElement>, 'children'>, VariantProps<typeof actionTypeChipVariants> {
+    /** Which action the chip represents */
+    type: ActionTypeKey;
+    /** Show the localized label after the icon @default true */
+    showLabel?: boolean;
+    /** Show a counter next to the label (e.g., "Like ۴۲۵") */
+    count?: number;
+    /** Locale for default label + digit formatting @default "fa" */
+    locale?: SupportedLocale;
+    /** Override the label (otherwise uses `actionTypeLabels[locale][type]`) */
+    label?: React$1.ReactNode;
+}
+declare const ActionTypeChip: React$1.ForwardRefExoticComponent<ActionTypeChipProps & React$1.RefAttributes<HTMLSpanElement>>;
+
 declare const Alert: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & VariantProps<(props?: ({
-    variant?: "info" | "default" | "success" | "warning" | "destructive" | null | undefined;
+    variant?: "warning" | "success" | "info" | "default" | "destructive" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string> & React$1.RefAttributes<HTMLDivElement>>;
 declare const AlertTitle: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLHeadingElement> & React$1.RefAttributes<HTMLParagraphElement>>;
 declare const AlertDescription: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLParagraphElement> & React$1.RefAttributes<HTMLParagraphElement>>;
@@ -718,19 +651,6 @@ declare namespace AspectRatio {
     var displayName: string;
 }
 
-declare function Avatar({ className, ...props }: React$1.ComponentProps<typeof AvatarPrimitive.Root>): react_jsx_runtime.JSX.Element;
-declare namespace Avatar {
-    var displayName: string;
-}
-declare function AvatarImage({ className, ...props }: React$1.ComponentProps<typeof AvatarPrimitive.Image>): react_jsx_runtime.JSX.Element;
-declare namespace AvatarImage {
-    var displayName: string;
-}
-declare function AvatarFallback({ className, ...props }: React$1.ComponentProps<typeof AvatarPrimitive.Fallback>): react_jsx_runtime.JSX.Element;
-declare namespace AvatarFallback {
-    var displayName: string;
-}
-
 declare const avatarGroupVariants: (props?: ({
     size?: "sm" | "md" | "lg" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
@@ -747,19 +667,8 @@ interface AvatarGroupProps extends React$1.HTMLAttributes<HTMLDivElement>, Varia
 }
 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" | "small" | "tiny" | "large" | null | undefined;
-    dot?: boolean | null | undefined;
-} & class_variance_authority_types.ClassProp) | undefined) => string;
-interface BadgeProps extends React$1.HTMLAttributes<HTMLSpanElement>, VariantProps<typeof badgeVariants> {
-    dot?: boolean;
-    dotPosition?: 'start' | 'end';
-}
-declare const Badge: React$1.ForwardRefExoticComponent<BadgeProps & React$1.RefAttributes<HTMLSpanElement>>;
-
 declare const bannerVariants: (props?: ({
-    variant?: "info" | "success" | "warning" | "destructive" | "neutral" | null | undefined;
+    variant?: "neutral" | "warning" | "success" | "info" | "destructive" | 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 */
@@ -804,43 +713,6 @@ declare namespace BreadcrumbEllipsis {
     var displayName: string;
 }
 
-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" | "default" | "icon" | null | undefined;
-    disabled?: boolean | null | undefined;
-    rounded?: boolean | null | undefined;
-} & class_variance_authority_types.ClassProp) | undefined) => string;
-type LoadingVariantProps = VariantProps<typeof loadingVariants>;
-declare const loadingVariants: (props?: ({
-    variant?: "link" | "text" | "default" | "warning" | "destructive" | "primary" | "secondary" | "outline" | "dashed" | "danger" | "ghost" | null | undefined;
-    loading?: boolean | "default" | null | undefined;
-} & class_variance_authority_types.ClassProp) | undefined) => string;
-interface ButtonProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, 'type'>, Omit<ButtonVariantProps, 'disabled'>, Omit<LoadingVariantProps, 'variant'> {
-    asChild?: boolean;
-    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 */
-    loading?: boolean;
-    block?: boolean;
-    rounded?: boolean;
-}
-declare const Button: React$1.ForwardRefExoticComponent<ButtonProps & React$1.RefAttributes<HTMLButtonElement>>;
-
-interface SeparatorProps extends React$1.ComponentPropsWithoutRef<typeof SeparatorPrimitive.Root> {
-    children?: React$1.ReactNode;
-}
-declare const Separator: React$1.ForwardRefExoticComponent<SeparatorProps & React$1.RefAttributes<HTMLDivElement>>;
-
 declare const buttonGroupVariants: (props?: ({
     orientation?: "horizontal" | "vertical" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
@@ -859,30 +731,6 @@ declare namespace ButtonGroupSeparator {
     var displayName: string;
 }
 
-type CalendarProps = {
-    usePersianCalendar?: boolean;
-    className?: string;
-    classNames?: Partial<Record<string, string>>;
-    showOutsideDays?: boolean;
-} & (React$1.ComponentProps<typeof DayPicker> | React$1.ComponentProps<typeof DayPicker$1>);
-declare function Calendar({ className, classNames, showOutsideDays, usePersianCalendar, ...props }: CalendarProps): react_jsx_runtime.JSX.Element;
-declare namespace Calendar {
-    var displayName: string;
-}
-
-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>>;
-declare const CardTitle: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLHeadingElement> & React$1.RefAttributes<HTMLParagraphElement>>;
-declare const CardDescription: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLParagraphElement> & React$1.RefAttributes<HTMLParagraphElement>>;
-declare const CardContent: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & React$1.RefAttributes<HTMLDivElement>>;
-declare const CardFooter: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & React$1.RefAttributes<HTMLDivElement>>;
-
 type CarouselApi = UseEmblaCarouselType[1];
 type UseCarouselParameters = Parameters<typeof useEmblaCarousel>;
 type CarouselOptions = UseCarouselParameters[0];
@@ -949,23 +797,6 @@ declare namespace CollapsibleContent {
     var displayName: string;
 }
 
-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<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: {
-    ({ className, ...props }: React$1.HTMLAttributes<HTMLDivElement>): react_jsx_runtime.JSX.Element;
-    displayName: string;
-};
-declare const DialogFooter: {
-    ({ className, ...props }: React$1.HTMLAttributes<HTMLDivElement>): react_jsx_runtime.JSX.Element;
-    displayName: string;
-};
-declare const DialogTitle: React$1.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogTitleProps & React$1.RefAttributes<HTMLHeadingElement>, "ref"> & React$1.RefAttributes<HTMLHeadingElement>>;
-declare const DialogDescription: React$1.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogDescriptionProps & React$1.RefAttributes<HTMLParagraphElement>, "ref"> & React$1.RefAttributes<HTMLParagraphElement>>;
-
 declare function Command({ className, ...props }: React$1.ComponentProps<typeof Command$1>): react_jsx_runtime.JSX.Element;
 declare namespace Command {
     var displayName: string;
@@ -1007,6 +838,457 @@ declare namespace CommandShortcut {
     var displayName: string;
 }
 
+interface CommandPaletteItem {
+    /** Stable identifier. Used as the cmdk value and the recents key — MUST be unique across the whole items list. */
+    id: string;
+    /** Visible label. */
+    label: string;
+    /** Dimmer description shown under the label. */
+    description?: string;
+    /** Icon displayed at the start of the row. */
+    icon?: LucideIcon | React$1.ComponentType<{
+        className?: string;
+    }>;
+    /** Group heading under which this item appears. Items without a group are rendered in the root group. */
+    group?: string;
+    /**
+     * Keyboard-shortcut display, using the same grammar as {@link HotkeyCombo}
+     * (e.g. 'mod+d'). The palette only displays it — binding the global shortcut
+     * is the caller's responsibility via {@link useHotkeys} at the host component.
+     */
+    shortcut?: string;
+    /** Extra search tokens not visible in the label (e.g., English aliases, acronyms, tag words). */
+    keywords?: string[];
+    /** Callback when item is selected. Palette closes automatically afterwards. */
+    onSelect: () => void;
+    /** Prevents selection + dims the row. */
+    disabled?: boolean;
+}
+interface CommandPaletteRecentsConfig {
+    /** Persistence key. Default: `'parto:cmdk:recents'`. Namespace by app if you mount multiple palettes. */
+    key?: string;
+    /** Max items to remember. Default: 5. */
+    max?: number;
+    /** Header label for the recents group. Default: locale-appropriate ('اخیر'/'Recent'). */
+    label?: string;
+}
+interface CommandPaletteProps {
+    /** Controlled open state. If omitted, palette manages its own state. */
+    open?: boolean;
+    /** Fires on both open and close. */
+    onOpenChange?: (open: boolean) => void;
+    /** Items to display. Grouped by `item.group` in insertion order. */
+    items: CommandPaletteItem[];
+    /**
+     * Global keyboard shortcut to toggle the palette. Default: `'mod+k'`.
+     * Pass `false` to disable the global listener (useful when wiring your own).
+     */
+    shortcut?: HotkeyCombo | false;
+    /** Placeholder for the input. Defaults to a locale-appropriate string. */
+    placeholder?: string;
+    /** Shown inside `<CommandEmpty>` when there are no matches. */
+    emptyMessage?: string;
+    /** Screen-reader title (visually hidden). */
+    title?: string;
+    /** Screen-reader description (visually hidden). */
+    description?: string;
+    /** Locale for default strings + Persian-aware fuzzy matching. */
+    locale?: SupportedLocale;
+    /**
+     * Remember recently-selected items in localStorage and surface them as a top
+     * group when the search input is empty. Pass `false` to disable. Default: on.
+     */
+    recents?: CommandPaletteRecentsConfig | false;
+    /** Extra class for the dialog content. */
+    className?: string;
+}
+declare function CommandPalette({ open: controlledOpen, onOpenChange, items, shortcut, placeholder, emptyMessage, title, description, locale, recents: recentsConfig, className, }: CommandPaletteProps): react_jsx_runtime.JSX.Element;
+declare namespace CommandPalette {
+    var displayName: string;
+}
+
+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;
+    /**
+     * Locale for digit formatting in tooltips and angle-axis labels. fa/ar
+     * convert embedded digits to Persian/Arabic; en uses Latin. Default: 'fa'.
+     */
+    locale?: SupportedLocale;
+    className?: string;
+    isLoading?: boolean;
+    ariaLabel?: string;
+}
+declare const PartoRadarChart: React$1.ForwardRefExoticComponent<PartoRadarChartProps & React$1.RefAttributes<HTMLDivElement>>;
+
+interface ComparisonMetric {
+    /** Unique key — used to look up values in each entity. */
+    key: string;
+    /** Human-readable label shown on the radar axis + tooltip. */
+    label: string;
+    /**
+     * True means a higher value is better (the default for most scores).
+     * Set to false for inverted metrics like error rate or response time.
+     * @default true
+     */
+    higherIsBetter?: boolean;
+    /**
+     * Informational — maximum expected value for this metric. Not used by the
+     * radar geometry (auto-scaled); used by the tooltip for "x / max" display.
+     */
+    max?: number;
+}
+interface ComparisonEntity {
+    /** Unique id — used as the `dataKey` for the radar series. */
+    key: string;
+    /** Display name in the legend. */
+    label: string;
+    /** Metric key → numeric value. Missing keys are treated as 0. */
+    values: Record<string, number>;
+    /** Optional custom color — defaults to the chart palette. */
+    color?: string;
+}
+interface ComparisonWinner {
+    /** Entity key (or null for a tie). */
+    winnerKey: string | null;
+    /** All entity keys tied at the top. Length >=1 when there is data; empty if no entities. */
+    topKeys: string[];
+    /** Top value for this metric (after higherIsBetter direction). */
+    topValue: number;
+}
+/**
+ * For each metric, compute the entity that "wins" (highest value, or lowest
+ * if `higherIsBetter: false`). Ties return winnerKey=null.
+ */
+declare function computeComparisonWinners(metrics: ComparisonMetric[], entities: ComparisonEntity[]): Record<string, ComparisonWinner>;
+/** Count outright wins (no ties) per entity. */
+declare function countComparisonWins(winners: Record<string, ComparisonWinner>): Record<string, number>;
+interface ComparisonRadarProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, 'title'> {
+    /** Metric axes of the radar. Order matters — these render clockwise from the top. */
+    metrics: ComparisonMetric[];
+    /** Entities being compared (typically 2-5). */
+    entities: ComparisonEntity[];
+    /** Annotate axis labels with a crown for the winner @default true */
+    showWinnerMarkers?: boolean;
+    /** Show the rich legend with win counts above the chart @default true */
+    showLegend?: boolean;
+    /** Card title */
+    title?: React$1.ReactNode;
+    /** Short description below title */
+    description?: React$1.ReactNode;
+    /** Chart height in pixels @default 340 */
+    chartHeight?: number;
+    /** Loading state */
+    isLoading?: boolean;
+    /** Locale @default "fa" */
+    locale?: SupportedLocale;
+    /**
+     * Custom radar props — pass-through to PartoRadarChart (margin, fillOpacity,
+     * gridType, …). Avoid setting `data` / `dataKeys` / `indexBy` / `isLoading`.
+     */
+    radarProps?: Omit<React$1.ComponentProps<typeof PartoRadarChart>, 'data' | 'dataKeys' | 'indexBy' | 'isLoading'>;
+}
+declare const ComparisonRadar: React$1.ForwardRefExoticComponent<ComparisonRadarProps & React$1.RefAttributes<HTMLDivElement>>;
+
+type NotificationSeverity = 'info' | 'warning' | 'destructive' | 'success' | 'critical';
+interface NotificationItem {
+    /** Stable id — required for `onMarkRead` / `onDismiss` to target a specific item. */
+    id: string;
+    /** Short headline. Keep under ~60 chars to avoid wrapping beyond two lines. */
+    title: string;
+    /** Longer body text. Truncated to 3 lines by default. */
+    body?: string;
+    /** ISO date string, Date instance, or epoch ms. */
+    timestamp: string | number | Date;
+    /** Severity drives the side-border + dot color. Defaults to `'info'`. */
+    severity?: NotificationSeverity;
+    /** Optional icon — replaces the severity dot when supplied. */
+    icon?: LucideIcon;
+    /** `true` renders the item in a read/dim state (no unread dot, lower contrast). */
+    read?: boolean;
+    /**
+     * Row-level callback — fires when the item body is clicked. Typical use:
+     * navigate to the source. The palette closes afterwards.
+     */
+    onSelect?: () => void;
+    /** Inline action button rendered inside the row (e.g., "Approve", "Open"). */
+    action?: {
+        label: string;
+        onClick: () => void;
+    };
+}
+interface NotificationFilter {
+    /** Stable key for the tab. */
+    key: string;
+    /** Visible label. */
+    label: string;
+    /** Predicate — items returning `true` are shown when this filter is active. */
+    predicate: (item: NotificationItem) => boolean;
+}
+interface NotificationCenterProps {
+    /** Items to render. Consumer owns the array (mark-as-read / dismiss happen in your store). */
+    items: NotificationItem[];
+    /** Fires when user clicks an unread item, or the "mark read" action on it. */
+    onMarkRead?: (id: string) => void;
+    /** Fires when user clicks "mark all read". */
+    onMarkAllRead?: () => void;
+    /** Fires when user clicks the × on an item. If absent, dismiss is hidden. */
+    onDismiss?: (id: string) => void;
+    /** Optional tabs. First filter is active by default unless `defaultFilter` supplied. */
+    filters?: NotificationFilter[];
+    /** Key of the filter active on first render. */
+    defaultFilter?: string;
+    /** Optional per-filter active control. When set, tabs become controlled. */
+    activeFilter?: string;
+    onFilterChange?: (key: string) => void;
+    /** Max CSS height of the scrollable list. Default `'420px'`. */
+    maxHeight?: string;
+    /** Locale for label strings + digit formatting. */
+    locale?: SupportedLocale;
+    /** Controlled open. */
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    /** Custom empty message. */
+    emptyMessage?: string;
+    /** Aria-label on the bell trigger. */
+    triggerLabel?: string;
+    /** Extra class on the trigger button. */
+    triggerClassName?: string;
+    /** Extra class on the popover content. */
+    className?: string;
+    /** Override relative-time formatter (default uses `formatRelativeTime` — Persian-biased). */
+    formatTime?: (date: Date) => string;
+}
+declare function NotificationCenter({ items, onMarkRead, onMarkAllRead, onDismiss, filters, defaultFilter, activeFilter: controlledFilter, onFilterChange, maxHeight, locale, open: controlledOpen, onOpenChange, emptyMessage, triggerLabel, triggerClassName, className, formatTime, }: NotificationCenterProps): react_jsx_runtime.JSX.Element;
+declare namespace NotificationCenter {
+    var displayName: string;
+}
+
+declare const siteHeaderVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface SiteHeaderProps extends React$1.HTMLAttributes<HTMLElement>, VariantProps<typeof siteHeaderVariants> {
+}
+/**
+ * Opinionated app-shell header for multi-screen dashboards. Compose with the
+ * sub-components: `<SiteHeaderStart>` / `<SiteHeaderEnd>` plus the small
+ * primitives (`Breadcrumb`, `SiteHeaderTitle`, `SiteHeaderSubtitle`,
+ * `SiteHeaderActions`, `SiteHeaderSeparator`).
+ *
+ * For a low-level prop-based layout use {@link AppBar} instead.
+ */
+declare const SiteHeader: React$1.ForwardRefExoticComponent<SiteHeaderProps & React$1.RefAttributes<HTMLElement>>;
+/** Inline-start slot. Holds breadcrumb + title stack. Grows to fill space. */
+declare const SiteHeaderStart: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & React$1.RefAttributes<HTMLDivElement>>;
+/** Inline-end slot. Holds actions + notifications + user menu. Shrinks to content. */
+declare const SiteHeaderEnd: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & React$1.RefAttributes<HTMLDivElement>>;
+/** Main page title. Single line, truncates. */
+declare const SiteHeaderTitle: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLHeadingElement> & React$1.RefAttributes<HTMLHeadingElement>>;
+/** Optional tagline under the title. Single line, truncates. */
+declare const SiteHeaderSubtitle: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLParagraphElement> & React$1.RefAttributes<HTMLParagraphElement>>;
+/**
+ * Stack helper — wraps breadcrumb / title / subtitle vertically. Use inside
+ * `SiteHeaderStart` when you want a conventional "breadcrumb-above-title" layout.
+ */
+declare const SiteHeaderTitleGroup: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & React$1.RefAttributes<HTMLDivElement>>;
+/** Group container for icon-only action buttons. */
+declare const SiteHeaderActions: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & React$1.RefAttributes<HTMLDivElement>>;
+/** Vertical separator between action clusters. */
+declare const SiteHeaderSeparator: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLSpanElement> & React$1.RefAttributes<HTMLSpanElement>>;
+
+interface UserMenuUser {
+    name: string;
+    email?: string;
+    avatar?: string;
+    /** Fallback initials when the avatar image is missing or fails to load. */
+    avatarFallback?: string;
+    /** Optional role / org label shown under the name. */
+    role?: string;
+}
+/** Discriminated item union for the dropdown body. */
+type UserMenuItem = {
+    type?: 'item';
+    label: string;
+    icon?: React$1.ComponentType<{
+        className?: string;
+    }>;
+    /** Hotkey string passed to `formatHotkey`, e.g. `'mod+,'`. */
+    shortcut?: string;
+    onSelect: () => void;
+    destructive?: boolean;
+    disabled?: boolean;
+} | {
+    type: 'separator';
+} | {
+    type: 'label';
+    label: string;
+} | {
+    type: 'submenu';
+    label: string;
+    icon?: React$1.ComponentType<{
+        className?: string;
+    }>;
+    items: UserMenuItem[];
+};
+interface UserMenuProps {
+    /** The current user shown in the dropdown header + trigger avatar. */
+    user: UserMenuUser;
+    /** Dropdown rows. Use the discriminated union for item / separator / label / submenu. */
+    items: UserMenuItem[];
+    /** Controlled open. */
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    /** Locale for default labels. Defaults to `'fa'`. */
+    locale?: SupportedLocale;
+    /** Show email + role block in the dropdown header. Default `true`. */
+    showUserHeader?: boolean;
+    /** Show the name next to the avatar on the trigger (hidden on mobile by default). Default `false`. */
+    showNameInTrigger?: boolean;
+    /** Trigger size. */
+    size?: 'sm' | 'md';
+    /** Extra class on the trigger button. */
+    triggerClassName?: string;
+    /** Extra class on the dropdown content. */
+    className?: string;
+    /** `data-slot` override (useful when nesting inside another component's analytics tree). */
+    'data-slot'?: string;
+}
+declare const UserMenu: React$1.ForwardRefExoticComponent<UserMenuProps & React$1.RefAttributes<HTMLButtonElement>>;
+
+interface RouteProgressProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    /**
+     * Controlled visibility. If omitted, the component stays mounted but hidden —
+     * fire the `start`/`finish` methods on the ref instead.
+     */
+    active?: boolean;
+    /** Progress value (0–1). Default: auto-trickle while active. */
+    value?: number;
+    /**
+     * How long to trickle before the bar caps out near the end (matches
+     * NProgress-style UX). Default: 800ms per step.
+     */
+    trickleInterval?: number;
+    /**
+     * Value the bar tops out at while waiting for `active=false` (so the page
+     * change still feels snappy). Default: 0.9 — never completes automatically.
+     */
+    trickleCap?: number;
+    /** Height in pixels. Default: 2. */
+    height?: number;
+    /** Position. `'top'` (default) sticks to the top edge; `'bottom'` for e.g. drawers. */
+    position?: 'top' | 'bottom';
+}
+interface RouteProgressHandle {
+    /** Reset + show the bar. */
+    start: () => void;
+    /** Snap to 100% then hide after a short fade-out. */
+    finish: () => void;
+}
+/**
+ * Thin gradient progress bar for route/page transitions. Three usage modes:
+ *
+ * 1. **Controlled** — pass `active={true/false}` and let the component trickle
+ *    automatically while `active` is true:
+ *    ```tsx
+ *    <RouteProgress active={isNavigating} />
+ *    ```
+ *
+ * 2. **Imperative** — call `start()` / `finish()` on the ref:
+ *    ```tsx
+ *    const ref = useRef<RouteProgressHandle>(null)
+ *    ref.current?.start()
+ *    // ... navigate ...
+ *    ref.current?.finish()
+ *    ```
+ *
+ * 3. **Fully controlled value** — pass a numeric `value` in `[0, 1]` and skip
+ *    `active` entirely. Useful for file uploads or long-running jobs.
+ */
+declare const RouteProgress: React$1.ForwardRefExoticComponent<RouteProgressProps & React$1.RefAttributes<RouteProgressHandle>>;
+
+type NavMatchStrategy = 'exact' | 'prefix';
+interface NavTreeContextValue {
+    /** Current pathname — used to decide which `NavItem.href` is active. */
+    activePath: string;
+    /** Match strategy. Default `'prefix'` matches `/clusters` for both `/clusters` and `/clusters/42`. */
+    matchStrategy: NavMatchStrategy;
+}
+declare function useNavTree(): NavTreeContextValue;
+interface NavTreeProviderProps {
+    /** Current pathname. For Next.js, pass `usePathname()`. */
+    activePath: string;
+    /** How NavItem `href` matches `activePath`. Default: `'prefix'`. */
+    matchStrategy?: NavMatchStrategy;
+    children: React$1.ReactNode;
+}
+declare function NavTreeProvider({ activePath, matchStrategy, children }: NavTreeProviderProps): react_jsx_runtime.JSX.Element;
+/** Outer container. Mostly a semantic `<nav>` wrapper — accepts any children. */
+declare const NavTree: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLElement> & React$1.RefAttributes<HTMLElement>>;
+interface NavGroupProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, 'role'> {
+    /** Visible group heading. Clickable if `collapsible` (default true). */
+    heading?: React$1.ReactNode;
+    /** Whether the header toggles visibility of children. Default `true` if `heading` is set. */
+    collapsible?: boolean;
+    /** Initial open state (uncontrolled). Default `true`. */
+    defaultOpen?: boolean;
+    /** Controlled open state. */
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+}
+declare const NavGroup: React$1.ForwardRefExoticComponent<NavGroupProps & React$1.RefAttributes<HTMLDivElement>>;
+declare const NavSeparator: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLHRElement> & React$1.RefAttributes<HTMLHRElement>>;
+declare const navItemVariants: (props?: ({
+    size?: "sm" | "md" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface NavItemBaseProps extends VariantProps<typeof navItemVariants> {
+    /** Link target. If set, NavItem renders as `<a>`. */
+    href?: string;
+    /** Click handler. If set (and `href` not set), NavItem renders as `<button>`. */
+    onClick?: React$1.MouseEventHandler<HTMLElement>;
+    /** Leading icon. */
+    icon?: React$1.ComponentType<{
+        className?: string;
+    }>;
+    /** Optional trailing badge (count, "new", etc.). */
+    badge?: React$1.ReactNode;
+    /** Custom `data-active` override. Use to short-circuit path matching. */
+    active?: boolean;
+    /** Skip the active-cascade report to parent (useful for informational items). */
+    skipActiveReport?: boolean;
+    /** Render-as override — passes all props to the given component. */
+    asChild?: boolean;
+    /** Disables interaction + dims the row. */
+    disabled?: boolean;
+    /** External link hint — opens in a new tab with `rel="noopener noreferrer"`. */
+    external?: boolean;
+}
+interface NavItemProps extends NavItemBaseProps, Omit<React$1.HTMLAttributes<HTMLElement>, 'onClick'> {
+}
+declare const NavItem: React$1.ForwardRefExoticComponent<NavItemProps & React$1.RefAttributes<HTMLElement>>;
+
 interface CommentTag {
     title: string;
     probability: number;
@@ -1139,6 +1421,78 @@ interface CopyButtonProps extends Omit<ButtonProps, 'onClick'> {
 }
 declare const CopyButton: React$1.ForwardRefExoticComponent<CopyButtonProps & React$1.RefAttributes<HTMLButtonElement>>;
 
+type CriterionTierKey = 'excellent' | 'good' | 'moderate' | 'poor' | 'critical';
+declare const CRITERION_TIER_KEYS: readonly CriterionTierKey[];
+interface CriterionTierThresholds {
+    /** Minimum score for "excellent" @default 80 */
+    excellent: number;
+    /** Minimum score for "good" @default 60 */
+    good: number;
+    /** Minimum score for "moderate" @default 40 */
+    moderate: number;
+    /** Minimum score for "poor" @default 20 (below → "critical") */
+    poor: number;
+}
+declare const DEFAULT_CRITERION_THRESHOLDS: CriterionTierThresholds;
+/**
+ * Auto-classify a score into one of the 5 canonical tiers based on thresholds.
+ * Assumes score is normalized to [0, max]; will return a tier even if score
+ * is out of range (clamped behaviour).
+ */
+declare function getCriterionTier(score: number, max?: number, thresholds?: CriterionTierThresholds): CriterionTierKey;
+interface CriterionInputSpec {
+    /** Short label for the input (e.g., "نرخ تعامل") */
+    label?: React$1.ReactNode;
+    /** Displayed value (e.g., "۳.۲٪", "+۱۲۰ فالوور", "۵۰۰ کلمه") */
+    value: React$1.ReactNode;
+}
+interface CriterionTrend {
+    /** Delta in points (not percent). Positive = higher score than baseline. */
+    delta: number;
+    /** Optional label describing the baseline (e.g., "نسبت به ماه قبل") */
+    label?: React$1.ReactNode;
+}
+interface CriterionScoreCardProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    /** Name of the criterion (e.g., "نرخ تعامل") */
+    name: React$1.ReactNode;
+    /** Short description of how the score is computed */
+    description?: React$1.ReactNode;
+    /** Computed score */
+    score: number;
+    /** Max of the score scale @default 100 */
+    max?: number;
+    /**
+     * Weight in a composite score (0..1). Rendered as "۶۰٪" badge in the header.
+     * When weight=0, the badge still renders — pass `undefined` to hide it.
+     */
+    weight?: number;
+    /** Raw input that produced the score (for transparency) */
+    input?: CriterionInputSpec;
+    /** Change vs a baseline, shown next to the score */
+    trend?: CriterionTrend;
+    /**
+     * Tier override. When omitted, auto-computed from `score` + `max` + thresholds.
+     */
+    tier?: CriterionTierKey;
+    /** Show a small "≥80 عالی · ≥60 خوب · ..." hint row @default false */
+    showThresholdHint?: boolean;
+    /** Custom tier thresholds (expressed for 0-100; scaled to `max` internally) */
+    tierThresholds?: CriterionTierThresholds;
+    /** Visual size @default "md" */
+    size?: 'sm' | 'md' | 'lg';
+    /**
+     * Layout orientation:
+     * - `default` — header with name+weight, big score + trend, input/description/hint rows
+     * - `compact` — single row name + score, for list/table usage
+     */
+    layout?: 'default' | 'compact';
+    /** Locale for default strings + digits @default "fa" */
+    locale?: SupportedLocale;
+    /** Hide the horizontal progress bar @default false */
+    hideBar?: boolean;
+}
+declare const CriterionScoreCard: React$1.ForwardRefExoticComponent<CriterionScoreCardProps & React$1.RefAttributes<HTMLDivElement>>;
+
 interface DatePickerProps {
     /**
      * The selected date range
@@ -1367,10 +1721,36 @@ declare const EmptyTitle: React$1.ForwardRefExoticComponent<Omit<React$1.Detaile
 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 */
-    message?: string;
-    /** Callback to trigger a retry — when provided, shows a retry button */
+/**
+ * SVG illustrations for empty / error / forbidden / first-run / no-results
+ * states. All use `currentColor` so consumers can color them via
+ * `text-foreground-muted` (default) or any token class. RTL-safe — no
+ * directional cues built in.
+ *
+ * Usage with the Empty primitive:
+ *
+ *   <Empty>
+ *     <NoResultsIllustration className="size-32 text-foreground-muted" />
+ *     <EmptyTitle>نتیجه‌ای یافت نشد</EmptyTitle>
+ *     <EmptyDescription>عبارت دیگری امتحان کنید یا فیلترها را پاک کنید</EmptyDescription>
+ *   </Empty>
+ *
+ * The illustrations sit at ~120×120 viewBox and scale with `size-*` classes.
+ * Stroke-only line work keeps them theme-agnostic (no tinting needed for
+ * dark mode) and tarball-cheap (each ~600 bytes after gzip).
+ */
+
+type SVGProps = React$1.SVGProps<SVGSVGElement>;
+declare const NoResultsIllustration: React$1.ForwardRefExoticComponent<Omit<SVGProps, "ref"> & React$1.RefAttributes<SVGSVGElement>>;
+declare const NoDataIllustration: React$1.ForwardRefExoticComponent<Omit<SVGProps, "ref"> & React$1.RefAttributes<SVGSVGElement>>;
+declare const FirstRunIllustration: React$1.ForwardRefExoticComponent<Omit<SVGProps, "ref"> & React$1.RefAttributes<SVGSVGElement>>;
+declare const ErrorIllustration: React$1.ForwardRefExoticComponent<Omit<SVGProps, "ref"> & React$1.RefAttributes<SVGSVGElement>>;
+declare const ForbiddenIllustration: React$1.ForwardRefExoticComponent<Omit<SVGProps, "ref"> & React$1.RefAttributes<SVGSVGElement>>;
+
+interface ErrorStateProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    /** Error message displayed below the icon */
+    message?: string;
+    /** Callback to trigger a retry — when provided, shows a retry button */
     onRetry?: () => void;
     /** Retry button label */
     retryLabel?: string;
@@ -1448,6 +1828,85 @@ interface FilterBarActiveFiltersProps extends React$1.HTMLAttributes<HTMLDivElem
 }
 declare const FilterBarActiveFilters: React$1.ForwardRefExoticComponent<FilterBarActiveFiltersProps & React$1.RefAttributes<HTMLDivElement>>;
 
+interface FilterPanelProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    /** Locale for default strings and digit formatting @default "fa" */
+    locale?: SupportedLocale;
+}
+declare const FilterPanel: React$1.ForwardRefExoticComponent<FilterPanelProps & React$1.RefAttributes<HTMLDivElement>>;
+declare const FilterPanelHeader: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & React$1.RefAttributes<HTMLDivElement>>;
+interface FilterPanelTitleProps extends React$1.HTMLAttributes<HTMLHeadingElement> {
+    /** Active filter count — when > 0, a pill is rendered next to the label */
+    activeCount?: number;
+}
+declare const FilterPanelTitle: React$1.ForwardRefExoticComponent<FilterPanelTitleProps & React$1.RefAttributes<HTMLHeadingElement>>;
+interface FilterPanelClearAllProps extends Omit<React$1.ButtonHTMLAttributes<HTMLButtonElement>, 'onClick'> {
+    /** Callback when clear-all is clicked */
+    onClear?: () => void;
+    /** Also allow onClick (alias of onClear) to match native HTML semantics */
+    onClick?: React$1.MouseEventHandler<HTMLButtonElement>;
+}
+declare const FilterPanelClearAll: React$1.ForwardRefExoticComponent<FilterPanelClearAllProps & React$1.RefAttributes<HTMLButtonElement>>;
+declare const FilterPanelBody: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & React$1.RefAttributes<HTMLDivElement>>;
+declare const FilterPanelFooter: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & React$1.RefAttributes<HTMLDivElement>>;
+interface FilterSectionProps {
+    /** Visible section title */
+    title: React$1.ReactNode;
+    /** Extra descriptive text below the title */
+    description?: React$1.ReactNode;
+    /** Number of active filters inside this section — shown as a pill next to the title */
+    activeCount?: number;
+    /** Initial open state for uncontrolled mode @default true */
+    defaultOpen?: boolean;
+    /** Controlled open state */
+    open?: boolean;
+    /** onOpenChange for controlled mode */
+    onOpenChange?: (open: boolean) => void;
+    /** When set, a "×" clear button appears in the header */
+    onClear?: () => void;
+    /** When true, the trigger is static (non-collapsible) — useful for single-field sections */
+    collapsible?: boolean;
+    /** Content (form fields) */
+    children?: React$1.ReactNode;
+    className?: string;
+    /** Extra class for the inner content container */
+    contentClassName?: string;
+    /** Optional id for testing / aria */
+    id?: string;
+}
+declare const FilterSection: React$1.ForwardRefExoticComponent<FilterSectionProps & React$1.RefAttributes<HTMLDivElement>>;
+interface FilterPanelTriggerProps extends React$1.ButtonHTMLAttributes<HTMLButtonElement> {
+    /** Active filter count — renders a pill badge next to the label */
+    activeCount?: number;
+    /** Locale for digit formatting and default label @default inherited from FilterPanel context; falls back to "fa" */
+    locale?: SupportedLocale;
+    /** Custom icon element (defaults to SlidersHorizontal) */
+    icon?: React$1.ReactNode;
+    /** Render without icon */
+    hideIcon?: boolean;
+    /** Visual variant — passthrough to Button */
+    variant?: React$1.ComponentProps<typeof Button>['variant'];
+    /** Size — passthrough to Button */
+    size?: React$1.ComponentProps<typeof Button>['size'];
+}
+declare const FilterPanelTrigger: React$1.ForwardRefExoticComponent<FilterPanelTriggerProps & React$1.RefAttributes<HTMLButtonElement>>;
+interface ActiveFiltersBarProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    /** Locale for default empty text */
+    locale?: SupportedLocale;
+    /** Label rendered before chips ("فیلترهای فعال:"). Pass `false` to hide it. */
+    label?: React$1.ReactNode;
+    /** Text when no children are provided */
+    emptyText?: React$1.ReactNode;
+    /** Hide the whole bar when there are no children (instead of showing emptyText) */
+    hideWhenEmpty?: boolean;
+}
+declare const ActiveFiltersBar: React$1.ForwardRefExoticComponent<ActiveFiltersBarProps & React$1.RefAttributes<HTMLDivElement>>;
+interface ActiveFiltersClearAllProps extends Omit<React$1.ButtonHTMLAttributes<HTMLButtonElement>, 'onClick'> {
+    onClear?: () => void;
+    onClick?: React$1.MouseEventHandler<HTMLButtonElement>;
+    locale?: SupportedLocale;
+}
+declare const ActiveFiltersClearAll: React$1.ForwardRefExoticComponent<ActiveFiltersClearAllProps & React$1.RefAttributes<HTMLButtonElement>>;
+
 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;
@@ -1499,16 +1958,48 @@ declare namespace HoverCardContent {
     var displayName: string;
 }
 
-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" | null | undefined;
-} & class_variance_authority_types.ClassProp) | undefined) => string;
-interface InputProps extends Omit<React$1.InputHTMLAttributes<HTMLInputElement>, 'size'>, VariantProps<typeof inputVariants> {
+interface NumberInputLocaleProps extends Omit<React$1.ComponentProps<'input'>, 'type' | 'value' | 'defaultValue' | 'onChange' | 'size'> {
+    /** Current numeric value. Use `null` for empty. */
+    value?: number | null;
+    /** Initial value (uncontrolled). */
+    defaultValue?: number | null;
+    /** Called when the parsed numeric value changes. `null` means cleared. */
+    onValueChange?: (next: number | null) => void;
+    /**
+     * Locale for digit display + parse. Persian/Arabic input is auto-normalised
+     * to Latin before parsing; output digits match the locale.
+     * @default 'fa'
+     */
+    locale?: SupportedLocale;
+    /** Optional unit suffix shown on the inline-end side (e.g. "%", "تومان"). */
+    unit?: React$1.ReactNode;
+    /** Min value (inclusive). */
+    min?: number;
+    /** Max value (inclusive). */
+    max?: number;
+    /** Number of fractional digits. @default 0 (integer) */
+    decimals?: number;
+    /** Show grouping separator (1,234) in display. @default true */
+    thousandSeparator?: boolean;
+    /** Allow negative numbers. @default true */
+    allowNegative?: boolean;
 }
-declare const Input: React$1.ForwardRefExoticComponent<InputProps & React$1.RefAttributes<HTMLInputElement>>;
+/**
+ * Locale-aware number input. Accepts Persian, Arabic, or Latin digits;
+ * always emits a parsed JS `number` (or `null` for empty) via `onValueChange`.
+ * Display digits match `locale` (Persian by default).
+ *
+ * - While the input is focused, the value renders as the user typed (raw
+ *   sanitized buffer), so editing mid-string doesn't snap the caret.
+ * - On blur, value is re-formatted to the locale display (with thousand
+ *   separators + decimals padded to spec).
+ * - `min`/`max` clamp on blur, never mid-edit.
+ *
+ * @example
+ *   const [n, setN] = useState<number | null>(null)
+ *   <NumberInputLocale value={n} onValueChange={setN} unit="تومان" thousandSeparator />
+ */
+declare const NumberInputLocale: React$1.ForwardRefExoticComponent<Omit<NumberInputLocaleProps, "ref"> & React$1.RefAttributes<HTMLInputElement>>;
 
 interface InputWithIconProps extends InputProps {
     /** Icon rendered at the start (inline-start, respects RTL) */
@@ -1539,6 +2030,141 @@ declare const TagInput: React$1.ForwardRefExoticComponent<TagInputProps & React$
 
 declare const HashtagInput: React$1.ForwardRefExoticComponent<TagInputProps & React$1.RefAttributes<HTMLDivElement>>;
 
+interface HashtagPerformanceData {
+    /** Hashtag without the leading `#` — the component renders the marker. */
+    tag: string;
+    /** Mention frequency (count of posts using the tag). */
+    frequency: number;
+    /** Engagement rate (%) for posts that used this tag. */
+    engagementRate?: number;
+    /** Trend sparkline values (e.g. last 7-14 days frequency). */
+    trend?: number[];
+    /** Optional explicit delta (% vs previous period). When omitted, derived from `trend`. */
+    delta?: number;
+}
+interface HashtagPerformanceRowProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, 'onClick'> {
+    data: HashtagPerformanceData;
+    /** Make the row clickable (opens an analytics drill-down on the consumer side). */
+    onRowClick?: (data: HashtagPerformanceData) => void;
+    /** Show ranking number at the start of the row (1, 2, 3, …). */
+    rank?: number;
+    /** Density compact (28px) vs comfortable (40px). @default 'comfortable' */
+    density?: 'compact' | 'comfortable';
+    /** Locale for digit + label formatting. @default 'fa' */
+    locale?: SupportedLocale;
+}
+/**
+ * Single row in a hashtag-performance table — hashtag + frequency +
+ * engagement + sparkline trend + delta. Designed to drop straight into a
+ * `<DataTable>` cell renderer or a vertical list of top hashtags.
+ *
+ * @example
+ *   <DataTable
+ *     columns={[{
+ *       id: 'hashtag', header: 'هشتگ',
+ *       cell: (row) => <HashtagPerformanceRow data={row} rank={row.rank} />,
+ *     }]}
+ *     data={hashtags}
+ *   />
+ */
+declare const HashtagPerformanceRow: React$1.ForwardRefExoticComponent<HashtagPerformanceRowProps & React$1.RefAttributes<HTMLDivElement>>;
+
+type CardSize = 'sm' | 'md' | 'lg';
+interface EntityHealthCardProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    /** Current health state — drives colour, icon, and default narrative framing */
+    severity: EntityHealthKey;
+    /** Compact row layout for list views @default "md" */
+    size?: CardSize;
+    /** Render as a clickable element (`role="button"` + focus ring). */
+    interactive?: boolean;
+    /** Locale for default strings + digit formatting @default "fa" */
+    locale?: SupportedLocale;
+    /** Render an accent-coloured left (logical-start) border tied to severity @default true */
+    accentBorder?: boolean;
+}
+declare const EntityHealthCard: React$1.ForwardRefExoticComponent<EntityHealthCardProps & React$1.RefAttributes<HTMLDivElement>>;
+declare const EntityHealthCardHeader: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & React$1.RefAttributes<HTMLDivElement>>;
+declare const EntityHealthCardHeaderText: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & React$1.RefAttributes<HTMLDivElement>>;
+interface EntityHealthCardTitleProps extends React$1.HTMLAttributes<HTMLHeadingElement> {
+    /** Semantic heading level @default "h3" */
+    as?: 'h2' | 'h3' | 'h4';
+}
+declare const EntityHealthCardTitle: React$1.ForwardRefExoticComponent<EntityHealthCardTitleProps & React$1.RefAttributes<HTMLHeadingElement>>;
+declare const EntityHealthCardSubtitle: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLParagraphElement> & React$1.RefAttributes<HTMLParagraphElement>>;
+declare const EntityHealthCardHeaderEnd: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & React$1.RefAttributes<HTMLDivElement>>;
+interface EntityHealthCardSeverityBadgeProps extends React$1.HTMLAttributes<HTMLSpanElement> {
+    /** Hide the text label — keeps the icon and aria-label only */
+    iconOnly?: boolean;
+    /** Size @default "sm" */
+    size?: 'xs' | 'sm' | 'md';
+    /** Override locale for just this badge */
+    locale?: SupportedLocale;
+}
+declare const EntityHealthCardSeverityBadge: React$1.ForwardRefExoticComponent<EntityHealthCardSeverityBadgeProps & React$1.RefAttributes<HTMLSpanElement>>;
+interface EntityHealthCardScoreProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    /** Current score — clamped to [0, max]. */
+    value: number;
+    /** Max score @default 100 */
+    max?: number;
+    /** Leading label (e.g., "نمره سلامت") */
+    label?: React$1.ReactNode;
+    /** Optional delta vs previous period. Positive => up, negative => down. */
+    delta?: number;
+    /** Suffix rendered after the score (e.g., "٪", "/۱۰۰"). Omit for no suffix. */
+    suffix?: React$1.ReactNode;
+    /** Override auto suffix when `suffix` is not provided. Defaults to "/{max}" in localized digits. */
+    showDenominator?: boolean;
+    /** Override the accent colour. Accepts any CSS color. */
+    color?: string;
+}
+declare const EntityHealthCardScore: React$1.ForwardRefExoticComponent<EntityHealthCardScoreProps & React$1.RefAttributes<HTMLDivElement>>;
+declare const EntityHealthCardNarrative: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLParagraphElement> & React$1.RefAttributes<HTMLParagraphElement>>;
+interface EntityHealthCardTrustProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    /** Trust score @range 0..max */
+    value: number;
+    /** Max score @default 100 */
+    max?: number;
+    /** Leading label — defaults to "اعتماد" */
+    label?: React$1.ReactNode;
+    /** Hide the numeric value on the trailing side */
+    hideValue?: boolean;
+    /** Show 25 / 50 / 75 tick marks inside the bar @default true */
+    showMarkers?: boolean;
+    /** Size of the bar @default "sm" */
+    barSize?: 'xs' | 'sm' | 'md';
+    /** Override the bar fill colour */
+    color?: string;
+}
+declare const EntityHealthCardTrust: React$1.ForwardRefExoticComponent<EntityHealthCardTrustProps & React$1.RefAttributes<HTMLDivElement>>;
+interface EntityHealthCardPhaseProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    /** Current day index (1-based). When provided with `total`, a progress bar renders. */
+    day?: number;
+    /** Total days in this phase */
+    total?: number;
+    /** Phase name */
+    phase?: React$1.ReactNode;
+}
+declare const EntityHealthCardPhase: React$1.ForwardRefExoticComponent<EntityHealthCardPhaseProps & React$1.RefAttributes<HTMLDivElement>>;
+interface EntityHealthCardMetricsProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    /** Number of columns @default 2 */
+    columns?: 1 | 2 | 3 | 4;
+}
+declare const EntityHealthCardMetrics: React$1.ForwardRefExoticComponent<EntityHealthCardMetricsProps & React$1.RefAttributes<HTMLDivElement>>;
+interface EntityHealthCardMetricProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    /** Metric label */
+    label: React$1.ReactNode;
+    /** Metric value — primary number or short string */
+    value: React$1.ReactNode;
+    /** Optional trend direction — affects trailing icon colour */
+    trend?: 'up' | 'down' | 'flat';
+    /** Optional trend magnitude shown after the arrow (e.g., "12%") */
+    trendLabel?: React$1.ReactNode;
+}
+declare const EntityHealthCardMetric: React$1.ForwardRefExoticComponent<EntityHealthCardMetricProps & React$1.RefAttributes<HTMLDivElement>>;
+declare const EntityHealthCardFooter: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & React$1.RefAttributes<HTMLDivElement>>;
+declare const EntityHealthCardActions: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & React$1.RefAttributes<HTMLDivElement>>;
+declare const EntityHealthCardMeta: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLParagraphElement> & React$1.RefAttributes<HTMLParagraphElement>>;
+
 interface InputGroupProps extends React$1.ComponentProps<'div'> {
     /**
      * Direction of the input group.
@@ -1599,69 +2225,109 @@ declare namespace InputOTPSeparator {
     var displayName: string;
 }
 
-type MediaType = 'image' | 'video' | 'carousel';
-type AspectRatioType = '16:9' | '9:16' | '1:1' | '4:5' | '5:4';
-interface MediaItem {
-    type: 'image' | 'video';
-    url: string;
-    aspectRatio?: AspectRatioType;
+interface JobCardProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    /** Current lifecycle status — drives colour and badge */
+    status: JobStatusKey;
+    /** Compact single-row layout (for list views) @default false */
+    compact?: boolean;
+    /** When set, the card renders as a clickable element with hover + focus styles. Pure presentational — wire your own handler via onClick. */
+    interactive?: boolean;
+    /** Locale for default strings + digit formatting @default "fa" */
+    locale?: SupportedLocale;
 }
-interface PostStats {
-    likes?: number;
-    comments?: number;
-    views?: number;
-    shares?: number;
+declare const JobCard: React$1.ForwardRefExoticComponent<JobCardProps & React$1.RefAttributes<HTMLDivElement>>;
+declare const JobCardHeader: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & React$1.RefAttributes<HTMLDivElement>>;
+interface JobCardThumbnailProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    /** Image URL. If omitted, `icon` or `fallback` is used. */
+    src?: string;
+    /** Alt text for the image */
+    alt?: string;
+    /** Lucide icon rendered in an outlined tile (used when no src) */
+    icon?: React$1.ComponentType<{
+        className?: string;
+    }>;
+    /** Arbitrary fallback node (letter, emoji, …) */
+    fallback?: React$1.ReactNode;
 }
-type NumberFormat = 'exact' | 'short';
-type TimeFormat = 'absolute' | 'relative';
-interface InstagramProfileInfo {
-    username: string;
-    fullName?: string;
-    profilePicture?: string;
-    avatarUrl?: string;
+declare const JobCardThumbnail: React$1.ForwardRefExoticComponent<JobCardThumbnailProps & React$1.RefAttributes<HTMLDivElement>>;
+declare const JobCardHeaderText: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & React$1.RefAttributes<HTMLDivElement>>;
+interface JobCardTitleProps extends React$1.HTMLAttributes<HTMLHeadingElement> {
+    /** Semantic heading level @default "h3" */
+    as?: 'h2' | 'h3' | 'h4';
+}
+declare const JobCardTitle: React$1.ForwardRefExoticComponent<JobCardTitleProps & React$1.RefAttributes<HTMLHeadingElement>>;
+declare const JobCardSubtitle: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLParagraphElement> & React$1.RefAttributes<HTMLParagraphElement>>;
+declare const JobCardHeaderActions: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & React$1.RefAttributes<HTMLDivElement>>;
+interface JobCardStatusBadgeProps extends React$1.HTMLAttributes<HTMLSpanElement> {
+    /** Hide the text label — keeps the icon and aria-label only */
+    iconOnly?: boolean;
+    /** Size @default "sm" */
+    size?: 'xs' | 'sm' | 'md';
+    /** Override locale for just this badge */
+    locale?: SupportedLocale;
 }
-interface InstagramPostProps extends React$1.HTMLAttributes<HTMLDivElement>, VariantProps<typeof instagramPostVariants> {
-    dir?: 'rtl' | 'ltr';
-    media?: MediaItem[];
-    mediaType?: MediaType;
-    postType?: 'image' | 'video' | 'carousel';
-    caption?: string;
-    showCaption?: boolean;
-    stats?: PostStats;
-    numberFormat?: NumberFormat;
-    showLikes?: boolean;
-    showComments?: boolean;
-    showViews?: boolean;
-    showShares?: boolean;
-    publishTime?: Date | string | number;
-    timeFormat?: TimeFormat;
-    profile?: InstagramProfileInfo;
-    showProfile?: boolean;
-    avatarUrl?: string;
-    showActions?: boolean;
-    /** Show loading skeleton state */
-    isLoading?: boolean;
-    onCommentAnalyzer?: () => void;
-    onBooster?: () => void;
-    onAIAnalysis?: () => void;
-    onOpenInstagram?: () => void;
-    instagramUrl?: string;
-    disableCommentAnalyzer?: boolean;
-    disableBooster?: boolean;
-    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 "کمتر" */
-    showLessText?: string;
-}
-declare const instagramPostVariants: (props?: ({
-    variant?: "horizontal" | "vertical" | null | undefined;
-} & class_variance_authority_types.ClassProp) | undefined) => string;
-declare const InstagramPost: React$1.ForwardRefExoticComponent<InstagramPostProps & React$1.RefAttributes<HTMLDivElement>>;
+declare const JobCardStatusBadge: React$1.ForwardRefExoticComponent<JobCardStatusBadgeProps & React$1.RefAttributes<HTMLSpanElement>>;
+/**
+ * Wrapper for action buttons. If the parent `<JobCard interactive>` is
+ * clickable, child button clicks would otherwise bubble up and trigger
+ * the card's handler. Wrap your buttons here and we add role="group"
+ * semantics; stop event propagation at the Button's own onClick when
+ * needed to avoid conflicting with card activation.
+ */
+declare const JobCardActions: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & React$1.RefAttributes<HTMLDivElement>>;
+interface JobCardProgressProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    /** Current value — if omitted (and not indeterminate), renders a 0% bar */
+    value?: number;
+    /** Max value @default 100 */
+    max?: number;
+    /** Render an animated indeterminate shimmer. Overrides `value`. */
+    indeterminate?: boolean;
+    /** Leading text label */
+    label?: React$1.ReactNode;
+    /** Force-hide the percentage text on the trailing end */
+    hideValueText?: boolean;
+    /** Override the bar colour (e.g. for `paused` state). Accepts a CSS value. */
+    color?: string;
+    /** Size of the bar @default "sm" */
+    size?: 'xs' | 'sm' | 'md';
+}
+declare const JobCardProgress: React$1.ForwardRefExoticComponent<JobCardProgressProps & React$1.RefAttributes<HTMLDivElement>>;
+declare const JobCardMeta: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDListElement> & React$1.RefAttributes<HTMLDListElement>>;
+interface JobCardMetaItemProps {
+    /** Lucide icon — usually Calendar, Clock, User, … */
+    icon?: React$1.ComponentType<{
+        className?: string;
+    }>;
+    /** Field label */
+    label: React$1.ReactNode;
+    /** Field value */
+    value: React$1.ReactNode;
+    /** Use `<time dateTime={...}>` for value (screen readers + copy behaviour) */
+    dateTime?: string;
+    className?: string;
+}
+declare const JobCardMetaItem: React$1.ForwardRefExoticComponent<JobCardMetaItemProps & React$1.RefAttributes<HTMLDivElement>>;
+interface JobCardStatsProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    /** Layout columns @default auto */
+    columns?: 2 | 3 | 4 | 'auto';
+}
+declare const JobCardStats: React$1.ForwardRefExoticComponent<JobCardStatsProps & React$1.RefAttributes<HTMLDivElement>>;
+interface JobCardStatProps {
+    label: React$1.ReactNode;
+    /** Current value */
+    value: number;
+    /** Total — renders as "value / total" when provided */
+    total?: number;
+    /** Value formatting locale. Defaults to JobCard context. */
+    locale?: SupportedLocale;
+    /** Semantic tone applied to the value */
+    variant?: 'default' | 'positive' | 'warning' | 'destructive' | 'muted';
+    /** Pre-formatted override — bypasses number formatting */
+    formatted?: React$1.ReactNode;
+    className?: string;
+}
+declare const JobCardStat: React$1.ForwardRefExoticComponent<JobCardStatProps & React$1.RefAttributes<HTMLDivElement>>;
+declare const JobCardError: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & React$1.RefAttributes<HTMLDivElement>>;
 
 declare function Kbd({ className, ...props }: React$1.ComponentProps<'kbd'>): react_jsx_runtime.JSX.Element;
 declare namespace Kbd {
@@ -1672,6 +2338,206 @@ declare namespace KbdGroup {
     var displayName: string;
 }
 
+declare const labelChipVariants: (props?: ({
+    tone?: "neutral" | "warning" | "success" | "destructive" | "brand" | "ai" | null | undefined;
+    size?: "sm" | "md" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface LabelChipProps extends Omit<React$1.HTMLAttributes<HTMLSpanElement>, 'onClick'>, VariantProps<typeof labelChipVariants> {
+    /** Visible label text. */
+    children: React$1.ReactNode;
+    /** When set, renders an inline pencil button that opens an editor on consumer side. */
+    onEdit?: () => void;
+    /** When set, renders an inline ✕ button to dismiss/remove the label. */
+    onRemove?: () => void;
+    /**
+     * Mark the chip as AI-generated — adds a subtle ✦ prefix and the `ai` tone
+     * (unless tone is explicitly overridden). Used by AI-labeled clustering
+     * dashboards to distinguish auto-tagged from human-curated labels.
+     */
+    aiGenerated?: boolean;
+    /** Confidence (0–1) for AI labels — rendered as a small `(۸۰%)` suffix when set. */
+    confidence?: number;
+    /** Whole chip click handler — useful for filter-by-label flows. */
+    onSelect?: () => void;
+}
+declare const LabelChip: React$1.ForwardRefExoticComponent<LabelChipProps & React$1.RefAttributes<HTMLSpanElement>>;
+
+interface LabelEditDialogProps {
+    /** Controlled open state. */
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    /** Initial value of the label being edited. */
+    initialValue?: string;
+    /** Whether this label was originally AI-generated (controls the AI-flag toggle default). */
+    aiGenerated?: boolean;
+    /** Existing labels — surfaced as quick-pick suggestions during edit. */
+    suggestions?: string[];
+    /** Save handler. Called with the new value + the AI-generated flag (consumer persists). */
+    onSave: (value: string, aiGenerated: boolean) => void;
+    /**
+     * Optional handler for the "Delete label" destructive action. When set, a
+     * `Button variant="destructive"` shows up in the footer; omit to hide.
+     */
+    onDelete?: () => void;
+    /** Locale for default strings. @default 'fa' */
+    locale?: SupportedLocale;
+}
+/**
+ * Edit dialog for AI-labeled clustering. Pairs with `<LabelChip>` — when
+ * users click the pencil affordance on a chip, this dialog opens with the
+ * current value pre-filled, an AI-generated toggle, and a list of
+ * suggestions (typically other labels already in use).
+ *
+ * Stateless wrt persistence: consumer wires `onSave` to whatever backend.
+ */
+declare const LabelEditDialog: React$1.ForwardRefExoticComponent<LabelEditDialogProps & React$1.RefAttributes<HTMLDivElement>>;
+
+interface MarkdownRendererProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, 'children'> {
+    /** Raw markdown source. Safe by default — raw HTML is escaped, scripts are never executed. */
+    children: string;
+    /**
+     * Enables permissive link schemes. By default only `http`, `https`, and `mailto` are kept;
+     * everything else (including `javascript:`) is dropped.
+     */
+    allowedLinkSchemes?: ReadonlyArray<string>;
+    /** Compact density tightens vertical rhythm — useful for inline AI summaries. */
+    density?: 'compact' | 'comfortable';
+}
+/**
+ * Lightweight, dependency-free markdown renderer for AI narratives, report
+ * sections, and bulletin bodies. Safe by default — raw HTML in the source is
+ * rendered as text (never injected), and `javascript:` links are dropped.
+ *
+ * Supports: ATX headings (`#`..`######`), paragraphs, **bold**, *italic*,
+ * ~~strike~~, `inline code`, fenced ``` code blocks ```, blockquotes, ordered
+ * + unordered lists (flat), `[links](url)`, horizontal rules, hard line breaks.
+ *
+ * Intentional non-features (v1): tables, nested lists, footnotes, images. If
+ * you need any of those, lift to a heavier renderer (TipTap / react-markdown).
+ */
+declare const MarkdownRenderer: React$1.ForwardRefExoticComponent<MarkdownRendererProps & React$1.RefAttributes<HTMLDivElement>>;
+
+interface TaskListGroup {
+    /** Stable group identifier — used to bucket items and as a React key. */
+    id: string;
+    /** Heading shown above the column / group section. */
+    label: React$1.ReactNode;
+    /** Optional accent token CSS variable (e.g. `--status-warning`) for the column rail. */
+    accent?: string;
+    /** Optional override for the empty state inside this group. */
+    emptyState?: React$1.ReactNode;
+}
+interface TaskListProps<T> extends Omit<React$1.HTMLAttributes<HTMLDivElement>, 'children' | 'onSelect'> {
+    /** Items to render. Order is preserved within each group. */
+    items: ReadonlyArray<T>;
+    /**
+     * Layout — `kanban` renders one column per group with horizontal scroll;
+     * `flat` renders a single ordered list with sticky group headings.
+     * @default 'kanban'
+     */
+    variant?: 'kanban' | 'flat';
+    /**
+     * Explicit group definitions. When omitted, groups are auto-derived from the
+     * unique `groupBy(item)` values in document order. Pass an array to control
+     * column ordering, labels, or to render columns with no items today.
+     */
+    groups?: ReadonlyArray<TaskListGroup>;
+    /** Function returning the group id for an item. */
+    groupBy: (item: T) => string;
+    /** Renders a single item card. Receives the resolved group for context. */
+    renderItem: (item: T, group: TaskListGroup) => React$1.ReactNode;
+    /** Stable React key per item. */
+    getItemKey: (item: T, index: number) => React$1.Key;
+    /** Default empty state when a group has no items. */
+    emptyState?: React$1.ReactNode;
+    /**
+     * Show the item count next to each group heading. @default true.
+     */
+    showCounts?: boolean;
+    /** Locale for default empty / count strings. @default 'fa' */
+    locale?: SupportedLocale;
+}
+declare const TaskList: <T>(props: TaskListProps<T> & {
+    ref?: React$1.ForwardedRef<HTMLDivElement>;
+}) => React$1.ReactElement;
+
+type RegionPickerKey = 'slug' | 'iso';
+interface RegionPickerProps {
+    /** Selected province identifiers (slug or iso, depending on `keyBy`). */
+    value?: ReadonlyArray<string>;
+    onValueChange?: (next: string[]) => void;
+    /**
+     * Which identifier to read/write — `slug` (e.g. `tehran`) is URL-friendly,
+     * `iso` (`IR-07`) is the ISO 3166-2 standard. @default 'slug'
+     */
+    keyBy?: RegionPickerKey;
+    /** Locale for province labels + UI strings. @default 'fa' */
+    locale?: SupportedLocale;
+    /** Restrict the choosable list (e.g. only show provinces with bureaus). */
+    includeSlugs?: ReadonlyArray<IranProvinceSlug>;
+    /** Excluded slugs — applied after `includeSlugs`. */
+    excludeSlugs?: ReadonlyArray<IranProvinceSlug>;
+    /** Trigger placeholder. */
+    placeholder?: string;
+    /** Search-input placeholder. */
+    searchPlaceholder?: string;
+    /** Empty-state message when search yields no results. */
+    emptyMessage?: string;
+    /** Cap on selections — e.g. `1` to make it a single-province picker. */
+    maxSelected?: number;
+    /** How many selected chips to render before collapsing into a "+N" badge. */
+    maxDisplayed?: number;
+    disabled?: boolean;
+    className?: string;
+}
+/**
+ * Multi-select picker over Iran's 31 provinces. Source of truth is
+ * `IRAN_PROVINCES`; the picker projects it through the active locale and
+ * surfaces it via `MultiSelect`.
+ *
+ * Pair with `IranProvinceHeat` for province-scoped افکارسنجی dashboards. A
+ * proper SVG geomap selector is deferred (Phase 5.4).
+ */
+declare const RegionPicker: React$1.ForwardRefExoticComponent<RegionPickerProps & React$1.RefAttributes<HTMLDivElement>>;
+
+interface CountryPickerProps {
+    /** Selected ISO 3166-1 alpha-2 codes (uppercase). */
+    value?: ReadonlyArray<string>;
+    onValueChange?: (next: string[]) => void;
+    /**
+     * Override the country list. Defaults to the curated 80-country roster in
+     * `lib/countries.ts`. Pass your own when you need a fuller ISO 3166 set or
+     * a sub-region (e.g. only EU members).
+     */
+    options?: ReadonlyArray<Country>;
+    /** Restrict the curated default list to these codes. */
+    includeCodes?: ReadonlyArray<string>;
+    /** Excluded codes — applied after `includeCodes`. */
+    excludeCodes?: ReadonlyArray<string>;
+    /** Show flag emoji prefix on each option. @default true */
+    showFlag?: boolean;
+    /** Locale for labels + UI strings. @default 'fa' */
+    locale?: SupportedLocale;
+    placeholder?: string;
+    searchPlaceholder?: string;
+    emptyMessage?: string;
+    /** Cap on selections — e.g. `1` for a single-country picker. */
+    maxSelected?: number;
+    /** Selected chips before collapsing into "+N" badge. */
+    maxDisplayed?: number;
+    disabled?: boolean;
+    className?: string;
+}
+/**
+ * Multi-select picker over a curated country list. Defaults to the 80
+ * countries that recur in افکارسنجی + influencer dashboards we serve; pass
+ * `options` to replace the dataset with your own.
+ *
+ * Returns ISO 3166-1 alpha-2 codes (uppercase). Pair with platform tokens +
+ * the audience graph for influencer geographic breakdowns.
+ */
+declare const CountryPicker: React$1.ForwardRefExoticComponent<CountryPickerProps & React$1.RefAttributes<HTMLDivElement>>;
+
 declare function Menubar({ className, ...props }: React$1.ComponentProps<typeof MenubarPrimitive.Root>): react_jsx_runtime.JSX.Element;
 declare namespace Menubar {
     var displayName: string;
@@ -1957,47 +2823,563 @@ interface PaginationControlledProps {
  */
 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>>;
+/**
+ * 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';
+    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 const PartoHeatMap: React$1.ForwardRefExoticComponent<PartoHeatMapProps & 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> {
-    /**
-     * نام کامل کاربر
-     */
-    name: string;
-    /**
-     * نام کاربری (username)
-     */
-    username: string;
-    /**
-     * آدرس تصویر پروفایل
-     */
-    avatarSrc?: string;
-    /**
-     * متن جایگزین برای تصویر
-     */
-    avatarAlt?: string;
+type PostingWeekStart = 'saturday' | 'sunday' | 'monday';
+interface PostingFrequencyCell {
+    /** Day of week — 0-6. What "0" means depends on `weekStart`. */
+    dayOfWeek: number;
+    /** Hour of day — 0-23 in the display timezone. */
+    hour: number;
+    /** Metric value (typically post count, can also be comments/likes avg). */
+    value: number;
+}
+interface PostingFrequencySummary {
+    /** 0–100 composite consistency score (activeDaysRatio + regularity + gap-penalty). */
+    consistencyScore?: number;
+    /** Longest inactivity gap, expressed in **days**. */
+    maxGapDays?: number;
+    /** 0–100 % of days that contain ≥1 post in the analysis window. */
+    activeDaysRatio?: number;
+    /** Total posts in the window (optional, for context in the header). */
+    totalPosts?: number;
+}
+/**
+ * Normalize a sparse `PostingFrequencyCell[]` into a full 7×24 grid of
+ * `HeatMapRow`s ordered by `weekStart`. Missing cells are filled with value=0.
+ * Each row's `id` is the English weekday name, matching PartoHeatMap's
+ * internal weekday mapping.
+ */
+declare function buildPostingFrequencyRows(data: PostingFrequencyCell[], weekStart?: PostingWeekStart): HeatMapRow[];
+interface PostingFrequencyHeatmapProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, 'title'> {
+    /** Per-cell activity. Sparse input is fine — missing cells render as 0. */
+    data: PostingFrequencyCell[];
+    /** Which day logically occupies row 0. @default "saturday" for fa/ar, "sunday" for en. */
+    weekStart?: PostingWeekStart;
+    /** Optional summary stats shown in the header row. */
+    summary?: PostingFrequencySummary;
+    /** Card title. */
+    title?: React$1.ReactNode;
+    /** Short description below title. */
+    description?: React$1.ReactNode;
     /**
-     * حروف اولیه برای fallback (اختیاری)
+     * Metric label for the tooltip (e.g., "پست", "نظر", "لایک"). Default uses
+     * the locale-specific "Posts" label.
      */
-    initials?: string;
+    metricLabel?: React$1.ReactNode;
+    /** Show the summary row @default true (when `summary` is provided) */
+    showSummary?: boolean;
+    /** Height of the heatmap chart in px @default 240 */
+    chartHeight?: number;
+    /** Loading state */
+    isLoading?: boolean;
+    /** Locale @default "fa" */
+    locale?: SupportedLocale;
     /**
-     * تعداد فالوورها
+     * Custom PartoHeatMap props to pass through (e.g., colorScale override,
+     * margin). Avoid setting `data` / `locale` here; use the outer props.
      */
+    heatmapProps?: Omit<PartoHeatMapProps, 'data' | 'locale' | 'isLoading' | 'renderTooltip'>;
+}
+declare const PostingFrequencyHeatmap: React$1.ForwardRefExoticComponent<PostingFrequencyHeatmapProps & React$1.RefAttributes<HTMLDivElement>>;
+
+/**
+ * Platform sources supported by `<PostCard>`. Extends the existing `SocialPlatform`
+ * for Phase 1; additional sources (`facebook`, `news`, `tv`, `radio`) land in Phase 2
+ * together with the `SocialPlatformBadge` extension.
+ */
+type PostPlatform = SocialPlatform;
+type PostDensity = 'compact' | 'comfortable';
+type PostSentiment = 'positive' | 'negative' | 'neutral' | 'mixed';
+interface PostAuthor {
+    name: string;
+    handle?: string;
+    avatarUrl?: string;
+    verified?: boolean;
+    /** Optional follower / subscriber count — used in PostDetailsModal sidebar. */
     followers?: number;
-    /**
-     * آیکون فالوور
-     */
-    followersIcon?: React$1.ReactNode;
-    /**
-     * تابع کلیک روی کارت
-     */
+}
+interface PostMetrics {
+    views?: number;
+    likes?: number;
+    comments?: number;
+    shares?: number;
+    /** Estimated reach / potential audience. */
+    reach?: number;
+    /** Engagement rate as a 0..1 decimal (e.g. 0.034 = 3.4%). */
+    engagementRate?: number;
+}
+interface PostTag {
+    id: string;
+    label: string;
+    /** Optional CSS var (e.g. `--chart-1`) or hex color. Auto-assigned from label if omitted. */
+    color?: string;
+}
+/**
+ * Flags indicate which enrichments the product has attached to this post.
+ * Consumers set these to show the matching chip in `<PostHeader>`.
+ */
+interface PostEnrichmentFlags {
+    ocr?: boolean;
+    transcript?: boolean;
+    aiAnalysis?: boolean;
+    commentCount?: number;
+}
+interface PostMediaItem {
+    url: string;
+    thumbnailUrl?: string;
+    /** Natural aspect ratio (width / height). If omitted, defaults to 1. */
+    aspectRatio?: number;
+    alt?: string;
+    type?: 'image' | 'video';
+    /** Duration in seconds for video. */
+    duration?: number;
+}
+type PostBodyData = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'media-single';
+    media: PostMediaItem;
+    caption?: string;
+} | {
+    type: 'media-carousel';
+    items: PostMediaItem[];
+    caption?: string;
+} | {
+    type: 'video';
+    media: PostMediaItem;
+    caption?: string;
+} | {
+    type: 'missing-media';
+    caption?: string;
+    reason?: string;
+};
+interface PostData {
+    id: string;
+    source: PostPlatform;
+    author: PostAuthor;
+    /** Post creation time. Accepts Date, ISO string, or unix ms. */
+    timestamp: Date | string | number;
+    body: PostBodyData;
+    metrics?: PostMetrics;
+    sentiment?: PostSentiment;
+    enrichments?: PostEnrichmentFlags;
+    /** User-defined category tags (topic, campaign, issue type). */
+    tags?: PostTag[];
+    /** Authority / influence score 0..100 — used to flag high-impact mentions. */
+    authorityScore?: number;
+    /** ISO language code detected for the post. */
+    language?: string;
+    /** URL to the post at the source platform (used by default "view at source" action). */
+    sourceUrl?: string;
+}
+interface PostAction {
+    id: string;
+    label: string;
+    icon: LucideIcon;
+    variant?: 'default' | 'danger';
+    onClick: (post: PostData) => void;
+    disabled?: boolean;
+    hidden?: boolean;
+}
+interface PostCommentAuthor {
+    name: string;
+    handle?: string;
+    avatarUrl?: string;
+    verified?: boolean;
+}
+interface PostComment {
+    id: string;
+    author: PostCommentAuthor;
+    text: string;
+    timestamp: Date | string | number;
+    sentiment?: PostSentiment;
+    likes?: number;
+    replies?: PostComment[];
+    /** Pinned by post author (Instagram, YouTube). */
+    pinned?: boolean;
+    /** Indicates this is a reply from the original post author. */
+    authorReply?: boolean;
+}
+type PostEmotion = 'anger' | 'anticipation' | 'joy' | 'trust' | 'fear' | 'surprise' | 'sadness' | 'disgust' | 'neutral';
+type PostIntent = 'complaint' | 'praise' | 'question' | 'announcement' | 'comparison' | 'opinion' | 'info';
+interface PostAiEntity {
+    text: string;
+    type: 'person' | 'brand' | 'place' | 'product' | 'event' | 'organization';
+}
+interface PostAiAnalysis {
+    /** Auto-generated summary of the post. */
+    summary?: string;
+    /** Key topics mentioned in the post. */
+    topics?: string[];
+    /** Named entities detected. */
+    entities?: PostAiEntity[];
+    /** Primary intent classification. */
+    intent?: PostIntent;
+    /** 9-class emotion distribution (raw counts or normalized). */
+    emotions?: Partial<Record<PostEmotion, number>>;
+    /** Flagged risks / sensitive content categories. */
+    risks?: string[];
+    /** Influence tier estimate for the author. */
+    influenceTier?: 'nano' | 'micro' | 'macro' | 'mega';
+    /** Model confidence 0..1 for overall analysis. */
+    confidence?: number;
+    /** Analysis generation timestamp. */
+    generatedAt?: Date | string | number;
+}
+/** Platform-specific metadata, discriminated by `platform` (matches `PostData.source`). */
+type PlatformMetadata = {
+    platform: 'instagram';
+    postType?: 'feed' | 'reel' | 'story' | 'carousel' | 'igtv';
+    location?: string;
+    music?: {
+        title: string;
+        artist?: string;
+    };
+    saveCount?: number;
+    collaborators?: string[];
+    /** Hashtags used in the post. */
+    hashtags?: string[];
+} | {
+    platform: 'twitter';
+    tweetType?: 'original' | 'retweet' | 'quote' | 'reply';
+    quotedTweetUrl?: string;
+    inReplyTo?: string;
+    retweetCount?: number;
+    quoteCount?: number;
+    bookmarkCount?: number;
+    isThread?: boolean;
+    /** Count of additional posts in the thread. */
+    threadLength?: number;
+} | {
+    platform: 'youtube';
+    videoType?: 'video' | 'short' | 'live' | 'premiere';
+    channelSubscribers?: number;
+    dislikes?: number;
+    category?: string;
+    tags?: string[];
+} | {
+    platform: 'telegram';
+    channelName?: string;
+    channelSubscribers?: number;
+    forwardCount?: number;
+    isChannel?: boolean;
+    /** Map of emoji → count, e.g. { '👍': 42, '❤️': 12 }. */
+    reactionCounts?: Record<string, number>;
+} | {
+    platform: 'tiktok';
+    videoType?: 'video' | 'duet' | 'stitch' | 'live';
+    music?: {
+        title: string;
+        artist?: string;
+    };
+    duetWith?: string;
+    saveCount?: number;
+    effects?: string[];
+} | {
+    platform: 'linkedin';
+    postType?: 'post' | 'article' | 'poll' | 'document';
+    reactions?: {
+        like?: number;
+        celebrate?: number;
+        support?: number;
+        love?: number;
+        insightful?: number;
+        funny?: number;
+    };
+    repostCount?: number;
+    industry?: string;
+} | {
+    platform: 'threads';
+    replyControls?: 'anyone' | 'followed' | 'mentioned';
+    repostCount?: number;
+    quoteCount?: number;
+};
+/** Extended post details — optionally attached to PostData when fetching full view. */
+interface PostDetails {
+    comments?: PostComment[];
+    aiAnalysis?: PostAiAnalysis;
+    /** Text extracted from images via OCR. */
+    ocrText?: string;
+    /** Transcript for audio / video content. */
+    transcript?: string;
+    /** Platform-specific metadata block. */
+    platformMeta?: PlatformMetadata;
+}
+
+declare const postCardVariants: (props?: ({
+    density?: "compact" | "comfortable" | null | undefined;
+    selected?: boolean | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface PostCardProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, 'onSelect'>, VariantProps<typeof postCardVariants> {
+    post: PostData;
+    density?: PostDensity;
+    selected?: boolean;
+    read?: boolean;
+    actions?: PostAction[];
+    onOpen?: (post: PostData) => void;
+    onSelect?: (post: PostData, selected: boolean) => void;
+    selectable?: boolean;
+    /** Fired when user clicks the details action (Maximize2 icon). Wires up the default details action. */
+    onOpenDetails?: (post: PostData) => void;
+}
+declare function defaultActions(handlers?: {
+    onOpenDetails?: (post: PostData) => void;
+}): PostAction[];
+declare const PostCard: React$1.ForwardRefExoticComponent<PostCardProps & React$1.RefAttributes<HTMLDivElement>>;
+
+declare const postHeaderVariants: (props?: ({
+    density?: "compact" | "comfortable" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface PostHeaderProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, 'children'>, VariantProps<typeof postHeaderVariants> {
+    author: PostAuthor;
+    platform: PostPlatform;
+    timestamp: Date | string | number;
+    sentiment?: PostSentiment;
+    enrichments?: PostEnrichmentFlags;
+    density?: PostDensity;
+    /** Override avatar size. */
+    avatarClassName?: string;
+}
+declare const PostHeader: React$1.ForwardRefExoticComponent<PostHeaderProps & React$1.RefAttributes<HTMLDivElement>>;
+
+/**
+ * Aspect-ratio helpers for post media.
+ *
+ * Platforms deliver media in many ratios (1:1, 4:5, 9:16, 16:9, …). The post
+ * component system normalizes aspect ratios per display context so a feed of
+ * mixed content looks consistent without cropping away information.
+ *
+ * Rules (spec §Aspect-Ratio Handling):
+ *  - `compact`    → always 1:1 thumbnail (center-crop via object-cover).
+ *  - `comfortable` → container clamps aspect to [4:5, 16:9]; media inside is
+ *                    letterboxed via `object-contain` so nothing is cropped.
+ *                    Callers typically render a blurred backdrop of the same
+ *                    media behind the letterboxed image to fill empty space.
+ *  - `detail`     → preserve natural ratio; cap max-h-[70vh] for tall portraits.
+ */
+type AspectContext = 'compact' | 'comfortable' | 'detail';
+
+interface PostBodyProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    body: PostBodyData;
+    /** Display context — drives aspect handling + text clamping. */
+    context: AspectContext;
+    /** Compact mode shows only a thumbnail; body text is rendered by parent. */
+    thumbnailOnly?: boolean;
+}
+declare const PostBody: React$1.ForwardRefExoticComponent<PostBodyProps & React$1.RefAttributes<HTMLDivElement>>;
+
+interface PostActionsProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    post: PostData;
+    actions: PostAction[];
+    /** Number of primary (inline) actions to render. Remaining flow into the overflow menu. */
+    primaryCount?: number;
+    /** Compact layout hides inline labels, shows icon-only buttons. */
+    compact?: boolean;
+}
+declare const PostActions: React$1.ForwardRefExoticComponent<PostActionsProps & React$1.RefAttributes<HTMLDivElement>>;
+
+interface PostMetadataProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    metrics?: PostMetrics;
+    sentiment?: PostSentiment;
+    density?: PostDensity;
+    /** Hide the sentiment badge (dot still rendered in header in compact mode). */
+    hideSentiment?: boolean;
+}
+declare const PostMetadata: React$1.ForwardRefExoticComponent<PostMetadataProps & React$1.RefAttributes<HTMLDivElement>>;
+
+interface PostListProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, 'onSelect'> {
+    posts: PostData[];
+    /** Controlled density. If omitted, the list manages its own state (persisted to localStorage). */
+    density?: PostDensity;
+    onDensityChange?: (density: PostDensity) => void;
+    /** ID of the currently open/selected post (for URL deep-linking). */
+    activeId?: string;
+    /** IDs of posts that have been visited (visual "read" state). */
+    readIds?: ReadonlyArray<string> | ReadonlySet<string>;
+    /** IDs of selected posts for bulk actions. */
+    selectedIds?: ReadonlyArray<string> | ReadonlySet<string>;
+    onSelectedIdsChange?: (ids: string[]) => void;
+    onOpen?: (post: PostData) => void;
+    /** Fired when the user triggers the default "view details" action on any card. */
+    onOpenDetails?: (post: PostData) => void;
+    /** Per-post action set. If omitted, each card uses its defaults. */
+    actions?: PostAction[];
+    /** Render the density toggle in the toolbar. Defaults to true. */
+    showToolbar?: boolean;
+    /** Custom toolbar content rendered next to the density toggle. */
+    toolbarExtra?: React$1.ReactNode;
+}
+declare const PostList: React$1.ForwardRefExoticComponent<PostListProps & React$1.RefAttributes<HTMLDivElement>>;
+
+/**
+ * Extended platform set: social media + government broadcast/print sources
+ * (TV, Radio, Press). Use this for cross-platform feeds where a tracked
+ * topic surfaces in both an Instagram post AND a TV broadcast.
+ */
+type ExtendedPlatform = SocialPlatform | 'tv' | 'radio' | 'press';
+/**
+ * Metrics shape varies by platform — social posts have likes/comments,
+ * TV/radio clips have viewers/listeners, news articles often just have
+ * a share count or comment-thread total. All optional.
+ */
+interface MultiPlatformMetrics {
+    likes?: number;
+    comments?: number;
+    shares?: number;
+    views?: number;
+    /** TV viewers OR radio listeners (different display label, same number type) */
+    audience?: number;
+}
+interface MultiPlatformPostData {
+    /** Stable id for keys + analytics */
+    id: string;
+    platform: ExtendedPlatform;
+    /** Outlet/account display name (e.g. "BBC فارسی", "@news_ir", "صدا و سیما"). */
+    sourceName: string;
+    /** Optional headline — typical for news + TV/radio segments, often absent on social. */
+    title?: React$1.ReactNode;
+    /** Body text or transcript excerpt. */
+    body: React$1.ReactNode;
+    /** Publication / broadcast time. Date or ISO string. */
+    publishedAt: Date | string;
+    /** Optional thumbnail (post image, article hero, video still). */
+    thumbnailUrl?: string;
+    /**
+     * Optional clip duration in **seconds** — only meaningful for TV / radio /
+     * video. Rendered as `MM:SS` or `HH:MM:SS`.
+     */
+    durationSec?: number;
+    metrics?: MultiPlatformMetrics;
+    /** Optional URL to the source. When set, the card gains an "open at source" affordance. */
+    sourceUrl?: string;
+    /** Optional language tag for the body. Renders a small chip when set. */
+    language?: string;
+}
+interface MultiPlatformPostCardProps extends Omit<React$1.HTMLAttributes<HTMLElement>, 'onClick'> {
+    post: MultiPlatformPostData;
+    /** Make the entire card clickable (opens sourceUrl in new tab if not custom) */
+    onCardClick?: (post: MultiPlatformPostData) => void;
+    /** Compact density hides body excerpt + thumbnail */
+    density?: 'compact' | 'comfortable';
+    /** Locale for labels + relative-time formatting */
+    locale?: SupportedLocale;
+}
+declare const MultiPlatformPostCard: React$1.ForwardRefExoticComponent<MultiPlatformPostCardProps & React$1.RefAttributes<HTMLElement>>;
+
+type PostDetailsTab = 'post' | 'comments' | 'analysis' | 'transcript';
+interface PostDetailsModalProps {
+    /** Controls modal open state. */
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    /** The post being viewed. If null/undefined, the modal renders nothing. */
+    post?: PostData | null;
+    /** Extended details — comments, AI analysis, OCR, platform metadata. */
+    details?: PostDetails;
+    /** Callback when user opens the source. Falls back to `post.sourceUrl`. */
+    onOpenSource?: (post: PostData) => void;
+    /** Loading state — true while fetching extended details. */
+    isLoading?: boolean;
+    /** Error state — when set, renders an error panel with optional retry. */
+    error?: string | Error | null;
+    /** Fires when user clicks "retry" on the error panel. */
+    onRetry?: () => void;
+    /** Which tab to open first @default "post" */
+    defaultTab?: PostDetailsTab;
+    /** Dialog size. @default "lg" (~1024px) */
+    size?: 'md' | 'lg' | 'xl';
+    /** Show the bookmark toggle. When `onBookmark` is set, the button appears. */
+    bookmarked?: boolean;
+    onBookmark?: (post: PostData, next: boolean) => void;
+    /** Override default clipboard writer. */
+    onCopyLink?: (post: PostData, url: string) => void;
+    /** Extra action slot (rendered at logical-end of the top action bar — e.g. a dropdown/"more" menu). */
+    headerActions?: React$1.ReactNode;
+}
+declare const PostDetailsModal: React$1.FC<PostDetailsModalProps>;
+
+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> {
+    /**
+     * نام کامل کاربر
+     */
+    name: string;
+    /**
+     * نام کاربری (username)
+     */
+    username: string;
+    /**
+     * آدرس تصویر پروفایل
+     */
+    avatarSrc?: string;
+    /**
+     * متن جایگزین برای تصویر
+     */
+    avatarAlt?: string;
+    /**
+     * حروف اولیه برای fallback (اختیاری)
+     */
+    initials?: string;
+    /**
+     * تعداد فالوورها
+     */
+    followers?: number;
+    /**
+     * آیکون فالوور
+     */
+    followersIcon?: React$1.ReactNode;
+    /**
+     * تابع کلیک روی کارت
+     */
     onCardClick?: () => void;
     /**
      * استایل حاشیه آواتار
@@ -2111,6 +3493,71 @@ interface EngagementRateProps extends React$1.HTMLAttributes<HTMLDivElement> {
 }
 declare const EngagementRate: React$1.ForwardRefExoticComponent<EngagementRateProps & React$1.RefAttributes<HTMLDivElement>>;
 
+interface BenchmarkTier {
+    /** Optional label shown below the segment (e.g., "عالی"). */
+    label?: React$1.ReactNode;
+    /** Inclusive upper bound of this tier. Use Infinity for the last tier. */
+    max: number;
+    /** CSS color — accepts any CSS value, including `hsl(var(--token))`. */
+    color: string;
+}
+interface BenchmarkMarker {
+    /** Position on the scale. Clamped to [min, max]. */
+    value: number;
+    /** Optional label shown above the marker (e.g., "میانگین صنعت"). */
+    label?: React$1.ReactNode;
+    /** Override the marker colour @default foreground */
+    color?: string;
+}
+/**
+ * Default 4-tier benchmark for engagement rate (percent). Thresholds picked
+ * for general social media (Instagram/Twitter/YouTube) — override with
+ * `getEngagementRateBenchmarkTiers` for follower-tiered thresholds.
+ *
+ * - 0–1%   → poor
+ * - 1–2.5% → moderate
+ * - 2.5–5% → good
+ * - >5%    → excellent
+ */
+declare function getEngagementRateBenchmarkTiers(locale?: SupportedLocale): BenchmarkTier[];
+/**
+ * Default 4-tier for a 0-100 score scale (e.g., Page Evaluation overall score).
+ * Thresholds: <40 poor, 40-60 moderate, 60-80 good, >=80 excellent.
+ */
+declare function getScoreBenchmarkTiers(locale?: SupportedLocale): BenchmarkTier[];
+/** Find which tier index contains value `v`. */
+declare function findTierIndex(value: number, tiers: BenchmarkTier[]): number;
+interface EngagementRateBenchmarkProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    /** The value to mark on the scale (typically engagement rate in %). */
+    value: number;
+    /** Scale start @default 0 */
+    min?: number;
+    /** Scale end @default 10 (engagement rate %) */
+    max?: number;
+    /** Tier segments. Must be ordered by ascending `max`. @default getEngagementRateBenchmarkTiers(locale) */
+    tiers?: BenchmarkTier[];
+    /** Optional comparison markers (industry average, target, …) */
+    benchmarks?: BenchmarkMarker[];
+    /**
+     * Label for the primary value marker. If omitted, renders the value with
+     * localized digits + "٪" (fa/ar) or "%" (en).
+     */
+    valueLabel?: React$1.ReactNode;
+    /** Show the numeric min/max under the bar @default true */
+    showScale?: boolean;
+    /** Show tier labels below each segment @default false */
+    showTierLabels?: boolean;
+    /** Bar height @default "md" */
+    size?: 'sm' | 'md' | 'lg';
+    /** Hide the primary value marker (e.g., when rendering multiple benchmarks only) */
+    hideValueMarker?: boolean;
+    /** Locale for digit + default label formatting @default "fa" */
+    locale?: SupportedLocale;
+    /** Number of decimals for scale labels @default 0 or 1 depending on max */
+    scaleDecimals?: number;
+}
+declare const EngagementRateBenchmark: React$1.ForwardRefExoticComponent<EngagementRateBenchmarkProps & React$1.RefAttributes<HTMLDivElement>>;
+
 interface EngagementRateBarProps extends React$1.HTMLAttributes<HTMLDivElement> {
     /**
      * نرخ تعامل فعلی (به صورت عدد اعشاری، مثلاً 0.05710 برای 5.710%)
@@ -2147,7 +3594,7 @@ declare const progressVariants: (props?: ({
     size?: "sm" | "md" | "lg" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 declare const progressIndicatorVariants: (props?: ({
-    variant?: "success" | "warning" | "destructive" | "primary" | "secondary" | null | undefined;
+    variant?: "warning" | "success" | "destructive" | "primary" | "secondary" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 interface ProgressProps extends React$1.ComponentProps<typeof ProgressPrimitive.Root>, VariantProps<typeof progressVariants>, VariantProps<typeof progressIndicatorVariants> {
     label?: string;
@@ -2155,9 +3602,82 @@ interface ProgressProps extends React$1.ComponentProps<typeof ProgressPrimitive.
 }
 declare const Progress: React$1.ForwardRefExoticComponent<Omit<ProgressProps, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 
+interface QuotaThresholds {
+    /** Ratio (0..1) at which bar turns amber. @default 0.7 */
+    amber: number;
+    /** Ratio (0..1) at which bar turns orange. @default 0.9 */
+    orange: number;
+    /** Ratio (0..1) at which bar turns destructive. @default 1 */
+    red: number;
+}
+declare const DEFAULT_THRESHOLDS: QuotaThresholds;
+type QuotaLevel = 'ok' | 'amber' | 'orange' | 'red';
+declare function resolveLevel(ratio: number, thresholds: QuotaThresholds): QuotaLevel;
+interface QuotaProgressBarProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    /** Units consumed so far (clamped to >= 0). */
+    used: number;
+    /** Total units allowed. Must be > 0. */
+    limit: number;
+    /** Optional label shown before the bar (e.g., "لایک روزانه") */
+    label?: React$1.ReactNode;
+    /**
+     * When set, renders a colour-coded dot + default label ("پسندیدن"/"Like"/…).
+     * Convenience for quota-by-action-type display; skip for generic quotas.
+     */
+    actionType?: ActionTypeKey;
+    /** Show `used / limit` text on trailing end @default true */
+    showCount?: boolean;
+    /** Show percentage next to count @default false */
+    showPercent?: boolean;
+    /** Show ⚠ icon when the bar is at `orange` or `red` level @default true */
+    showWarningIcon?: boolean;
+    /** Bar height @default "sm" */
+    size?: 'xs' | 'sm' | 'md' | 'lg';
+    /**
+     * Override colour thresholds. Ratios are `used / limit`. Defaults:
+     * - amber: 0.7, orange: 0.9, red: 1.
+     */
+    thresholds?: Partial<QuotaThresholds>;
+    /** Locale for digit + default label formatting @default "fa" */
+    locale?: SupportedLocale;
+    /**
+     * Allow the bar to visually extend past 100% when quota is over-consumed.
+     * When `true`, the fill stays at 100% of the track but a repeating stripe
+     * pattern + red glow signals overflow. @default false (clamp to 100%)
+     */
+    showOverflow?: boolean;
+}
+declare const QuotaProgressBar: React$1.ForwardRefExoticComponent<QuotaProgressBarProps & React$1.RefAttributes<HTMLDivElement>>;
+
 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>>;
 
+interface RateLimitBannerProps extends Omit<BannerProps, 'variant' | 'icon' | 'action' | 'children'> {
+    /** When the cooldown ends — Date, ISO string, or epoch ms */
+    resumeAt: Date | string | number;
+    /** Which action is rate-limited — renders in the title (e.g., «پسندیدن متوقف شده») */
+    actionType?: ActionTypeKey;
+    /** Short explanation (1-2 sentences). Falls back to a locale-specific generic. */
+    reason?: React$1.ReactNode;
+    /**
+     * Whether to re-render every second so the countdown ticks live.
+     * @default true
+     */
+    live?: boolean;
+    /** Visual tone @default "destructive" */
+    variant?: 'destructive' | 'warning';
+    /**
+     * Callback to retry the operation now (ignores cooldown). Rendered as an
+     * action button when provided.
+     */
+    onRetryNow?: () => void;
+    /** Override label for the retry button */
+    retryLabel?: React$1.ReactNode;
+    /** Locale for default strings + countdown @default "fa" */
+    locale?: SupportedLocale;
+}
+declare const RateLimitBanner: React$1.ForwardRefExoticComponent<RateLimitBannerProps & React$1.RefAttributes<HTMLDivElement>>;
+
 declare const RadioCards: React$1.ForwardRefExoticComponent<Omit<RadioGroupPrimitive.RadioGroupProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & {
     columns?: number;
     dir?: "rtl" | "ltr";
@@ -2209,58 +3729,6 @@ declare const SelectLabel: React$1.ForwardRefExoticComponent<Omit<SelectPrimitiv
 declare const SelectItem: React$1.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectItemProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 declare const SelectSeparator: React$1.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectSeparatorProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 
-declare function Sheet({ ...props }: React$1.ComponentProps<typeof DialogPrimitive.Root>): react_jsx_runtime.JSX.Element;
-declare namespace Sheet {
-    var displayName: string;
-}
-declare function SheetTrigger({ ...props }: React$1.ComponentProps<typeof DialogPrimitive.Trigger>): react_jsx_runtime.JSX.Element;
-declare namespace SheetTrigger {
-    var displayName: string;
-}
-declare function SheetClose({ ...props }: React$1.ComponentProps<typeof DialogPrimitive.Close>): react_jsx_runtime.JSX.Element;
-declare namespace SheetClose {
-    var displayName: string;
-}
-declare function SheetContent({ className, children, side, ...props }: React$1.ComponentProps<typeof DialogPrimitive.Content> & {
-    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 namespace SheetHeader {
-    var displayName: string;
-}
-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;
-}
-declare function SheetTitle({ className, ...props }: React$1.ComponentProps<typeof DialogPrimitive.Title>): react_jsx_runtime.JSX.Element;
-declare namespace SheetTitle {
-    var displayName: string;
-}
-declare function SheetDescription({ className, ...props }: React$1.ComponentProps<typeof DialogPrimitive.Description>): react_jsx_runtime.JSX.Element;
-declare namespace SheetDescription {
-    var displayName: string;
-}
-
-declare const TooltipProvider: React$1.FC<TooltipPrimitive.TooltipProviderProps>;
-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';
-    /** Size */
-    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';
     open: boolean;
@@ -2269,12 +3737,23 @@ type SidebarContextProps = {
     setOpenMobile: (open: boolean) => void;
     isMobile: boolean;
     toggleSidebar: () => void;
+    /**
+     * When true, the sidebar is positioned absolutely within its parent wrapper
+     * instead of fixed to the viewport. Use inside bounded previews, cards,
+     * or anywhere the sidebar should not escape its container.
+     */
+    contained: boolean;
 };
 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, contained, className, style, children, ...props }: React$1.ComponentProps<'div'> & {
     defaultOpen?: boolean;
     open?: boolean;
     onOpenChange?: (open: boolean) => void;
+    /**
+     * When true, the sidebar is positioned absolutely within this provider
+     * instead of fixed to the viewport. Use inside bounded previews or cards.
+     */
+    contained?: boolean;
 }): react_jsx_runtime.JSX.Element;
 declare function Sidebar({ side, variant, collapsible, className, children, ...props }: React$1.ComponentProps<'div'> & {
     side?: 'left' | 'right';
@@ -2410,6 +3889,52 @@ declare function TableSkeleton({ rows, className }: TableSkeletonProps): react_j
 declare namespace TableSkeleton {
     var displayName: string;
 }
+interface TableRowSkeletonProps {
+    /** Number of cells in the row */
+    cells?: number;
+    className?: string;
+}
+declare function TableRowSkeleton({ cells, className }: TableRowSkeletonProps): react_jsx_runtime.JSX.Element;
+declare namespace TableRowSkeleton {
+    var displayName: string;
+}
+interface CardSkeletonProps {
+    /** Show a leading image/thumbnail block @default false */
+    withImage?: boolean;
+    /** Aspect ratio of the image (when withImage) @default 'video' */
+    imageAspect?: 'video' | 'square' | 'wide';
+    /** Number of body lines @default 2 */
+    bodyLines?: number;
+    /** Show a footer row (button-shaped placeholder) @default false */
+    withFooter?: boolean;
+    className?: string;
+}
+declare function CardSkeleton({ withImage, imageAspect, bodyLines, withFooter, className, }: CardSkeletonProps): react_jsx_runtime.JSX.Element;
+declare namespace CardSkeleton {
+    var displayName: string;
+}
+interface AvatarTextSkeletonProps {
+    /** Avatar size @default 'md' */
+    size?: 'sm' | 'md' | 'lg';
+    /** Number of text lines beside the avatar @default 2 */
+    lines?: number;
+    className?: string;
+}
+declare function AvatarTextSkeleton({ size, lines, className }: AvatarTextSkeletonProps): react_jsx_runtime.JSX.Element;
+declare namespace AvatarTextSkeleton {
+    var displayName: string;
+}
+interface FormRowSkeletonProps {
+    /** Field shape — 'input' (one-line), 'textarea' (3-line), 'select' (input + chevron) */
+    field?: 'input' | 'textarea' | 'select';
+    /** Show help text line below input @default false */
+    withHelp?: boolean;
+    className?: string;
+}
+declare function FormRowSkeleton({ field, withHelp, className }: FormRowSkeletonProps): react_jsx_runtime.JSX.Element;
+declare namespace FormRowSkeleton {
+    var displayName: string;
+}
 
 declare function Slider({ className, defaultValue, value, min, max, dir, ...props }: React$1.ComponentProps<typeof SliderPrimitive.Root>): react_jsx_runtime.JSX.Element;
 declare namespace Slider {
@@ -2432,7 +3957,7 @@ interface SpinnerProps extends React$1.HTMLAttributes<HTMLSpanElement>, VariantP
 declare const Spinner: React$1.ForwardRefExoticComponent<SpinnerProps & React$1.RefAttributes<HTMLSpanElement>>;
 
 declare const switchRootVariants: (props?: ({
-    size?: "sm" | "md" | "lg" | "small" | "medium" | "large" | null | undefined;
+    size?: "medium" | "sm" | "md" | "lg" | "small" | "large" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 interface SwitchProps extends React$1.ComponentPropsWithoutRef<typeof SwitchPrimitive.Root>, VariantProps<typeof switchRootVariants> {
 }
@@ -2626,6 +4151,197 @@ interface StepProps extends React$1.HTMLAttributes<HTMLDivElement> {
 declare const Stepper: React$1.ForwardRefExoticComponent<StepperProps & React$1.RefAttributes<HTMLDivElement>>;
 declare const Step: React$1.ForwardRefExoticComponent<StepProps & React$1.RefAttributes<HTMLDivElement>>;
 
+interface StatusFlowStageData {
+    /** Stable identifier */
+    id: string;
+    /** Display label */
+    label: React$1.ReactNode;
+    /** Optional one-line description under the label */
+    description?: React$1.ReactNode;
+    /** Optional trailing meta (duration, count, …) shown next to the label */
+    meta?: React$1.ReactNode;
+    /** Status of this stage */
+    status: StageStatusKey;
+    /** Progress 0-100 within this stage. Rendered only when `status === "running"`. */
+    progress?: number;
+}
+type StatusFlowOrientation = 'horizontal' | 'vertical';
+type StatusFlowSize = 'sm' | 'md' | 'lg';
+interface StatusFlowProps extends Omit<React$1.OlHTMLAttributes<HTMLOListElement>, 'children'> {
+    /** Data-driven stage list. Mutually exclusive with `children`. */
+    stages?: StatusFlowStageData[];
+    /** Composition API — an array of `<StatusFlowStage>` children. */
+    children?: React$1.ReactNode;
+    /** Layout @default "horizontal" */
+    orientation?: StatusFlowOrientation;
+    /** Size @default "md" */
+    size?: StatusFlowSize;
+    /** Whether labels below/beside markers are shown. @default true */
+    showLabels?: boolean;
+    /** Locale for digits + accessible announcements @default "fa" */
+    locale?: SupportedLocale;
+    /** Fires when a stage marker is clicked. When set, markers become buttons. */
+    onStageSelect?: (stage: StatusFlowStageData, index: number) => void;
+}
+interface StatusFlowStageProps extends Omit<StatusFlowStageData, 'id'> {
+    id?: string;
+}
+/**
+ * Optional composition wrapper. Use this or the `stages` prop on
+ * `<StatusFlow>` — not both. StatusFlow injects position metadata as
+ * internal props; StatusFlowStage should not be rendered outside.
+ */
+declare function StatusFlowStage(props: StatusFlowStageProps): React$1.ReactElement;
+declare const StatusFlow: React$1.ForwardRefExoticComponent<StatusFlowProps & React$1.RefAttributes<HTMLOListElement>>;
+
+interface JobWizardStep {
+    /** Stable identifier — referenced by `validateStep`, `goToStep`, etc. */
+    id: string;
+    /** Step title (shown in stepper + header when this step is active) */
+    title: string;
+    /** Optional one-line description under the title */
+    description?: string;
+    /** Mark step as optional — a "Skip" button appears. @default false */
+    optional?: boolean;
+    /**
+     * Branching: resolve the next step id based on current data. Returning a
+     * known step id navigates there (skipping any steps in between); returning
+     * `null` marks the wizard as terminal (the Next button submits); returning
+     * `undefined` falls back to the natural linear `currentIndex + 1`.
+     *
+     * Cast `data` to your wizard's data shape inside the callback.
+     */
+    nextStep?: (data: Partial<Record<string, unknown>>) => string | null | undefined;
+}
+/** Result of a validator — `null`/`undefined` = pass, `string` = single error, `Record<field, message>` = field errors */
+type JobWizardValidationResult = string | Record<string, string> | null | undefined;
+type JobWizardSubmitState = 'idle' | 'submitting' | 'success' | 'error';
+interface UseJobWizardOptions<TData extends Record<string, unknown>> {
+    /** Ordered list of steps. Pass a new array reference when the step list should change dynamically (e.g. branching). */
+    steps: JobWizardStep[];
+    /** Initial form data */
+    initialData?: Partial<TData>;
+    /**
+     * Validator fired before navigating to the next step. Also runs for each step
+     * on submit if `validateAllOnSubmit` is true.
+     *
+     * Return `null`/`undefined` to pass, or an error (string or field-map) to block navigation.
+     */
+    validateStep?: (stepId: string, data: Partial<TData>) => JobWizardValidationResult | Promise<JobWizardValidationResult>;
+    /** Called when the user confirms the last step. May return a Promise. */
+    onSubmit: (data: TData) => Promise<unknown> | unknown;
+    /** Called when the user clicks Cancel */
+    onCancel?: () => void;
+    /** When set, drafts are persisted to localStorage under this key. */
+    draftKey?: string;
+    /** Debounce (ms) for draft save. @default 300 */
+    draftDebounceMs?: number;
+    /** Validate all steps (in order) on submit. Default false — only the current step is validated before submit. */
+    validateAllOnSubmit?: boolean;
+}
+interface JobWizardApi<TData extends Record<string, unknown>> {
+    /** Current step (resolved from `steps[currentIndex]`). */
+    readonly currentStep: JobWizardStep;
+    readonly currentIndex: number;
+    readonly isFirst: boolean;
+    readonly isLast: boolean;
+    readonly steps: JobWizardStep[];
+    /** Mutable form data (merged across all steps). */
+    readonly data: Partial<TData>;
+    /** Replace the data object. */
+    setData: React$1.Dispatch<React$1.SetStateAction<Partial<TData>>>;
+    /** Shallow-merge the given patch into `data`. */
+    update: (patch: Partial<TData>) => void;
+    /** Current error. String = whole-step error, Record = per-field errors. */
+    readonly error: string | Record<string, string> | null;
+    /** Clear the current error. */
+    clearError: () => void;
+    /** Submit state lifecycle. */
+    readonly submitState: JobWizardSubmitState;
+    readonly submitResult: unknown;
+    readonly submitError: Error | null;
+    /** Advance to the next step. Runs validation first. Returns true if navigated. */
+    next: () => Promise<boolean>;
+    /** Go back to the previous step. */
+    back: () => void;
+    /** Jump to a specific step by id. Does NOT validate. */
+    goToStep: (id: string) => void;
+    /** Fire onSubmit. Runs validation first (current step only, unless `validateAllOnSubmit`). */
+    submit: () => Promise<void>;
+    /** Fire onCancel if provided. */
+    cancel: () => void;
+    /** Reset wizard to first step + `initialData` + idle state. Also clears draft. */
+    reset: () => void;
+    /** Remove the saved draft from localStorage (if `draftKey` set). */
+    clearDraft: () => void;
+    /** True iff the step at this id has been visited. */
+    isStepVisited: (id: string) => boolean;
+    /** Resolved stage status for the StatusFlow stepper. */
+    stageStatus: (step: JobWizardStep, index: number) => StageStatusKey;
+}
+declare function useJobWizard<TData extends Record<string, unknown>>(options: UseJobWizardOptions<TData>): JobWizardApi<TData>;
+/** Hook to access the wizard from within nested components. */
+declare function useJobWizardState<TData extends Record<string, unknown> = Record<string, unknown>>(): JobWizardApi<TData>;
+interface JobWizardProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    /** Wizard API from `useJobWizard`. */
+    wizard: JobWizardApi<Record<string, unknown>>;
+    /** Locale @default "fa" */
+    locale?: SupportedLocale;
+}
+declare const JobWizard: React$1.ForwardRefExoticComponent<JobWizardProps & React$1.RefAttributes<HTMLDivElement>>;
+interface JobWizardHeaderProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, 'title'> {
+    /** Main title of the wizard (persistent across steps). If omitted, shows the current step's title. */
+    title?: React$1.ReactNode;
+    /** Short description / context line under the title. */
+    description?: React$1.ReactNode;
+    /** Trailing slot (e.g. a close button). */
+    trailing?: React$1.ReactNode;
+}
+declare const JobWizardHeader: React$1.ForwardRefExoticComponent<JobWizardHeaderProps & React$1.RefAttributes<HTMLDivElement>>;
+interface JobWizardStepperProps {
+    /** Orientation @default "horizontal" */
+    orientation?: 'horizontal' | 'vertical';
+    /** Size @default "md" */
+    size?: 'sm' | 'md' | 'lg';
+    /** Allow clicking visited steps to jump back. @default true */
+    allowJump?: boolean;
+    className?: string;
+}
+declare const JobWizardStepper: React$1.FC<JobWizardStepperProps>;
+declare const JobWizardBody: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & React$1.RefAttributes<HTMLDivElement>>;
+declare const JobWizardError: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & React$1.RefAttributes<HTMLDivElement>>;
+declare const JobWizardFooter: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & React$1.RefAttributes<HTMLDivElement>>;
+/** Invisible flex spacer — pushes following buttons to the logical end. */
+declare const JobWizardSpacer: React$1.FC;
+interface JobWizardBackProps extends Omit<React$1.ComponentProps<typeof Button>, 'onClick'> {
+    /** Override label */
+    children?: React$1.ReactNode;
+}
+declare const JobWizardBack: React$1.ForwardRefExoticComponent<Omit<JobWizardBackProps, "ref"> & React$1.RefAttributes<HTMLButtonElement>>;
+interface JobWizardNextProps extends Omit<React$1.ComponentProps<typeof Button>, 'onClick'> {
+    /** Override label (not applied when on last step — uses `submitLabel` then) */
+    children?: React$1.ReactNode;
+    /** Label for the submit button when on the last step */
+    submitLabel?: React$1.ReactNode;
+}
+declare const JobWizardNext: React$1.ForwardRefExoticComponent<Omit<JobWizardNextProps, "ref"> & React$1.RefAttributes<HTMLButtonElement>>;
+interface JobWizardCancelProps extends Omit<React$1.ComponentProps<typeof Button>, 'onClick'> {
+    children?: React$1.ReactNode;
+}
+declare const JobWizardCancel: React$1.ForwardRefExoticComponent<Omit<JobWizardCancelProps, "ref"> & React$1.RefAttributes<HTMLButtonElement>>;
+interface JobWizardSkipProps extends Omit<React$1.ComponentProps<typeof Button>, 'onClick'> {
+    children?: React$1.ReactNode;
+}
+declare const JobWizardSkip: React$1.ForwardRefExoticComponent<Omit<JobWizardSkipProps, "ref"> & React$1.RefAttributes<HTMLButtonElement>>;
+interface JobWizardSuccessProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, 'title'> {
+    title?: React$1.ReactNode;
+    description?: React$1.ReactNode;
+    actions?: React$1.ReactNode;
+    /** Only render children when submitState === 'success' @default true */
+    autoShow?: boolean;
+}
+declare const JobWizardSuccess: React$1.ForwardRefExoticComponent<JobWizardSuccessProps & React$1.RefAttributes<HTMLDivElement>>;
+
 interface SentimentBadgeProps extends React$1.HTMLAttributes<HTMLSpanElement> {
     /** Sentiment type */
     sentiment: 'positive' | 'negative' | 'neutral' | 'mixed';
@@ -2640,28 +4356,111 @@ interface SentimentBadgeProps extends React$1.HTMLAttributes<HTMLSpanElement> {
 }
 declare const SentimentBadge: React$1.ForwardRefExoticComponent<SentimentBadgeProps & React$1.RefAttributes<HTMLSpanElement>>;
 
-interface MultiSelectOption {
-    value: string;
-    label: string;
-    disabled?: boolean;
+interface EmotionBadgeProps extends React$1.HTMLAttributes<HTMLSpanElement> {
+    /** Emotion (9-class advanced sentiment scale) */
+    emotion: EmotionKey;
+    /** Optional count — shown alongside the label */
+    count?: number;
+    /** Size variant */
+    size?: 'sm' | 'md';
+    /** Show the text label. When false, renders an icon-only chip (aria-label kept). */
+    showLabel?: boolean;
+    /** Locale for label + digit formatting */
+    locale?: SupportedLocale;
 }
-interface MultiSelectProps {
-    /** All available options */
-    options: MultiSelectOption[];
-    /** Currently selected values */
-    value?: string[];
-    /** Callback fired when selection changes */
-    onValueChange?: (value: string[]) => void;
-    /** Placeholder text when nothing is selected */
-    placeholder?: string;
-    /** Disables the entire control */
-    disabled?: boolean;
-    /** Shows loading skeleton in dropdown */
-    isLoading?: boolean;
-    /** Maximum number of items that can be selected */
-    maxSelected?: number;
-    /** How many selected chips to display before collapsing into a count badge */
-    maxDisplayed?: number;
+declare const EmotionBadge: React$1.ForwardRefExoticComponent<EmotionBadgeProps & React$1.RefAttributes<HTMLSpanElement>>;
+
+type EmotionData = Partial<Record<EmotionKey, number>>;
+interface EmotionDistributionProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    /** Emotion counts (auto-normalized to 100%). Missing keys are treated as 0. */
+    data: EmotionData;
+    /** Display mode */
+    variant?: 'bars' | 'stacked' | 'compact';
+    /**
+     * For 'compact' and 'bars': limit to the top-N emotions by value. Leftover
+     * contributions roll up into a muted "بقیه" chip so totals still make sense.
+     * Default 5 — matches the canonical تحلیل افکار summary density.
+     */
+    topN?: number;
+    /** Show numeric count labels (in addition to percent). */
+    showCounts?: boolean;
+    /** Show percentage labels. */
+    showPercent?: boolean;
+    /** Locale for label + digit formatting */
+    locale?: SupportedLocale;
+    /** Loading skeleton */
+    isLoading?: boolean;
+}
+declare const EmotionDistribution: React$1.ForwardRefExoticComponent<EmotionDistributionProps & React$1.RefAttributes<HTMLDivElement>>;
+
+interface FlowBadgeProps extends React$1.HTMLAttributes<HTMLSpanElement> {
+    /** Flow classification */
+    flow: FlowKey;
+    /** Optional count shown alongside the label */
+    count?: number;
+    /** Size */
+    size?: 'sm' | 'md';
+    /** Whether to render the text label (keeps aria-label when false) */
+    showLabel?: boolean;
+    /** Locale for label + digit formatting */
+    locale?: SupportedLocale;
+}
+declare const FlowBadge: React$1.ForwardRefExoticComponent<FlowBadgeProps & React$1.RefAttributes<HTMLSpanElement>>;
+
+interface StatusBadgeProps extends React$1.HTMLAttributes<HTMLSpanElement> {
+    /** Operational status */
+    status: StatusKey;
+    /** Size */
+    size?: 'sm' | 'md';
+    /** Show text label (keeps aria-label when false) */
+    showLabel?: boolean;
+    /** Locale */
+    locale?: SupportedLocale;
+    /**
+     * Explicitly enable/disable the pulse animation on the indicator dot.
+     * Default: animated only for `status="critical"`. Pair with
+     * `prefers-reduced-motion` (already honoured globally in globals.css).
+     */
+    animated?: boolean;
+}
+declare const StatusBadge: React$1.ForwardRefExoticComponent<StatusBadgeProps & React$1.RefAttributes<HTMLSpanElement>>;
+
+interface SeverityBadgeProps extends React$1.HTMLAttributes<HTMLSpanElement> {
+    /** Urgency level — independent from operational status */
+    severity: SeverityKey;
+    /** Size */
+    size?: 'sm' | 'md';
+    /** Show text label */
+    showLabel?: boolean;
+    /** Render as a solid chip instead of the soft tinted pill (for high-contrast lists) */
+    variant?: 'soft' | 'solid';
+    /** Locale */
+    locale?: SupportedLocale;
+}
+declare const SeverityBadge: React$1.ForwardRefExoticComponent<SeverityBadgeProps & React$1.RefAttributes<HTMLSpanElement>>;
+
+interface MultiSelectOption {
+    value: string;
+    label: string;
+    disabled?: boolean;
+}
+interface MultiSelectProps {
+    /** All available options */
+    options: MultiSelectOption[];
+    /** Currently selected values */
+    value?: string[];
+    /** Callback fired when selection changes */
+    onValueChange?: (value: string[]) => void;
+    /** Placeholder text when nothing is selected */
+    placeholder?: string;
+    /** Disables the entire control */
+    disabled?: boolean;
+    /** Shows loading skeleton in dropdown */
+    isLoading?: boolean;
+    /** Maximum number of items that can be selected */
+    maxSelected?: number;
+    /** How many selected chips to display before collapsing into a count badge */
+    maxDisplayed?: number;
     /** Locale for display and default strings */
     locale?: SupportedLocale;
     /** Additional className on the trigger */
@@ -2696,23 +4495,6 @@ interface PeriodSelectorProps {
 }
 declare const PeriodSelector: React$1.ForwardRefExoticComponent<PeriodSelectorProps & React$1.RefAttributes<HTMLDivElement>>;
 
-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';
-    /** Show the platform name label */
-    showLabel?: boolean;
-    /** Visual style of the 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> {
     /** Locale for placeholder and aria labels */
     locale?: SupportedLocale;
@@ -2731,28 +4513,6 @@ interface SearchInputProps extends Omit<React$1.InputHTMLAttributes<HTMLInputEle
 }
 declare const SearchInput: React$1.ForwardRefExoticComponent<SearchInputProps & React$1.RefAttributes<HTMLInputElement>>;
 
-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';
-    /** Show numeric count labels */
-    showCounts?: boolean;
-    /** Show percentage labels */
-    showPercent?: boolean;
-    /** Locale for number/label formatting */
-    locale?: SupportedLocale;
-    /** Show loading skeleton */
-    isLoading?: boolean;
-}
-declare const SentimentDistribution: React$1.ForwardRefExoticComponent<SentimentDistributionProps & React$1.RefAttributes<HTMLDivElement>>;
-
 interface ComparisonCardProps extends React$1.HTMLAttributes<HTMLDivElement> {
     /** Card title */
     title: string;
@@ -2785,74 +4545,197 @@ interface ComparisonCardProps extends React$1.HTMLAttributes<HTMLDivElement> {
 }
 declare const ComparisonCard: React$1.ForwardRefExoticComponent<ComparisonCardProps & React$1.RefAttributes<HTMLDivElement>>;
 
-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> */
+/**
+ * data-table-cells — opinionated thin wrappers around DS primitives, sized
+ * and styled for use as `DataTableColumn.cell` values. Each cell renderer
+ * gives a consistent inline footprint (no margin/padding chrome) and pairs
+ * a chart/badge with optional numeric value text.
+ *
+ * Usage:
+ *   columns={[
+ *     {
+ *       id: 'engagement',
+ *       header: 'تعامل',
+ *       cell: (row) => <SparklineCell data={row.history} value={row.eRate} suffix="٪" />,
+ *     },
+ *     ...
+ *   ]}
+ */
+interface SparklineCellProps {
+    /** History values (typically 6-12 points) */
+    data: number[];
+    /** Optional numeric value shown after the sparkline */
+    value?: number;
+    /** Suffix appended to value (e.g., '٪') */
+    suffix?: React$1.ReactNode;
+    /** Sparkline width in px @default 64 */
+    width?: number;
+    /** Sparkline height in px @default 18 */
+    height?: number;
+    /** Sparkline visual variant @default 'line' */
+    variant?: 'line' | 'area' | 'bars';
+    /** Override trend color (auto-detected from first vs last) */
+    trend?: 'up' | 'down' | 'neutral';
+    /** Locale @default 'fa' */
+    locale?: SupportedLocale;
+    /** Decimal places for value @default 0 */
+    decimals?: number;
     className?: string;
-    /** Column alignment */
-    align?: 'start' | 'center' | 'end';
 }
-interface DataTablePagination {
-    currentPage: number;
-    totalPages: number;
-    onPageChange: (page: number) => void;
+declare const SparklineCell: React$1.ForwardRefExoticComponent<SparklineCellProps & React$1.RefAttributes<HTMLDivElement>>;
+interface TrendCellProps {
+    /** Numeric delta. Positive=up, negative=down, zero=flat. */
+    value: number;
+    /** Suffix (e.g., '٪'). */
+    suffix?: React$1.ReactNode;
+    /** Show the absolute value text alongside the arrow @default true */
+    showValue?: boolean;
+    /** Inverted trend (lower=better) — colours flip */
+    invert?: boolean;
+    /** Locale @default 'fa' */
+    locale?: SupportedLocale;
+    className?: string;
 }
-interface DataTableSort {
-    column: string | null;
-    direction: SortDirection | null;
-    onSort: (column: string, direction: SortDirection) => void;
+declare const TrendCell: React$1.ForwardRefExoticComponent<TrendCellProps & React$1.RefAttributes<HTMLSpanElement>>;
+interface StatusPulseCellProps {
+    status: StatusKey;
+    /** Optional label after the dot (omit for ultra-compact rows) */
+    label?: React$1.ReactNode;
+    /** Locale (forwarded to StatusBadge for default labels) */
+    locale?: SupportedLocale;
+    className?: string;
 }
-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;
+declare const StatusPulseCell: React$1.ForwardRefExoticComponent<StatusPulseCellProps & React$1.RefAttributes<HTMLSpanElement>>;
+interface SentimentCellProps {
+    /** Sentiment counts. */
+    data: SentimentData;
+    /** Visual mode @default 'stacked' */
+    variant?: 'stacked' | 'bars' | 'compact';
+    /** Width of the inline bar @default 80 */
+    width?: number;
+    /** Locale */
+    locale?: SupportedLocale;
+    className?: string;
 }
-interface DataTableProps<TData> {
-    /** Column definitions */
+declare const SentimentCell: React$1.ForwardRefExoticComponent<SentimentCellProps & React$1.RefAttributes<HTMLDivElement>>;
+interface FlowCellProps {
+    /** Flow counts. */
+    data: FlowData;
+    /** Visual mode @default 'stacked' */
+    variant?: 'stacked' | 'bars' | 'compact';
+    /** Width of the inline bar @default 96 */
+    width?: number;
+    /** Locale */
+    locale?: SupportedLocale;
+    className?: string;
+}
+declare const FlowCell: React$1.ForwardRefExoticComponent<FlowCellProps & React$1.RefAttributes<HTMLDivElement>>;
+interface ProgressCellProps {
+    /** Progress 0–100 */
+    value: number;
+    /** Show value text after the bar @default true */
+    showValue?: boolean;
+    /** Suffix on value (e.g., '٪'). Defaults to locale-appropriate %. */
+    suffix?: React$1.ReactNode;
+    /** Variant for color */
+    variant?: 'primary' | 'secondary' | 'success' | 'warning' | 'destructive';
+    /** Bar width @default 80 */
+    width?: number;
+    /** Locale @default 'fa' */
+    locale?: SupportedLocale;
+    className?: string;
+}
+declare const ProgressCell: React$1.ForwardRefExoticComponent<ProgressCellProps & React$1.RefAttributes<HTMLDivElement>>;
+interface StatDeltaCellProps {
+    /** Primary value (e.g., 1240) */
+    value: number | string;
+    /** Delta (positive=up). Hidden if undefined. */
+    delta?: number;
+    /** Format the value with locale digits @default true (when value is number) */
+    formatValue?: boolean;
+    /** Suffix on value */
+    valueSuffix?: React$1.ReactNode;
+    /** Suffix on delta */
+    deltaSuffix?: React$1.ReactNode;
+    /** Inverted trend (lower=better) */
+    invertDelta?: boolean;
+    /** Locale */
+    locale?: SupportedLocale;
+    className?: string;
+}
+declare const StatDeltaCell: React$1.ForwardRefExoticComponent<StatDeltaCellProps & React$1.RefAttributes<HTMLSpanElement>>;
+
+interface DataTableColumnVisibilityToggleProps<TData> {
     columns: DataTableColumn<TData>[];
-    /** Data rows */
+    visibility: DataTableColumnVisibility;
+    /** Locale @default 'fa' */
+    locale?: SupportedLocale;
+    /** Custom trigger label (defaults to "ستون‌ها") */
+    label?: React$1.ReactNode;
+    /** Custom Button class */
+    className?: string;
+    /** Override Button size */
+    size?: 'xs' | 'sm' | 'default';
+    /** Override Button variant */
+    variant?: 'default' | 'outline' | 'ghost' | 'secondary';
+}
+declare function DataTableColumnVisibilityToggle<TData>({ columns, visibility, locale, label, className, size, variant, }: DataTableColumnVisibilityToggleProps<TData>): react_jsx_runtime.JSX.Element;
+/**
+ * Convert column definitions + row data into a CSV string. Each cell is
+ * stringified by calling its `cell` render and extracting plain text — for
+ * complex React nodes pass an `exportValue: (row) => string` on the column.
+ */
+interface ExportableColumn<TData> extends DataTableColumn<TData> {
+    /** Override how this column's value is serialized for export. */
+    exportValue?: (row: TData, index: number) => string | number | boolean | null | undefined;
+}
+/**
+ * Build a CSV string from columns + rows. Header row uses each column's
+ * `header` (if string) or its `id` as fallback.
+ */
+declare function buildCsv<TData>(columns: ExportableColumn<TData>[], data: TData[]): string;
+/** Build a TSV string (tab-separated) — useful for "paste into spreadsheet". */
+declare function buildTsv<TData>(columns: ExportableColumn<TData>[], data: TData[]): string;
+/** Trigger a browser download of `content` with the given filename + mime. */
+declare function downloadFile(filename: string, content: string, mime?: string): void;
+interface DataTableExportButtonProps<TData> {
+    columns: ExportableColumn<TData>[];
     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 */
+    /** Output filename (default: data-<timestamp>.csv) */
+    filename?: string;
+    /** Locale @default 'fa' */
+    locale?: SupportedLocale;
+    /** Override label */
+    label?: React$1.ReactNode;
+    /** Hide TSV-copy entry @default false */
+    hideTsv?: boolean;
+    /** Custom Button class */
     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' */
+    /** Override Button size */
+    size?: 'xs' | 'sm' | 'default';
+    /** Override Button variant */
+    variant?: 'default' | 'outline' | 'ghost' | 'secondary';
+}
+declare function DataTableExportButton<TData>({ columns, data, filename, locale, label, hideTsv, className, size, variant, }: DataTableExportButtonProps<TData>): react_jsx_runtime.JSX.Element;
+
+interface TableComparisonViewProps<TData> {
+    /** Original DataTable column definitions — `cell()` is reused for rendering. */
+    columns: DataTableColumn<TData>[];
+    /** Rows being compared. Recommended 2-4. */
+    rows: TData[];
+    /** Optional label for each row column header (e.g., name). Falls back to `Row N`. */
+    rowLabel?: (row: TData, index: number) => React$1.ReactNode;
+    /** Callback for the column "remove" button. When omitted, no remove button shows. */
+    onRemoveRow?: (row: TData, index: number) => void;
+    /** Highlight cells whose value differs across rows @default true */
+    highlightDifferences?: boolean;
+    /** Locale @default 'fa' */
     locale?: SupportedLocale;
+    /** Empty state when no rows are passed */
+    emptyState?: React$1.ReactNode;
+    className?: string;
 }
-declare const DataTable: <TData>(props: DataTableProps<TData> & {
-    ref?: React$1.ForwardedRef<HTMLDivElement>;
-}) => React$1.ReactElement;
+declare const TableComparisonView: <TData>(props: TableComparisonViewProps<TData>) => React$1.ReactElement;
 
 interface DirectionalBoxProps extends React$1.HTMLAttributes<HTMLDivElement> {
     /**
@@ -2917,8 +4800,166 @@ interface SafeImageProps extends React$1.ImgHTMLAttributes<HTMLImageElement> {
 }
 declare const SafeImage: React$1.ForwardRefExoticComponent<SafeImageProps & React$1.RefAttributes<HTMLImageElement>>;
 
+interface ReportComposerProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, 'title'> {
+    /** Report title (e.g., "بولتن هفتگی — هفته ۱۴") */
+    title?: React$1.ReactNode;
+    /** Subtitle / metadata */
+    description?: React$1.ReactNode;
+    /** Top-right header actions (Save, Export, …) */
+    headerActions?: React$1.ReactNode;
+    /** Locale @default 'fa' */
+    locale?: SupportedLocale;
+}
+declare const ReportComposer: React$1.ForwardRefExoticComponent<ReportComposerProps & React$1.RefAttributes<HTMLDivElement>>;
+interface ReportSectionProps extends Omit<React$1.HTMLAttributes<HTMLElement>, 'title'> {
+    /** Section title */
+    title: React$1.ReactNode;
+    /** Optional secondary text */
+    description?: React$1.ReactNode;
+    /** Whether the section is enabled (in the bulletin output) */
+    enabled?: boolean;
+    /** Callback when the enable switch is toggled. When omitted, switch is hidden. */
+    onEnabledChange?: (next: boolean) => void;
+    /** Whether the section is collapsed (only the header visible) */
+    collapsed?: boolean;
+    /** Callback when collapse toggles. When omitted, collapse button is hidden. */
+    onCollapsedChange?: (next: boolean) => void;
+    /** Show drag handle (consumer wires the drag interaction) */
+    draggable?: boolean;
+    /** drag-handle pointerDown — set when wiring native or react-dnd */
+    onDragHandlePointerDown?: (e: React$1.PointerEvent<HTMLButtonElement>) => void;
+    /** Render a settings button (e.g., to open a popover). When omitted, hidden. */
+    onSettingsClick?: () => void;
+    /** Custom header actions (extra buttons beside settings) */
+    headerActions?: React$1.ReactNode;
+}
+declare const ReportSection: React$1.ForwardRefExoticComponent<ReportSectionProps & React$1.RefAttributes<HTMLElement>>;
+interface BulletinViewerProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, 'title'> {
+    /** Bulletin title (h1) */
+    title: React$1.ReactNode;
+    /** Author / source line */
+    author?: React$1.ReactNode;
+    /** Publish date display */
+    publishedAt?: React$1.ReactNode;
+    /** Optional list of subtitle lines (volume, edition, etc.) */
+    meta?: React$1.ReactNode[];
+    /** Action buttons in the header (Print, Download PDF, Share). Hidden when printing via @media print. */
+    headerActions?: React$1.ReactNode;
+    /** Locale @default 'fa' */
+    locale?: SupportedLocale;
+}
+declare const BulletinViewer: React$1.ForwardRefExoticComponent<BulletinViewerProps & React$1.RefAttributes<HTMLDivElement>>;
+
+/**
+ * Report section templates — thin compositions of existing primitives that
+ * each render inside a `<ReportSection>` shell. They cover the 6 layouts
+ * that recur across every افکارسنجی bulletin we've seen:
+ *
+ *   1. ExecutiveSummarySection   — title + AI paragraph + tile metrics
+ *   2. SentimentBreakdownSection — sentiment + optional 9-emotion side-by-side
+ *   3. FlowDistributionSection   — political-flow stacked bar
+ *   4. TopPostsSection           — compact PostList of N highlighted posts
+ *   5. TimelineSection           — line chart with optional sparkline summary
+ *   6. SourceBreakdownSection    — per-platform metric grid
+ *
+ * Each template is intentionally thin — props mirror the underlying
+ * primitive when possible. Consumers compose these inside a
+ * `<ReportComposer>`; for non-template sections, `<ReportSection>` is
+ * still the building block.
+ */
+
+type ReportSectionShellProps = Pick<ReportSectionProps, 'enabled' | 'onEnabledChange' | 'collapsed' | 'onCollapsedChange' | 'draggable' | 'onDragHandlePointerDown' | 'onSettingsClick' | 'headerActions'>;
+interface ExecutiveSummaryMetric {
+    label: string;
+    value: number | string;
+    /** Pre-formatted display value. When omitted, numeric `value` is locale-formatted via `formatLargeNumber`. */
+    displayValue?: string;
+    /** Optional delta (percent vs previous period). */
+    delta?: number;
+    /** Optional unit string appended to the value (e.g. ' %'). */
+    unit?: string;
+}
+interface ExecutiveSummarySectionProps extends ReportSectionShellProps {
+    /** Section title (e.g., "خلاصه اجرایی") */
+    title?: React$1.ReactNode;
+    description?: React$1.ReactNode;
+    /** AI / analyst-written paragraph (1–4 sentences). */
+    summary: React$1.ReactNode;
+    /** Up to 4 KPIs rendered as a row of tiles. */
+    metrics?: ExecutiveSummaryMetric[];
+    locale?: SupportedLocale;
+}
+declare const ExecutiveSummarySection: React$1.ForwardRefExoticComponent<ExecutiveSummarySectionProps & React$1.RefAttributes<HTMLDivElement>>;
+interface SentimentBreakdownSectionProps extends ReportSectionShellProps {
+    title?: React$1.ReactNode;
+    description?: React$1.ReactNode;
+    /** 3-class sentiment counts (auto-normalized). */
+    sentiment: SentimentData;
+    /** Optional 9-emotion breakdown rendered alongside. */
+    emotions?: Partial<Record<EmotionKey, number>>;
+    locale?: SupportedLocale;
+}
+declare const SentimentBreakdownSection: React$1.ForwardRefExoticComponent<SentimentBreakdownSectionProps & React$1.RefAttributes<HTMLDivElement>>;
+interface FlowDistributionSectionProps extends ReportSectionShellProps {
+    title?: React$1.ReactNode;
+    description?: React$1.ReactNode;
+    /** Political-flow counts (5 keys). */
+    flow: Partial<Record<FlowKey, number>>;
+    locale?: SupportedLocale;
+}
+declare const FlowDistributionSection: React$1.ForwardRefExoticComponent<FlowDistributionSectionProps & React$1.RefAttributes<HTMLDivElement>>;
+interface TopPostsSectionProps extends ReportSectionShellProps {
+    title?: React$1.ReactNode;
+    description?: React$1.ReactNode;
+    posts: PostData[];
+    /** Render only the first N posts. @default 5 */
+    topN?: number;
+    /** Density passed through to PostList. @default 'compact' */
+    density?: 'compact' | 'comfortable';
+    locale?: SupportedLocale;
+}
+declare const TopPostsSection: React$1.ForwardRefExoticComponent<TopPostsSectionProps & React$1.RefAttributes<HTMLDivElement>>;
+interface TimelineSectionProps extends ReportSectionShellProps {
+    title?: React$1.ReactNode;
+    description?: React$1.ReactNode;
+    /** Row-oriented timeline data: [{ name: '۱ فروردین', volume: 1240 }, …] */
+    data: Array<Record<string, string | number>>;
+    /** Series keys to plot. */
+    dataKeys: string[];
+    /** Pixel chart height. @default 240 */
+    chartHeight?: number;
+    /**
+     * Optional one-line summary of the trend, rendered as a sparkline + delta
+     * pair below the chart. Pass a single series name and a "from" / "to" pair
+     * to highlight the period delta.
+     */
+    summary?: {
+        seriesKey: string;
+        from: number;
+        to: number;
+    };
+    /** Custom axes (forwarded to PartoLineChart). */
+    axisLeft?: Record<string, unknown>;
+    axisBottom?: Record<string, unknown>;
+    locale?: SupportedLocale;
+}
+declare const TimelineSection: React$1.ForwardRefExoticComponent<TimelineSectionProps & React$1.RefAttributes<HTMLDivElement>>;
+interface SourceBreakdownEntry {
+    platform: SocialPlatform;
+    count: number;
+    /** Pre-computed share percent. When omitted, percent is computed across all entries. */
+    percent?: number;
+}
+interface SourceBreakdownSectionProps extends ReportSectionShellProps {
+    title?: React$1.ReactNode;
+    description?: React$1.ReactNode;
+    sources: SourceBreakdownEntry[];
+    locale?: SupportedLocale;
+}
+declare const SourceBreakdownSection: React$1.ForwardRefExoticComponent<SourceBreakdownSectionProps & React$1.RefAttributes<HTMLDivElement>>;
+
 declare const calloutVariants: (props?: ({
-    variant?: "info" | "success" | "warning" | "destructive" | "neutral" | null | undefined;
+    variant?: "neutral" | "warning" | "success" | "info" | "destructive" | 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. */
@@ -2961,169 +5002,6 @@ interface SectionNavigatorProps extends React$1.HTMLAttributes<HTMLElement> {
 }
 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;
-    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 const PartoBarChart: React$1.ForwardRefExoticComponent<PartoBarChartProps & React$1.RefAttributes<HTMLDivElement>>;
-
-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';
-    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 const PartoHeatMap: React$1.ForwardRefExoticComponent<PartoHeatMapProps & React$1.RefAttributes<HTMLDivElement>>;
-
 /**
  * PartoWordCloud — modern word cloud with smooth hover transitions,
  * glassmorphic tooltip, and brand-harmonious coloring.
@@ -3158,25 +5036,46 @@ declare namespace PartoWordCloud {
     var displayName: string;
 }
 
-interface PartoAreaChartProps {
-    /** Row-oriented data: [{ name: "فروردین", series1: 50, series2: 30 }] */
+/**
+ * PartoScatterChart — x/y scatter with optional bubble sizing (z) and
+ * per-point color override. Wraps Recharts ScatterChart with theme-aware
+ * styles, RTL-safe margins, and Persian number formatting.
+ *
+ * @example
+ * <PartoScatterChart
+ *   data={[
+ *     { x: 10, y: 30, z: 200, label: 'پیج A' },
+ *     { x: 40, y: 50, z: 120, label: 'پیج B' },
+ *   ]}
+ *   xKey="x" yKey="y" zKey="z" labelKey="label"
+ *   xLabel="تعامل (٪)" yLabel="رشد (٪)"
+ * />
+ */
+interface PartoScatterChartProps {
+    /** Row-oriented data. Each row contains x, y, and optional z (size) + label. */
     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;
+    /** Field name for X axis value */
+    xKey: string;
+    /** Field name for Y axis value */
+    yKey: string;
+    /** Optional field for bubble size (z). When provided, becomes a bubble chart. */
+    zKey?: string;
+    /** Optional field for per-point label (shown in tooltip). */
+    labelKey?: string;
+    /** Optional field for color classification (per-point). Values are mapped to palette. */
+    groupKey?: string;
+    /** Min/max bubble radius (px) when zKey is set. Default [40, 400]. */
+    zRange?: [number, number];
+    /** Axis range [min, max] for X @default 'dataMin'..'dataMax' */
+    xDomain?: [number | 'dataMin' | 'auto', number | 'dataMax' | 'auto'];
+    /** Axis range [min, max] for Y */
+    yDomain?: [number | 'dataMin' | 'auto', number | 'dataMax' | 'auto'];
+    /** Axis labels */
+    xLabel?: string;
+    yLabel?: string;
+    /** Unit suffix appended to tick labels (e.g., '٪') */
+    xUnit?: string;
+    yUnit?: string;
     /** Chart margins */
     margin?: {
         top?: number;
@@ -3184,37 +5083,51 @@ interface PartoAreaChartProps {
         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 */
+    /** Show grid @default true */
+    enableGrid?: boolean;
+    /** Series name for tooltip header @default 'Scatter' */
+    seriesName?: string;
+    /** Locale for digit formatting @default 'fa' */
+    locale?: SupportedLocale;
+    /** Custom tooltip formatter (name, value) */
     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>>;
+declare const PartoScatterChart: React$1.ForwardRefExoticComponent<PartoScatterChartProps & 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';
+/**
+ * PartoSankeyChart — flow visualization between nodes (source → target).
+ * Uses Recharts' Sankey primitive. Wraps for theme-aware colors, Persian
+ * number formatting, empty state, and a simpler API.
+ *
+ * @example
+ * <PartoSankeyChart
+ *   nodes={[{ name: 'ورودی' }, { name: 'فرآیند' }, { name: 'خروجی' }]}
+ *   links={[
+ *     { source: 0, target: 1, value: 50 },
+ *     { source: 1, target: 2, value: 50 },
+ *   ]}
+ * />
+ */
+interface SankeyNode {
+    /** Displayed label for the node. */
+    name: string;
+    /** Optional explicit color override (CSS color or `hsl(var(--token))`). */
+    color?: string;
+}
+interface SankeyLink {
+    /** Zero-based index of the source node in `nodes`. */
+    source: number;
+    /** Zero-based index of the target node in `nodes`. */
+    target: number;
+    /** Flow magnitude — drives link thickness. */
+    value: number;
+}
+interface PartoSankeyChartProps {
+    nodes: SankeyNode[];
+    links: SankeyLink[];
     /** Chart margins */
     margin?: {
         top?: number;
@@ -3222,13 +5135,180 @@ interface PartoRadarChartProps {
         bottom?: number;
         left?: number;
     };
-    /** Custom tooltip formatter */
-    tooltipFormatter?: (name: string, value: number) => React$1.ReactNode;
+    /** Horizontal gap between node columns in pixels */
+    nodePadding?: number;
+    /** Node rectangle width in pixels */
+    nodeWidth?: number;
+    /** Sort nodes alphabetically within a column @default false (preserve input order) */
+    iterations?: number;
+    /** Locale for digit formatting in tooltip @default 'fa' */
+    locale?: SupportedLocale;
+    /** Custom tooltip formatter (receives link.source/target names + value) */
+    tooltipFormatter?: (label: string, value: number) => React$1.ReactNode;
     className?: string;
     isLoading?: boolean;
     ariaLabel?: string;
 }
-declare const PartoRadarChart: React$1.ForwardRefExoticComponent<PartoRadarChartProps & React$1.RefAttributes<HTMLDivElement>>;
+declare const PartoSankeyChart: React$1.ForwardRefExoticComponent<PartoSankeyChartProps & React$1.RefAttributes<HTMLDivElement>>;
+
+/**
+ * ConceptPulseChart — افکارسنجی-flavored bubble chart where each data point
+ * is a "concept" rendered as a center dot surrounded by **composition arcs**.
+ * Built on Recharts ScatterChart but overrides the scatter shape with a
+ * custom SVG renderer that draws the central bubble + concentric pie arcs
+ * showing the composition breakdown (flow / emotion / sentiment).
+ *
+ * Heart-of-dashboard chart in the prototype — replaces a flat scatter when
+ * "what's this concept made of?" matters as much as where it sits.
+ *
+ * @example
+ * <ConceptPulseChart
+ *   data={[{
+ *     x: 30, y: 50, z: 200,
+ *     label: 'افزایش قیمت بنزین',
+ *     composition: { 'pro-gov': 20, 'internal-critic': 60, 'external-opponent': 20 },
+ *   }]}
+ *   compositionScale="flow"
+ * />
+ */
+type CompositionScale = 'flow' | 'emotion' | 'custom';
+type ConceptComposition = Partial<Record<string, number>>;
+interface ConceptPoint {
+    /** X coordinate. */
+    x: number;
+    /** Y coordinate. */
+    y: number;
+    /** Optional bubble size value (drives center radius). */
+    z?: number;
+    /** Concept label — shown in tooltip and aria. */
+    label: string;
+    /**
+     * Composition breakdown — keys must match the chosen `compositionScale`:
+     * - flow: 'pro-gov' | 'internal-critic' | 'internal-opponent' | 'external-opponent' | 'grey'
+     * - emotion: 'anger' | 'joy' | 'fear' | … (9 emotion keys)
+     * - custom: any keys, paired with `compositionTokens` prop
+     */
+    composition: ConceptComposition;
+}
+interface ConceptPulseChartProps {
+    data: ConceptPoint[];
+    /** Which token family the composition keys map to @default "flow" */
+    compositionScale?: CompositionScale;
+    /**
+     * For `compositionScale="custom"`, supply a key → CSS-color map
+     * (e.g., `{ a: 'hsl(var(--brand-default))', b: 'red' }`).
+     */
+    compositionTokens?: Record<string, string>;
+    /** Per-key labels for tooltip (custom scale only) */
+    compositionLabels?: Record<string, string>;
+    /** Optional bubble size range (px area) when z is provided @default [80, 600] */
+    zRange?: [number, number];
+    /** Center bubble radius when z is omitted @default 14 */
+    centerRadius?: number;
+    /** Outer arc radius offset (added to centerRadius) @default 8 */
+    arcThickness?: number;
+    /** Show concept label below the bubble @default false (use tooltip instead) */
+    showLabels?: boolean;
+    /** Axis configuration */
+    xLabel?: string;
+    yLabel?: string;
+    xUnit?: string;
+    yUnit?: string;
+    xDomain?: [number | 'dataMin' | 'auto', number | 'dataMax' | 'auto'];
+    yDomain?: [number | 'dataMin' | 'auto', number | 'dataMax' | 'auto'];
+    margin?: {
+        top?: number;
+        right?: number;
+        bottom?: number;
+        left?: number;
+    };
+    enableGrid?: boolean;
+    locale?: SupportedLocale;
+    className?: string;
+    isLoading?: boolean;
+    ariaLabel?: string;
+}
+declare const ConceptPulseChart: React$1.ForwardRefExoticComponent<ConceptPulseChartProps & React$1.RefAttributes<HTMLDivElement>>;
+
+/**
+ * PartoNetworkChart — force-directed node/link graph. Uses a lightweight
+ * custom force-simulation (no d3-force dep) — repulsion + link attraction +
+ * centering — to lay out nodes in a stable position inside the container.
+ *
+ * Consumers who want non-force layouts (circular, radial, manual x/y) can
+ * pass nodes with explicit `x`/`y` to skip the simulation.
+ */
+interface NetworkNode {
+    /** Unique id — used by links for source/target. */
+    id: string;
+    /** Displayed label. */
+    label?: string;
+    /** Optional numeric weight — drives node radius (larger = more important). */
+    weight?: number;
+    /** Category key — maps to a stable palette color. */
+    group?: string;
+    /** Fixed X (skip simulation for this node) */
+    fx?: number;
+    /** Fixed Y */
+    fy?: number;
+    /** Explicit color override */
+    color?: string;
+}
+interface NetworkLink {
+    /** Source node id. */
+    source: string;
+    /** Target node id. */
+    target: string;
+    /** Optional numeric weight — drives stroke width. */
+    value?: number;
+}
+interface PartoNetworkChartProps {
+    nodes: NetworkNode[];
+    links: NetworkLink[];
+    /** Base node radius in px @default 12 */
+    nodeRadius?: number;
+    /** Max node radius (when scaling by weight) @default 24 */
+    maxNodeRadius?: number;
+    /** Link base stroke width @default 1.5 */
+    linkStrokeWidth?: number;
+    /** Max link stroke width (when scaling by value) @default 6 */
+    maxLinkStrokeWidth?: number;
+    /** Number of simulation ticks @default 250 */
+    iterations?: number;
+    /** Show node labels @default true */
+    showLabels?: boolean;
+    /** Locale for labels + digits @default 'fa' */
+    locale?: SupportedLocale;
+    /** Tooltip formatter (node hover) */
+    nodeTooltip?: (node: NetworkNode) => React$1.ReactNode;
+    /** Callback when a node is clicked */
+    onNodeClick?: (node: NetworkNode) => void;
+    className?: string;
+    isLoading?: boolean;
+    ariaLabel?: string;
+}
+declare const PartoNetworkChart: React$1.ForwardRefExoticComponent<PartoNetworkChartProps & React$1.RefAttributes<HTMLDivElement>>;
+
+/**
+ * Chart-shaped empty state — a lightweight placeholder for charts with no data.
+ * Designed to be drop-in compatible with `PartoBarChart`, `PartoLineChart`, etc.
+ * Sits inside `ChartContainer` consumers, so it accepts the same wrapper
+ * `className` and fills 100% of the parent's bounds.
+ */
+type EmptyChartShape = 'bar' | 'line' | 'pie' | 'network' | 'generic';
+interface EmptyChartProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    /** Visual shape hint for the icon @default "generic" */
+    shape?: EmptyChartShape;
+    /** Primary message. Defaults to a locale-specific "no data" string. */
+    message?: React$1.ReactNode;
+    /** Secondary helper text below the message */
+    hint?: React$1.ReactNode;
+    /** Optional action (button, link) shown under the text */
+    action?: React$1.ReactNode;
+    /** Locale @default "fa" */
+    locale?: SupportedLocale;
+}
+declare const EmptyChart: React$1.ForwardRefExoticComponent<EmptyChartProps & React$1.RefAttributes<HTMLDivElement>>;
 
 type Direction = 'ltr' | 'rtl';
 declare function useDocumentDirection(): Direction;
@@ -3347,8 +5427,25 @@ interface ChartTooltipProps {
     label?: string;
     tooltipStyle: React$1.CSSProperties;
     formatter?: (name: string, value: number) => React$1.ReactNode;
+    /** Locale for the default value formatter. fa/ar render Persian/Arabic digits with thousands separators; en uses Latin. */
+    locale?: SupportedLocale;
 }
-declare function ChartTooltip({ active, payload, label, tooltipStyle, formatter }: ChartTooltipProps): react_jsx_runtime.JSX.Element | null;
+declare function ChartTooltip({ active, payload, label, tooltipStyle, formatter, locale }: ChartTooltipProps): react_jsx_runtime.JSX.Element | null;
+/**
+ * Default tickFormatter for numeric chart axes (Y axis on Line/Area/Bar, both
+ * axes on Scatter, radial on Radar). Renders Persian/Arabic digits + locale
+ * suffix ("۱.۵ هزار", "1.5K") for fa/ar, Latin K/M/B for en.
+ *
+ * Pass via `axisLeft={{ tickFormatter: localeAwareNumberTick('fa') }}`, or rely
+ * on the chart wrapper's `locale` prop which wires this in by default.
+ */
+declare function localeAwareNumberTick(locale: SupportedLocale): (value: unknown) => string;
+/**
+ * Default tickFormatter for categorical chart axes — converts embedded digits
+ * to the locale's numerals (e.g. "۱۴۰۳-۰۱" for "1403-01") without altering
+ * letters. Use on date/time axes whose labels carry digits.
+ */
+declare function localeAwareCategoryTick(locale: SupportedLocale): (value: unknown) => string;
 /**
  * Transforms Nivo line/area data format to Recharts row-oriented format.
  * Useful for consumers migrating from Nivo data shape.
@@ -3377,4 +5474,240 @@ declare function transformNivoLineData(nivoData: Array<{
  */
 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 };
+interface ShortcutsCheatsheetProps {
+    /** Controlled open state. If omitted, the cheatsheet manages its own open state. */
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    /**
+     * Global keyboard shortcut to toggle the cheatsheet. Default: `'shift+?'`.
+     * Pass `false` to disable the global listener (useful when wiring your own).
+     */
+    shortcut?: HotkeyCombo | false;
+    /** Trigger node — when set, the cheatsheet opens on click. Otherwise opening is controlled or via shortcut. */
+    trigger?: React$1.ReactNode;
+    /** Custom title (defaults to a localized "Keyboard shortcuts"). */
+    title?: React$1.ReactNode;
+    /** Custom description shown under the title. */
+    description?: React$1.ReactNode;
+    /** Locale for default strings + sort tie-breaks. */
+    locale?: SupportedLocale;
+    /** Override which entries to show. Defaults to the active provider's full registry. */
+    hotkeys?: RegisteredHotkey[];
+    /** Optional empty-state customization when the registry is empty. */
+    emptyState?: React$1.ReactNode;
+    className?: string;
+}
+/**
+ * Visual help overlay that lists every hotkey registered with the active
+ * `<HotkeyProvider>`. Opens on `Shift+?` by default (configurable) or via a
+ * trigger button. Renders nothing useful outside a HotkeyProvider — the
+ * registry is empty and the empty state shows.
+ *
+ * @example
+ *   <HotkeyProvider>
+ *     <ShortcutsCheatsheet />
+ *     <App />  // descendants register via useHotkey()
+ *   </HotkeyProvider>
+ *
+ * Pair with `useHotkey('?', 'shift+?', () => setOpen(true))` if you prefer
+ * to wire the toggle yourself; the built-in shortcut is just a convenience.
+ */
+declare const ShortcutsCheatsheet: React$1.ForwardRefExoticComponent<ShortcutsCheatsheetProps & React$1.RefAttributes<HTMLDivElement>>;
+
+/**
+ * Fires `handler` whenever a pointer event lands outside the referenced
+ * element. Use for closing dropdowns, popovers, dismissable cards, etc.
+ *
+ * @example
+ * const ref = useRef<HTMLDivElement>(null)
+ * useOutsideClick(ref, () => setOpen(false), { when: open })
+ *
+ * @param ref - Ref to the inside element. Clicks inside (or on descendants) are ignored.
+ * @param handler - Called when an outside click is detected.
+ * @param options.when - When false, the listener is detached (avoid stale closures).
+ * @param options.events - Which events to listen for. Default: ['mousedown', 'touchstart'].
+ *   Using 'mousedown' (instead of 'click') closes the menu before any click handler
+ *   inside fires — matches Radix/Headless UI behaviour.
+ */
+declare function useOutsideClick<T extends HTMLElement = HTMLElement>(ref: React$1.RefObject<T | null>, handler: (event: MouseEvent | TouchEvent) => void, options?: {
+    when?: boolean;
+    events?: Array<'mousedown' | 'mouseup' | 'click' | 'touchstart' | 'touchend'>;
+}): void;
+
+/**
+ * Subscribes to a CSS media query and returns its current match state.
+ * SSR-safe: returns `undefined` on the server and on the initial client
+ * render (consumers must handle the `undefined` case).
+ *
+ * @example
+ * const isLarge = useMediaQuery('(min-width: 1024px)')
+ * if (isLarge) ...  // narrow to true|false
+ *
+ * @example presets
+ * const prefersDark = useMediaQuery('(prefers-color-scheme: dark)')
+ * const reducedMotion = useMediaQuery('(prefers-reduced-motion: reduce)')
+ */
+declare function useMediaQuery(query: string): boolean | undefined;
+/** Common breakpoint helper. Returns `undefined` until hydrated. */
+declare function useBreakpoint(breakpoint: 'sm' | 'md' | 'lg' | 'xl' | '2xl'): boolean | undefined;
+
+interface UseClipboardOptions {
+    /** Reset `copied` back to false after this many ms. @default 2000 */
+    resetAfter?: number | false;
+}
+interface UseClipboardReturn {
+    /** True for `resetAfter` ms after a successful copy. */
+    copied: boolean;
+    /** True if the last copy attempt threw. */
+    error: Error | null;
+    /**
+     * Copy a string to clipboard. Returns a promise that resolves to `true` on
+     * success, `false` if the API isn't available, and rejects on permission
+     * denial (caught and exposed via `error`).
+     */
+    copy: (value: string) => Promise<boolean>;
+    /** Manually reset `copied` and `error` state. */
+    reset: () => void;
+}
+/**
+ * useClipboard — copy text to the system clipboard with a transient `copied`
+ * flag suitable for "Copied!" affordances. Uses the modern Clipboard API
+ * with a `document.execCommand('copy')` fallback for older browsers.
+ *
+ * @example
+ * const { copied, copy } = useClipboard()
+ * <button onClick={() => copy('hello')}>{copied ? 'کپی شد' : 'کپی'}</button>
+ */
+declare function useClipboard(options?: UseClipboardOptions): UseClipboardReturn;
+
+/**
+ * Returns the value from the previous render. Useful for diffing props,
+ * detecting transitions, and triggering effects on specific value changes.
+ *
+ * @example
+ * const prevId = usePrevious(currentId)
+ * useEffect(() => {
+ *   if (prevId !== currentId) trackNavigation(prevId, currentId)
+ * }, [prevId, currentId])
+ *
+ * @returns `undefined` on first render, then the value from the previous render.
+ */
+declare function usePrevious<T>(value: T): T | undefined;
+
+/**
+ * Lightweight async-state hook for one-shot fetches without bringing in
+ * TanStack Query. Tracks loading / data / error and exposes a stable
+ * `run` function plus a `reset`. For request deduplication, caching,
+ * retry, mutation, optimistic updates, etc. **prefer TanStack Query** —
+ * this hook intentionally stays tiny.
+ *
+ * @example
+ * const { data, error, status, run } = useAsync<User>()
+ * useEffect(() => { run(() => fetch(`/api/users/${id}`).then(r => r.json())) }, [id, run])
+ * if (status === 'loading') return <Skeleton />
+ * if (status === 'error') return <ErrorState onRetry={run} />
+ * return <UserCard user={data!} />
+ */
+type AsyncStatus = 'idle' | 'loading' | 'success' | 'error';
+interface UseAsyncReturn<T> {
+    data: T | null;
+    error: unknown;
+    status: AsyncStatus;
+    isIdle: boolean;
+    isLoading: boolean;
+    isSuccess: boolean;
+    isError: boolean;
+    /** Run an async operation. Cancels the previous in-flight result. */
+    run: (operation: () => Promise<T>) => Promise<T | undefined>;
+    reset: () => void;
+}
+declare function useAsync<T = unknown>(initialData?: T | null): UseAsyncReturn<T>;
+
+interface UseFilterParamsOptions<T extends FilterStateShape> {
+    /**
+     * Convert a state object into a flat map of URL params. Return null/undefined
+     * for entries you want to omit (e.g. defaults, empty arrays, null fields).
+     */
+    serialize: (state: T) => Record<string, string | undefined | null>;
+    /**
+     * Parse the current URL params back into a partial state. Called once on
+     * mount to hydrate the FilterProvider, and on browser navigation events.
+     */
+    parse: (params: URLSearchParams) => Partial<T>;
+    /**
+     * Debounce window (ms) before pushing serialized state to the URL.
+     * @default 200
+     */
+    debounceMs?: number;
+    /**
+     * Use `history.pushState` instead of `replaceState`. Default replace
+     * keeps the back button useful for actual page navigation rather than
+     * filter tweaks.
+     * @default 'replace'
+     */
+    history?: 'push' | 'replace';
+    /** Disable the hook (e.g. while a parent is loading server-side data). */
+    disabled?: boolean;
+}
+declare function normalizeUrlDigits(input: string): string;
+/**
+ * Two-way bind a `<FilterProvider>`'s state with `URLSearchParams`.
+ *
+ * - On mount, parses `window.location.search` and merges it onto the
+ *   provider's initial state via `patch`.
+ * - On state change, runs `serialize` and writes the result to the URL
+ *   (debounced 200ms, replaceState by default).
+ * - Persian/Arabic digits in incoming params are normalized to Latin.
+ *
+ * SSR-safe — does nothing on the server. Must be used inside a
+ * `<FilterProvider>`. Throws otherwise to surface wiring mistakes early.
+ */
+declare function useFilterParams<T extends FilterStateShape>(options: UseFilterParamsOptions<T>): void;
+
+interface FilterPreset<T extends FilterStateShape = FilterStateShape> {
+    /** Stable, locally-unique id (slug or random). */
+    id: string;
+    /** User-visible name. */
+    name: string;
+    /** Snapshot of the filter state. */
+    state: T;
+    /** Unix timestamp (ms) of creation. */
+    createdAt: number;
+    /** Unix timestamp (ms) of the most recent rename / overwrite. */
+    updatedAt: number;
+}
+interface UseFilterPresetsOptions {
+    /** localStorage namespace (must be unique per app section). */
+    storageKey: string;
+    /** Soft cap on total presets retained. Oldest is dropped on overflow. @default 20 */
+    maxPresets?: number;
+}
+interface UseFilterPresetsReturn<T extends FilterStateShape> {
+    /** Sorted list (newest first by `updatedAt`). */
+    presets: FilterPreset<T>[];
+    /** Save the FilterProvider's current state under a name. Returns the new preset's id. */
+    save: (name: string) => string;
+    /** Apply a preset's state to the FilterProvider via `set`. */
+    load: (id: string) => boolean;
+    /** Remove a preset. */
+    remove: (id: string) => void;
+    /** Update a preset's name. */
+    rename: (id: string, name: string) => boolean;
+    /** Overwrite a preset with the current state. */
+    overwrite: (id: string) => boolean;
+    /** Clear ALL presets in this namespace. */
+    clear: () => void;
+}
+/**
+ * Save / load / rename / delete named presets of a `<FilterProvider>`'s
+ * state in localStorage.
+ *
+ * Storage shape: `localStorage[storageKey] = JSON.stringify(FilterPreset[])`.
+ * Presets are sorted newest-first by `updatedAt`. Soft-capped at `maxPresets`
+ * (default 20) — oldest is dropped on overflow at save time.
+ *
+ * SSR-safe: returns an empty list on the server, hydrates on first effect.
+ */
+declare function useFilterPresets<T extends FilterStateShape>(options: UseFilterPresetsOptions): UseFilterPresetsReturn<T>;
+
+export { ACTION_TYPE_META, Accordion, AccordionContent, AccordionItem, AccordionTrigger, ActionStatusKey, ActionTimeline, type ActionTimelineDensity, type ActionTimelineGroupBy, ActionTimelineItem, type ActionTimelineItemData, type ActionTimelineItemProps, type ActionTimelineProps, ActionTypeChip, type ActionTypeChipProps, ActionTypeKey, ActiveFiltersBar, type ActiveFiltersBarProps, ActiveFiltersClearAll, type ActiveFiltersClearAllProps, Alert, AlertDescription, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, AlertTitle, AnimatedNumber, type AnimatedNumberProps, AppBar, type AppBarProps, AppLayout, AppLayoutContent, AspectRatio, type AsyncStatus, Autocomplete, type AutocompleteItem, type AutocompleteProps, AvatarGroup, type AvatarGroupItem, type AvatarGroupProps, AvatarTextSkeleton, type AvatarTextSkeletonProps, Banner, type BannerProps, type BenchmarkMarker, type BenchmarkTier, Breadcrumb, BreadcrumbEllipsis, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator, BulletinViewer, type BulletinViewerProps, Button, ButtonGroup, ButtonGroupSeparator, ButtonGroupText, ButtonProps, CHART_FONT_FAMILY, COUNTRIES, CRITERION_TIER_KEYS, Callout, CalloutDescription, type CalloutProps, CalloutTitle, CardSkeleton, type CardSkeletonProps, 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, CommandPalette, type CommandPaletteItem, type CommandPaletteProps, type CommandPaletteRecentsConfig, CommandSeparator, CommandShortcut, CommentCard, type CommentCardProps, type CommentTag, ComparisonCard, type ComparisonCardProps, type ComparisonEntity, type ComparisonMetric, ComparisonRadar, type ComparisonRadarProps, type ComparisonWinner, type CompositionScale, type ConceptComposition, type ConceptPoint, ConceptPulseChart, type ConceptPulseChartProps, ConfirmDialog, type ConfirmDialogProps, ContextMenu, ContextMenuCheckboxItem, ContextMenuContent, ContextMenuGroup, ContextMenuItem, ContextMenuLabel, ContextMenuPortal, ContextMenuRadioGroup, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuShortcut, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger, CopyButton, type CopyButtonProps, type Country, type CountryCode, CountryPicker, type CountryPickerProps, type CriterionInputSpec, CriterionScoreCard, type CriterionScoreCardProps, type CriterionTierKey, type CriterionTierThresholds, type CriterionTrend, DEFAULT_CRITERION_THRESHOLDS, DEFAULT_PERIODS, DEFAULT_THRESHOLDS, DataTableColumn, DataTableColumnVisibility, DataTableColumnVisibilityToggle, type DataTableColumnVisibilityToggleProps, DataTableExportButton, type DataTableExportButtonProps, DatePicker, type DatePickerProps, DateRangePicker, DateRangePickerInline, type DateRangePickerProps, Dialog, 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, EmotionBadge, type EmotionBadgeProps, type EmotionData, EmotionDistribution, type EmotionDistributionProps, EmotionKey, Empty, EmptyAction, EmptyChart, type EmptyChartProps, type EmptyChartShape, EmptyDescription, EmptyIcon, EmptyTitle, type EngagementRange, type EngagementRangeWithDisplay, EngagementRate, EngagementRateBar, type EngagementRateBarProps, EngagementRateBenchmark, type EngagementRateBenchmarkProps, type EngagementRateProps, type EngagementTier, EntityHealthCard, EntityHealthCardActions, EntityHealthCardFooter, EntityHealthCardHeader, EntityHealthCardHeaderEnd, EntityHealthCardHeaderText, EntityHealthCardMeta, EntityHealthCardMetric, type EntityHealthCardMetricProps, EntityHealthCardMetrics, type EntityHealthCardMetricsProps, EntityHealthCardNarrative, EntityHealthCardPhase, type EntityHealthCardPhaseProps, type EntityHealthCardProps, EntityHealthCardScore, type EntityHealthCardScoreProps, EntityHealthCardSeverityBadge, type EntityHealthCardSeverityBadgeProps, EntityHealthCardSubtitle, EntityHealthCardTitle, type EntityHealthCardTitleProps, EntityHealthCardTrust, type EntityHealthCardTrustProps, EntityHealthKey, ErrorBoundary, type ErrorBoundaryProps, ErrorIllustration, ErrorState, type ErrorStateProps, type ExecutiveSummaryMetric, ExecutiveSummarySection, type ExecutiveSummarySectionProps, type ExportableColumn, type ExtendedPlatform, 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, FilterPanel, FilterPanelBody, FilterPanelClearAll, type FilterPanelClearAllProps, FilterPanelFooter, FilterPanelHeader, type FilterPanelProps, FilterPanelTitle, type FilterPanelTitleProps, FilterPanelTrigger, type FilterPanelTriggerProps, type FilterPreset, FilterSection, type FilterSectionProps, FilterStateShape, FirstRunIllustration, FlowBadge, type FlowBadgeProps, FlowCell, type FlowCellProps, FlowData, FlowDistributionSection, type FlowDistributionSectionProps, FlowKey, type FollowerGroup, ForbiddenIllustration, Form, FormControl, FormDescription, FormField, FormItem, FormLabel, FormMessage, FormRowSkeleton, type FormRowSkeletonProps, GROUP_LABELS, HashtagInput, type TagInputProps as HashtagInputProps, type HashtagPerformanceData, HashtagPerformanceRow, type HashtagPerformanceRowProps, type HeatMapDatum, type HeatMapRow, HotkeyCombo, HoverCard, HoverCardContent, HoverCardTrigger, IRAN_PROVINCES, type Icon, Icons, Input, InputGroup, InputGroupAddon, InputGroupButton, InputGroupInput, InputGroupText, InputGroupTextarea, InputOTP, InputOTPGroup, InputOTPSeparator, InputOTPSlot, InputProps, InputVariants, InputWithIcon, type InputWithIconProps, type IranProvince, type IranProvinceSlug, JobCard, JobCardActions, JobCardError, JobCardHeader, JobCardHeaderActions, JobCardHeaderText, JobCardMeta, JobCardMetaItem, type JobCardMetaItemProps, JobCardProgress, type JobCardProgressProps, type JobCardProps, JobCardStat, type JobCardStatProps, JobCardStats, type JobCardStatsProps, JobCardStatusBadge, type JobCardStatusBadgeProps, JobCardSubtitle, JobCardThumbnail, type JobCardThumbnailProps, JobCardTitle, type JobCardTitleProps, JobStatusKey, JobWizard, type JobWizardApi, JobWizardBack, type JobWizardBackProps, JobWizardBody, JobWizardCancel, type JobWizardCancelProps, JobWizardError, JobWizardFooter, JobWizardHeader, type JobWizardHeaderProps, JobWizardNext, type JobWizardNextProps, type JobWizardProps, JobWizardSkip, type JobWizardSkipProps, JobWizardSpacer, type JobWizardStep, JobWizardStepper, type JobWizardStepperProps, type JobWizardSubmitState, JobWizardSuccess, type JobWizardSuccessProps, type JobWizardValidationResult, Kbd, KbdGroup, Label, LabelChip, type LabelChipProps, LabelEditDialog, type LabelEditDialogProps, type LegacySize, MarkdownRenderer, type MarkdownRendererProps, 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, type MultiPlatformMetrics, MultiPlatformPostCard, type MultiPlatformPostCardProps, type MultiPlatformPostData, MultiSelect, type MultiSelectOption, type MultiSelectProps, NativeSelect, NativeSelectOptGroup, NativeSelectOption, NavGroup, type NavGroupProps, NavItem, type NavItemBaseProps, type NavItemProps, type NavMatchStrategy, NavPanel, NavPanelContent, NavPanelFooter, NavPanelHeader, NavRail, NavRailContent, NavRailFooter, NavRailHeader, NavRailItem, NavRailProvider, NavRailSeparator, NavRailTrigger, NavSeparator, NavTree, type NavTreeContextValue, NavTreeProvider, type NavTreeProviderProps, NavigationMenu, NavigationMenuContent, NavigationMenuIndicator, NavigationMenuItem, NavigationMenuLink, NavigationMenuList, NavigationMenuTrigger, NavigationMenuViewport, type NetworkLink, type NetworkNode, NoDataIllustration, NoResultsIllustration, NotificationCenter, type NotificationCenterProps, type NotificationFilter, type NotificationItem, type NotificationSeverity, NumberInputLocale, type NumberInputLocaleProps, 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, PartoHeatMap, type PartoHeatMapProps, PartoNetworkChart, type PartoNetworkChartProps, PartoRadarChart, type PartoRadarChartProps, PartoSankeyChart, type PartoSankeyChartProps, PartoScatterChart, type PartoScatterChartProps, type PartoToasterProps, PartoWordCloud, type PartoWordCloudProps, type PeriodOption, PeriodSelector, type PeriodSelectorProps, type PlatformMetadata, type PostAction, PostActions, type PostActionsProps, type PostAiAnalysis, type PostAiEntity, type PostAuthor, PostBody, type PostBodyData, type PostBodyProps, PostCard, type PostCardProps, type PostComment, type PostCommentAuthor, type PostData, type PostDensity, type PostDetails, PostDetailsModal, type PostDetailsModalProps, type PostDetailsTab, type PostEmotion, type PostEnrichmentFlags, PostHeader, type PostHeaderProps, type PostIntent, PostList, type PostListProps, type PostMediaItem, PostMetadata, type PostMetadataProps, type PostMetrics, type PostPlatform, type PostSentiment, type PostingFrequencyCell, PostingFrequencyHeatmap, type PostingFrequencyHeatmapProps, type PostingFrequencySummary, type PostingWeekStart, ProfileCard, type ProfileCardProps, ProfileInfo, type ProfileInfoProps, Progress, ProgressCell, type ProgressCellProps, type ProgressProps, type QuotaLevel, QuotaProgressBar, type QuotaProgressBarProps, type QuotaThresholds, RadioCardDescription, RadioCardItem, RadioCardTitle, RadioCards, RadioGroup, RadioGroupItem, RateLimitBanner, type RateLimitBannerProps, RegionPicker, type RegionPickerKey, type RegionPickerProps, RegisteredHotkey, ReportComposer, type ReportComposerProps, ReportSection, type ReportSectionProps, ResizableHandle, ResizablePanel, ResizablePanelGroup, RouteProgress, type RouteProgressHandle, type RouteProgressProps, SONNER_DEFAULT_DURATION, SafeImage, type SafeImageProps, type SankeyLink, type SankeyNode, ScrollArea, ScrollBar, SearchInput, type SearchInputProps, type SectionItem, SectionNavigator, type SectionNavigatorProps, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectTriggerVariants, SelectValue, SentimentBadge, type SentimentBadgeProps, SentimentBreakdownSection, type SentimentBreakdownSectionProps, SentimentCell, type SentimentCellProps, SentimentData, Separator, SeverityBadge, type SeverityBadgeProps, SeverityKey, ShortcutsCheatsheet, type ShortcutsCheatsheetProps, Sidebar, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupAction, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInput, SidebarInset, SidebarMenu, SidebarMenuAction, SidebarMenuBadge, SidebarMenuButton, SidebarMenuItem, SidebarMenuSkeleton, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubItem, SidebarProvider, SidebarRail, SidebarSeparator, SidebarTrigger, SiteHeader, SiteHeaderActions, SiteHeaderEnd, type SiteHeaderProps, SiteHeaderSeparator, SiteHeaderStart, SiteHeaderSubtitle, SiteHeaderTitle, SiteHeaderTitleGroup, type SizeWithLegacy, Skeleton, type SkeletonProps, Slider, SocialPlatform, type SourceBreakdownEntry, SourceBreakdownSection, type SourceBreakdownSectionProps, SparklineCell, type SparklineCellProps, Spinner, type SpinnerProps, StageStatusKey, type StandardSize, StatDeltaCell, type StatDeltaCellProps, StatDisplay, type StatDisplayProps, StatusBadge, type StatusBadgeProps, StatusFlow, type StatusFlowOrientation, type StatusFlowProps, type StatusFlowSize, StatusFlowStage, type StatusFlowStageData, type StatusFlowStageProps, StatusKey, StatusPulseCell, type StatusPulseCellProps, Step, type StepProps, Stepper, type StepperProps, SupportedLocale, Switch, type SwitchProps, TIER_LABELS, Table, TableBody, TableCaption, TableCell, TableComparisonView, type TableComparisonViewProps, TableFooter, TableHead, TableHeader, TableRow, TableRowSkeleton, type TableRowSkeletonProps, TableSkeleton, type TableSkeletonProps, TableSortHeader, Tabs, TabsContent, TabsList, TabsTrigger, TagInput, type TagInputProps, TaskList, type TaskListGroup, type TaskListProps, Textarea, TimelineSection, type TimelineSectionProps, Toaster, Toggle, ToggleGroup, ToggleGroupItem, TooltipContent, TopPostsSection, type TopPostsSectionProps, TrendCell, type TrendCellProps, TrendIndicator, type TrendIndicatorProps, type UseAsyncReturn, type UseClipboardOptions, type UseClipboardReturn, type UseFilterParamsOptions, type UseFilterPresetsOptions, type UseFilterPresetsReturn, type UseInfiniteScrollOptions, type UseInfiniteScrollReturn, type UseJobWizardOptions, UserAutocomplete, type UserAutocompleteProps, type UserItem, UserMenu, type UserMenuItem, type UserMenuProps, type UserMenuUser, type ViewMode, ViewToggle, type ViewToggleProps, type WordData, actionTypeChipVariants, appBarVariants, avatarGroupVariants, bannerVariants, buildCsv, buildPostingFrequencyRows, buildTsv, buttonGroupVariants, calloutVariants, computeComparisonWinners, countComparisonWins, countryFlag, defaultActions as defaultPostActions, downloadFile, findCountry, findProvince, findTierIndex, formatJalaliDate, formatPersianDateRange, getCountryLabel, getCriterionTier, getCurrentRangeIndex, getEngagementRanges, getEngagementRateBenchmarkTiers, getFollowerGroup, getPersianDay, getPersianMonth, getPersianMonthName, getPersianMonthNameShort, getPersianMonthsForDropdown, getPersianWeekdayName, getPersianYear, getPersianYearsForDropdown, getProvinceLabel, getScoreBenchmarkTiers, tagInputVariants as hashtagInputVariants, jalaliToGregorian, labelChipVariants, localeAwareCategoryTick, localeAwareNumberTick, navItemVariants, navigationMenuTriggerStyle, normalizeSize, normalizeUrlDigits, pageLoaderVariants, postCardVariants, postHeaderVariants, profileCardVariants, resolveLevel, siteHeaderVariants, spinnerVariants, statDisplayVariants, tagInputVariants, toEnglishDigits, toPersianDigits, toggleVariants, transformNivoLineData, useAsync, useBreakpoint, useChartTheme, useClipboard, useDebounce, useDocumentDirection, useFilterParams, useFilterPresets, useFormField, useInfiniteScroll, useIsMobile, useJobWizard, useJobWizardState, useLocalStorage, useMediaQuery, useNavRail, useNavTree, useOutsideClick, usePrevious, useRootStyles, useScrollLock, useSidebar };