@ncds/ui-admin 1.3.0 → 1.4.1

package/dist/esm/src/hooks/dropdown/useDropdownKeyboard.js

@@ -0,0 +1,124 @@
+import { useCallback, useRef } from 'react';
+import { calculateNextFocusIndex } from '../../utils/dropdown';
+/**
+ * 드롭다운 키보드 네비게이션을 위한 커스텀 훅
+ */
+export var useDropdownKeyboard = function (config) {
+  var isOpen = config.isOpen,
+    disabled = config.disabled,
+    focusedIndex = config.focusedIndex,
+    optionItems = config.optionItems,
+    onToggle = config.onToggle,
+    onSelect = config.onSelect,
+    onClose = config.onClose,
+    onFocusChange = config.onFocusChange,
+    triggerRef = config.triggerRef,
+    dropdownRef = config.dropdownRef;
+  // 키보드 네비게이션 플래그
+  var isKeyboardNavigationRef = useRef(false);
+  // 포커스된 옵션이 보이도록 스크롤 조정
+  var scrollToFocusedOption = useCallback(function (index) {
+    if (!(dropdownRef === null || dropdownRef === void 0 ? void 0 : dropdownRef.current) || index < 0) return;
+    var optionsList = dropdownRef.current.querySelector('.ncua-select-dropdown__options');
+    if (!optionsList) return;
+    var options = optionsList.querySelectorAll('.ncua-select-dropdown__option');
+    var focusedOption = options[index];
+    if (!focusedOption) return;
+    var optionsListRect = optionsList.getBoundingClientRect();
+    var focusedOptionRect = focusedOption.getBoundingClientRect();
+    // 옵션이 위쪽으로 벗어났을 때
+    if (focusedOptionRect.top < optionsListRect.top) {
+      optionsList.scrollTop = focusedOption.offsetTop;
+    }
+    // 옵션이 아래쪽으로 벗어났을 때
+    else if (focusedOptionRect.bottom > optionsListRect.bottom) {
+      optionsList.scrollTop = focusedOption.offsetTop + focusedOption.offsetHeight - optionsList.clientHeight;
+    }
+  }, [dropdownRef]);
+  var handleKeyDown = useCallback(function (e) {
+    var _a;
+    if (disabled) return;
+    switch (e.key) {
+      case 'Enter':
+      case ' ':
+        e.preventDefault();
+        if (!isOpen) {
+          onToggle();
+        } else if (focusedIndex >= 0 && optionItems[focusedIndex]) {
+          onSelect(optionItems[focusedIndex]);
+        }
+        break;
+      case 'Escape':
+        if (isOpen) {
+          e.preventDefault();
+          onClose();
+          (_a = triggerRef === null || triggerRef === void 0 ? void 0 : triggerRef.current) === null || _a === void 0 ? void 0 : _a.focus();
+        }
+        break;
+      case 'ArrowDown':
+        e.preventDefault();
+        isKeyboardNavigationRef.current = true; // 키보드 네비게이션 시작
+        if (!isOpen) {
+          onToggle();
+        } else {
+          var nextIndex_1 = calculateNextFocusIndex(focusedIndex, 'down', optionItems.length);
+          onFocusChange(nextIndex_1);
+          // 포커스 변경 후 스크롤 조정
+          setTimeout(function () {
+            return scrollToFocusedOption(nextIndex_1);
+          }, 100);
+        }
+        break;
+      case 'ArrowUp':
+        e.preventDefault();
+        isKeyboardNavigationRef.current = true; // 키보드 네비게이션 시작
+        if (!isOpen) {
+          onToggle();
+        } else {
+          var nextIndex_2 = calculateNextFocusIndex(focusedIndex, 'up', optionItems.length);
+          onFocusChange(nextIndex_2);
+          // 포커스 변경 후 스크롤 조정
+          setTimeout(function () {
+            return scrollToFocusedOption(nextIndex_2);
+          }, 100);
+        }
+        break;
+      case 'Home':
+        if (isOpen) {
+          e.preventDefault();
+          isKeyboardNavigationRef.current = true; // 키보드 네비게이션 시작
+          onFocusChange(0);
+          // 포커스 변경 후 스크롤 조정
+          setTimeout(function () {
+            return scrollToFocusedOption(0);
+          }, 0);
+        }
+        break;
+      case 'End':
+        if (isOpen) {
+          e.preventDefault();
+          isKeyboardNavigationRef.current = true; // 키보드 네비게이션 시작
+          var lastIndex_1 = optionItems.length - 1;
+          onFocusChange(lastIndex_1);
+          // 포커스 변경 후 스크롤 조정
+          setTimeout(function () {
+            return scrollToFocusedOption(lastIndex_1);
+          }, 0);
+        }
+        break;
+    }
+  }, [disabled, isOpen, focusedIndex, optionItems, onToggle, onSelect, onClose, onFocusChange, triggerRef, scrollToFocusedOption]);
+  // 마우스 움직임 감지 함수
+  var handleMouseMove = useCallback(function () {
+    isKeyboardNavigationRef.current = false;
+  }, []);
+  // 키보드 네비게이션 상태 확인 함수
+  var isKeyboardNavigation = useCallback(function () {
+    return isKeyboardNavigationRef.current;
+  }, []);
+  return {
+    handleKeyDown: handleKeyDown,
+    handleMouseMove: handleMouseMove,
+    isKeyboardNavigation: isKeyboardNavigation
+  };
+};

