@wakastellar/ui 2.0.0 → 2.1.0

package/src/components/error-boundary/ErrorBoundary.tsx

@@ -0,0 +1,281 @@
+"use client"
+
+import * as React from "react"
+import { WakaError, ErrorCode, ErrorCodeType } from "../../utils/error-handling"
+import { logger } from "../../utils/logger"
+import { cn } from "../../utils/cn"
+
+/**
+ * Props for the error fallback component
+ */
+export interface ErrorFallbackProps {
+  /** The error that was caught */
+  error: WakaError
+  /** Function to reset the error boundary */
+  resetErrorBoundary: () => void
+  /** Component name where error occurred */
+  componentName?: string
+}
+
+/**
+ * Props for ErrorBoundary component
+ */
+export interface ErrorBoundaryProps {
+  /** Children to render */
+  children: React.ReactNode
+  /** Custom fallback component */
+  fallback?: React.ReactNode | ((props: ErrorFallbackProps) => React.ReactNode)
+  /** Callback when error is caught */
+  onError?: (error: WakaError, errorInfo: React.ErrorInfo) => void
+  /** Callback when boundary is reset */
+  onReset?: () => void
+  /** Reset keys - boundary resets when these change */
+  resetKeys?: unknown[]
+  /** Component name for error context */
+  componentName?: string
+  /** Error code to use for caught errors */
+  errorCode?: ErrorCodeType
+  /** Additional CSS classes */
+  className?: string
+}
+
+/**
+ * State for ErrorBoundary
+ */
+interface ErrorBoundaryState {
+  hasError: boolean
+  error: WakaError | null
+}
+
+/**
+ * Default error fallback component
+ */
+function DefaultErrorFallback({
+  error,
+  resetErrorBoundary,
+  componentName,
+}: ErrorFallbackProps) {
+  return (
+    <div
+      role="alert"
+      className={cn(
+        "flex flex-col items-center justify-center p-6",
+        "border border-destructive/50 rounded-lg bg-destructive/5",
+        "text-center space-y-4"
+      )}
+    >
+      <div className="flex items-center gap-2 text-destructive">
+        <svg
+          xmlns="http://www.w3.org/2000/svg"
+          width="24"
+          height="24"
+          viewBox="0 0 24 24"
+          fill="none"
+          stroke="currentColor"
+          strokeWidth="2"
+          strokeLinecap="round"
+          strokeLinejoin="round"
+        >
+          <circle cx="12" cy="12" r="10" />
+          <line x1="12" y1="8" x2="12" y2="12" />
+          <line x1="12" y1="16" x2="12.01" y2="16" />
+        </svg>
+        <h3 className="font-semibold text-lg">Something went wrong</h3>
+      </div>
+
+      {componentName && (
+        <p className="text-sm text-muted-foreground">
+          Error in component: <code className="font-mono">{componentName}</code>
+        </p>
+      )}
+
+      <p className="text-sm text-muted-foreground max-w-md">{error.message}</p>
+
+      {error.code !== ErrorCode.UNKNOWN && (
+        <p className="text-xs text-muted-foreground font-mono">
+          Code: {error.code}
+        </p>
+      )}
+
+      <button
+        onClick={resetErrorBoundary}
+        className={cn(
+          "px-4 py-2 text-sm font-medium rounded-md",
+          "bg-primary text-primary-foreground",
+          "hover:bg-primary/90 transition-colors",
+          "focus:outline-none focus:ring-2 focus:ring-primary focus:ring-offset-2"
+        )}
+      >
+        Try again
+      </button>
+    </div>
+  )
+}
+
+/**
+ * Error Boundary component for catching and handling React errors
+ *
+ * @example
+ * ```tsx
+ * <ErrorBoundary
+ *   componentName="DataTable"
+ *   onError={(error) => reportError(error)}
+ *   fallback={<CustomErrorUI />}
+ * >
+ *   <DataTable data={data} columns={columns} />
+ * </ErrorBoundary>
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // With reset keys
+ * <ErrorBoundary resetKeys={[userId, tableId]}>
+ *   <UserTable userId={userId} />
+ * </ErrorBoundary>
+ * ```
+ */
+export class ErrorBoundary extends React.Component<
+  ErrorBoundaryProps,
+  ErrorBoundaryState
+> {
+  constructor(props: ErrorBoundaryProps) {
+    super(props)
+    this.state = { hasError: false, error: null }
+  }
+
+  static getDerivedStateFromError(error: Error): ErrorBoundaryState {
+    const wakaError = WakaError.from(error, {
+      code: ErrorCode.COMPONENT_RENDER_FAILED,
+    })
+    return { hasError: true, error: wakaError }
+  }
+
+  componentDidCatch(error: Error, errorInfo: React.ErrorInfo) {
+    const { onError, componentName, errorCode } = this.props
+
+    const wakaError = WakaError.from(error, {
+      code: errorCode || ErrorCode.COMPONENT_RENDER_FAILED,
+      context: componentName,
+      metadata: {
+        componentStack: errorInfo.componentStack,
+      },
+    })
+
+    // Log error
+    logger.error(
+      `ErrorBoundary caught error${componentName ? ` in ${componentName}` : ""}`,
+      wakaError.toJSON()
+    )
+
+    // Call error callback
+    onError?.(wakaError, errorInfo)
+  }
+
+  componentDidUpdate(prevProps: ErrorBoundaryProps) {
+    const { resetKeys } = this.props
+    const { hasError } = this.state
+
+    // Reset on resetKeys change
+    if (hasError && resetKeys) {
+      const prevResetKeys = prevProps.resetKeys || []
+      const hasResetKeyChanged = resetKeys.some(
+        (key, index) => key !== prevResetKeys[index]
+      )
+      if (hasResetKeyChanged) {
+        this.reset()
+      }
+    }
+  }
+
+  reset = () => {
+    const { onReset } = this.props
+    this.setState({ hasError: false, error: null })
+    onReset?.()
+  }
+
+  render() {
+    const { children, fallback, componentName, className } = this.props
+    const { hasError, error } = this.state
+
+    if (hasError && error) {
+      // Custom fallback function
+      if (typeof fallback === "function") {
+        return (
+          <div className={className}>
+            {fallback({
+              error,
+              resetErrorBoundary: this.reset,
+              componentName,
+            })}
+          </div>
+        )
+      }
+
+      // Custom fallback element
+      if (fallback) {
+        return <div className={className}>{fallback}</div>
+      }
+
+      // Default fallback
+      return (
+        <div className={className}>
+          <DefaultErrorFallback
+            error={error}
+            resetErrorBoundary={this.reset}
+            componentName={componentName}
+          />
+        </div>
+      )
+    }
+
+    return children
+  }
+}
+
+/**
+ * Hook to create an error boundary reset function
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const resetBoundary = useErrorBoundaryReset()
+ *
+ *   const handleRetry = () => {
+ *     // Clear local state
+ *     setState(initialState)
+ *     // Reset error boundary
+ *     resetBoundary()
+ *   }
+ * }
+ * ```
+ */
+export function useErrorBoundaryReset(): () => void {
+  const [, setKey] = React.useState(0)
+  return React.useCallback(() => setKey((k) => k + 1), [])
+}
+
+/**
+ * Higher-order component to wrap a component with ErrorBoundary
+ *
+ * @example
+ * ```tsx
+ * const SafeDataTable = withErrorBoundary(DataTable, {
+ *   componentName: 'DataTable',
+ *   onError: reportError,
+ * })
+ * ```
+ */
+export function withErrorBoundary<P extends object>(
+  Component: React.ComponentType<P>,
+  errorBoundaryProps: Omit<ErrorBoundaryProps, "children">
+): React.FC<P> {
+  const WrappedComponent: React.FC<P> = (props) => (
+    <ErrorBoundary {...errorBoundaryProps}>
+      <Component {...props} />
+    </ErrorBoundary>
+  )
+
+  WrappedComponent.displayName = `withErrorBoundary(${Component.displayName || Component.name || "Component"})`
+
+  return WrappedComponent
+}

