@wakastellar/ui 3.2.0 → 3.3.2

package/src/components/waka-credit-activity-feed/index.tsx

@@ -0,0 +1,364 @@
+"use client"
+
+import * as React from "react"
+import { cn } from "../../utils/cn"
+import {
+  ArrowDownLeft,
+  ArrowUpRight,
+  RotateCcw,
+  Gift,
+  Clock,
+  ChevronDown,
+  Inbox,
+} from "lucide-react"
+import { Button } from "../button"
+import type {
+  CreditTransaction,
+  CreditTransactionType,
+} from "../waka-credit-balance/types"
+
+// ============================================================================
+// Types
+// ============================================================================
+
+export interface WakaCreditActivityFeedProps {
+  /** List of credit transactions to display */
+  activities: CreditTransaction[]
+  /** Maximum number of items to display */
+  maxItems?: number
+  /** Show "Load more" button at bottom */
+  showLoadMore?: boolean
+  /** Callback when "Load more" is clicked */
+  onLoadMore?: () => void
+  /** Show loading skeleton state */
+  loading?: boolean
+  /** Message to display when activity list is empty */
+  emptyMessage?: string
+  /** Enable staggered fade-in animation for items */
+  animated?: boolean
+  /** Additional CSS classes */
+  className?: string
+}
+
+// ============================================================================
+// Transaction Type Configuration
+// ============================================================================
+
+const transactionTypeConfig: Record<
+  CreditTransactionType,
+  {
+    icon: React.ElementType
+    color: string
+    bgColor: string
+    dotColor: string
+    amountColor: string
+    amountPrefix: string
+    label: string
+  }
+> = {
+  debit: {
+    icon: ArrowDownLeft,
+    color: "text-red-600 dark:text-red-400",
+    bgColor: "bg-red-100 dark:bg-red-900/30",
+    dotColor: "bg-red-500",
+    amountColor: "text-red-600 dark:text-red-400",
+    amountPrefix: "-",
+    label: "Debit",
+  },
+  credit: {
+    icon: ArrowUpRight,
+    color: "text-green-600 dark:text-green-400",
+    bgColor: "bg-green-100 dark:bg-green-900/30",
+    dotColor: "bg-green-500",
+    amountColor: "text-green-600 dark:text-green-400",
+    amountPrefix: "+",
+    label: "Credit",
+  },
+  refund: {
+    icon: RotateCcw,
+    color: "text-blue-600 dark:text-blue-400",
+    bgColor: "bg-blue-100 dark:bg-blue-900/30",
+    dotColor: "bg-blue-500",
+    amountColor: "text-blue-600 dark:text-blue-400",
+    amountPrefix: "+",
+    label: "Refund",
+  },
+  bonus: {
+    icon: Gift,
+    color: "text-purple-600 dark:text-purple-400",
+    bgColor: "bg-purple-100 dark:bg-purple-900/30",
+    dotColor: "bg-purple-500",
+    amountColor: "text-purple-600 dark:text-purple-400",
+    amountPrefix: "+",
+    label: "Bonus",
+  },
+  expiry: {
+    icon: Clock,
+    color: "text-gray-500 dark:text-gray-400",
+    bgColor: "bg-gray-100 dark:bg-gray-800/30",
+    dotColor: "bg-gray-400",
+    amountColor: "text-gray-500 dark:text-gray-400",
+    amountPrefix: "-",
+    label: "Expired",
+  },
+}
+
+// ============================================================================
+// Helpers
+// ============================================================================
+
+function formatRelativeTime(date: Date): string {
+  const now = new Date()
+  const diffInSeconds = Math.floor((now.getTime() - date.getTime()) / 1000)
+
+  if (diffInSeconds < 60) {
+    return "just now"
+  }
+
+  const diffInMinutes = Math.floor(diffInSeconds / 60)
+  if (diffInMinutes < 60) {
+    return `${diffInMinutes} min ago`
+  }
+
+  const diffInHours = Math.floor(diffInMinutes / 60)
+  if (diffInHours < 24) {
+    return `${diffInHours}h ago`
+  }
+
+  const diffInDays = Math.floor(diffInHours / 24)
+  if (diffInDays === 1) {
+    return "yesterday"
+  }
+  if (diffInDays < 7) {
+    return `${diffInDays} days ago`
+  }
+
+  const diffInWeeks = Math.floor(diffInDays / 7)
+  if (diffInWeeks < 4) {
+    return `${diffInWeeks}w ago`
+  }
+
+  const diffInMonths = Math.floor(diffInDays / 30)
+  if (diffInMonths < 12) {
+    return `${diffInMonths}mo ago`
+  }
+
+  const diffInYears = Math.floor(diffInDays / 365)
+  return `${diffInYears}y ago`
+}
+
+function formatAmount(amount: number, prefix: string): string {
+  return `${prefix}${amount.toLocaleString("en-US")}`
+}
+
+// ============================================================================
+// Skeleton Item
+// ============================================================================
+
+function ActivitySkeleton() {
+  return (
+    <div className="flex gap-3 py-3">
+      {/* Timeline dot placeholder */}
+      <div className="flex flex-col items-center flex-shrink-0">
+        <div className="h-8 w-8 rounded-full bg-muted animate-pulse" />
+      </div>
+      {/* Content placeholder */}
+      <div className="flex-1 min-w-0 space-y-2">
+        <div className="h-4 w-3/4 bg-muted rounded animate-pulse" />
+        <div className="h-3 w-1/3 bg-muted rounded animate-pulse" />
+      </div>
+      {/* Amount placeholder */}
+      <div className="flex flex-col items-end flex-shrink-0 space-y-2">
+        <div className="h-4 w-16 bg-muted rounded animate-pulse" />
+        <div className="h-3 w-12 bg-muted rounded animate-pulse" />
+      </div>
+    </div>
+  )
+}
+
+// ============================================================================
+// Activity Item
+// ============================================================================
+
+interface ActivityItemProps {
+  activity: CreditTransaction
+  isLast: boolean
+  animated: boolean
+  index: number
+}
+
+function ActivityItem({ activity, isLast, animated, index }: ActivityItemProps) {
+  const config = transactionTypeConfig[activity.type]
+  const Icon = config.icon
+  const timestamp = new Date(activity.timestamp)
+
+  return (
+    <div
+      className={cn(
+        "relative flex gap-3 py-3",
+        animated && "animate-feed-item-in",
+      )}
+      style={
+        animated
+          ? ({ "--stagger-delay": `${index * 80}ms` } as React.CSSProperties)
+          : undefined
+      }
+    >
+      {/* Timeline column: icon + connecting line */}
+      <div className="flex flex-col items-center flex-shrink-0">
+        <div
+          className={cn(
+            "flex h-8 w-8 items-center justify-center rounded-full flex-shrink-0",
+            config.bgColor,
+          )}
+        >
+          <Icon className={cn("h-4 w-4", config.color)} />
+        </div>
+        {!isLast && (
+          <div className="w-px flex-1 bg-border mt-1 min-h-[16px]" />
+        )}
+      </div>
+
+      {/* Content */}
+      <div className="flex-1 min-w-0 pt-1">
+        <p className="text-sm font-medium text-foreground leading-tight truncate">
+          {activity.description}
+        </p>
+        {activity.service && (
+          <p className="text-xs text-muted-foreground mt-0.5 truncate">
+            {activity.service}
+          </p>
+        )}
+      </div>
+
+      {/* Amount + Time */}
+      <div className="flex flex-col items-end flex-shrink-0 pt-1">
+        <span
+          className={cn(
+            "text-sm font-semibold tabular-nums",
+            config.amountColor,
+          )}
+        >
+          {formatAmount(activity.amount, config.amountPrefix)}
+        </span>
+        <span className="text-xs text-muted-foreground mt-0.5">
+          {formatRelativeTime(timestamp)}
+        </span>
+      </div>
+    </div>
+  )
+}
+
+// ============================================================================
+// Empty State
+// ============================================================================
+
+interface EmptyStateProps {
+  message: string
+}
+
+function EmptyState({ message }: EmptyStateProps) {
+  return (
+    <div className="flex flex-col items-center justify-center py-12 text-center">
+      <Inbox className="h-12 w-12 text-muted-foreground/50 mb-4" />
+      <p className="text-sm text-muted-foreground">{message}</p>
+    </div>
+  )
+}
+
+// ============================================================================
+// Main Component
+// ============================================================================
+
+export function WakaCreditActivityFeed({
+  activities,
+  maxItems,
+  showLoadMore = false,
+  onLoadMore,
+  loading = false,
+  emptyMessage = "No recent activity",
+  animated = false,
+  className,
+}: WakaCreditActivityFeedProps) {
+  const displayActivities = React.useMemo(() => {
+    if (maxItems && maxItems > 0) {
+      return activities.slice(0, maxItems)
+    }
+    return activities
+  }, [activities, maxItems])
+
+  // Loading state
+  if (loading) {
+    return (
+      <div className={cn("divide-y divide-transparent", className)}>
+        {Array.from({ length: 4 }).map((_, i) => (
+          <ActivitySkeleton key={i} />
+        ))}
+      </div>
+    )
+  }
+
+  // Empty state
+  if (displayActivities.length === 0) {
+    return (
+      <div className={className}>
+        <EmptyState message={emptyMessage} />
+      </div>
+    )
+  }
+
+  return (
+    <div className={cn("relative", className)}>
+      {/* Activity list */}
+      <div>
+        {displayActivities.map((activity, index) => (
+          <ActivityItem
+            key={activity.id}
+            activity={activity}
+            isLast={index === displayActivities.length - 1}
+            animated={animated}
+            index={index}
+          />
+        ))}
+      </div>
+
+      {/* Load More */}
+      {showLoadMore && onLoadMore && (
+        <div className="flex justify-center pt-2">
+          <Button
+            variant="outline"
+            size="sm"
+            onClick={onLoadMore}
+            className="gap-2"
+          >
+            <ChevronDown className="h-4 w-4" />
+            Load more
+          </Button>
+        </div>
+      )}
+
+      {/* Animation styles */}
+      {animated && (
+        <style>{`
+          @keyframes feed-item-in {
+            0% {
+              opacity: 0;
+              transform: translateY(8px);
+            }
+            100% {
+              opacity: 1;
+              transform: translateY(0);
+            }
+          }
+          .animate-feed-item-in {
+            opacity: 0;
+            animation: feed-item-in 0.35s ease-out forwards;
+            animation-delay: var(--stagger-delay, 0ms);
+          }
+        `}</style>
+      )}
+    </div>
+  )
+}
+
+export default WakaCreditActivityFeed