package/dist/esm/src/hooks/dropdown/useDropdownPosition.js

@@ -0,0 +1,20 @@
+import { useCallback, useState } from 'react';
+import { calculateDropdownPosition } from '../../utils/dropdown';
+/**
+ * 드롭다운 위치 계산을 위한 커스텀 훅
+ */
+export var useDropdownPosition = function (config) {
+  var _a = useState('down'),
+    direction = _a[0],
+    setDirection = _a[1];
+  var updatePosition = useCallback(function () {
+    var result = calculateDropdownPosition(config);
+    setDirection(result.direction);
+    return result;
+  }, [config]);
+  return {
+    direction: direction,
+    updatePosition: updatePosition,
+    setDirection: setDirection
+  };
+};

package/dist/esm/src/hooks/dropdown/useOutsideClick.js

@@ -0,0 +1,26 @@
+import { useEffect } from 'react';
+/**
+ * 외부 클릭 감지를 위한 커스텀 훅
+ */
+export var useOutsideClick = function (config) {
+  var isOpen = config.isOpen,
+    refs = config.refs,
+    onClose = config.onClose;
+  useEffect(function () {
+    if (!isOpen) return;
+    var handleClickOutside = function (event) {
+      var target = event.target;
+      // 모든 ref들에 대해 클릭이 외부에서 발생했는지 확인
+      var isOutside = refs.every(function (ref) {
+        return !ref.current || !ref.current.contains(target);
+      });
+      if (isOutside) {
+        onClose();
+      }
+    };
+    document.addEventListener('mousedown', handleClickOutside);
+    return function () {
+      document.removeEventListener('mousedown', handleClickOutside);
+    };
+  }, [isOpen, refs, onClose]);
+};

package/dist/esm/src/hooks/dropdown/useScrollLock.js

