@umituz/web-design-system 1.5.1 → 1.7.1

package/src/presentation/organisms/Dialog.tsx

@@ -0,0 +1,124 @@
+/**
+ * Dialog Component (Organism)
+ * @description Modal dialog (Shadcn/ui compatible)
+ */
+
+import * as React from 'react';
+import * as DialogPrimitive from '@radix-ui/react-dialog';
+import { X } from 'lucide-react';
+import { cn } from '../../infrastructure/utils';
+
+const Dialog = DialogPrimitive.Root;
+
+const DialogTrigger = DialogPrimitive.Trigger;
+
+const DialogPortal = DialogPrimitive.Portal;
+
+const DialogClose = DialogPrimitive.Close;
+
+const DialogOverlay = React.forwardRef<
+  React.ElementRef<typeof DialogPrimitive.Overlay>,
+  React.ComponentPropsWithoutRef<typeof DialogPrimitive.Overlay>
+>(({ className, ...props }, ref) => (
+  <DialogPrimitive.Overlay
+    ref={ref}
+    className={cn(
+      'fixed inset-0 z-50 bg-black/80  data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0',
+      className
+    )}
+    {...props}
+  />
+));
+DialogOverlay.displayName = DialogPrimitive.Overlay.displayName;
+
+const DialogContent = React.forwardRef<
+  React.ElementRef<typeof DialogPrimitive.Content>,
+  React.ComponentPropsWithoutRef<typeof DialogPrimitive.Content>
+>(({ className, children, ...props }, ref) => (
+  <DialogPortal>
+    <DialogOverlay />
+    <DialogPrimitive.Content
+      ref={ref}
+      className={cn(
+        'fixed left-[50%] top-[50%] z-50 grid w-full max-w-lg translate-x-[-50%] translate-y-[-50%] gap-4 border bg-background p-6 shadow-lg duration-200 data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 data-[state=closed]:slide-out-to-left-1/2 data-[state=closed]:slide-out-to-top-[48%] data-[state=open]:slide-in-from-left-1/2 data-[state=open]:slide-in-from-top-[48%] sm:rounded-lg',
+        className
+      )}
+      {...props}
+    >
+      {children}
+      <DialogPrimitive.Close className="absolute right-4 top-4 rounded-sm opacity-70 ring-offset-background transition-opacity hover:opacity-100 focus:outline-none focus:ring-2 focus:ring-ring focus:ring-offset-2 disabled:pointer-events-none data-[state=open]:bg-accent data-[state=open]:text-muted-foreground">
+        <X className="h-4 w-4" />
+        <span className="sr-only">Close</span>
+      </DialogPrimitive.Close>
+    </DialogPrimitive.Content>
+  </DialogPortal>
+));
+DialogContent.displayName = DialogPrimitive.Content.displayName;
+
+const DialogHeader = ({
+  className,
+  ...props
+}: React.HTMLAttributes<HTMLDivElement>) => (
+  <div
+    className={cn(
+      'flex flex-col space-y-1.5 text-center sm:text-left',
+      className
+    )}
+    {...props}
+  />
+);
+DialogHeader.displayName = 'DialogHeader';
+
+const DialogFooter = ({
+  className,
+  ...props
+}: React.HTMLAttributes<HTMLDivElement>) => (
+  <div
+    className={cn(
+      'flex flex-col-reverse sm:flex-row sm:justify-end sm:space-x-2',
+      className
+    )}
+    {...props}
+  />
+);
+DialogFooter.displayName = 'DialogFooter';
+
+const DialogTitle = React.forwardRef<
+  React.ElementRef<typeof DialogPrimitive.Title>,
+  React.ComponentPropsWithoutRef<typeof DialogPrimitive.Title>
+>(({ className, ...props }, ref) => (
+  <DialogPrimitive.Title
+    ref={ref}
+    className={cn(
+      'text-lg font-semibold leading-none tracking-tight',
+      className
+    )}
+    {...props}
+  />
+));
+DialogTitle.displayName = DialogPrimitive.Title.displayName;
+
+const DialogDescription = React.forwardRef<
+  React.ElementRef<typeof DialogPrimitive.Description>,
+  React.ComponentPropsWithoutRef<typeof DialogPrimitive.Description>
+>(({ className, ...props }, ref) => (
+  <DialogPrimitive.Description
+    ref={ref}
+    className={cn('text-sm text-muted-foreground', className)}
+    {...props}
+  />
+));
+DialogDescription.displayName = DialogPrimitive.Description.displayName;
+
+export {
+  Dialog,
+  DialogPortal,
+  DialogOverlay,
+  DialogClose,
+  DialogTrigger,
+  DialogContent,
+  DialogHeader,
+  DialogFooter,
+  DialogTitle,
+  DialogDescription,
+};