package/src/components/waka-credit-alert/WakaCreditAlert.stories.tsx

@@ -0,0 +1,170 @@
+import type { Meta, StoryObj } from '@storybook/react'
+import { WakaCreditAlert } from './index'
+import * as React from 'react'
+
+const meta: Meta<typeof WakaCreditAlert> = {
+  title: 'Components/Credit/WakaCreditAlert',
+  component: WakaCreditAlert,
+  parameters: {
+    layout: 'centered',
+    docs: {
+      description: {
+        component:
+          'Alert banner for credit thresholds. Displays contextual messages with 4 severity levels: info, warning, critical, and depleted.',
+      },
+    },
+  },
+  tags: ['autodocs'],
+  argTypes: {
+    level: {
+      control: 'select',
+      options: ['info', 'warning', 'critical', 'depleted'],
+      description: 'Alert severity level',
+    },
+    balance: {
+      control: { type: 'number', min: 0, max: 10000 },
+      description: 'Current credit balance',
+    },
+    threshold: {
+      control: { type: 'number', min: 0, max: 10000 },
+      description: 'Threshold that triggered the alert',
+    },
+    message: {
+      control: 'text',
+      description: 'Custom message (overrides default)',
+    },
+    topUpLabel: {
+      control: 'text',
+      description: 'Label for the top-up button',
+    },
+    dismissable: {
+      control: 'boolean',
+      description: 'Whether the alert can be dismissed',
+    },
+  },
+}
+
+export default meta
+type Story = StoryObj<typeof WakaCreditAlert>
+
+export const Info: Story = {
+  args: {
+    level: 'info',
+    balance: 500,
+  },
+}
+
+export const Warning: Story = {
+  args: {
+    level: 'warning',
+    balance: 85,
+    threshold: 100,
+  },
+}
+
+export const Critical: Story = {
+  args: {
+    level: 'critical',
+    balance: 12,
+    threshold: 20,
+  },
+}
+
+export const Depleted: Story = {
+  args: {
+    level: 'depleted',
+    balance: 0,
+  },
+}
+
+export const WithTopUp: Story = {
+  render: () => (
+    <div className="space-y-4 w-[500px]">
+      <WakaCreditAlert
+        level="info"
+        balance={500}
+        onTopUp={() => alert('Top up clicked')}
+      />
+      <WakaCreditAlert
+        level="warning"
+        balance={85}
+        threshold={100}
+        onTopUp={() => alert('Top up clicked')}
+      />
+      <WakaCreditAlert
+        level="critical"
+        balance={12}
+        threshold={20}
+        onTopUp={() => alert('Top up clicked')}
+        topUpLabel="Recharge Now"
+      />
+      <WakaCreditAlert
+        level="depleted"
+        balance={0}
+        onTopUp={() => alert('Top up clicked')}
+        topUpLabel="Buy Credits"
+      />
+    </div>
+  ),
+}
+
+export const Dismissable: Story = {
+  render: function DismissableStory() {
+    const [visibleAlerts, setVisibleAlerts] = React.useState({
+      info: true,
+      warning: true,
+      critical: true,
+      depleted: true,
+    })
+
+    const resetAll = () =>
+      setVisibleAlerts({ info: true, warning: true, critical: true, depleted: true })
+
+    return (
+      <div className="space-y-4 w-[500px]">
+        {visibleAlerts.info && (
+          <WakaCreditAlert
+            level="info"
+            balance={500}
+            dismissable
+            onDismiss={() => setVisibleAlerts((v) => ({ ...v, info: false }))}
+          />
+        )}
+        {visibleAlerts.warning && (
+          <WakaCreditAlert
+            level="warning"
+            balance={85}
+            threshold={100}
+            dismissable
+            onDismiss={() => setVisibleAlerts((v) => ({ ...v, warning: false }))}
+          />
+        )}
+        {visibleAlerts.critical && (
+          <WakaCreditAlert
+            level="critical"
+            balance={12}
+            threshold={20}
+            dismissable
+            onDismiss={() => setVisibleAlerts((v) => ({ ...v, critical: false }))}
+          />
+        )}
+        {visibleAlerts.depleted && (
+          <WakaCreditAlert
+            level="depleted"
+            balance={0}
+            dismissable
+            onDismiss={() => setVisibleAlerts((v) => ({ ...v, depleted: false }))}
+          />
+        )}
+        {Object.values(visibleAlerts).some((v) => !v) && (
+          <button
+            className="px-3 py-1.5 text-sm rounded-md border bg-card hover:bg-muted transition-colors"
+            onClick={resetAll}
+          >
+            Reset All
+          </button>
+        )}
+      </div>
+    )
+  },
+}

