@xyhp915/slack-base-ui 0.0.1 → 0.0.2

package/package.json

@@ -2,7 +2,7 @@
   "name": "@xyhp915/slack-base-ui",
   "main": "libs/index.js",
   "types": "libs/index.d.ts",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "type": "module",
   "scripts": {
     "dev": "vite",

package/src/App.css

@@ -0,0 +1,7 @@
+/* Cleared for Slack clone custom styles */
+#root {
+  width: 100%;
+  height: 100vh;
+  display: flex;
+  flex-direction: column;
+}

package/src/App.tsx

@@ -0,0 +1,18 @@
+import { BrowserRouter as Router, Routes, Route } from 'react-router-dom';
+import { Dashboard } from './pages/Dashboard';
+import { ComponentShowcase } from './pages/ComponentShowcase';
+import SlackApp from './examples/slack-clone/SlackApp';
+
+function App() {
+    return (
+        <Router>
+            <Routes>
+                <Route path="/" element={<Dashboard />} />
+                <Route path="/components" element={<ComponentShowcase />} />
+                <Route path="/examples/slack" element={<SlackApp />} />
+            </Routes>
+        </Router>
+    );
+}
+
+export default App;

package/src/assets/react.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" class="iconify iconify--logos" width="35.93" height="32" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 228"><path fill="#00D8FF" d="M210.483 73.824a171.49 171.49 0 0 0-8.24-2.597c.465-1.9.893-3.777 1.273-5.621c6.238-30.281 2.16-54.676-11.769-62.708c-13.355-7.7-35.196.329-57.254 19.526a171.23 171.23 0 0 0-6.375 5.848a155.866 155.866 0 0 0-4.241-3.917C100.759 3.829 77.587-4.822 63.673 3.233C50.33 10.957 46.379 33.89 51.995 62.588a170.974 170.974 0 0 0 1.892 8.48c-3.28.932-6.445 1.924-9.474 2.98C17.309 83.498 0 98.307 0 113.668c0 15.865 18.582 31.778 46.812 41.427a145.52 145.52 0 0 0 6.921 2.165a167.467 167.467 0 0 0-2.01 9.138c-5.354 28.2-1.173 50.591 12.134 58.266c13.744 7.926 36.812-.22 59.273-19.855a145.567 145.567 0 0 0 5.342-4.923a168.064 168.064 0 0 0 6.92 6.314c21.758 18.722 43.246 26.282 56.54 18.586c13.731-7.949 18.194-32.003 12.4-61.268a145.016 145.016 0 0 0-1.535-6.842c1.62-.48 3.21-.974 4.76-1.488c29.348-9.723 48.443-25.443 48.443-41.52c0-15.417-17.868-30.326-45.517-39.844Zm-6.365 70.984c-1.4.463-2.836.91-4.3 1.345c-3.24-10.257-7.612-21.163-12.963-32.432c5.106-11 9.31-21.767 12.459-31.957c2.619.758 5.16 1.557 7.61 2.4c23.69 8.156 38.14 20.213 38.14 29.504c0 9.896-15.606 22.743-40.946 31.14Zm-10.514 20.834c2.562 12.94 2.927 24.64 1.23 33.787c-1.524 8.219-4.59 13.698-8.382 15.893c-8.067 4.67-25.32-1.4-43.927-17.412a156.726 156.726 0 0 1-6.437-5.87c7.214-7.889 14.423-17.06 21.459-27.246c12.376-1.098 24.068-2.894 34.671-5.345a134.17 134.17 0 0 1 1.386 6.193ZM87.276 214.515c-7.882 2.783-14.16 2.863-17.955.675c-8.075-4.657-11.432-22.636-6.853-46.752a156.923 156.923 0 0 1 1.869-8.499c10.486 2.32 22.093 3.988 34.498 4.994c7.084 9.967 14.501 19.128 21.976 27.15a134.668 134.668 0 0 1-4.877 4.492c-9.933 8.682-19.886 14.842-28.658 17.94ZM50.35 144.747c-12.483-4.267-22.792-9.812-29.858-15.863c-6.35-5.437-9.555-10.836-9.555-15.216c0-9.322 13.897-21.212 37.076-29.293c2.813-.98 5.757-1.905 8.812-2.773c3.204 10.42 7.406 21.315 12.477 32.332c-5.137 11.18-9.399 22.249-12.634 32.792a134.718 134.718 0 0 1-6.318-1.979Zm12.378-84.26c-4.811-24.587-1.616-43.134 6.425-47.789c8.564-4.958 27.502 2.111 47.463 19.835a144.318 144.318 0 0 1 3.841 3.545c-7.438 7.987-14.787 17.08-21.808 26.988c-12.04 1.116-23.565 2.908-34.161 5.309a160.342 160.342 0 0 1-1.76-7.887Zm110.427 27.268a347.8 347.8 0 0 0-7.785-12.803c8.168 1.033 15.994 2.404 23.343 4.08c-2.206 7.072-4.956 14.465-8.193 22.045a381.151 381.151 0 0 0-7.365-13.322Zm-45.032-43.861c5.044 5.465 10.096 11.566 15.065 18.186a322.04 322.04 0 0 0-30.257-.006c4.974-6.559 10.069-12.652 15.192-18.18ZM82.802 87.83a323.167 323.167 0 0 0-7.227 13.238c-3.184-7.553-5.909-14.98-8.134-22.152c7.304-1.634 15.093-2.97 23.209-3.984a321.524 321.524 0 0 0-7.848 12.897Zm8.081 65.352c-8.385-.936-16.291-2.203-23.593-3.793c2.26-7.3 5.045-14.885 8.298-22.6a321.187 321.187 0 0 0 7.257 13.246c2.594 4.48 5.28 8.868 8.038 13.147Zm37.542 31.03c-5.184-5.592-10.354-11.779-15.403-18.433c4.902.192 9.899.29 14.978.29c5.218 0 10.376-.117 15.453-.343c-4.985 6.774-10.018 12.97-15.028 18.486Zm52.198-57.817c3.422 7.8 6.306 15.345 8.596 22.52c-7.422 1.694-15.436 3.058-23.88 4.071a382.417 382.417 0 0 0 7.859-13.026a347.403 347.403 0 0 0 7.425-13.565Zm-16.898 8.101a358.557 358.557 0 0 1-12.281 19.815a329.4 329.4 0 0 1-23.444.823c-7.967 0-15.716-.248-23.178-.732a310.202 310.202 0 0 1-12.513-19.846h.001a307.41 307.41 0 0 1-10.923-20.627a310.278 310.278 0 0 1 10.89-20.637l-.001.001a307.318 307.318 0 0 1 12.413-19.761c7.613-.576 15.42-.876 23.31-.876H128c7.926 0 15.743.303 23.354.883a329.357 329.357 0 0 1 12.335 19.695a358.489 358.489 0 0 1 11.036 20.54a329.472 329.472 0 0 1-11 20.722Zm22.56-122.124c8.572 4.944 11.906 24.881 6.52 51.026c-.344 1.668-.73 3.367-1.15 5.09c-10.622-2.452-22.155-4.275-34.23-5.408c-7.034-10.017-14.323-19.124-21.64-27.008a160.789 160.789 0 0 1 5.888-5.4c18.9-16.447 36.564-22.941 44.612-18.3ZM128 90.808c12.625 0 22.86 10.235 22.86 22.86s-10.235 22.86-22.86 22.86s-22.86-10.235-22.86-22.86s10.235-22.86 22.86-22.86Z"></path></svg>

