@parto-system-design/ui 1.1.5 → 1.1.7

package/dist/index.d.cts

@@ -1,4 +1,7 @@
-import { ClassValue } from 'clsx';
+import { S as SupportedLocale } from './utils-DlXWmDZ-.cjs';
+export { c as cn, a as convertToLocalNumbers, e as formatAbsoluteTime, f as formatLargeNumber, b as formatNumber, d as formatRelativeTime } from './utils-DlXWmDZ-.cjs';
+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-CAd9wGOr.cjs';
+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-CAd9wGOr.cjs';
 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.cjs';
 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.cjs';
+export { Badge, BadgeProps, badgeVariants } from './components/ui/badge.cjs';
+import { Button, ButtonProps } from './components/ui/button.cjs';
+export { ButtonVariantProps, LoadingVariantProps, buttonVariants } from './components/ui/button.cjs';
+import { Separator } from './components/ui/separator.cjs';
+export { Calendar, CalendarProps } from './components/ui/calendar.cjs';
+export { Card, CardContent, CardDescription, CardFooter, CardHeader, CardProps, CardTitle, cardVariants } from './components/ui/card.cjs';
 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.cjs';
+export { DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger } from './components/ui/dialog.cjs';
+import { HotkeyCombo } from './hooks/use-hotkeys.cjs';
+export { UseHotkeysOptions, formatHotkey, useHotkeys } from './hooks/use-hotkeys.cjs';
 import * as ContextMenuPrimitive from '@radix-ui/react-context-menu';
+import { S as SentimentData, F as FlowData } from './concept-card-RwPbqJ06.cjs';
+export { C as ConceptCard, a as ConceptCardProps, b as FlowDistribution, c as FlowDistributionProps, d as SentimentDistribution, e as SentimentDistributionProps } from './concept-card-RwPbqJ06.cjs';
+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.cjs';
+export { FilterContextValue, FilterProvider, FilterProviderProps, useFilterState, useFilterStateOptional } from './components/ui/filter-provider.cjs';
 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.cjs';
+export { inputVariants } from './components/ui/input.cjs';
+export { IranProvinceCell, IranProvinceHeat, IranProvinceHeatProps, IranProvinceHeatScale } from './components/ui/iran-province-heat.cjs';
 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-DOl50DqJ.cjs';
+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-DOl50DqJ.cjs';
+export { Popover, PopoverAnchor, PopoverContent, PopoverTrigger } from './components/ui/popover.cjs';
 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.cjs';
+import { TooltipContent } from './components/ui/tooltip.cjs';
+export { Tooltip, TooltipProvider, TooltipTrigger } from './components/ui/tooltip.cjs';
+export { Sparkline, SparklineProps, SparklineTrend, SparklineVariant } from './components/ui/sparkline.cjs';
 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.cjs';
