"use client"; /** * UnifiedSelect * * 통합 선택 컴포넌트 * - dropdown: 드롭다운 선택 * - radio: 라디오 버튼 그룹 * - check: 체크박스 그룹 * - tag: 태그 선택 * - toggle: 토글 스위치 * - swap: 스왑 선택 (좌우 이동) */ import React, { forwardRef, useCallback, useContext, useEffect, useMemo, useState } from "react"; import { Label } from "@/components/ui/label"; import { RadioGroup, RadioGroupItem } from "@/components/ui/radio-group"; import { Checkbox } from "@/components/ui/checkbox"; import { Switch } from "@/components/ui/switch"; import { Badge } from "@/components/ui/badge"; import { Button } from "@/components/ui/button"; import { Command, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList } from "@/components/ui/command"; import { Popover, PopoverContent, PopoverTrigger } from "@/components/ui/popover"; import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from "@/components/ui/select"; import { cn } from "@/lib/utils"; import { UnifiedSelectProps, SelectOption } from "@/types/unified-components"; import { Check, ChevronsUpDown, X, ArrowLeftRight } from "lucide-react"; import { apiClient } from "@/lib/api/client"; import UnifiedFormContext from "./UnifiedFormContext"; /** * 드롭다운 선택 컴포넌트 */ const DropdownSelect = forwardRef void; placeholder?: string; searchable?: boolean; multiple?: boolean; maxSelect?: number; allowClear?: boolean; disabled?: boolean; className?: string; }>(({ options, value, onChange, placeholder = "선택", searchable, multiple, maxSelect, allowClear = true, disabled, className }, ref) => { const [open, setOpen] = useState(false); // 단일 선택 + 검색 불가능 → 기본 Select 사용 if (!searchable && !multiple) { return ( ); } // 검색 가능 또는 다중 선택 → Combobox 사용 const selectedValues = useMemo(() => { if (!value) return []; return Array.isArray(value) ? value : [value]; }, [value]); const selectedLabels = useMemo(() => { return selectedValues .map((v) => options.find((o) => o.value === v)?.label) .filter(Boolean) as string[]; }, [selectedValues, options]); const handleSelect = useCallback((selectedValue: string) => { if (multiple) { const newValues = selectedValues.includes(selectedValue) ? selectedValues.filter((v) => v !== selectedValue) : maxSelect && selectedValues.length >= maxSelect ? selectedValues : [...selectedValues, selectedValue]; onChange?.(newValues); } else { onChange?.(selectedValue); setOpen(false); } }, [multiple, selectedValues, maxSelect, onChange]); const handleClear = useCallback((e: React.MouseEvent) => { e.stopPropagation(); onChange?.(multiple ? [] : ""); }, [multiple, onChange]); return ( { // value는 CommandItem의 value (라벨) // search는 검색어 if (!search) return 1; const normalizedValue = value.toLowerCase(); const normalizedSearch = search.toLowerCase(); if (normalizedValue.includes(normalizedSearch)) return 1; return 0; }} > {searchable && } 검색 결과가 없습니다. {options.map((option) => { const displayLabel = option.label || option.value || "(빈 값)"; return ( handleSelect(option.value)} > {displayLabel} ); })} ); }); DropdownSelect.displayName = "DropdownSelect"; /** * 라디오 선택 컴포넌트 */ const RadioSelect = forwardRef void; disabled?: boolean; className?: string; }>(({ options, value, onChange, disabled, className }, ref) => { return ( {options.map((option) => (
))}
); }); RadioSelect.displayName = "RadioSelect"; /** * 체크박스 선택 컴포넌트 */ const CheckSelect = forwardRef void; maxSelect?: number; disabled?: boolean; className?: string; }>(({ options, value = [], onChange, maxSelect, disabled, className }, ref) => { const handleChange = useCallback((optionValue: string, checked: boolean) => { if (checked) { if (maxSelect && value.length >= maxSelect) return; onChange?.([...value, optionValue]); } else { onChange?.(value.filter((v) => v !== optionValue)); } }, [value, maxSelect, onChange]); return (
{options.map((option) => (
handleChange(option.value, checked as boolean)} disabled={disabled || (maxSelect && value.length >= maxSelect && !value.includes(option.value))} />
))}
); }); CheckSelect.displayName = "CheckSelect"; /** * 태그 선택 컴포넌트 */ const TagSelect = forwardRef void; maxSelect?: number; disabled?: boolean; className?: string; }>(({ options, value = [], onChange, maxSelect, disabled, className }, ref) => { const handleToggle = useCallback((optionValue: string) => { const isSelected = value.includes(optionValue); if (isSelected) { onChange?.(value.filter((v) => v !== optionValue)); } else { if (maxSelect && value.length >= maxSelect) return; onChange?.([...value, optionValue]); } }, [value, maxSelect, onChange]); return (
{options.map((option) => { const isSelected = value.includes(option.value); return ( !disabled && handleToggle(option.value)} > {option.label} {isSelected && } ); })}
); }); TagSelect.displayName = "TagSelect"; /** * 토글 선택 컴포넌트 (Boolean용) */ const ToggleSelect = forwardRef void; disabled?: boolean; className?: string; }>(({ options, value, onChange, disabled, className }, ref) => { // 토글은 2개 옵션만 지원 const [offOption, onOption] = options.length >= 2 ? [options[0], options[1]] : [{ value: "false", label: "아니오" }, { value: "true", label: "예" }]; const isOn = value === onOption.value; return (
{offOption.label} onChange?.(checked ? onOption.value : offOption.value)} disabled={disabled} /> {onOption.label}
); }); ToggleSelect.displayName = "ToggleSelect"; /** * 스왑 선택 컴포넌트 (좌우 이동 방식) */ const SwapSelect = forwardRef void; maxSelect?: number; disabled?: boolean; className?: string; }>(({ options, value = [], onChange, disabled, className }, ref) => { const available = useMemo(() => options.filter((o) => !value.includes(o.value)), [options, value] ); const selected = useMemo(() => options.filter((o) => value.includes(o.value)), [options, value] ); const handleMoveRight = useCallback((optionValue: string) => { onChange?.([...value, optionValue]); }, [value, onChange]); const handleMoveLeft = useCallback((optionValue: string) => { onChange?.(value.filter((v) => v !== optionValue)); }, [value, onChange]); const handleMoveAllRight = useCallback(() => { onChange?.(options.map((o) => o.value)); }, [options, onChange]); const handleMoveAllLeft = useCallback(() => { onChange?.([]); }, [onChange]); return (
{/* 왼쪽: 선택 가능 */}
선택 가능
{available.map((option) => (
!disabled && handleMoveRight(option.value)} > {option.label}
))} {available.length === 0 && (
항목 없음
)}
{/* 중앙: 이동 버튼 */}
{/* 오른쪽: 선택됨 */}
선택됨
{selected.map((option) => (
!disabled && handleMoveLeft(option.value)} > {option.label}
))} {selected.length === 0 && (
선택 없음
)}
); }); SwapSelect.displayName = "SwapSelect"; /** * 메인 UnifiedSelect 컴포넌트 */ export const UnifiedSelect = forwardRef( (props, ref) => { const { id, label, required, readonly, disabled, style, size, config: configProp, value, onChange, } = props; // config가 없으면 기본값 사용 const config = configProp || { mode: "dropdown" as const, source: "static" as const, options: [] }; const [options, setOptions] = useState(config.options || []); const [loading, setLoading] = useState(false); const [optionsLoaded, setOptionsLoaded] = useState(false); // 옵션 로딩에 필요한 값들만 추출 (객체 참조 대신 원시값 사용) // category 소스는 code로 자동 변환 (카테고리 → 공통코드 통합) const rawSource = config.source; const categoryTable = (config as any).categoryTable; const categoryColumn = (config as any).categoryColumn; // category 소스인 경우 code로 변환하고 codeGroup을 자동 생성 const source = rawSource === "category" ? "code" : rawSource; const codeGroup = rawSource === "category" && categoryTable && categoryColumn ? `${categoryTable.toUpperCase()}_${categoryColumn.toUpperCase()}` : config.codeGroup; const entityTable = config.entityTable; const entityValueColumn = config.entityValueColumn || config.entityValueField; const entityLabelColumn = config.entityLabelColumn || config.entityLabelField; const table = config.table; const valueColumn = config.valueColumn; const labelColumn = config.labelColumn; const apiEndpoint = config.apiEndpoint; const staticOptions = config.options; // 계층 코드 연쇄 선택 관련 const hierarchical = config.hierarchical; const parentField = config.parentField; // FormContext에서 부모 필드 값 가져오기 (Context가 없으면 null) const formContext = useContext(UnifiedFormContext); // 부모 필드의 값 계산 const parentValue = useMemo(() => { if (!hierarchical || !parentField) return null; // FormContext가 있으면 거기서 값 가져오기 if (formContext) { const val = formContext.getValue(parentField); return val as string | null; } return null; }, [hierarchical, parentField, formContext]); // 데이터 소스에 따른 옵션 로딩 (원시값 의존성만 사용) useEffect(() => { // 계층 구조인 경우 부모 값이 변경되면 다시 로드 if (hierarchical && source === "code") { setOptionsLoaded(false); } }, [parentValue, hierarchical, source]); useEffect(() => { // 이미 로드된 경우 스킵 (static 제외, 계층 구조 제외) if (optionsLoaded && source !== "static") { return; } const loadOptions = async () => { if (source === "static") { setOptions(staticOptions || []); setOptionsLoaded(true); return; } setLoading(true); try { let fetchedOptions: SelectOption[] = []; if (source === "code" && codeGroup) { // 계층 구조 사용 시 자식 코드만 로드 if (hierarchical) { const params = new URLSearchParams(); if (parentValue) { params.append("parentCodeValue", parentValue); } const queryString = params.toString(); const url = `/common-codes/categories/${codeGroup}/children${queryString ? `?${queryString}` : ""}`; const response = await apiClient.get(url); const data = response.data; if (data.success && data.data) { fetchedOptions = data.data.map((item: { value: string; label: string; hasChildren: boolean }) => ({ value: item.value, label: item.label, })); } } else { // 일반 공통코드에서 로드 (올바른 API 경로: /common-codes/categories/:categoryCode/options) const response = await apiClient.get(`/common-codes/categories/${codeGroup}/options`); const data = response.data; if (data.success && data.data) { fetchedOptions = data.data.map((item: { value: string; label: string }) => ({ value: item.value, label: item.label, })); } } } else if (source === "db" && table) { // DB 테이블에서 로드 const response = await apiClient.get(`/entity/${table}/options`, { params: { value: valueColumn || "id", label: labelColumn || "name", }, }); const data = response.data; if (data.success && data.data) { fetchedOptions = data.data; } } else if (source === "entity" && entityTable) { // 엔티티(참조 테이블)에서 로드 const valueCol = entityValueColumn || "id"; const labelCol = entityLabelColumn || "name"; const response = await apiClient.get(`/entity/${entityTable}/options`, { params: { value: valueCol, label: labelCol, }, }); const data = response.data; if (data.success && data.data) { fetchedOptions = data.data; } } else if (source === "api" && apiEndpoint) { // 외부 API에서 로드 const response = await apiClient.get(apiEndpoint); const data = response.data; if (Array.isArray(data)) { fetchedOptions = data; } } setOptions(fetchedOptions); setOptionsLoaded(true); } catch (error) { console.error("옵션 로딩 실패:", error); setOptions([]); } finally { setLoading(false); } }; loadOptions(); }, [source, entityTable, entityValueColumn, entityLabelColumn, codeGroup, table, valueColumn, labelColumn, apiEndpoint, staticOptions, optionsLoaded, hierarchical, parentValue]); // 모드별 컴포넌트 렌더링 const renderSelect = () => { if (loading) { return
로딩 중...
; } const isDisabled = disabled || readonly; switch (config.mode) { case "dropdown": return ( ); case "radio": return ( onChange?.(v)} disabled={isDisabled} /> ); case "check": return ( ); case "tag": return ( ); case "toggle": return ( onChange?.(v)} disabled={isDisabled} /> ); case "swap": return ( ); default: return ( ); } }; const showLabel = label && style?.labelDisplay !== false; const componentWidth = size?.width || style?.width; const componentHeight = size?.height || style?.height; return (
{showLabel && ( )}
{renderSelect()}
); } ); UnifiedSelect.displayName = "UnifiedSelect"; export default UnifiedSelect;