@designbasekorea/ui 0.2.28 → 0.2.29

package/dist/index.umd.js

@@ -5278,7 +5278,7 @@
     };
     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());
@@ -5290,6 +5290,7 @@
         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;
@@ -5379,6 +5380,7 @@
         }
         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] = React.useState(211);
@@ -5388,10 +5390,10 @@
         const [isOpen, setIsOpen] = React.useState(false);
         const [format, setFormat] = React.useState('hex');
         const [isCopied, setIsCopied] = React.useState(false);
-        // 하단 컬러 인풋(문자열), 알파 인풋(문자열) – 엔터로만 확정
+        // 하단 인풋(문자열) — 엔터로만 확정
         const [colorInput, setColorInput] = React.useState('');
         const [alphaInput, setAlphaInput] = React.useState('100');
-        // 모달용 임시 상태 (적용/취소 버튼용)
+        // 모달용 임시 상태 (취소 시 되돌리기)
         const [tempColor, setTempColor] = React.useState('');
         const pickerRef = React.useRef(null);
         const areaRef = React.useRef(null);
@@ -5405,12 +5407,13 @@
                 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 반영 */
         React.useEffect(() => {
             if (!value)
                 return;
@@ -5426,7 +5429,7 @@
         const rgb = React.useMemo(() => hsvToRgb(h, s, v), [h, s, v]);
         const hex = React.useMemo(() => rgbToHex(rgb.r, rgb.g, rgb.b), [rgb]);
         const hsl = React.useMemo(() => rgbToHsl(rgb.r, rgb.g, rgb.b), [rgb]);
-        /** 표시 문자열 */
+        /** 포맷 출력 문자열 */
         const formatted = React.useMemo(() => {
             const alpha = a / 100;
             switch (format) {
@@ -5438,11 +5441,9 @@
                 default: return hex;
             }
         }, [format, hex, rgb, hsl, a]);
-        /** 외부 onChange 및 인풋 동기화 */
+        /** 외부 onChange 알림만 (입력창 동기화는 여기서 하지 않음!) */
         React.useEffect(() => {
             onChange?.(formatted);
-            setColorInput(formatted.toUpperCase());
-            setAlphaInput(String(a));
             // eslint-disable-next-line react-hooks/exhaustive-deps
         }, [formatted]);
         /** 드롭다운 외부 클릭 닫기 */
@@ -5455,7 +5456,7 @@
                 document.addEventListener('mousedown', handler);
             return () => document.removeEventListener('mousedown', handler);
         }, [isOpen, type]);
-        /** 컬러 필드 핸들링 */
+        /** 컬러 영역 (S x V) 마우스/터치 */
         const updateFromArea = (clientX, clientY) => {
             const el = areaRef.current;
             if (!el)
@@ -5478,27 +5479,26 @@
             return; const t = e.touches[0]; updateFromArea(t.clientX, t.clientY); };
         const onAreaTouchEnd = () => { dragging.current = false; };
         /** 슬라이더 */
-        const onHueChange = React.useCallback((e) => {
-            setH(parseInt(e.target.value, 10));
-        }, []);
+        const onHueChange = React.useCallback((e) => setH(parseInt(e.target.value, 10)), []);
         const onAlphaChange = React.useCallback((e) => {
             const newAlpha = parseInt(e.target.value, 10);
             setA(newAlpha);
-            setAlphaInput(String(newAlpha)); // 실시간 동기화
+            setAlphaInput(String(newAlpha)); // 슬라이더 ↔ 인풋 동기화(표시만)
         }, []);
-        /** 컬러 인풋: 엔터로만 확정 */
-        const tryCommitColorInput = () => {
+        /** 컬러 텍스트 인풋: 엔터로만 확정 */
+        const commitColorInput = React.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);
@@ -5508,9 +5508,10 @@
                 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);
@@ -5522,35 +5523,38 @@
                 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 = React.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));
         };
         /** 복사 */
@@ -5584,13 +5588,12 @@
                 console.error(e);
             }
         }, []);