+export { DataTable, DataTableExpansion, DataTableMultiSort, DataTablePagination, DataTableProps, DataTableSelection, DataTableSort, SortDirection, SortRule } from './components/ui/data-table.cjs';
+export { SavedQueryCard, SavedQueryCardProps, SavedQueryFilter } from './components/ui/saved-query-card.cjs';
+export { PartoLineChart, PartoLineChartProps } from './components/charts/PartoLineChart.cjs';
+export { PartoBarChart, PartoBarChartProps } from './components/charts/PartoBarChart.cjs';
+export { PartoPieChart, PartoPieChartProps } from './components/charts/PartoPieChart.cjs';
+export { PartoAreaChart, PartoAreaChartProps } from './components/charts/PartoAreaChart.cjs';
+import { RegisteredHotkey } from './hooks/use-hotkey-registry.cjs';
+export { HotkeyProvider, HotkeyProviderProps, useHotkey, useHotkeyRegistry } from './hooks/use-hotkey-registry.cjs';
+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,346 +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.
- */
-declare const engagementUiTranslations: Record<SupportedLocale, {
-    yourCategory: string;
-    influencer: string;
-    followers: string;
-    over: string;
-    to: string;
-    and: string;
-    lessThan: string;
-    you: string;
-    criteria: string;
-}>;
-/**
- * Sentiment label translations used by the SentimentBadge component.
- */
-declare const sentimentLabels: Record<SupportedLocale, {
-    positive: string;
-    negative: string;
-    neutral: string;
-    mixed: string;
-}>;
-/**
- * Canonical emotion keys — 9-class advanced sentiment scale used in افکارسنجی
- * deep analysis. Coexists with the simple 3-class `Sentiment` above; they are
- * NOT interchangeable. Choose the scale based on view density.
- */
-type EmotionKey = 'anger' | 'anticipation' | 'joy' | 'trust' | 'fear' | 'surprise' | 'sadness' | 'disgust' | 'neutral';
-declare const EMOTION_KEYS: readonly EmotionKey[];
-/** Emotion label translations used by EmotionBadge / EmotionDistribution. */
-declare const emotionLabels: Record<SupportedLocale, Record<EmotionKey, string>>;
-/**
- * Political flow keys — 5-class classification used in افکارسنجی clustering.
- * A concept / post / page belongs to exactly one flow (primary) but usually
- * also has secondary flow composition expressed as percentages.
- */
-type FlowKey = 'pro-gov' | 'internal-critic' | 'internal-opponent' | 'external-opponent' | 'grey';
-declare const FLOW_KEYS: readonly FlowKey[];
-declare const flowLabels: Record<SupportedLocale, Record<FlowKey, string>>;
-/** Operational status — visual state of a tracked entity. */
-type StatusKey = 'critical' | 'warning' | 'normal';
-declare const statusLabels: Record<SupportedLocale, Record<StatusKey, string>>;
-/** Severity — urgency level. Independent from status. */
-type SeverityKey = 'urgent' | 'high' | 'medium' | 'low';
-declare const severityLabels: Record<SupportedLocale, Record<SeverityKey, string>>;
-/**
- * Job lifecycle — canonical states for async work (analyses, campaigns,
- * evaluation runs, imports, exports, report generation).
- *
- * Terminal states: completed / failed / cancelled.
- * Active states: queued / running / paused.
- */
-type JobStatusKey = 'queued' | 'running' | 'paused' | 'completed' | 'failed' | 'cancelled';
-declare const JOB_STATUS_KEYS: readonly JobStatusKey[];
-declare const jobStatusLabels: Record<SupportedLocale, Record<JobStatusKey, string>>;
-/** True iff a job is still active (not in a terminal state). */
-declare function isActiveJobStatus(s: JobStatusKey): boolean;
-/**
- * Action status — discrete outcome for a single completed (or in-flight)
- * action in an activity feed / audit timeline. Distinct from the richer
- * job/stage lifecycles above: each event is atomic, so no "paused" here.
- */
-type ActionStatusKey = 'success' | 'failed' | 'pending' | 'warning' | 'info';
-declare const ACTION_STATUS_KEYS: readonly ActionStatusKey[];
-declare const actionStatusLabels: Record<SupportedLocale, Record<ActionStatusKey, string>>;
-/**
- * Locale-aware relative time label producer. Used by ActionTimeline and any
- * other component that wants trilingual "n minutes ago" strings. For absolute
- * formatting see `formatAbsoluteTime`/`formatJalaliDate` in lib/utils.ts.
- */
-declare function formatRelativeLocaleTime(date: Date | string | number, locale: SupportedLocale): string;
-/**
- * Locale-aware "time remaining" label — forward-looking companion to
- * `formatRelativeLocaleTime`. Used by RateLimitBanner and any countdown UI.
- *
- * Input can be a Date, ISO string, or epoch ms. Past/zero remaining returns
- * the locale-specific "now" / "any moment" marker.
- */
-declare function formatTimeRemaining(target: Date | string | number, locale: SupportedLocale): string;
 /**
- * Stage status — for multi-stage pipeline visualizations (StatusFlow).
+ * Iran's 31 provinces with trilingual labels and ISO 3166-2 codes.
  *
- * Distinct from `JobStatusKey`: a job has ONE status; a pipeline of stages has
- * a status PER stage. A `running` stage means that stage is currently active;
- * a `warning` stage completed but with caveats; `skipped` means it was bypassed.
- */
-type StageStatusKey = 'pending' | 'running' | 'completed' | 'failed' | 'skipped' | 'warning' | 'paused';
-declare const STAGE_STATUS_KEYS: readonly StageStatusKey[];
-declare const stageStatusLabels: Record<SupportedLocale, Record<StageStatusKey, string>>;
-/**
- * Action type — canonical set of social-media actions a worker/user can
- * execute. Maps 1:1 to a CSS token family (`--action-type-*`) so each action
- * has a distinct recognizable colour + icon across activity feeds, audit
- * timelines, and rate-limit dashboards.
+ * 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.
  *
- * The 7 canonical keys cover current افکارسنجی + Booster + future SRR use:
- * - `like` / `comment` / `save` / `follow` / `unfollow` — Booster OPERATION_TYPES
- * - `dm` — direct message (future bulk-DM, notification replies)
- * - `share` — cross-post / retweet (future multi-platform)
+ * 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.
  */
