@ncds/ui-admin 1.3.0 → 1.5.0

package/dist/types/src/hooks/dropdown/index.d.ts

@@ -0,0 +1,7 @@
+export { useDropdown } from './useDropdown';
+export { useDropdownKeyboard } from './useDropdownKeyboard';
+export { useDropdownPosition } from './useDropdownPosition';
+export { useOutsideClick } from './useOutsideClick';
+export { useScrollLock } from './useScrollLock';
+export { useWindowResize } from './useWindowResize';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/src/hooks/dropdown/useDropdown.d.ts

@@ -0,0 +1,30 @@
+import { RefObject } from 'react';
+interface UseDropdownConfig<T = any> {
+    triggerRef: RefObject<HTMLElement>;
+    dropdownRef?: RefObject<HTMLElement>;
+    maxHeight: number;
+    itemCount: number;
+    optionItems: T[];
+    disabled?: boolean;
+    multiple?: boolean;
+    onSelect: (option: T) => void;
+    onChange?: (isOpen: boolean) => void;
+}
+/**
+ * 드롭다운 기능을 통합한 커스텀 훅
+ */
+export declare const useDropdown: <T = any>(config: UseDropdownConfig<T>) => {
+    isOpen: boolean;
+    direction: import("../../types").DropdownDirection;
+    focusedIndex: number;
+    toggleDropdown: () => void;
+    closeDropdown: () => void;
+    handleOptionSelect: (option: T) => void;
+    handleKeyDown: (e: import("react").KeyboardEvent<HTMLElement>) => void;
+    setFocusedIndex: import("react").Dispatch<import("react").SetStateAction<number>>;
+    handleMouseMove: () => void;
+    isKeyboardNavigation: () => boolean;
+    updatePosition: () => import("../../types").DropdownPositionResult;
+};
+export {};
+//# sourceMappingURL=useDropdown.d.ts.map

package/dist/types/src/hooks/dropdown/useDropdownKeyboard.d.ts

@@ -0,0 +1,11 @@
+import { KeyboardEvent } from 'react';
+import { DropdownKeyboardConfig } from '../../types/dropdown';
+/**
+ * 드롭다운 키보드 네비게이션을 위한 커스텀 훅
+ */
+export declare const useDropdownKeyboard: <T = any>(config: DropdownKeyboardConfig<T>) => {
+    handleKeyDown: (e: KeyboardEvent<HTMLElement>) => void;
+    handleMouseMove: () => void;
+    isKeyboardNavigation: () => boolean;
+};
+//# sourceMappingURL=useDropdownKeyboard.d.ts.map

package/dist/types/src/hooks/dropdown/useDropdownPosition.d.ts

@@ -0,0 +1,10 @@
+import { DropdownDirection, DropdownPositionConfig } from '../../types/dropdown';
+/**
+ * 드롭다운 위치 계산을 위한 커스텀 훅
+ */
+export declare const useDropdownPosition: (config: DropdownPositionConfig) => {
+    direction: DropdownDirection;
+    updatePosition: () => import("../../types/dropdown").DropdownPositionResult;
+    setDirection: import("react").Dispatch<import("react").SetStateAction<DropdownDirection>>;
+};
+//# sourceMappingURL=useDropdownPosition.d.ts.map

package/dist/types/src/hooks/dropdown/useOutsideClick.d.ts

@@ -0,0 +1,6 @@
+import { DropdownOutsideClickConfig } from '../../types/dropdown';
+/**
+ * 외부 클릭 감지를 위한 커스텀 훅
+ */
+export declare const useOutsideClick: (config: DropdownOutsideClickConfig) => void;
+//# sourceMappingURL=useOutsideClick.d.ts.map

package/dist/types/src/hooks/dropdown/useScrollLock.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 페이지 스크롤을 잠그는 커스텀 훅 (드롭다운 내부 스크롤은 허용)
+ */
+export declare const useScrollLock: (isLocked: boolean, dropdownRef?: React.RefObject<HTMLElement>) => void;
+//# sourceMappingURL=useScrollLock.d.ts.map

package/dist/types/src/hooks/dropdown/useWindowResize.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Resize Observer를 사용하여 요소의 크기 변화를 감지하는 커스텀 훅
+ * @param callback 크기 변화 시 실행될 콜백 함수
+ * @param isActive 옵저버 활성화 여부
+ * @param target 관찰할 대상 요소 (기본값: document.body)
+ */
+export declare const useWindowResize: (callback: () => void, isActive?: boolean, target?: HTMLElement | null) => void;
+//# sourceMappingURL=useWindowResize.d.ts.map

package/dist/types/src/hooks/index.d.ts

@@ -1,4 +1,5 @@
+export { useCallbackRef } from './useCallbackRef';
 export { useMediaQuery } from './useMediaQuery';
 export { useMergeRefs } from './useMergeRefs';
-export { useCallbackRef } from './useCallbackRef';
+export * from './dropdown';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/src/types/dropdown/dropdown.d.ts