-        /** 모달용 핸들러 */
+        /** 모달 열기/적용/취소 (deps에서 formatted 제거 → 재생성 방지) */
         const handleModalOpen = React.useCallback(() => {
-            if (type === 'modal') {
-                setTempColor(formatted);
-            }
+            if (type === 'modal')
+                setTempColor(hex); // 현재 HEX 저장
             setIsOpen(true);
-        }, [type, formatted]);
+        }, [type, hex]);
         const handleModalApply = React.useCallback(() => {
             if (type === 'modal') {
                 onApply?.(formatted);
@@ -5599,7 +5602,6 @@
         }, [type, formatted, onApply]);
         const handleModalCancel = React.useCallback(() => {
             if (type === 'modal') {
-                // 원래 색상으로 복원
                 const rgb = hexToRgb(tempColor);
                 if (rgb) {
                     const { h, s, v } = rgbToHsv(rgb.r, rgb.g, rgb.b);
@@ -5611,7 +5613,7 @@
                 setIsOpen(false);
             }
         }, [type, tempColor, onCancel]);
-        /** 배경 스타일 */
+        /** 배경 스타일들 */
         const hueTrackStyle = React.useMemo(() => ({
             background: `linear-gradient(to right,
       hsl(0,100%,50%),
@@ -5622,13 +5624,14 @@
       hsl(300,100%,50%),
       hsl(360,100%,50%))`,
         }), []);
+        // 상단 좌→우: 채도 증가 / 상단→하단: 밝기 감소
         const areaBackground = React.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%))
     `,
         }), [h]);
-        /** ✔︎ 알파 트랙: 색상 무관, 고정 흑백 그라디언트 */
+        // ✔ 고정 흑백 알파 트랙 (색상 무관)
         const alphaTrackStyle = React.useMemo(() => ({
             backgroundImage: `
       linear-gradient(45deg, var(--db-border-base) 25%, transparent 25%),
@@ -5647,7 +5650,7 @@
             'designbase-color-picker--open': isOpen,
             'designbase-color-picker--no-input': !showInput,
         }, className);