package/src/presentation/organisms/EmptyState.tsx

@@ -0,0 +1,103 @@
+/**
+ * EmptyState Component (Organism)
+ * @description Component for displaying empty states with optional actions
+ */
+
+import { forwardRef } from 'react';
+import { cn } from '../../infrastructure/utils';
+import type { BaseProps, SizeVariant } from '../../domain/types';
+
+export interface EmptyStateProps extends BaseProps {
+  icon?: React.ComponentType<{ className?: string }>;
+  title: string;
+  description?: string;
+  action?: {
+    label: string;
+    onClick: () => void;
+  };
+  size?: Extract<SizeVariant, 'sm' | 'md' | 'lg' | 'xl'>;
+}
+
+const sizeStyles = {
+  sm: 'p-6 gap-3',
+  md: 'p-8 gap-4',
+  lg: 'p-12 gap-5',
+  xl: 'p-16 gap-6',
+};
+
+const iconSizeStyles = {
+  sm: 'h-8 w-8',
+  md: 'h-12 w-12',
+  lg: 'h-16 w-16',
+  xl: 'h-20 w-20',
+};
+
+const titleSizeStyles = {
+  sm: 'text-sm',
+  md: 'text-base',
+  lg: 'text-lg',
+  xl: 'text-xl',
+};
+
+const descriptionSizeStyles = {
+  sm: 'text-xs',
+  md: 'text-sm',
+  lg: 'text-base',
+  xl: 'text-lg',
+};
+
+export const EmptyState = forwardRef<HTMLDivElement, EmptyStateProps>(
+  (
+    {
+      className,
+      icon: Icon,
+      title,
+      description,
+      action,
+      size = 'md',
+      ...props
+    },
+    ref
+  ) => {
+    return (
+      <div
+        ref={ref}
+        className={cn(
+          'flex flex-col items-center justify-center text-center',
+          sizeStyles[size],
+          className
+        )}
+        {...props}
+      >
+        {Icon && (
+          <Icon className={cn(iconSizeStyles[size], 'text-muted-foreground/50 mx-auto mb-2')} />
+        )}
+        <h3 className={cn('font-semibold text-foreground', titleSizeStyles[size])}>{title}</h3>
+        {description && (
+          <p className={cn('text-muted-foreground max-w-md', descriptionSizeStyles[size])}>
+            {description}
+          </p>
+        )}
+        {action && (
+          <button
+            onClick={action.onClick}
+            className={cn(
+              'mt-4 inline-flex items-center justify-center',
+              'rounded-md font-medium',
+              'bg-primary text-primary-foreground',
+              'hover:bg-primary/90',
+              'focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring',
+              'disabled:pointer-events-none disabled:opacity-50',
+              'h-9 px-4 text-sm',
+              'transition-colors'
+            )}
+          >
+            {action.label}
+          </button>
+        )}
+      </div>
+    );
+  }
+);
+
+EmptyState.displayName = 'EmptyState';

package/src/presentation/organisms/FormModal.tsx