package/src/components/AlertDialog.tsx

@@ -0,0 +1,185 @@
+import clsx from 'clsx'
+import { Dialog as BaseDialog } from '@base-ui/react'
+import React from 'react'
+import { AlertTriangle, Info, CheckCircle, XCircle } from 'lucide-react'
+import { Button } from './Button'
+
+export type AlertDialogVariant = 'info' | 'success' | 'warning' | 'danger';
+
+export interface AlertDialogProps {
+  open?: boolean;
+  onOpenChange?: (open: boolean) => void;
+  title: string;
+  description?: string;
+  children?: React.ReactNode;
+  variant?: AlertDialogVariant;
+  confirmText?: string;
+  cancelText?: string;
+  onConfirm?: () => void | Promise<void>;
+  onCancel?: () => void;
+  showCancel?: boolean;
+  confirmButtonVariant?: 'primary' | 'secondary' | 'danger' | 'ghost';
+  className?: string;
+}
+
+const variantConfig = {
+  info: {
+    icon: Info,
+    iconClassName: 'text-(--slack-blue)',
+    bgClassName: 'bg-(--slack-blue)/10',
+  },
+  success: {
+    icon: CheckCircle,
+    iconClassName: 'text-(--slack-green)',
+    bgClassName: 'bg-(--slack-green)/10',
+  },
+  warning: {
+    icon: AlertTriangle,
+    iconClassName: 'text-[#E2A03F]',
+    bgClassName: 'bg-[#E2A03F]/10',
+  },
+  danger: {
+    icon: XCircle,
+    iconClassName: 'text-(--danger)',
+    bgClassName: 'bg-(--danger)/10',
+  },
+}
+
+export const AlertDialog = ({
+  open,
+  onOpenChange,
+  title,
+  description,
+  children,
+  variant = 'info',
+  confirmText = 'Confirm',
+  cancelText = 'Cancel',
+  onConfirm,
+  onCancel,
+  showCancel = true,
+  confirmButtonVariant,
+  className,
+}: AlertDialogProps) => {
+  const [isLoading, setIsLoading] = React.useState(false)
+  const config = variantConfig[variant]
+  const Icon = config.icon
+
+  // Auto-map variant to button variant if not specified
+  const buttonVariant = confirmButtonVariant ?? (variant === 'danger' ? 'danger' : 'primary')
+
+  const handleConfirm = async () => {
+    if (onConfirm) {
+      setIsLoading(true)
+      try {
+        await onConfirm()
+        onOpenChange?.(false)
+      } catch (error) {
+        console.error('AlertDialog confirm error:', error)
+      } finally {
+        setIsLoading(false)
+      }
+    } else {
+      onOpenChange?.(false)
+    }
+  }
+
+  const handleCancel = () => {
+    onCancel?.()
+    onOpenChange?.(false)
+  }
+
+  return (
+      <BaseDialog.Root open={open} onOpenChange={onOpenChange}>
+        <BaseDialog.Portal>
+          {/* Backdrop */}
+          <BaseDialog.Backdrop
+              className="fixed inset-0 bg-black/50 z-40 transition-opacity duration-200"
+          />
+
+          {/* Dialog Content */}
+          <BaseDialog.Popup
+              className={clsx(
+                  'fixed left-[50%] top-[50%] z-50 translate-x-[-50%] translate-y-[-50%]',
+                  'w-full max-w-md',
+                  'bg-(--bg-primary) rounded-lg shadow-2xl border border-(--border-gray)',
+                  'transition-all duration-200',
+                  'outline-none focus-visible:outline-none',
+                  className,
+              )}
+          >
+            {/* Content */}
+            <div className="p-6">
+              {/* Icon and Title Section */}
+              <div className="flex items-start gap-4 mb-4">
+                <div className={clsx('p-2 rounded-lg shrink-0', config.bgClassName)}>
+                  <Icon className={clsx('w-6 h-6', config.iconClassName)}/>
+                </div>
+                <div className="flex-1">
+                  <BaseDialog.Title className="text-xl font-black text-(--text-primary) leading-tight">
+                    {title}
+                  </BaseDialog.Title>
+                  {description && (
+                      <BaseDialog.Description className="text-(--text-secondary) mt-2 text-[15px] leading-relaxed">
+                        {description}
+                      </BaseDialog.Description>
+                  )}
+                </div>
+              </div>
+
+              {/* Custom Content */}
+              {children && (
+                  <div className="mb-4 pl-14 text-(--text-primary) text-[15px] leading-relaxed">
+                    {children}
+                  </div>
+              )}
+
+              {/* Action Buttons */}
+              <div className="flex items-center justify-end gap-3 mt-6">
+                {showCancel && (
+                    <Button
+                        variant="secondary"
+                        onClick={handleCancel}
+                        disabled={isLoading}
+                    >
+                      {cancelText}
+                    </Button>
+                )}
+                <Button
+                    variant={buttonVariant}
+                    onClick={handleConfirm}
+                    disabled={isLoading}
+                >
+                  {isLoading ? 'Processing...' : confirmText}
+                </Button>
+              </div>
+            </div>
+          </BaseDialog.Popup>
+        </BaseDialog.Portal>
+      </BaseDialog.Root>
+  )
+}
+
+AlertDialog.displayName = 'AlertDialog'
+
+// Trigger component for opening alert dialogs
+export interface AlertDialogTriggerProps extends React.ComponentPropsWithoutRef<'button'> {
+  asChild?: boolean;
+}
+
+export const AlertDialogTrigger = React.forwardRef<HTMLButtonElement, AlertDialogTriggerProps>(
+    ({ children, asChild, ...props }, ref) => {
+      if (asChild) {
+        return <BaseDialog.Trigger ref={ref}>{children}</BaseDialog.Trigger>
+      }
+
+      return (
+          <BaseDialog.Trigger ref={ref} {...props}>
+            {children}
+          </BaseDialog.Trigger>
+      )
+    },
+)
+
+AlertDialogTrigger.displayName = 'AlertDialogTrigger'
+
+