-        const Trigger = (jsxRuntime.jsxs("div", { className: "designbase-color-picker__trigger", onClick: () => !disabled && !readonly && handleModalOpen(), children: [jsxRuntime.jsx("div", { className: "designbase-color-picker__color-display", children: jsxRuntime.jsx("div", { className: "designbase-color-picker__color-box", style: { backgroundColor: showAlpha ? `rgba(${rgb.r}, ${rgb.g}, ${rgb.b}, ${a / 100})` : hex } }) }), showInput && (jsxRuntime.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 && (jsxRuntime.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 ? jsxRuntime.jsx(icons.DoneIcon, { size: 14 }) : jsxRuntime.jsx(icons.CopyIcon, { size: 14 }) })), jsxRuntime.jsx("button", { type: "button", className: "designbase-color-picker__toggle", disabled: disabled, "aria-label": "Toggle color picker", children: jsxRuntime.jsx(icons.ChevronDownIcon, { size: 16 }) })] }));
+        const Trigger = (jsxRuntime.jsxs("div", { className: "designbase-color-picker__trigger", onClick: () => !disabled && !readonly && (type === 'modal' ? handleModalOpen() : setIsOpen(v => !v)), children: [jsxRuntime.jsx("div", { className: "designbase-color-picker__color-display", children: jsxRuntime.jsx("div", { className: "designbase-color-picker__color-box", style: { backgroundColor: showAlpha ? `rgba(${rgb.r}, ${rgb.g}, ${rgb.b}, ${a / 100})` : hex } }) }), showInput && (jsxRuntime.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 && (jsxRuntime.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 ? jsxRuntime.jsx(icons.DoneIcon, { size: 14 }) : jsxRuntime.jsx(icons.CopyIcon, { size: 14 }) })), jsxRuntime.jsx("button", { type: "button", className: "designbase-color-picker__toggle", disabled: disabled, "aria-label": "Toggle color picker", children: jsxRuntime.jsx(icons.ChevronDownIcon, { size: 16 }) })] }));
         const Selector = (jsxRuntime.jsxs("div", { className: "designbase-color-picker__selector", children: [jsxRuntime.jsx("div", { className: "designbase-color-picker__color-area", children: jsxRuntime.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: jsxRuntime.jsx("div", { className: "designbase-color-picker__color-pointer", style: { left: `${s}%`, top: `${100 - v}%`, backgroundColor: `rgb(${rgb.r}, ${rgb.g}, ${rgb.b})` } }) }) }), jsxRuntime.jsxs("div", { className: "designbase-color-picker__controls", children: [jsxRuntime.jsx(Button, { variant: "tertiary", size: "m", iconOnly: true, onClick: onEyedrop, "aria-label": "Eyedropper tool", children: jsxRuntime.jsx(icons.EyedropperIcon, {}) }), jsxRuntime.jsxs("div", { className: "designbase-color-picker__slider-container", children: [jsxRuntime.jsx("div", { className: "designbase-color-picker__hue-slider", children: jsxRuntime.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 && (jsxRuntime.jsx("div", { className: "designbase-color-picker__alpha-slider", children: jsxRuntime.jsx("input", { type: "range", min: 0, max: 100, value: a, onChange: onAlphaChange, className: "designbase-color-picker__slider designbase-color-picker__slider--alpha", style: alphaTrackStyle }) }))] })] }), jsxRuntime.jsxs("div", { className: "designbase-color-picker__value-display", children: [showFormatSelector && (jsxRuntime.jsx(Select, { value: format, onChange: (v) => setFormat(v), showClearButton: false, options: [
                                 { label: 'HEX', value: 'hex' },
                                 { label: 'RGB', value: 'rgb' },
@@ -5655,7 +5658,7 @@
                                 { label: 'HSL', value: 'hsl' },
                                 { label: 'HSLA', value: 'hsla' },
                             ], size: "s", position: "top" })), jsxRuntime.jsx(Input, { type: "text", value: colorInput, onChange: setColorInput, onKeyDown: onColorKeyDown, onBlur: onColorBlur, placeholder: "#000000", size: "s", className: "designbase-color-picker__value-input" }), showAlpha && (jsxRuntime.jsxs("div", { className: "designbase-color-picker__alpha-input-wrap", children: [jsxRuntime.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" }), jsxRuntime.jsx("span", { className: "designbase-color-picker__alpha-suffix", children: "%" })] })), showCopyButton && (jsxRuntime.jsx(Button, { variant: "tertiary", size: "m", iconOnly: true, onClick: onCopy, "aria-label": "Copy color value", children: isCopied ? jsxRuntime.jsx(icons.DoneIcon, {}) : jsxRuntime.jsx(icons.CopyIcon, {}) }))] })] }));
-        return (jsxRuntime.jsxs("div", { ref: pickerRef, className: classes, children: [Trigger, type === 'dropdown' && isOpen && (jsxRuntime.jsx("div", { className: "designbase-color-picker__dropdown", onClick: (e) => e.stopPropagation(), children: Selector })), type === 'modal' && (jsxRuntime.jsxs(Modal, { isOpen: isOpen, onClose: handleModalCancel, title: "\uC0C9\uC0C1 \uC120\uD0DD", size: "s", children: [jsxRuntime.jsx(ModalBody, { children: Selector }), jsxRuntime.jsx(ModalFooter, { children: jsxRuntime.jsxs("div", { style: { display: 'flex', gap: '8px', justifyContent: 'flex-end' }, children: [jsxRuntime.jsx(Button, { variant: "tertiary", size: "s", onClick: handleModalCancel, children: "\uCDE8\uC18C" }), jsxRuntime.jsx(Button, { variant: "primary", size: "s", onClick: handleModalApply, children: "\uC801\uC6A9" })] }) })] }))] }));
+        return (jsxRuntime.jsxs("div", { ref: pickerRef, className: classes, children: [Trigger, type === 'dropdown' && isOpen && (jsxRuntime.jsx("div", { className: "designbase-color-picker__dropdown", onClick: (e) => e.stopPropagation(), children: Selector })), type === 'modal' && (jsxRuntime.jsxs(Modal, { isOpen: isOpen, onClose: handleModalCancel, title: "\uC0C9\uC0C1 \uC120\uD0DD", size: "s", children: [jsxRuntime.jsx(ModalBody, { children: Selector }), jsxRuntime.jsx(ModalFooter, { children: jsxRuntime.jsxs("div", { style: { display: 'flex', gap: 8, justifyContent: 'flex-end' }, children: [jsxRuntime.jsx(Button, { variant: "tertiary", size: "s", onClick: handleModalCancel, children: "\uCDE8\uC18C" }), jsxRuntime.jsx(Button, { variant: "primary", size: "s", onClick: handleModalApply, children: "\uC801\uC6A9" })] }) })] }))] }));
     };
     ColorPicker.displayName = 'ColorPicker';