@parto-system-design/ui 1.1.5 → 1.1.8

package/dist/page-card-CmShVqG-.d.cts

@@ -0,0 +1,100 @@
+import * as React from 'react';
+import { S as SupportedLocale } from './utils-DlXWmDZ-.cjs';
+import * as class_variance_authority_types from 'class-variance-authority/types';
+import { c as StatusKey } from './i18n-CAd9wGOr.cjs';
+
+type SocialPlatform = 'instagram' | 'twitter' | 'tiktok' | 'youtube' | 'linkedin' | 'telegram' | 'threads' | 'facebook';
+interface SocialPlatformBadgeProps extends React.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.ForwardRefExoticComponent<SocialPlatformBadgeProps & React.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.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.ForwardRefExoticComponent<BotDetectionMeterProps & React.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.HTMLAttributes<HTMLDivElement> {
+    /** Account handle / display name (e.g., "@news_agency") */
+    handle: React.ReactNode;
+    /** Optional secondary subtitle (e.g., page category) */
+    subtitle?: React.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.ForwardRefExoticComponent<PageCardProps & React.RefAttributes<HTMLDivElement>>;
+
+export { BotDetectionMeter as B, PageCard as P, type SocialPlatform as S, type PageCardContentMix as a, type PageCardProps as b, SocialPlatformBadge as c, type SocialPlatformBadgeProps as d, type BotDetectionKey as e, type BotDetectionData as f, type BotDetectionMeterProps as g, socialPlatformBadgeVariants as s };

package/dist/page-card-HBn-cy4J.d.ts

@@ -0,0 +1,100 @@
+import * as React from 'react';
+import { S as SupportedLocale } from './utils-DlXWmDZ-.js';
+import * as class_variance_authority_types from 'class-variance-authority/types';
+import { c as StatusKey } from './i18n-ArS3mqj0.js';
+
+type SocialPlatform = 'instagram' | 'twitter' | 'tiktok' | 'youtube' | 'linkedin' | 'telegram' | 'threads' | 'facebook';
+interface SocialPlatformBadgeProps extends React.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.ForwardRefExoticComponent<SocialPlatformBadgeProps & React.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.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.ForwardRefExoticComponent<BotDetectionMeterProps & React.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.HTMLAttributes<HTMLDivElement> {
+    /** Account handle / display name (e.g., "@news_agency") */
+    handle: React.ReactNode;
+    /** Optional secondary subtitle (e.g., page category) */
+    subtitle?: React.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.ForwardRefExoticComponent<PageCardProps & React.RefAttributes<HTMLDivElement>>;
+
+export { BotDetectionMeter as B, PageCard as P, type SocialPlatform as S, type PageCardContentMix as a, type PageCardProps as b, SocialPlatformBadge as c, type SocialPlatformBadgeProps as d, type BotDetectionKey as e, type BotDetectionData as f, type BotDetectionMeterProps as g, socialPlatformBadgeVariants as s };

package/dist/utils-DlXWmDZ-.d.cts

@@ -0,0 +1,35 @@
+import { ClassValue } from 'clsx';
+
+declare function cn(...inputs: ClassValue[]): string;
+type SupportedLocale = 'fa' | 'ar' | 'en';
+/**
+ * Convert digits in a string to Persian/Arabic numerals based on locale.
+ * @example convertToLocalNumbers('123', 'fa') => '۱۲۳'
+ * @example convertToLocalNumbers('123', 'en') => '123'
+ */
+declare function convertToLocalNumbers(text: string | number, locale: SupportedLocale): string;
+/**
+ * Format large numbers with locale-aware suffixes (K/M/B).
+ * @example formatLargeNumber(1500, 'fa') => '۱.۵ هزار'
+ * @example formatLargeNumber(1500, 'en') => '1.5K'
+ */
+declare function formatLargeNumber(num: number, locale: SupportedLocale): string;
+/**
+ * Format number to Instagram-style short format (English only).
+ * @example formatNumber(123456, 'short') => '123K'
+ * @example formatNumber(123456, 'exact') => '123,456'
+ */
+declare function formatNumber(num: number | undefined, format?: 'exact' | 'short'): string;
+/**
+ * Format date to relative time with absolute on hover (Persian)
+ * @example formatRelativeTime(new Date()) => '۲ ساعت پیش'
+ */
+declare function formatRelativeTime(date: Date | string | number): string;
+/**
+ * Format date to absolute format (Persian / Jalali)
+ * Uses date-fns-jalali for accurate Jalali conversion.
+ * @example formatAbsoluteTime(new Date()) => '۱۵ دی ۱۴۰۳، ۱۵:۳۰'
+ */
+declare function formatAbsoluteTime(date: Date | string | number): string;
+
+export { type SupportedLocale as S, convertToLocalNumbers as a, formatNumber as b, cn as c, formatRelativeTime as d, formatAbsoluteTime as e, formatLargeNumber as f };

package/dist/utils-DlXWmDZ-.d.ts

@@ -0,0 +1,35 @@
+import { ClassValue } from 'clsx';
+
+declare function cn(...inputs: ClassValue[]): string;
+type SupportedLocale = 'fa' | 'ar' | 'en';
+/**
+ * Convert digits in a string to Persian/Arabic numerals based on locale.
+ * @example convertToLocalNumbers('123', 'fa') => '۱۲۳'
+ * @example convertToLocalNumbers('123', 'en') => '123'
+ */
+declare function convertToLocalNumbers(text: string | number, locale: SupportedLocale): string;
+/**
+ * Format large numbers with locale-aware suffixes (K/M/B).
+ * @example formatLargeNumber(1500, 'fa') => '۱.۵ هزار'
+ * @example formatLargeNumber(1500, 'en') => '1.5K'
+ */
+declare function formatLargeNumber(num: number, locale: SupportedLocale): string;
+/**
+ * Format number to Instagram-style short format (English only).
+ * @example formatNumber(123456, 'short') => '123K'
+ * @example formatNumber(123456, 'exact') => '123,456'
+ */
+declare function formatNumber(num: number | undefined, format?: 'exact' | 'short'): string;
+/**
+ * Format date to relative time with absolute on hover (Persian)
+ * @example formatRelativeTime(new Date()) => '۲ ساعت پیش'
+ */
+declare function formatRelativeTime(date: Date | string | number): string;
+/**
+ * Format date to absolute format (Persian / Jalali)
+ * Uses date-fns-jalali for accurate Jalali conversion.
+ * @example formatAbsoluteTime(new Date()) => '۱۵ دی ۱۴۰۳، ۱۵:۳۰'
+ */
+declare function formatAbsoluteTime(date: Date | string | number): string;
+
+export { type SupportedLocale as S, convertToLocalNumbers as a, formatNumber as b, cn as c, formatRelativeTime as d, formatAbsoluteTime as e, formatLargeNumber as f };

package/package.json

@@ -1,7 +1,34 @@
 {
   "name": "@parto-system-design/ui",
-  "version": "1.1.5",
-  "description": "Parto Design System UI components with RTL support",
+  "version": "1.1.8",
+  "description": "Persian-first, RTL-native React component library for public-opinion monitoring (افکارسنجی), social listening, and influencer analytics — Supabase-style design language adapted for Farsi typography.",
+  "license": "MIT",
+  "author": "Parto Design System contributors",
+  "homepage": "https://github.com/DadeNegar-Company/parto-ui#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/DadeNegar-Company/parto-ui.git",
+    "directory": "packages/ui"
+  },
+  "bugs": {
+    "url": "https://github.com/DadeNegar-Company/parto-ui/issues"
+  },
+  "keywords": [
+    "react",
+    "design-system",
+    "ui-components",
+    "rtl",
+    "persian",
+    "farsi",
+    "shadcn",
+    "radix-ui",
+    "tailwindcss",
+    "social-listening",
+    "افکارسنجی",
+    "data-visualization",
+    "recharts",
+    "accessibility"
+  ],
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -12,12 +39,140 @@
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
     },
+    "./button": {
+      "types": "./dist/components/ui/button.d.ts",
+      "import": "./dist/components/ui/button.js",
+      "require": "./dist/components/ui/button.cjs"
+    },
+    "./input": {
+      "types": "./dist/components/ui/input.d.ts",
+      "import": "./dist/components/ui/input.js",
+      "require": "./dist/components/ui/input.cjs"
+    },
+    "./card": {
+      "types": "./dist/components/ui/card.d.ts",
+      "import": "./dist/components/ui/card.js",
+      "require": "./dist/components/ui/card.cjs"
+    },
+    "./badge": {
+      "types": "./dist/components/ui/badge.d.ts",
+      "import": "./dist/components/ui/badge.js",
+      "require": "./dist/components/ui/badge.cjs"
+    },
+    "./avatar": {
+      "types": "./dist/components/ui/avatar.d.ts",
+      "import": "./dist/components/ui/avatar.js",
+      "require": "./dist/components/ui/avatar.cjs"
+    },
+    "./dialog": {
+      "types": "./dist/components/ui/dialog.d.ts",
+      "import": "./dist/components/ui/dialog.js",
+      "require": "./dist/components/ui/dialog.cjs"
+    },
+    "./sheet": {
+      "types": "./dist/components/ui/sheet.d.ts",
+      "import": "./dist/components/ui/sheet.js",
+      "require": "./dist/components/ui/sheet.cjs"
+    },
+    "./popover": {
+      "types": "./dist/components/ui/popover.d.ts",
+      "import": "./dist/components/ui/popover.js",
+      "require": "./dist/components/ui/popover.cjs"
+    },
+    "./tooltip": {
+      "types": "./dist/components/ui/tooltip.d.ts",
+      "import": "./dist/components/ui/tooltip.js",
+      "require": "./dist/components/ui/tooltip.cjs"
+    },
+    "./separator": {
+      "types": "./dist/components/ui/separator.d.ts",
+      "import": "./dist/components/ui/separator.js",
+      "require": "./dist/components/ui/separator.cjs"
+    },
+    "./data-table": {
+      "types": "./dist/components/ui/data-table.d.ts",
+      "import": "./dist/components/ui/data-table.js",
+      "require": "./dist/components/ui/data-table.cjs"
+    },
+    "./calendar": {
+      "types": "./dist/components/ui/calendar.d.ts",
+      "import": "./dist/components/ui/calendar.js",
+      "require": "./dist/components/ui/calendar.cjs"
+    },
+    "./iran-province-heat": {
+      "types": "./dist/components/ui/iran-province-heat.d.ts",
+      "import": "./dist/components/ui/iran-province-heat.js",
+      "require": "./dist/components/ui/iran-province-heat.cjs"
+    },
+    "./sparkline": {
+      "types": "./dist/components/ui/sparkline.d.ts",
+      "import": "./dist/components/ui/sparkline.js",
+      "require": "./dist/components/ui/sparkline.cjs"
+    },
+    "./line-chart": {
+      "types": "./dist/components/charts/PartoLineChart.d.ts",
+      "import": "./dist/components/charts/PartoLineChart.js",
+      "require": "./dist/components/charts/PartoLineChart.cjs"
+    },
+    "./bar-chart": {
+      "types": "./dist/components/charts/PartoBarChart.d.ts",
+      "import": "./dist/components/charts/PartoBarChart.js",
+      "require": "./dist/components/charts/PartoBarChart.cjs"
+    },
+    "./pie-chart": {
+      "types": "./dist/components/charts/PartoPieChart.d.ts",
+      "import": "./dist/components/charts/PartoPieChart.js",
+      "require": "./dist/components/charts/PartoPieChart.cjs"
+    },
+    "./area-chart": {
+      "types": "./dist/components/charts/PartoAreaChart.d.ts",
+      "import": "./dist/components/charts/PartoAreaChart.js",
+      "require": "./dist/components/charts/PartoAreaChart.cjs"
+    },
+    "./concept-card": {
+      "types": "./dist/components/ui/concept-card.d.ts",
+      "import": "./dist/components/ui/concept-card.js",
+      "require": "./dist/components/ui/concept-card.cjs"
+    },
+    "./page-card": {
+      "types": "./dist/components/ui/page-card.d.ts",
+      "import": "./dist/components/ui/page-card.js",
+      "require": "./dist/components/ui/page-card.cjs"
+    },
+    "./alert-rule-card": {
+      "types": "./dist/components/ui/alert-rule-card.d.ts",
+      "import": "./dist/components/ui/alert-rule-card.js",
+      "require": "./dist/components/ui/alert-rule-card.cjs"
+    },
+    "./saved-query-card": {
+      "types": "./dist/components/ui/saved-query-card.d.ts",
+      "import": "./dist/components/ui/saved-query-card.js",
+      "require": "./dist/components/ui/saved-query-card.cjs"
+    },
+    "./filter-provider": {
+      "types": "./dist/components/ui/filter-provider.d.ts",
+      "import": "./dist/components/ui/filter-provider.js",
+      "require": "./dist/components/ui/filter-provider.cjs"
+    },
+    "./hooks/use-hotkeys": {
+      "types": "./dist/hooks/use-hotkeys.d.ts",
+      "import": "./dist/hooks/use-hotkeys.js",
+      "require": "./dist/hooks/use-hotkeys.cjs"
+    },
+    "./hooks/use-hotkey-registry": {
+      "types": "./dist/hooks/use-hotkey-registry.d.ts",
+      "import": "./dist/hooks/use-hotkey-registry.js",
+      "require": "./dist/hooks/use-hotkey-registry.cjs"
+    },
     "./styles.css": "./dist/index.css",
     "./tailwind.config": "./tailwind.config.ts"
   },
   "files": [
     "dist",
-    "tailwind.config.ts"
+    "tailwind.config.ts",
+    "LICENSE",
+    "README.md",
+    "AGENTS.md"
   ],
   "sideEffects": [
     "*.css"
@@ -125,6 +280,7 @@
     "lint:fix": "eslint src/ --fix",
     "typecheck": "tsc --noEmit --skipLibCheck",
     "size": "size-limit",
-    "size:check": "size-limit --limit"
+    "size:check": "size-limit --limit",
+    "size:treeshake-audit": "size-limit --config .size-limit.audit.json"
   }
 }