package/src/components/AutoComplete.tsx

@@ -0,0 +1,311 @@
+import React from 'react'
+import clsx from 'clsx'
+import { ChevronDown, X, Check } from 'lucide-react'
+
+export interface AutoCompleteOption {
+  value: string
+  label: string
+  disabled?: boolean
+}
+
+export interface AutoCompleteProps {
+  options: AutoCompleteOption[]
+  value?: string
+  defaultValue?: string
+  onValueChange?: (value: string) => void
+  /** Called when the raw input text changes */
+  onInputChange?: (input: string) => void
+  placeholder?: string
+  disabled?: boolean
+  required?: boolean
+  /** Label shown above the input */
+  label?: string
+  /** Error message shown below the input */
+  error?: string
+  fullWidth?: boolean
+  /** Show a clear button when a value is selected */
+  clearable?: boolean
+  /** Maximum dropdown height (Tailwind class) */
+  maxHeight?: string
+  /** No-results message */
+  emptyMessage?: string
+  className?: string
+  id?: string
+}
+
+export const AutoComplete = React.forwardRef<HTMLInputElement, AutoCompleteProps>(
+  (
+    {
+      options,
+      value: controlledValue,
+      defaultValue = '',
+      onValueChange,
+      onInputChange,
+      placeholder = 'Search…',
+      disabled,
+      required,
+      label,
+      error,
+      fullWidth,
+      clearable = true,
+      maxHeight = 'max-h-60',
+      emptyMessage = 'No results found',
+      className,
+      id,
+    },
+    ref,
+  ) => {
+    const generatedId = React.useId()
+    const inputId = id ?? generatedId
+    const listboxId = `${inputId}-listbox`
+
+    // ── state ──────────────────────────────────────────────────────────────
+    const isControlled = controlledValue !== undefined
+    const [internalValue, setInternalValue] = React.useState<string>(defaultValue)
+    const selectedValue = isControlled ? controlledValue : internalValue
+
+    const [inputText, setInputText] = React.useState<string>(() => {
+      const found = options.find((o) => o.value === (isControlled ? controlledValue : defaultValue))
+      return found ? found.label : (isControlled ? controlledValue ?? '' : defaultValue)
+    })
+    const [open, setOpen] = React.useState(false)
+    const [activeIndex, setActiveIndex] = React.useState<number>(-1)
+
+    const containerRef = React.useRef<HTMLDivElement>(null)
+    const inputRef = React.useRef<HTMLInputElement>(null)
+
+    // sync external label when controlled value changes
+    React.useEffect(() => {
+      if (isControlled) {
+        const found = options.find((o) => o.value === controlledValue)
+        setInputText(found ? found.label : controlledValue ?? '')
+      }
+    }, [controlledValue, isControlled, options])
+
+    // ── filtered list ──────────────────────────────────────────────────────
+    const filtered = React.useMemo(() => {
+      const q = inputText.toLowerCase()
+      return options.filter((o) => o.label.toLowerCase().includes(q))
+    }, [options, inputText])
+
+    // ── helpers ────────────────────────────────────────────────────────────
+    const selectOption = (option: AutoCompleteOption) => {
+      if (option.disabled) return
+      setInputText(option.label)
+      if (!isControlled) setInternalValue(option.value)
+      onValueChange?.(option.value)
+      setOpen(false)
+      setActiveIndex(-1)
+    }
+
+    const clearSelection = (e: React.MouseEvent) => {
+      e.stopPropagation()
+      setInputText('')
+      if (!isControlled) setInternalValue('')
+      onValueChange?.('')
+      onInputChange?.('')
+      setOpen(false)
+      inputRef.current?.focus()
+    }
+
+    // ── event handlers ─────────────────────────────────────────────────────
+    const handleInputChange = (e: React.ChangeEvent<HTMLInputElement>) => {
+      const v = e.target.value
+      setInputText(v)
+      onInputChange?.(v)
+      if (!isControlled) setInternalValue('')
+      onValueChange?.('')
+      setOpen(true)
+      setActiveIndex(-1)
+    }
+
+    const handleInputFocus = () => {
+      setOpen(true)
+    }
+
+    const handleKeyDown = (e: React.KeyboardEvent<HTMLInputElement>) => {
+      const enabledItems = filtered.filter((o) => !o.disabled)
+      switch (e.key) {
+        case 'ArrowDown':
+          e.preventDefault()
+          setOpen(true)
+          setActiveIndex((i) => Math.min(i + 1, enabledItems.length - 1))
+          break
+        case 'ArrowUp':
+          e.preventDefault()
+          setActiveIndex((i) => Math.max(i - 1, 0))
+          break
+        case 'Enter':
+          e.preventDefault()
+          if (open && activeIndex >= 0 && enabledItems[activeIndex]) {
+            selectOption(enabledItems[activeIndex])
+          }
+          break
+        case 'Escape':
+          setOpen(false)
+          setActiveIndex(-1)
+          break
+        case 'Tab':
+          setOpen(false)
+          break
+      }
+    }
+
+    // close on outside click
+    React.useEffect(() => {
+      const onPointerDown = (e: PointerEvent) => {
+        if (containerRef.current && !containerRef.current.contains(e.target as Node)) {
+          setOpen(false)
+          // restore label if user blurs with partial text
+          const matched = options.find((o) => o.value === selectedValue)
+          if (matched) setInputText(matched.label)
+        }
+      }
+      document.addEventListener('pointerdown', onPointerDown)
+      return () => document.removeEventListener('pointerdown', onPointerDown)
+    }, [options, selectedValue])
+
+    const showClear = clearable && (inputText || selectedValue)
+
+    return (
+      <div
+        ref={containerRef}
+        className={clsx('relative flex flex-col gap-1.5', fullWidth && 'w-full', className)}
+      >
+        {/* Label */}
+        {label && (
+          <label
+            htmlFor={inputId}
+            className="text-[14px] font-semibold text-(--text-primary)"
+          >
+            {label}
+            {required && <span className="ml-0.5 text-(--danger)">*</span>}
+          </label>
+        )}
+
+        {/* Input row */}
+        <div className="relative">
+          <input
+            ref={(node) => {
+              // forward ref + internal ref
+              ;(inputRef as React.MutableRefObject<HTMLInputElement | null>).current = node
+              if (typeof ref === 'function') ref(node)
+              else if (ref) (ref as React.MutableRefObject<HTMLInputElement | null>).current = node
+            }}
+            id={inputId}
+            role="combobox"
+            aria-autocomplete="list"
+            aria-expanded={open}
+            aria-controls={listboxId}
+            aria-activedescendant={
+              activeIndex >= 0 ? `${inputId}-option-${activeIndex}` : undefined
+            }
+            autoComplete="off"
+            disabled={disabled}
+            required={required}
+            placeholder={placeholder}
+            value={inputText}
+            onChange={handleInputChange}
+            onFocus={handleInputFocus}
+            onKeyDown={handleKeyDown}
+            className={clsx(
+              'appearance-none block w-full rounded-md border text-[15px] leading-[1.4] shadow-sm',
+              'px-3 py-2 pr-9 bg-(--bg-primary) text-(--text-primary) placeholder-(--text-muted)',
+              'transition-[border-color,box-shadow,background-color] focus:outline-none',
+              'focus:border-(--accent)/70',
+              'disabled:bg-(--bg-primary) disabled:text-(--text-muted) disabled:cursor-not-allowed',
+              error
+                ? 'border-(--danger) focus:border-(--danger) focus:shadow-[0_0_0_2px_var(--danger)]'
+                : 'border-(--border-light) hover:border-(--text-primary)/30',
+            )}
+          />
+
+          {/* Trailing icons */}
+          <span className="pointer-events-none absolute inset-y-0 right-0 flex items-center pr-2.5 gap-0.5">
+            {showClear && (
+              <button
+                type="button"
+                tabIndex={-1}
+                aria-label="Clear"
+                onClick={clearSelection}
+                className={clsx(
+                  'pointer-events-auto p-0.5 rounded text-(--text-muted) hover:text-(--text-primary)',
+                  'transition-colors',
+                )}
+              >
+                <X size={14} />
+              </button>
+            )}
+            <ChevronDown
+              size={16}
+              className={clsx(
+                'text-(--text-muted) transition-transform duration-150',
+                open && 'rotate-180',
+              )}
+            />
+          </span>
+        </div>
+
+        {/* Dropdown */}
+        {open && (
+          <div
+            id={listboxId}
+            role="listbox"
+            className={clsx(
+              'absolute left-0 right-0 z-50 mt-1 overflow-y-auto',
+              'rounded-md border border-(--border-light) bg-(--bg-primary) shadow-lg',
+              'py-1',
+              maxHeight,
+              label ? 'top-[calc(100%+2px)]' : 'top-[calc(100%+2px)]',
+            )}
+            style={{ top: label ? 'calc(1.5rem + 0.375rem + 2.25rem + 2px)' : 'calc(2.25rem + 2px)' }}
+          >
+            {filtered.length === 0 ? (
+              <div className="px-3 py-2 text-[13px] text-(--text-muted)">{emptyMessage}</div>
+            ) : (
+              filtered.map((option, index) => {
+                const isSelected = option.value === selectedValue
+                const isActive = index === activeIndex
+                return (
+                  <div
+                    key={option.value}
+                    id={`${inputId}-option-${index}`}
+                    role="option"
+                    aria-selected={isSelected}
+                    aria-disabled={option.disabled}
+                    onPointerDown={(e) => {
+                      e.preventDefault()
+                      selectOption(option)
+                    }}
+                    className={clsx(
+                      'relative flex cursor-default select-none items-center px-3 py-1.5 text-[14px] rounded mx-1',
+                      'transition-colors',
+                      isActive && 'bg-(--bg-hover) outline-none',
+                      isSelected && !isActive && 'bg-(--bg-hover)/60 font-medium',
+                      option.disabled && 'opacity-50 cursor-not-allowed',
+                    )}
+                  >
+                    <span className="flex-1">{option.label}</span>
+                    {isSelected && (
+                      <Check size={14} className="ml-2 text-(--accent) shrink-0" />
+                    )}
+                  </div>
+                )
+              })
+            )}
+          </div>
+        )}
+
+        {/* Error */}
+        {error && (
+          <span className="text-[12px] font-medium text-(--danger) flex items-center gap-1 leading-tight">
+            ⚠️ {error}
+          </span>
+        )}
+      </div>
+    )
+  },
+)
+
+AutoComplete.displayName = 'AutoComplete'
+

