@parto-system-design/ui 1.1.5 → 1.1.8

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, b as EmotionKey, F as FlowKey, S as StageStatusKey, 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-CmShVqG-.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-CmShVqG-.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,9 +933,20 @@ 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;
+    /**
+     * Render a legend below the radar that names each series. Recommended when
+     * more than one Radar fill is drawn — overlapping color-only fills are
+     * unreadable for colorblind users (WCAG 1.4.1). @default `false`
+     */
+    legend?: boolean;
 }
 declare const PartoRadarChart: React$1.ForwardRefExoticComponent<PartoRadarChartProps & React$1.RefAttributes<HTMLDivElement>>;
 
@@ -1874,84 +1415,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 +1727,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 +1964,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) */
@@ -2510,11 +2031,54 @@ interface TagInputProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, 'on
     prefix?: string;
     /** Locale for sr-only remove label @default "fa" */
     locale?: SupportedLocale;
+    /** Form `name` attribute forwarded to the inner `<input>` (for React Hook Form / native forms). */
+    name?: string;
+    /** HTML5 `required` attribute forwarded to the inner `<input>`. */
+    required?: boolean;
 }
 declare const TagInput: React$1.ForwardRefExoticComponent<TagInputProps & React$1.RefAttributes<HTMLDivElement>>;
 
 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,7 +2348,207 @@ declare namespace KbdGroup {
     var displayName: string;
 }
 
-declare function Menubar({ className, ...props }: React$1.ComponentProps<typeof MenubarPrimitive.Root>): react_jsx_runtime.JSX.Element;
+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, dir, ...props }: React$1.ComponentProps<typeof MenubarPrimitive.Root>): react_jsx_runtime.JSX.Element;
 declare namespace Menubar {
     var displayName: string;
 }
@@ -2928,7 +2692,7 @@ declare namespace NativeSelectOptGroup {
     var displayName: string;
 }
 