@@ -0,0 +1,71 @@
+import { useEffect, useRef } from 'react';
+import { findScrollableParent } from '../../utils';
+/**
+ * 페이지 스크롤을 잠그는 커스텀 훅 (드롭다운 내부 스크롤은 허용)
+ */
+export var useScrollLock = function (isLocked, dropdownRef) {
+  var scrollPosition = useRef(0);
+  useEffect(function () {
+    if (isLocked) {
+      // 현재 스크롤 위치 저장
+      scrollPosition.current = window.pageYOffset;
+      // 스크롤 방지 함수 (드롭다운 내부는 스크롤 체이닝 방지)
+      var preventScroll_1 = function (e) {
+        // 드롭다운 내부에서 발생하지 않은 이벤트는 차단
+        if (!(dropdownRef === null || dropdownRef === void 0 ? void 0 : dropdownRef.current) || !dropdownRef.current.contains(e.target)) {
+          e.preventDefault();
+          return;
+        }
+        // 드롭다운 내부의 스크롤 가능한 요소 찾기
+        var scrollableElement = findScrollableParent(e.target, dropdownRef.current);
+        if (scrollableElement && e instanceof WheelEvent) {
+          var deltaY = e.deltaY;
+          var scrollTop = scrollableElement.scrollTop,
+            scrollHeight = scrollableElement.scrollHeight,
+            clientHeight = scrollableElement.clientHeight;
+          // 스크롤이 위쪽 끝에 도달했고 위로 스크롤하려는 경우
+          if (scrollTop === 0 && deltaY < 0) {
+            e.preventDefault();
+            return;
+          }
+          // 스크롤이 아래쪽 끝에 도달했고 아래로 스크롤하려는 경우
+          if (scrollTop + clientHeight >= scrollHeight && deltaY > 0) {
+            e.preventDefault();
+            return;
+          }
+        }
+        // 드롭다운 내부에 스크롤 가능한 요소가 없으면 차단
+        if (!scrollableElement) {
+          e.preventDefault();
+        }
+      };
+      // 키보드 스크롤 방지 함수 (드롭다운 내부는 제외)
+      var preventKeyboardScroll_1 = function (e) {
+        // 드롭다운 내부에서 발생한 이벤트는 허용
+        if ((dropdownRef === null || dropdownRef === void 0 ? void 0 : dropdownRef.current) && dropdownRef.current.contains(e.target)) {
+          return;
+        }
+        var scrollKeys = ['PageUp', 'PageDown', 'Home', 'End', ' '];
+        if (scrollKeys.includes(e.key)) {
+          e.preventDefault();
+        }
+      };
+      // 이벤트 리스너 추가
+      document.addEventListener('wheel', preventScroll_1, {
+        passive: false
+      });
+      document.addEventListener('touchmove', preventScroll_1, {
+        passive: false
+      });
+      document.addEventListener('keydown', preventKeyboardScroll_1);
+      return function () {
+        // 이벤트 리스너 제거
+        document.removeEventListener('wheel', preventScroll_1);
+        document.removeEventListener('touchmove', preventScroll_1);
+        document.removeEventListener('keydown', preventKeyboardScroll_1);
+        // 스크롤 위치 복원
+        window.scrollTo(0, scrollPosition.current);
+      };
+    }
+  }, [isLocked, dropdownRef]);
+};

package/dist/esm/src/hooks/dropdown/useWindowResize.js

@@ -0,0 +1,45 @@
+import { useEffect, useRef } from 'react';
+/**
+ * Resize Observer를 사용하여 요소의 크기 변화를 감지하는 커스텀 훅
+ * @param callback 크기 변화 시 실행될 콜백 함수
+ * @param isActive 옵저버 활성화 여부
+ * @param target 관찰할 대상 요소 (기본값: document.body)
+ */
+export var useWindowResize = function (callback, isActive, target) {
+  if (isActive === void 0) {
+    isActive = true;
+  }
+  var resizeObserverRef = useRef(null);
+  useEffect(function () {
+    if (!isActive) return;
+    // Resize Observer 지원 여부 확인
+    if (!window.ResizeObserver) {
+      // Resize Observer를 지원하지 않는 브라우저의 경우 기존 방식 사용
+      var handleResize_1 = function () {
+        callback();
+      };
+      window.addEventListener('resize', handleResize_1);
+      return function () {
+        window.removeEventListener('resize', handleResize_1);
+      };
+    }
+    // Resize Observer 생성
+    resizeObserverRef.current = new ResizeObserver(function (entries) {
+      // entries가 비어있지 않을 때만 콜백 실행
+      if (entries.length > 0) {
+        callback();
+      }
+    });
+    // 관찰할 대상 요소 결정
+    var targetElement = target || document.body;
+    if (targetElement) {
+      resizeObserverRef.current.observe(targetElement);
+    }
+    return function () {
+      if (resizeObserverRef.current) {
+        resizeObserverRef.current.disconnect();
+        resizeObserverRef.current = null;
+      }
+    };
+  }, [callback, isActive, target]);
+};

package/dist/esm/src/hooks/index.js

@@ -1,3 +1,6 @@
+// 기존 공통 hooks
+export { useCallbackRef } from './useCallbackRef';
 export { useMediaQuery } from './useMediaQuery';
 export { useMergeRefs } from './useMergeRefs';