package/src/components/Avatar.tsx

@@ -0,0 +1,70 @@
+import clsx from 'clsx'
+import React from 'react'
+
+export type AvatarStatus = 'online' | 'away' | 'dnd' | 'offline';
+export type AvatarSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+
+export interface AvatarProps extends React.ComponentPropsWithoutRef<'div'> {
+  src?: string;
+  alt?: string;
+  fallback?: string;
+  size?: AvatarSize;
+  status?: AvatarStatus;
+  rounded?: boolean; // Slack uses rounded squares mostly
+}
+
+export const Avatar = React.forwardRef<HTMLDivElement, AvatarProps>(
+    ({ className, src, alt, fallback, size = 'md', status, rounded = true, ...props }, ref) => {
+
+      const sizeClasses = {
+        xs: 'h-5 w-5 text-[10px]',
+        sm: 'h-6 w-6 text-xs',
+        md: 'h-9 w-9 text-sm',
+        lg: 'h-12 w-12 text-base',
+        xl: 'h-16 w-16 text-lg',
+      }
+
+      const statusColors = {
+        online: 'bg-[#2bac76]',
+        away: 'bg-[#eca33d]', // Hollow circle usually, but filled for simplicity or specific icon
+        dnd: 'bg-[#e01e5a]',
+        offline: 'bg-(--text-muted)',
+      }
+
+      // Slack uses rounded-md for avatars usually
+      const radiusClass = rounded ? 'rounded-md' : 'rounded-full'
+
+      return (
+          <div
+              ref={ref}
+              className={clsx('relative inline-block', className)}
+              {...props}
+          >
+            <div
+                className={clsx(
+                    'overflow-hidden bg-(--bg-secondary) flex items-center justify-center font-medium text-(--text-secondary) select-none',
+                    sizeClasses[size],
+                    radiusClass,
+                )}
+            >
+              {src ? (
+                  <img src={src} alt={alt} className="h-full w-full object-cover"/>
+              ) : (
+                  <span>{fallback || (alt ? alt.charAt(0).toUpperCase() : '?')}</span>
+              )}
+            </div>
+
+            {status && status !== 'offline' && (
+                <span
+                    className={clsx(
+                        'absolute -bottom-0.5 -right-0.5 block h-2 w-2 rounded-full ring-2 ring-(--bg-primary)',
+                        statusColors[status],
+                    )}
+                />
+            )}
+          </div>
+      )
+    },
+)
+
+Avatar.displayName = 'Avatar'

