zyflow 0.6.4

package/src/components/ui/skeleton.tsx

@@ -0,0 +1,13 @@
+import { cn } from '@/lib/utils'
+
+function Skeleton({ className, ...props }: React.ComponentProps<'div'>) {
+  return (
+    <div
+      data-slot='skeleton'
+      className={cn('bg-accent animate-pulse rounded-md', className)}
+      {...props}
+    />
+  )
+}
+
+export { Skeleton }

package/src/components/ui/slider.tsx

@@ -0,0 +1,56 @@
+import * as React from "react"
+import * as SliderPrimitive from "@radix-ui/react-slider"
+
+import { cn } from "@/lib/utils"
+
+function Slider({
+  className,
+  defaultValue,
+  value,
+  min = 0,
+  max = 100,
+  ...props
+}: React.ComponentProps<typeof SliderPrimitive.Root>) {
+  const _values = React.useMemo(
+    () => value ?? defaultValue ?? [min, max],
+    [value, defaultValue, min, max]
+  )
+
+  return (
+    <SliderPrimitive.Root
+      data-slot="slider"
+      defaultValue={defaultValue}
+      value={value}
+      min={min}
+      max={max}
+      className={cn(
+        "relative flex w-full touch-none items-center select-none data-[disabled]:opacity-50 data-[orientation=vertical]:h-full data-[orientation=vertical]:min-h-44 data-[orientation=vertical]:w-auto data-[orientation=vertical]:flex-col",
+        className
+      )}
+      {...props}
+    >
+      <SliderPrimitive.Track
+        data-slot="slider-track"
+        className={cn(
+          "bg-muted relative grow overflow-hidden rounded-full data-[orientation=horizontal]:h-1.5 data-[orientation=horizontal]:w-full data-[orientation=vertical]:h-full data-[orientation=vertical]:w-1.5"
+        )}
+      >
+        <SliderPrimitive.Range
+          data-slot="slider-range"
+          className={cn(
+            "bg-primary absolute data-[orientation=horizontal]:h-full data-[orientation=vertical]:w-full"
+          )}
+        />
+      </SliderPrimitive.Track>
+      {Array.from({ length: _values.length }, (_, index) => (
+        <SliderPrimitive.Thumb
+          data-slot="slider-thumb"
+          key={index}
+          className="border-primary bg-background ring-ring/50 block size-4 shrink-0 rounded-full border shadow-sm transition-[color,box-shadow] hover:ring-4 focus-visible:ring-4 focus-visible:outline-hidden disabled:pointer-events-none disabled:opacity-50"
+        />
+      ))}
+    </SliderPrimitive.Root>
+  )
+}
+
+export { Slider }

package/src/components/ui/switch.tsx

@@ -0,0 +1,29 @@
+import * as React from "react"
+import * as SwitchPrimitive from "@radix-ui/react-switch"
+
+import { cn } from "@/lib/utils"
+
+function Switch({
+  className,
+  ...props
+}: React.ComponentProps<typeof SwitchPrimitive.Root>) {
+  return (
+    <SwitchPrimitive.Root
+      data-slot="switch"
+      className={cn(
+        "peer data-[state=checked]:bg-primary data-[state=unchecked]:bg-input focus-visible:border-ring focus-visible:ring-ring/50 dark:data-[state=unchecked]:bg-input/80 inline-flex h-[1.15rem] w-8 shrink-0 items-center rounded-full border border-transparent shadow-xs transition-all outline-none focus-visible:ring-[3px] disabled:cursor-not-allowed disabled:opacity-50",
+        className
+      )}
+      {...props}
+    >
+      <SwitchPrimitive.Thumb
+        data-slot="switch-thumb"
+        className={cn(
+          "bg-background dark:data-[state=unchecked]:bg-foreground dark:data-[state=checked]:bg-primary-foreground pointer-events-none block size-4 rounded-full ring-0 transition-transform data-[state=checked]:translate-x-[calc(100%-2px)] data-[state=unchecked]:translate-x-0"
+        )}
+      />
+    </SwitchPrimitive.Root>
+  )
+}
+
+export { Switch }

package/src/components/ui/table.tsx