-export { useCallbackRef } from './useCallbackRef';
+// 드롭다운 관련 hooks
+export * from './dropdown';

package/dist/esm/src/types/dropdown/dropdown.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/src/types/dropdown/index.js

@@ -0,0 +1,2 @@
+export * from './dropdown';
+export * from './option';

package/dist/esm/src/types/dropdown/option.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/src/types/index.js

@@ -0,0 +1,2 @@
+// 드롭다운 관련 types
+export * from './dropdown';

package/dist/esm/src/utils/date-picker.js

@@ -14,4 +14,36 @@ export function getSubtractDate(_a) {
     period = _a.period,
     unit = _a.unit;
   return moment(date).subtract(period, unit).toDate();
-}
+}
+export var formatDateInput = function (input) {
+  var dateRegex = /^(19|20)\d{2}(0[1-9]|1[012])(0[1-9]|[12][0-9]|3[0-1])$/;
+  if (dateRegex.test(input)) {
+    // 20231112 -> 2023-11-12 형식으로 변환
+    var year = input.substring(0, 4);
+    var month = input.substring(4, 6);
+    var day = input.substring(6, 8);
+    return "".concat(year, "-").concat(month, "-").concat(day);
+  }
+  return input;
+};
+export var formatHourInput = function (input) {
+  var numbers = input.replace(/\D/g, '');
+  var hourStr = numbers.substring(0, 2);
+  var hourNum = parseInt(hourStr, 10);
+  if (hourNum >= 0 && hourNum <= 23) {
+    return hourStr;
+  }
+  return input;
+};
+export var formatMinuteInput = function (input) {
+  // 숫자만 추출
+  var numbers = input.replace(/\D/g, '');
+  // 2자리 숫자로 제한
+  var minuteStr = numbers.substring(0, 2);
+  var minuteNum = parseInt(minuteStr, 10);
+  // 00-59 범위 체크
+  if (minuteNum >= 0 && minuteNum <= 59) {
+    return minuteStr; // 2자리로 패딩
+  }
+  return input;
+};

package/dist/esm/src/utils/dropdown/dropdownUtils.js