package/src/components/Badge.tsx

@@ -0,0 +1,48 @@
+import clsx from 'clsx'
+import React from 'react'
+
+export interface BadgeProps extends React.HTMLAttributes<HTMLSpanElement> {
+  count?: number;
+  dot?: boolean;
+  variant?: 'danger' | 'neutral'; // Red for mentions, Gray for unread
+}
+
+export const Badge = React.forwardRef<HTMLSpanElement, BadgeProps>(
+    ({ className, count, dot, variant = 'danger', children, ...props }, ref) => {
+
+      const variants = {
+        danger: 'bg-(--danger) text-(--accent-contrast)',
+        neutral: 'bg-(--badge-neutral) text-(--accent-contrast)',
+      }
+
+      if (dot) {
+        return (
+            <span
+                ref={ref}
+                className={clsx(
+                    'inline-block h-2 w-2 rounded-full',
+                    variants[variant],
+                    className,
+                )}
+                {...props}
+            />
+        )
+      }
+
+      return (
+          <span
+              ref={ref}
+              className={clsx(
+                  'inline-flex items-center justify-center rounded-full px-2 py-0.5 text-[11px] font-bold min-w-5',
+                  variants[variant],
+                  className,
+              )}
+              {...props}
+          >
+                {count !== undefined ? count : children}
+            </span>
+      )
+    },
+)
+
+Badge.displayName = 'Badge'