@designbasekorea/ui 0.2.27 → 0.2.29

package/dist/index.esm.js

@@ -5277,7 +5277,7 @@ const Chip = ({ label, size = 'm', variant = 'default', color = 'primary', delet
 };
 Chip.displayName = 'Chip';
 
-/** 유틸 */
+/* ----------------------- 유틸 ----------------------- */
 const clamp = (n, min, max) => Math.max(min, Math.min(max, n));
 const hexToRgb = (hex) => {
     const m = /^#?([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(hex.trim());
@@ -5289,6 +5289,7 @@ const rgbToHex = (r, g, b) => {
     const toHex = (n) => clamp(Math.round(n), 0, 255).toString(16).padStart(2, '0');
     return `#${toHex(r)}${toHex(g)}${toHex(b)}`.toUpperCase();
 };
+/** RGB ↔ HSV (HSV: h[0-360], s[0-100], v[0-100]) */
 const rgbToHsv = (r, g, b) => {
     r /= 255;
     g /= 255;
@@ -5378,6 +5379,7 @@ const rgbToHsl = (r, g, b) => {
     }
     return { h: Math.round(h * 100) / 100, s: Math.round(s * 10000) / 100, l: Math.round(l * 10000) / 100 };
 };
+/* ----------------------- 컴포넌트 ----------------------- */
 const ColorPicker = ({ size = 'm', type = 'dropdown', position = 'bottom-left', value, defaultValue = '#006FFF', showInput = true, showAlpha = true, showFormatSelector = true, showCopyButton = true, disabled = false, readonly = false, onChange, onApply, onCancel, className, }) => {
     /** 내부 상태 (HSV + alpha%) */
     const [h, setH] = useState(211);
@@ -5387,10 +5389,10 @@ const ColorPicker = ({ size = 'm', type = 'dropdown', position = 'bottom-left',
     const [isOpen, setIsOpen] = useState(false);
     const [format, setFormat] = useState('hex');
     const [isCopied, setIsCopied] = useState(false);
-    // 하단 컬러 인풋(문자열), 알파 인풋(문자열) – 엔터로만 확정
+    // 하단 인풋(문자열) — 엔터로만 확정
     const [colorInput, setColorInput] = useState('');
     const [alphaInput, setAlphaInput] = useState('100');
-    // 모달용 임시 상태 (적용/취소 버튼용)
+    // 모달용 임시 상태 (취소 시 되돌리기)
     const [tempColor, setTempColor] = useState('');
     const pickerRef = useRef(null);
     const areaRef = useRef(null);
@@ -5404,12 +5406,13 @@ const ColorPicker = ({ size = 'm', type = 'dropdown', position = 'bottom-left',
             setH(h);
             setS(s);
             setV(v);
-            setColorInput(initial);
-            setAlphaInput('100');
         }
+        // 인풋 초기 표현
+        setColorInput(initial);
+        setAlphaInput('100');
         // eslint-disable-next-line react-hooks/exhaustive-deps
     }, []);
-    /** 외부 value 변화 */
+    /** 외부 value 변화 시(제어형)만 HSV 반영 */
     useEffect(() => {
         if (!value)
             return;
@@ -5425,7 +5428,7 @@ const ColorPicker = ({ size = 'm', type = 'dropdown', position = 'bottom-left',
     const rgb = useMemo(() => hsvToRgb(h, s, v), [h, s, v]);
     const hex = useMemo(() => rgbToHex(rgb.r, rgb.g, rgb.b), [rgb]);
     const hsl = useMemo(() => rgbToHsl(rgb.r, rgb.g, rgb.b), [rgb]);
-    /** 표시 문자열 */
+    /** 포맷 출력 문자열 */
     const formatted = useMemo(() => {
         const alpha = a / 100;
         switch (format) {
@@ -5437,11 +5440,9 @@ const ColorPicker = ({ size = 'm', type = 'dropdown', position = 'bottom-left',
             default: return hex;
         }
     }, [format, hex, rgb, hsl, a]);
-    /** 외부 onChange 및 인풋 동기화 */
+    /** 외부 onChange 알림만 (입력창 동기화는 여기서 하지 않음!) */
     useEffect(() => {
         onChange?.(formatted);
-        setColorInput(formatted.toUpperCase());
-        setAlphaInput(String(a));
         // eslint-disable-next-line react-hooks/exhaustive-deps
     }, [formatted]);
     /** 드롭다운 외부 클릭 닫기 */
@@ -5454,7 +5455,7 @@ const ColorPicker = ({ size = 'm', type = 'dropdown', position = 'bottom-left',
             document.addEventListener('mousedown', handler);
         return () => document.removeEventListener('mousedown', handler);
     }, [isOpen, type]);
-    /** 컬러 필드 핸들링 */
+    /** 컬러 영역 (S x V) 마우스/터치 */
     const updateFromArea = (clientX, clientY) => {
         const el = areaRef.current;
         if (!el)
@@ -5477,25 +5478,26 @@ const ColorPicker = ({ size = 'm', type = 'dropdown', position = 'bottom-left',
         return; const t = e.touches[0]; updateFromArea(t.clientX, t.clientY); };
     const onAreaTouchEnd = () => { dragging.current = false; };
     /** 슬라이더 */
-    const onHueChange = (e) => setH(parseInt(e.target.value, 10));
-    const onAlphaChange = (e) => {
+    const onHueChange = useCallback((e) => setH(parseInt(e.target.value, 10)), []);
+    const onAlphaChange = useCallback((e) => {
         const newAlpha = parseInt(e.target.value, 10);
         setA(newAlpha);
-        setAlphaInput(String(newAlpha)); // 실시간 동기화
-    };
-    /** 컬러 인풋: 엔터로만 확정 */
-    const tryCommitColorInput = () => {
+        setAlphaInput(String(newAlpha)); // 슬라이더 ↔ 인풋 동기화(표시만)
+    }, []);
+    /** 컬러 텍스트 인풋: 엔터로만 확정 */
+    const commitColorInput = useCallback(() => {
         const str = colorInput.trim();
-        // HEX
+        // HEX (#RRGGBB)
         if (/^#([0-9A-Fa-f]{6})$/.test(str)) {
             const rgb = hexToRgb(str);
             const hsv = rgbToHsv(rgb.r, rgb.g, rgb.b);
             setH(hsv.h);
             setS(hsv.s);
             setV(hsv.v);
+            setColorInput(str.toUpperCase());
             return;
         }
-        // rgb()
+        // rgb(r,g,b)
         let m = /^rgb\(\s*(\d{1,3})\s*,\s*(\d{1,3})\s*,\s*(\d{1,3})\s*\)$/i.exec(str);
         if (m) {
             const r = clamp(parseInt(m[1], 10), 0, 255);
@@ -5505,9 +5507,10 @@ const ColorPicker = ({ size = 'm', type = 'dropdown', position = 'bottom-left',
             setH(hsv.h);
             setS(hsv.s);
             setV(hsv.v);
+            setColorInput(`rgb(${r}, ${g}, ${b})`.toUpperCase());
             return;
         }
-        // rgba()
+        // rgba(r,g,b,a)
         m = /^rgba\(\s*(\d{1,3})\s*,\s*(\d{1,3})\s*,\s*(\d{1,3})\s*,\s*(0|1|0?\.\d+)\s*\)$/i.exec(str);
         if (m) {
             const r = clamp(parseInt(m[1], 10), 0, 255);
@@ -5519,39 +5522,42 @@ const ColorPicker = ({ size = 'm', type = 'dropdown', position = 'bottom-left',
             setS(hsv.s);
             setV(hsv.v);
             setA(Math.round(alpha * 100));
+            setAlphaInput(String(Math.round(alpha * 100)));
+            setColorInput(`rgba(${r}, ${g}, ${b}, ${alpha})`.toUpperCase());
             return;
         }
-        // 실패 → 원래 값으로 복구
+        // 잘못된 값 → 원복
         setColorInput(formatted.toUpperCase());
-    };
+    }, [colorInput, formatted]);
     const onColorKeyDown = (e) => {
         if (e.key === 'Enter')
-            tryCommitColorInput();
+            commitColorInput();
     };
     const onColorBlur = () => {
-        // 요구사항: 엔터로만 변경. 블러 시에는 값 복구만.
+        // 요구사항: 엔터로만 반영, 블러 시엔 원복
         setColorInput(formatted.toUpperCase());
     };
-    /** 알파 인풋: 엔터로만 확정 (0-100) */
-    const tryCommitAlphaInput = () => {
+    /** 알파 인풋: 엔터로만 확정 (0~100) */
+    const commitAlphaInput = useCallback(() => {
         const n = Number(alphaInput.trim());
         if (!Number.isNaN(n) && n >= 0 && n <= 100) {
             setA(Math.round(n));
+            setAlphaInput(String(Math.round(n)));
             return;
         }
-        // 실패 → 복구
+        // 잘못된 값 → 원복
         setAlphaInput(String(a));
-    };
+    }, [alphaInput, a]);
     const onAlphaInputKeyDown = (e) => {
         if (e.key === 'Enter')
-            tryCommitAlphaInput();
+            commitAlphaInput();
     };
     const onAlphaInputBlur = () => {
-        // 엔터로만 반영. 블러 시 복원.
+        // 엔터로만 반영, 블러 시 원복
         setAlphaInput(String(a));
     };
     /** 복사 */
-    const onCopy = async () => {
+    const onCopy = useCallback(async () => {
         try {
             await navigator.clipboard.writeText(formatted);
             setIsCopied(true);
@@ -5560,9 +5566,9 @@ const ColorPicker = ({ size = 'm', type = 'dropdown', position = 'bottom-left',
         catch (e) {
             console.error(e);
         }
-    };
+    }, [formatted]);
     /** EyeDropper */
-    const onEyedrop = async () => {
+    const onEyedrop = useCallback(async () => {
         try {
             if ('EyeDropper' in window) {
                 const eye = new window.EyeDropper();
@@ -5580,23 +5586,21 @@ const ColorPicker = ({ size = 'm', type = 'dropdown', position = 'bottom-left',
         catch (e) {
             console.error(e);
         }
-    };
-    /** 모달용 핸들러 */
-    const handleModalOpen = () => {
-        if (type === 'modal') {
-            setTempColor(formatted);
-        }
+    }, []);
+    /** 모달 열기/적용/취소 (deps에서 formatted 제거 → 재생성 방지) */
+    const handleModalOpen = useCallback(() => {
+        if (type === 'modal')
+            setTempColor(hex); // 현재 HEX 저장
         setIsOpen(true);
-    };
-    const handleModalApply = () => {
+    }, [type, hex]);
+    const handleModalApply = useCallback(() => {
         if (type === 'modal') {
             onApply?.(formatted);
             setIsOpen(false);
         }
-    };
-    const handleModalCancel = () => {
+    }, [type, formatted, onApply]);
+    const handleModalCancel = useCallback(() => {
         if (type === 'modal') {
-            // 원래 색상으로 복원
             const rgb = hexToRgb(tempColor);
             if (rgb) {
                 const { h, s, v } = rgbToHsv(rgb.r, rgb.g, rgb.b);
@@ -5607,9 +5611,9 @@ const ColorPicker = ({ size = 'm', type = 'dropdown', position = 'bottom-left',
             onCancel?.();
             setIsOpen(false);
         }
-    };
-    /** 배경 스타일 */
-    const hueTrackStyle = {
+    }, [type, tempColor, onCancel]);
+    /** 배경 스타일들 */
+    const hueTrackStyle = useMemo(() => ({
         background: `linear-gradient(to right,
       hsl(0,100%,50%),
       hsl(60,100%,50%),
@@ -5618,15 +5622,16 @@ const ColorPicker = ({ size = 'm', type = 'dropdown', position = 'bottom-left',
       hsl(240,100%,50%),
       hsl(300,100%,50%),
       hsl(360,100%,50%))`,
-    };
-    const areaBackground = {
+    }), []);
+    // 상단 좌→우: 채도 증가 / 상단→하단: 밝기 감소
+    const areaBackground = useMemo(() => ({
         backgroundImage: `
       linear-gradient(to top, rgba(0,0,0,1), rgba(0,0,0,0)),
       linear-gradient(to right, #ffffff, hsl(${h}, 100%, 50%))
     `,
-    };
-    /** ✔︎ 알파 트랙: 색상 무관, 고정 흑백 그라디언트 */
-    const alphaTrackStyle = {
+    }), [h]);
+    // ✔ 고정 흑백 알파 트랙 (색상 무관)
+    const alphaTrackStyle = useMemo(() => ({
         backgroundImage: `
       linear-gradient(45deg, var(--db-border-base) 25%, transparent 25%),
       linear-gradient(-45deg, var(--db-border-base) 25%, transparent 25%),
@@ -5637,22 +5642,22 @@ const ColorPicker = ({ size = 'm', type = 'dropdown', position = 'bottom-left',
         backgroundSize: '8px 8px,8px 8px,8px 8px,8px 8px,100% 100%',
         backgroundPosition: '0 0,0 4px,4px -4px,-4px 0,0 0',
         backgroundColor: 'var(--db-surface-base)',
-    };
+    }), []);
     const classes = clsx('designbase-color-picker', `designbase-color-picker--${size}`, `designbase-color-picker--${position}`, {
         'designbase-color-picker--disabled': disabled,
         'designbase-color-picker--readonly': readonly,
         'designbase-color-picker--open': isOpen,
         'designbase-color-picker--no-input': !showInput,
     }, className);
-    const Trigger = (jsxs("div", { className: "designbase-color-picker__trigger", onClick: () => !disabled && !readonly && handleModalOpen(), children: [jsx("div", { className: "designbase-color-picker__color-display", children: jsx("div", { className: "designbase-color-picker__color-box", style: { backgroundColor: showAlpha ? `rgba(${rgb.r}, ${rgb.g}, ${rgb.b}, ${a / 100})` : hex } }) }), showInput && (jsx("input", { type: "text", value: colorInput, onChange: (e) => setColorInput(e.target.value), onKeyDown: onColorKeyDown, onBlur: onColorBlur, onClick: (e) => e.stopPropagation(), disabled: disabled, readOnly: readonly, className: "designbase-color-picker__input", placeholder: "#000000" })), showInput && showCopyButton && (jsx("button", { type: "button", className: "designbase-color-picker__copy-button-inline", onClick: (e) => { e.stopPropagation(); onCopy(); }, disabled: disabled, "aria-label": "Copy color value", children: isCopied ? jsx(DoneIcon$1, { size: 14 }) : jsx(CopyIcon, { size: 14 }) })), jsx("button", { type: "button", className: "designbase-color-picker__toggle", disabled: disabled, "aria-label": "Toggle color picker", children: jsx(ChevronDownIcon, { size: 16 }) })] }));
-    const Selector = (jsxs("div", { className: "designbase-color-picker__selector", children: [jsx("div", { className: "designbase-color-picker__color-area", children: jsx("div", { ref: areaRef, className: "designbase-color-picker__color-field", style: areaBackground, onMouseDown: onAreaMouseDown, onMouseMove: onAreaMouseMove, onMouseUp: onAreaMouseUp, onMouseLeave: onAreaLeave, onTouchStart: onAreaTouchStart, onTouchMove: onAreaTouchMove, onTouchEnd: onAreaTouchEnd, children: jsx("div", { className: "designbase-color-picker__color-pointer", style: { left: `${s}%`, top: `${100 - v}%`, backgroundColor: `rgb(${rgb.r}, ${rgb.g}, ${rgb.b})` } }) }) }), jsxs("div", { className: "designbase-color-picker__controls", children: [jsx(Button, { variant: "tertiary", size: "m", iconOnly: true, onClick: onEyedrop, "aria-label": "Eyedropper tool", children: jsx(EyedropperIcon, {}) }), jsxs("div", { className: "designbase-color-picker__slider-container", children: [jsx("div", { className: "designbase-color-picker__hue-slider", children: jsx("input", { type: "range", min: 0, max: 360, value: h, onChange: onHueChange, className: "designbase-color-picker__slider designbase-color-picker__slider--hue", style: hueTrackStyle }) }), showAlpha && (jsx("div", { className: "designbase-color-picker__alpha-slider", children: jsx("input", { type: "range", min: 0, max: 100, value: a, onChange: onAlphaChange, className: "designbase-color-picker__slider designbase-color-picker__slider--alpha", style: alphaTrackStyle }) }))] })] }), jsxs("div", { className: "designbase-color-picker__value-display", children: [showFormatSelector && (jsx(Select, { value: format, onChange: (v) => setFormat(v), showClearButton: false, position: "top", options: [
+    const Trigger = (jsxs("div", { className: "designbase-color-picker__trigger", onClick: () => !disabled && !readonly && (type === 'modal' ? handleModalOpen() : setIsOpen(v => !v)), children: [jsx("div", { className: "designbase-color-picker__color-display", children: jsx("div", { className: "designbase-color-picker__color-box", style: { backgroundColor: showAlpha ? `rgba(${rgb.r}, ${rgb.g}, ${rgb.b}, ${a / 100})` : hex } }) }), showInput && (jsx("input", { type: "text", value: colorInput, onChange: (e) => setColorInput(e.target.value), onKeyDown: onColorKeyDown, onBlur: onColorBlur, onClick: (e) => e.stopPropagation(), disabled: disabled, readOnly: readonly, className: "designbase-color-picker__input", placeholder: "#000000" })), showInput && showCopyButton && (jsx("button", { type: "button", className: "designbase-color-picker__copy-button-inline", onClick: (e) => { e.stopPropagation(); onCopy(); }, disabled: disabled, "aria-label": "Copy color value", children: isCopied ? jsx(DoneIcon$1, { size: 14 }) : jsx(CopyIcon, { size: 14 }) })), jsx("button", { type: "button", className: "designbase-color-picker__toggle", disabled: disabled, "aria-label": "Toggle color picker", children: jsx(ChevronDownIcon, { size: 16 }) })] }));
+    const Selector = (jsxs("div", { className: "designbase-color-picker__selector", children: [jsx("div", { className: "designbase-color-picker__color-area", children: jsx("div", { ref: areaRef, className: "designbase-color-picker__color-field", style: areaBackground, onMouseDown: onAreaMouseDown, onMouseMove: onAreaMouseMove, onMouseUp: onAreaMouseUp, onMouseLeave: onAreaLeave, onTouchStart: onAreaTouchStart, onTouchMove: onAreaTouchMove, onTouchEnd: onAreaTouchEnd, children: jsx("div", { className: "designbase-color-picker__color-pointer", style: { left: `${s}%`, top: `${100 - v}%`, backgroundColor: `rgb(${rgb.r}, ${rgb.g}, ${rgb.b})` } }) }) }), jsxs("div", { className: "designbase-color-picker__controls", children: [jsx(Button, { variant: "tertiary", size: "m", iconOnly: true, onClick: onEyedrop, "aria-label": "Eyedropper tool", children: jsx(EyedropperIcon, {}) }), jsxs("div", { className: "designbase-color-picker__slider-container", children: [jsx("div", { className: "designbase-color-picker__hue-slider", children: jsx("input", { type: "range", min: 0, max: 360, value: h, onChange: onHueChange, className: "designbase-color-picker__slider designbase-color-picker__slider--hue", style: hueTrackStyle }) }), showAlpha && (jsx("div", { className: "designbase-color-picker__alpha-slider", children: jsx("input", { type: "range", min: 0, max: 100, value: a, onChange: onAlphaChange, className: "designbase-color-picker__slider designbase-color-picker__slider--alpha", style: alphaTrackStyle }) }))] })] }), jsxs("div", { className: "designbase-color-picker__value-display", children: [showFormatSelector && (jsx(Select, { value: format, onChange: (v) => setFormat(v), showClearButton: false, options: [
                             { label: 'HEX', value: 'hex' },
                             { label: 'RGB', value: 'rgb' },
                             { label: 'RGBA', value: 'rgba' },
                             { label: 'HSL', value: 'hsl' },
                             { label: 'HSLA', value: 'hsla' },
-                        ], size: "s" })), jsx(Input, { type: "text", value: colorInput, onChange: setColorInput, onKeyDown: onColorKeyDown, onBlur: onColorBlur, placeholder: "#000000", size: "s", className: "designbase-color-picker__value-input" }), showAlpha && (jsxs("div", { className: "designbase-color-picker__alpha-input-wrap", children: [jsx(Input, { type: "text", inputMode: "numeric", value: alphaInput, onChange: (value) => setAlphaInput(value.replace(/[^\d]/g, '').slice(0, 3)), onKeyDown: onAlphaInputKeyDown, onBlur: onAlphaInputBlur, placeholder: "100", size: "s", className: "designbase-color-picker__alpha-input", "aria-label": "Alpha percent" }), jsx("span", { className: "designbase-color-picker__alpha-suffix", children: "%" })] })), showCopyButton && (jsx(Button, { variant: "tertiary", size: "m", iconOnly: true, onClick: onCopy, "aria-label": "Copy color value", children: isCopied ? jsx(DoneIcon$1, {}) : jsx(CopyIcon, {}) }))] })] }));
-    return (jsxs("div", { ref: pickerRef, className: classes, children: [Trigger, type === 'dropdown' && isOpen && (jsx("div", { className: "designbase-color-picker__dropdown", onClick: (e) => e.stopPropagation(), children: Selector })), type === 'modal' && (jsxs(Modal, { isOpen: isOpen, onClose: handleModalCancel, title: "\uC0C9\uC0C1 \uC120\uD0DD", size: "s", children: [jsx(ModalBody, { children: Selector }), jsx(ModalFooter, { children: jsxs("div", { style: { display: 'flex', gap: '8px', justifyContent: 'flex-end' }, children: [jsx(Button, { variant: "tertiary", size: "s", onClick: handleModalCancel, children: "\uCDE8\uC18C" }), jsx(Button, { variant: "primary", size: "s", onClick: handleModalApply, children: "\uC801\uC6A9" })] }) })] }))] }));
+                        ], size: "s", position: "top" })), jsx(Input, { type: "text", value: colorInput, onChange: setColorInput, onKeyDown: onColorKeyDown, onBlur: onColorBlur, placeholder: "#000000", size: "s", className: "designbase-color-picker__value-input" }), showAlpha && (jsxs("div", { className: "designbase-color-picker__alpha-input-wrap", children: [jsx(Input, { type: "text", inputMode: "numeric", value: alphaInput, onChange: (value) => setAlphaInput(value.replace(/[^\d]/g, '').slice(0, 3)), onKeyDown: onAlphaInputKeyDown, onBlur: onAlphaInputBlur, placeholder: "100", size: "s", className: "designbase-color-picker__alpha-input", "aria-label": "Alpha percent" }), jsx("span", { className: "designbase-color-picker__alpha-suffix", children: "%" })] })), showCopyButton && (jsx(Button, { variant: "tertiary", size: "m", iconOnly: true, onClick: onCopy, "aria-label": "Copy color value", children: isCopied ? jsx(DoneIcon$1, {}) : jsx(CopyIcon, {}) }))] })] }));
+    return (jsxs("div", { ref: pickerRef, className: classes, children: [Trigger, type === 'dropdown' && isOpen && (jsx("div", { className: "designbase-color-picker__dropdown", onClick: (e) => e.stopPropagation(), children: Selector })), type === 'modal' && (jsxs(Modal, { isOpen: isOpen, onClose: handleModalCancel, title: "\uC0C9\uC0C1 \uC120\uD0DD", size: "s", children: [jsx(ModalBody, { children: Selector }), jsx(ModalFooter, { children: jsxs("div", { style: { display: 'flex', gap: 8, justifyContent: 'flex-end' }, children: [jsx(Button, { variant: "tertiary", size: "s", onClick: handleModalCancel, children: "\uCDE8\uC18C" }), jsx(Button, { variant: "primary", size: "s", onClick: handleModalApply, children: "\uC801\uC6A9" })] }) })] }))] }));
 };
 ColorPicker.displayName = 'ColorPicker';