@@ -0,0 +1,126 @@
+/**
+ * FormModal Component (Template)
+ * @description Pre-configured modal with form wrapper and loading state
+ * Reduces boilerplate in modal components like CampaignModal, ProjectListModal
+ */
+
+import { forwardRef, type ComponentType, type ReactNode } from 'react';
+import { cn } from '../../infrastructure/utils';
+import {
+  Dialog,
+  DialogContent,
+  DialogDescription,
+  DialogFooter,
+  DialogHeader,
+  DialogTitle,
+} from './Dialog';
+import { Button } from '../atoms';
+import { Loader2 } from 'lucide-react';
+import type { BaseProps } from '../../domain/types';
+
+export interface FormModalProps extends BaseProps {
+  open: boolean;
+  onOpenChange: (open: boolean) => void;
+  title: string;
+  description?: string;
+  children: ReactNode;
+  onSubmit?: (e: React.FormEvent) => void | Promise<void>;
+  loading?: boolean;
+  submitText?: string;
+  cancelText?: string;
+  showFooter?: boolean;
+  footer?: ReactNode;
+  size?: 'sm' | 'md' | 'lg' | 'xl' | 'full';
+  preventCloseOnSubmit?: boolean;
+}
+
+const sizeStyles = {
+  sm: 'sm:max-w-[400px]',
+  md: 'sm:max-w-[425px]',
+  lg: 'sm:max-w-[600px]',
+  xl: 'sm:max-w-[800px]',
+  full: 'sm:max-w-[95vw]',
+};
+
+export const FormModal = forwardRef<HTMLDivElement, FormModalProps>(
+  (
+    {
+      className,
+      open,
+      onOpenChange,
+      title,
+      description,
+      children,
+      onSubmit,
+      loading = false,
+      submitText = 'Submit',
+      cancelText = 'Cancel',
+      showFooter = true,
+      footer,
+      size = 'md',
+      preventCloseOnSubmit = false,
+      ...props
+    },
+    ref
+  ) => {
+    const handleSubmit = async (e: React.FormEvent) => {
+      e.preventDefault();
+      if (onSubmit && !loading) {
+        await onSubmit(e);
+        if (!preventCloseOnSubmit) {
+          onOpenChange(false);
+        }
+      }
+    };
+
+    return (
+      <Dialog open={open} onOpenChange={onOpenChange}>
+        <DialogContent className={cn(sizeStyles[size], className)} ref={ref} {...props}>
+          {onSubmit ? (
+            <form onSubmit={handleSubmit}>
+              <DialogHeader>
+                <DialogTitle>{title}</DialogTitle>
+                {description && <DialogDescription>{description}</DialogDescription>}
+              </DialogHeader>
+              <div className="grid gap-4 py-4">{children}</div>
+              {showFooter && (
+                <DialogFooter>
+                  {footer || (
+                    <>
+                      <Button type="button" variant="outline" onClick={() => onOpenChange(false)} disabled={loading}>
+                        {cancelText}
+                      </Button>
+                      <Button type="submit" disabled={loading}>
+                        {loading && <Loader2 className="mr-2 h-4 w-4 animate-spin" />}
+                        {submitText}
+                      </Button>
+                    </>
+                  )}
+                </DialogFooter>
+              )}
+            </form>
+          ) : (
+            <>
+              <DialogHeader>
+                <DialogTitle>{title}</DialogTitle>
+                {description && <DialogDescription>{description}</DialogDescription>}
+              </DialogHeader>
+              <div className="grid gap-4 py-4">{children}</div>
+              {showFooter && (
+                <DialogFooter>
+                  {footer || (
+                    <Button variant="outline" onClick={() => onOpenChange(false)} disabled={loading}>
+                      {cancelText}
+                    </Button>
+                  )}
+                </DialogFooter>
+              )}
+            </>
+          )}
+        </DialogContent>
+      </Dialog>
+    );
+  }
+);
+
+FormModal.displayName = 'FormModal';

package/src/presentation/organisms/HoverCard.tsx

@@ -0,0 +1,31 @@
+/**
+ * HoverCard Component (Organism)
+ * @description Hover-triggered card (Shadcn/ui compatible)
+ */
+
+import * as React from 'react';
+import * as HoverCardPrimitive from '@radix-ui/react-hover-card';
+import { cn } from '../../infrastructure/utils';
+
+const HoverCard = HoverCardPrimitive.Root;
+
+const HoverCardTrigger = HoverCardPrimitive.Trigger;
+
+const HoverCardContent = React.forwardRef<
+  React.ElementRef<typeof HoverCardPrimitive.Content>,
+  React.ComponentPropsWithoutRef<typeof HoverCardPrimitive.Content>
+>(({ className, align = 'center', sideOffset = 4, ...props }, ref) => (
+  <HoverCardPrimitive.Content
+    ref={ref}
+    align={align}
+    sideOffset={sideOffset}
+    className={cn(
+      'z-50 w-64 rounded-md border bg-popover p-4 text-popover-foreground shadow-md outline-none data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2',
+      className
+    )}
+    {...props}
+  />
+));
+HoverCardContent.displayName = HoverCardPrimitive.Content.displayName;
+
+export { HoverCard, HoverCardTrigger, HoverCardContent };

