@parto-system-design/ui 1.1.5 → 1.1.7

package/dist/i18n-CAd9wGOr.d.cts

@@ -0,0 +1,344 @@
+import { S as SupportedLocale } from './utils-DlXWmDZ-.cjs';
+
+type Locale = SupportedLocale;
+/**
+ * Returns true for RTL locales (fa, ar).
+ */
+declare function isRTL(locale: SupportedLocale): boolean;
+/**
+ * UI string translations used by the EngagementRate component.
+ * Centralised here to avoid duplication between components.
+ */
+declare const engagementUiTranslations: Record<SupportedLocale, {
+    yourCategory: string;
+    influencer: string;
+    followers: string;
+    over: string;
+    to: string;
+    and: string;
+    lessThan: string;
+    you: string;
+    criteria: string;
+}>;
+/**
+ * Sentiment label translations used by the SentimentBadge component.
+ */
+declare const sentimentLabels: Record<SupportedLocale, {
+    positive: string;
+    negative: string;
+    neutral: string;
+    mixed: string;
+}>;
+/**
+ * Canonical emotion keys — 9-class advanced sentiment scale used in افکارسنجی
+ * deep analysis. Coexists with the simple 3-class `Sentiment` above; they are
+ * NOT interchangeable. Choose the scale based on view density.
+ */
+type EmotionKey = 'anger' | 'anticipation' | 'joy' | 'trust' | 'fear' | 'surprise' | 'sadness' | 'disgust' | 'neutral';
+declare const EMOTION_KEYS: readonly EmotionKey[];
+/** Emotion label translations used by EmotionBadge / EmotionDistribution. */
+declare const emotionLabels: Record<SupportedLocale, Record<EmotionKey, string>>;
+/**
+ * Political flow keys — 5-class classification used in افکارسنجی clustering.
+ * A concept / post / page belongs to exactly one flow (primary) but usually
+ * also has secondary flow composition expressed as percentages.
+ */
+type FlowKey = 'pro-gov' | 'internal-critic' | 'internal-opponent' | 'external-opponent' | 'grey';
+declare const FLOW_KEYS: readonly FlowKey[];
+declare const flowLabels: Record<SupportedLocale, Record<FlowKey, string>>;
+/** Operational status — visual state of a tracked entity. */
+type StatusKey = 'critical' | 'warning' | 'normal';
+declare const statusLabels: Record<SupportedLocale, Record<StatusKey, string>>;
+/** Severity — urgency level. Independent from status. */
+type SeverityKey = 'urgent' | 'high' | 'medium' | 'low';
+declare const severityLabels: Record<SupportedLocale, Record<SeverityKey, string>>;
+/**
+ * Job lifecycle — canonical states for async work (analyses, campaigns,
+ * evaluation runs, imports, exports, report generation).
+ *
+ * Terminal states: completed / failed / cancelled.
+ * Active states: queued / running / paused.
+ */
+type JobStatusKey = 'queued' | 'running' | 'paused' | 'completed' | 'failed' | 'cancelled';
+declare const JOB_STATUS_KEYS: readonly JobStatusKey[];
+declare const jobStatusLabels: Record<SupportedLocale, Record<JobStatusKey, string>>;
+/** True iff a job is still active (not in a terminal state). */
+declare function isActiveJobStatus(s: JobStatusKey): boolean;
+/**
+ * Action status — discrete outcome for a single completed (or in-flight)
+ * action in an activity feed / audit timeline. Distinct from the richer
+ * job/stage lifecycles above: each event is atomic, so no "paused" here.
+ */
+type ActionStatusKey = 'success' | 'failed' | 'pending' | 'warning' | 'info';
+declare const ACTION_STATUS_KEYS: readonly ActionStatusKey[];
+declare const actionStatusLabels: Record<SupportedLocale, Record<ActionStatusKey, string>>;
+/**
+ * Locale-aware relative time label producer. Used by ActionTimeline and any
+ * other component that wants trilingual "n minutes ago" strings. For absolute
+ * formatting see `formatAbsoluteTime`/`formatJalaliDate` in lib/utils.ts.
+ */
+declare function formatRelativeLocaleTime(date: Date | string | number, locale: SupportedLocale): string;
+/**
+ * Locale-aware "time remaining" label — forward-looking companion to
+ * `formatRelativeLocaleTime`. Used by RateLimitBanner and any countdown UI.
+ *
+ * Input can be a Date, ISO string, or epoch ms. Past/zero remaining returns
+ * the locale-specific "now" / "any moment" marker.
+ */
+declare function formatTimeRemaining(target: Date | string | number, locale: SupportedLocale): string;
+/**
+ * Stage status — for multi-stage pipeline visualizations (StatusFlow).
+ *
+ * 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.
+ */
+declare const UI_STRINGS: {
+    readonly fa: {
+        readonly noResults: "نتیجه‌ای یافت نشد";
+        readonly suggestions: "پیشنهادها";
+        readonly select: "انتخاب کنید";
+        readonly noOptionsFound: "موردی یافت نشد";
+        readonly search: "جستجو...";
+        readonly clearAll: "پاک کردن همه";
+        readonly selectDate: "انتخاب تاریخ";
+        readonly selectDateRange: "انتخاب بازه تاریخ";
+        readonly errorLoadingData: "خطا در بارگذاری داده‌ها";
+        readonly retry: "تلاش مجدد";
+        readonly remove: "حذف";
+        readonly noUsersFound: "کاربری یافت نشد";
+        readonly goToPreviousPage: "رفتن به صفحه قبلی";
+        readonly goToNextPage: "رفتن به صفحه بعدی";
+        readonly previous: "قبلی";
+        readonly next: "بعدی";
+        readonly actions: "عملیات";
+        readonly copy: "کپی";
+        readonly copied: "کپی شد";
+        readonly confirm: "تایید";
+        readonly cancel: "انصراف";
+        readonly areYouSure: "آیا مطمئن هستید؟";
+        readonly stepperLabel: "مراحل";
+        readonly stepCompleted: "تکمیل شده";
+        readonly stepCurrent: "مرحله فعلی";
+        readonly stepPending: "در انتظار";
+        readonly clearFilters: "پاک کردن فیلترها";
+        readonly activeFilters: "فیلترهای فعال";
+        readonly filters: "فیلترها";
+        readonly applyFilters: "اعمال";
+        readonly resetFilters: "پیش‌فرض";
+        readonly noFiltersActive: "فیلتر فعالی نیست";
+        readonly clearSection: "پاک کردن این بخش";
+        readonly goBack: "بازگشت";
+        readonly gridView: "نمای شبکه‌ای";
+        readonly listView: "نمای لیستی";
+        readonly loading: "در حال بارگذاری...";
+        readonly unexpectedError: "خطای غیرمنتظره‌ای رخ داد";
+        readonly selectAll: "انتخاب همه";
+        readonly selectRow: "انتخاب ردیف";
+        readonly noDataToDisplay: "داده‌ای برای نمایش وجود ندارد";
+        readonly likesCount: "تعداد لایک";
+        readonly commentsCount: "تعداد کامنت";
+        readonly viewsCount: "تعداد بازدید";
+        readonly sharesCount: "تعداد اشتراک";
+        readonly postTypeLabel: "نوع پست";
+        readonly postTypePhoto: "عکس";
+        readonly postTypeVideo: "ویدیو";
+        readonly postTypeCarousel: "اسلاید";
+        readonly showMore: "بیشتر";
+        readonly showLess: "کمتر";
+        readonly noMediaAvailable: "رسانه‌ای موجود نیست";
+        readonly commentAnalysis: "تحلیل کامنت‌ها";
+        readonly commentAnalysisDisabled: "تحلیل کامنت‌ها (غیرفعال)";
+        readonly booster: "بوستر";
+        readonly boosterDisabled: "بوستر (غیرفعال)";
+        readonly aiAnalysis: "تحلیل هوش مصنوعی";
+        readonly aiAnalysisDisabled: "تحلیل هوش مصنوعی (غیرفعال)";
+        readonly openOnInstagram: "باز کردن در اینستاگرام";
+        readonly openOnInstagramDisabled: "باز کردن در اینستاگرام (غیرفعال)";
+    };
+    readonly ar: {
+        readonly noResults: "لم يتم العثور على نتائج";
+        readonly suggestions: "اقتراحات";
+        readonly select: "اختر";
+        readonly noOptionsFound: "لم يتم العثور على خيارات";
+        readonly search: "بحث...";
+        readonly clearAll: "مسح الكل";
+        readonly selectDate: "اختر تاريخ";
+        readonly selectDateRange: "اختر نطاق التاريخ";
+        readonly errorLoadingData: "خطأ في تحميل البيانات";
+        readonly retry: "إعادة المحاولة";
+        readonly remove: "حذف";
+        readonly noUsersFound: "لم يتم العثور على مستخدمين";
+        readonly goToPreviousPage: "الانتقال إلى الصفحة السابقة";
+        readonly goToNextPage: "الانتقال إلى الصفحة التالية";
+        readonly previous: "السابق";
+        readonly next: "التالي";
+        readonly actions: "إجراءات";
+        readonly copy: "نسخ";
+        readonly copied: "تم النسخ";
+        readonly confirm: "تأكيد";
+        readonly cancel: "إلغاء";
+        readonly areYouSure: "هل أنت متأكد؟";
+        readonly stepperLabel: "الخطوات";
+        readonly stepCompleted: "مكتمل";
+        readonly stepCurrent: "الخطوة الحالية";
+        readonly stepPending: "قيد الانتظار";
+        readonly clearFilters: "مسح الفلاتر";
+        readonly activeFilters: "الفلاتر النشطة";
+        readonly filters: "الفلاتر";
+        readonly applyFilters: "تطبيق";
+        readonly resetFilters: "الافتراضي";
+        readonly noFiltersActive: "لا توجد فلاتر نشطة";
+        readonly clearSection: "مسح هذا القسم";
+        readonly goBack: "رجوع";
+        readonly gridView: "عرض شبكي";
+        readonly listView: "عرض قائمة";
+        readonly loading: "جارٍ التحميل...";
+        readonly unexpectedError: "حدث خطأ غير متوقع";
+        readonly selectAll: "تحديد الكل";
+        readonly selectRow: "تحديد الصف";
+        readonly noDataToDisplay: "لا توجد بيانات للعرض";
+        readonly likesCount: "عدد الإعجابات";
+        readonly commentsCount: "عدد التعليقات";
+        readonly viewsCount: "عدد المشاهدات";
+        readonly sharesCount: "عدد المشاركات";
+        readonly postTypeLabel: "نوع المنشور";
+        readonly postTypePhoto: "صورة";
+        readonly postTypeVideo: "فيديو";
+        readonly postTypeCarousel: "شرائح";
+        readonly showMore: "المزيد";
+        readonly showLess: "أقل";
+        readonly noMediaAvailable: "لا توجد وسائط";
+        readonly commentAnalysis: "تحليل التعليقات";
+        readonly commentAnalysisDisabled: "تحليل التعليقات (معطل)";
+        readonly booster: "تعزيز";
+        readonly boosterDisabled: "تعزيز (معطل)";
+        readonly aiAnalysis: "تحليل الذكاء الاصطناعي";
+        readonly aiAnalysisDisabled: "تحليل الذكاء الاصطناعي (معطل)";
+        readonly openOnInstagram: "فتح في إنستاجرام";
+        readonly openOnInstagramDisabled: "فتح في إنستاجرام (معطل)";
+    };
+    readonly en: {
+        readonly noResults: "No results found";
+        readonly suggestions: "Suggestions";
+        readonly select: "Select";
+        readonly noOptionsFound: "No options found";
+        readonly search: "Search...";
+        readonly clearAll: "Clear all";
+        readonly selectDate: "Select date";
+        readonly selectDateRange: "Select date range";
+        readonly errorLoadingData: "Error loading data";
+        readonly retry: "Retry";
+        readonly remove: "Remove";
+        readonly noUsersFound: "No users found";
+        readonly goToPreviousPage: "Go to previous page";
+        readonly goToNextPage: "Go to next page";
+        readonly previous: "Previous";
+        readonly next: "Next";
+        readonly actions: "Actions";
+        readonly copy: "Copy";
+        readonly copied: "Copied";
+        readonly confirm: "Confirm";
+        readonly cancel: "Cancel";
+        readonly areYouSure: "Are you sure?";
+        readonly stepperLabel: "Steps";
+        readonly stepCompleted: "Completed";
+        readonly stepCurrent: "Current step";
+        readonly stepPending: "Pending";
+        readonly clearFilters: "Clear filters";
+        readonly activeFilters: "Active filters";
+        readonly filters: "Filters";
+        readonly applyFilters: "Apply";
+        readonly resetFilters: "Reset";
+        readonly noFiltersActive: "No active filters";
+        readonly clearSection: "Clear this section";
+        readonly goBack: "Go back";
+        readonly gridView: "Grid view";
+        readonly listView: "List view";
+        readonly loading: "Loading...";
+        readonly unexpectedError: "An unexpected error occurred";
+        readonly selectAll: "Select all";
+        readonly selectRow: "Select row";
+        readonly noDataToDisplay: "No data to display";
+        readonly likesCount: "Likes";
+        readonly commentsCount: "Comments";
+        readonly viewsCount: "Views";
+        readonly sharesCount: "Shares";
+        readonly postTypeLabel: "Post type";
+        readonly postTypePhoto: "Photo";
+        readonly postTypeVideo: "Video";
+        readonly postTypeCarousel: "Carousel";
+        readonly showMore: "More";
+        readonly showLess: "Less";
+        readonly noMediaAvailable: "No media available";
+        readonly commentAnalysis: "Comment Analysis";
+        readonly commentAnalysisDisabled: "Comment Analysis (disabled)";
+        readonly booster: "Booster";
+        readonly boosterDisabled: "Booster (disabled)";
+        readonly aiAnalysis: "AI Analysis";
+        readonly aiAnalysisDisabled: "AI Analysis (disabled)";
+        readonly openOnInstagram: "Open on Instagram";
+        readonly openOnInstagramDisabled: "Open on Instagram (disabled)";
+    };
+};
+type UIStringKeys = keyof (typeof UI_STRINGS)['fa'];
+type UIStrings = Record<UIStringKeys, string>;
+/**
+ * Get UI strings for a given locale.
+ * Falls back to 'fa' for unknown locales.
+ */
+declare function getUIStrings(locale?: SupportedLocale): UIStrings;
+
+export { type ActionStatusKey as A, entityHealthLabels as B, entityHealthPriority as C, isCriticalEntityHealth as D, type EntityHealthKey as E, type FlowKey as F, type UIStringKeys as G, type UIStrings as H, getUIStrings as I, type JobStatusKey as J, type Locale as L, type StageStatusKey as S, UI_STRINGS as U, type ActionTypeKey as a, type EmotionKey as b, type StatusKey as c, type SeverityKey as d, engagementUiTranslations as e, EMOTION_KEYS as f, emotionLabels as g, FLOW_KEYS as h, isRTL as i, flowLabels as j, statusLabels as k, severityLabels as l, JOB_STATUS_KEYS as m, jobStatusLabels as n, isActiveJobStatus as o, ACTION_STATUS_KEYS as p, actionStatusLabels as q, formatRelativeLocaleTime as r, sentimentLabels as s, formatTimeRemaining as t, STAGE_STATUS_KEYS as u, stageStatusLabels as v, ACTION_TYPE_KEYS as w, actionTypeLabels as x, actionTypeVerbs as y, ENTITY_HEALTH_KEYS as z };