-type ActionTypeKey = 'like' | 'comment' | 'save' | 'follow' | 'unfollow' | 'dm' | 'share';
-declare const ACTION_TYPE_KEYS: readonly ActionTypeKey[];
-declare const actionTypeLabels: Record<SupportedLocale, Record<ActionTypeKey, 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;
 /**
- * Short-form verb labels for past-tense activity phrasing ("worker X پسندید Y").
- * When composing "subject action object" sentences in ActivityFeed / ActionTimeline,
- * prefer these over `actionTypeLabels` which are noun-form.
+ * 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 actionTypeVerbs: Record<SupportedLocale, Record<ActionTypeKey, string>>;
+declare function getProvinceLabel(codeOrSlug: string, locale?: SupportedLocale): string;
+
 /**
- * Entity health — 6-tier severity narrative for long-lived entities like
- * workers, tracked pages, data sources, monitored feeds. Ordered most-critical
- * to most-positive so components can sort "worst first" deterministically.
+ * Curated country list with trilingual labels + flag emoji.
  *
- * `banned` — entity is permanently disabled / blocked upstream.
- * `pending` — not yet evaluated (new, awaiting verification, in setup).
- * `at-risk` — immediate intervention needed (failed checks, violations).
- * `warning` — degrading signals, needs monitoring.
- * `growing` — improving trajectory but not yet healthy.
- * `healthy` — stable, all checks pass.
+ * 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.
  *
- * Distinct from `StatusKey` (critical/warning/normal — short-lived operational)
- * and `SeverityKey` (urgent/high/medium/low — urgency of an action item).
- */
-type EntityHealthKey = 'banned' | 'pending' | 'at-risk' | 'warning' | 'growing' | 'healthy';
-declare const ENTITY_HEALTH_KEYS: readonly EntityHealthKey[];
-declare const entityHealthLabels: Record<SupportedLocale, Record<EntityHealthKey, string>>;
-/**
- * Priority rank of each entity health state — higher number = more severe.
- * Use to sort entity lists "worst first" without ad-hoc comparisons.
- */
-declare const entityHealthPriority: Record<EntityHealthKey, number>;
-/** True iff the entity needs immediate human attention. */
-declare function isCriticalEntityHealth(s: EntityHealthKey): boolean;
-/**
- * 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 filters: "فیلترها";
-        readonly applyFilters: "اعمال";
-        readonly resetFilters: "پیش‌فرض";
-        readonly noFiltersActive: "فیلتر فعالی نیست";
-        readonly clearSection: "پاک کردن این بخش";
-        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 filters: "الفلاتر";
-        readonly applyFilters: "تطبيق";
-        readonly resetFilters: "الافتراضي";
-        readonly noFiltersActive: "لا توجد فلاتر نشطة";
-        readonly clearSection: "مسح هذا القسم";
-        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 filters: "Filters";
-        readonly applyFilters: "Apply";
-        readonly resetFilters: "Reset";
-        readonly noFiltersActive: "No active filters";
-        readonly clearSection: "Clear this section";
-        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>;
-/**
- * Get UI strings for a given locale.
- * Falls back to 'fa' for unknown locales.
+ * 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.
@@ -689,38 +416,6 @@ declare function AlertDialogDescription({ className, ...props }: React$1.Compone
 declare const AlertDialogAction: React$1.ForwardRefExoticComponent<Omit<AlertDialogPrimitive.AlertDialogActionProps & React$1.RefAttributes<HTMLButtonElement>, "ref"> & React$1.RefAttributes<HTMLButtonElement>>;
 declare const AlertDialogCancel: React$1.ForwardRefExoticComponent<Omit<AlertDialogPrimitive.AlertDialogCancelProps & React$1.RefAttributes<HTMLButtonElement>, "ref"> & React$1.RefAttributes<HTMLButtonElement>>;
 
-/**
- * AlertRuleCard — saved alert-rule definition. Shows trigger summary,
- * threshold, severity tag, target channels, and an active/inactive toggle.
- *
- * Designed for "Alert Rules" management pages — a list of these cards lets
- * an analyst quickly scan + tweak which alerts are running.
- */
-type AlertChannel = 'email' | 'sms' | 'telegram' | 'in-app' | 'webhook';
-interface AlertRuleCardProps extends React$1.HTMLAttributes<HTMLDivElement> {
-    /** Rule name (e.g., "افزایش ناگهانی منفی") */
-    name: React$1.ReactNode;
-    /** Trigger description in plain language (e.g., "هرگاه نرخ منفی > ۲۰٪ شد") */
-    trigger: React$1.ReactNode;
-    /** Threshold value display (e.g., "≥ ۲۰٪", "> ۱۰۰۰ mentions") */
-    threshold?: React$1.ReactNode;
-    /** Severity that this alert raises */
-    severity?: SeverityKey;
-    /** Channels this rule fires through */
-    channels?: AlertChannel[];
-    /** Active state (master switch) */
-    active: boolean;
-    /** Called when the user toggles the switch */
-    onActiveChange: (next: boolean) => void;
-    /** Last-fired timestamp display (e.g., "۲ ساعت پیش") */
-    lastFired?: React$1.ReactNode;
-    /** Optional total fire count */
-    fireCount?: number;
-    /** Locale @default 'fa' */
-    locale?: SupportedLocale;
-}
-declare const AlertRuleCard: React$1.ForwardRefExoticComponent<AlertRuleCardProps & React$1.RefAttributes<HTMLDivElement>>;
-
 interface AutocompleteItem {
     value: string;
     label: string;
@@ -956,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;
@@ -985,17 +667,6 @@ interface AvatarGroupProps extends React$1.HTMLAttributes<HTMLDivElement>, Varia
 }
 declare const AvatarGroup: React$1.ForwardRefExoticComponent<AvatarGroupProps & React$1.RefAttributes<HTMLDivElement>>;
 