package/src/presentation/organisms/LoadingState.tsx

@@ -0,0 +1,87 @@
+/**
+ * LoadingState Component (Organism)
+ * @description Component for displaying loading states
+ */
+
+import { forwardRef } from 'react';
+import { cn } from '../../infrastructure/utils';
+import { Spinner } from '../atoms/Spinner';
+import type { BaseProps, SizeVariant } from '../../domain/types';
+
+export interface LoadingStateProps extends BaseProps {
+  message?: string;
+  size?: Extract<SizeVariant, 'sm' | 'md' | 'lg'>;
+  variant?: 'spinner' | 'skeleton' | 'dots';
+}
+
+const sizeStyles = {
+  sm: 'gap-3',
+  md: 'gap-4',
+  lg: 'gap-5',
+};
+
+const spinnerSizeStyles = {
+  sm: 'sm' as const,
+  md: 'md' as const,
+  lg: 'lg' as const,
+};
+
+const messageSizeStyles = {
+  sm: 'text-xs',
+  md: 'text-sm',
+  lg: 'text-base',
+};
+
+export const LoadingState = forwardRef<HTMLDivElement, LoadingStateProps>(
+  (
+    {
+      className,
+      message,
+      size = 'md',
+      variant = 'spinner',
+      ...props
+    },
+    ref
+  ) => {
+    return (
+      <div
+        ref={ref}
+        className={cn(
+          'flex flex-col items-center justify-center p-8',
+          sizeStyles[size],
+          className
+        )}
+        {...props}
+      >
+        {variant === 'spinner' && <Spinner size={spinnerSizeStyles[size]} />}
+        {variant === 'dots' && (
+          <div className="flex gap-1">
+            {[0, 1, 2].map((i) => (
+              <div
+                key={i}
+                className={cn(
+                  'w-2 h-2 bg-primary rounded-full animate-bounce',
+                  size === 'sm' && 'w-1.5 h-1.5',
+                  size === 'lg' && 'w-3 h-3'
+                )}
+                style={{ animationDelay: `${i * 0.15}s` }}
+              />
+            ))}
+          </div>
+        )}
+        {variant === 'skeleton' && (
+          <div className="w-full space-y-3">
+            <div className="h-4 bg-muted animate-pulse rounded" style={{ width: '40%' }} />
+            <div className="h-3 bg-muted animate-pulse rounded" style={{ width: '70%' }} />
+            <div className="h-3 bg-muted animate-pulse rounded" style={{ width: '60%' }} />
+          </div>
+        )}
+        {message && variant !== 'skeleton' && (
+          <p className={cn('text-muted-foreground mt-2', messageSizeStyles[size])}>{message}</p>
+        )}
+      </div>
+    );
+  }
+);
+
+LoadingState.displayName = 'LoadingState';

package/src/presentation/organisms/MetricCard.tsx

