@parto-system-design/ui 1.1.4 → 1.1.5

package/dist/index.d.ts

@@ -230,6 +230,118 @@ declare const sentimentLabels: Record<SupportedLocale, {
     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).
+ *
+ * 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.
+ *
+ * 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)
+ */
+type ActionTypeKey = 'like' | 'comment' | 'save' | 'follow' | 'unfollow' | 'dm' | 'share';
+declare const ACTION_TYPE_KEYS: readonly ActionTypeKey[];
+declare const actionTypeLabels: Record<SupportedLocale, Record<ActionTypeKey, string>>;
+/**
+ * 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.
+ */
+declare const actionTypeVerbs: Record<SupportedLocale, Record<ActionTypeKey, 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.
+ *
+ * `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.
+ *
+ * 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.
@@ -264,6 +376,11 @@ declare const UI_STRINGS: {
         readonly stepPending: "در انتظار";
         readonly clearFilters: "پاک کردن فیلترها";
         readonly activeFilters: "فیلترهای فعال";
+        readonly filters: "فیلترها";
+        readonly applyFilters: "اعمال";
+        readonly resetFilters: "پیش‌فرض";
+        readonly noFiltersActive: "فیلتر فعالی نیست";
+        readonly clearSection: "پاک کردن این بخش";
         readonly goBack: "بازگشت";
         readonly gridView: "نمای شبکه‌ای";
         readonly listView: "نمای لیستی";
@@ -321,6 +438,11 @@ declare const UI_STRINGS: {
         readonly stepPending: "قيد الانتظار";
         readonly clearFilters: "مسح الفلاتر";
         readonly activeFilters: "الفلاتر النشطة";
+        readonly filters: "الفلاتر";
+        readonly applyFilters: "تطبيق";
+        readonly resetFilters: "الافتراضي";
+        readonly noFiltersActive: "لا توجد فلاتر نشطة";
+        readonly clearSection: "مسح هذا القسم";
         readonly goBack: "رجوع";
         readonly gridView: "عرض شبكي";
         readonly listView: "عرض قائمة";
@@ -378,6 +500,11 @@ declare const UI_STRINGS: {
         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";
@@ -465,8 +592,87 @@ declare namespace AccordionContent {
     var displayName: string;
 }
 
+interface ActionTimelineItemData {
+    /** Stable identifier */
+    id: string;
+    /** Outcome of the action. Drives the marker colour/icon when `leading` isn't set. @default "info" */
+    status?: ActionStatusKey;
+    /** Primary text — actor + verb + target. */
+    title: React$1.ReactNode;
+    /** Optional one-line description under the title. */
+    description?: React$1.ReactNode;
+    /** Optional preview (comment text, error message, diff snippet). Rendered in a muted box. */
+    preview?: React$1.ReactNode;
+    /** Optional small tag next to the timestamp (e.g. "Instagram", "AI", "System"). */
+    tag?: React$1.ReactNode;
+    /** Optional trailing actions (buttons, dropdown). */
+    actions?: React$1.ReactNode;
+    /** When this action happened. Accepts Date | ISO string | epoch ms. */
+    timestamp: Date | string | number;
+    /** Override the leading marker — pass an `<Avatar />`, custom icon, etc. */
+    leading?: React$1.ReactNode;
+}
+type ActionTimelineDensity = 'compact' | 'default' | 'spacious';
+type ActionTimelineGroupBy = 'none' | 'day';
+interface ActionTimelineProps extends Omit<React$1.OlHTMLAttributes<HTMLOListElement>, 'children'> {
+    /** Data-driven item list. Mutually exclusive with `children`. */
+    items?: ActionTimelineItemData[];
+    /** Composition API — pass `<ActionTimelineItem>` children. */
+    children?: React$1.ReactNode;
+    /** Visual density @default "default" */
+    density?: ActionTimelineDensity;
+    /** Group adjacent items under sticky day headers */
+    groupBy?: ActionTimelineGroupBy;
+    /** Locale for timestamp formatting + status aria-labels @default "fa" */
+    locale?: SupportedLocale;
+    /** Hide the vertical connector line between items @default false */
+    hideConnector?: boolean;
+    /** Maximum items to render. When set and exceeded, caller is responsible for pagination UI. */
+    limit?: number;
+    /** Fires when an item is clicked (anywhere outside the `actions` slot) */
+    onItemSelect?: (item: ActionTimelineItemData, index: number) => void;
+    /** Empty state when items is empty / undefined and no children provided */
+    emptyState?: React$1.ReactNode;
+}
+interface ActionTimelineItemProps extends ActionTimelineItemData {
+}
+/**
+ * Optional composition wrapper. Use inside `<ActionTimeline>` instead of the
+ * `items` prop — ActionTimeline injects the position metadata automatically.
+ * Throws if rendered outside <ActionTimeline>.
+ */
+declare function ActionTimelineItem(props: ActionTimelineItemProps): React$1.ReactElement;
+declare const ActionTimeline: React$1.ForwardRefExoticComponent<ActionTimelineProps & React$1.RefAttributes<HTMLOListElement>>;
+
+interface ActionTypeMeta {
+    /** CSS var fragment — read as `hsl(var(--action-type-foo))` */
+    token: string;
+    /** Lucide icon for the action */
+    icon: React$1.ComponentType<{
+        className?: string;
+    }>;
+}
+declare const ACTION_TYPE_META: Record<ActionTypeKey, ActionTypeMeta>;
+declare const actionTypeChipVariants: (props?: ({
+    size?: "xs" | "sm" | "md" | "lg" | null | undefined;
+    variant?: "flat" | "soft" | "solid" | "outline" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface ActionTypeChipProps extends Omit<React$1.HTMLAttributes<HTMLSpanElement>, 'children'>, VariantProps<typeof actionTypeChipVariants> {
+    /** Which action the chip represents */
+    type: ActionTypeKey;
+    /** Show the localized label after the icon @default true */
+    showLabel?: boolean;
+    /** Show a counter next to the label (e.g., "Like ۴۲۵") */
+    count?: number;
+    /** Locale for default label + digit formatting @default "fa" */
+    locale?: SupportedLocale;
+    /** Override the label (otherwise uses `actionTypeLabels[locale][type]`) */
+    label?: React$1.ReactNode;
+}
+declare const ActionTypeChip: React$1.ForwardRefExoticComponent<ActionTypeChipProps & React$1.RefAttributes<HTMLSpanElement>>;
+
 declare const Alert: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & VariantProps<(props?: ({
-    variant?: "info" | "default" | "success" | "warning" | "destructive" | null | undefined;
+    variant?: "warning" | "success" | "info" | "default" | "destructive" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string> & React$1.RefAttributes<HTMLDivElement>>;
 declare const AlertTitle: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLHeadingElement> & React$1.RefAttributes<HTMLParagraphElement>>;
 declare const AlertDescription: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLParagraphElement> & React$1.RefAttributes<HTMLParagraphElement>>;
@@ -483,6 +689,38 @@ 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;
@@ -748,8 +986,8 @@ interface AvatarGroupProps extends React$1.HTMLAttributes<HTMLDivElement>, Varia
 declare const AvatarGroup: React$1.ForwardRefExoticComponent<AvatarGroupProps & React$1.RefAttributes<HTMLDivElement>>;
 
 declare const badgeVariants: (props?: ({
-    variant?: "default" | "success" | "warning" | "destructive" | "secondary" | "outline" | "brand" | null | undefined;
-    size?: "xs" | "sm" | "md" | "lg" | "small" | "tiny" | "large" | null | undefined;
+    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> {
@@ -759,7 +997,7 @@ interface BadgeProps extends React$1.HTMLAttributes<HTMLSpanElement>, VariantPro
 declare const Badge: React$1.ForwardRefExoticComponent<BadgeProps & React$1.RefAttributes<HTMLSpanElement>>;
 
 declare const bannerVariants: (props?: ({
-    variant?: "info" | "success" | "warning" | "destructive" | "neutral" | null | undefined;
+    variant?: "neutral" | "warning" | "success" | "info" | "destructive" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 interface BannerProps extends React$1.HTMLAttributes<HTMLDivElement>, VariantProps<typeof bannerVariants> {
     /** Whether the banner can be dismissed */
@@ -806,7 +1044,7 @@ declare namespace BreadcrumbEllipsis {
 
 type ButtonVariantProps = VariantProps<typeof buttonVariants>;
 declare const buttonVariants: (props?: ({
-    variant?: "link" | "text" | "default" | "warning" | "destructive" | "primary" | "secondary" | "outline" | "dashed" | "danger" | "ghost" | null | undefined;
+    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;
@@ -814,7 +1052,7 @@ declare const buttonVariants: (props?: ({
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 type LoadingVariantProps = VariantProps<typeof loadingVariants>;
 declare const loadingVariants: (props?: ({
-    variant?: "link" | "text" | "default" | "warning" | "destructive" | "primary" | "secondary" | "outline" | "dashed" | "danger" | "ghost" | null | undefined;
+    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'> {
@@ -1007,6 +1245,515 @@ 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;
+    /** Visible label. */
+    label: string;
+    /** Dimmer description shown under the label. */
+    description?: string;
+    /** Icon displayed at the start of the row. */
+    icon?: LucideIcon | React$1.ComponentType<{
+        className?: string;
+    }>;
+    /** Group heading under which this item appears. Items without a group are rendered in the root group. */
+    group?: string;
+    /**
+     * Keyboard-shortcut display, using the same grammar as {@link HotkeyCombo}
+     * (e.g. 'mod+d'). The palette only displays it — binding the global shortcut
+     * is the caller's responsibility via {@link useHotkeys} at the host component.
+     */
+    shortcut?: string;
+    /** Extra search tokens not visible in the label (e.g., English aliases, acronyms, tag words). */
+    keywords?: string[];
+    /** Callback when item is selected. Palette closes automatically afterwards. */
+    onSelect: () => void;
+    /** Prevents selection + dims the row. */
+    disabled?: boolean;
+}
+interface CommandPaletteRecentsConfig {
+    /** Persistence key. Default: `'parto:cmdk:recents'`. Namespace by app if you mount multiple palettes. */
+    key?: string;
+    /** Max items to remember. Default: 5. */
+    max?: number;
+    /** Header label for the recents group. Default: locale-appropriate ('اخیر'/'Recent'). */
+    label?: string;
+}
+interface CommandPaletteProps {
+    /** Controlled open state. If omitted, palette manages its own state. */
+    open?: boolean;
+    /** Fires on both open and close. */
+    onOpenChange?: (open: boolean) => void;
+    /** Items to display. Grouped by `item.group` in insertion order. */
+    items: CommandPaletteItem[];
+    /**
+     * Global keyboard shortcut to toggle the palette. Default: `'mod+k'`.
+     * Pass `false` to disable the global listener (useful when wiring your own).
+     */
+    shortcut?: HotkeyCombo | false;
+    /** Placeholder for the input. Defaults to a locale-appropriate string. */
+    placeholder?: string;
+    /** Shown inside `<CommandEmpty>` when there are no matches. */
+    emptyMessage?: string;
+    /** Screen-reader title (visually hidden). */
+    title?: string;
+    /** Screen-reader description (visually hidden). */
+    description?: string;
+    /** Locale for default strings + Persian-aware fuzzy matching. */
+    locale?: SupportedLocale;
+    /**
+     * Remember recently-selected items in localStorage and surface them as a top
+     * group when the search input is empty. Pass `false` to disable. Default: on.
+     */
+    recents?: CommandPaletteRecentsConfig | false;
+    /** Extra class for the dialog content. */
+    className?: string;
+}
+declare function CommandPalette({ open: controlledOpen, onOpenChange, items, shortcut, placeholder, emptyMessage, title, description, locale, recents: recentsConfig, className, }: CommandPaletteProps): react_jsx_runtime.JSX.Element;
+declare namespace CommandPalette {
+    var displayName: string;
+}
+
+interface PartoRadarChartProps {
+    /** Data: [{ subject: "سرعت", series1: 80, series2: 60 }] */
+    data: Array<Record<string, any>>;
+    /** Keys for each radar series */
+    dataKeys: string[];
+    /** Field name used for angle axis labels (default: 'subject') */
+    indexBy?: string;
+    /** Radar fill opacity */
+    fillOpacity?: number;
+    /** Radar stroke width */
+    strokeWidth?: number;
+    /** Show dots on vertices */
+    showDots?: boolean;
+    /** Dot radius */
+    dotRadius?: number;
+    /** Grid shape */
+    gridType?: 'polygon' | 'circle';
+    /** Chart margins */
+    margin?: {
+        top?: number;
+        right?: number;
+        bottom?: number;
+        left?: number;
+    };
+    /** Custom tooltip formatter */
+    tooltipFormatter?: (name: string, value: number) => React$1.ReactNode;
+    className?: string;
+    isLoading?: boolean;
+    ariaLabel?: string;
+}
+declare const PartoRadarChart: React$1.ForwardRefExoticComponent<PartoRadarChartProps & React$1.RefAttributes<HTMLDivElement>>;
+
+interface ComparisonMetric {
+    /** Unique key — used to look up values in each entity. */
+    key: string;
+    /** Human-readable label shown on the radar axis + tooltip. */
+    label: string;
+    /**
+     * True means a higher value is better (the default for most scores).
+     * Set to false for inverted metrics like error rate or response time.
+     * @default true
+     */
+    higherIsBetter?: boolean;
+    /**
+     * Informational — maximum expected value for this metric. Not used by the
+     * radar geometry (auto-scaled); used by the tooltip for "x / max" display.
+     */
+    max?: number;
+}
+interface ComparisonEntity {
+    /** Unique id — used as the `dataKey` for the radar series. */
+    key: string;
+    /** Display name in the legend. */
+    label: string;
+    /** Metric key → numeric value. Missing keys are treated as 0. */
+    values: Record<string, number>;
+    /** Optional custom color — defaults to the chart palette. */
+    color?: string;
+}
+interface ComparisonWinner {
+    /** Entity key (or null for a tie). */
+    winnerKey: string | null;
+    /** All entity keys tied at the top. Length >=1 when there is data; empty if no entities. */
+    topKeys: string[];
+    /** Top value for this metric (after higherIsBetter direction). */
+    topValue: number;
+}
+/**
+ * For each metric, compute the entity that "wins" (highest value, or lowest
+ * if `higherIsBetter: false`). Ties return winnerKey=null.
+ */
+declare function computeComparisonWinners(metrics: ComparisonMetric[], entities: ComparisonEntity[]): Record<string, ComparisonWinner>;
+/** Count outright wins (no ties) per entity. */
+declare function countComparisonWins(winners: Record<string, ComparisonWinner>): Record<string, number>;
+interface ComparisonRadarProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, 'title'> {
+    /** Metric axes of the radar. Order matters — these render clockwise from the top. */
+    metrics: ComparisonMetric[];
+    /** Entities being compared (typically 2-5). */
+    entities: ComparisonEntity[];
+    /** Annotate axis labels with a crown for the winner @default true */
+    showWinnerMarkers?: boolean;
+    /** Show the rich legend with win counts above the chart @default true */
+    showLegend?: boolean;
+    /** Card title */
+    title?: React$1.ReactNode;
+    /** Short description below title */
+    description?: React$1.ReactNode;
+    /** Chart height in pixels @default 340 */
+    chartHeight?: number;
+    /** Loading state */
+    isLoading?: boolean;
+    /** Locale @default "fa" */
+    locale?: SupportedLocale;
+    /**
+     * Custom radar props — pass-through to PartoRadarChart (margin, fillOpacity,
+     * gridType, …). Avoid setting `data` / `dataKeys` / `indexBy` / `isLoading`.
+     */
+    radarProps?: Omit<React$1.ComponentProps<typeof PartoRadarChart>, 'data' | 'dataKeys' | 'indexBy' | 'isLoading'>;
+}
+declare const ComparisonRadar: React$1.ForwardRefExoticComponent<ComparisonRadarProps & React$1.RefAttributes<HTMLDivElement>>;
+
+type NotificationSeverity = 'info' | 'warning' | 'destructive' | 'success' | 'critical';
+interface NotificationItem {
+    /** Stable id — required for `onMarkRead` / `onDismiss` to target a specific item. */
+    id: string;
+    /** Short headline. Keep under ~60 chars to avoid wrapping beyond two lines. */
+    title: string;
+    /** Longer body text. Truncated to 3 lines by default. */
+    body?: string;
+    /** ISO date string, Date instance, or epoch ms. */
+    timestamp: string | number | Date;
+    /** Severity drives the side-border + dot color. Defaults to `'info'`. */
+    severity?: NotificationSeverity;
+    /** Optional icon — replaces the severity dot when supplied. */
+    icon?: LucideIcon;
+    /** `true` renders the item in a read/dim state (no unread dot, lower contrast). */
+    read?: boolean;
+    /**
+     * Row-level callback — fires when the item body is clicked. Typical use:
+     * navigate to the source. The palette closes afterwards.
+     */
+    onSelect?: () => void;
+    /** Inline action button rendered inside the row (e.g., "Approve", "Open"). */
+    action?: {
+        label: string;
+        onClick: () => void;
+    };
+}
+interface NotificationFilter {
+    /** Stable key for the tab. */
+    key: string;
+    /** Visible label. */
+    label: string;
+    /** Predicate — items returning `true` are shown when this filter is active. */
+    predicate: (item: NotificationItem) => boolean;
+}
+interface NotificationCenterProps {
+    /** Items to render. Consumer owns the array (mark-as-read / dismiss happen in your store). */
+    items: NotificationItem[];
+    /** Fires when user clicks an unread item, or the "mark read" action on it. */
+    onMarkRead?: (id: string) => void;
+    /** Fires when user clicks "mark all read". */
+    onMarkAllRead?: () => void;
+    /** Fires when user clicks the × on an item. If absent, dismiss is hidden. */
+    onDismiss?: (id: string) => void;
+    /** Optional tabs. First filter is active by default unless `defaultFilter` supplied. */
+    filters?: NotificationFilter[];
+    /** Key of the filter active on first render. */
+    defaultFilter?: string;
+    /** Optional per-filter active control. When set, tabs become controlled. */
+    activeFilter?: string;
+    onFilterChange?: (key: string) => void;
+    /** Max CSS height of the scrollable list. Default `'420px'`. */
+    maxHeight?: string;
+    /** Locale for label strings + digit formatting. */
+    locale?: SupportedLocale;
+    /** Controlled open. */
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    /** Custom empty message. */
+    emptyMessage?: string;
+    /** Aria-label on the bell trigger. */
+    triggerLabel?: string;
+    /** Extra class on the trigger button. */
+    triggerClassName?: string;
+    /** Extra class on the popover content. */
+    className?: string;
+    /** Override relative-time formatter (default uses `formatRelativeTime` — Persian-biased). */
+    formatTime?: (date: Date) => string;
+}
+declare function NotificationCenter({ items, onMarkRead, onMarkAllRead, onDismiss, filters, defaultFilter, activeFilter: controlledFilter, onFilterChange, maxHeight, locale, open: controlledOpen, onOpenChange, emptyMessage, triggerLabel, triggerClassName, className, formatTime, }: NotificationCenterProps): react_jsx_runtime.JSX.Element;
+declare namespace NotificationCenter {
+    var displayName: string;
+}
+
+declare const siteHeaderVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface SiteHeaderProps extends React$1.HTMLAttributes<HTMLElement>, VariantProps<typeof siteHeaderVariants> {
+}
+/**
+ * Opinionated app-shell header for multi-screen dashboards. Compose with the
+ * sub-components: `<SiteHeaderStart>` / `<SiteHeaderEnd>` plus the small
+ * primitives (`Breadcrumb`, `SiteHeaderTitle`, `SiteHeaderSubtitle`,
+ * `SiteHeaderActions`, `SiteHeaderSeparator`).
+ *
+ * For a low-level prop-based layout use {@link AppBar} instead.
+ */
+declare const SiteHeader: React$1.ForwardRefExoticComponent<SiteHeaderProps & React$1.RefAttributes<HTMLElement>>;
+/** Inline-start slot. Holds breadcrumb + title stack. Grows to fill space. */
+declare const SiteHeaderStart: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & React$1.RefAttributes<HTMLDivElement>>;
+/** Inline-end slot. Holds actions + notifications + user menu. Shrinks to content. */
+declare const SiteHeaderEnd: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & React$1.RefAttributes<HTMLDivElement>>;
+/** Main page title. Single line, truncates. */
+declare const SiteHeaderTitle: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLHeadingElement> & React$1.RefAttributes<HTMLHeadingElement>>;
+/** Optional tagline under the title. Single line, truncates. */
+declare const SiteHeaderSubtitle: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLParagraphElement> & React$1.RefAttributes<HTMLParagraphElement>>;
+/**
+ * Stack helper — wraps breadcrumb / title / subtitle vertically. Use inside
+ * `SiteHeaderStart` when you want a conventional "breadcrumb-above-title" layout.
+ */
+declare const SiteHeaderTitleGroup: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & React$1.RefAttributes<HTMLDivElement>>;
+/** Group container for icon-only action buttons. */
+declare const SiteHeaderActions: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & React$1.RefAttributes<HTMLDivElement>>;
+/** Vertical separator between action clusters. */
+declare const SiteHeaderSeparator: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLSpanElement> & React$1.RefAttributes<HTMLSpanElement>>;
+
+interface UserMenuUser {
+    name: string;
+    email?: string;
+    avatar?: string;
+    /** Fallback initials when the avatar image is missing or fails to load. */
+    avatarFallback?: string;
+    /** Optional role / org label shown under the name. */
+    role?: string;
+}
+/** Discriminated item union for the dropdown body. */
+type UserMenuItem = {
+    type?: 'item';
+    label: string;
+    icon?: React$1.ComponentType<{
+        className?: string;
+    }>;
+    /** Hotkey string passed to `formatHotkey`, e.g. `'mod+,'`. */
+    shortcut?: string;
+    onSelect: () => void;
+    destructive?: boolean;
+    disabled?: boolean;
+} | {
+    type: 'separator';
+} | {
+    type: 'label';
+    label: string;
+} | {
+    type: 'submenu';
+    label: string;
+    icon?: React$1.ComponentType<{
+        className?: string;
+    }>;
+    items: UserMenuItem[];
+};
+interface UserMenuProps {
+    /** The current user shown in the dropdown header + trigger avatar. */
+    user: UserMenuUser;
+    /** Dropdown rows. Use the discriminated union for item / separator / label / submenu. */
+    items: UserMenuItem[];
+    /** Controlled open. */
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    /** Locale for default labels. Defaults to `'fa'`. */
+    locale?: SupportedLocale;
+    /** Show email + role block in the dropdown header. Default `true`. */
+    showUserHeader?: boolean;
+    /** Show the name next to the avatar on the trigger (hidden on mobile by default). Default `false`. */
+    showNameInTrigger?: boolean;
+    /** Trigger size. */
+    size?: 'sm' | 'md';
+    /** Extra class on the trigger button. */
+    triggerClassName?: string;
+    /** Extra class on the dropdown content. */
+    className?: string;
+    /** `data-slot` override (useful when nesting inside another component's analytics tree). */
+    'data-slot'?: string;
+}
+declare const UserMenu: React$1.ForwardRefExoticComponent<UserMenuProps & React$1.RefAttributes<HTMLButtonElement>>;
+
+interface RouteProgressProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    /**
+     * Controlled visibility. If omitted, the component stays mounted but hidden —
+     * fire the `start`/`finish` methods on the ref instead.
+     */
+    active?: boolean;
+    /** Progress value (0–1). Default: auto-trickle while active. */
+    value?: number;
+    /**
+     * How long to trickle before the bar caps out near the end (matches
+     * NProgress-style UX). Default: 800ms per step.
+     */
+    trickleInterval?: number;
+    /**
+     * Value the bar tops out at while waiting for `active=false` (so the page
+     * change still feels snappy). Default: 0.9 — never completes automatically.
+     */
+    trickleCap?: number;
+    /** Height in pixels. Default: 2. */
+    height?: number;
+    /** Position. `'top'` (default) sticks to the top edge; `'bottom'` for e.g. drawers. */
+    position?: 'top' | 'bottom';
+}
+interface RouteProgressHandle {
+    /** Reset + show the bar. */
+    start: () => void;
+    /** Snap to 100% then hide after a short fade-out. */
+    finish: () => void;
+}
+/**
+ * Thin gradient progress bar for route/page transitions. Three usage modes:
+ *
+ * 1. **Controlled** — pass `active={true/false}` and let the component trickle
+ *    automatically while `active` is true:
+ *    ```tsx
+ *    <RouteProgress active={isNavigating} />
+ *    ```
+ *
+ * 2. **Imperative** — call `start()` / `finish()` on the ref:
+ *    ```tsx
+ *    const ref = useRef<RouteProgressHandle>(null)
+ *    ref.current?.start()
+ *    // ... navigate ...
+ *    ref.current?.finish()
+ *    ```
+ *
+ * 3. **Fully controlled value** — pass a numeric `value` in `[0, 1]` and skip
+ *    `active` entirely. Useful for file uploads or long-running jobs.
+ */
+declare const RouteProgress: React$1.ForwardRefExoticComponent<RouteProgressProps & React$1.RefAttributes<RouteProgressHandle>>;
+
+type NavMatchStrategy = 'exact' | 'prefix';
+interface NavTreeContextValue {
+    /** Current pathname — used to decide which `NavItem.href` is active. */
+    activePath: string;
+    /** Match strategy. Default `'prefix'` matches `/clusters` for both `/clusters` and `/clusters/42`. */
+    matchStrategy: NavMatchStrategy;
+}
+declare function useNavTree(): NavTreeContextValue;
+interface NavTreeProviderProps {
+    /** Current pathname. For Next.js, pass `usePathname()`. */
+    activePath: string;
+    /** How NavItem `href` matches `activePath`. Default: `'prefix'`. */
+    matchStrategy?: NavMatchStrategy;
+    children: React$1.ReactNode;
+}
+declare function NavTreeProvider({ activePath, matchStrategy, children }: NavTreeProviderProps): react_jsx_runtime.JSX.Element;
+/** Outer container. Mostly a semantic `<nav>` wrapper — accepts any children. */
+declare const NavTree: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLElement> & React$1.RefAttributes<HTMLElement>>;
+interface NavGroupProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, 'role'> {
+    /** Visible group heading. Clickable if `collapsible` (default true). */
+    heading?: React$1.ReactNode;
+    /** Whether the header toggles visibility of children. Default `true` if `heading` is set. */
+    collapsible?: boolean;
+    /** Initial open state (uncontrolled). Default `true`. */
+    defaultOpen?: boolean;
+    /** Controlled open state. */
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+}
+declare const NavGroup: React$1.ForwardRefExoticComponent<NavGroupProps & React$1.RefAttributes<HTMLDivElement>>;
+declare const NavSeparator: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLHRElement> & React$1.RefAttributes<HTMLHRElement>>;
+declare const navItemVariants: (props?: ({
+    size?: "sm" | "md" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface NavItemBaseProps extends VariantProps<typeof navItemVariants> {
+    /** Link target. If set, NavItem renders as `<a>`. */
+    href?: string;
+    /** Click handler. If set (and `href` not set), NavItem renders as `<button>`. */
+    onClick?: React$1.MouseEventHandler<HTMLElement>;
+    /** Leading icon. */
+    icon?: React$1.ComponentType<{
+        className?: string;
+    }>;
+    /** Optional trailing badge (count, "new", etc.). */
+    badge?: React$1.ReactNode;
+    /** Custom `data-active` override. Use to short-circuit path matching. */
+    active?: boolean;
+    /** Skip the active-cascade report to parent (useful for informational items). */
+    skipActiveReport?: boolean;
+    /** Render-as override — passes all props to the given component. */
+    asChild?: boolean;
+    /** Disables interaction + dims the row. */
+    disabled?: boolean;
+    /** External link hint — opens in a new tab with `rel="noopener noreferrer"`. */
+    external?: boolean;
+}
+interface NavItemProps extends NavItemBaseProps, Omit<React$1.HTMLAttributes<HTMLElement>, 'onClick'> {
+}
+declare const NavItem: React$1.ForwardRefExoticComponent<NavItemProps & React$1.RefAttributes<HTMLElement>>;
+
 interface CommentTag {
     title: string;
     probability: number;
@@ -1127,29 +1874,179 @@ declare namespace ContextMenuShortcut {
     var displayName: string;
 }
 
-interface CopyButtonProps extends Omit<ButtonProps, 'onClick'> {
-    /** The text value to copy to clipboard */
-    value: string;
-    /** Duration in ms to show the "copied" state @default 2000 */
-    feedbackDuration?: number;
-    /** Locale for aria-label and tooltip text @default "fa" */
+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;
-    /** Called after successful copy */
-    onCopy?: () => void;
+    /** Loading skeleton */
+    isLoading?: boolean;
 }
-declare const CopyButton: React$1.ForwardRefExoticComponent<CopyButtonProps & React$1.RefAttributes<HTMLButtonElement>>;
+declare const FlowDistribution: React$1.ForwardRefExoticComponent<FlowDistributionProps & React$1.RefAttributes<HTMLDivElement>>;
 
-interface DatePickerProps {
-    /**
-     * The selected date range
-     */
-    value?: DateRange;
-    /**
-     * Callback when date range changes
-     */
-    onChange?: (date: DateRange | undefined) => void;
-    /**
-     * Use Persian/Jalali calendar
+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;
+    /** Duration in ms to show the "copied" state @default 2000 */
+    feedbackDuration?: number;
+    /** Locale for aria-label and tooltip text @default "fa" */
+    locale?: SupportedLocale;
+    /** Called after successful copy */
+    onCopy?: () => void;
+}
+declare const CopyButton: React$1.ForwardRefExoticComponent<CopyButtonProps & React$1.RefAttributes<HTMLButtonElement>>;
+
+type CriterionTierKey = 'excellent' | 'good' | 'moderate' | 'poor' | 'critical';
+declare const CRITERION_TIER_KEYS: readonly CriterionTierKey[];
+interface CriterionTierThresholds {
+    /** Minimum score for "excellent" @default 80 */
+    excellent: number;
+    /** Minimum score for "good" @default 60 */
+    good: number;
+    /** Minimum score for "moderate" @default 40 */
+    moderate: number;
+    /** Minimum score for "poor" @default 20 (below → "critical") */
+    poor: number;
+}
+declare const DEFAULT_CRITERION_THRESHOLDS: CriterionTierThresholds;
+/**
+ * Auto-classify a score into one of the 5 canonical tiers based on thresholds.
+ * Assumes score is normalized to [0, max]; will return a tier even if score
+ * is out of range (clamped behaviour).
+ */
+declare function getCriterionTier(score: number, max?: number, thresholds?: CriterionTierThresholds): CriterionTierKey;
+interface CriterionInputSpec {
+    /** Short label for the input (e.g., "نرخ تعامل") */
+    label?: React$1.ReactNode;
+    /** Displayed value (e.g., "۳.۲٪", "+۱۲۰ فالوور", "۵۰۰ کلمه") */
+    value: React$1.ReactNode;
+}
+interface CriterionTrend {
+    /** Delta in points (not percent). Positive = higher score than baseline. */
+    delta: number;
+    /** Optional label describing the baseline (e.g., "نسبت به ماه قبل") */
+    label?: React$1.ReactNode;
+}
+interface CriterionScoreCardProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    /** Name of the criterion (e.g., "نرخ تعامل") */
+    name: React$1.ReactNode;
+    /** Short description of how the score is computed */
+    description?: React$1.ReactNode;
+    /** Computed score */
+    score: number;
+    /** Max of the score scale @default 100 */
+    max?: number;
+    /**
+     * Weight in a composite score (0..1). Rendered as "۶۰٪" badge in the header.
+     * When weight=0, the badge still renders — pass `undefined` to hide it.
+     */
+    weight?: number;
+    /** Raw input that produced the score (for transparency) */
+    input?: CriterionInputSpec;
+    /** Change vs a baseline, shown next to the score */
+    trend?: CriterionTrend;
+    /**
+     * Tier override. When omitted, auto-computed from `score` + `max` + thresholds.
+     */
+    tier?: CriterionTierKey;
+    /** Show a small "≥80 عالی · ≥60 خوب · ..." hint row @default false */
+    showThresholdHint?: boolean;
+    /** Custom tier thresholds (expressed for 0-100; scaled to `max` internally) */
+    tierThresholds?: CriterionTierThresholds;
+    /** Visual size @default "md" */
+    size?: 'sm' | 'md' | 'lg';
+    /**
+     * Layout orientation:
+     * - `default` — header with name+weight, big score + trend, input/description/hint rows
+     * - `compact` — single row name + score, for list/table usage
+     */
+    layout?: 'default' | 'compact';
+    /** Locale for default strings + digits @default "fa" */
+    locale?: SupportedLocale;
+    /** Hide the horizontal progress bar @default false */
+    hideBar?: boolean;
+}
+declare const CriterionScoreCard: React$1.ForwardRefExoticComponent<CriterionScoreCardProps & React$1.RefAttributes<HTMLDivElement>>;
+
+interface DatePickerProps {
+    /**
+     * The selected date range
+     */
+    value?: DateRange;
+    /**
+     * Callback when date range changes
+     */
+    onChange?: (date: DateRange | undefined) => void;
+    /**
+     * Use Persian/Jalali calendar
      */
     usePersianCalendar?: boolean;
     /**
@@ -1448,6 +2345,85 @@ interface FilterBarActiveFiltersProps extends React$1.HTMLAttributes<HTMLDivElem
 }
 declare const FilterBarActiveFilters: React$1.ForwardRefExoticComponent<FilterBarActiveFiltersProps & React$1.RefAttributes<HTMLDivElement>>;
 
+interface FilterPanelProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    /** Locale for default strings and digit formatting @default "fa" */
+    locale?: SupportedLocale;
+}
+declare const FilterPanel: React$1.ForwardRefExoticComponent<FilterPanelProps & React$1.RefAttributes<HTMLDivElement>>;
+declare const FilterPanelHeader: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & React$1.RefAttributes<HTMLDivElement>>;
+interface FilterPanelTitleProps extends React$1.HTMLAttributes<HTMLHeadingElement> {
+    /** Active filter count — when > 0, a pill is rendered next to the label */
+    activeCount?: number;
+}
+declare const FilterPanelTitle: React$1.ForwardRefExoticComponent<FilterPanelTitleProps & React$1.RefAttributes<HTMLHeadingElement>>;
+interface FilterPanelClearAllProps extends Omit<React$1.ButtonHTMLAttributes<HTMLButtonElement>, 'onClick'> {
+    /** Callback when clear-all is clicked */
+    onClear?: () => void;
+    /** Also allow onClick (alias of onClear) to match native HTML semantics */
+    onClick?: React$1.MouseEventHandler<HTMLButtonElement>;
+}
+declare const FilterPanelClearAll: React$1.ForwardRefExoticComponent<FilterPanelClearAllProps & React$1.RefAttributes<HTMLButtonElement>>;
+declare const FilterPanelBody: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & React$1.RefAttributes<HTMLDivElement>>;
+declare const FilterPanelFooter: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & React$1.RefAttributes<HTMLDivElement>>;
+interface FilterSectionProps {
+    /** Visible section title */
+    title: React$1.ReactNode;
+    /** Extra descriptive text below the title */
+    description?: React$1.ReactNode;
+    /** Number of active filters inside this section — shown as a pill next to the title */
+    activeCount?: number;
+    /** Initial open state for uncontrolled mode @default true */
+    defaultOpen?: boolean;
+    /** Controlled open state */
+    open?: boolean;
+    /** onOpenChange for controlled mode */
+    onOpenChange?: (open: boolean) => void;
+    /** When set, a "×" clear button appears in the header */
+    onClear?: () => void;
+    /** When true, the trigger is static (non-collapsible) — useful for single-field sections */
+    collapsible?: boolean;
+    /** Content (form fields) */
+    children?: React$1.ReactNode;
+    className?: string;
+    /** Extra class for the inner content container */
+    contentClassName?: string;
+    /** Optional id for testing / aria */
+    id?: string;
+}
+declare const FilterSection: React$1.ForwardRefExoticComponent<FilterSectionProps & React$1.RefAttributes<HTMLDivElement>>;
+interface FilterPanelTriggerProps extends React$1.ButtonHTMLAttributes<HTMLButtonElement> {
+    /** Active filter count — renders a pill badge next to the label */
+    activeCount?: number;
+    /** Locale for digit formatting and default label @default inherited from FilterPanel context; falls back to "fa" */
+    locale?: SupportedLocale;
+    /** Custom icon element (defaults to SlidersHorizontal) */
+    icon?: React$1.ReactNode;
+    /** Render without icon */
+    hideIcon?: boolean;
+    /** Visual variant — passthrough to Button */
+    variant?: React$1.ComponentProps<typeof Button>['variant'];
+    /** Size — passthrough to Button */
+    size?: React$1.ComponentProps<typeof Button>['size'];
+}
+declare const FilterPanelTrigger: React$1.ForwardRefExoticComponent<FilterPanelTriggerProps & React$1.RefAttributes<HTMLButtonElement>>;
+interface ActiveFiltersBarProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    /** Locale for default empty text */
+    locale?: SupportedLocale;
+    /** Label rendered before chips ("فیلترهای فعال:"). Pass `false` to hide it. */
+    label?: React$1.ReactNode;
+    /** Text when no children are provided */
+    emptyText?: React$1.ReactNode;
+    /** Hide the whole bar when there are no children (instead of showing emptyText) */
+    hideWhenEmpty?: boolean;
+}
+declare const ActiveFiltersBar: React$1.ForwardRefExoticComponent<ActiveFiltersBarProps & React$1.RefAttributes<HTMLDivElement>>;
+interface ActiveFiltersClearAllProps extends Omit<React$1.ButtonHTMLAttributes<HTMLButtonElement>, 'onClick'> {
+    onClear?: () => void;
+    onClick?: React$1.MouseEventHandler<HTMLButtonElement>;
+    locale?: SupportedLocale;
+}
+declare const ActiveFiltersClearAll: React$1.ForwardRefExoticComponent<ActiveFiltersClearAllProps & React$1.RefAttributes<HTMLButtonElement>>;
+
 declare const Form: <TFieldValues extends FieldValues, TContext = any, TTransformedValues = TFieldValues>(props: react_hook_form.FormProviderProps<TFieldValues, TContext, TTransformedValues>) => React$1.JSX.Element;
 declare const FormField: {
     <TFieldValues extends FieldValues = FieldValues, TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>>({ ...props }: ControllerProps<TFieldValues, TName>): react_jsx_runtime.JSX.Element;
@@ -1539,6 +2515,102 @@ declare const TagInput: React$1.ForwardRefExoticComponent<TagInputProps & React$
 
 declare const HashtagInput: React$1.ForwardRefExoticComponent<TagInputProps & React$1.RefAttributes<HTMLDivElement>>;
 
+type CardSize = 'sm' | 'md' | 'lg';
+interface EntityHealthCardProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    /** Current health state — drives colour, icon, and default narrative framing */
+    severity: EntityHealthKey;
+    /** Compact row layout for list views @default "md" */
+    size?: CardSize;
+    /** Render as a clickable element (`role="button"` + focus ring). */
+    interactive?: boolean;
+    /** Locale for default strings + digit formatting @default "fa" */
+    locale?: SupportedLocale;
+    /** Render an accent-coloured left (logical-start) border tied to severity @default true */
+    accentBorder?: boolean;
+}
+declare const EntityHealthCard: React$1.ForwardRefExoticComponent<EntityHealthCardProps & React$1.RefAttributes<HTMLDivElement>>;
+declare const EntityHealthCardHeader: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & React$1.RefAttributes<HTMLDivElement>>;
+declare const EntityHealthCardHeaderText: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & React$1.RefAttributes<HTMLDivElement>>;
+interface EntityHealthCardTitleProps extends React$1.HTMLAttributes<HTMLHeadingElement> {
+    /** Semantic heading level @default "h3" */
+    as?: 'h2' | 'h3' | 'h4';
+}
+declare const EntityHealthCardTitle: React$1.ForwardRefExoticComponent<EntityHealthCardTitleProps & React$1.RefAttributes<HTMLHeadingElement>>;
+declare const EntityHealthCardSubtitle: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLParagraphElement> & React$1.RefAttributes<HTMLParagraphElement>>;
+declare const EntityHealthCardHeaderEnd: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & React$1.RefAttributes<HTMLDivElement>>;
+interface EntityHealthCardSeverityBadgeProps extends React$1.HTMLAttributes<HTMLSpanElement> {
+    /** Hide the text label — keeps the icon and aria-label only */
+    iconOnly?: boolean;
+    /** Size @default "sm" */
+    size?: 'xs' | 'sm' | 'md';
+    /** Override locale for just this badge */
+    locale?: SupportedLocale;
+}
+declare const EntityHealthCardSeverityBadge: React$1.ForwardRefExoticComponent<EntityHealthCardSeverityBadgeProps & React$1.RefAttributes<HTMLSpanElement>>;
+interface EntityHealthCardScoreProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    /** Current score — clamped to [0, max]. */
+    value: number;
+    /** Max score @default 100 */
+    max?: number;
+    /** Leading label (e.g., "نمره سلامت") */
+    label?: React$1.ReactNode;
+    /** Optional delta vs previous period. Positive => up, negative => down. */
+    delta?: number;
+    /** Suffix rendered after the score (e.g., "٪", "/۱۰۰"). Omit for no suffix. */
+    suffix?: React$1.ReactNode;
+    /** Override auto suffix when `suffix` is not provided. Defaults to "/{max}" in localized digits. */
+    showDenominator?: boolean;
+    /** Override the accent colour. Accepts any CSS color. */
+    color?: string;
+}
+declare const EntityHealthCardScore: React$1.ForwardRefExoticComponent<EntityHealthCardScoreProps & React$1.RefAttributes<HTMLDivElement>>;
+declare const EntityHealthCardNarrative: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLParagraphElement> & React$1.RefAttributes<HTMLParagraphElement>>;
+interface EntityHealthCardTrustProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    /** Trust score @range 0..max */
+    value: number;
+    /** Max score @default 100 */
+    max?: number;
+    /** Leading label — defaults to "اعتماد" */
+    label?: React$1.ReactNode;
+    /** Hide the numeric value on the trailing side */
+    hideValue?: boolean;
+    /** Show 25 / 50 / 75 tick marks inside the bar @default true */
+    showMarkers?: boolean;
+    /** Size of the bar @default "sm" */
+    barSize?: 'xs' | 'sm' | 'md';
+    /** Override the bar fill colour */
+    color?: string;
+}
+declare const EntityHealthCardTrust: React$1.ForwardRefExoticComponent<EntityHealthCardTrustProps & React$1.RefAttributes<HTMLDivElement>>;
+interface EntityHealthCardPhaseProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    /** Current day index (1-based). When provided with `total`, a progress bar renders. */
+    day?: number;
+    /** Total days in this phase */
+    total?: number;
+    /** Phase name */
+    phase?: React$1.ReactNode;
+}
+declare const EntityHealthCardPhase: React$1.ForwardRefExoticComponent<EntityHealthCardPhaseProps & React$1.RefAttributes<HTMLDivElement>>;
+interface EntityHealthCardMetricsProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    /** Number of columns @default 2 */
+    columns?: 1 | 2 | 3 | 4;
+}
+declare const EntityHealthCardMetrics: React$1.ForwardRefExoticComponent<EntityHealthCardMetricsProps & React$1.RefAttributes<HTMLDivElement>>;
+interface EntityHealthCardMetricProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    /** Metric label */
+    label: React$1.ReactNode;
+    /** Metric value — primary number or short string */
+    value: React$1.ReactNode;
+    /** Optional trend direction — affects trailing icon colour */
+    trend?: 'up' | 'down' | 'flat';
+    /** Optional trend magnitude shown after the arrow (e.g., "12%") */
+    trendLabel?: React$1.ReactNode;
+}
+declare const EntityHealthCardMetric: React$1.ForwardRefExoticComponent<EntityHealthCardMetricProps & React$1.RefAttributes<HTMLDivElement>>;
+declare const EntityHealthCardFooter: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & React$1.RefAttributes<HTMLDivElement>>;
+declare const EntityHealthCardActions: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & React$1.RefAttributes<HTMLDivElement>>;
+declare const EntityHealthCardMeta: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLParagraphElement> & React$1.RefAttributes<HTMLParagraphElement>>;
+
 interface InputGroupProps extends React$1.ComponentProps<'div'> {
     /**
      * Direction of the input group.
@@ -1599,69 +2671,109 @@ declare namespace InputOTPSeparator {
     var displayName: string;
 }
 
-type MediaType = 'image' | 'video' | 'carousel';
-type AspectRatioType = '16:9' | '9:16' | '1:1' | '4:5' | '5:4';
-interface MediaItem {
-    type: 'image' | 'video';
-    url: string;
-    aspectRatio?: AspectRatioType;
+interface JobCardProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    /** Current lifecycle status — drives colour and badge */
+    status: JobStatusKey;
+    /** Compact single-row layout (for list views) @default false */
+    compact?: boolean;
+    /** When set, the card renders as a clickable element with hover + focus styles. Pure presentational — wire your own handler via onClick. */
+    interactive?: boolean;
+    /** Locale for default strings + digit formatting @default "fa" */
+    locale?: SupportedLocale;
 }
-interface PostStats {
-    likes?: number;
-    comments?: number;
-    views?: number;
-    shares?: number;
+declare const JobCard: React$1.ForwardRefExoticComponent<JobCardProps & React$1.RefAttributes<HTMLDivElement>>;
+declare const JobCardHeader: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & React$1.RefAttributes<HTMLDivElement>>;
+interface JobCardThumbnailProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    /** Image URL. If omitted, `icon` or `fallback` is used. */
+    src?: string;
+    /** Alt text for the image */
+    alt?: string;
+    /** Lucide icon rendered in an outlined tile (used when no src) */
+    icon?: React$1.ComponentType<{
+        className?: string;
+    }>;
+    /** Arbitrary fallback node (letter, emoji, …) */
+    fallback?: React$1.ReactNode;
 }
-type NumberFormat = 'exact' | 'short';
-type TimeFormat = 'absolute' | 'relative';
-interface InstagramProfileInfo {
-    username: string;
-    fullName?: string;
-    profilePicture?: string;
-    avatarUrl?: string;
+declare const JobCardThumbnail: React$1.ForwardRefExoticComponent<JobCardThumbnailProps & React$1.RefAttributes<HTMLDivElement>>;
+declare const JobCardHeaderText: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & React$1.RefAttributes<HTMLDivElement>>;
+interface JobCardTitleProps extends React$1.HTMLAttributes<HTMLHeadingElement> {
+    /** Semantic heading level @default "h3" */
+    as?: 'h2' | 'h3' | 'h4';
+}
+declare const JobCardTitle: React$1.ForwardRefExoticComponent<JobCardTitleProps & React$1.RefAttributes<HTMLHeadingElement>>;
+declare const JobCardSubtitle: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLParagraphElement> & React$1.RefAttributes<HTMLParagraphElement>>;
+declare const JobCardHeaderActions: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & React$1.RefAttributes<HTMLDivElement>>;
+interface JobCardStatusBadgeProps extends React$1.HTMLAttributes<HTMLSpanElement> {
+    /** Hide the text label — keeps the icon and aria-label only */
+    iconOnly?: boolean;
+    /** Size @default "sm" */
+    size?: 'xs' | 'sm' | 'md';
+    /** Override locale for just this badge */
+    locale?: SupportedLocale;
 }
-interface InstagramPostProps extends React$1.HTMLAttributes<HTMLDivElement>, VariantProps<typeof instagramPostVariants> {
-    dir?: 'rtl' | 'ltr';
-    media?: MediaItem[];
-    mediaType?: MediaType;
-    postType?: 'image' | 'video' | 'carousel';
-    caption?: string;
-    showCaption?: boolean;
-    stats?: PostStats;
-    numberFormat?: NumberFormat;
-    showLikes?: boolean;
-    showComments?: boolean;
-    showViews?: boolean;
-    showShares?: boolean;
-    publishTime?: Date | string | number;
-    timeFormat?: TimeFormat;
-    profile?: InstagramProfileInfo;
-    showProfile?: boolean;
-    avatarUrl?: string;
-    showActions?: boolean;
-    /** Show loading skeleton state */
-    isLoading?: boolean;
-    onCommentAnalyzer?: () => void;
-    onBooster?: () => void;
-    onAIAnalysis?: () => void;
-    onOpenInstagram?: () => void;
-    instagramUrl?: string;
-    disableCommentAnalyzer?: boolean;
-    disableBooster?: boolean;
-    disableAIAnalysis?: boolean;
-    disableOpenInstagram?: boolean;
-    placeholderText?: string;
-    /** Locale for UI strings @default 'fa' */
+declare const JobCardStatusBadge: React$1.ForwardRefExoticComponent<JobCardStatusBadgeProps & React$1.RefAttributes<HTMLSpanElement>>;
+/**
+ * Wrapper for action buttons. If the parent `<JobCard interactive>` is
+ * clickable, child button clicks would otherwise bubble up and trigger
+ * the card's handler. Wrap your buttons here and we add role="group"
+ * semantics; stop event propagation at the Button's own onClick when
+ * needed to avoid conflicting with card activation.
+ */
+declare const JobCardActions: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & React$1.RefAttributes<HTMLDivElement>>;
+interface JobCardProgressProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    /** Current value — if omitted (and not indeterminate), renders a 0% bar */
+    value?: number;
+    /** Max value @default 100 */
+    max?: number;
+    /** Render an animated indeterminate shimmer. Overrides `value`. */
+    indeterminate?: boolean;
+    /** Leading text label */
+    label?: React$1.ReactNode;
+    /** Force-hide the percentage text on the trailing end */
+    hideValueText?: boolean;
+    /** Override the bar colour (e.g. for `paused` state). Accepts a CSS value. */
+    color?: string;
+    /** Size of the bar @default "sm" */
+    size?: 'xs' | 'sm' | 'md';
+}
+declare const JobCardProgress: React$1.ForwardRefExoticComponent<JobCardProgressProps & React$1.RefAttributes<HTMLDivElement>>;
+declare const JobCardMeta: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDListElement> & React$1.RefAttributes<HTMLDListElement>>;
+interface JobCardMetaItemProps {
+    /** Lucide icon — usually Calendar, Clock, User, … */
+    icon?: React$1.ComponentType<{
+        className?: string;
+    }>;
+    /** Field label */
+    label: React$1.ReactNode;
+    /** Field value */
+    value: React$1.ReactNode;
+    /** Use `<time dateTime={...}>` for value (screen readers + copy behaviour) */
+    dateTime?: string;
+    className?: string;
+}
+declare const JobCardMetaItem: React$1.ForwardRefExoticComponent<JobCardMetaItemProps & React$1.RefAttributes<HTMLDivElement>>;
+interface JobCardStatsProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    /** Layout columns @default auto */
+    columns?: 2 | 3 | 4 | 'auto';
+}
+declare const JobCardStats: React$1.ForwardRefExoticComponent<JobCardStatsProps & React$1.RefAttributes<HTMLDivElement>>;
+interface JobCardStatProps {
+    label: React$1.ReactNode;
+    /** Current value */
+    value: number;
+    /** Total — renders as "value / total" when provided */
+    total?: number;
+    /** Value formatting locale. Defaults to JobCard context. */
     locale?: SupportedLocale;
-    /** Text for "show more" button @default "بیشتر" */
-    showMoreText?: string;
-    /** Text for "show less" button @default "کمتر" */
-    showLessText?: string;
+    /** Semantic tone applied to the value */
+    variant?: 'default' | 'positive' | 'warning' | 'destructive' | 'muted';
+    /** Pre-formatted override — bypasses number formatting */
+    formatted?: React$1.ReactNode;
+    className?: string;
 }
-declare const instagramPostVariants: (props?: ({
-    variant?: "horizontal" | "vertical" | null | undefined;
-} & class_variance_authority_types.ClassProp) | undefined) => string;
-declare const InstagramPost: React$1.ForwardRefExoticComponent<InstagramPostProps & React$1.RefAttributes<HTMLDivElement>>;
+declare const JobCardStat: React$1.ForwardRefExoticComponent<JobCardStatProps & React$1.RefAttributes<HTMLDivElement>>;
+declare const JobCardError: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & React$1.RefAttributes<HTMLDivElement>>;
 
 declare function Kbd({ className, ...props }: React$1.ComponentProps<'kbd'>): react_jsx_runtime.JSX.Element;
 declare namespace Kbd {
@@ -1852,6 +2964,100 @@ 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;
@@ -1962,47 +3168,513 @@ declare const PopoverTrigger: React$1.ForwardRefExoticComponent<PopoverPrimitive
 declare const PopoverAnchor: React$1.ForwardRefExoticComponent<PopoverPrimitive.PopoverAnchorProps & React$1.RefAttributes<HTMLDivElement>>;
 declare const PopoverContent: React$1.ForwardRefExoticComponent<Omit<PopoverPrimitive.PopoverContentProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 
-declare const profileCardVariants: (props?: ({
-    variant?: "default" | "transparent" | "dark" | null | undefined;
-    size?: "sm" | "md" | "lg" | null | undefined;
-} & class_variance_authority_types.ClassProp) | undefined) => string;
-interface ProfileCardProps extends React$1.HTMLAttributes<HTMLDivElement> {
-    /**
-     * نام کامل کاربر
-     */
-    name: string;
-    /**
-     * نام کاربری (username)
-     */
-    username: string;
-    /**
-     * آدرس تصویر پروفایل
-     */
-    avatarSrc?: string;
-    /**
-     * متن جایگزین برای تصویر
-     */
-    avatarAlt?: string;
+/**
+ * PartoHeatMap — brand-tinted heatmap with rounded cells, clean axis,
+ * glassmorphic tooltip, and locale-aware formatting.
+ * Built with Visx scales + raw SVG for full control.
+ */
+interface HeatMapDatum {
+    x: string | number;
+    y: number;
+}
+interface HeatMapRow {
+    id: string;
+    data: HeatMapDatum[];
+}
+interface PartoHeatMapProps {
+    data: HeatMapRow[];
+    locale?: 'fa' | 'en';
+    className?: string;
+    isLoading?: boolean;
+    ariaLabel?: string;
+    margin?: {
+        top: number;
+        right: number;
+        bottom: number;
+        left: number;
+    };
+    /** Custom color function: receives value and max → returns CSS color */
+    colorScale?: (value: number, max: number) => string;
+    /** Cell border radius */
+    cellRadius?: number;
+    /** Gap between cells */
+    cellGap?: number;
+    /** Custom tooltip content */
+    renderTooltip?: (cell: {
+        rowId: string;
+        x: string | number;
+        value: number;
+        color: string;
+    }) => React$1.ReactNode;
+    /** X axis label */
+    xAxisLabel?: string;
+    /** Y axis label */
+    yAxisLabel?: string;
+    /** Filter which x-axis ticks to show */
+    xTickFilter?: (value: string | number, index: number) => boolean;
+}
+declare const PartoHeatMap: React$1.ForwardRefExoticComponent<PartoHeatMapProps & React$1.RefAttributes<HTMLDivElement>>;
+
+type PostingWeekStart = 'saturday' | 'sunday' | 'monday';
+interface PostingFrequencyCell {
+    /** Day of week — 0-6. What "0" means depends on `weekStart`. */
+    dayOfWeek: number;
+    /** Hour of day — 0-23 in the display timezone. */
+    hour: number;
+    /** Metric value (typically post count, can also be comments/likes avg). */
+    value: number;
+}
+interface PostingFrequencySummary {
+    /** 0–100 composite consistency score (activeDaysRatio + regularity + gap-penalty). */
+    consistencyScore?: number;
+    /** Longest inactivity gap, expressed in **days**. */
+    maxGapDays?: number;
+    /** 0–100 % of days that contain ≥1 post in the analysis window. */
+    activeDaysRatio?: number;
+    /** Total posts in the window (optional, for context in the header). */
+    totalPosts?: number;
+}
+/**
+ * Normalize a sparse `PostingFrequencyCell[]` into a full 7×24 grid of
+ * `HeatMapRow`s ordered by `weekStart`. Missing cells are filled with value=0.
+ * Each row's `id` is the English weekday name, matching PartoHeatMap's
+ * internal weekday mapping.
+ */
+declare function buildPostingFrequencyRows(data: PostingFrequencyCell[], weekStart?: PostingWeekStart): HeatMapRow[];
+interface PostingFrequencyHeatmapProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, 'title'> {
+    /** Per-cell activity. Sparse input is fine — missing cells render as 0. */
+    data: PostingFrequencyCell[];
+    /** Which day logically occupies row 0. @default "saturday" for fa/ar, "sunday" for en. */
+    weekStart?: PostingWeekStart;
+    /** Optional summary stats shown in the header row. */
+    summary?: PostingFrequencySummary;
+    /** Card title. */
+    title?: React$1.ReactNode;
+    /** Short description below title. */
+    description?: React$1.ReactNode;
     /**
-     * حروف اولیه برای fallback (اختیاری)
+     * Metric label for the tooltip (e.g., "پست", "نظر", "لایک"). Default uses
+     * the locale-specific "Posts" label.
      */
-    initials?: string;
+    metricLabel?: React$1.ReactNode;
+    /** Show the summary row @default true (when `summary` is provided) */
+    showSummary?: boolean;
+    /** Height of the heatmap chart in px @default 240 */
+    chartHeight?: number;
+    /** Loading state */
+    isLoading?: boolean;
+    /** Locale @default "fa" */
+    locale?: SupportedLocale;
     /**
-     * تعداد فالوورها
+     * Custom PartoHeatMap props to pass through (e.g., colorScale override,
+     * margin). Avoid setting `data` / `locale` here; use the outer props.
      */
+    heatmapProps?: Omit<PartoHeatMapProps, 'data' | 'locale' | 'isLoading' | 'renderTooltip'>;
+}
+declare const PostingFrequencyHeatmap: React$1.ForwardRefExoticComponent<PostingFrequencyHeatmapProps & React$1.RefAttributes<HTMLDivElement>>;
+
+/**
+ * Platform sources supported by `<PostCard>`. Extends the existing `SocialPlatform`
+ * for Phase 1; additional sources (`facebook`, `news`, `tv`, `radio`) land in Phase 2
+ * together with the `SocialPlatformBadge` extension.
+ */
+type PostPlatform = SocialPlatform;
+type PostDensity = 'compact' | 'comfortable';
+type PostSentiment = 'positive' | 'negative' | 'neutral' | 'mixed';
+interface PostAuthor {
+    name: string;
+    handle?: string;
+    avatarUrl?: string;
+    verified?: boolean;
+    /** Optional follower / subscriber count — used in PostDetailsModal sidebar. */
     followers?: number;
-    /**
-     * آیکون فالوور
-     */
-    followersIcon?: React$1.ReactNode;
-    /**
-     * تابع کلیک روی کارت
-     */
-    onCardClick?: () => void;
-    /**
-     * استایل حاشیه آواتار
-     */
-    avatarBorderVariant?: 'gold' | 'primary' | 'none';
+}
+interface PostMetrics {
+    views?: number;
+    likes?: number;
+    comments?: number;
+    shares?: number;
+    /** Estimated reach / potential audience. */
+    reach?: number;
+    /** Engagement rate as a 0..1 decimal (e.g. 0.034 = 3.4%). */
+    engagementRate?: number;
+}
+interface PostTag {
+    id: string;
+    label: string;
+    /** Optional CSS var (e.g. `--chart-1`) or hex color. Auto-assigned from label if omitted. */
+    color?: string;
+}
+/**
+ * Flags indicate which enrichments the product has attached to this post.
+ * Consumers set these to show the matching chip in `<PostHeader>`.
+ */
+interface PostEnrichmentFlags {
+    ocr?: boolean;
+    transcript?: boolean;
+    aiAnalysis?: boolean;
+    commentCount?: number;
+}
+interface PostMediaItem {
+    url: string;
+    thumbnailUrl?: string;
+    /** Natural aspect ratio (width / height). If omitted, defaults to 1. */
+    aspectRatio?: number;
+    alt?: string;
+    type?: 'image' | 'video';
+    /** Duration in seconds for video. */
+    duration?: number;
+}
+type PostBodyData = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'media-single';
+    media: PostMediaItem;
+    caption?: string;
+} | {
+    type: 'media-carousel';
+    items: PostMediaItem[];
+    caption?: string;
+} | {
+    type: 'video';
+    media: PostMediaItem;
+    caption?: string;
+} | {
+    type: 'missing-media';
+    caption?: string;
+    reason?: string;
+};
+interface PostData {
+    id: string;
+    source: PostPlatform;
+    author: PostAuthor;
+    /** Post creation time. Accepts Date, ISO string, or unix ms. */
+    timestamp: Date | string | number;
+    body: PostBodyData;
+    metrics?: PostMetrics;
+    sentiment?: PostSentiment;
+    enrichments?: PostEnrichmentFlags;
+    /** User-defined category tags (topic, campaign, issue type). */
+    tags?: PostTag[];
+    /** Authority / influence score 0..100 — used to flag high-impact mentions. */
+    authorityScore?: number;
+    /** ISO language code detected for the post. */
+    language?: string;
+    /** URL to the post at the source platform (used by default "view at source" action). */
+    sourceUrl?: string;
+}
+interface PostAction {
+    id: string;
+    label: string;
+    icon: LucideIcon;
+    variant?: 'default' | 'danger';
+    onClick: (post: PostData) => void;
+    disabled?: boolean;
+    hidden?: boolean;
+}
+interface PostCommentAuthor {
+    name: string;
+    handle?: string;
+    avatarUrl?: string;
+    verified?: boolean;
+}
+interface PostComment {
+    id: string;
+    author: PostCommentAuthor;
+    text: string;
+    timestamp: Date | string | number;
+    sentiment?: PostSentiment;
+    likes?: number;
+    replies?: PostComment[];
+    /** Pinned by post author (Instagram, YouTube). */
+    pinned?: boolean;
+    /** Indicates this is a reply from the original post author. */
+    authorReply?: boolean;
+}
+type PostEmotion = 'anger' | 'anticipation' | 'joy' | 'trust' | 'fear' | 'surprise' | 'sadness' | 'disgust' | 'neutral';
+type PostIntent = 'complaint' | 'praise' | 'question' | 'announcement' | 'comparison' | 'opinion' | 'info';
+interface PostAiEntity {
+    text: string;
+    type: 'person' | 'brand' | 'place' | 'product' | 'event' | 'organization';
+}
+interface PostAiAnalysis {
+    /** Auto-generated summary of the post. */
+    summary?: string;
+    /** Key topics mentioned in the post. */
+    topics?: string[];
+    /** Named entities detected. */
+    entities?: PostAiEntity[];
+    /** Primary intent classification. */
+    intent?: PostIntent;
+    /** 9-class emotion distribution (raw counts or normalized). */
+    emotions?: Partial<Record<PostEmotion, number>>;
+    /** Flagged risks / sensitive content categories. */
+    risks?: string[];
+    /** Influence tier estimate for the author. */
+    influenceTier?: 'nano' | 'micro' | 'macro' | 'mega';
+    /** Model confidence 0..1 for overall analysis. */
+    confidence?: number;
+    /** Analysis generation timestamp. */
+    generatedAt?: Date | string | number;
+}
+/** Platform-specific metadata, discriminated by `platform` (matches `PostData.source`). */
+type PlatformMetadata = {
+    platform: 'instagram';
+    postType?: 'feed' | 'reel' | 'story' | 'carousel' | 'igtv';
+    location?: string;
+    music?: {
+        title: string;
+        artist?: string;
+    };
+    saveCount?: number;
+    collaborators?: string[];
+    /** Hashtags used in the post. */
+    hashtags?: string[];
+} | {
+    platform: 'twitter';
+    tweetType?: 'original' | 'retweet' | 'quote' | 'reply';
+    quotedTweetUrl?: string;
+    inReplyTo?: string;
+    retweetCount?: number;
+    quoteCount?: number;
+    bookmarkCount?: number;
+    isThread?: boolean;
+    /** Count of additional posts in the thread. */
+    threadLength?: number;
+} | {
+    platform: 'youtube';
+    videoType?: 'video' | 'short' | 'live' | 'premiere';
+    channelSubscribers?: number;
+    dislikes?: number;
+    category?: string;
+    tags?: string[];
+} | {
+    platform: 'telegram';
+    channelName?: string;
+    channelSubscribers?: number;
+    forwardCount?: number;
+    isChannel?: boolean;
+    /** Map of emoji → count, e.g. { '👍': 42, '❤️': 12 }. */
+    reactionCounts?: Record<string, number>;
+} | {
+    platform: 'tiktok';
+    videoType?: 'video' | 'duet' | 'stitch' | 'live';
+    music?: {
+        title: string;
+        artist?: string;
+    };
+    duetWith?: string;
+    saveCount?: number;
+    effects?: string[];
+} | {
+    platform: 'linkedin';
+    postType?: 'post' | 'article' | 'poll' | 'document';
+    reactions?: {
+        like?: number;
+        celebrate?: number;
+        support?: number;
+        love?: number;
+        insightful?: number;
+        funny?: number;
+    };
+    repostCount?: number;
+    industry?: string;
+} | {
+    platform: 'threads';
+    replyControls?: 'anyone' | 'followed' | 'mentioned';
+    repostCount?: number;
+    quoteCount?: number;
+};
+/** Extended post details — optionally attached to PostData when fetching full view. */
+interface PostDetails {
+    comments?: PostComment[];
+    aiAnalysis?: PostAiAnalysis;
+    /** Text extracted from images via OCR. */
+    ocrText?: string;
+    /** Transcript for audio / video content. */
+    transcript?: string;
+    /** Platform-specific metadata block. */
+    platformMeta?: PlatformMetadata;
+}
+
+declare const postCardVariants: (props?: ({
+    density?: "compact" | "comfortable" | null | undefined;
+    selected?: boolean | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface PostCardProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, 'onSelect'>, VariantProps<typeof postCardVariants> {
+    post: PostData;
+    density?: PostDensity;
+    selected?: boolean;
+    read?: boolean;
+    actions?: PostAction[];
+    onOpen?: (post: PostData) => void;
+    onSelect?: (post: PostData, selected: boolean) => void;
+    selectable?: boolean;
+    /** Fired when user clicks the details action (Maximize2 icon). Wires up the default details action. */
+    onOpenDetails?: (post: PostData) => void;
+}
+declare function defaultActions(handlers?: {
+    onOpenDetails?: (post: PostData) => void;
+}): PostAction[];
+declare const PostCard: React$1.ForwardRefExoticComponent<PostCardProps & React$1.RefAttributes<HTMLDivElement>>;
+
+declare const postHeaderVariants: (props?: ({
+    density?: "compact" | "comfortable" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface PostHeaderProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, 'children'>, VariantProps<typeof postHeaderVariants> {
+    author: PostAuthor;
+    platform: PostPlatform;
+    timestamp: Date | string | number;
+    sentiment?: PostSentiment;
+    enrichments?: PostEnrichmentFlags;
+    density?: PostDensity;
+    /** Override avatar size. */
+    avatarClassName?: string;
+}
+declare const PostHeader: React$1.ForwardRefExoticComponent<PostHeaderProps & React$1.RefAttributes<HTMLDivElement>>;
+
+/**
+ * Aspect-ratio helpers for post media.
+ *
+ * Platforms deliver media in many ratios (1:1, 4:5, 9:16, 16:9, …). The post
+ * component system normalizes aspect ratios per display context so a feed of
+ * mixed content looks consistent without cropping away information.
+ *
+ * Rules (spec §Aspect-Ratio Handling):
+ *  - `compact`    → always 1:1 thumbnail (center-crop via object-cover).
+ *  - `comfortable` → container clamps aspect to [4:5, 16:9]; media inside is
+ *                    letterboxed via `object-contain` so nothing is cropped.
+ *                    Callers typically render a blurred backdrop of the same
+ *                    media behind the letterboxed image to fill empty space.
+ *  - `detail`     → preserve natural ratio; cap max-h-[70vh] for tall portraits.
+ */
+type AspectContext = 'compact' | 'comfortable' | 'detail';
+
+interface PostBodyProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    body: PostBodyData;
+    /** Display context — drives aspect handling + text clamping. */
+    context: AspectContext;
+    /** Compact mode shows only a thumbnail; body text is rendered by parent. */
+    thumbnailOnly?: boolean;
+}
+declare const PostBody: React$1.ForwardRefExoticComponent<PostBodyProps & React$1.RefAttributes<HTMLDivElement>>;
+
+interface PostActionsProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    post: PostData;
+    actions: PostAction[];
+    /** Number of primary (inline) actions to render. Remaining flow into the overflow menu. */
+    primaryCount?: number;
+    /** Compact layout hides inline labels, shows icon-only buttons. */
+    compact?: boolean;
+}
+declare const PostActions: React$1.ForwardRefExoticComponent<PostActionsProps & React$1.RefAttributes<HTMLDivElement>>;
+
+interface PostMetadataProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    metrics?: PostMetrics;
+    sentiment?: PostSentiment;
+    density?: PostDensity;
+    /** Hide the sentiment badge (dot still rendered in header in compact mode). */
+    hideSentiment?: boolean;
+}
+declare const PostMetadata: React$1.ForwardRefExoticComponent<PostMetadataProps & React$1.RefAttributes<HTMLDivElement>>;
+
+interface PostListProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, 'onSelect'> {
+    posts: PostData[];
+    /** Controlled density. If omitted, the list manages its own state (persisted to localStorage). */
+    density?: PostDensity;
+    onDensityChange?: (density: PostDensity) => void;
+    /** ID of the currently open/selected post (for URL deep-linking). */
+    activeId?: string;
+    /** IDs of posts that have been visited (visual "read" state). */
+    readIds?: ReadonlyArray<string> | ReadonlySet<string>;
+    /** IDs of selected posts for bulk actions. */
+    selectedIds?: ReadonlyArray<string> | ReadonlySet<string>;
+    onSelectedIdsChange?: (ids: string[]) => void;
+    onOpen?: (post: PostData) => void;
+    /** Fired when the user triggers the default "view details" action on any card. */
+    onOpenDetails?: (post: PostData) => void;
+    /** Per-post action set. If omitted, each card uses its defaults. */
+    actions?: PostAction[];
+    /** Render the density toggle in the toolbar. Defaults to true. */
+    showToolbar?: boolean;
+    /** Custom toolbar content rendered next to the density toggle. */
+    toolbarExtra?: React$1.ReactNode;
+}
+declare const PostList: React$1.ForwardRefExoticComponent<PostListProps & React$1.RefAttributes<HTMLDivElement>>;
+
+type PostDetailsTab = 'post' | 'comments' | 'analysis' | 'transcript';
+interface PostDetailsModalProps {
+    /** Controls modal open state. */
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    /** The post being viewed. If null/undefined, the modal renders nothing. */
+    post?: PostData | null;
+    /** Extended details — comments, AI analysis, OCR, platform metadata. */
+    details?: PostDetails;
+    /** Callback when user opens the source. Falls back to `post.sourceUrl`. */
+    onOpenSource?: (post: PostData) => void;
+    /** Loading state — true while fetching extended details. */
+    isLoading?: boolean;
+    /** Error state — when set, renders an error panel with optional retry. */
+    error?: string | Error | null;
+    /** Fires when user clicks "retry" on the error panel. */
+    onRetry?: () => void;
+    /** Which tab to open first @default "post" */
+    defaultTab?: PostDetailsTab;
+    /** Dialog size. @default "lg" (~1024px) */
+    size?: 'md' | 'lg' | 'xl';
+    /** Show the bookmark toggle. When `onBookmark` is set, the button appears. */
+    bookmarked?: boolean;
+    onBookmark?: (post: PostData, next: boolean) => void;
+    /** Override default clipboard writer. */
+    onCopyLink?: (post: PostData, url: string) => void;
+    /** Extra action slot (rendered at logical-end of the top action bar — e.g. a dropdown/"more" menu). */
+    headerActions?: React$1.ReactNode;
+}
+declare const PostDetailsModal: React$1.FC<PostDetailsModalProps>;
+
+declare const profileCardVariants: (props?: ({
+    variant?: "default" | "transparent" | "dark" | null | undefined;
+    size?: "sm" | "md" | "lg" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface ProfileCardProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    /**
+     * نام کامل کاربر
+     */
+    name: string;
+    /**
+     * نام کاربری (username)
+     */
+    username: string;
+    /**
+     * آدرس تصویر پروفایل
+     */
+    avatarSrc?: string;
+    /**
+     * متن جایگزین برای تصویر
+     */
+    avatarAlt?: string;
+    /**
+     * حروف اولیه برای fallback (اختیاری)
+     */
+    initials?: string;
+    /**
+     * تعداد فالوورها
+     */
+    followers?: number;
+    /**
+     * آیکون فالوور
+     */
+    followersIcon?: React$1.ReactNode;
+    /**
+     * تابع کلیک روی کارت
+     */
+    onCardClick?: () => void;
+    /**
+     * استایل حاشیه آواتار
+     */
+    avatarBorderVariant?: 'gold' | 'primary' | 'none';
     /**
      * اندازه کامپوننت
      */
@@ -2111,6 +3783,71 @@ interface EngagementRateProps extends React$1.HTMLAttributes<HTMLDivElement> {
 }
 declare const EngagementRate: React$1.ForwardRefExoticComponent<EngagementRateProps & React$1.RefAttributes<HTMLDivElement>>;
 
+interface BenchmarkTier {
+    /** Optional label shown below the segment (e.g., "عالی"). */
+    label?: React$1.ReactNode;
+    /** Inclusive upper bound of this tier. Use Infinity for the last tier. */
+    max: number;
+    /** CSS color — accepts any CSS value, including `hsl(var(--token))`. */
+    color: string;
+}
+interface BenchmarkMarker {
+    /** Position on the scale. Clamped to [min, max]. */
+    value: number;
+    /** Optional label shown above the marker (e.g., "میانگین صنعت"). */
+    label?: React$1.ReactNode;
+    /** Override the marker colour @default foreground */
+    color?: string;
+}
+/**
+ * Default 4-tier benchmark for engagement rate (percent). Thresholds picked
+ * for general social media (Instagram/Twitter/YouTube) — override with
+ * `getEngagementRateBenchmarkTiers` for follower-tiered thresholds.
+ *
+ * - 0–1%   → poor
+ * - 1–2.5% → moderate
+ * - 2.5–5% → good
+ * - >5%    → excellent
+ */
+declare function getEngagementRateBenchmarkTiers(locale?: SupportedLocale): BenchmarkTier[];
+/**
+ * Default 4-tier for a 0-100 score scale (e.g., Page Evaluation overall score).
+ * Thresholds: <40 poor, 40-60 moderate, 60-80 good, >=80 excellent.
+ */
+declare function getScoreBenchmarkTiers(locale?: SupportedLocale): BenchmarkTier[];
+/** Find which tier index contains value `v`. */
+declare function findTierIndex(value: number, tiers: BenchmarkTier[]): number;
+interface EngagementRateBenchmarkProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    /** The value to mark on the scale (typically engagement rate in %). */
+    value: number;
+    /** Scale start @default 0 */
+    min?: number;
+    /** Scale end @default 10 (engagement rate %) */
+    max?: number;
+    /** Tier segments. Must be ordered by ascending `max`. @default getEngagementRateBenchmarkTiers(locale) */
+    tiers?: BenchmarkTier[];
+    /** Optional comparison markers (industry average, target, …) */
+    benchmarks?: BenchmarkMarker[];
+    /**
+     * Label for the primary value marker. If omitted, renders the value with
+     * localized digits + "٪" (fa/ar) or "%" (en).
+     */
+    valueLabel?: React$1.ReactNode;
+    /** Show the numeric min/max under the bar @default true */
+    showScale?: boolean;
+    /** Show tier labels below each segment @default false */
+    showTierLabels?: boolean;
+    /** Bar height @default "md" */
+    size?: 'sm' | 'md' | 'lg';
+    /** Hide the primary value marker (e.g., when rendering multiple benchmarks only) */
+    hideValueMarker?: boolean;
+    /** Locale for digit + default label formatting @default "fa" */
+    locale?: SupportedLocale;
+    /** Number of decimals for scale labels @default 0 or 1 depending on max */
+    scaleDecimals?: number;
+}
+declare const EngagementRateBenchmark: React$1.ForwardRefExoticComponent<EngagementRateBenchmarkProps & React$1.RefAttributes<HTMLDivElement>>;
+
 interface EngagementRateBarProps extends React$1.HTMLAttributes<HTMLDivElement> {
     /**
      * نرخ تعامل فعلی (به صورت عدد اعشاری، مثلاً 0.05710 برای 5.710%)
@@ -2147,7 +3884,7 @@ declare const progressVariants: (props?: ({
     size?: "sm" | "md" | "lg" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 declare const progressIndicatorVariants: (props?: ({
-    variant?: "success" | "warning" | "destructive" | "primary" | "secondary" | null | undefined;
+    variant?: "warning" | "success" | "destructive" | "primary" | "secondary" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 interface ProgressProps extends React$1.ComponentProps<typeof ProgressPrimitive.Root>, VariantProps<typeof progressVariants>, VariantProps<typeof progressIndicatorVariants> {
     label?: string;
@@ -2155,9 +3892,82 @@ interface ProgressProps extends React$1.ComponentProps<typeof ProgressPrimitive.
 }
 declare const Progress: React$1.ForwardRefExoticComponent<Omit<ProgressProps, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 
+interface QuotaThresholds {
+    /** Ratio (0..1) at which bar turns amber. @default 0.7 */
+    amber: number;
+    /** Ratio (0..1) at which bar turns orange. @default 0.9 */
+    orange: number;
+    /** Ratio (0..1) at which bar turns destructive. @default 1 */
+    red: number;
+}
+declare const DEFAULT_THRESHOLDS: QuotaThresholds;
+type QuotaLevel = 'ok' | 'amber' | 'orange' | 'red';
+declare function resolveLevel(ratio: number, thresholds: QuotaThresholds): QuotaLevel;
+interface QuotaProgressBarProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    /** Units consumed so far (clamped to >= 0). */
+    used: number;
+    /** Total units allowed. Must be > 0. */
+    limit: number;
+    /** Optional label shown before the bar (e.g., "لایک روزانه") */
+    label?: React$1.ReactNode;
+    /**
+     * When set, renders a colour-coded dot + default label ("پسندیدن"/"Like"/…).
+     * Convenience for quota-by-action-type display; skip for generic quotas.
+     */
+    actionType?: ActionTypeKey;
+    /** Show `used / limit` text on trailing end @default true */
+    showCount?: boolean;
+    /** Show percentage next to count @default false */
+    showPercent?: boolean;
+    /** Show ⚠ icon when the bar is at `orange` or `red` level @default true */
+    showWarningIcon?: boolean;
+    /** Bar height @default "sm" */
+    size?: 'xs' | 'sm' | 'md' | 'lg';
+    /**
+     * Override colour thresholds. Ratios are `used / limit`. Defaults:
+     * - amber: 0.7, orange: 0.9, red: 1.
+     */
+    thresholds?: Partial<QuotaThresholds>;
+    /** Locale for digit + default label formatting @default "fa" */
+    locale?: SupportedLocale;
+    /**
+     * Allow the bar to visually extend past 100% when quota is over-consumed.
+     * When `true`, the fill stays at 100% of the track but a repeating stripe
+     * pattern + red glow signals overflow. @default false (clamp to 100%)
+     */
+    showOverflow?: boolean;
+}
+declare const QuotaProgressBar: React$1.ForwardRefExoticComponent<QuotaProgressBarProps & React$1.RefAttributes<HTMLDivElement>>;
+
 declare const RadioGroup: React$1.ForwardRefExoticComponent<Omit<RadioGroupPrimitive.RadioGroupProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 declare const RadioGroupItem: React$1.ForwardRefExoticComponent<Omit<RadioGroupPrimitive.RadioGroupItemProps & React$1.RefAttributes<HTMLButtonElement>, "ref"> & React$1.RefAttributes<HTMLButtonElement>>;
 
+interface RateLimitBannerProps extends Omit<BannerProps, 'variant' | 'icon' | 'action' | 'children'> {
+    /** When the cooldown ends — Date, ISO string, or epoch ms */
+    resumeAt: Date | string | number;
+    /** Which action is rate-limited — renders in the title (e.g., «پسندیدن متوقف شده») */
+    actionType?: ActionTypeKey;
+    /** Short explanation (1-2 sentences). Falls back to a locale-specific generic. */
+    reason?: React$1.ReactNode;
+    /**
+     * Whether to re-render every second so the countdown ticks live.
+     * @default true
+     */
+    live?: boolean;
+    /** Visual tone @default "destructive" */
+    variant?: 'destructive' | 'warning';
+    /**
+     * Callback to retry the operation now (ignores cooldown). Rendered as an
+     * action button when provided.
+     */
+    onRetryNow?: () => void;
+    /** Override label for the retry button */
+    retryLabel?: React$1.ReactNode;
+    /** Locale for default strings + countdown @default "fa" */
+    locale?: SupportedLocale;
+}
+declare const RateLimitBanner: React$1.ForwardRefExoticComponent<RateLimitBannerProps & React$1.RefAttributes<HTMLDivElement>>;
+
 declare const RadioCards: React$1.ForwardRefExoticComponent<Omit<RadioGroupPrimitive.RadioGroupProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & {
     columns?: number;
     dir?: "rtl" | "ltr";
@@ -2269,12 +4079,23 @@ type SidebarContextProps = {
     setOpenMobile: (open: boolean) => void;
     isMobile: boolean;
     toggleSidebar: () => void;
+    /**
+     * When true, the sidebar is positioned absolutely within its parent wrapper
+     * instead of fixed to the viewport. Use inside bounded previews, cards,
+     * or anywhere the sidebar should not escape its container.
+     */
+    contained: boolean;
 };
 declare function useSidebar(): SidebarContextProps;
-declare function SidebarProvider({ defaultOpen, open: openProp, onOpenChange: setOpenProp, className, style, children, ...props }: React$1.ComponentProps<'div'> & {
+declare function SidebarProvider({ defaultOpen, open: openProp, onOpenChange: setOpenProp, contained, className, style, children, ...props }: React$1.ComponentProps<'div'> & {
     defaultOpen?: boolean;
     open?: boolean;
     onOpenChange?: (open: boolean) => void;
+    /**
+     * When true, the sidebar is positioned absolutely within this provider
+     * instead of fixed to the viewport. Use inside bounded previews or cards.
+     */
+    contained?: boolean;
 }): react_jsx_runtime.JSX.Element;
 declare function Sidebar({ side, variant, collapsible, className, children, ...props }: React$1.ComponentProps<'div'> & {
     side?: 'left' | 'right';
@@ -2410,6 +4231,85 @@ declare function TableSkeleton({ rows, className }: TableSkeletonProps): react_j
 declare namespace TableSkeleton {
     var displayName: string;
 }
+interface TableRowSkeletonProps {
+    /** Number of cells in the row */
+    cells?: number;
+    className?: string;
+}
+declare function TableRowSkeleton({ cells, className }: TableRowSkeletonProps): react_jsx_runtime.JSX.Element;
+declare namespace TableRowSkeleton {
+    var displayName: string;
+}
+interface CardSkeletonProps {
+    /** Show a leading image/thumbnail block @default false */
+    withImage?: boolean;
+    /** Aspect ratio of the image (when withImage) @default 'video' */
+    imageAspect?: 'video' | 'square' | 'wide';
+    /** Number of body lines @default 2 */
+    bodyLines?: number;
+    /** Show a footer row (button-shaped placeholder) @default false */
+    withFooter?: boolean;
+    className?: string;
+}
+declare function CardSkeleton({ withImage, imageAspect, bodyLines, withFooter, className, }: CardSkeletonProps): react_jsx_runtime.JSX.Element;
+declare namespace CardSkeleton {
+    var displayName: string;
+}
+interface AvatarTextSkeletonProps {
+    /** Avatar size @default 'md' */
+    size?: 'sm' | 'md' | 'lg';
+    /** Number of text lines beside the avatar @default 2 */
+    lines?: number;
+    className?: string;
+}
+declare function AvatarTextSkeleton({ size, lines, className }: AvatarTextSkeletonProps): react_jsx_runtime.JSX.Element;
+declare namespace AvatarTextSkeleton {
+    var displayName: string;
+}
+interface FormRowSkeletonProps {
+    /** Field shape — 'input' (one-line), 'textarea' (3-line), 'select' (input + chevron) */
+    field?: 'input' | 'textarea' | 'select';
+    /** Show help text line below input @default false */
+    withHelp?: boolean;
+    className?: string;
+}
+declare function FormRowSkeleton({ field, withHelp, className }: FormRowSkeletonProps): react_jsx_runtime.JSX.Element;
+declare namespace FormRowSkeleton {
+    var displayName: string;
+}
+
+type SparklineTrend = 'up' | 'down' | 'neutral' | 'auto';
+type SparklineVariant = 'line' | 'area' | 'bars';
+interface SparklineProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    /** Array of numeric data points. Must have at least 2 items to render line/area. */
+    data: number[];
+    /** Visual style @default "line" */
+    variant?: SparklineVariant;
+    /**
+     * Trend colour. `"auto"` compares first and last point:
+     *   last > first → up, last < first → down, equal → neutral.
+     * Pass an explicit value to override.
+     * @default "auto"
+     */
+    trend?: SparklineTrend;
+    /** Width in px. Also used as SVG viewBox width — output scales to parent when CSS overrides. @default 80 */
+    width?: number;
+    /** Height in px @default 24 */
+    height?: number;
+    /** Line / bar stroke width @default 1.5 */
+    strokeWidth?: number;
+    /** Show a filled dot at the last point */
+    showEndDot?: boolean;
+    /** Padding inside the viewBox so strokes/dots are not clipped @default 2 */
+    padding?: number;
+    /** Override color with any CSS value (e.g. `"hsl(var(--brand))"`). Takes precedence over `trend`. */
+    color?: string;
+    /** For bars variant — gap between bars in user units @default 1 */
+    barGap?: number;
+    /** aria-label for screen readers — describe the trend / metric */
+    'aria-label'?: string;
+}
+declare const Sparkline: React$1.ForwardRefExoticComponent<SparklineProps & React$1.RefAttributes<HTMLDivElement>>;
 
 declare function Slider({ className, defaultValue, value, min, max, dir, ...props }: React$1.ComponentProps<typeof SliderPrimitive.Root>): react_jsx_runtime.JSX.Element;
 declare namespace Slider {
@@ -2432,7 +4332,7 @@ interface SpinnerProps extends React$1.HTMLAttributes<HTMLSpanElement>, VariantP
 declare const Spinner: React$1.ForwardRefExoticComponent<SpinnerProps & React$1.RefAttributes<HTMLSpanElement>>;
 
 declare const switchRootVariants: (props?: ({
-    size?: "sm" | "md" | "lg" | "small" | "medium" | "large" | null | undefined;
+    size?: "medium" | "sm" | "md" | "lg" | "small" | "large" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 interface SwitchProps extends React$1.ComponentPropsWithoutRef<typeof SwitchPrimitive.Root>, VariantProps<typeof switchRootVariants> {
 }
@@ -2626,6 +4526,188 @@ interface StepProps extends React$1.HTMLAttributes<HTMLDivElement> {
 declare const Stepper: React$1.ForwardRefExoticComponent<StepperProps & React$1.RefAttributes<HTMLDivElement>>;
 declare const Step: React$1.ForwardRefExoticComponent<StepProps & React$1.RefAttributes<HTMLDivElement>>;
 
+interface StatusFlowStageData {
+    /** Stable identifier */
+    id: string;
+    /** Display label */
+    label: React$1.ReactNode;
+    /** Optional one-line description under the label */
+    description?: React$1.ReactNode;
+    /** Optional trailing meta (duration, count, …) shown next to the label */
+    meta?: React$1.ReactNode;
+    /** Status of this stage */
+    status: StageStatusKey;
+    /** Progress 0-100 within this stage. Rendered only when `status === "running"`. */
+    progress?: number;
+}
+type StatusFlowOrientation = 'horizontal' | 'vertical';
+type StatusFlowSize = 'sm' | 'md' | 'lg';
+interface StatusFlowProps extends Omit<React$1.OlHTMLAttributes<HTMLOListElement>, 'children'> {
+    /** Data-driven stage list. Mutually exclusive with `children`. */
+    stages?: StatusFlowStageData[];
+    /** Composition API — an array of `<StatusFlowStage>` children. */
+    children?: React$1.ReactNode;
+    /** Layout @default "horizontal" */
+    orientation?: StatusFlowOrientation;
+    /** Size @default "md" */
+    size?: StatusFlowSize;
+    /** Whether labels below/beside markers are shown. @default true */
+    showLabels?: boolean;
+    /** Locale for digits + accessible announcements @default "fa" */
+    locale?: SupportedLocale;
+    /** Fires when a stage marker is clicked. When set, markers become buttons. */
+    onStageSelect?: (stage: StatusFlowStageData, index: number) => void;
+}
+interface StatusFlowStageProps extends Omit<StatusFlowStageData, 'id'> {
+    id?: string;
+}
+/**
+ * Optional composition wrapper. Use this or the `stages` prop on
+ * `<StatusFlow>` — not both. StatusFlow injects position metadata as
+ * internal props; StatusFlowStage should not be rendered outside.
+ */
+declare function StatusFlowStage(props: StatusFlowStageProps): React$1.ReactElement;
+declare const StatusFlow: React$1.ForwardRefExoticComponent<StatusFlowProps & React$1.RefAttributes<HTMLOListElement>>;
+
+interface JobWizardStep {
+    /** Stable identifier — referenced by `validateStep`, `goToStep`, etc. */
+    id: string;
+    /** Step title (shown in stepper + header when this step is active) */
+    title: string;
+    /** Optional one-line description under the title */
+    description?: string;
+    /** Mark step as optional — a "Skip" button appears. @default false */
+    optional?: boolean;
+}
+/** Result of a validator — `null`/`undefined` = pass, `string` = single error, `Record<field, message>` = field errors */
+type JobWizardValidationResult = string | Record<string, string> | null | undefined;
+type JobWizardSubmitState = 'idle' | 'submitting' | 'success' | 'error';
+interface UseJobWizardOptions<TData extends Record<string, unknown>> {
+    /** Ordered list of steps. Pass a new array reference when the step list should change dynamically (e.g. branching). */
+    steps: JobWizardStep[];
+    /** Initial form data */
+    initialData?: Partial<TData>;
+    /**
+     * Validator fired before navigating to the next step. Also runs for each step
+     * on submit if `validateAllOnSubmit` is true.
+     *
+     * Return `null`/`undefined` to pass, or an error (string or field-map) to block navigation.
+     */
+    validateStep?: (stepId: string, data: Partial<TData>) => JobWizardValidationResult | Promise<JobWizardValidationResult>;
+    /** Called when the user confirms the last step. May return a Promise. */
+    onSubmit: (data: TData) => Promise<unknown> | unknown;
+    /** Called when the user clicks Cancel */
+    onCancel?: () => void;
+    /** When set, drafts are persisted to localStorage under this key. */
+    draftKey?: string;
+    /** Debounce (ms) for draft save. @default 300 */
+    draftDebounceMs?: number;
+    /** Validate all steps (in order) on submit. Default false — only the current step is validated before submit. */
+    validateAllOnSubmit?: boolean;
+}
+interface JobWizardApi<TData extends Record<string, unknown>> {
+    /** Current step (resolved from `steps[currentIndex]`). */
+    readonly currentStep: JobWizardStep;
+    readonly currentIndex: number;
+    readonly isFirst: boolean;
+    readonly isLast: boolean;
+    readonly steps: JobWizardStep[];
+    /** Mutable form data (merged across all steps). */
+    readonly data: Partial<TData>;
+    /** Replace the data object. */
+    setData: React$1.Dispatch<React$1.SetStateAction<Partial<TData>>>;
+    /** Shallow-merge the given patch into `data`. */
+    update: (patch: Partial<TData>) => void;
+    /** Current error. String = whole-step error, Record = per-field errors. */
+    readonly error: string | Record<string, string> | null;
+    /** Clear the current error. */
+    clearError: () => void;
+    /** Submit state lifecycle. */
+    readonly submitState: JobWizardSubmitState;
+    readonly submitResult: unknown;
+    readonly submitError: Error | null;
+    /** Advance to the next step. Runs validation first. Returns true if navigated. */
+    next: () => Promise<boolean>;
+    /** Go back to the previous step. */
+    back: () => void;
+    /** Jump to a specific step by id. Does NOT validate. */
+    goToStep: (id: string) => void;
+    /** Fire onSubmit. Runs validation first (current step only, unless `validateAllOnSubmit`). */
+    submit: () => Promise<void>;
+    /** Fire onCancel if provided. */
+    cancel: () => void;
+    /** Reset wizard to first step + `initialData` + idle state. Also clears draft. */
+    reset: () => void;
+    /** Remove the saved draft from localStorage (if `draftKey` set). */
+    clearDraft: () => void;
+    /** True iff the step at this id has been visited. */
+    isStepVisited: (id: string) => boolean;
+    /** Resolved stage status for the StatusFlow stepper. */
+    stageStatus: (step: JobWizardStep, index: number) => StageStatusKey;
+}
+declare function useJobWizard<TData extends Record<string, unknown>>(options: UseJobWizardOptions<TData>): JobWizardApi<TData>;
+/** Hook to access the wizard from within nested components. */
+declare function useJobWizardState<TData extends Record<string, unknown> = Record<string, unknown>>(): JobWizardApi<TData>;
+interface JobWizardProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    /** Wizard API from `useJobWizard`. */
+    wizard: JobWizardApi<Record<string, unknown>>;
+    /** Locale @default "fa" */
+    locale?: SupportedLocale;
+}
+declare const JobWizard: React$1.ForwardRefExoticComponent<JobWizardProps & React$1.RefAttributes<HTMLDivElement>>;
+interface JobWizardHeaderProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, 'title'> {
+    /** Main title of the wizard (persistent across steps). If omitted, shows the current step's title. */
+    title?: React$1.ReactNode;
+    /** Short description / context line under the title. */
+    description?: React$1.ReactNode;
+    /** Trailing slot (e.g. a close button). */
+    trailing?: React$1.ReactNode;
+}
+declare const JobWizardHeader: React$1.ForwardRefExoticComponent<JobWizardHeaderProps & React$1.RefAttributes<HTMLDivElement>>;
+interface JobWizardStepperProps {
+    /** Orientation @default "horizontal" */
+    orientation?: 'horizontal' | 'vertical';
+    /** Size @default "md" */
+    size?: 'sm' | 'md' | 'lg';
+    /** Allow clicking visited steps to jump back. @default true */
+    allowJump?: boolean;
+    className?: string;
+}
+declare const JobWizardStepper: React$1.FC<JobWizardStepperProps>;
+declare const JobWizardBody: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & React$1.RefAttributes<HTMLDivElement>>;
+declare const JobWizardError: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & React$1.RefAttributes<HTMLDivElement>>;
+declare const JobWizardFooter: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & React$1.RefAttributes<HTMLDivElement>>;
+/** Invisible flex spacer — pushes following buttons to the logical end. */
+declare const JobWizardSpacer: React$1.FC;
+interface JobWizardBackProps extends Omit<React$1.ComponentProps<typeof Button>, 'onClick'> {
+    /** Override label */
+    children?: React$1.ReactNode;
+}
+declare const JobWizardBack: React$1.ForwardRefExoticComponent<Omit<JobWizardBackProps, "ref"> & React$1.RefAttributes<HTMLButtonElement>>;
+interface JobWizardNextProps extends Omit<React$1.ComponentProps<typeof Button>, 'onClick'> {
+    /** Override label (not applied when on last step — uses `submitLabel` then) */
+    children?: React$1.ReactNode;
+    /** Label for the submit button when on the last step */
+    submitLabel?: React$1.ReactNode;
+}
+declare const JobWizardNext: React$1.ForwardRefExoticComponent<Omit<JobWizardNextProps, "ref"> & React$1.RefAttributes<HTMLButtonElement>>;
+interface JobWizardCancelProps extends Omit<React$1.ComponentProps<typeof Button>, 'onClick'> {
+    children?: React$1.ReactNode;
+}
+declare const JobWizardCancel: React$1.ForwardRefExoticComponent<Omit<JobWizardCancelProps, "ref"> & React$1.RefAttributes<HTMLButtonElement>>;
+interface JobWizardSkipProps extends Omit<React$1.ComponentProps<typeof Button>, 'onClick'> {
+    children?: React$1.ReactNode;
+}
+declare const JobWizardSkip: React$1.ForwardRefExoticComponent<Omit<JobWizardSkipProps, "ref"> & React$1.RefAttributes<HTMLButtonElement>>;
+interface JobWizardSuccessProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, 'title'> {
+    title?: React$1.ReactNode;
+    description?: React$1.ReactNode;
+    actions?: React$1.ReactNode;
+    /** Only render children when submitState === 'success' @default true */
+    autoShow?: boolean;
+}
+declare const JobWizardSuccess: React$1.ForwardRefExoticComponent<JobWizardSuccessProps & React$1.RefAttributes<HTMLDivElement>>;
+
 interface SentimentBadgeProps extends React$1.HTMLAttributes<HTMLSpanElement> {
     /** Sentiment type */
     sentiment: 'positive' | 'negative' | 'neutral' | 'mixed';
@@ -2640,6 +4722,89 @@ interface SentimentBadgeProps extends React$1.HTMLAttributes<HTMLSpanElement> {
 }
 declare const SentimentBadge: React$1.ForwardRefExoticComponent<SentimentBadgeProps & React$1.RefAttributes<HTMLSpanElement>>;
 
+interface EmotionBadgeProps extends React$1.HTMLAttributes<HTMLSpanElement> {
+    /** Emotion (9-class advanced sentiment scale) */
+    emotion: EmotionKey;
+    /** Optional count — shown alongside the label */
+    count?: number;
+    /** Size variant */
+    size?: 'sm' | 'md';
+    /** Show the text label. When false, renders an icon-only chip (aria-label kept). */
+    showLabel?: boolean;
+    /** Locale for label + digit formatting */
+    locale?: SupportedLocale;
+}
+declare const EmotionBadge: React$1.ForwardRefExoticComponent<EmotionBadgeProps & React$1.RefAttributes<HTMLSpanElement>>;
+
+type EmotionData = Partial<Record<EmotionKey, number>>;
+interface EmotionDistributionProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    /** Emotion counts (auto-normalized to 100%). Missing keys are treated as 0. */
+    data: EmotionData;
+    /** Display mode */
+    variant?: 'bars' | 'stacked' | 'compact';
+    /**
+     * For 'compact' and 'bars': limit to the top-N emotions by value. Leftover
+     * contributions roll up into a muted "بقیه" chip so totals still make sense.
+     * Default 5 — matches the canonical تحلیل افکار summary density.
+     */
+    topN?: number;
+    /** Show numeric count labels (in addition to percent). */
+    showCounts?: boolean;
+    /** Show percentage labels. */
+    showPercent?: boolean;
+    /** Locale for label + digit formatting */
+    locale?: SupportedLocale;
+    /** Loading skeleton */
+    isLoading?: boolean;
+}
+declare const EmotionDistribution: React$1.ForwardRefExoticComponent<EmotionDistributionProps & React$1.RefAttributes<HTMLDivElement>>;
+
+interface FlowBadgeProps extends React$1.HTMLAttributes<HTMLSpanElement> {
+    /** Flow classification */
+    flow: FlowKey;
+    /** Optional count shown alongside the label */
+    count?: number;
+    /** Size */
+    size?: 'sm' | 'md';
+    /** Whether to render the text label (keeps aria-label when false) */
+    showLabel?: boolean;
+    /** Locale for label + digit formatting */
+    locale?: SupportedLocale;
+}
+declare const FlowBadge: React$1.ForwardRefExoticComponent<FlowBadgeProps & React$1.RefAttributes<HTMLSpanElement>>;
+
+interface StatusBadgeProps extends React$1.HTMLAttributes<HTMLSpanElement> {
+    /** Operational status */
+    status: StatusKey;
+    /** Size */
+    size?: 'sm' | 'md';
+    /** Show text label (keeps aria-label when false) */
+    showLabel?: boolean;
+    /** Locale */
+    locale?: SupportedLocale;
+    /**
+     * Explicitly enable/disable the pulse animation on the indicator dot.
+     * Default: animated only for `status="critical"`. Pair with
+     * `prefers-reduced-motion` (already honoured globally in globals.css).
+     */
+    animated?: boolean;
+}
+declare const StatusBadge: React$1.ForwardRefExoticComponent<StatusBadgeProps & React$1.RefAttributes<HTMLSpanElement>>;
+
+interface SeverityBadgeProps extends React$1.HTMLAttributes<HTMLSpanElement> {
+    /** Urgency level — independent from operational status */
+    severity: SeverityKey;
+    /** Size */
+    size?: 'sm' | 'md';
+    /** Show text label */
+    showLabel?: boolean;
+    /** Render as a solid chip instead of the soft tinted pill (for high-contrast lists) */
+    variant?: 'soft' | 'solid';
+    /** Locale */
+    locale?: SupportedLocale;
+}
+declare const SeverityBadge: React$1.ForwardRefExoticComponent<SeverityBadgeProps & React$1.RefAttributes<HTMLSpanElement>>;
+
 interface MultiSelectOption {
     value: string;
     label: string;
@@ -2696,23 +4861,6 @@ interface PeriodSelectorProps {
 }
 declare const PeriodSelector: React$1.ForwardRefExoticComponent<PeriodSelectorProps & React$1.RefAttributes<HTMLDivElement>>;
 
-type SocialPlatform = 'instagram' | 'twitter' | 'tiktok' | 'youtube' | 'linkedin' | 'telegram' | 'threads';
-interface SocialPlatformBadgeProps extends React$1.HTMLAttributes<HTMLSpanElement> {
-    /** The social media platform to display */
-    platform: SocialPlatform;
-    /** Size of the badge */
-    size?: 'xs' | 'sm' | 'md' | 'lg';
-    /** Show the platform name label */
-    showLabel?: boolean;
-    /** Visual style of the badge */
-    variant?: 'flat' | 'badge';
-}
-declare const socialPlatformBadgeVariants: (props?: ({
-    size?: "xs" | "sm" | "md" | "lg" | null | undefined;
-    variant?: "flat" | "badge" | null | undefined;
-} & class_variance_authority_types.ClassProp) | undefined) => string;
-declare const SocialPlatformBadge: React$1.ForwardRefExoticComponent<SocialPlatformBadgeProps & React$1.RefAttributes<HTMLSpanElement>>;
-
 interface SearchInputProps extends Omit<React$1.InputHTMLAttributes<HTMLInputElement>, 'size'>, VariantProps<typeof InputVariants> {
     /** Locale for placeholder and aria labels */
     locale?: SupportedLocale;
@@ -2731,28 +4879,6 @@ interface SearchInputProps extends Omit<React$1.InputHTMLAttributes<HTMLInputEle
 }
 declare const SearchInput: React$1.ForwardRefExoticComponent<SearchInputProps & React$1.RefAttributes<HTMLInputElement>>;
 
-interface SentimentData {
-    positive: number;
-    negative: number;
-    neutral: number;
-    mixed?: number;
-}
-interface SentimentDistributionProps extends React$1.HTMLAttributes<HTMLDivElement> {
-    /** Sentiment counts (will be auto-normalized to 100%) */
-    data: SentimentData;
-    /** Display mode */
-    variant?: 'bars' | 'stacked' | 'compact';
-    /** Show numeric count labels */
-    showCounts?: boolean;
-    /** Show percentage labels */
-    showPercent?: boolean;
-    /** Locale for number/label formatting */
-    locale?: SupportedLocale;
-    /** Show loading skeleton */
-    isLoading?: boolean;
-}
-declare const SentimentDistribution: React$1.ForwardRefExoticComponent<SentimentDistributionProps & React$1.RefAttributes<HTMLDivElement>>;
-
 interface ComparisonCardProps extends React$1.HTMLAttributes<HTMLDivElement> {
     /** Card title */
     title: string;
@@ -2799,6 +4925,30 @@ interface DataTableColumn<TData> {
     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;
@@ -2835,6 +4985,25 @@ interface DataTableProps<TData> {
     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 */
@@ -2854,6 +5023,198 @@ 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
+ * gives a consistent inline footprint (no margin/padding chrome) and pairs
+ * a chart/badge with optional numeric value text.
+ *
+ * Usage:
+ *   columns={[
+ *     {
+ *       id: 'engagement',
+ *       header: 'تعامل',
+ *       cell: (row) => <SparklineCell data={row.history} value={row.eRate} suffix="٪" />,
+ *     },
+ *     ...
+ *   ]}
+ */
+interface SparklineCellProps {
+    /** History values (typically 6-12 points) */
+    data: number[];
+    /** Optional numeric value shown after the sparkline */
+    value?: number;
+    /** Suffix appended to value (e.g., '٪') */
+    suffix?: React$1.ReactNode;
+    /** Sparkline width in px @default 64 */
+    width?: number;
+    /** Sparkline height in px @default 18 */
+    height?: number;
+    /** Sparkline visual variant @default 'line' */
+    variant?: 'line' | 'area' | 'bars';
+    /** Override trend color (auto-detected from first vs last) */
+    trend?: 'up' | 'down' | 'neutral';
+    /** Locale @default 'fa' */
+    locale?: SupportedLocale;
+    /** Decimal places for value @default 0 */
+    decimals?: number;
+    className?: string;
+}
+declare const SparklineCell: React$1.ForwardRefExoticComponent<SparklineCellProps & React$1.RefAttributes<HTMLDivElement>>;
+interface TrendCellProps {
+    /** Numeric delta. Positive=up, negative=down, zero=flat. */
+    value: number;
+    /** Suffix (e.g., '٪'). */
+    suffix?: React$1.ReactNode;
+    /** Show the absolute value text alongside the arrow @default true */
+    showValue?: boolean;
+    /** Inverted trend (lower=better) — colours flip */
+    invert?: boolean;
+    /** Locale @default 'fa' */
+    locale?: SupportedLocale;
+    className?: string;
+}
+declare const TrendCell: React$1.ForwardRefExoticComponent<TrendCellProps & React$1.RefAttributes<HTMLSpanElement>>;
+interface StatusPulseCellProps {
+    status: StatusKey;
+    /** Optional label after the dot (omit for ultra-compact rows) */
+    label?: React$1.ReactNode;
+    /** Locale (forwarded to StatusBadge for default labels) */
+    locale?: SupportedLocale;
+    className?: string;
+}
+declare const StatusPulseCell: React$1.ForwardRefExoticComponent<StatusPulseCellProps & React$1.RefAttributes<HTMLSpanElement>>;
+interface SentimentCellProps {
+    /** Sentiment counts. */
+    data: SentimentData;
+    /** Visual mode @default 'stacked' */
+    variant?: 'stacked' | 'bars' | 'compact';
+    /** Width of the inline bar @default 80 */
+    width?: number;
+    /** Locale */
+    locale?: SupportedLocale;
+    className?: string;
+}
+declare const SentimentCell: React$1.ForwardRefExoticComponent<SentimentCellProps & React$1.RefAttributes<HTMLDivElement>>;
+interface FlowCellProps {
+    /** Flow counts. */
+    data: FlowData;
+    /** Visual mode @default 'stacked' */
+    variant?: 'stacked' | 'bars' | 'compact';
+    /** Width of the inline bar @default 96 */
+    width?: number;
+    /** Locale */
+    locale?: SupportedLocale;
+    className?: string;
+}
+declare const FlowCell: React$1.ForwardRefExoticComponent<FlowCellProps & React$1.RefAttributes<HTMLDivElement>>;
+interface ProgressCellProps {
+    /** Progress 0–100 */
+    value: number;
+    /** Show value text after the bar @default true */
+    showValue?: boolean;
+    /** Suffix on value (e.g., '٪'). Defaults to locale-appropriate %. */
+    suffix?: React$1.ReactNode;
+    /** Variant for color */
+    variant?: 'primary' | 'secondary' | 'success' | 'warning' | 'destructive';
+    /** Bar width @default 80 */
+    width?: number;
+    /** Locale @default 'fa' */
+    locale?: SupportedLocale;
+    className?: string;
+}
+declare const ProgressCell: React$1.ForwardRefExoticComponent<ProgressCellProps & React$1.RefAttributes<HTMLDivElement>>;
+interface StatDeltaCellProps {
+    /** Primary value (e.g., 1240) */
+    value: number | string;
+    /** Delta (positive=up). Hidden if undefined. */
+    delta?: number;
+    /** Format the value with locale digits @default true (when value is number) */
+    formatValue?: boolean;
+    /** Suffix on value */
+    valueSuffix?: React$1.ReactNode;
+    /** Suffix on delta */
+    deltaSuffix?: React$1.ReactNode;
+    /** Inverted trend (lower=better) */
+    invertDelta?: boolean;
+    /** Locale */
+    locale?: SupportedLocale;
+    className?: string;
+}
+declare const StatDeltaCell: React$1.ForwardRefExoticComponent<StatDeltaCellProps & React$1.RefAttributes<HTMLSpanElement>>;
+
+interface DataTableColumnVisibilityToggleProps<TData> {
+    columns: DataTableColumn<TData>[];
+    visibility: DataTableColumnVisibility;
+    /** Locale @default 'fa' */
+    locale?: SupportedLocale;
+    /** Custom trigger label (defaults to "ستون‌ها") */
+    label?: React$1.ReactNode;
+    /** Custom Button class */
+    className?: string;
+    /** Override Button size */
+    size?: 'xs' | 'sm' | 'default';
+    /** Override Button variant */
+    variant?: 'default' | 'outline' | 'ghost' | 'secondary';
+}
+declare function DataTableColumnVisibilityToggle<TData>({ columns, visibility, locale, label, className, size, variant, }: DataTableColumnVisibilityToggleProps<TData>): react_jsx_runtime.JSX.Element;
+/**
+ * Convert column definitions + row data into a CSV string. Each cell is
+ * stringified by calling its `cell` render and extracting plain text — for
+ * complex React nodes pass an `exportValue: (row) => string` on the column.
+ */
+interface ExportableColumn<TData> extends DataTableColumn<TData> {
+    /** Override how this column's value is serialized for export. */
+    exportValue?: (row: TData, index: number) => string | number | boolean | null | undefined;
+}
+/**
+ * Build a CSV string from columns + rows. Header row uses each column's
+ * `header` (if string) or its `id` as fallback.
+ */
+declare function buildCsv<TData>(columns: ExportableColumn<TData>[], data: TData[]): string;
+/** Build a TSV string (tab-separated) — useful for "paste into spreadsheet". */
+declare function buildTsv<TData>(columns: ExportableColumn<TData>[], data: TData[]): string;
+/** Trigger a browser download of `content` with the given filename + mime. */
+declare function downloadFile(filename: string, content: string, mime?: string): void;
+interface DataTableExportButtonProps<TData> {
+    columns: ExportableColumn<TData>[];
+    data: TData[];
+    /** Output filename (default: data-<timestamp>.csv) */
+    filename?: string;
+    /** Locale @default 'fa' */
+    locale?: SupportedLocale;
+    /** Override label */
+    label?: React$1.ReactNode;
+    /** Hide TSV-copy entry @default false */
+    hideTsv?: boolean;
+    /** Custom Button class */
+    className?: string;
+    /** Override Button size */
+    size?: 'xs' | 'sm' | 'default';
+    /** Override Button variant */
+    variant?: 'default' | 'outline' | 'ghost' | 'secondary';
+}
+declare function DataTableExportButton<TData>({ columns, data, filename, locale, label, hideTsv, className, size, variant, }: DataTableExportButtonProps<TData>): react_jsx_runtime.JSX.Element;
+
+interface TableComparisonViewProps<TData> {
+    /** Original DataTable column definitions — `cell()` is reused for rendering. */
+    columns: DataTableColumn<TData>[];
+    /** Rows being compared. Recommended 2-4. */
+    rows: TData[];
+    /** Optional label for each row column header (e.g., name). Falls back to `Row N`. */
+    rowLabel?: (row: TData, index: number) => React$1.ReactNode;
+    /** Callback for the column "remove" button. When omitted, no remove button shows. */
+    onRemoveRow?: (row: TData, index: number) => void;
+    /** Highlight cells whose value differs across rows @default true */
+    highlightDifferences?: boolean;
+    /** Locale @default 'fa' */
+    locale?: SupportedLocale;
+    /** Empty state when no rows are passed */
+    emptyState?: React$1.ReactNode;
+    className?: string;
+}
+declare const TableComparisonView: <TData>(props: TableComparisonViewProps<TData>) => React$1.ReactElement;
+
 interface DirectionalBoxProps extends React$1.HTMLAttributes<HTMLDivElement> {
     /**
      * Override the detected document direction.
@@ -2917,8 +5278,94 @@ 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;
+    /** Subtitle / metadata */
+    description?: React$1.ReactNode;
+    /** Top-right header actions (Save, Export, …) */
+    headerActions?: React$1.ReactNode;
+    /** Locale @default 'fa' */
+    locale?: SupportedLocale;
+}
+declare const ReportComposer: React$1.ForwardRefExoticComponent<ReportComposerProps & React$1.RefAttributes<HTMLDivElement>>;
+interface ReportSectionProps extends Omit<React$1.HTMLAttributes<HTMLElement>, 'title'> {
+    /** Section title */
+    title: React$1.ReactNode;
+    /** Optional secondary text */
+    description?: React$1.ReactNode;
+    /** Whether the section is enabled (in the bulletin output) */
+    enabled?: boolean;
+    /** Callback when the enable switch is toggled. When omitted, switch is hidden. */
+    onEnabledChange?: (next: boolean) => void;
+    /** Whether the section is collapsed (only the header visible) */
+    collapsed?: boolean;
+    /** Callback when collapse toggles. When omitted, collapse button is hidden. */
+    onCollapsedChange?: (next: boolean) => void;
+    /** Show drag handle (consumer wires the drag interaction) */
+    draggable?: boolean;
+    /** drag-handle pointerDown — set when wiring native or react-dnd */
+    onDragHandlePointerDown?: (e: React$1.PointerEvent<HTMLButtonElement>) => void;
+    /** Render a settings button (e.g., to open a popover). When omitted, hidden. */
+    onSettingsClick?: () => void;
+    /** Custom header actions (extra buttons beside settings) */
+    headerActions?: React$1.ReactNode;
+}
+declare const ReportSection: React$1.ForwardRefExoticComponent<ReportSectionProps & React$1.RefAttributes<HTMLElement>>;
+interface BulletinViewerProps extends Omit<React$1.HTMLAttributes<HTMLDivElement>, 'title'> {
+    /** Bulletin title (h1) */
+    title: React$1.ReactNode;
+    /** Author / source line */
+    author?: React$1.ReactNode;
+    /** Publish date display */
+    publishedAt?: React$1.ReactNode;
+    /** Optional list of subtitle lines (volume, edition, etc.) */
+    meta?: React$1.ReactNode[];
+    /** Action buttons in the header (Print, Download PDF, Share). Hidden when printing via @media print. */
+    headerActions?: React$1.ReactNode;
+    /** Locale @default 'fa' */
+    locale?: SupportedLocale;
+}
+declare const BulletinViewer: React$1.ForwardRefExoticComponent<BulletinViewerProps & React$1.RefAttributes<HTMLDivElement>>;
+
 declare const calloutVariants: (props?: ({
-    variant?: "info" | "success" | "warning" | "destructive" | "neutral" | null | undefined;
+    variant?: "neutral" | "warning" | "success" | "info" | "destructive" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 interface CalloutProps extends React$1.HTMLAttributes<HTMLDivElement>, VariantProps<typeof calloutVariants> {
     /** Custom icon. Set to `null` to hide the icon. */
@@ -3077,53 +5524,6 @@ interface PartoPieChartProps {
 }
 declare const PartoPieChart: React$1.ForwardRefExoticComponent<PartoPieChartProps & React$1.RefAttributes<HTMLDivElement>>;
 
-/**
- * PartoHeatMap — brand-tinted heatmap with rounded cells, clean axis,
- * glassmorphic tooltip, and locale-aware formatting.
- * Built with Visx scales + raw SVG for full control.
- */
-interface HeatMapDatum {
-    x: string | number;
-    y: number;
-}
-interface HeatMapRow {
-    id: string;
-    data: HeatMapDatum[];
-}
-interface PartoHeatMapProps {
-    data: HeatMapRow[];
-    locale?: 'fa' | 'en';
-    className?: string;
-    isLoading?: boolean;
-    ariaLabel?: string;
-    margin?: {
-        top: number;
-        right: number;
-        bottom: number;
-        left: number;
-    };
-    /** Custom color function: receives value and max → returns CSS color */
-    colorScale?: (value: number, max: number) => string;
-    /** Cell border radius */
-    cellRadius?: number;
-    /** Gap between cells */
-    cellGap?: number;
-    /** Custom tooltip content */
-    renderTooltip?: (cell: {
-        rowId: string;
-        x: string | number;
-        value: number;
-        color: string;
-    }) => React$1.ReactNode;
-    /** X axis label */
-    xAxisLabel?: string;
-    /** Y axis label */
-    yAxisLabel?: string;
-    /** Filter which x-axis ticks to show */
-    xTickFilter?: (value: string | number, index: number) => boolean;
-}
-declare const PartoHeatMap: React$1.ForwardRefExoticComponent<PartoHeatMapProps & React$1.RefAttributes<HTMLDivElement>>;
-
 /**
  * PartoWordCloud — modern word cloud with smooth hover transitions,
  * glassmorphic tooltip, and brand-harmonious coloring.
@@ -3198,23 +5598,46 @@ interface PartoAreaChartProps {
 }
 declare const PartoAreaChart: React$1.ForwardRefExoticComponent<PartoAreaChartProps & React$1.RefAttributes<HTMLDivElement>>;
 
-interface PartoRadarChartProps {
-    /** Data: [{ subject: "سرعت", series1: 80, series2: 60 }] */
+/**
+ * PartoScatterChart — x/y scatter with optional bubble sizing (z) and
+ * per-point color override. Wraps Recharts ScatterChart with theme-aware
+ * styles, RTL-safe margins, and Persian number formatting.
+ *
+ * @example
+ * <PartoScatterChart
+ *   data={[
+ *     { x: 10, y: 30, z: 200, label: 'پیج A' },
+ *     { x: 40, y: 50, z: 120, label: 'پیج B' },
+ *   ]}
+ *   xKey="x" yKey="y" zKey="z" labelKey="label"
+ *   xLabel="تعامل (٪)" yLabel="رشد (٪)"
+ * />
+ */
+interface PartoScatterChartProps {
+    /** Row-oriented data. Each row contains x, y, and optional z (size) + label. */
     data: Array<Record<string, any>>;
-    /** Keys for each radar series */
-    dataKeys: string[];
-    /** Field name used for angle axis labels (default: 'subject') */
-    indexBy?: string;
-    /** Radar fill opacity */
-    fillOpacity?: number;
-    /** Radar stroke width */
-    strokeWidth?: number;
-    /** Show dots on vertices */
-    showDots?: boolean;
-    /** Dot radius */
-    dotRadius?: number;
-    /** Grid shape */
-    gridType?: 'polygon' | 'circle';
+    /** Field name for X axis value */
+    xKey: string;
+    /** Field name for Y axis value */
+    yKey: string;
+    /** Optional field for bubble size (z). When provided, becomes a bubble chart. */
+    zKey?: string;
+    /** Optional field for per-point label (shown in tooltip). */
+    labelKey?: string;
+    /** Optional field for color classification (per-point). Values are mapped to palette. */
+    groupKey?: string;
+    /** Min/max bubble radius (px) when zKey is set. Default [40, 400]. */
+    zRange?: [number, number];
+    /** Axis range [min, max] for X @default 'dataMin'..'dataMax' */
+    xDomain?: [number | 'dataMin' | 'auto', number | 'dataMax' | 'auto'];
+    /** Axis range [min, max] for Y */
+    yDomain?: [number | 'dataMin' | 'auto', number | 'dataMax' | 'auto'];
+    /** Axis labels */
+    xLabel?: string;
+    yLabel?: string;
+    /** Unit suffix appended to tick labels (e.g., '٪') */
+    xUnit?: string;
+    yUnit?: string;
     /** Chart margins */
     margin?: {
         top?: number;
@@ -3222,13 +5645,232 @@ interface PartoRadarChartProps {
         bottom?: number;
         left?: number;
     };
-    /** Custom tooltip formatter */
+    /** Show grid @default true */
+    enableGrid?: boolean;
+    /** Series name for tooltip header @default 'Scatter' */
+    seriesName?: string;
+    /** Locale for digit formatting @default 'fa' */
+    locale?: SupportedLocale;
+    /** Custom tooltip formatter (name, value) */
     tooltipFormatter?: (name: string, value: number) => React$1.ReactNode;
     className?: string;
     isLoading?: boolean;
     ariaLabel?: string;
 }
-declare const PartoRadarChart: React$1.ForwardRefExoticComponent<PartoRadarChartProps & React$1.RefAttributes<HTMLDivElement>>;
+declare const PartoScatterChart: React$1.ForwardRefExoticComponent<PartoScatterChartProps & React$1.RefAttributes<HTMLDivElement>>;
+
+/**
+ * PartoSankeyChart — flow visualization between nodes (source → target).
+ * Uses Recharts' Sankey primitive. Wraps for theme-aware colors, Persian
+ * number formatting, empty state, and a simpler API.
+ *
+ * @example
+ * <PartoSankeyChart
+ *   nodes={[{ name: 'ورودی' }, { name: 'فرآیند' }, { name: 'خروجی' }]}
+ *   links={[
+ *     { source: 0, target: 1, value: 50 },
+ *     { source: 1, target: 2, value: 50 },
+ *   ]}
+ * />
+ */
+interface SankeyNode {
+    /** Displayed label for the node. */
+    name: string;
+    /** Optional explicit color override (CSS color or `hsl(var(--token))`). */
+    color?: string;
+}
+interface SankeyLink {
+    /** Zero-based index of the source node in `nodes`. */
+    source: number;
+    /** Zero-based index of the target node in `nodes`. */
+    target: number;
+    /** Flow magnitude — drives link thickness. */
+    value: number;
+}
+interface PartoSankeyChartProps {
+    nodes: SankeyNode[];
+    links: SankeyLink[];
+    /** Chart margins */
+    margin?: {
+        top?: number;
+        right?: number;
+        bottom?: number;
+        left?: number;
+    };
+    /** Horizontal gap between node columns in pixels */
+    nodePadding?: number;
+    /** Node rectangle width in pixels */
+    nodeWidth?: number;
+    /** Sort nodes alphabetically within a column @default false (preserve input order) */
+    iterations?: number;
+    /** Locale for digit formatting in tooltip @default 'fa' */
+    locale?: SupportedLocale;
+    /** Custom tooltip formatter (receives link.source/target names + value) */
+    tooltipFormatter?: (label: string, value: number) => React$1.ReactNode;
+    className?: string;
+    isLoading?: boolean;
+    ariaLabel?: string;
+}
+declare const PartoSankeyChart: React$1.ForwardRefExoticComponent<PartoSankeyChartProps & React$1.RefAttributes<HTMLDivElement>>;
+
+/**
+ * ConceptPulseChart — افکارسنجی-flavored bubble chart where each data point
+ * is a "concept" rendered as a center dot surrounded by **composition arcs**.
+ * Built on Recharts ScatterChart but overrides the scatter shape with a
+ * custom SVG renderer that draws the central bubble + concentric pie arcs
+ * showing the composition breakdown (flow / emotion / sentiment).
+ *
+ * Heart-of-dashboard chart in the prototype — replaces a flat scatter when
+ * "what's this concept made of?" matters as much as where it sits.
+ *
+ * @example
+ * <ConceptPulseChart
+ *   data={[{
+ *     x: 30, y: 50, z: 200,
+ *     label: 'افزایش قیمت بنزین',
+ *     composition: { 'pro-gov': 20, 'internal-critic': 60, 'external-opponent': 20 },
+ *   }]}
+ *   compositionScale="flow"
+ * />
+ */
+type CompositionScale = 'flow' | 'emotion' | 'custom';
+type ConceptComposition = Partial<Record<string, number>>;
+interface ConceptPoint {
+    /** X coordinate. */
+    x: number;
+    /** Y coordinate. */
+    y: number;
+    /** Optional bubble size value (drives center radius). */
+    z?: number;
+    /** Concept label — shown in tooltip and aria. */
+    label: string;
+    /**
+     * Composition breakdown — keys must match the chosen `compositionScale`:
+     * - flow: 'pro-gov' | 'internal-critic' | 'internal-opponent' | 'external-opponent' | 'grey'
+     * - emotion: 'anger' | 'joy' | 'fear' | … (9 emotion keys)
+     * - custom: any keys, paired with `compositionTokens` prop
+     */
+    composition: ConceptComposition;
+}
+interface ConceptPulseChartProps {
+    data: ConceptPoint[];
+    /** Which token family the composition keys map to @default "flow" */
+    compositionScale?: CompositionScale;
+    /**
+     * For `compositionScale="custom"`, supply a key → CSS-color map
+     * (e.g., `{ a: 'hsl(var(--brand-default))', b: 'red' }`).
+     */
+    compositionTokens?: Record<string, string>;
+    /** Per-key labels for tooltip (custom scale only) */
+    compositionLabels?: Record<string, string>;
+    /** Optional bubble size range (px area) when z is provided @default [80, 600] */
+    zRange?: [number, number];
+    /** Center bubble radius when z is omitted @default 14 */
+    centerRadius?: number;
+    /** Outer arc radius offset (added to centerRadius) @default 8 */
+    arcThickness?: number;
+    /** Show concept label below the bubble @default false (use tooltip instead) */
+    showLabels?: boolean;
+    /** Axis configuration */
+    xLabel?: string;
+    yLabel?: string;
+    xUnit?: string;
+    yUnit?: string;
+    xDomain?: [number | 'dataMin' | 'auto', number | 'dataMax' | 'auto'];
+    yDomain?: [number | 'dataMin' | 'auto', number | 'dataMax' | 'auto'];
+    margin?: {
+        top?: number;
+        right?: number;
+        bottom?: number;
+        left?: number;
+    };
+    enableGrid?: boolean;
+    locale?: SupportedLocale;
+    className?: string;
+    isLoading?: boolean;
+    ariaLabel?: string;
+}
+declare const ConceptPulseChart: React$1.ForwardRefExoticComponent<ConceptPulseChartProps & React$1.RefAttributes<HTMLDivElement>>;
+
+/**
+ * PartoNetworkChart — force-directed node/link graph. Uses a lightweight
+ * custom force-simulation (no d3-force dep) — repulsion + link attraction +
+ * centering — to lay out nodes in a stable position inside the container.
+ *
+ * Consumers who want non-force layouts (circular, radial, manual x/y) can
+ * pass nodes with explicit `x`/`y` to skip the simulation.
+ */
+interface NetworkNode {
+    /** Unique id — used by links for source/target. */
+    id: string;
+    /** Displayed label. */
+    label?: string;
+    /** Optional numeric weight — drives node radius (larger = more important). */
+    weight?: number;
+    /** Category key — maps to a stable palette color. */
+    group?: string;
+    /** Fixed X (skip simulation for this node) */
+    fx?: number;
+    /** Fixed Y */
+    fy?: number;
+    /** Explicit color override */
+    color?: string;
+}
+interface NetworkLink {
+    /** Source node id. */
+    source: string;
+    /** Target node id. */
+    target: string;
+    /** Optional numeric weight — drives stroke width. */
+    value?: number;
+}
+interface PartoNetworkChartProps {
+    nodes: NetworkNode[];
+    links: NetworkLink[];
+    /** Base node radius in px @default 12 */
+    nodeRadius?: number;
+    /** Max node radius (when scaling by weight) @default 24 */
+    maxNodeRadius?: number;
+    /** Link base stroke width @default 1.5 */
+    linkStrokeWidth?: number;
+    /** Max link stroke width (when scaling by value) @default 6 */
+    maxLinkStrokeWidth?: number;
+    /** Number of simulation ticks @default 250 */
+    iterations?: number;
+    /** Show node labels @default true */
+    showLabels?: boolean;
+    /** Locale for labels + digits @default 'fa' */
+    locale?: SupportedLocale;
+    /** Tooltip formatter (node hover) */
+    nodeTooltip?: (node: NetworkNode) => React$1.ReactNode;
+    /** Callback when a node is clicked */
+    onNodeClick?: (node: NetworkNode) => void;
+    className?: string;
+    isLoading?: boolean;
+    ariaLabel?: string;
+}
+declare const PartoNetworkChart: React$1.ForwardRefExoticComponent<PartoNetworkChartProps & React$1.RefAttributes<HTMLDivElement>>;
+
+/**
+ * Chart-shaped empty state — a lightweight placeholder for charts with no data.
+ * Designed to be drop-in compatible with `PartoBarChart`, `PartoLineChart`, etc.
+ * Sits inside `ChartContainer` consumers, so it accepts the same wrapper
+ * `className` and fills 100% of the parent's bounds.
+ */
+type EmptyChartShape = 'bar' | 'line' | 'pie' | 'network' | 'generic';
+interface EmptyChartProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    /** Visual shape hint for the icon @default "generic" */
+    shape?: EmptyChartShape;
+    /** Primary message. Defaults to a locale-specific "no data" string. */
+    message?: React$1.ReactNode;
+    /** Secondary helper text below the message */
+    hint?: React$1.ReactNode;
+    /** Optional action (button, link) shown under the text */
+    action?: React$1.ReactNode;
+    /** Locale @default "fa" */
+    locale?: SupportedLocale;
+}
+declare const EmptyChart: React$1.ForwardRefExoticComponent<EmptyChartProps & React$1.RefAttributes<HTMLDivElement>>;
 
 type Direction = 'ltr' | 'rtl';
 declare function useDocumentDirection(): Direction;
@@ -3377,4 +6019,113 @@ declare function transformNivoLineData(nivoData: Array<{
  */
 declare function useScrollLock(locked: boolean): void;
 
-export { Accordion, AccordionContent, AccordionItem, AccordionTrigger, Alert, AlertDescription, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, AlertTitle, AnimatedNumber, type AnimatedNumberProps, AppBar, type AppBarProps, AppLayout, AppLayoutContent, AspectRatio, type AspectRatioType, Autocomplete, type AutocompleteItem, type AutocompleteProps, Avatar, AvatarFallback, AvatarGroup, type AvatarGroupItem, type AvatarGroupProps, AvatarImage, Badge, type BadgeProps, Banner, type BannerProps, Breadcrumb, BreadcrumbEllipsis, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator, Button, ButtonGroup, ButtonGroupSeparator, ButtonGroupText, type ButtonProps, type ButtonVariantProps, CHART_FONT_FAMILY, Calendar, type CalendarProps, Callout, CalloutDescription, type CalloutProps, CalloutTitle, Card, CardContent, CardDescription, CardFooter, CardHeader, type CardProps, CardTitle, Carousel, type CarouselApi, CarouselContent, CarouselItem, CarouselNext, CarouselPrevious, ChartContainer, ChartLoadingSkeleton, ChartSkeleton, type ChartSkeletonProps$1 as ChartSkeletonProps, ChartTooltip, Checkbox, CircularProgress, type CircularProgressProps, Collapsible, CollapsibleContent, CollapsibleTrigger, Command, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, CommentCard, type CommentCardProps, type CommentTag, ComparisonCard, type ComparisonCardProps, ConfirmDialog, type ConfirmDialogProps, ContextMenu, ContextMenuCheckboxItem, ContextMenuContent, ContextMenuGroup, ContextMenuItem, ContextMenuLabel, ContextMenuPortal, ContextMenuRadioGroup, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuShortcut, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger, CopyButton, type CopyButtonProps, DEFAULT_PERIODS, DataTable, type DataTableColumn, type DataTablePagination, type DataTableProps, type DataTableSelection, type DataTableSort, DatePicker, type DatePickerProps, DateRangePicker, DateRangePickerInline, type DateRangePickerProps, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, type Direction, DirectionalBox, type DirectionalBoxProps, Drawer, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerOverlay, DrawerPortal, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, ENGAGEMENT_RANGES, Empty, EmptyAction, EmptyDescription, EmptyIcon, EmptyTitle, type EngagementRange, type EngagementRangeWithDisplay, EngagementRate, EngagementRateBar, type EngagementRateBarProps, type EngagementRateProps, type EngagementTier, ErrorBoundary, type ErrorBoundaryProps, ErrorState, type ErrorStateProps, Field, FieldContent, FieldDescription, FieldError, FieldGroup, FieldLabel, FieldLegend, FieldSeparator, FieldSet, FieldTitle, FilterBar, FilterBarActions, type FilterBarActionsProps, FilterBarActiveFilters, type FilterBarActiveFiltersProps, FilterBarClear, type FilterBarClearProps, type FilterBarProps, FilterBarRow, type FilterBarRowProps, FilterChip, FilterChipGroup, type FilterChipProps, type FollowerGroup, Form, FormControl, FormDescription, FormField, FormItem, FormLabel, FormMessage, GROUP_LABELS, HashtagInput, type TagInputProps as HashtagInputProps, type HeatMapDatum, type HeatMapRow, HoverCard, HoverCardContent, HoverCardTrigger, type Icon, Icons, Input, InputGroup, InputGroupAddon, InputGroupButton, InputGroupInput, InputGroupText, InputGroupTextarea, InputOTP, InputOTPGroup, InputOTPSeparator, InputOTPSlot, type InputProps, InputVariants, InputWithIcon, type InputWithIconProps, InstagramPost, type InstagramPostProps, type InstagramProfileInfo, Kbd, KbdGroup, Label, type LegacySize, type LoadingVariantProps, type Locale, type MediaItem, type MediaType, Menubar, MenubarCheckboxItem, MenubarContent, MenubarGroup, MenubarItem, MenubarLabel, MenubarMenu, MenubarPortal, MenubarRadioGroup, MenubarRadioItem, MenubarSeparator, MenubarShortcut, MenubarSub, MenubarSubContent, MenubarSubTrigger, MenubarTrigger, MetricCard, MetricCardContent, MetricCardDifferential, MetricCardHeader, MetricCardLabel, MetricCardSkeleton, type MetricCardSkeletonProps, MetricCardSparkline, MetricCardValue, MultiSelect, type MultiSelectOption, type MultiSelectProps, NativeSelect, NativeSelectOptGroup, NativeSelectOption, NavPanel, NavPanelContent, NavPanelFooter, NavPanelHeader, NavRail, NavRailContent, NavRailFooter, NavRailHeader, NavRailItem, NavRailProvider, NavRailSeparator, NavRailTrigger, NavigationMenu, NavigationMenuContent, NavigationMenuIndicator, NavigationMenuItem, NavigationMenuLink, NavigationMenuList, NavigationMenuTrigger, NavigationMenuViewport, type NumberFormat, PERSIAN_MONTHS, PERSIAN_MONTHS_SHORT, PERSIAN_WEEKDAYS, PERSIAN_WEEKDAYS_SHORT, PageHeader, type PageHeaderProps, PageLoader, type PageLoaderProps, Pagination, PaginationContent, PaginationControlled, type PaginationControlledProps, PaginationEllipsis, PaginationItem, PaginationLink, PaginationNext, PaginationPrevious, PartoAreaChart, type PartoAreaChartProps, PartoBarChart, type PartoBarChartProps, PartoHeatMap, type PartoHeatMapProps, PartoLineChart, type PartoLineChartProps, PartoPieChart, type PartoPieChartProps, PartoRadarChart, type PartoRadarChartProps, type PartoToasterProps, PartoWordCloud, type PartoWordCloudProps, type PeriodOption, PeriodSelector, type PeriodSelectorProps, Popover, PopoverAnchor, PopoverContent, PopoverTrigger, type PostStats, ProfileCard, type ProfileCardProps, ProfileInfo, type ProfileInfoProps, Progress, type ProgressProps, RadioCardDescription, RadioCardItem, RadioCardTitle, RadioCards, RadioGroup, RadioGroupItem, ResizableHandle, ResizablePanel, ResizablePanelGroup, SONNER_DEFAULT_DURATION, SafeImage, type SafeImageProps, ScrollArea, ScrollBar, SearchInput, type SearchInputProps, type SectionItem, SectionNavigator, type SectionNavigatorProps, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectTriggerVariants, SelectValue, SentimentBadge, type SentimentBadgeProps, type SentimentData, SentimentDistribution, type SentimentDistributionProps, Separator, Sheet, SheetBody, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetTitle, SheetTrigger, Sidebar, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupAction, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInput, SidebarInset, SidebarMenu, SidebarMenuAction, SidebarMenuBadge, SidebarMenuButton, SidebarMenuItem, SidebarMenuSkeleton, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubItem, SidebarProvider, SidebarRail, SidebarSeparator, SidebarTrigger, type SizeWithLegacy, Skeleton, type SkeletonProps, Slider, type SocialPlatform, SocialPlatformBadge, type SocialPlatformBadgeProps, type SortDirection, Spinner, type SpinnerProps, type StandardSize, StatDisplay, type StatDisplayProps, Step, type StepProps, Stepper, type StepperProps, type SupportedLocale, Switch, type SwitchProps, TIER_LABELS, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, TableSkeleton, type TableSkeletonProps, TableSortHeader, Tabs, TabsContent, TabsList, TabsTrigger, TagInput, type TagInputProps, Textarea, type TimeFormat, Toaster, Toggle, ToggleGroup, ToggleGroupItem, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, TrendIndicator, type TrendIndicatorProps, type UIStringKeys, type UIStrings, UI_STRINGS, type UseInfiniteScrollOptions, type UseInfiniteScrollReturn, UserAutocomplete, type UserAutocompleteProps, type UserItem, type ViewMode, ViewToggle, type ViewToggleProps, type WordData, appBarVariants, avatarGroupVariants, badgeVariants, bannerVariants, buttonGroupVariants, buttonVariants, calloutVariants, cardVariants, cn, convertToLocalNumbers, engagementUiTranslations, formatAbsoluteTime, formatJalaliDate, formatLargeNumber, formatNumber, formatPersianDateRange, formatRelativeTime, getCurrentRangeIndex, getEngagementRanges, getFollowerGroup, getPersianDay, getPersianMonth, getPersianMonthName, getPersianMonthNameShort, getPersianMonthsForDropdown, getPersianWeekdayName, getPersianYear, getPersianYearsForDropdown, getUIStrings, tagInputVariants as hashtagInputVariants, inputVariants, instagramPostVariants, isRTL, jalaliToGregorian, navigationMenuTriggerStyle, normalizeSize, pageLoaderVariants, profileCardVariants, sentimentLabels, socialPlatformBadgeVariants, spinnerVariants, statDisplayVariants, tagInputVariants, toEnglishDigits, toPersianDigits, toggleVariants, transformNivoLineData, useChartTheme, useDebounce, useDocumentDirection, useFormField, useInfiniteScroll, useIsMobile, useLocalStorage, useNavRail, useRootStyles, useScrollLock, useSidebar };
+/**
+ * Fires `handler` whenever a pointer event lands outside the referenced
+ * element. Use for closing dropdowns, popovers, dismissable cards, etc.
+ *
+ * @example
+ * const ref = useRef<HTMLDivElement>(null)
+ * useOutsideClick(ref, () => setOpen(false), { when: open })
+ *
+ * @param ref - Ref to the inside element. Clicks inside (or on descendants) are ignored.
+ * @param handler - Called when an outside click is detected.
+ * @param options.when - When false, the listener is detached (avoid stale closures).
+ * @param options.events - Which events to listen for. Default: ['mousedown', 'touchstart'].
+ *   Using 'mousedown' (instead of 'click') closes the menu before any click handler
+ *   inside fires — matches Radix/Headless UI behaviour.
+ */
+declare function useOutsideClick<T extends HTMLElement = HTMLElement>(ref: React$1.RefObject<T | null>, handler: (event: MouseEvent | TouchEvent) => void, options?: {
+    when?: boolean;
+    events?: Array<'mousedown' | 'mouseup' | 'click' | 'touchstart' | 'touchend'>;
+}): void;
+
+/**
+ * Subscribes to a CSS media query and returns its current match state.
+ * SSR-safe: returns `undefined` on the server and on the initial client
+ * render (consumers must handle the `undefined` case).
+ *
+ * @example
+ * const isLarge = useMediaQuery('(min-width: 1024px)')
+ * if (isLarge) ...  // narrow to true|false
+ *
+ * @example presets
+ * const prefersDark = useMediaQuery('(prefers-color-scheme: dark)')
+ * const reducedMotion = useMediaQuery('(prefers-reduced-motion: reduce)')
+ */
+declare function useMediaQuery(query: string): boolean | undefined;
+/** Common breakpoint helper. Returns `undefined` until hydrated. */
+declare function useBreakpoint(breakpoint: 'sm' | 'md' | 'lg' | 'xl' | '2xl'): boolean | undefined;
+
+interface UseClipboardOptions {
+    /** Reset `copied` back to false after this many ms. @default 2000 */
+    resetAfter?: number | false;
+}
+interface UseClipboardReturn {
+    /** True for `resetAfter` ms after a successful copy. */
+    copied: boolean;
+    /** True if the last copy attempt threw. */
+    error: Error | null;
+    /**
+     * Copy a string to clipboard. Returns a promise that resolves to `true` on
+     * success, `false` if the API isn't available, and rejects on permission
+     * denial (caught and exposed via `error`).
+     */
+    copy: (value: string) => Promise<boolean>;
+    /** Manually reset `copied` and `error` state. */
+    reset: () => void;
+}
+/**
+ * useClipboard — copy text to the system clipboard with a transient `copied`
+ * flag suitable for "Copied!" affordances. Uses the modern Clipboard API
+ * with a `document.execCommand('copy')` fallback for older browsers.
+ *
+ * @example
+ * const { copied, copy } = useClipboard()
+ * <button onClick={() => copy('hello')}>{copied ? 'کپی شد' : 'کپی'}</button>
+ */
+declare function useClipboard(options?: UseClipboardOptions): UseClipboardReturn;
+
+/**
+ * Returns the value from the previous render. Useful for diffing props,
+ * detecting transitions, and triggering effects on specific value changes.
+ *
+ * @example
+ * const prevId = usePrevious(currentId)
+ * useEffect(() => {
+ *   if (prevId !== currentId) trackNavigation(prevId, currentId)
+ * }, [prevId, currentId])
+ *
+ * @returns `undefined` on first render, then the value from the previous render.
+ */
+declare function usePrevious<T>(value: T): T | undefined;
+
+/**
+ * Lightweight async-state hook for one-shot fetches without bringing in
+ * TanStack Query. Tracks loading / data / error and exposes a stable
+ * `run` function plus a `reset`. For request deduplication, caching,
+ * retry, mutation, optimistic updates, etc. **prefer TanStack Query** —
+ * this hook intentionally stays tiny.
+ *
+ * @example
+ * const { data, error, status, run } = useAsync<User>()
+ * useEffect(() => { run(() => fetch(`/api/users/${id}`).then(r => r.json())) }, [id, run])
+ * if (status === 'loading') return <Skeleton />
+ * if (status === 'error') return <ErrorState onRetry={run} />
+ * return <UserCard user={data!} />
+ */
+type AsyncStatus = 'idle' | 'loading' | 'success' | 'error';
+interface UseAsyncReturn<T> {
+    data: T | null;
+    error: unknown;
+    status: AsyncStatus;
+    isIdle: boolean;
+    isLoading: boolean;
+    isSuccess: boolean;
+    isError: boolean;
+    /** Run an async operation. Cancels the previous in-flight result. */
+    run: (operation: () => Promise<T>) => Promise<T | undefined>;
+    reset: () => void;
+}
+declare function useAsync<T = unknown>(initialData?: T | null): UseAsyncReturn<T>;
+
+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 };