-declare const badgeVariants: (props?: ({
-    variant?: "warning" | "success" | "default" | "outline" | "destructive" | "secondary" | "brand" | null | undefined;
-    size?: "xs" | "sm" | "md" | "lg" | "small" | "large" | "tiny" | 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?: "neutral" | "warning" | "success" | "info" | "destructive" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
@@ -1042,43 +713,6 @@ declare namespace BreadcrumbEllipsis {
     var displayName: string;
 }
 
-type ButtonVariantProps = VariantProps<typeof buttonVariants>;
-declare const buttonVariants: (props?: ({
-    variant?: "warning" | "link" | "text" | "default" | "outline" | "dashed" | "destructive" | "primary" | "secondary" | "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?: "warning" | "link" | "text" | "default" | "outline" | "dashed" | "destructive" | "primary" | "secondary" | "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;
@@ -1097,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];
@@ -1187,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;
@@ -1245,69 +838,6 @@ declare namespace CommandShortcut {
     var displayName: string;
 }
 
-/**
- * Hotkey string grammar:
- *
- *   <part>[+<part>]*
- *
- * where each <part> is one of:
- *   mod           — Cmd on macOS, Ctrl on everything else (recommended)
- *   ctrl / cmd    — explicit, cross-platform tokens
- *   shift | alt | meta
- *   <single key>  — lowercase character, 'space', 'enter', 'escape', 'tab',
- *                   arrow{up,down,left,right}, 'slash', 'backspace', etc.
- *
- * Examples:
- *   'mod+k'          — ⌘K on macOS, CtrlK elsewhere
- *   'mod+shift+p'
- *   'escape'
- *   'ctrl+k'         — explicit Ctrl (no Cmd fallback on macOS)
- *
- * Passing an array of strings is treated as an OR — any combo fires the handler.
- */
-type HotkeyCombo = string | readonly string[];
-interface UseHotkeysOptions {
-    /**
-     * When true, `event.preventDefault()` is called on matched combos.
-     * Default: true. Useful to allow the browser's native 'mod+k' (address bar)
-     * to keep working — set to false if the handler only does something conditionally.
-     */
-    preventDefault?: boolean;
-    /**
-     * Skip the handler when focus is inside an editable control (input, textarea,
-     * contenteditable). The exception: combos that include a modifier (mod/ctrl/
-     * cmd/alt) still fire — they are unambiguous shortcuts, not typing.
-     * Default: true.
-     */
-    ignoreWhenTyping?: boolean;
-    /**
-     * When false, the hook unregisters its listener. Useful for conditionally
-     * enabling shortcuts (e.g., only while a panel is open).
-     * Default: true.
-     */
-    enabled?: boolean;
-    /**
-     * DOM target. Defaults to `document`. Pass a ref for scoped shortcuts (e.g.,
-     * only when a specific panel has focus within).
-     */
-    target?: React$1.RefObject<HTMLElement | null> | HTMLElement | Document | null;
-}
-/**
- * Register a keyboard shortcut. Handler fires when the combo matches, respecting
- * `ignoreWhenTyping` (default true) — except when a modifier is part of the combo,
- * which always wins. Returns nothing; cleanup is automatic.
- *
- * @example
- * useHotkeys('mod+k', () => setOpen((v) => !v))
- * useHotkeys(['escape', 'mod+w'], close, { enabled: open })
- */
-declare function useHotkeys(combo: HotkeyCombo, handler: (event: KeyboardEvent) => void, options?: UseHotkeysOptions): void;
-/**
- * Render-helper: returns a platform-appropriate display string for a combo.
- * 'mod+k' → '⌘K' on macOS, 'Ctrl+K' elsewhere. Useful for `<CommandShortcut>`.
- */
-declare function formatHotkey(combo: string): string;
-
 interface CommandPaletteItem {
     /** Stable identifier. Used as the cmdk value and the recents key — MUST be unique across the whole items list. */
     id: string;
@@ -1403,6 +933,11 @@ interface PartoRadarChartProps {
     };
     /** 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;
@@ -1874,84 +1409,6 @@ declare namespace ContextMenuShortcut {
     var displayName: string;
 }
 
-type FlowData = Partial<Record<FlowKey, number>>;
-interface FlowDistributionProps extends React$1.HTMLAttributes<HTMLDivElement> {
-    /** Flow counts (auto-normalized). Missing keys treated as 0. */
-    data: FlowData;
-    /** Display mode */
-    variant?: 'bars' | 'stacked' | 'compact';
-    /** Show numeric counts alongside percent */
-    showCounts?: boolean;
-    /** Show percentages */
-    showPercent?: boolean;
-    /** Locale */
-    locale?: SupportedLocale;
-    /** Loading skeleton */
-    isLoading?: boolean;
-}
-declare const FlowDistribution: React$1.ForwardRefExoticComponent<FlowDistributionProps & React$1.RefAttributes<HTMLDivElement>>;
-
-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>>;
-
-/**
- * ConceptCard — افکارسنجی-flavored headline tile for clustering dashboards.
- * Composes: status badge, severity badge, flow composition bar, sentiment
- * distribution, sparkline trend, AI summary snippet, optional comparison
- * checkbox. Built for government dashboards where each "concept" needs
- * to fit in a card grid with rich, comparable signals.
- */
-interface ConceptCardProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, 'title'> {
-    /** Concept name (e.g., "افزایش قیمت بنزین") */
-    title: React$1.ReactNode;
-    /** Short subtitle (e.g., "خوشه ۴ — ۱۲۰ پست") */
-    subtitle?: React$1.ReactNode;
-    /** Operational status */
-    status?: StatusKey;
-    /** Criticality of the concept (urgent/high/medium/low) */
-    severity?: SeverityKey;
-    /** Flow composition breakdown (5-class political) */
-    flow?: FlowData;
-    /** Sentiment composition (3-class) */
-    sentiment?: SentimentData;
-    /** Trend sparkline values (e.g., last 14 days mention volume) */
-    trend?: number[];
-    /** AI-generated short summary (1-2 sentences) */
-    aiSummary?: React$1.ReactNode;
-    /** Total mentions / size — shown as a stat */
-    totalCount?: number;
-    /** Comparison checkbox state. When provided, renders the checkbox in the header */
-    comparison?: {
-        selected: boolean;
-        onSelectionChange: (next: boolean) => void;
-        label?: React$1.ReactNode;
-    };
-    /** Make the entire card clickable (cursor + hover/focus ring) */
-    interactive?: boolean;
-    /** Locale @default 'fa' */
-    locale?: SupportedLocale;
-}
-declare const ConceptCard: React$1.ForwardRefExoticComponent<ConceptCardProps & React$1.RefAttributes<HTMLDivElement>>;
-
 interface CopyButtonProps extends Omit<ButtonProps, 'onClick'> {
     /** The text value to copy to clipboard */
     value: string;
@@ -2264,6 +1721,32 @@ 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>>;
 
+/**
+ * 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;
@@ -2475,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) */
@@ -2515,6 +2030,45 @@ 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 */
@@ -2784,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;
@@ -2964,100 +2718,6 @@ declare namespace NavigationMenuIndicator {
     var displayName: string;
 }
 
-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>>;
-
-type BotDetectionKey = 'real' | 'suspicious' | 'bot';
-interface BotDetectionData {
-    /** Confirmed real / human accounts */
-    real: number;
-    /** Suspicious — insufficient signal, possibly bot */
-    suspicious: number;
-    /** Confirmed bot / automated */
-    bot: number;
-}
-interface BotDetectionMeterProps extends React$1.HTMLAttributes<HTMLDivElement> {
-    /** Counts — auto-normalised to percentages that sum to exactly 100 */
-    data: BotDetectionData;
-    /** Display mode @default "stacked" */
-    variant?: 'stacked' | 'bars' | 'compact';
-    /** Show numeric count labels */
-    showCounts?: boolean;
-    /** Show percentage labels @default true */
-    showPercent?: boolean;
-    /** Show the top "Real-account rate" summary line (stacked variant only) @default true */
-    showSummary?: boolean;
-    /** Size of the stacked bar or individual bars */
-    size?: 'sm' | 'md' | 'lg';
-    /** Locale for digits + default labels @default "fa" */
-    locale?: SupportedLocale;
-}
-declare const BotDetectionMeter: React$1.ForwardRefExoticComponent<BotDetectionMeterProps & React$1.RefAttributes<HTMLDivElement>>;
-
-/**
- * PageCard (government-flavor) — tracked-account tile for افکارسنجی pages
- * dashboards. Composes: avatar + handle + platform badge, status (healthy/
- * degrading/at-risk via StatusKey), follower trend sparkline, engagement
- * stats, content-type mix, bot-detection percentages.
- *
- * Distinct from `ProfileCard` which is influencer-flavored (focus on
- * engagement tier, follower count, avatar). PageCard is for **tracked
- * accounts** in monitoring — health and trust signals matter most.
- */
-interface PageCardContentMix {
-    /** Photo posts in window (count or %) */
-    photo?: number;
-    /** Video posts in window */
-    video?: number;
-    /** Carousel posts */
-    carousel?: number;
-    /** Story / reel count */
-    story?: number;
-}
-interface PageCardProps extends React$1.HTMLAttributes<HTMLDivElement> {
-    /** Account handle / display name (e.g., "@news_agency") */
-    handle: React$1.ReactNode;
-    /** Optional secondary subtitle (e.g., page category) */
-    subtitle?: React$1.ReactNode;
-    /** Avatar URL */
-    avatarSrc?: string;
-    /** Platform — drives the platform badge */
-    platform?: SocialPlatform;
-    /** Operational status (healthy/degrading/at-risk) — uses StatusKey */
-    status?: StatusKey;
-    /** Total followers (current snapshot) */
-    followers?: number;
-    /** Follower-trend sparkline values */
-    followerTrend?: number[];
-    /** Engagement rate (%) */
-    engagementRate?: number;
-    /** Posts per week (recent average) */
-    postsPerWeek?: number;
-    /** Content-type mix (counts or percents) */
-    contentMix?: PageCardContentMix;
-    /** Bot-detection breakdown (real / suspicious / bot) */
-    botDetection?: BotDetectionData;
-    /** Make the entire card clickable */
-    interactive?: boolean;
-    /** Locale @default 'fa' */
-    locale?: SupportedLocale;
-}
-declare const PageCard: React$1.ForwardRefExoticComponent<PageCardProps & React$1.RefAttributes<HTMLDivElement>>;
-
 interface PageHeaderProps extends React$1.HTMLAttributes<HTMLDivElement> {
     /** Page title */
     title: string;
@@ -3163,11 +2823,6 @@ 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.
@@ -3603,6 +3258,61 @@ interface PostListProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, 'on
 }
 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. */
@@ -4019,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;
@@ -4278,39 +3936,6 @@ declare namespace FormRowSkeleton {
     var displayName: string;
 }
 
-type SparklineTrend = 'up' | 'down' | 'neutral' | 'auto';
-type SparklineVariant = 'line' | 'area' | 'bars';
-interface SparklineProps extends React$1.HTMLAttributes<HTMLDivElement> {
-    /** Array of numeric data points. Must have at least 2 items to render line/area. */
-    data: number[];
-    /** Visual style @default "line" */
-    variant?: SparklineVariant;
-    /**
-     * Trend colour. `"auto"` compares first and last point:
-     *   last > first → up, last < first → down, equal → neutral.
-     * Pass an explicit value to override.
-     * @default "auto"
-     */
-    trend?: SparklineTrend;
-    /** Width in px. Also used as SVG viewBox width — output scales to parent when CSS overrides. @default 80 */
-    width?: number;
-    /** Height in px @default 24 */
-    height?: number;
-    /** Line / bar stroke width @default 1.5 */
-    strokeWidth?: number;
-    /** Show a filled dot at the last point */
-    showEndDot?: boolean;
-    /** Padding inside the viewBox so strokes/dots are not clipped @default 2 */
-    padding?: number;
-    /** Override color with any CSS value (e.g. `"hsl(var(--brand))"`). Takes precedence over `trend`. */
-    color?: string;
-    /** For bars variant — gap between bars in user units @default 1 */
-    barGap?: number;
-    /** aria-label for screen readers — describe the trend / metric */
-    'aria-label'?: string;
-}
-declare const Sparkline: React$1.ForwardRefExoticComponent<SparklineProps & React$1.RefAttributes<HTMLDivElement>>;
-
 declare function Slider({ className, defaultValue, value, min, max, dir, ...props }: React$1.ComponentProps<typeof SliderPrimitive.Root>): react_jsx_runtime.JSX.Element;
 declare namespace Slider {
     var displayName: string;
@@ -4578,6 +4203,15 @@ interface JobWizardStep {
     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;
@@ -4911,118 +4545,6 @@ 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> */
-    className?: string;
-    /** Column alignment */
-    align?: 'start' | 'center' | 'end';
-    /**
-     * Pin the column to the start (logical, RTL-aware) or end of the visible
-     * area. Pinned columns stay visible while horizontal scrolling. The
-     * selection / expansion gutter columns are pinned automatically.
-     */
-    pinned?: 'start' | 'end';
-    /** Optional fixed pixel width (used for pinning offset calculation) */
-    width?: number;
-    /** When false, this column is hidden via the columnVisibility map */
-    defaultVisible?: boolean;
-}
-interface DataTableColumnVisibility {
-    /** Map of column id → visible. Missing keys default to true. */
-    visible: Record<string, boolean>;
-    /** Called when a column toggle changes. */
-    onVisibilityChange: (next: Record<string, boolean>) => void;
-}
-interface DataTableExpansion<TData> {
-    /** Set of expanded row keys. */
-    expandedRows: Set<number>;
-    /** Called when expansion toggles. */
-    onExpandedRowsChange: (next: Set<number>) => void;
-    /** Render function for the expanded content (full-width row below). */
-    renderExpandedRow: (row: TData, rowIndex: number) => React$1.ReactNode;
-}
-interface DataTablePagination {
-    currentPage: number;
-    totalPages: number;
-    onPageChange: (page: number) => void;
-}
-interface DataTableSort {
-    column: string | null;
-    direction: SortDirection | null;
-    onSort: (column: string, direction: SortDirection) => void;
-}
-interface DataTableSelection<TData> {
-    selectedRows: Set<number>;
-    onSelectionChange: (selectedRows: Set<number>) => void;
-    /** Function to get a unique key for each row (defaults to index) */
-    getRowKey?: (row: TData, index: number) => number;
-}
-interface DataTableProps<TData> {
-    /** Column definitions */
-    columns: DataTableColumn<TData>[];
-    /** Data rows */
-    data: TData[];
-    /** Table size variant */
-    size?: 'sm' | 'md' | 'lg';
-    /** Show loading skeleton */
-    isLoading?: boolean;
-    /** Number of skeleton rows to show when loading */
-    loadingRows?: number;
-    /** Content to show when data is empty (not loading) */
-    emptyState?: React$1.ReactNode;
-    /** Pagination configuration */
-    pagination?: DataTablePagination;
-    /** Sort configuration */
-    sort?: DataTableSort;
-    /** Row selection configuration */
-    selection?: DataTableSelection<TData>;
-    /** Column visibility configuration (for show/hide column toggle) */
-    columnVisibility?: DataTableColumnVisibility;
-    /** Expansion configuration (for inline detail row) */
-    expansion?: DataTableExpansion<TData>;
-    /**
-     * Opt-in row virtualization for very long lists (1000+ rows). When set,
-     * the table is wrapped in a scroll container of `viewportHeight` and only
-     * rows in the visible window + `overscan` are rendered. Rows must have a
-     * predictable `rowHeight`; expanded rows + dynamic content are NOT
-     * supported in virtualized mode.
-     */
-    virtualize?: {
-        /** Pixel height of each row (must be uniform). */
-        rowHeight: number;
-        /** Container scroll-area height in px. @default 480 */
-        viewportHeight?: number;
-        /** Extra rows rendered above and below the viewport. @default 6 */
-        overscan?: number;
-    };
-    /** Zebra-striped rows */
-    striped?: boolean;
-    /** Bordered cells */
-    bordered?: boolean;
-    /** Sticky header */
-    stickyHeader?: boolean;
-    /** Additional className for the root wrapper */
-    className?: string;
-    /** Caption text below the table */
-    caption?: string;
-    /** Total result count shown above table (e.g. "۲۴ نتیجه") */
-    resultCount?: React$1.ReactNode;
-    /** Locale for UI strings @default 'fa' */
-    locale?: SupportedLocale;
-}
-declare const DataTable: <TData>(props: DataTableProps<TData> & {
-    ref?: React$1.ForwardedRef<HTMLDivElement>;
-}) => React$1.ReactElement;
-
 /**
  * data-table-cells — opinionated thin wrappers around DS primitives, sized
  * and styled for use as `DataTableColumn.cell` values. Each cell renderer
@@ -5278,42 +4800,6 @@ interface SafeImageProps extends React$1.ImgHTMLAttributes<HTMLImageElement> {
 }
 declare const SafeImage: React$1.ForwardRefExoticComponent<SafeImageProps & React$1.RefAttributes<HTMLImageElement>>;
 
-/**
- * SavedQueryCard — saved-search tile for analyst dashboards. Shows query
- * description + filter summary chips, run count, last-run timestamp, and a
- * one-click "run again" action button. Optional star/favorite toggle.
- */
-interface SavedQueryFilter {
-    /** Filter label (e.g., "احساس") */
-    label: React$1.ReactNode;
-    /** Filter value (e.g., "منفی") */
-    value: React$1.ReactNode;
-}
-interface SavedQueryCardProps extends React$1.HTMLAttributes<HTMLDivElement> {
-    /** Saved query name */
-    name: React$1.ReactNode;
-    /** Optional 1-line description */
-    description?: React$1.ReactNode;
-    /** Filter chips (label + value pairs) */
-    filters?: SavedQueryFilter[];
-    /** Total run count */
-    runCount?: number;
-    /** Last-run display (e.g., "۲ روز پیش") */
-    lastRun?: React$1.ReactNode;
-    /** Run-now callback */
-    onRun?: () => void;
-    /** Run button label override */
-    runLabel?: React$1.ReactNode;
-    /** Favorite/star state. When set, renders the star toggle */
-    favorite?: {
-        starred: boolean;
-        onChange: (next: boolean) => void;
-    };
-    /** Locale @default 'fa' */
-    locale?: SupportedLocale;
-}
-declare const SavedQueryCard: React$1.ForwardRefExoticComponent<SavedQueryCardProps & React$1.RefAttributes<HTMLDivElement>>;
-
 interface ReportComposerProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, 'title'> {
     /** Report title (e.g., "بولتن هفتگی — هفته ۱۴") */
     title?: React$1.ReactNode;
@@ -5364,6 +4850,114 @@ interface BulletinViewerProps extends Omit<React$1.HTMLAttributes<HTMLDivElement
 }
 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?: "neutral" | "warning" | "success" | "info" | "destructive" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
@@ -5408,122 +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>>;
-
 /**
  * PartoWordCloud — modern word cloud with smooth hover transitions,
  * glassmorphic tooltip, and brand-harmonious coloring.
@@ -5558,46 +5036,6 @@ declare namespace PartoWordCloud {
     var displayName: string;
 }
 
-interface PartoAreaChartProps {
-    /** Row-oriented data: [{ name: "فروردین", series1: 50, series2: 30 }] */
-    data: Array<Record<string, any>>;
-    /** Keys for each area series (e.g. ['فروش', 'سود']) */
-    dataKeys: string[];
-    /** Field name for X axis (default: 'name') */
-    xAxisKey?: string;
-    /** Curve type */
-    curve?: 'monotone' | 'linear' | 'natural' | 'step';
-    /** Line width */
-    strokeWidth?: number;
-    /** Area fill opacity */
-    fillOpacity?: number;
-    /** Show dots on data points */
-    showDots?: boolean;
-    /** Show horizontal grid lines */
-    enableGridY?: boolean;
-    /** Show vertical grid lines */
-    enableGridX?: boolean;
-    /** Chart margins */
-    margin?: {
-        top?: number;
-        right?: number;
-        bottom?: number;
-        left?: number;
-    };
-    /** Custom X axis config */
-    axisBottom?: Record<string, any> | null;
-    /** Custom Y axis config */
-    axisLeft?: Record<string, any> | null;
-    /** Custom tooltip formatter */
-    tooltipFormatter?: (name: string, value: number) => React$1.ReactNode;
-    className?: string;
-    isLoading?: boolean;
-    ariaLabel?: string;
-    /** Additional Recharts AreaChart props */
-    chartProps?: Record<string, any>;
-}
-declare const PartoAreaChart: React$1.ForwardRefExoticComponent<PartoAreaChartProps & React$1.RefAttributes<HTMLDivElement>>;
-
 /**
  * PartoScatterChart — x/y scatter with optional bubble sizing (z) and
  * per-point color override. Wraps Recharts ScatterChart with theme-aware
@@ -5989,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.
@@ -6019,6 +5474,46 @@ declare function transformNivoLineData(nivoData: Array<{
  */
 declare function useScrollLock(locked: boolean): void;
 
+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.
@@ -6128,4 +5623,91 @@ interface UseAsyncReturn<T> {
 }
 declare function useAsync<T = unknown>(initialData?: T | null): UseAsyncReturn<T>;
 
-export { ACTION_STATUS_KEYS, ACTION_TYPE_KEYS, ACTION_TYPE_META, Accordion, AccordionContent, AccordionItem, AccordionTrigger, type ActionStatusKey, ActionTimeline, type ActionTimelineDensity, type ActionTimelineGroupBy, ActionTimelineItem, type ActionTimelineItemData, type ActionTimelineItemProps, type ActionTimelineProps, ActionTypeChip, type ActionTypeChipProps, type ActionTypeKey, ActiveFiltersBar, type ActiveFiltersBarProps, ActiveFiltersClearAll, type ActiveFiltersClearAllProps, Alert, type AlertChannel, AlertDescription, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, AlertRuleCard, type AlertRuleCardProps, AlertTitle, AnimatedNumber, type AnimatedNumberProps, AppBar, type AppBarProps, AppLayout, AppLayoutContent, AspectRatio, type AsyncStatus, Autocomplete, type AutocompleteItem, type AutocompleteProps, Avatar, AvatarFallback, AvatarGroup, type AvatarGroupItem, type AvatarGroupProps, AvatarImage, AvatarTextSkeleton, type AvatarTextSkeletonProps, Badge, type BadgeProps, Banner, type BannerProps, type BenchmarkMarker, type BenchmarkTier, type BotDetectionData, type BotDetectionKey, BotDetectionMeter, type BotDetectionMeterProps, Breadcrumb, BreadcrumbEllipsis, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator, BulletinViewer, type BulletinViewerProps, Button, ButtonGroup, ButtonGroupSeparator, ButtonGroupText, type ButtonProps, type ButtonVariantProps, CHART_FONT_FAMILY, CRITERION_TIER_KEYS, Calendar, type CalendarProps, Callout, CalloutDescription, type CalloutProps, CalloutTitle, Card, CardContent, CardDescription, CardFooter, CardHeader, type CardProps, CardSkeleton, type CardSkeletonProps, 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, 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, ConceptCard, type ConceptCardProps, 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 CriterionInputSpec, CriterionScoreCard, type CriterionScoreCardProps, type CriterionTierKey, type CriterionTierThresholds, type CriterionTrend, DEFAULT_CRITERION_THRESHOLDS, DEFAULT_PERIODS, DEFAULT_THRESHOLDS, DataTable, type DataTableColumn, type DataTableColumnVisibility, DataTableColumnVisibilityToggle, type DataTableColumnVisibilityToggleProps, type DataTableExpansion, DataTableExportButton, type DataTableExportButtonProps, 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, EMOTION_KEYS, ENGAGEMENT_RANGES, ENTITY_HEALTH_KEYS, EmotionBadge, type EmotionBadgeProps, type EmotionData, EmotionDistribution, type EmotionDistributionProps, type 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, type EntityHealthKey, ErrorBoundary, type ErrorBoundaryProps, ErrorState, type ErrorStateProps, type ExportableColumn, FLOW_KEYS, 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, FilterSection, type FilterSectionProps, FlowBadge, type FlowBadgeProps, FlowCell, type FlowCellProps, type FlowData, FlowDistribution, type FlowDistributionProps, type FlowKey, type FollowerGroup, Form, FormControl, FormDescription, FormField, FormItem, FormLabel, FormMessage, FormRowSkeleton, type FormRowSkeletonProps, GROUP_LABELS, HashtagInput, type TagInputProps as HashtagInputProps, type HeatMapDatum, type HeatMapRow, type HotkeyCombo, HoverCard, HoverCardContent, HoverCardTrigger, type Icon, Icons, Input, InputGroup, InputGroupAddon, InputGroupButton, InputGroupInput, InputGroupText, InputGroupTextarea, InputOTP, InputOTPGroup, InputOTPSeparator, InputOTPSlot, type InputProps, InputVariants, InputWithIcon, type InputWithIconProps, JOB_STATUS_KEYS, 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, type 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, type LegacySize, type LoadingVariantProps, type Locale, 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, 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, NotificationCenter, type NotificationCenterProps, type NotificationFilter, type NotificationItem, type NotificationSeverity, PERSIAN_MONTHS, PERSIAN_MONTHS_SHORT, PERSIAN_WEEKDAYS, PERSIAN_WEEKDAYS_SHORT, PageCard, type PageCardContentMix, type PageCardProps, 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, PartoNetworkChart, type PartoNetworkChartProps, PartoPieChart, type PartoPieChartProps, PartoRadarChart, type PartoRadarChartProps, PartoSankeyChart, type PartoSankeyChartProps, PartoScatterChart, type PartoScatterChartProps, type PartoToasterProps, PartoWordCloud, type PartoWordCloudProps, type PeriodOption, PeriodSelector, type PeriodSelectorProps, type PlatformMetadata, Popover, PopoverAnchor, PopoverContent, PopoverTrigger, 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, ReportComposer, type ReportComposerProps, ReportSection, type ReportSectionProps, ResizableHandle, ResizablePanel, ResizablePanelGroup, RouteProgress, type RouteProgressHandle, type RouteProgressProps, SONNER_DEFAULT_DURATION, STAGE_STATUS_KEYS, SafeImage, type SafeImageProps, type SankeyLink, type SankeyNode, SavedQueryCard, type SavedQueryCardProps, type SavedQueryFilter, ScrollArea, ScrollBar, SearchInput, type SearchInputProps, type SectionItem, SectionNavigator, type SectionNavigatorProps, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectTriggerVariants, SelectValue, SentimentBadge, type SentimentBadgeProps, SentimentCell, type SentimentCellProps, type SentimentData, SentimentDistribution, type SentimentDistributionProps, Separator, SeverityBadge, type SeverityBadgeProps, type SeverityKey, 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, SiteHeader, SiteHeaderActions, SiteHeaderEnd, type SiteHeaderProps, SiteHeaderSeparator, SiteHeaderStart, SiteHeaderSubtitle, SiteHeaderTitle, SiteHeaderTitleGroup, type SizeWithLegacy, Skeleton, type SkeletonProps, Slider, type SocialPlatform, SocialPlatformBadge, type SocialPlatformBadgeProps, type SortDirection, Sparkline, SparklineCell, type SparklineCellProps, type SparklineProps, type SparklineTrend, type SparklineVariant, Spinner, type SpinnerProps, type StageStatusKey, type StandardSize, StatDeltaCell, type StatDeltaCellProps, StatDisplay, type StatDisplayProps, StatusBadge, type StatusBadgeProps, StatusFlow, type StatusFlowOrientation, type StatusFlowProps, type StatusFlowSize, StatusFlowStage, type StatusFlowStageData, type StatusFlowStageProps, type StatusKey, StatusPulseCell, type StatusPulseCellProps, Step, type StepProps, Stepper, type StepperProps, type 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, Textarea, Toaster, Toggle, ToggleGroup, ToggleGroupItem, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, TrendCell, type TrendCellProps, TrendIndicator, type TrendIndicatorProps, type UIStringKeys, type UIStrings, UI_STRINGS, type UseAsyncReturn, type UseClipboardOptions, type UseClipboardReturn, type UseHotkeysOptions, 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, actionStatusLabels, actionTypeChipVariants, actionTypeLabels, actionTypeVerbs, appBarVariants, avatarGroupVariants, badgeVariants, bannerVariants, buildCsv, buildPostingFrequencyRows, buildTsv, buttonGroupVariants, buttonVariants, calloutVariants, cardVariants, cn, computeComparisonWinners, convertToLocalNumbers, countComparisonWins, defaultActions as defaultPostActions, downloadFile, emotionLabels, engagementUiTranslations, entityHealthLabels, entityHealthPriority, findTierIndex, flowLabels, formatAbsoluteTime, formatHotkey, formatJalaliDate, formatLargeNumber, formatNumber, formatPersianDateRange, formatRelativeLocaleTime, formatRelativeTime, formatTimeRemaining, getCriterionTier, getCurrentRangeIndex, getEngagementRanges, getEngagementRateBenchmarkTiers, getFollowerGroup, getPersianDay, getPersianMonth, getPersianMonthName, getPersianMonthNameShort, getPersianMonthsForDropdown, getPersianWeekdayName, getPersianYear, getPersianYearsForDropdown, getScoreBenchmarkTiers, getUIStrings, tagInputVariants as hashtagInputVariants, inputVariants, isActiveJobStatus, isCriticalEntityHealth, isRTL, jalaliToGregorian, jobStatusLabels, navItemVariants, navigationMenuTriggerStyle, normalizeSize, pageLoaderVariants, postCardVariants, postHeaderVariants, profileCardVariants, resolveLevel, sentimentLabels, severityLabels, siteHeaderVariants, socialPlatformBadgeVariants, spinnerVariants, stageStatusLabels, statDisplayVariants, statusLabels, tagInputVariants, toEnglishDigits, toPersianDigits, toggleVariants, transformNivoLineData, useAsync, useBreakpoint, useChartTheme, useClipboard, useDebounce, useDocumentDirection, useFormField, useHotkeys, useInfiniteScroll, useIsMobile, useJobWizard, useJobWizardState, useLocalStorage, useMediaQuery, useNavRail, useNavTree, useOutsideClick, usePrevious, useRootStyles, useScrollLock, useSidebar };
+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 };