@@ -0,0 +1,126 @@
+/**
+ * MetricCard Component (Organism)
+ * @description Card component for displaying metrics and statistics with trend indicators
+ */
+
+import { forwardRef, type ComponentProps } from 'react';
+import { cn } from '../../infrastructure/utils';
+import { Card, CardContent } from './Card';
+import type { BaseProps, ColorVariant, SizeVariant } from '../../domain/types';
+
+export interface MetricCardProps extends BaseProps {
+  title: string;
+  value: string | number;
+  icon?: React.ComponentType<{ className?: string }>;
+  iconColor?: string;
+  trend?: {
+    value: number;
+    label?: string;
+  };
+  size?: Extract<SizeVariant, 'sm' | 'md' | 'lg'>;
+  variant?: ColorVariant;
+  trendValueFormatter?: (value: number) => string;
+  onClick?: () => void;
+}
+
+const sizeStyles = {
+  sm: 'p-3',
+  md: 'p-4',
+  lg: 'p-5',
+};
+
+const valueSizeStyles = {
+  sm: 'text-lg',
+  md: 'text-2xl',
+  lg: 'text-3xl',
+};
+
+const iconSizeStyles = {
+  sm: 'h-4 w-4',
+  md: 'h-8 w-8',
+  lg: 'h-10 w-10',
+};
+
+const labelSizeStyles = {
+  sm: 'text-xs',
+  md: 'text-sm',
+  lg: 'text-base',
+};
+
+const trendColors: Record<ColorVariant, { positive: string; negative: string; bg: string }> = {
+  primary: { positive: 'text-primary', negative: 'text-destructive', bg: 'bg-primary' },
+  secondary: { positive: 'text-secondary', negative: 'text-destructive', bg: 'bg-secondary' },
+  success: { positive: 'text-success', negative: 'text-destructive', bg: 'bg-success' },
+  warning: { positive: 'text-warning', negative: 'text-destructive', bg: 'bg-warning' },
+  destructive: { positive: 'text-destructive', negative: 'text-success', bg: 'bg-destructive' },
+};
+
+export const MetricCard = forwardRef<HTMLDivElement, MetricCardProps>(
+  (
+    {
+      className,
+      title,
+      value,
+      icon: Icon,
+      iconColor = 'text-primary',
+      trend,
+      size = 'md',
+      variant = 'primary',
+      trendValueFormatter = (v) => `${v > 0 ? '+' : ''}${v}%`,
+      onClick,
+      ...props
+    },
+    ref
+  ) => {
+    const isPositive = trend?.value !== undefined && trend.value >= 0;
+    const TrendIcon = isPositive ? '↑' : '↓';
+    const colors = trendColors[variant];
+
+    return (
+      <Card
+        ref={ref}
+        className={cn(
+          'transition-all duration-200',
+          onClick && 'cursor-pointer hover:shadow-md hover:border-primary/50',
+          className
+        )}
+        onClick={onClick}
+        {...props}
+      >
+        <CardContent className={cn(sizeStyles[size])}>
+          <div className="flex items-center justify-between">
+            <div className="flex-1">
+              <p className={cn('text-muted-foreground font-medium', labelSizeStyles[size])}>{title}</p>
+              <p className={cn('font-bold text-foreground', valueSizeStyles[size])}>
+                {typeof value === 'number' ? value.toLocaleString() : value}
+              </p>
+              {trend && (
+                <div className="flex items-center gap-1 mt-1">
+                  <span
+                    className={cn(
+                      'text-xs font-medium',
+                      isPositive ? colors.positive : colors.negative
+                    )}
+                  >
+                    {TrendIcon}
+                  </span>
+                  <p className={cn('text-xs', isPositive ? colors.positive : colors.negative)}>
+                    {trendValueFormatter(trend.value)}
+                  </p>
+                  {trend.label && (
+                    <p className="text-xs text-muted-foreground ml-1">{trend.label}</p>
+                  )}
+                </div>
+              )}
+            </div>
+            {Icon && (
+              <Icon className={cn(iconSizeStyles[size], iconColor, 'flex-shrink-0')} />
+            )}
+          </div>
+        </CardContent>
+      </Card>
+    );
+  }
+);
+
+MetricCard.displayName = 'MetricCard';

package/src/presentation/organisms/Popover.tsx

@@ -0,0 +1,33 @@
+/**
+ * Popover Component (Organism)
+ * @description Popover dialog (Shadcn/ui compatible)
+ */
+
+import * as React from 'react';
+import * as PopoverPrimitive from '@radix-ui/react-popover';
+import { cn } from '../../infrastructure/utils';
+
+const Popover = PopoverPrimitive.Root;
+
+const PopoverTrigger = PopoverPrimitive.Trigger;
+
+const PopoverContent = React.forwardRef<
+  React.ElementRef<typeof PopoverPrimitive.Content>,
+  React.ComponentPropsWithoutRef<typeof PopoverPrimitive.Content>
+>(({ className, align = 'center', sideOffset = 4, ...props }, ref) => (
+  <PopoverPrimitive.Portal>
+    <PopoverPrimitive.Content
+      ref={ref}
+      align={align}
+      sideOffset={sideOffset}
+      className={cn(
+        'z-50 w-72 rounded-md border bg-popover p-4 text-popover-foreground shadow-md outline-none data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2',
+        className
+      )}
+      {...props}
+    />
+  </PopoverPrimitive.Portal>
+));
+PopoverContent.displayName = PopoverPrimitive.Content.displayName;
+
+export { Popover, PopoverTrigger, PopoverContent };