-declare function NavigationMenu({ className, children, viewport, ...props }: React$1.ComponentProps<typeof NavigationMenuPrimitive.Root> & {
+declare function NavigationMenu({ className, children, viewport, dir, ...props }: React$1.ComponentProps<typeof NavigationMenuPrimitive.Root> & {
     viewport?: boolean;
 }): react_jsx_runtime.JSX.Element;
 declare namespace NavigationMenu {
@@ -2964,100 +2728,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 +2833,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.
@@ -3212,6 +2877,15 @@ interface PartoHeatMapProps {
     yAxisLabel?: string;
     /** Filter which x-axis ticks to show */
     xTickFilter?: (value: string | number, index: number) => boolean;
+    /**
+     * Render a continuous-gradient legend below the heatmap that maps the
+     * color intensity to a [min, max] value range. The bar uses the same
+     * `colorScale` the cells use, so the gradient matches the data exactly.
+     * @default `false`
+     */
+    legend?: boolean;
+    /** Caption shown above the gradient bar when `legend` is on (e.g. "تراکم انتشار"). */
+    legendCaption?: React$1.ReactNode;
 }
 declare const PartoHeatMap: React$1.ForwardRefExoticComponent<PartoHeatMapProps & React$1.RefAttributes<HTMLDivElement>>;
 
@@ -3274,64 +2948,162 @@ interface PostingFrequencyHeatmapProps extends Omit<React$1.HTMLAttributes<HTMLD
 declare const PostingFrequencyHeatmap: React$1.ForwardRefExoticComponent<PostingFrequencyHeatmapProps & React$1.RefAttributes<HTMLDivElement>>;
 
 /**
- * Platform sources supported by `<PostCard>`. Extends the existing `SocialPlatform`
- * for Phase 1; additional sources (`facebook`, `news`, `tv`, `radio`) land in Phase 2
- * together with the `SocialPlatformBadge` extension.
+ * The full set of sources a post can originate from in Parto's social-listening +
+ * افکارسنجی pipeline. Extends `SocialPlatform` (7 social networks) with broadcast
+ * (tv, radio) and editorial (press, web) sources.
+ */
+type PostSource = SocialPlatform | 'tv' | 'radio' | 'press' | 'web';
+/** High-level grouping that drives header layout and default metric ordering. */
+type PostSourceCategory = 'social' | 'broadcast' | 'editorial';
+/**
+ * Derive the source category from a `PostSource` value.
+ * Used internally by `<PostHeader>`, metric label helpers, and default-actions config.
+ */
+declare function sourceCategory(source: PostSource): PostSourceCategory;
+/**
+ * @deprecated Use {@link PostSource} for new code. `PostPlatform` is retained with its
+ * historical meaning (the 7 social networks only) so existing components that target
+ * social-specific APIs (e.g. `<SocialPlatformBadge>`) keep their narrow contract.
+ * `PostSource` is the expanded superset (adds tv / radio / press / web).
  */
 type PostPlatform = SocialPlatform;
+/**
+ * `view` is the canonical PostList render mode. `compact` and `comfortable` are the
+ * pre-existing densities; `grid` is the new magazine/visual layout.
+ */
+type PostView = 'compact' | 'comfortable' | 'grid';
+/**
+ * @deprecated Use {@link PostView} instead. `density` is the legacy two-value alias
+ * (compact | comfortable) kept for backward compatibility with PostCard / PostList.
+ */
 type PostDensity = 'compact' | 'comfortable';
 type PostSentiment = 'positive' | 'negative' | 'neutral' | 'mixed';
+type PostEmotion = 'anger' | 'anticipation' | 'joy' | 'trust' | 'fear' | 'surprise' | 'sadness' | 'disgust' | 'neutral';
+/** Political flow classification — see CLAUDE.md domain concepts. */
+type PostFlow = 'pro-gov' | 'internal-critic' | 'internal-opponent' | 'external-opponent' | 'grey';
+type PostSeverity = 'low' | 'medium' | 'high' | 'critical';
+type PostStatus = 'normal' | 'warning' | 'critical';
+type PostAuthorityTier = 'nano' | 'micro' | 'macro' | 'mega';
 interface PostAuthor {
     name: string;
     handle?: string;
     avatarUrl?: string;
     verified?: boolean;
-    /** Optional follower / subscriber count — used in PostDetailsModal sidebar. */
+    /** Optional follower / subscriber count. */
     followers?: number;
-}
-interface PostMetrics {
-    views?: number;
-    likes?: number;
-    comments?: number;
-    shares?: number;
-    /** Estimated reach / potential audience. */
-    reach?: number;
-    /** Engagement rate as a 0..1 decimal (e.g. 0.034 = 3.4%). */
-    engagementRate?: number;
-}
-interface PostTag {
-    id: string;
-    label: string;
-    /** Optional CSS var (e.g. `--chart-1`) or hex color. Auto-assigned from label if omitted. */
-    color?: string;
+    /** Influence score 0..100 — used to render the authority chip on the card. */
+    authorityScore?: number;
+    /** Categorical author tier inferred from follower count + engagement. */
+    authorityTier?: PostAuthorityTier;
 }
 /**
- * Flags indicate which enrichments the product has attached to this post.
- * Consumers set these to show the matching chip in `<PostHeader>`.
+ * Editorial / broadcast actor. Used when the post originates from press, web, tv, radio
+ * instead of an individual social-platform account.
  */
-interface PostEnrichmentFlags {
-    ocr?: boolean;
-    transcript?: boolean;
-    aiAnalysis?: boolean;
-    commentCount?: number;
+interface PostOutlet {
+    name: string;
+    logoUrl?: string;
+    /** Editorial only: web domain ("hamshahrionline.ir"). */
+    domain?: string;
+    /** Editorial only: 0..100 SEO/credibility signal. */
+    domainAuthority?: number;
+    /** Broadcast only: TV channel or radio station ("شبکه ۱", "رادیو پیام"). */
+    channel?: string;
+    /** Broadcast only: program / show name. */
+    program?: string;
+    /** Editorial only: byline / journalist name. */
+    reporterName?: string;
 }
+/**
+ * Per-item ingestion status. Drives how `<PostMedia>` renders each item:
+ * - `ready`: image/video/audio is downloaded and viewable.
+ * - `loading`: the panel is fetching the media right now — render a shimmer.
+ * - `failed`: download failed — render retry placeholder.
+ * - `unavailable`: source has media but we never captured it — render "ذخیره نشده" placeholder.
+ */
+type PostMediaStatus = 'ready' | 'loading' | 'failed' | 'unavailable';
+/** Sensitive-content classifications. Used at media-level and post-level. */
+type PostMediaSensitivity = 'nsfw' | 'graphic' | 'spoiler';
 interface PostMediaItem {
     url: string;
     thumbnailUrl?: string;
-    /** Natural aspect ratio (width / height). If omitted, defaults to 1. */
+    /** Natural aspect ratio (width / height). Defaults to 1. */
     aspectRatio?: number;
     alt?: string;
-    type?: 'image' | 'video';
-    /** Duration in seconds for video. */
+    type?: 'image' | 'video' | 'audio';
+    /** Duration in seconds for video / audio. */
     duration?: number;
+    /** Ingestion status. Defaults to 'ready'. */
+    status?: PostMediaStatus;
+    /** Sensitivity tag — if set, the renderer blurs the media until revealed. */
+    sensitivity?: PostMediaSensitivity;
+    /** Audio only: URL of a waveform peaks file or a pre-rendered SVG / inline data URI. */
+    waveformUrl?: string;
+}
+/** Open Graph–style URL preview embedded inside a text body. */
+interface PostUrlPreview {
+    url: string;
+    domain: string;
+    title?: string;
+    description?: string;
+    thumbnailUrl?: string;
+}
+/**
+ * Sticker overlays found on Instagram stories (mentions, polls, location, music, etc.).
+ * Captured to preserve story context after crawling. Coordinates are normalized 0..1.
+ */
+interface StoryStickerOverlay {
+    /** Type of sticker — drives the icon and label in `<PostMediaStory>`. */
+    type: 'mention' | 'location' | 'hashtag' | 'music' | 'poll' | 'question' | 'time' | 'link' | 'other';
+    /** Human-readable label (e.g. "@digikala", "Tehran", "#خرید_آنلاین"). */
+    label: string;
+    /** Optional secondary text — for polls/questions, the question text. */
+    secondaryText?: string;
+    /** Normalized x/y position on the story canvas (0..1). */
+    x?: number;
+    y?: number;
+}
+/** Per-story metadata extracted at crawl time. */
+interface StoryItem {
+    /** The captured media (image or video). */
+    media: PostMediaItem;
+    /** OCR-extracted text from the story canvas (visible Persian/English text). */
+    ocrText?: string;
+    /** Transcript for video stories. */
+    transcript?: string;
+    /** Story sticker overlays (mentions, polls, location, etc.). */
+    stickers?: StoryStickerOverlay[];
+    /** Story publication time — distinct from the post wrapper's timestamp. */
+    publishedAt?: Date | string | number;
+    /** Outbound "swipe up" / link sticker URL. */
+    swipeUpUrl?: string;
+    /** Story view count (Stories use viewers, not likes). */
+    viewCount?: number;
 }
+/**
+ * Discriminated union of body shapes. The renderer in `<PostBody>` switches on `type`.
+ *
+ * Story-related variants:
+ *   - `story` — single ephemeral story (9:16, OCR text overlay, optional swipe-up link)
+ *   - `highlight` — saved-story collection under a titled cover; renders as a strip of stories
+ * Other social media coverage:
+ *   - `media-grid`, `media-carousel`, `video`, `audio`, `text` — generic
+ * Failure states:
+ *   - `missing-media`, `source-removed`
+ */
 type PostBodyData = {
     type: 'text';
     text: string;
+    urlPreview?: PostUrlPreview;
 } | {
     type: 'media-single';
     media: PostMediaItem;
     caption?: string;
+    urlPreview?: PostUrlPreview;
+} | {
+    type: 'media-grid';
+    items: PostMediaItem[];
+    caption?: string;
 } | {
     type: 'media-carousel';
     items: PostMediaItem[];
@@ -3340,85 +3112,141 @@ type PostBodyData = {
     type: 'video';
     media: PostMediaItem;
     caption?: string;
+} | {
+    type: 'audio';
+    media: PostMediaItem;
+    caption?: string;
+} | {
+    type: 'story';
+    story: StoryItem;
+    caption?: string;
+} | {
+    type: 'highlight';
+    title: string;
+    coverUrl?: string;
+    stories: StoryItem[];
+    caption?: string;
 } | {
     type: 'missing-media';
     caption?: string;
     reason?: string;
+} | {
+    type: 'source-removed';
+    archivedAt?: Date | string | number;
+    archiveUrl?: string;
+    caption?: string;
 };
-interface PostData {
-    id: string;
-    source: PostPlatform;
-    author: PostAuthor;
-    /** Post creation time. Accepts Date, ISO string, or unix ms. */
-    timestamp: Date | string | number;
-    body: PostBodyData;
-    metrics?: PostMetrics;
-    sentiment?: PostSentiment;
-    enrichments?: PostEnrichmentFlags;
-    /** User-defined category tags (topic, campaign, issue type). */
-    tags?: PostTag[];
-    /** Authority / influence score 0..100 — used to flag high-impact mentions. */
-    authorityScore?: number;
-    /** ISO language code detected for the post. */
-    language?: string;
-    /** URL to the post at the source platform (used by default "view at source" action). */
-    sourceUrl?: string;
+/**
+ * Unified metric envelope. Labels are platform-aware via `getMetricLabel(source, key, locale)`;
+ * the same `views` field is rendered as "بازدید" (Instagram/YouTube), "تماشا" (TikTok),
+ * "نمایش" (X), "بیننده" (TV), "شنونده" (Radio) depending on the post's source.
+ */
+interface PostMetrics {
+    /** Generic "consumption" metric — viewers / impressions / plays / page-views. */
+    views?: number;
+    likes?: number;
+    comments?: number;
+    /** Generic share count. */
+    shares?: number;
+    /** Reposts: X retweets, Threads reposts, Telegram forwards. */
+    reposts?: number;
+    /** Quote-with-comment: X quote-tweets, Threads quotes. */
+    quotes?: number;
+    /** Saves/bookmarks: IG, TikTok, LinkedIn. */
+    saves?: number;
+    /** Estimated reach / potential audience. */
+    reach?: number;
+    /** Engagement rate as 0..1 decimal (e.g. 0.034 = 3.4%). */
+    engagementRate?: number;
+    /** Broadcast: TV viewers / Radio listeners. Editorial: readers. One field, label per source. */
+    audience?: number;
+    /** Editorial: actual page-views distinct from `views`. */
+    reads?: number;
+    /** Editorial: SEO domain authority signal — also surfaced via `PostOutlet.domainAuthority`. */
+    domainAuthority?: number;
+    /** Reaction breakdown (Telegram emoji, LinkedIn 7-type, Facebook-style). */
+    reactions?: ReactionBreakdown;
 }
-interface PostAction {
+/**
+ * Typed reaction breakdown. Sparse — only platforms that emit a given reaction fill it.
+ *   LinkedIn fills like/celebrate/support/love/insightful/funny.
+ *   Facebook fills like/love/care/haha/wow/sad/angry.
+ *   Telegram fills `emoji` with the raw map.
+ */
+interface ReactionBreakdown {
+    like?: number;
+    love?: number;
+    celebrate?: number;
+    support?: number;
+    insightful?: number;
+    funny?: number;
+    /** Facebook-only — empathy reaction. */
+    care?: number;
+    /** Facebook-only — laughing reaction. */
+    haha?: number;
+    /** Facebook-only — surprised reaction. */
+    wow?: number;
+    /** Facebook-only — sad reaction. */
+    sad?: number;
+    /** Facebook-only — anger reaction. */
+    angry?: number;
+    /** Raw emoji → count map (Telegram channel reactions). */
+    emoji?: Record<string, number>;
+}
+interface PostTag {
     id: string;
     label: string;
-    icon: LucideIcon;
-    variant?: 'default' | 'danger';
-    onClick: (post: PostData) => void;
-    disabled?: boolean;
-    hidden?: boolean;
+    /** Optional CSS var (e.g. `--chart-1`) or hex color. Auto-assigned from label if omitted. */
+    color?: string;
 }
-interface PostCommentAuthor {
-    name: string;
-    handle?: string;
-    avatarUrl?: string;
-    verified?: boolean;
+/**
+ * Flags indicate which enrichments the product has attached to this post.
+ * Consumers set these to show the matching chip in `<PostHeader>`.
+ */
+interface PostEnrichmentFlags {
+    ocr?: boolean;
+    transcript?: boolean;
+    aiAnalysis?: boolean;
+    commentCount?: number;
 }
-interface PostComment {
-    id: string;
-    author: PostCommentAuthor;
-    text: string;
-    timestamp: Date | string | number;
-    sentiment?: PostSentiment;
-    likes?: number;
-    replies?: PostComment[];
-    /** Pinned by post author (Instagram, YouTube). */
+/**
+ * Contextual flags surfaced as chips or banners on the card. Independent of media-level status.
+ */
+interface PostFlags {
     pinned?: boolean;
-    /** Indicates this is a reply from the original post author. */
-    authorReply?: boolean;
-}
-type PostEmotion = 'anger' | 'anticipation' | 'joy' | 'trust' | 'fear' | 'surprise' | 'sadness' | 'disgust' | 'neutral';
-type PostIntent = 'complaint' | 'praise' | 'question' | 'announcement' | 'comparison' | 'opinion' | 'info';
-interface PostAiEntity {
-    text: string;
-    type: 'person' | 'brand' | 'place' | 'product' | 'event' | 'organization';
-}
-interface PostAiAnalysis {
-    /** Auto-generated summary of the post. */
-    summary?: string;
-    /** Key topics mentioned in the post. */
-    topics?: string[];
-    /** Named entities detected. */
-    entities?: PostAiEntity[];
-    /** Primary intent classification. */
-    intent?: PostIntent;
-    /** 9-class emotion distribution (raw counts or normalized). */
-    emotions?: Partial<Record<PostEmotion, number>>;
-    /** Flagged risks / sensitive content categories. */
-    risks?: string[];
-    /** Influence tier estimate for the author. */
-    influenceTier?: 'nano' | 'micro' | 'macro' | 'mega';
-    /** Model confidence 0..1 for overall analysis. */
-    confidence?: number;
-    /** Analysis generation timestamp. */
-    generatedAt?: Date | string | number;
+    edited?: boolean;
+    /** Optional edit count, surfaced in tooltip. */
+    editCount?: number;
+    sponsored?: boolean;
+    /** Post was deleted at source after we ingested it. */
+    deletedAtSource?: boolean;
+    /** Snapshot URL to our archived copy. */
+    archivedSnapshotUrl?: string;
+    /** Post-level sensitivity (distinct from per-media `sensitivity`). */
+    sensitive?: PostMediaSensitivity;
+}
+/** Cluster / topic membership — links the post to a parent analytical grouping. */
+interface PostCluster {
+    id: string;
+    label: string;
+    tone?: 'brand' | 'neutral' | 'warning';
+}
+/** "X reposted at Y" wrapper info. */
+interface PostRepostInfo {
+    by: PostAuthor;
+    at: Date | string | number;
+    /** Optional retweet-with-comment / Telegram forward note. */
+    comment?: string;
+}
+/** Position info when a post belongs to a multi-post thread. */
+interface PostThreadInfo {
+    threadId: string;
+    /** 1-indexed position in the thread. */
+    position: number;
+    total: number;
+    /** Optional id of the next thread post — used to draw the connector to the next visible card. */
+    nextId?: string;
 }
-/** Platform-specific metadata, discriminated by `platform` (matches `PostData.source`). */
 type PlatformMetadata = {
     platform: 'instagram';
     postType?: 'feed' | 'reel' | 'story' | 'carousel' | 'igtv';
@@ -3429,7 +3257,6 @@ type PlatformMetadata = {
     };
     saveCount?: number;
     collaborators?: string[];
-    /** Hashtags used in the post. */
     hashtags?: string[];
 } | {
     platform: 'twitter';
@@ -3440,7 +3267,6 @@ type PlatformMetadata = {
     quoteCount?: number;
     bookmarkCount?: number;
     isThread?: boolean;
-    /** Count of additional posts in the thread. */
     threadLength?: number;
 } | {
     platform: 'youtube';
@@ -3485,7 +3311,184 @@ type PlatformMetadata = {
     replyControls?: 'anyone' | 'followed' | 'mentioned';
     repostCount?: number;
     quoteCount?: number;
+} | {
+    platform: 'facebook';
+    postType?: 'post' | 'photo' | 'video' | 'reel' | 'story' | 'event' | 'shared';
+    reactions?: {
+        like?: number;
+        love?: number;
+        care?: number;
+        haha?: number;
+        wow?: number;
+        sad?: number;
+        angry?: number;
+    };
+    shareCount?: number;
+    /** Page name if posted on behalf of a page (vs personal profile). */
+    pageName?: string;
+    pageFollowers?: number;
+} | {
+    platform: 'tv';
+    airDate?: Date | string | number;
+    durationSec?: number;
+    programType?: 'news' | 'talk-show' | 'documentary' | 'interview' | 'live' | 'other';
+    viewers?: number;
+    replays?: number;
+} | {
+    platform: 'radio';
+    airDate?: Date | string | number;
+    durationSec?: number;
+    programType?: 'news' | 'talk-show' | 'music' | 'interview' | 'live' | 'other';
+    listeners?: number;
+} | {
+    platform: 'press';
+    printedAt?: Date | string | number;
+    /** Print edition: issue / page reference. */
+    issue?: string;
+    pageNumber?: number;
+    /** Optional AVE (Ad Value Equivalent) — common press metric. */
+    adValueEquivalent?: number;
+    hashtags?: string[];
+} | {
+    platform: 'web';
+    contentType?: 'blog' | 'forum' | 'news' | 'review' | 'comment' | 'other';
+    /** Reference to a parent thread / discussion if part of one. */
+    threadUrl?: string;
+    hashtags?: string[];
 };
+interface PostData {
+    id: string;
+    /**
+     * Source platform — full 11-source taxonomy (social + broadcast + editorial).
+     * Header layout and metric labels dispatch on this value via `sourceCategory(source)`.
+     */
+    source: PostSource;
+    /** Headline (editorial), program/segment (broadcast), video title (YouTube). */
+    title?: string;
+    /** Present for social posts; optional for editorial/broadcast where `outlet` is the actor. */
+    author?: PostAuthor;
+    /** Editorial/broadcast outlet — used for press, web, tv, radio header variants. */
+    outlet?: PostOutlet;
+    body: PostBodyData;
+    /** Post creation / publish / air time. Accepts Date, ISO string, or unix ms. */
+    timestamp: Date | string | number;
+    metrics?: PostMetrics;
+    sentiment?: PostSentiment;
+    /** Dominant emotion (9-class) — surfaced as a chip on the card. */
+    emotion?: PostEmotion;
+    /** Political flow classification — surfaced as a chip on the card. */
+    flow?: PostFlow;
+    severity?: PostSeverity;
+    enrichments?: PostEnrichmentFlags;
+    flags?: PostFlags;
+    cluster?: PostCluster;
+    /** User-defined category tags. */
+    tags?: PostTag[];
+    /** @deprecated Use `author.authorityScore` instead. Kept for backward compat. */
+    authorityScore?: number;
+    /** ISO language code detected for the post. */
+    language?: string;
+    /** URL to the post at the source platform. */
+    sourceUrl?: string;
+    /** Quoted/embedded post (X quote-tweets, Threads quotes, Telegram forwards-with-comment). */
+    quoted?: PostData;
+    /** Parent post when this is a reply. */
+    parent?: PostData;
+    /** Repost wrapper info — when present, render "X reposted" header strip above the card. */
+    reposted?: PostRepostInfo;
+    /** Thread position info — when present, draw the thread-connector hairline. */
+    thread?: PostThreadInfo;
+    /** Platform-specific metadata block (discriminated by source). */
+    platformMeta?: PlatformMetadata;
+}
+interface PostAction {
+    id: string;
+    label: string;
+    icon: LucideIcon;
+    variant?: 'default' | 'danger';
+    onClick: (post: PostData) => void;
+    disabled?: boolean;
+    hidden?: boolean;
+}
+/** Bulk action surfaced in the floating bottom bar when posts are selected. */
+interface PostBulkAction {
+    id: string;
+    label: string;
+    icon: LucideIcon;
+    variant?: 'default' | 'danger' | 'brand';
+    /** Optional sub-options — rendered as dropdown menu when present. */
+    options?: Array<{
+        id: string;
+        label: string;
+        icon?: LucideIcon;
+    }>;
+    onClick: (selectedIds: string[], optionId?: string) => void;
+    disabled?: boolean;
+    hidden?: boolean;
+}
+interface PostCommentAuthor {
+    name: string;
+    handle?: string;
+    avatarUrl?: string;
+    verified?: boolean;
+    /** Optional badge: "Moderator", "Subscriber", "Author", etc. — surfaced as a chip next to the name. */
+    badge?: string;
+}
+interface PostComment {
+    id: string;
+    author: PostCommentAuthor;
+    text: string;
+    timestamp: Date | string | number;
+    sentiment?: PostSentiment;
+    likes?: number;
+    replies?: PostComment[];
+    /**
+     * Total reply count (may exceed `replies.length` if pagination caps the nested
+     * replies). Drives the "نمایش ۲۳ پاسخ" affordance.
+     */
+    replyCount?: number;
+    /** Pinned by post author (Instagram, YouTube). */
+    pinned?: boolean;
+    /** Indicates this is a reply from the original post author. */
+    authorReply?: boolean;
+    /** Comment was edited at source — show ویرایش‌شده chip. */
+    edited?: boolean;
+    /** ISO language code; enables translation toggle when different from current locale. */
+    language?: string;
+    /** Hidden by source moderator / shadow-banned. */
+    hiddenByModerator?: boolean;
+    /** Typed reaction breakdown (Facebook 7-type, LinkedIn 7-type, YouTube hearts, etc.). */
+    reactions?: ReactionBreakdown;
+    /** AI-detected toxicity / hate-speech / spam score (0..1). Surfaces a flag chip when set. */
+    toxicityScore?: number;
+    /** Pre-translated body (if cached). */
+    translatedText?: string;
+}
+type PostIntent = 'complaint' | 'praise' | 'question' | 'announcement' | 'comparison' | 'opinion' | 'info';
+interface PostAiEntity {
+    text: string;
+    type: 'person' | 'brand' | 'place' | 'product' | 'event' | 'organization';
+}
+interface PostAiAnalysis {
+    /** Auto-generated summary of the post. */
+    summary?: string;
+    /** Key topics mentioned in the post. */
+    topics?: string[];
+    /** Named entities detected. */
+    entities?: PostAiEntity[];
+    /** Primary intent classification. */
+    intent?: PostIntent;
+    /** 9-class emotion distribution (raw counts or normalized). */
+    emotions?: Partial<Record<PostEmotion, number>>;
+    /** Flagged risks / sensitive content categories. */
+    risks?: string[];
+    /** Influence tier estimate for the author. */
+    influenceTier?: PostAuthorityTier;
+    /** Model confidence 0..1 for overall analysis. */
+    confidence?: number;
+    /** Analysis generation timestamp. */
+    generatedAt?: Date | string | number;
+}
 /** Extended post details — optionally attached to PostData when fetching full view. */
 interface PostDetails {
     comments?: PostComment[];
@@ -3498,25 +3501,34 @@ interface PostDetails {
     platformMeta?: PlatformMetadata;
 }
 
+declare function defaultActions(handlers?: {
+    onOpenDetails?: (post: PostData) => void;
+}): PostAction[];
 declare const postCardVariants: (props?: ({
-    density?: "compact" | "comfortable" | null | undefined;
+    view?: "grid" | "compact" | "comfortable" | null | undefined;
     selected?: boolean | null | undefined;
+    active?: boolean | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 interface PostCardProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, 'onSelect'>, VariantProps<typeof postCardVariants> {
     post: PostData;
+    /** Layout mode. Replaces the legacy `density` prop. */
+    view?: PostView;
+    /** @deprecated Use `view` instead. */
     density?: PostDensity;
     selected?: boolean;
+    /** True when the card represents the post currently open in the details drawer. */
+    active?: boolean;
     read?: boolean;
     actions?: PostAction[];
+    selectable?: boolean;
     onOpen?: (post: PostData) => void;
     onSelect?: (post: PostData, selected: boolean) => void;
-    selectable?: boolean;
-    /** Fired when user clicks the details action (Maximize2 icon). Wires up the default details action. */
     onOpenDetails?: (post: PostData) => void;
+    onOpenQuoted?: (post: PostData) => void;
+    onRetryMedia?: (item: PostMediaItem) => void;
+    onClusterClick?: (cluster: NonNullable<PostData['cluster']>) => void;
+    onAuthorClick?: (authorId: string | undefined) => void;
 }
-declare function defaultActions(handlers?: {
-    onOpenDetails?: (post: PostData) => void;
-}): PostAction[];
 declare const PostCard: React$1.ForwardRefExoticComponent<PostCardProps & React$1.RefAttributes<HTMLDivElement>>;
 
 declare const postHeaderVariants: (props?: ({
@@ -3534,6 +3546,25 @@ interface PostHeaderProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, '
 }
 declare const PostHeader: React$1.ForwardRefExoticComponent<PostHeaderProps & React$1.RefAttributes<HTMLDivElement>>;
 
+interface PostHeaderBroadcastProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    source: 'tv' | 'radio';
+    outlet: PostOutlet;
+    timestamp: Date | string | number;
+    enrichments?: PostEnrichmentFlags;
+    density?: PostDensity;
+}
+declare const PostHeaderBroadcast: React$1.ForwardRefExoticComponent<PostHeaderBroadcastProps & React$1.RefAttributes<HTMLDivElement>>;
+interface PostHeaderEditorialProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    source: 'press' | 'web';
+    outlet: PostOutlet;
+    timestamp: Date | string | number;
+    enrichments?: PostEnrichmentFlags;
+    density?: PostDensity;
+    /** Optional author byline (for press articles authored by an individual journalist). */
+    byline?: PostAuthor;
+}
+declare const PostHeaderEditorial: React$1.ForwardRefExoticComponent<PostHeaderEditorialProps & React$1.RefAttributes<HTMLDivElement>>;
+
 /**
  * Aspect-ratio helpers for post media.
  *
@@ -3560,6 +3591,98 @@ interface PostBodyProps extends React$1.HTMLAttributes<HTMLDivElement> {
 }
 declare const PostBody: React$1.ForwardRefExoticComponent<PostBodyProps & React$1.RefAttributes<HTMLDivElement>>;
 
+/**
+ * Rule: never vertically center an `<img>` with `mx-auto` + `h-full`. `<img>` is
+ * `display: inline` by default so `mx-auto` is a no-op and the image rests on the
+ * text baseline. Use the centered-container pattern below.
+ */
+declare const CENTERED_CONTAINER_CLS = "relative w-full overflow-hidden rounded-md bg-muted flex items-center justify-center";
+/**
+ * Foreground image classes. `block` removes the baseline inline behavior;
+ * `max-*` + `w-auto h-auto` + `object-contain` fit naturally inside the container.
+ */
+declare const FOREGROUND_IMG_CLS = "relative block max-h-full max-w-full w-auto h-auto object-contain";
+declare const BlurBackdrop: React$1.FC<{
+    src?: string;
+}>;
+type PostMediaPlaceholderVariant = 'loading' | 'failed' | 'unavailable';
+interface PostMediaPlaceholderProps {
+    variant: PostMediaPlaceholderVariant;
+    /** Optional reason / human note. */
+    reason?: string;
+    /** CSS aspect ratio for the placeholder box (e.g. `"4 / 5"`). Defaults to `"4 / 5"`. */
+    aspectRatio?: string;
+    /** Optional cap. */
+    maxHeight?: string;
+    /** Retry handler — only rendered when `variant === 'failed'`. */
+    onRetry?: () => void;
+    className?: string;
+}
+declare const PostMediaPlaceholder: React$1.ForwardRefExoticComponent<PostMediaPlaceholderProps & React$1.RefAttributes<HTMLDivElement>>;
+interface PostMediaSourceRemovedProps {
+    /** Optional URL to our archive snapshot. */
+    archiveUrl?: string;
+    /** Optional date the snapshot was taken. */
+    archivedAt?: Date | string | number;
+    className?: string;
+}
+declare const PostMediaSourceRemoved: React$1.ForwardRefExoticComponent<PostMediaSourceRemovedProps & React$1.RefAttributes<HTMLDivElement>>;
+declare const SENSITIVITY_LABEL: Record<string, string>;
+declare const PostMediaSensitiveOverlay: React$1.FC<{
+    sensitivity: NonNullable<PostMediaItem['sensitivity']>;
+    onReveal: () => void;
+}>;
+declare const PostMediaSingle: React$1.FC<{
+    item: PostMediaItem;
+    context: AspectContext;
+    onRetry?: (item: PostMediaItem) => void;
+    className?: string;
+}>;
+declare const PostMediaGrid: React$1.FC<{
+    items: PostMediaItem[];
+    context: AspectContext;
+    onRetry?: (item: PostMediaItem) => void;
+    className?: string;
+}>;
+declare const PostMediaCarousel: React$1.FC<{
+    items: PostMediaItem[];
+    context: AspectContext;
+    onRetry?: (item: PostMediaItem) => void;
+    className?: string;
+}>;
+declare const PostMediaVideo: React$1.FC<{
+    item: PostMediaItem;
+    context: AspectContext;
+    onRetry?: (item: PostMediaItem) => void;
+    className?: string;
+}>;
+declare const PostMediaAudio: React$1.FC<{
+    item: PostMediaItem;
+    context: AspectContext;
+    className?: string;
+}>;
+declare const PostMediaStory: React$1.FC<{
+    story: StoryItem;
+    context: AspectContext;
+    /** When true, no fixed 9:16 frame — used inside Highlight strip cells. */
+    fillCell?: boolean;
+    className?: string;
+}>;
+declare const PostMediaHighlight: React$1.FC<{
+    title: string;
+    coverUrl?: string;
+    stories: StoryItem[];
+    context: AspectContext;
+    className?: string;
+}>;
+interface PostMediaProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    body: PostBodyData;
+    context: AspectContext;
+    /** Retry callback for failed media items. */
+    onRetry?: (item: PostMediaItem) => void;
+}
+declare const PostMedia: React$1.ForwardRefExoticComponent<PostMediaProps & React$1.RefAttributes<HTMLDivElement>>;
+
 interface PostActionsProps extends React$1.HTMLAttributes<HTMLDivElement> {
     post: PostData;
     actions: PostAction[];
@@ -3579,10 +3702,94 @@ interface PostMetadataProps extends React$1.HTMLAttributes<HTMLDivElement> {
 }
 declare const PostMetadata: React$1.ForwardRefExoticComponent<PostMetadataProps & React$1.RefAttributes<HTMLDivElement>>;
 
+interface PostSignalsProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    sentiment?: PostSentiment;
+    emotion?: EmotionKey;
+    flow?: FlowKey;
+    severity?: PostSeverity;
+    cluster?: PostCluster;
+    /** ISO language code (rendered as uppercase chip when not 'fa'). */
+    language?: string;
+    /** When true, hide emotion + flow + cluster + language to keep the row scannable in compact density. */
+    compact?: boolean;
+    /** Click handler on the cluster chip — typically filters the list. */
+    onClusterClick?: (cluster: PostCluster) => void;
+}
+/**
+ * Domain-signal chip row: sentiment, emotion, flow, severity, cluster, language.
+ * Rendered in the `<PostCard>` footer. Designed to wrap when narrow.
+ */
+declare const PostSignals: React$1.ForwardRefExoticComponent<PostSignalsProps & React$1.RefAttributes<HTMLDivElement>>;
+
+interface PostRepostHeaderProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    reposted: PostRepostInfo;
+    /** Optional click handler on the reposter chip — typically opens the reposter's profile. */
+    onAuthorClick?: (authorId: string | undefined) => void;
+}
+/**
+ * Slim wrapper strip rendered above a `<PostCard>` when the post is surfaced through
+ * a repost / retweet / forward. Matches the X, Threads, Telegram-channel-forward UX.
+ */
+declare const PostRepostHeader: React$1.ForwardRefExoticComponent<PostRepostHeaderProps & React$1.RefAttributes<HTMLDivElement>>;
+
+interface PostQuotedEmbedProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    /** The post being quoted / referenced. */
+    post: PostData;
+    /** Click handler — typically navigates to the quoted post's details surface. */
+    onOpen?: (post: PostData) => void;
+}
+/**
+ * Nested compact card rendered inside a `<PostCard>` body when the post quotes,
+ * embeds, or replies to another post. Read-only — no metrics, no action buttons,
+ * no recursive embeds. Matches the X quote-tweet stacking pattern.
+ *
+ * RTL: indented from the inline-start via `ms-*` (visually right-indent in RTL).
+ */
+declare const PostQuotedEmbed: React$1.ForwardRefExoticComponent<PostQuotedEmbedProps & React$1.RefAttributes<HTMLDivElement>>;
+
+interface PostThreadConnectorProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    thread: PostThreadInfo;
+    /** When true, draws the connecting hairline that visually links this card to the next thread post. */
+    showLine?: boolean;
+}
+/**
+ * Renders the thread-position chip and the optional vertical hairline that connects
+ * consecutive posts in the same thread. The hairline is positioned on the inline-start
+ * edge of the card (right edge in RTL) and is purely visual — no interaction.
+ *
+ * The parent `<PostCard>` is responsible for rendering this in a `relative` container
+ * so the absolute hairline can anchor to the card's full height.
+ */
+declare const PostThreadConnector: React$1.ForwardRefExoticComponent<PostThreadConnectorProps & React$1.RefAttributes<HTMLDivElement>>;
+
+interface PostCrisisBannerProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    severity: PostSeverity;
+    /** Optional override label — defaults to the Persian severity name. */
+    label?: string;
+}
+/**
+ * Slim banner strip rendered at the top of a `<PostCard>` to call attention to a
+ * crisis / high-severity mention. Animates a pulse dot for `critical`. Subtle
+ * by design — not a full-card red bleed, so the post stays scannable.
+ */
+declare const PostCrisisBanner: React$1.ForwardRefExoticComponent<PostCrisisBannerProps & React$1.RefAttributes<HTMLDivElement>>;
+
+interface PostUrlPreviewProps extends React$1.HTMLAttributes<HTMLAnchorElement> {
+    preview: PostUrlPreview;
+    /** Compact layout (no description, smaller thumbnail). */
+    compact?: boolean;
+}
+
+type PostGroupBy = 'none' | 'platform' | 'sentiment' | 'date';
+type PostSortBy = 'newest' | 'oldest' | 'engagement' | 'authority' | 'severity';
 interface PostListProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, 'onSelect'> {
     posts: PostData[];
-    /** Controlled density. If omitted, the list manages its own state (persisted to localStorage). */
+    /** Controlled view. If omitted, the list manages its own state (persisted to localStorage). */
+    view?: PostView;
+    onViewChange?: (view: PostView) => void;
+    /** @deprecated Use `view` instead. */
     density?: PostDensity;
+    /** @deprecated Use `onViewChange` instead. */
     onDensityChange?: (density: PostDensity) => void;
     /** ID of the currently open/selected post (for URL deep-linking). */
     activeId?: string;
@@ -3594,16 +3801,105 @@ interface PostListProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, 'on
     onOpen?: (post: PostData) => void;
     /** Fired when the user triggers the default "view details" action on any card. */
     onOpenDetails?: (post: PostData) => void;
+    onOpenQuoted?: (post: PostData) => void;
+    onRetryMedia?: (item: PostMediaItem) => void;
+    onClusterClick?: (cluster: NonNullable<PostData['cluster']>) => void;
     /** Per-post action set. If omitted, each card uses its defaults. */
     actions?: PostAction[];
-    /** Render the density toggle in the toolbar. Defaults to true. */
+    /** Bulk actions surfaced in the floating bar when posts are selected. */
+    bulkActions?: PostBulkAction[];
+    /** Group rendering: split the list into sticky-header sections. */
+    groupBy?: PostGroupBy;
+    /** Client-side sort applied to `posts` before render. */
+    sortBy?: PostSortBy;
+    /** Soft search filter — matches body text or title (case-insensitive). */
+    searchQuery?: string;
+    /** Render the toolbar (view toggle + extras). Defaults to true. */
     showToolbar?: boolean;
-    /** Custom toolbar content rendered next to the density toggle. */
+    /** Custom toolbar content rendered next to the view toggle. */
     toolbarExtra?: React$1.ReactNode;
+    /** Loading state — replaces list with skeleton or custom node. */
+    isLoading?: boolean;
+    loadingState?: React$1.ReactNode;
+    /** Error state — replaces list when set. */
+    error?: unknown;
+    errorState?: React$1.ReactNode;
+    /** Empty state — shown when `posts.length === 0` after filtering. */
+    emptyState?: React$1.ReactNode;
+    /** Hide the floating bulk action bar even when posts are selected. */
+    hideBulkBar?: boolean;
 }
 declare const PostList: React$1.ForwardRefExoticComponent<PostListProps & React$1.RefAttributes<HTMLDivElement>>;
 
-type PostDetailsTab = 'post' | 'comments' | 'analysis' | 'transcript';
+interface PostBulkActionBarProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, 'onClick'> {
+    selectedCount: number;
+    selectedIds: string[];
+    actions?: PostBulkAction[];
+    onClear?: () => void;
+}
+/**
+ * Floating bulk-action bar — appears at the bottom of the viewport when one or
+ * more posts are selected in `<PostList>`. Matches the Gmail / Linear / Notion
+ * selection bar pattern. Dismiss with Esc or by clicking the clear button.
+ */
+declare const PostBulkActionBar: React$1.ForwardRefExoticComponent<PostBulkActionBarProps & 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$1 = 'post' | 'comments' | 'analysis' | 'transcript';
 interface PostDetailsModalProps {
     /** Controls modal open state. */
     open: boolean;
@@ -3621,7 +3917,7 @@ interface PostDetailsModalProps {
     /** Fires when user clicks "retry" on the error panel. */
     onRetry?: () => void;
     /** Which tab to open first @default "post" */
-    defaultTab?: PostDetailsTab;
+    defaultTab?: PostDetailsTab$1;
     /** Dialog size. @default "lg" (~1024px) */
     size?: 'md' | 'lg' | 'xl';
     /** Show the bookmark toggle. When `onBookmark` is set, the button appears. */
@@ -3634,6 +3930,99 @@ interface PostDetailsModalProps {
 }
 declare const PostDetailsModal: React$1.FC<PostDetailsModalProps>;
 
+type PostDetailsTab = 'post' | 'comments' | 'analysis' | 'transcript';
+interface PostDetailsDrawerProps {
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    post: PostData;
+    details?: PostDetails;
+    /** Details are being fetched asynchronously — show loading state in tabs. */
+    isLoadingDetails?: boolean;
+    bookmarked?: boolean;
+    onBookmark?: (post: PostData, next: boolean) => void;
+    onCopyLink?: (post: PostData, url: string) => void;
+    onOpenSource?: (post: PostData) => void;
+    onRetryMedia?: (item: PostMediaItem) => void;
+    /** Navigate to the next post in the parent list (fires when j is pressed). */
+    onNext?: () => void;
+    /** Navigate to the previous post in the parent list (fires when k is pressed). */
+    onPrevious?: () => void;
+    defaultTab?: PostDetailsTab;
+    /** Custom action node rendered next to the default header actions. */
+    extraActions?: React$1.ReactNode;
+    /** Optional translation handler. When provided, a "نمایش ترجمه" toggle appears on the post tab. */
+    onTranslate?: (post: PostData) => Promise<string> | string;
+    /** Optional like-comment handler. */
+    onLikeComment?: (commentId: string) => void;
+}
+/**
+ * Right-aligned side panel for inspecting a post in depth. Replaces the legacy
+ * `<PostDetailsModal>` as the canonical detail surface on desktop. The modal
+ * stays as a mobile-only fallback.
+ *
+ * Keyboard:
+ *   - Esc → close (handled by Sheet)
+ *   - j / ArrowDown → onNext
+ *   - k / ArrowUp → onPrevious
+ */
+declare const PostDetailsDrawer: React$1.ForwardRefExoticComponent<PostDetailsDrawerProps & React$1.RefAttributes<HTMLDivElement>>;
+
+type SupportedMetricLocale = 'fa' | 'en';
+type MetricKey = keyof PostMetrics;
+/**
+ * Resolve a metric label for a given source + key + locale.
+ *
+ * Lookup order:
+ *   1. Source-specific override (e.g. tiktok.views → "تماشا")
+ *   2. Default for that locale (e.g. views → "بازدید")
+ *
+ * Never returns `undefined` — falls back to default labels.
+ */
+declare function getMetricLabel(source: PostSource, key: MetricKey, locale?: SupportedMetricLocale): string;
+
+/**
+ * Per-source metadata used by `<PostHeader>`, `<PostMetrics>`, badges, and the source-aware
+ * default actions. This is the single source of truth — adding a new platform = adding
+ * one entry here + one CSS var + one label entry in `post-metric-labels.ts`.
+ *
+ * Brand colors are referenced as CSS variables (`--social-platform-*`) and resolved at
+ * runtime so the dark/light theme can adapt where needed (twitter, threads, press, web).
+ */
+type SourceIconSource = 
+/** Icon comes from the brand-SVG set in `<SocialPlatformBadge>` (7 social platforms). */
+{
+    kind: 'social-brand';
+}
+/** Icon is a generic Lucide glyph (broadcast / editorial sources). */
+ | {
+    kind: 'lucide';
+    icon: LucideIcon;
+};
+interface PostSourceConfig {
+    /** English label, displayed when `showLabel` is on. */
+    label: string;
+    /** Persian (fa) label, for fa-locale headers and tooltips. */
+    labelFa: string;
+    /** Category: drives header layout switch. */
+    category: PostSourceCategory;
+    /** CSS variable name (without the `var()` wrapper). */
+    colorVar: string;
+    /** How to render the icon for this source. */
+    icon: SourceIconSource;
+    /**
+     * Default metric order — which metric keys to show by default and in what order.
+     * Consumers can override per-card via PostMetadata's `metricsOrder` prop.
+     */
+    defaultMetrics: ReadonlyArray<keyof PostMetrics>;
+}
+/** Look up the per-source config block. */
+declare function getPostSourceConfig(source: PostSource): PostSourceConfig;
+/**
+ * Convenience: read the brand color CSS variable for a source.
+ * Use as: `style={{ color: getSourceColorVar('instagram') }}` → `var(--social-platform-instagram)`.
+ */
+declare function getSourceColorVar(source: PostSource): string;
+
 declare const profileCardVariants: (props?: ({
     variant?: "default" | "transparent" | "dark" | null | undefined;
     size?: "sm" | "md" | "lg" | null | undefined;
@@ -4000,7 +4389,10 @@ declare namespace ScrollBar {
     var displayName: string;
 }
 
-declare const Select: React$1.FC<SelectPrimitive.SelectProps>;
+declare const Select: {
+    ({ dir, ...props }: React$1.ComponentProps<typeof SelectPrimitive.Root>): react_jsx_runtime.JSX.Element;
+    displayName: string;
+};
 declare const SelectGroup: React$1.ForwardRefExoticComponent<SelectPrimitive.SelectGroupProps & React$1.RefAttributes<HTMLDivElement>>;
 declare const SelectValue: React$1.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectValueProps & React$1.RefAttributes<HTMLSpanElement>, "ref"> & VariantProps<(props?: ({
     size?: "xs" | "sm" | "md" | "lg" | "xl" | null | undefined;
@@ -4015,61 +4407,9 @@ declare const SelectTrigger: React$1.ForwardRefExoticComponent<Omit<SelectPrimit
 declare const SelectScrollUpButton: React$1.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectScrollUpButtonProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 declare const SelectScrollDownButton: React$1.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectScrollDownButtonProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 declare const SelectContent: React$1.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectContentProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
-declare const SelectLabel: React$1.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectLabelProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
-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>>;
+declare const SelectLabel: React$1.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectLabelProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
+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>>;
 
 type SidebarContextProps = {
     state: 'expanded' | 'collapsed';
@@ -4278,40 +4618,7 @@ 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 function Slider({ className, defaultValue, value, min, max, dir, 'aria-label': ariaLabel, 'aria-labelledby': ariaLabelledBy, ...props }: React$1.ComponentProps<typeof SliderPrimitive.Root>): react_jsx_runtime.JSX.Element;
 declare namespace Slider {
     var displayName: string;
 }
@@ -4393,7 +4700,7 @@ declare namespace TableSortHeader {
     var displayName: string;
 }
 
-declare const Tabs: React$1.ForwardRefExoticComponent<TabsPrimitive.TabsProps & React$1.RefAttributes<HTMLDivElement>>;
+declare const Tabs: React$1.ForwardRefExoticComponent<Omit<TabsPrimitive.TabsProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 interface TabsListProps extends React$1.ComponentPropsWithoutRef<typeof TabsPrimitive.List> {
     /** Visual variant */
     variant?: 'default' | 'underline' | 'outline';
@@ -4578,6 +4885,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;
@@ -4835,6 +5151,16 @@ interface MultiSelectProps {
     emptyMessage?: string;
     /** Search placeholder */
     searchPlaceholder?: string;
+    /** Accessible label. Falls back to the resolved placeholder when omitted. */
+    'aria-label'?: string;
+    /** id of an external label element that names this control. */
+    'aria-labelledby'?: string;
+    /** Marks the trigger as invalid (e.g. when wired through `<FormControl>`). */
+    'aria-invalid'?: boolean | 'true' | 'false';
+    /** id(s) of element(s) describing the trigger (typically a `<FormMessage>`). */
+    'aria-describedby'?: string;
+    /** id of the trigger element — set by `<FormControl>` to wire `<FormLabel htmlFor>`. */
+    id?: string;
 }
 declare const MultiSelect: React$1.ForwardRefExoticComponent<MultiSelectProps & React$1.RefAttributes<HTMLDivElement>>;
 
@@ -4911,118 +5237,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 +5492,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 +5542,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 +5694,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.
@@ -5552,52 +5722,20 @@ interface PartoWordCloudProps {
     isLoading?: boolean;
     /** Accessible label describing the chart content */
     ariaLabel?: string;
+    /** Locale for the empty-state message @default 'fa' */
+    locale?: SupportedLocale;
+    /**
+     * Render a small caption below the cloud explaining that word size
+     * encodes frequency. Helps colorblind / sighted-but-confused users —
+     * word color is decorative (palette rotation), not semantic. @default `false`
+     */
+    legend?: boolean;
 }
-declare function PartoWordCloud({ words, width: widthProp, height: heightProp, className, minFontSize, maxFontSize, padding, spiral, rotate, random, fontWeight, onWordClick, isLoading, ariaLabel, }: PartoWordCloudProps): react_jsx_runtime.JSX.Element;
+declare function PartoWordCloud({ words, width: widthProp, height: heightProp, className, minFontSize, maxFontSize, padding, spiral, rotate, random, fontWeight, onWordClick, isLoading, ariaLabel, locale, legend, }: PartoWordCloudProps): react_jsx_runtime.JSX.Element;
 declare namespace PartoWordCloud {
     var displayName: string;
 }
 
-interface PartoAreaChartProps {
-    /** Row-oriented data: [{ name: "فروردین", series1: 50, series2: 30 }] */
-    data: Array<Record<string, any>>;
-    /** Keys for each area series (e.g. ['فروش', 'سود']) */
-    dataKeys: string[];
-    /** Field name for X axis (default: 'name') */
-    xAxisKey?: string;
-    /** Curve type */
-    curve?: 'monotone' | 'linear' | 'natural' | 'step';
-    /** Line width */
-    strokeWidth?: number;
-    /** Area fill opacity */
-    fillOpacity?: number;
-    /** Show dots on data points */
-    showDots?: boolean;
-    /** Show horizontal grid lines */
-    enableGridY?: boolean;
-    /** Show vertical grid lines */
-    enableGridX?: boolean;
-    /** Chart margins */
-    margin?: {
-        top?: number;
-        right?: number;
-        bottom?: number;
-        left?: number;
-    };
-    /** Custom X axis config */
-    axisBottom?: Record<string, any> | null;
-    /** Custom Y axis config */
-    axisLeft?: Record<string, any> | null;
-    /** Custom tooltip formatter */
-    tooltipFormatter?: (name: string, value: number) => React$1.ReactNode;
-    className?: string;
-    isLoading?: boolean;
-    ariaLabel?: string;
-    /** Additional Recharts AreaChart props */
-    chartProps?: Record<string, any>;
-}
-declare const PartoAreaChart: React$1.ForwardRefExoticComponent<PartoAreaChartProps & React$1.RefAttributes<HTMLDivElement>>;
-
 /**
  * PartoScatterChart — x/y scatter with optional bubble sizing (z) and
  * per-point color override. Wraps Recharts ScatterChart with theme-aware
@@ -5656,6 +5794,11 @@ interface PartoScatterChartProps {
     className?: string;
     isLoading?: boolean;
     ariaLabel?: string;
+    /**
+     * Render a legend below the chart. Only meaningful when `groupKey` is set —
+     * the legend lists each group with its assigned color. @default `false`
+     */
+    legend?: boolean;
 }
 declare const PartoScatterChart: React$1.ForwardRefExoticComponent<PartoScatterChartProps & React$1.RefAttributes<HTMLDivElement>>;
 
@@ -5710,6 +5853,12 @@ interface PartoSankeyChartProps {
     className?: string;
     isLoading?: boolean;
     ariaLabel?: string;
+    /**
+     * Render a legend listing each node with its color. Useful for flows
+     * where node names aren't always visible (small column widths). The
+     * legend shows the same color the node rectangle uses. @default `false`
+     */
+    legend?: boolean;
 }
 declare const PartoSankeyChart: React$1.ForwardRefExoticComponent<PartoSankeyChartProps & React$1.RefAttributes<HTMLDivElement>>;
 
@@ -5789,6 +5938,16 @@ interface ConceptPulseChartProps {
     className?: string;
     isLoading?: boolean;
     ariaLabel?: string;
+    /**
+     * Render a legend below the chart that maps composition arc colors to
+     * their category names (flow/emotion/custom). Only categories that
+     * appear in at least one bubble's composition are listed.
+     *
+     * Without a legend, the arc colors are decipherable only via hover —
+     * which fails WCAG 1.4.1 for the core "what is this composition?"
+     * question. @default `false`
+     */
+    legend?: boolean;
 }
 declare const ConceptPulseChart: React$1.ForwardRefExoticComponent<ConceptPulseChartProps & React$1.RefAttributes<HTMLDivElement>>;
 
@@ -5848,6 +6007,12 @@ interface PartoNetworkChartProps {
     className?: string;
     isLoading?: boolean;
     ariaLabel?: string;
+    /**
+     * Render a legend listing each node group with its assigned color.
+     * Pulled from the unique `group` values across `nodes`. When no node
+     * has a `group`, the legend silently renders nothing. @default `false`
+     */
+    legend?: boolean;
 }
 declare const PartoNetworkChart: React$1.ForwardRefExoticComponent<PartoNetworkChartProps & React$1.RefAttributes<HTMLDivElement>>;
 
@@ -5989,8 +6154,88 @@ 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, 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;
+interface ChartLegendItem {
+    /** Unique identifier — typically the dataKey or series id. */
+    key: string;
+    /** Display label. Strings preferred so AT can read it. */
+    label: React$1.ReactNode;
+    /** Marker color. Pass the resolved value (hsl, hex, or `var(--token)`). */
+    color: string;
+    /**
+     * Marker shape. `dot` for categorical (Bar/Pie), `line` for series (Line/Area),
+     * `bar` for stacked distributions. @default `dot`
+     */
+    shape?: 'dot' | 'line' | 'bar';
+    /**
+     * Optional stroke pattern when `shape="line"`. Lets color-blind users
+     * distinguish series by texture in addition to color. WCAG 1.4.1
+     * (Use of Color) recommends adding a non-color signal.
+     */
+    pattern?: 'solid' | 'dashed' | 'dotted' | 'dash-dot';
+    /** Optional trailing value (count, percent, etc.). */
+    value?: React$1.ReactNode;
+}
+interface ChartLegendProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    /** Series to enumerate. */
+    items: ChartLegendItem[];
+    /** Layout — `horizontal` wraps, `vertical` stacks. @default `horizontal` */
+    orientation?: 'horizontal' | 'vertical';
+    /** Marker square/dot edge length in px. @default `10` */
+    swatchSize?: number;
+}
+/**
+ * Reusable chart legend. Pair with `PartoLineChart`, `PartoBarChart`, etc. by
+ * passing `legend={[…]}` or rendering `<ChartLegend>` next to the chart. Each
+ * line-shape entry can carry a stroke pattern so colorblind users can read
+ * series identity without relying on color alone.
+ *
+ * The legend has no chart-aware behavior on its own — pass the same colors
+ * (resolved via `useChartTheme`) you handed to the chart's `Cell`/series.
+ */
+declare const ChartLegend: React$1.ForwardRefExoticComponent<ChartLegendProps & React$1.RefAttributes<HTMLDivElement>>;
+interface ChartGradientLegendProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    /** Color at the low end of the scale (e.g. background-muted). */
+    startColor: string;
+    /** Color at the high end (e.g. brand). */
+    endColor: string;
+    /** Optional left/start label (typically the minimum value). */
+    startLabel?: React$1.ReactNode;
+    /** Optional right/end label (typically the maximum value). */
+    endLabel?: React$1.ReactNode;
+    /** Optional caption above the bar (e.g. "تراکم انتشار"). */
+    caption?: React$1.ReactNode;
+    /** Bar width in px @default 160 */
+    width?: number;
+    /** Bar height in px @default 8 */
+    height?: number;
 }
-declare function ChartTooltip({ active, payload, label, tooltipStyle, formatter }: ChartTooltipProps): react_jsx_runtime.JSX.Element | null;
+/**
+ * Continuous-scale legend for charts whose data is encoded as color intensity
+ * (HeatMap, choropleth, gradient density). Renders a horizontal gradient bar
+ * with start/end labels, captioned for AT via `role="img"` + `aria-label`.
+ *
+ * For discrete categorical legends (Line/Bar/Pie), use `<ChartLegend>` instead.
+ */
+declare const ChartGradientLegend: React$1.ForwardRefExoticComponent<ChartGradientLegendProps & React$1.RefAttributes<HTMLDivElement>>;
 /**
  * Transforms Nivo line/area data format to Recharts row-oriented format.
  * Useful for consumers migrating from Nivo data shape.
@@ -6019,6 +6264,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 +6413,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, BlurBackdrop, Breadcrumb, BreadcrumbEllipsis, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator, BulletinViewer, type BulletinViewerProps, Button, ButtonGroup, ButtonGroupSeparator, ButtonGroupText, ButtonProps, CENTERED_CONTAINER_CLS, CHART_FONT_FAMILY, COUNTRIES, CRITERION_TIER_KEYS, Callout, CalloutDescription, type CalloutProps, CalloutTitle, CardSkeleton, type CardSkeletonProps, Carousel, type CarouselApi, CarouselContent, CarouselItem, CarouselNext, CarouselPrevious, ChartContainer, ChartGradientLegend, type ChartGradientLegendProps, ChartLegend, type ChartLegendItem, type ChartLegendProps, 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, FOREGROUND_IMG_CLS, 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, type PostAuthorityTier, PostBody, type PostBodyData, type PostBodyProps, type PostBulkAction, PostBulkActionBar, type PostBulkActionBarProps, PostCard, type PostCardProps, type PostCluster, type PostComment, type PostCommentAuthor, PostCrisisBanner, type PostCrisisBannerProps, type PostData, type PostDensity, type PostDetails, PostDetailsDrawer, type PostDetailsDrawerProps, PostDetailsModal, type PostDetailsModalProps, type PostDetailsTab$1 as PostDetailsTab, type PostEmotion, type PostEnrichmentFlags, type PostFlags, type PostFlow, type PostGroupBy, PostHeader, PostHeaderBroadcast, type PostHeaderBroadcastProps, PostHeaderEditorial, type PostHeaderEditorialProps, type PostHeaderProps, type PostIntent, PostList, type PostListProps, PostMedia, PostMediaAudio, PostMediaCarousel, PostMediaGrid, PostMediaHighlight, type PostMediaItem, PostMediaPlaceholder, type PostMediaPlaceholderProps, type PostMediaPlaceholderVariant, type PostMediaProps, PostMediaSensitiveOverlay, type PostMediaSensitivity, PostMediaSingle, PostMediaSourceRemoved, type PostMediaSourceRemovedProps, type PostMediaStatus, PostMediaStory, PostMediaVideo, PostMetadata, type PostMetadataProps, type PostMetrics, type PostOutlet, type PostPlatform, PostQuotedEmbed, type PostQuotedEmbedProps, PostRepostHeader, type PostRepostHeaderProps, type PostRepostInfo, type PostSentiment, type PostSeverity, PostSignals, type PostSignalsProps, type PostSortBy, type PostSource, type PostSourceCategory, type PostStatus, PostThreadConnector, type PostThreadConnectorProps, type PostThreadInfo, type PostUrlPreview, type PostUrlPreview as PostUrlPreviewData, type PostUrlPreviewProps, type PostView, 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, type ReactionBreakdown, RegionPicker, type RegionPickerKey, type RegionPickerProps, RegisteredHotkey, ReportComposer, type ReportComposerProps, ReportSection, type ReportSectionProps, ResizableHandle, ResizablePanel, ResizablePanelGroup, RouteProgress, type RouteProgressHandle, type RouteProgressProps, SENSITIVITY_LABEL, 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, getMetricLabel, getPersianDay, getPersianMonth, getPersianMonthName, getPersianMonthNameShort, getPersianMonthsForDropdown, getPersianWeekdayName, getPersianYear, getPersianYearsForDropdown, getPostSourceConfig, getProvinceLabel, getScoreBenchmarkTiers, getSourceColorVar, tagInputVariants as hashtagInputVariants, jalaliToGregorian, labelChipVariants, localeAwareCategoryTick, localeAwareNumberTick, navItemVariants, navigationMenuTriggerStyle, normalizeSize, normalizeUrlDigits, pageLoaderVariants, postCardVariants, postHeaderVariants, profileCardVariants, resolveLevel, siteHeaderVariants, sourceCategory, 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 };