@parto-system-design/ui 1.1.17 → 1.1.18

package/dist/server-m6tiB6DB.d.ts

@@ -0,0 +1,829 @@
+import { S as SupportedLocale } from './utils-Czyp5Ned.js';
+import './i18n-UEClNsBy.js';
+import { LucideIcon } from 'lucide-react';
+import { SocialPlatform } from './components/ui/social-platform-badge.js';
+
+/**
+ * Persian (Jalali / Solar Hijri) calendar utilities.
+ *
+ * Backed by **date-fns-jalali** — a Jalali-native fork of date-fns v4.
+ * Chosen over moment-jalaali (unmaintained since 2019) because:
+ *   • Tree-shakeable, zero dependencies
+ *   • Built-in TypeScript types
+ *   • Tracks upstream date-fns releases
+ *   • Built-in fa-IR locale with month/weekday names
+ *   • ~5-10KB gzipped for typical usage
+ *
+ * DO NOT replace this library again. This decision was made after
+ * evaluating date-fns-jalali, jalaali-js, jalaliday (dayjs), moment-jalaali,
+ * and persian-date in April 2026. date-fns-jalali is the clear winner
+ * for a design system that needs formatting, parsing, and locale support.
+ */
+/**
+ * Persian/Farsi month names
+ */
+declare const PERSIAN_MONTHS: string[];
+/**
+ * Persian/Farsi short month names
+ */
+declare const PERSIAN_MONTHS_SHORT: string[];
+/**
+ * Persian/Farsi weekday names
+ */
+declare const PERSIAN_WEEKDAYS: string[];
+/**
+ * Persian/Farsi short weekday names
+ */
+declare const PERSIAN_WEEKDAYS_SHORT: string[];
+/**
+ * Convert English digits to Persian/Farsi digits
+ */
+declare function toPersianDigits(num: number | string): string;
+/**
+ * Convert Persian/Farsi digits to English digits
+ */
+declare function toEnglishDigits(str: string): string;
+/**
+ * Format a Date object to Persian/Jalali date string.
+ *
+ * Uses date-fns-jalali format tokens:
+ *   yyyy = Jalali year, MM = month (01-12), dd = day (01-31)
+ *   MMMM = full month name, EEEE = full weekday name
+ *   HH:mm = 24h time, hh:mm a = 12h time
+ */
+declare function formatJalaliDate(date: Date, formatStr?: string): string;
+/**
+ * Get Persian month name from a Date object
+ */
+declare function getPersianMonthName(date: Date): string;
+/**
+ * Get Persian short month name from a Date object
+ */
+declare function getPersianMonthNameShort(date: Date): string;
+/**
+ * Get Persian weekday name from a Date object
+ */
+declare function getPersianWeekdayName(date: Date, short?: boolean): string;
+/**
+ * Get Persian year from a Date object
+ */
+declare function getPersianYear(date: Date): number;
+/**
+ * Get Persian month (0-11) from a Date object
+ */
+declare function getPersianMonth(date: Date): number;
+/**
+ * Get Persian day from a Date object
+ */
+declare function getPersianDay(date: Date): number;
+/**
+ * Create a Date object from Persian/Jalali date
+ */
+declare function jalaliToGregorian(year: number, month: number, day: number): Date;
+/**
+ * Format date range in Persian
+ */
+declare function formatPersianDateRange(from: Date, to: Date): string;
+/**
+ * Get all months for a dropdown (returns array of {value, label})
+ */
+declare function getPersianMonthsForDropdown(): Array<{
+    value: number;
+    label: string;
+}>;
+/**
+ * Get years range for a dropdown
+ */
+declare function getPersianYearsForDropdown(fromYear: number, toYear: number): Array<{
+    value: number;
+    label: string;
+}>;
+
+type EngagementTier = 'excellent' | 'veryGood' | 'good' | 'average' | 'couldBeImproved' | 'low';
+type FollowerGroup = 'nano' | 'micro' | 'mid' | 'macro' | 'mega';
+interface EngagementRange {
+    label: string;
+    min: number;
+    max: number;
+    color: string;
+    colorFaded: string;
+    hoverColor: string;
+    /** Accessible text color for use on hoverColor background */
+    contrastText: string;
+}
+interface EngagementRangeWithDisplay extends EngagementRange {
+    display: string;
+}
+interface GroupThresholds {
+    followers: [number, number];
+    excellent: number;
+    veryGood: [number, number];
+    good: [number, number];
+    average: [number, number];
+    couldBeImproved: [number, number];
+    low: number;
+}
+declare const ENGAGEMENT_RANGES: Record<FollowerGroup, GroupThresholds>;
+declare const TIER_LABELS: Record<SupportedLocale, Record<EngagementTier, string>>;
+declare const GROUP_LABELS: Record<SupportedLocale, Record<FollowerGroup, string>>;
+declare function getFollowerGroup(followers: number): FollowerGroup;
+declare function getEngagementRanges(followers: number, locale: SupportedLocale): EngagementRangeWithDisplay[];
+declare function getCurrentRangeIndex(currentRate: number, ranges: EngagementRange[]): number;
+
+/**
+ * Iran's 31 provinces with trilingual labels and ISO 3166-2 codes.
+ *
+ * Use as a stable identifier source for `IranProvinceHeat`, `RegionPicker`,
+ * and any public-opinion dashboard scoped by استان. The slug (`code`) is the
+ * canonical key — never rely on label string equality, since labels are
+ * locale-dependent and may evolve.
+ *
+ * Codes follow ISO 3166-2:IR (e.g. 'IR-07' for Tehran). The slug is the
+ * lowercased, hyphenated English name without diacritics, suitable for URLs
+ * and CSS selectors. Use `getProvinceLabel(code, locale)` to resolve a label.
+ */
+
+interface IranProvince {
+    /** Stable URL-safe slug. The canonical key for province lookups. */
+    slug: string;
+    /** ISO 3166-2:IR code (e.g. 'IR-07'). */
+    iso: string;
+    /** Trilingual labels — fa is the canonical/native form. */
+    labels: Record<SupportedLocale, string>;
+}
+declare const IRAN_PROVINCES: readonly IranProvince[];
+type IranProvinceSlug = (typeof IRAN_PROVINCES)[number]['slug'];
+/** Look up a province by slug or ISO code. Returns undefined for unknown codes. */
+declare function findProvince(codeOrSlug: string): IranProvince | undefined;
+/**
+ * Resolve the locale-appropriate label for a province slug or ISO code.
+ * Falls back to fa for unknown locales and to the slug itself for unknown
+ * provinces (so the row still renders something instead of crashing).
+ */
+declare function getProvinceLabel(codeOrSlug: string, locale?: SupportedLocale): string;
+
+/**
+ * Curated country list with trilingual labels + flag emoji.
+ *
+ * Scope: ISO 3166-1 alpha-2 codes for ~80 countries that recur in افکارسنجی
+ * and influencer dashboards we serve — neighbors of Iran, the Gulf, MENA,
+ * major Western markets, and Asian/African markets relevant to Persian-
+ * speaking audiences. The flag emoji is the regional-indicator pair for the
+ * code; modern OS fonts render it as a flag.
+ *
+ * This is NOT an exhaustive ISO 3166 dataset — for country-level analytics
+ * outside this scope, consumers should pass their own list to `CountryPicker`
+ * via the `options` prop.
+ */
+
+interface Country {
+    /** ISO 3166-1 alpha-2 code (uppercase). The canonical key. */
+    code: string;
+    /** Trilingual labels — fa is the canonical/native form. */
+    labels: Record<SupportedLocale, string>;
+}
+/** Convert an ISO 3166-1 alpha-2 code to its flag-emoji pair. */
+declare function countryFlag(code: string): string;
+declare const COUNTRIES: readonly Country[];
+type CountryCode = (typeof COUNTRIES)[number]['code'];
+/** Look up a country by ISO 3166-1 alpha-2 code. Returns undefined for unknown codes. */
+declare function findCountry(code: string): Country | undefined;
+/** Resolve the locale-appropriate label for a country code. */
+declare function getCountryLabel(code: string, locale: SupportedLocale): string;
+
+/**
+ * Standard size scale used across the design system.
+ * Components should accept these values for their `size` prop.
+ */
+type StandardSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+/** @deprecated Use `StandardSize` instead — legacy names have been removed */
+type LegacySize = StandardSize;
+/** @deprecated Use `StandardSize` instead */
+type SizeWithLegacy = StandardSize;
+/**
+ * Normalizes a size value to standard names.
+ * @deprecated All sizes are standard now — this function is a no-op passthrough.
+ */
+declare function normalizeSize(size: StandardSize): StandardSize;
+
+/**
+ * The full set of sources a post can originate from in Parto's social-listening +
+ * افکارسنجی pipeline. Extends `SocialPlatform` (7 social networks) with broadcast
+ * (tv, radio) and editorial (press, web) sources.
+ */
+type PostSource = SocialPlatform | 'tv' | 'radio' | 'press' | 'web';
+/** High-level grouping that drives header layout and default metric ordering. */
+type PostSourceCategory = 'social' | 'broadcast' | 'editorial';
+/**
+ * Derive the source category from a `PostSource` value.
+ * Used internally by `<PostHeader>`, metric label helpers, and default-actions config.
+ */
+declare function sourceCategory(source: PostSource): PostSourceCategory;
+/**
+ * @deprecated Use {@link PostSource} for new code. `PostPlatform` is retained with its
+ * historical meaning (the 7 social networks only) so existing components that target
+ * social-specific APIs (e.g. `<SocialPlatformBadge>`) keep their narrow contract.
+ * `PostSource` is the expanded superset (adds tv / radio / press / web).
+ */
+type PostPlatform = SocialPlatform;
+/**
+ * Canonical render mode for `<PostList>` and `<PostCard>`:
+ *   - `compact`     — dense list row with side thumbnail and 1-line preview
+ *   - `comfortable` — full vertical card with header, body, media, metrics, signals
+ *   - `grid`        — magazine/visual layout (aspect-square media-dominant tile)
+ */
+type PostView = 'compact' | 'comfortable' | 'grid';
+/**
+ * Two-mode subset used by sub-components that don't ship a `grid` layout
+ * (`<PostHeader>`, `<PostHeaderBroadcast>`, `<PostHeaderEditorial>`,
+ * `<PostMetadata>`, `<PostSignals>`). `<PostCard>` internally narrows its
+ * `view` down to this when rendering those sub-components.
+ */
+type PostDensity = 'compact' | 'comfortable';
+type PostSentiment = 'positive' | 'negative' | 'neutral' | 'mixed';
+type PostEmotion = 'anger' | 'anticipation' | 'joy' | 'trust' | 'fear' | 'surprise' | 'sadness' | 'disgust' | 'neutral';
+/** Audience-stance classification — see CLAUDE.md domain concepts. */
+type PostFlow = 'pro-gov' | 'internal-critic' | 'internal-opponent' | 'external-opponent' | 'grey';
+type PostSeverity = 'low' | 'medium' | 'high' | 'critical';
+type PostStatus = 'normal' | 'warning' | 'critical';
+type PostAuthorityTier = 'nano' | 'micro' | 'macro' | 'mega';
+interface PostAuthor {
+    name: string;
+    handle?: string;
+    avatarUrl?: string;
+    verified?: boolean;
+    /** Optional follower / subscriber count. */
+    followers?: number;
+    /** Optional following / friends count — rendered in the author HoverCard. */
+    following?: number;
+    /** Optional total post count — rendered in the author HoverCard. */
+    postCount?: number;
+    /** Short bio / description from the author's profile (1-2 sentences). */
+    bio?: string;
+    /** Influence score 0..100 — used to render the authority chip on the card. */
+    authorityScore?: number;
+    /** Categorical author tier inferred from follower count + engagement. */
+    authorityTier?: PostAuthorityTier;
+}
+/**
+ * Editorial / broadcast actor. Used when the post originates from press, web, tv, radio
+ * instead of an individual social-platform account.
+ */
+interface PostOutlet {
+    name: string;
+    logoUrl?: string;
+    /** Editorial only: web domain ("hamshahrionline.ir"). */
+    domain?: string;
+    /** Editorial only: 0..100 SEO/credibility signal. */
+    domainAuthority?: number;
+    /** Broadcast only: TV channel or radio station ("شبکه ۱", "رادیو پیام"). */
+    channel?: string;
+    /** Broadcast only: program / show name. */
+    program?: string;
+    /** Editorial only: byline / journalist name. */
+    reporterName?: string;
+}
+/**
+ * Per-item ingestion status. Drives how `<PostMedia>` renders each item:
+ * - `ready`: image/video/audio is downloaded and viewable.
+ * - `loading`: the panel is fetching the media right now — render a shimmer.
+ * - `failed`: download failed — render retry placeholder.
+ * - `unavailable`: source has media but we never captured it — render "ذخیره نشده" placeholder.
+ */
+type PostMediaStatus = 'ready' | 'loading' | 'failed' | 'unavailable';
+/** Sensitive-content classifications. Used at media-level and post-level. */
+type PostMediaSensitivity = 'nsfw' | 'graphic' | 'spoiler';
+interface PostMediaItem {
+    url: string;
+    thumbnailUrl?: string;
+    /** Natural aspect ratio (width / height). Defaults to 1. */
+    aspectRatio?: number;
+    alt?: string;
+    type?: 'image' | 'video' | 'audio';
+    /** Duration in seconds for video / audio. */
+    duration?: number;
+    /** Ingestion status. Defaults to 'ready'. */
+    status?: PostMediaStatus;
+    /** Sensitivity tag — if set, the renderer blurs the media until revealed. */
+    sensitivity?: PostMediaSensitivity;
+    /** Audio only: URL of a waveform peaks file or a pre-rendered SVG / inline data URI. */
+    waveformUrl?: string;
+}
+/** Open Graph–style URL preview embedded inside a text body. */
+interface PostUrlPreview {
+    url: string;
+    domain: string;
+    title?: string;
+    description?: string;
+    thumbnailUrl?: string;
+}
+/**
+ * Sticker overlays found on Instagram stories (mentions, polls, location, music, etc.).
+ * Captured to preserve story context after crawling. Coordinates are normalized 0..1.
+ */
+interface StoryStickerOverlay {
+    /** Type of sticker — drives the icon and label in `<PostMediaStory>`. */
+    type: 'mention' | 'location' | 'hashtag' | 'music' | 'poll' | 'question' | 'time' | 'link' | 'other';
+    /** Human-readable label (e.g. "@digikala", "Tehran", "#خرید_آنلاین"). */
+    label: string;
+    /** Optional secondary text — for polls/questions, the question text. */
+    secondaryText?: string;
+    /** Normalized x/y position on the story canvas (0..1). */
+    x?: number;
+    y?: number;
+}
+/** Per-story metadata extracted at crawl time. */
+interface StoryItem {
+    /** The captured media (image or video). */
+    media: PostMediaItem;
+    /** OCR-extracted text from the story canvas (visible Persian/English text). */
+    ocrText?: string;
+    /** Transcript for video stories. */
+    transcript?: string;
+    /** Story sticker overlays (mentions, polls, location, etc.). */
+    stickers?: StoryStickerOverlay[];
+    /** Story publication time — distinct from the post wrapper's timestamp. */
+    publishedAt?: Date | string | number;
+    /** Outbound "swipe up" / link sticker URL. */
+    swipeUpUrl?: string;
+    /** Story view count (Stories use viewers, not likes). */
+    viewCount?: number;
+}
+/**
+ * Discriminated union of body shapes. The renderer in `<PostBody>` switches on `type`.
+ *
+ * Story-related variants:
+ *   - `story` — single ephemeral story (9:16, OCR text overlay, optional swipe-up link)
+ *   - `highlight` — saved-story collection under a titled cover; renders as a strip of stories
+ * Other social media coverage:
+ *   - `media-grid`, `media-carousel`, `video`, `audio`, `text` — generic
+ * Failure states:
+ *   - `missing-media`, `source-removed`
+ */
+type PostBodyData = {
+    type: 'text';
+    text: string;
+    urlPreview?: PostUrlPreview;
+} | {
+    type: 'media-single';
+    media: PostMediaItem;
+    caption?: string;
+    urlPreview?: PostUrlPreview;
+} | {
+    type: 'media-grid';
+    items: PostMediaItem[];
+    caption?: string;
+} | {
+    type: 'media-carousel';
+    items: PostMediaItem[];
+    caption?: string;
+} | {
+    type: 'video';
+    media: PostMediaItem;
+    caption?: string;
+} | {
+    type: 'audio';
+    media: PostMediaItem;
+    caption?: string;
+} | {
+    type: 'story';
+    story: StoryItem;
+    caption?: string;
+} | {
+    type: 'highlight';
+    title: string;
+    coverUrl?: string;
+    stories: StoryItem[];
+    caption?: string;
+} | {
+    type: 'missing-media';
+    caption?: string;
+    reason?: string;
+} | {
+    type: 'source-removed';
+    archivedAt?: Date | string | number;
+    archiveUrl?: string;
+    caption?: string;
+};
+/**
+ * Unified metric envelope. Labels are platform-aware via `getMetricLabel(source, key, locale)`;
+ * the same `views` field is rendered as "بازدید" (Instagram/YouTube), "تماشا" (TikTok),
+ * "نمایش" (X), "بیننده" (TV), "شنونده" (Radio) depending on the post's source.
+ */
+interface PostMetrics {
+    /** Generic "consumption" metric — viewers / impressions / plays / page-views. */
+    views?: number;
+    likes?: number;
+    comments?: number;
+    /** Generic share count. */
+    shares?: number;
+    /** Reposts: X retweets, Threads reposts, Telegram forwards. */
+    reposts?: number;
+    /** Quote-with-comment: X quote-tweets, Threads quotes. */
+    quotes?: number;
+    /** Saves/bookmarks: IG, TikTok, LinkedIn. */
+    saves?: number;
+    /** Estimated reach / potential audience. */
+    reach?: number;
+    /** Engagement rate as 0..1 decimal (e.g. 0.034 = 3.4%). */
+    engagementRate?: number;
+    /** Broadcast: TV viewers / Radio listeners. Editorial: readers. One field, label per source. */
+    audience?: number;
+    /** Editorial: actual page-views distinct from `views`. */
+    reads?: number;
+    /** Editorial: SEO domain authority signal — also surfaced via `PostOutlet.domainAuthority`. */
+    domainAuthority?: number;
+    /** Reaction breakdown (Telegram emoji, LinkedIn 7-type, Facebook-style). */
+    reactions?: ReactionBreakdown;
+}
+/**
+ * Typed reaction breakdown. Sparse — only platforms that emit a given reaction fill it.
+ *   LinkedIn fills like/celebrate/support/love/insightful/funny.
+ *   Facebook fills like/love/care/haha/wow/sad/angry.
+ *   Telegram fills `emoji` with the raw map.
+ */
+interface ReactionBreakdown {
+    like?: number;
+    love?: number;
+    celebrate?: number;
+    support?: number;
+    insightful?: number;
+    funny?: number;
+    /** Facebook-only — empathy reaction. */
+    care?: number;
+    /** Facebook-only — laughing reaction. */
+    haha?: number;
+    /** Facebook-only — surprised reaction. */
+    wow?: number;
+    /** Facebook-only — sad reaction. */
+    sad?: number;
+    /** Facebook-only — anger reaction. */
+    angry?: number;
+    /** Raw emoji → count map (Telegram channel reactions). */
+    emoji?: Record<string, number>;
+}
+interface PostTag {
+    id: string;
+    label: string;
+    /** 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;
+}
+/**
+ * Contextual flags surfaced as chips or banners on the card. Independent of media-level status.
+ */
+interface PostFlags {
+    pinned?: boolean;
+    edited?: boolean;
+    /** Optional edit count, surfaced in tooltip. */
+    editCount?: number;
+    sponsored?: boolean;
+    /** Post was deleted at source after we ingested it. */
+    deletedAtSource?: boolean;
+    /** Snapshot URL to our archived copy. */
+    archivedSnapshotUrl?: string;
+    /** Post-level sensitivity (distinct from per-media `sensitivity`). */
+    sensitive?: PostMediaSensitivity;
+}
+/** Cluster / topic membership — links the post to a parent analytical grouping. */
+interface PostCluster {
+    id: string;
+    label: string;
+    tone?: 'brand' | 'neutral' | 'warning';
+}
+/** "X reposted at Y" wrapper info. */
+interface PostRepostInfo {
+    by: PostAuthor;
+    at: Date | string | number;
+    /** Optional retweet-with-comment / Telegram forward note. */
+    comment?: string;
+}
+/** Position info when a post belongs to a multi-post thread. */
+interface PostThreadInfo {
+    threadId: string;
+    /** 1-indexed position in the thread. */
+    position: number;
+    total: number;
+    /** Optional id of the next thread post — used to draw the connector to the next visible card. */
+    nextId?: string;
+}
+type PlatformMetadata = {
+    platform: 'instagram';
+    postType?: 'feed' | 'reel' | 'story' | 'carousel' | 'igtv';
+    location?: string;
+    music?: {
+        title: string;
+        artist?: string;
+    };
+    saveCount?: number;
+    collaborators?: string[];
+    hashtags?: string[];
+} | {
+    platform: 'twitter';
+    tweetType?: 'original' | 'retweet' | 'quote' | 'reply';
+    quotedTweetUrl?: string;
+    inReplyTo?: string;
+    retweetCount?: number;
+    quoteCount?: number;
+    bookmarkCount?: number;
+    isThread?: boolean;
+    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;
+} | {
+    platform: 'facebook';
+    postType?: 'post' | 'photo' | 'video' | 'reel' | 'story' | 'event' | 'shared';
+    reactions?: {
+        like?: number;
+        love?: number;
+        care?: number;
+        haha?: number;
+        wow?: number;
+        sad?: number;
+        angry?: number;
+    };
+    shareCount?: number;
+    /** Page name if posted on behalf of a page (vs personal profile). */
+    pageName?: string;
+    pageFollowers?: number;
+} | {
+    platform: 'tv';
+    airDate?: Date | string | number;
+    durationSec?: number;
+    programType?: 'news' | 'talk-show' | 'documentary' | 'interview' | 'live' | 'other';
+    viewers?: number;
+    replays?: number;
+} | {
+    platform: 'radio';
+    airDate?: Date | string | number;
+    durationSec?: number;
+    programType?: 'news' | 'talk-show' | 'music' | 'interview' | 'live' | 'other';
+    listeners?: number;
+} | {
+    platform: 'press';
+    printedAt?: Date | string | number;
+    /** Print edition: issue / page reference. */
+    issue?: string;
+    pageNumber?: number;
+    /** Optional AVE (Ad Value Equivalent) — common press metric. */
+    adValueEquivalent?: number;
+    hashtags?: string[];
+} | {
+    platform: 'web';
+    contentType?: 'blog' | 'forum' | 'news' | 'review' | 'comment' | 'other';
+    /** Reference to a parent thread / discussion if part of one. */
+    threadUrl?: string;
+    hashtags?: string[];
+};
+interface PostData {
+    id: string;
+    /**
+     * Source platform — full 11-source taxonomy (social + broadcast + editorial).
+     * Header layout and metric labels dispatch on this value via `sourceCategory(source)`.
+     */
+    source: PostSource;
+    /** Headline (editorial), program/segment (broadcast), video title (YouTube). */
+    title?: string;
+    /** Present for social posts; optional for editorial/broadcast where `outlet` is the actor. */
+    author?: PostAuthor;
+    /** Editorial/broadcast outlet — used for press, web, tv, radio header variants. */
+    outlet?: PostOutlet;
+    body: PostBodyData;
+    /** Post creation / publish / air time. Accepts Date, ISO string, or unix ms. */
+    timestamp: Date | string | number;
+    metrics?: PostMetrics;
+    sentiment?: PostSentiment;
+    /** Dominant emotion (9-class) — surfaced as a chip on the card. */
+    emotion?: PostEmotion;
+    /** Audience-stance classification — surfaced as a chip on the card. */
+    flow?: PostFlow;
+    severity?: PostSeverity;
+    enrichments?: PostEnrichmentFlags;
+    flags?: PostFlags;
+    cluster?: PostCluster;
+    /** User-defined category tags. */
+    tags?: PostTag[];
+    /** @deprecated Use `author.authorityScore` instead. Kept for backward compat. */
+    authorityScore?: number;
+    /** ISO language code detected for the post. */
+    language?: string;
+    /** URL to the post at the source platform. */
+    sourceUrl?: string;
+    /** Quoted/embedded post (X quote-tweets, Threads quotes, Telegram forwards-with-comment). */
+    quoted?: PostData;
+    /** Parent post when this is a reply. */
+    parent?: PostData;
+    /** Repost wrapper info — when present, render "X reposted" header strip above the card. */
+    reposted?: PostRepostInfo;
+    /** Thread position info — when present, draw the thread-connector hairline. */
+    thread?: PostThreadInfo;
+    /** Platform-specific metadata block (discriminated by source). */
+    platformMeta?: PlatformMetadata;
+}
+interface PostAction {
+    id: string;
+    label: string;
+    icon: LucideIcon;
+    variant?: 'default' | 'danger';
+    onClick: (post: PostData) => void;
+    disabled?: boolean;
+    hidden?: boolean;
+}
+/** Bulk action surfaced in the floating bottom bar when posts are selected. */
+interface PostBulkAction {
+    id: string;
+    label: string;
+    icon: LucideIcon;
+    variant?: 'default' | 'danger' | 'brand';
+    /** Optional sub-options — rendered as dropdown menu when present. */
+    options?: Array<{
+        id: string;
+        label: string;
+        icon?: LucideIcon;
+    }>;
+    onClick: (selectedIds: string[], optionId?: string) => void;
+    disabled?: boolean;
+    hidden?: boolean;
+}
+interface PostCommentAuthor {
+    name: string;
+    handle?: string;
+    avatarUrl?: string;
+    verified?: boolean;
+    /** Optional badge: "Moderator", "Subscriber", "Author", etc. — surfaced as a chip next to the name. */
+    badge?: string;
+}
+interface PostComment {
+    id: string;
+    author: PostCommentAuthor;
+    text: string;
+    timestamp: Date | string | number;
+    sentiment?: PostSentiment;
+    likes?: number;
+    replies?: PostComment[];
+    /**
+     * Total reply count (may exceed `replies.length` if pagination caps the nested
+     * replies). Drives the "نمایش ۲۳ پاسخ" affordance.
+     */
+    replyCount?: number;
+    /** Pinned by post author (Instagram, YouTube). */
+    pinned?: boolean;
+    /** Indicates this is a reply from the original post author. */
+    authorReply?: boolean;
+    /** Comment was edited at source — show ویرایش‌شده chip. */
+    edited?: boolean;
+    /** ISO language code; enables translation toggle when different from current locale. */
+    language?: string;
+    /** Hidden by source moderator / shadow-banned. */
+    hiddenByModerator?: boolean;
+    /** Typed reaction breakdown (Facebook 7-type, LinkedIn 7-type, YouTube hearts, etc.). */
+    reactions?: ReactionBreakdown;
+    /** AI-detected toxicity / hate-speech / spam score (0..1). Surfaces a flag chip when set. */
+    toxicityScore?: number;
+    /** Pre-translated body (if cached). */
+    translatedText?: string;
+}
+type PostIntent = 'complaint' | 'praise' | 'question' | 'announcement' | 'comparison' | 'opinion' | 'info';
+interface PostAiEntity {
+    text: string;
+    type: 'person' | 'brand' | 'place' | 'product' | 'event' | 'organization';
+}
+interface PostAiAnalysis {
+    /** Auto-generated summary of the post. */
+    summary?: string;
+    /** Key topics mentioned in the post. */
+    topics?: string[];
+    /** Named entities detected. */
+    entities?: PostAiEntity[];
+    /** Primary intent classification. */
+    intent?: PostIntent;
+    /** 9-class emotion distribution (raw counts or normalized). */
+    emotions?: Partial<Record<PostEmotion, number>>;
+    /** Flagged risks / sensitive content categories. */
+    risks?: string[];
+    /** Influence tier estimate for the author. */
+    influenceTier?: PostAuthorityTier;
+    /** Model confidence 0..1 for overall analysis. */
+    confidence?: number;
+    /** Analysis generation timestamp. */
+    generatedAt?: Date | string | number;
+}
+/** Extended post details — optionally attached to PostData when fetching full view. */
+interface PostDetails {
+    comments?: PostComment[];
+    aiAnalysis?: PostAiAnalysis;
+    /** Text extracted from images via OCR. */
+    ocrText?: string;
+    /** Transcript for audio / video content. */
+    transcript?: string;
+    /** Platform-specific metadata block. */
+    platformMeta?: PlatformMetadata;
+}
+
+type SupportedMetricLocale = 'fa' | 'en';
+type MetricKey = keyof PostMetrics;
+/**
+ * Resolve a metric label for a given source + key + locale.
+ *
+ * Lookup order:
+ *   1. Source-specific override (e.g. tiktok.views → "تماشا")
+ *   2. Default for that locale (e.g. views → "بازدید")
+ *
+ * Never returns `undefined` — falls back to default labels.
+ */
+declare function getMetricLabel(source: PostSource, key: MetricKey, locale?: SupportedMetricLocale): string;
+
+/**
+ * Per-source metadata used by `<PostHeader>`, `<PostMetrics>`, badges, and the source-aware
+ * default actions. This is the single source of truth — adding a new platform = adding
+ * one entry here + one CSS var + one label entry in `post-metric-labels.ts`.
+ *
+ * Brand colors are referenced as CSS variables (`--social-platform-*`) and resolved at
+ * runtime so the dark/light theme can adapt where needed (twitter, threads, press, web).
+ */
+type SourceIconSource = 
+/** Icon comes from the brand-SVG set in `<SocialPlatformBadge>` (7 social platforms). */
+{
+    kind: 'social-brand';
+}
+/** Icon is a generic Lucide glyph (broadcast / editorial sources). */
+ | {
+    kind: 'lucide';
+    icon: LucideIcon;
+};
+interface PostSourceConfig {
+    /** English label, displayed when `showLabel` is on. */
+    label: string;
+    /** Persian (fa) label, for fa-locale headers and tooltips. */
+    labelFa: string;
+    /** Category: drives header layout switch. */
+    category: PostSourceCategory;
+    /** CSS variable name (without the `var()` wrapper). */
+    colorVar: string;
+    /** How to render the icon for this source. */
+    icon: SourceIconSource;
+    /**
+     * Default metric order — which metric keys to show by default and in what order.
+     * Consumers can override per-card via PostMetadata's `metricsOrder` prop.
+     */
+    defaultMetrics: ReadonlyArray<keyof PostMetrics>;
+}
+/** Look up the per-source config block. */
+declare function getPostSourceConfig(source: PostSource): PostSourceConfig;
+/**
+ * Convenience: read the brand color CSS variable for a source.
+ * Use as: `style={{ color: getSourceColorVar('instagram') }}` → `var(--social-platform-instagram)`.
+ */
+declare function getSourceColorVar(source: PostSource): string;
+
+export { type SizeWithLegacy as $, PERSIAN_MONTHS as A, PERSIAN_MONTHS_SHORT as B, type Country as C, PERSIAN_WEEKDAYS as D, ENGAGEMENT_RANGES as E, type FollowerGroup as F, GROUP_LABELS as G, PERSIAN_WEEKDAYS_SHORT as H, type IranProvinceSlug as I, type PlatformMetadata as J, type PostAiAnalysis as K, type LegacySize as L, type PostAiEntity as M, type PostAuthorityTier as N, type PostCommentAuthor as O, type PostData as P, type PostEmotion as Q, type PostFlags as R, type StoryItem as S, type PostFlow as T, type PostIntent as U, type PostMediaSensitivity as V, type PostMediaStatus as W, type PostSource as X, type PostSourceCategory as Y, type PostStatus as Z, type ReactionBreakdown as _, type PostView as a, type StandardSize as a0, TIER_LABELS as a1, countryFlag as a2, findCountry as a3, findProvince as a4, formatJalaliDate as a5, formatPersianDateRange as a6, getCountryLabel as a7, getCurrentRangeIndex as a8, getEngagementRanges as a9, getFollowerGroup as aa, getMetricLabel as ab, getPersianDay as ac, getPersianMonth as ad, getPersianMonthName as ae, getPersianMonthNameShort as af, getPersianMonthsForDropdown as ag, getPersianWeekdayName as ah, getPersianYear as ai, getPersianYearsForDropdown as aj, getPostSourceConfig as ak, getProvinceLabel as al, getSourceColorVar as am, jalaliToGregorian as an, normalizeSize as ao, sourceCategory as ap, toEnglishDigits as aq, toPersianDigits as ar, type PostAction as b, type PostMediaItem as c, type PostAuthor as d, type PostPlatform as e, type PostSentiment as f, type PostEnrichmentFlags as g, type PostDensity as h, type PostOutlet as i, type PostBodyData as j, type PostMetrics as k, type PostSeverity as l, type PostCluster as m, type PostRepostInfo as n, type PostThreadInfo as o, type PostUrlPreview as p, type PostBulkAction as q, type PostDetails as r, type PostComment as s, COUNTRIES as t, type CountryCode as u, type EngagementRange as v, type EngagementRangeWithDisplay as w, type EngagementTier as x, IRAN_PROVINCES as y, type IranProvince as z };