@@ -0,0 +1,113 @@
+import * as React from 'react'
+import { cn } from '@/lib/utils'
+
+function Table({ className, ...props }: React.ComponentProps<'table'>) {
+  return (
+    <div
+      data-slot='table-container'
+      className='relative w-full overflow-x-auto'
+    >
+      <table
+        data-slot='table'
+        className={cn('w-full caption-bottom text-sm', className)}
+        {...props}
+      />
+    </div>
+  )
+}
+
+function TableHeader({ className, ...props }: React.ComponentProps<'thead'>) {
+  return (
+    <thead
+      data-slot='table-header'
+      className={cn('[&_tr]:border-b', className)}
+      {...props}
+    />
+  )
+}
+
+function TableBody({ className, ...props }: React.ComponentProps<'tbody'>) {
+  return (
+    <tbody
+      data-slot='table-body'
+      className={cn('[&_tr:last-child]:border-0', className)}
+      {...props}
+    />
+  )
+}
+
+function TableFooter({ className, ...props }: React.ComponentProps<'tfoot'>) {
+  return (
+    <tfoot
+      data-slot='table-footer'
+      className={cn(
+        'bg-muted/50 border-t font-medium [&>tr]:last:border-b-0',
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+function TableRow({ className, ...props }: React.ComponentProps<'tr'>) {
+  return (
+    <tr
+      data-slot='table-row'
+      className={cn(
+        'hover:bg-muted/50 data-[state=selected]:bg-muted border-b transition-colors',
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+function TableHead({ className, ...props }: React.ComponentProps<'th'>) {
+  return (
+    <th
+      data-slot='table-head'
+      className={cn(
+        'text-foreground h-10 px-2 text-start align-middle font-medium whitespace-nowrap [&>[role=checkbox]]:translate-y-[2px]',
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+function TableCell({ className, ...props }: React.ComponentProps<'td'>) {
+  return (
+    <td
+      data-slot='table-cell'
+      className={cn(
+        'p-2 align-middle whitespace-nowrap [&>[role=checkbox]]:translate-y-[2px]',
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+function TableCaption({
+  className,
+  ...props
+}: React.ComponentProps<'caption'>) {
+  return (
+    <caption
+      data-slot='table-caption'
+      className={cn('text-muted-foreground mt-4 text-sm', className)}
+      {...props}
+    />
+  )
+}
+
+export {
+  Table,
+  TableHeader,
+  TableBody,
+  TableFooter,
+  TableHead,
+  TableRow,
+  TableCell,
+  TableCaption,
+}

package/src/components/ui/tabs.tsx

@@ -0,0 +1,63 @@
+import * as React from 'react'
+import * as TabsPrimitive from '@radix-ui/react-tabs'
+import { cn } from '@/lib/utils'
+
+function Tabs({
+  className,
+  ...props
+}: React.ComponentProps<typeof TabsPrimitive.Root>) {
+  return (
+    <TabsPrimitive.Root
+      data-slot='tabs'
+      className={cn('flex flex-col gap-2', className)}
+      {...props}
+    />
+  )
+}
+
+function TabsList({
+  className,
+  ...props
+}: React.ComponentProps<typeof TabsPrimitive.List>) {
+  return (
+    <TabsPrimitive.List
+      data-slot='tabs-list'
+      className={cn(
+        'bg-muted text-muted-foreground inline-flex h-9 w-fit items-center justify-center rounded-lg p-[3px]',
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+function TabsTrigger({
+  className,
+  ...props
+}: React.ComponentProps<typeof TabsPrimitive.Trigger>) {
+  return (
+    <TabsPrimitive.Trigger
+      data-slot='tabs-trigger'
+      className={cn(
+        "data-[state=active]:bg-background dark:data-[state=active]:text-foreground focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:outline-ring dark:data-[state=active]:border-input dark:data-[state=active]:bg-input/30 text-foreground dark:text-muted-foreground inline-flex h-[calc(100%-1px)] flex-1 items-center justify-center gap-1.5 rounded-md border border-transparent px-2 py-1 text-sm font-medium whitespace-nowrap transition-[color,box-shadow] focus-visible:ring-[3px] focus-visible:outline-1 disabled:pointer-events-none disabled:opacity-50 data-[state=active]:shadow-sm [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4",
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+function TabsContent({
+  className,
+  ...props
+}: React.ComponentProps<typeof TabsPrimitive.Content>) {
+  return (
+    <TabsPrimitive.Content
+      data-slot='tabs-content'
+      className={cn('flex-1 outline-none', className)}
+      {...props}
+    />
+  )
+}
+
+export { Tabs, TabsList, TabsTrigger, TabsContent }

package/src/components/ui/textarea.tsx

@@ -0,0 +1,17 @@
+import * as React from 'react'
+import { cn } from '@/lib/utils'
+
+function Textarea({ className, ...props }: React.ComponentProps<'textarea'>) {
+  return (
+    <textarea
+      data-slot='textarea'
+      className={cn(
+        'border-input placeholder:text-muted-foreground focus-visible:border-ring focus-visible:ring-ring/50 aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 aria-invalid:border-destructive dark:bg-input/30 flex field-sizing-content min-h-16 w-full rounded-md border bg-transparent px-3 py-2 text-base shadow-xs transition-[color,box-shadow] outline-none focus-visible:ring-[3px] disabled:cursor-not-allowed disabled:opacity-50 md:text-sm',
+        className
+      )}
+      {...props}
+    />
+  )
+}
+
+export { Textarea }

package/src/components/ui/tooltip.tsx

@@ -0,0 +1,60 @@
+'use client'
+
+import * as React from 'react'
+import * as TooltipPrimitive from '@radix-ui/react-tooltip'
+import { cn } from '@/lib/utils'
+
+function TooltipProvider({
+  delayDuration = 0,
+  ...props
+}: React.ComponentProps<typeof TooltipPrimitive.Provider>) {
+  return (
+    <TooltipPrimitive.Provider
+      data-slot='tooltip-provider'
+      delayDuration={delayDuration}
+      {...props}
+    />
+  )
+}
+
+function Tooltip({
+  ...props
+}: React.ComponentProps<typeof TooltipPrimitive.Root>) {
+  return (
+    <TooltipProvider>
+      <TooltipPrimitive.Root data-slot='tooltip' {...props} />
+    </TooltipProvider>
+  )
+}
+
+function TooltipTrigger({
+  ...props
+}: React.ComponentProps<typeof TooltipPrimitive.Trigger>) {
+  return <TooltipPrimitive.Trigger data-slot='tooltip-trigger' {...props} />
+}
+
+function TooltipContent({
+  className,
+  sideOffset = 0,
+  children,
+  ...props
+}: React.ComponentProps<typeof TooltipPrimitive.Content>) {
+  return (
+    <TooltipPrimitive.Portal>
+      <TooltipPrimitive.Content
+        data-slot='tooltip-content'
+        sideOffset={sideOffset}
+        className={cn(
+          'bg-primary text-primary-foreground animate-in fade-in-0 zoom-in-95 data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=closed]:zoom-out-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 z-50 w-fit origin-(--radix-tooltip-content-transform-origin) rounded-md px-3 py-1.5 text-xs text-balance',
+          className
+        )}
+        {...props}
+      >
+        {children}
+        <TooltipPrimitive.Arrow className='bg-primary fill-primary z-50 size-2.5 translate-y-[calc(-50%_-_2px)] rotate-45 rounded-[2px]' />
+      </TooltipPrimitive.Content>
+    </TooltipPrimitive.Portal>
+  )
+}
+
+export { Tooltip, TooltipTrigger, TooltipContent, TooltipProvider }

package/src/config/api.ts

@@ -0,0 +1,83 @@
+/**
+ * API Configuration
+ *
+ * 환경변수 기반 API 엔드포인트 중앙 관리
+ * - 개발: Vite 프록시를 통해 상대 경로 사용 (/api → localhost:3100)
+ * - 프로덕션: 환경변수로 설정
+ */
+
+// API Base URL (환경변수 우선, 없으면 상대 경로 사용 - Vite 프록시 활용)
+export const API_BASE_URL = import.meta.env.VITE_API_BASE_URL || ''
+
+// API 엔드포인트
+export const API_ENDPOINTS = {
+  // Base
+  base: `${API_BASE_URL}/api`,
+  health: `${API_BASE_URL}/api/health`,
+
+  // Projects
+  projects: `${API_BASE_URL}/api/projects`,
+  projectsAllData: `${API_BASE_URL}/api/projects/all-data`,
+
+  // Changes
+  changes: `${API_BASE_URL}/api/changes`,
+
+  // Flow
+  flow: `${API_BASE_URL}/api/flow`,
+  flowChanges: `${API_BASE_URL}/api/flow/changes`,
+
+  // Tasks
+  tasks: `${API_BASE_URL}/api/tasks`,
+
+  // Agents
+  agents: `${API_BASE_URL}/api/agents`,
+
+  // CLI
+  cli: `${API_BASE_URL}/api/cli`,
+  cliSessions: `${API_BASE_URL}/api/cli/sessions`,
+  cliSettings: `${API_BASE_URL}/api/cli/settings`,
+  cliProfiles: `${API_BASE_URL}/api/cli/profiles`,
+
+  // Integrations
+  integrations: `${API_BASE_URL}/api/integrations`,
+
+  // Docs
+  docs: `${API_BASE_URL}/api/docs`,
+
+
+  // AI
+  ai: `${API_BASE_URL}/api/ai`,
+
+  // Git
+  git: `${API_BASE_URL}/api/git`,
+} as const
+
+// WebSocket URL (상대 경로 사용 시 현재 호스트 기반으로 자동 설정)
+export const WS_BASE_URL = import.meta.env.VITE_WS_BASE_URL || ''
+export const WS_ENDPOINT = WS_BASE_URL ? `${WS_BASE_URL}/ws` : '/ws'
+
+// Helper: 동적 URL 생성
+export const buildApiUrl = (path: string): string => {
+  return `${API_BASE_URL}${path.startsWith('/') ? path : `/${path}`}`
+}
+
+// Helper: 프로젝트 관련 URL
+export const projectApiUrl = {
+  changes: (projectId: string) => `${API_ENDPOINTS.projects}/${projectId}/changes`,
+  activate: (projectId: string) => `${API_ENDPOINTS.projects}/${projectId}/activate`,
+  path: (projectId: string) => `${API_ENDPOINTS.projects}/${projectId}/path`,
+  name: (projectId: string) => `${API_ENDPOINTS.projects}/${projectId}/name`,
+}
+
+// Helper: Change 관련 URL
+export const changeApiUrl = {
+  tasks: (changeId: string) => `${API_ENDPOINTS.changes}/${changeId}/tasks`,
+  detail: (changeId: string) => `${API_ENDPOINTS.flowChanges}/${changeId}`,
+  archive: (changeId: string) => `${API_ENDPOINTS.flowChanges}/${changeId}/archive`,
+}
+
+// Helper: CLI 세션 관련 URL
+export const cliApiUrl = {
+  session: (sessionId: string) => `${API_ENDPOINTS.cliSessions}/${sessionId}`,
+  availableProfiles: () => `${API_ENDPOINTS.cliProfiles}/available`,
+}

package/src/constants/error-codes.ts

@@ -0,0 +1,255 @@
+/**
+ * Error Code Definitions with i18n Support
+ * Maps error codes to messages and translations keys
+ * @module constants/error-codes
+ */
+
+import {
+  NetworkErrorCode,
+  ComponentErrorCode,
+  ValidationErrorCode,
+  StateErrorCode,
+  TaskErrorCode,
+  SSEErrorCode,
+  ErrorSeverity,
+  ErrorType,
+  RecoveryActionType,
+} from '@/types/errors'
+
+// =============================================
+// Error Code Registry
+// =============================================
+
+export interface ErrorCodeRegistry {
+  code: string
+  type: ErrorType
+  severity: ErrorSeverity
+  i18nKey: string
+  defaultMessage: string
+  recoveryActions: string[]
+}
+
+/** Registry of all error codes with metadata */
+export const ERROR_CODE_REGISTRY: Record<string, ErrorCodeRegistry> = {
+  // Network Errors (1000-1002)
+  [NetworkErrorCode.CONNECTION_FAILED]: {
+    code: NetworkErrorCode.CONNECTION_FAILED,
+    type: ErrorType.NETWORK,
+    severity: ErrorSeverity.ERROR,
+    i18nKey: 'errors.network.connection_failed',
+    defaultMessage: 'Connection failed. Please check your internet connection.',
+    recoveryActions: [RecoveryActionType.RETRY, RecoveryActionType.IGNORE],
+  },
+  [NetworkErrorCode.REQUEST_TIMEOUT]: {
+    code: NetworkErrorCode.REQUEST_TIMEOUT,
+    type: ErrorType.NETWORK,
+    severity: ErrorSeverity.WARNING,
+    i18nKey: 'errors.network.request_timeout',
+    defaultMessage: 'Request took too long. Please try again.',
+    recoveryActions: [RecoveryActionType.RETRY, RecoveryActionType.SKIP],
+  },
+  [NetworkErrorCode.INVALID_RESPONSE]: {
+    code: NetworkErrorCode.INVALID_RESPONSE,
+    type: ErrorType.NETWORK,
+    severity: ErrorSeverity.ERROR,
+    i18nKey: 'errors.network.invalid_response',
+    defaultMessage: 'Invalid response from server. Please try again.',
+    recoveryActions: [RecoveryActionType.RETRY],
+  },
+
+  // Component Errors (2000-2001)
+  [ComponentErrorCode.RENDER_ERROR]: {
+    code: ComponentErrorCode.RENDER_ERROR,
+    type: ErrorType.COMPONENT,
+    severity: ErrorSeverity.CRITICAL,
+    i18nKey: 'errors.component.render_error',
+    defaultMessage: 'Something went wrong. Please refresh the page.',
+    recoveryActions: [RecoveryActionType.RESET, RecoveryActionType.NAVIGATE],
+  },
+  [ComponentErrorCode.HOOK_ERROR]: {
+    code: ComponentErrorCode.HOOK_ERROR,
+    type: ErrorType.COMPONENT,
+    severity: ErrorSeverity.ERROR,
+    i18nKey: 'errors.component.hook_error',
+    defaultMessage: 'An error occurred in the application. Please try again.',
+    recoveryActions: [RecoveryActionType.RETRY, RecoveryActionType.RESET],
+  },
+
+  // Validation Errors (3000-3001)
+  [ValidationErrorCode.INPUT_VALIDATION_FAILED]: {
+    code: ValidationErrorCode.INPUT_VALIDATION_FAILED,
+    type: ErrorType.VALIDATION,
+    severity: ErrorSeverity.WARNING,
+    i18nKey: 'errors.validation.input_validation_failed',
+    defaultMessage: 'Please check your input and try again.',
+    recoveryActions: [RecoveryActionType.IGNORE],
+  },
+  [ValidationErrorCode.SCHEMA_VALIDATION_FAILED]: {
+    code: ValidationErrorCode.SCHEMA_VALIDATION_FAILED,
+    type: ErrorType.VALIDATION,
+    severity: ErrorSeverity.WARNING,
+    i18nKey: 'errors.validation.schema_validation_failed',
+    defaultMessage: 'Invalid data format. Please try again.',
+    recoveryActions: [RecoveryActionType.IGNORE],
+  },
+
+  // State Errors (4000-4001)
+  [StateErrorCode.STATE_MUTATION_FAILED]: {
+    code: StateErrorCode.STATE_MUTATION_FAILED,
+    type: ErrorType.STATE,
+    severity: ErrorSeverity.ERROR,
+    i18nKey: 'errors.state.mutation_failed',
+    defaultMessage: 'Failed to save changes. Please try again.',
+    recoveryActions: [RecoveryActionType.RETRY, RecoveryActionType.RESET],
+  },
+  [StateErrorCode.CONTEXT_VALUE_MISSING]: {
+    code: StateErrorCode.CONTEXT_VALUE_MISSING,
+    type: ErrorType.STATE,
+    severity: ErrorSeverity.CRITICAL,
+    i18nKey: 'errors.state.context_missing',
+    defaultMessage: 'Application state is missing. Please refresh.',
+    recoveryActions: [RecoveryActionType.RESET, RecoveryActionType.NAVIGATE],
+  },
+
+  // Task Errors (5000-5002)
+  [TaskErrorCode.TASK_EXECUTION_FAILED]: {
+    code: TaskErrorCode.TASK_EXECUTION_FAILED,
+    type: ErrorType.TASK,
+    severity: ErrorSeverity.ERROR,
+    i18nKey: 'errors.task.execution_failed',
+    defaultMessage: 'Task execution failed. Please review the error and try again.',
+    recoveryActions: [RecoveryActionType.RETRY, RecoveryActionType.SKIP],
+  },
+  [TaskErrorCode.SPEC_PARSING_FAILED]: {
+    code: TaskErrorCode.SPEC_PARSING_FAILED,
+    type: ErrorType.TASK,
+    severity: ErrorSeverity.ERROR,
+    i18nKey: 'errors.task.parsing_failed',
+    defaultMessage: 'Failed to parse specification file. Please check the file format.',
+    recoveryActions: [RecoveryActionType.RETRY, RecoveryActionType.REPORT],
+  },
+  [TaskErrorCode.TASK_TIMEOUT]: {
+    code: TaskErrorCode.TASK_TIMEOUT,
+    type: ErrorType.TASK,
+    severity: ErrorSeverity.WARNING,
+    i18nKey: 'errors.task.timeout',
+    defaultMessage: 'Task execution timed out. Please try again.',
+    recoveryActions: [RecoveryActionType.RETRY, RecoveryActionType.SKIP],
+  },
+
+  // SSE Errors (6000-6002)
+  [SSEErrorCode.CONNECTION_LOST]: {
+    code: SSEErrorCode.CONNECTION_LOST,
+    type: ErrorType.SSE,
+    severity: ErrorSeverity.WARNING,
+    i18nKey: 'errors.sse.connection_lost',
+    defaultMessage: 'Connection lost. Reconnecting...',
+    recoveryActions: [RecoveryActionType.RETRY, RecoveryActionType.IGNORE],
+  },
+  [SSEErrorCode.EVENT_PARSING_FAILED]: {
+    code: SSEErrorCode.EVENT_PARSING_FAILED,
+    type: ErrorType.SSE,
+    severity: ErrorSeverity.INFO,
+    i18nKey: 'errors.sse.parsing_failed',
+    defaultMessage: 'Failed to parse server event. Continuing...',
+    recoveryActions: [RecoveryActionType.IGNORE],
+  },
+  [SSEErrorCode.EVENT_HANDLER_ERROR]: {
+    code: SSEErrorCode.EVENT_HANDLER_ERROR,
+    type: ErrorType.SSE,
+    severity: ErrorSeverity.ERROR,
+    i18nKey: 'errors.sse.handler_error',
+    defaultMessage: 'Error processing server event.',
+    recoveryActions: [RecoveryActionType.RETRY, RecoveryActionType.IGNORE],
+  },
+}
+
+// =============================================
+// i18n Translation Keys
+// =============================================
+
+export const ERROR_I18N_KEYS = {
+  errors: {
+    network: {
+      connection_failed: 'errors.network.connection_failed',
+      request_timeout: 'errors.network.request_timeout',
+      invalid_response: 'errors.network.invalid_response',
+    },
+    component: {
+      render_error: 'errors.component.render_error',
+      hook_error: 'errors.component.hook_error',
+    },
+    validation: {
+      input_validation_failed: 'errors.validation.input_validation_failed',
+      schema_validation_failed: 'errors.validation.schema_validation_failed',
+    },
+    state: {
+      mutation_failed: 'errors.state.mutation_failed',
+      context_missing: 'errors.state.context_missing',
+    },
+    task: {
+      execution_failed: 'errors.task.execution_failed',
+      parsing_failed: 'errors.task.parsing_failed',
+      timeout: 'errors.task.timeout',
+    },
+    sse: {
+      connection_lost: 'errors.sse.connection_lost',
+      parsing_failed: 'errors.sse.parsing_failed',
+      handler_error: 'errors.sse.handler_error',
+    },
+  },
+}
+
+// =============================================
+// Utility Functions
+// =============================================
+
+export function getErrorCodeRegistry(code: string): ErrorCodeRegistry | undefined {
+  return ERROR_CODE_REGISTRY[code]
+}
+
+export function getDefaultErrorMessage(code: string): string {
+  const registry = getErrorCodeRegistry(code)
+  return registry?.defaultMessage || 'An error occurred'
+}
+
+export function getErrorI18nKey(code: string): string {
+  const registry = getErrorCodeRegistry(code)
+  return registry?.i18nKey || 'errors.unknown'
+}
+
+export function getErrorSeverity(code: string): ErrorSeverity {
+  const registry = getErrorCodeRegistry(code)
+  return registry?.severity || ErrorSeverity.ERROR
+}
+
+export function getErrorType(code: string): ErrorType {
+  const registry = getErrorCodeRegistry(code)
+  return registry?.type || ErrorType.COMPONENT
+}
+
+export function getRecoveryActions(code: string): string[] {
+  const registry = getErrorCodeRegistry(code)
+  return registry?.recoveryActions || [RecoveryActionType.IGNORE]
+}
+
+/** Get all error codes for a specific type */
+export function getErrorCodesForType(type: ErrorType): string[] {
+  return Object.values(ERROR_CODE_REGISTRY)
+    .filter((registry) => registry.type === type)
+    .map((registry) => registry.code)
+}
+
+/** Get all error codes with a specific severity */
+export function getErrorCodesWithSeverity(severity: ErrorSeverity): string[] {
+  return Object.values(ERROR_CODE_REGISTRY)
+    .filter((registry) => registry.severity === severity)
+    .map((registry) => registry.code)
+}
+
+/** Check if code is recoverable (has recovery actions other than ignore) */
+export function isErrorRecoverable(code: string): boolean {
+  const actions = getRecoveryActions(code)
+  const hasRecoverableActions = actions.some((action) => action !== RecoveryActionType.IGNORE)
+  return hasRecoverableActions
+}