@@ -0,0 +1,40 @@
+import { RefObject } from 'react';
+export type DropdownDirection = 'up' | 'down';
+export type DropdownPositionConfig = {
+    triggerRef: RefObject<HTMLElement>;
+    maxHeight: number;
+    itemCount: number;
+    itemHeight?: number;
+    offset?: number;
+};
+export type DropdownPositionResult = {
+    direction: DropdownDirection;
+    maxHeight: number;
+};
+export type DropdownKeyboardConfig<T> = {
+    isOpen: boolean;
+    disabled: boolean;
+    focusedIndex: number;
+    optionItems: T[];
+    onToggle: () => void;
+    onSelect: (option: T) => void;
+    onClose: () => void;
+    onFocusChange: (index: number) => void;
+    triggerRef?: RefObject<HTMLElement>;
+    dropdownRef?: RefObject<HTMLElement>;
+};
+export type DropdownOutsideClickConfig = {
+    isOpen: boolean;
+    refs: RefObject<HTMLElement>[];
+    onClose: () => void;
+};
+export type MultiSelectOption = {
+    id: string | number;
+    label?: string;
+    disabled?: boolean;
+};
+export type SelectedTag = {
+    id: string | number;
+    label: string;
+};
+//# sourceMappingURL=dropdown.d.ts.map

package/dist/types/src/types/dropdown/index.d.ts

@@ -0,0 +1,3 @@
+export * from './dropdown';
+export * from './option';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/src/types/dropdown/option.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 기본 옵션 타입
+ */
+export type OptionType = {
+    id: string | number;
+    label: string;
+};
+/**
+ * 옵션 값 타입 (단일 또는 다중 선택)
+ */
+export type OptionValue = string | number | (string | number)[];
+/**
+ * 옵션 변경 핸들러 타입
+ */
+export type OptionChangeHandler = (value: OptionValue) => void;
+/**
+ * 옵션 선택 핸들러 타입
+ */
+export type OptionSelectHandler<T extends OptionType = OptionType> = (option: T) => void;
+//# sourceMappingURL=option.d.ts.map

package/dist/types/src/types/index.d.ts

@@ -0,0 +1,2 @@
+export * from './dropdown';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/src/utils/date-picker.d.ts

@@ -6,4 +6,7 @@ export declare function getSubtractDate({ date, period, unit, }: {
     period: DurationInputArg1;
     unit: DurationInputArg2;
 }): Date;
+export declare const formatDateInput: (input: string) => string;
+export declare const formatHourInput: (input: string) => string;
+export declare const formatMinuteInput: (input: string) => string;
 //# sourceMappingURL=date-picker.d.ts.map

package/dist/types/src/utils/dropdown/dropdownUtils.d.ts

@@ -0,0 +1,18 @@
+import { DropdownPositionConfig, DropdownPositionResult } from '../../types/dropdown';
+/**
+ * 드롭다운 위치를 계산하는 유틸리티 함수
+ */
+export declare const calculateDropdownPosition: ({ triggerRef, maxHeight, itemCount, itemHeight, offset, }: DropdownPositionConfig) => DropdownPositionResult;
+/**
+ * 키보드 네비게이션을 위한 포커스 인덱스 계산
+ */
+export declare const calculateNextFocusIndex: (currentIndex: number, direction: 'up' | 'down', validOptionsLength: number) => number;
+/**
+ * 드롭다운이 뷰포트를 벗어나지 않도록 위치 조정
+ */
+export declare const adjustDropdownPosition: (dropdownElement: HTMLElement, triggerElement: HTMLElement) => void;
+/**
+ * 스크롤 가능한 부모 요소를 찾는 유틸리티 함수
+ */
+export declare const findScrollableParent: (element: Element, boundary: Element) => Element | null;
+//# sourceMappingURL=dropdownUtils.d.ts.map

package/dist/types/src/utils/dropdown/index.d.ts

@@ -0,0 +1,3 @@
+export * from './dropdownUtils';
+export * from './multiSelect';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/src/utils/dropdown/multiSelect.d.ts

@@ -0,0 +1,32 @@
+import { MultiSelectOption, SelectedTag } from '../../types';
+/**
+ * 전체 선택 상태를 확인하는 유틸 함수
+ */
+export declare const isAllItemsSelected: (selectedValues: (string | number)[], options: MultiSelectOption[]) => boolean;
+/**
+ * 전체 선택 버튼 텍스트를 반환하는 유틸 함수
+ */
+export declare const getSelectAllButtonText: (selectedValues: (string | number)[], options: MultiSelectOption[], selectText?: string, deselectText?: string) => string;
+/**
+ * 전체 선택/해제를 처리하는 유틸 함수
+ */
+export declare const handleSelectAllItems: (selectedValues: (string | number)[], options: MultiSelectOption[]) => (string | number)[];
+/**
+ * 선택된 항목들을 태그 데이터로 변환하는 유틸 함수
+ */
+export declare const getSelectedTags: (selectedValues: (string | number)[], options: MultiSelectOption[]) => SelectedTag[];
+/**
+ * 태그 제거 시 선택값에서 해당 ID를 제거하는 유틸 함수
+ */
+export declare const removeTagFromSelected: (selectedValues: (string | number)[], tagIdToRemove: string | number) => (string | number)[];
+/**
+ * 전체 선택 관련 로직을 한 번에 처리하는 커스텀 훅
+ */
+export declare const useMultiSelect: (selectedValues: (string | number)[], options: MultiSelectOption[], selectText?: string, deselectText?: string) => {
+    isAllSelected: boolean;
+    buttonText: string;
+    toggleSelectAll: () => (string | number)[];
+    getSelectedTagsData: () => SelectedTag[];
+    removeTag: (tagId: string | number) => (string | number)[];
+};
+//# sourceMappingURL=multiSelect.d.ts.map

package/dist/types/src/utils/index.d.ts

@@ -0,0 +1,3 @@
+export * from './date-picker';
+export * from './dropdown';
+//# sourceMappingURL=index.d.ts.map