@@ -0,0 +1,97 @@
+/**
+ * 드롭다운 위치를 계산하는 유틸리티 함수
+ */
+export var calculateDropdownPosition = function (_a) {
+  var triggerRef = _a.triggerRef,
+    maxHeight = _a.maxHeight,
+    itemCount = _a.itemCount,
+    _b = _a.itemHeight,
+    itemHeight = _b === void 0 ? 40 : _b,
+    _c = _a.offset,
+    offset = _c === void 0 ? 20 : _c;
+  if (!(triggerRef === null || triggerRef === void 0 ? void 0 : triggerRef.current)) {
+    return {
+      direction: 'down',
+      maxHeight: maxHeight
+    };
+  }
+  var rect = triggerRef === null || triggerRef === void 0 ? void 0 : triggerRef.current.getBoundingClientRect();
+  var viewportHeight = window.innerHeight;
+  var dropdownHeight = Math.min(maxHeight, itemCount * itemHeight);
+  // 아래쪽 공간이 충분한지 확인
+  var spaceBelow = viewportHeight - rect.bottom;
+  if (spaceBelow < dropdownHeight + offset) {
+    return {
+      direction: 'up',
+      maxHeight: maxHeight
+    };
+  } else {
+    return {
+      direction: 'down',
+      maxHeight: maxHeight
+    };
+  }
+};
+/**
+ * 키보드 네비게이션을 위한 포커스 인덱스 계산
+ */
+export var calculateNextFocusIndex = function (currentIndex, direction, validOptionsLength) {
+  if (validOptionsLength === 0) return -1;
+  if (direction === 'down') {
+    return currentIndex < validOptionsLength - 1 ? currentIndex + 1 : 0;
+  } else {
+    return currentIndex > 0 ? currentIndex - 1 : validOptionsLength - 1;
+  }
+};
+/**
+ * 드롭다운이 뷰포트를 벗어나지 않도록 위치 조정
+ */
+export var adjustDropdownPosition = function (dropdownElement, triggerElement) {
+  var dropdownRect = dropdownElement.getBoundingClientRect();
+  var viewportWidth = window.innerWidth;
+  var viewportHeight = window.innerHeight;
+  // 좌우 위치 조정
+  if (dropdownRect.right > viewportWidth) {
+    var overflow = dropdownRect.right - viewportWidth;
+    dropdownElement.style.left = "".concat(-overflow - 10, "px");
+  }
+  if (dropdownRect.left < 0) {
+    dropdownElement.style.left = '10px';
+  }
+  // 상하 위치 조정 (이미 up/down 방향이 결정된 후 미세 조정)
+  if (dropdownRect.bottom > viewportHeight) {
+    var overflow = dropdownRect.bottom - viewportHeight;
+    dropdownElement.style.maxHeight = "".concat(dropdownRect.height - overflow - 10, "px");
+  }
+};
+/**
+ * 스크롤 가능한 부모 요소를 찾는 유틸리티 함수
+ */
+export var findScrollableParent = function (element, boundary) {
+  var current = element;
+  while (current && current !== boundary && current !== document.body) {
+    var style = window.getComputedStyle(current);
+    var overflowY = style.overflowY;
+    if (overflowY === 'scroll' || overflowY === 'auto') {
+      var scrollHeight = current.scrollHeight,
+        clientHeight = current.clientHeight;
+      if (scrollHeight > clientHeight) {
+        return current;
+      }
+    }
+    current = current.parentElement;
+  }
+  // boundary 자체가 스크롤 가능한지 확인
+  if (current === boundary) {
+    var style = window.getComputedStyle(boundary);
+    var overflowY = style.overflowY;
+    if (overflowY === 'scroll' || overflowY === 'auto') {
+      var scrollHeight = boundary.scrollHeight,
+        clientHeight = boundary.clientHeight;
+      if (scrollHeight > clientHeight) {
+        return boundary;
+      }
+    }
+  }
+  return null;
+};

package/dist/esm/src/utils/dropdown/index.js

@@ -0,0 +1,2 @@
+export * from './dropdownUtils';
+export * from './multiSelect';

package/dist/esm/src/utils/dropdown/multiSelect.js

@@ -0,0 +1,88 @@
+/**
+ * 전체 선택 상태를 확인하는 유틸 함수
+ */
+export var isAllItemsSelected = function (selectedValues, options) {
+  if (options.length === 0) return false;
+  var validOptionIds = options.filter(function (option) {
+    return !option.disabled;
+  }).map(function (option) {
+    return option.id;
+  });
+  return validOptionIds.length > 0 && validOptionIds.every(function (id) {
+    return selectedValues.includes(id);
+  });
+};
+/**
+ * 전체 선택 버튼 텍스트를 반환하는 유틸 함수
+ */
+export var getSelectAllButtonText = function (selectedValues, options, selectText, deselectText) {
+  if (selectText === void 0) {
+    selectText = '전체 선택';
+  }
+  if (deselectText === void 0) {
+    deselectText = '전체 해제';
+  }
+  return isAllItemsSelected(selectedValues, options) ? deselectText : selectText;
+};
+/**
+ * 전체 선택/해제를 처리하는 유틸 함수
+ */
+export var handleSelectAllItems = function (selectedValues, options) {
+  if (isAllItemsSelected(selectedValues, options)) {
+    // 전체 해제: 빈 배열 반환
+    return [];
+  }
+  // 전체 선택: 비활성화되지 않은 모든 옵션 ID 반환
+  return options.filter(function (option) {
+    return !option.disabled;
+  }).map(function (option) {
+    return option.id;
+  });
+};
+/**
+ * 선택된 항목들을 태그 데이터로 변환하는 유틸 함수
+ */
+export var getSelectedTags = function (selectedValues, options) {
+  return selectedValues.map(function (value) {
+    var option = options.find(function (opt) {
+      return opt.id === value;
+    });
+    return option ? {
+      id: option.id,
+      label: option.label || String(option.id)
+    } : null;
+  }).filter(function (tag) {
+    return tag !== null;
+  });
+};
+/**
+ * 태그 제거 시 선택값에서 해당 ID를 제거하는 유틸 함수
+ */
+export var removeTagFromSelected = function (selectedValues, tagIdToRemove) {
+  return selectedValues.filter(function (id) {
+    return id !== tagIdToRemove;
+  });
+};
+/**
+ * 전체 선택 관련 로직을 한 번에 처리하는 커스텀 훅
+ */
+export var useMultiSelect = function (selectedValues, options, selectText, deselectText) {
+  var isAllSelected = isAllItemsSelected(selectedValues, options);
+  var buttonText = getSelectAllButtonText(selectedValues, options, selectText, deselectText);
+  var toggleSelectAll = function () {
+    return handleSelectAllItems(selectedValues, options);
+  };
+  var getSelectedTagsData = function () {
+    return getSelectedTags(selectedValues, options);
+  };
+  var removeTag = function (tagId) {
+    return removeTagFromSelected(selectedValues, tagId);
+  };
+  return {
+    isAllSelected: isAllSelected,
+    buttonText: buttonText,
+    toggleSelectAll: toggleSelectAll,
+    getSelectedTagsData: getSelectedTagsData,
+    removeTag: removeTag
+  };
+};