package/src/components/waka-credit-alert/index.tsx

@@ -0,0 +1,179 @@
+"use client"
+
+import * as React from "react"
+import { cn } from "../../utils/cn"
+import { Info, AlertTriangle, AlertCircle, XCircle, X } from "lucide-react"
+import type { CreditAlertLevel } from "../waka-credit-balance/types"
+
+// ============================================================================
+// Types
+// ============================================================================
+
+export type { CreditAlertLevel } from "../waka-credit-balance/types"
+
+export interface WakaCreditAlertProps {
+  /** Alert severity level */
+  level: CreditAlertLevel
+  /** Current credit balance */
+  balance: number
+  /** Threshold value that triggered the alert */
+  threshold?: number
+  /** Custom message (overrides default) */
+  message?: string
+  /** Callback when dismissing the alert */
+  onDismiss?: () => void
+  /** Callback when clicking the top-up action */
+  onTopUp?: () => void
+  /** Label for the top-up button */
+  topUpLabel?: string
+  /** Whether the alert can be dismissed */
+  dismissable?: boolean
+  /** Additional CSS classes */
+  className?: string
+}
+
+// ============================================================================
+// Config
+// ============================================================================
+
+const LEVEL_CONFIG: Record<
+  CreditAlertLevel,
+  {
+    icon: React.ElementType
+    bg: string
+    border: string
+    text: string
+    iconColor: string
+    buttonBg: string
+    buttonHover: string
+    dismissColor: string
+  }
+> = {
+  info: {
+    icon: Info,
+    bg: "bg-blue-50 dark:bg-blue-950/40",
+    border: "border-blue-200 dark:border-blue-800",
+    text: "text-blue-900 dark:text-blue-100",
+    iconColor: "text-blue-500 dark:text-blue-400",
+    buttonBg: "bg-blue-600 hover:bg-blue-700 text-white",
+    buttonHover: "hover:bg-blue-700",
+    dismissColor: "text-blue-500 hover:text-blue-700 dark:text-blue-400 dark:hover:text-blue-200",
+  },
+  warning: {
+    icon: AlertTriangle,
+    bg: "bg-amber-50 dark:bg-amber-950/40",
+    border: "border-amber-200 dark:border-amber-800",
+    text: "text-amber-900 dark:text-amber-100",
+    iconColor: "text-amber-500 dark:text-amber-400",
+    buttonBg: "bg-amber-600 hover:bg-amber-700 text-white",
+    buttonHover: "hover:bg-amber-700",
+    dismissColor: "text-amber-500 hover:text-amber-700 dark:text-amber-400 dark:hover:text-amber-200",
+  },
+  critical: {
+    icon: AlertCircle,
+    bg: "bg-red-50 dark:bg-red-950/40",
+    border: "border-red-200 dark:border-red-800",
+    text: "text-red-900 dark:text-red-100",
+    iconColor: "text-red-500 dark:text-red-400",
+    buttonBg: "bg-red-600 hover:bg-red-700 text-white",
+    buttonHover: "hover:bg-red-700",
+    dismissColor: "text-red-500 hover:text-red-700 dark:text-red-400 dark:hover:text-red-200",
+  },
+  depleted: {
+    icon: XCircle,
+    bg: "bg-red-100 dark:bg-red-950/60",
+    border: "border-red-300 dark:border-red-700",
+    text: "text-red-950 dark:text-red-50",
+    iconColor: "text-red-700 dark:text-red-300",
+    buttonBg: "bg-red-800 hover:bg-red-900 text-white",
+    buttonHover: "hover:bg-red-900",
+    dismissColor: "text-red-600 hover:text-red-800 dark:text-red-300 dark:hover:text-red-100",
+  },
+}
+
+const DEFAULT_MESSAGES: Record<CreditAlertLevel, (balance: number) => string> = {
+  info: (balance) => `Your credit balance is ${balance.toLocaleString()} credits.`,
+  warning: (balance) => `Low balance! You have ${balance.toLocaleString()} credits remaining.`,
+  critical: (balance) => `Critical! Only ${balance.toLocaleString()} credits left. Recharge now.`,
+  depleted: () => "No credits remaining. Services may be interrupted.",
+}
+
+// ============================================================================
+// Component
+// ============================================================================
+
+export function WakaCreditAlert({
+  level,
+  balance,
+  threshold,
+  message,
+  onDismiss,
+  onTopUp,
+  topUpLabel = "Top Up",
+  dismissable = false,
+  className,
+}: WakaCreditAlertProps) {
+  const config = LEVEL_CONFIG[level]
+  const Icon = config.icon
+  const displayMessage = message ?? DEFAULT_MESSAGES[level](balance)
+
+  return (
+    <div
+      role="alert"
+      className={cn(
+        "relative flex items-start gap-3 rounded-lg border px-4 py-3",
+        config.bg,
+        config.border,
+        config.text,
+        className
+      )}
+    >
+      <Icon
+        className={cn("h-5 w-5 mt-0.5 shrink-0", config.iconColor)}
+        aria-hidden="true"
+      />
+
+      <div className="flex-1 min-w-0">
+        <p className="text-sm font-medium leading-relaxed">
+          {displayMessage}
+        </p>
+        {threshold !== undefined && (
+          <p className="text-xs mt-1 opacity-75">
+            Threshold: {threshold.toLocaleString()} credits
+          </p>
+        )}
+      </div>
+
+      <div className="flex items-center gap-2 shrink-0">
+        {onTopUp && (
+          <button
+            type="button"
+            onClick={onTopUp}
+            className={cn(
+              "inline-flex items-center rounded-md px-3 py-1.5 text-xs font-semibold transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring",
+              config.buttonBg
+            )}
+          >
+            {topUpLabel}
+          </button>
+        )}
+
+        {dismissable && onDismiss && (
+          <button
+            type="button"
+            onClick={onDismiss}
+            className={cn(
+              "inline-flex items-center justify-center rounded-md p-1 transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring",
+              config.dismissColor
+            )}
+            aria-label="Dismiss alert"
+          >
+            <X className="h-4 w-4" />
+          </button>
+        )}
+      </div>
+    </div>
+  )
+}
+
+export default WakaCreditAlert