package/src/components/error-boundary/index.ts

@@ -0,0 +1,7 @@
+export {
+  ErrorBoundary,
+  withErrorBoundary,
+  useErrorBoundaryReset,
+} from "./ErrorBoundary"
+
+export type { ErrorBoundaryProps, ErrorFallbackProps } from "./ErrorBoundary"

package/src/components/form/index.tsx

@@ -0,0 +1,183 @@
+import * as React from "react"
+import * as LabelPrimitive from "@radix-ui/react-label"
+import { Slot } from "@radix-ui/react-slot"
+import {
+  Controller,
+  ControllerProps,
+  FieldPath,
+  FieldValues,
+  FormProvider,
+  useFormContext,
+} from "react-hook-form"
+
+import { cn } from "../../utils"
+import { Label } from "../label"
+
+const Form = FormProvider
+
+type FormFieldContextValue<
+  TFieldValues extends FieldValues = FieldValues,
+  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>
+> = {
+  name: TName
+}
+
+const FormFieldContext = React.createContext<FormFieldContextValue>(
+  {} as FormFieldContextValue
+)
+
+const FormField = <
+  TFieldValues extends FieldValues = FieldValues,
+  TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>
+>({
+  ...props
+}: ControllerProps<TFieldValues, TName>) => {
+  return (
+    <FormFieldContext.Provider value={{ name: props.name }}>
+      <Controller {...props} />
+    </FormFieldContext.Provider>
+  )
+}
+
+const useFormField = () => {
+  const fieldContext = React.useContext(FormFieldContext)
+  const itemContext = React.useContext(FormItemContext)
+  const { getFieldState, formState } = useFormContext()
+
+  const fieldState = getFieldState(fieldContext.name, formState)
+
+  if (!fieldContext) {
+    throw new Error("useFormField should be used within <FormField>")
+  }
+
+  const { id } = itemContext
+
+  return {
+    id,
+    name: fieldContext.name,
+    formItemId: `${id}-form-item`,
+    formDescriptionId: `${id}-form-item-description`,
+    formMessageId: `${id}-form-item-message`,
+    ...fieldState,
+  }
+}
+
+type FormItemContextValue = {
+  id: string
+}
+
+const FormItemContext = React.createContext<FormItemContextValue>(
+  {} as FormItemContextValue
+)
+
+const FormItem = React.forwardRef<
+  HTMLDivElement,
+  React.HTMLAttributes<HTMLDivElement>
+>(({ className, ...props }, ref) => {
+  const id = React.useId()
+
+  return (
+    <FormItemContext.Provider value={{ id }}>
+      <div ref={ref} className={cn("space-y-2", className)} {...props} />
+    </FormItemContext.Provider>
+  )
+})
+FormItem.displayName = "FormItem"
+
+const FormLabel = React.forwardRef<
+  React.ElementRef<typeof LabelPrimitive.Root>,
+  React.ComponentPropsWithoutRef<typeof LabelPrimitive.Root>
+>(({ className, ...props }, ref) => {
+  const { error, formItemId } = useFormField()
+
+  return (
+    <Label
+      ref={ref}
+      className={cn(error && "text-destructive", className)}
+      htmlFor={formItemId}
+      {...props}
+    />
+  )
+})
+FormLabel.displayName = "FormLabel"
+
+const FormControl = React.forwardRef<
+  React.ElementRef<typeof Slot>,
+  React.ComponentPropsWithoutRef<typeof Slot>
+>(({ ...props }, ref) => {
+  const { error, formItemId, formDescriptionId, formMessageId } = useFormField()
+
+  return (
+    <Slot
+      ref={ref}
+      id={formItemId}
+      aria-describedby={
+        !error
+          ? `${formDescriptionId}`
+          : `${formDescriptionId} ${formMessageId}`
+      }
+      aria-invalid={!!error}
+      {...props}
+    />
+  )
+})
+FormControl.displayName = "FormControl"
+
+const FormDescription = React.forwardRef<
+  HTMLParagraphElement,
+  React.HTMLAttributes<HTMLParagraphElement>
+>(({ className, ...props }, ref) => {
+  const { formDescriptionId } = useFormField()
+
+  return (
+    <p
+      ref={ref}
+      id={formDescriptionId}
+      className={cn("text-sm text-muted-foreground", className)}
+      {...props}
+    />
+  )
+})
+FormDescription.displayName = "FormDescription"
+
+const FormMessage = React.forwardRef<
+  HTMLParagraphElement,
+  React.HTMLAttributes<HTMLParagraphElement>
+>(({ className, children, ...props }, ref) => {
+  const { error, formMessageId } = useFormField()
+  const body = error ? String(error?.message) : children
+
+  if (!body) {
+    return null
+  }
+
+  return (
+    <p
+      ref={ref}
+      id={formMessageId}
+      className={cn("text-sm font-medium text-destructive", className)}
+      {...props}
+    >
+      {body}
+    </p>
+  )
+})
+FormMessage.displayName = "FormMessage"
+
+export {
+  useFormField,
+  Form,
+  FormItem,
+  FormLabel,
+  FormControl,
+  FormDescription,
+  FormMessage,
+  FormField,
+}
+
+
+
+
+
+
+

package/src/components/hover-card/index.tsx

@@ -0,0 +1,33 @@
+import * as React from "react"
+import * as HoverCardPrimitive from "@radix-ui/react-hover-card"
+import { cn } from "../../utils/cn"
+
+const HoverCard: typeof HoverCardPrimitive.Root = HoverCardPrimitive.Root
+
+const HoverCardTrigger: typeof HoverCardPrimitive.Trigger = 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 }
+
+
+
+
+
+
+