package/dist/esm/src/utils/index.js

@@ -0,0 +1,4 @@
+// 날짜 관련 utils
+export * from './date-picker';
+// 드롭다운 관련 utils
+export * from './dropdown';

package/dist/types/assets/scripts/comboBox.d.ts

@@ -0,0 +1,79 @@
+import { Size } from '@ncds/ui-admin/constant/size';
+import { OptionValue } from '../../src/types';
+import { DropdownOption } from './utils/selectbox/DropdownModel';
+import { UnifiedSelectBoxConfig } from './utils/selectbox/UnifiedSelectBox';
+export interface ComboBoxOptionType {
+    id: string | number;
+    label: string;
+    disabled?: boolean;
+}
+export interface ComboBoxConfig {
+    options?: ComboBoxOptionType[];
+    placeholder?: string;
+    value?: OptionValue;
+    onChange?: (value: OptionValue) => void;
+    onSearch?: (searchValue: string) => void;
+    onEdit?: () => void;
+    onSelectAll?: () => void;
+    onSearchAll?: () => void;
+    onComplete?: () => void;
+    onTagRemove?: (tagId: string | number) => void;
+    onScrollBottom?: () => void;
+    searchDebounceMs?: number;
+    maxHeight?: number;
+    disabled?: boolean;
+    size?: Extract<Size, 'xs' | 'sm'>;
+    multiple?: boolean;
+    showFooterButtons?: boolean;
+    label?: string;
+    required?: boolean;
+}
+export declare class ComboBox {
+    private element;
+    private unifiedSelectBox;
+    private targetSelect;
+    private isInitializing;
+    private lastValue;
+    constructor(element: HTMLElement, config?: ComboBoxConfig);
+    /**
+     * 타겟 select 요소 찾기
+     */
+    private findTargetSelect;
+    /**
+     * HTML select에서 옵션 파싱
+     */
+    private parseOptionsFromHTML;
+    /**
+     * HTML에서 속성 파싱
+     */
+    private parseAttributesFromHTML;
+    /**
+     * 타겟 select와 동기화 (Single 모드)
+     */
+    private syncWithTargetSelect;
+    /**
+     * 타겟 select와 동기화 (Multiple 모드)
+     */
+    private syncWithTargetSelectMultiple;
+    getValues(): DropdownOption[];
+    getOptions(): DropdownOption[];
+    setValues(value: DropdownOption[]): void;
+    updateOptions(newOptions: DropdownOption[]): void;
+    setDisabled(disabled: boolean): void;
+    open(): void;
+    close(): void;
+    focus(): void;
+    destroy(): void;
+    clearInput(): void;
+    getDebugInfo(): {
+        config: UnifiedSelectBoxConfig;
+        modelState: any;
+        isOpen: boolean;
+    };
+    selectAll(): void;
+    deselectAll(): void;
+    getSelectedCount(): number;
+    isMultiple(): boolean;
+    toggleSelectAll(): void;
+}
+//# sourceMappingURL=comboBox.d.ts.map