@uniai-fe/uds-primitives 0.12.5 → 0.12.7

package/src/utils/selected-values.ts

@@ -1,25 +1,25 @@
-/**
- * Selected Values Utils; value 기반 선택 비교/정규화 유틸
- */
-
 /**
  * Select/Dropdown value 원시 타입
  */
 export type SelectedValue = string | number;
 
 /**
- * value를 비교 키 문자열로 정규화
+ * Selected Values; value를 비교 키 문자열로 정규화
+ * @function
  * @param {SelectedValue | undefined} value 비교 대상 value
- * @returns {string} 정규화된 키 문자열
+ * @desc Select와 Dropdown이 문자열·숫자 value를 같은 비교 축으로 다룰 수 있게 한다.
+ * @return {string} 정규화된 키 문자열
  */
 export const toSelectedValueKey = (value?: SelectedValue): string =>
   value === undefined ? "" : String(value);
 
 /**
- * 단일 value 동등성 비교
+ * Selected Values; 단일 value 동등성 비교
+ * @function
  * @param {SelectedValue | undefined} previousValue 이전 value
  * @param {SelectedValue | undefined} nextValue 다음 value
- * @returns {boolean} 동등 여부
+ * @desc 문자열·숫자 표현 차이를 정규화한 뒤 두 선택값의 동등성을 판정한다.
+ * @return {boolean} 동등 여부
  */
 export const isSameSelectedValue = (
   previousValue?: SelectedValue,
@@ -28,10 +28,12 @@ export const isSameSelectedValue = (
   toSelectedValueKey(previousValue) === toSelectedValueKey(nextValue);
 
 /**
- * value 배열 동등성 비교
+ * Selected Values; value 배열 동등성 비교
+ * @function
  * @param {SelectedValue[]} previousValues 이전 value 배열
  * @param {SelectedValue[]} nextValues 다음 value 배열
- * @returns {boolean} 동등 여부
+ * @desc 선택 순서를 포함해 두 value 배열이 같은지 판정한다.
+ * @return {boolean} 동등 여부
  */
 export const isSameSelectedValueList = (
   previousValues: SelectedValue[],
@@ -43,19 +45,23 @@ export const isSameSelectedValueList = (
   );
 
 /**
- * 단일 선택 value 정규화
+ * Selected Values; 단일 선택 value 정규화
+ * @function
  * @param {SelectedValue[]} selectedValues 선택 value 배열
- * @returns {SelectedValue | undefined} 단일 선택 결과
+ * @desc 선택 배열의 첫 value를 단일 선택 결과로 사용한다.
+ * @return {SelectedValue | undefined} 단일 선택 결과
  */
 export const normalizeSingleSelectedValue = (
   selectedValues: SelectedValue[],
 ): SelectedValue | undefined => selectedValues[0];
 
 /**
- * 모드 기반 value 배열 정규화
+ * Selected Values; 모드 기반 value 배열 정규화
+ * @function
  * @param {SelectedValue[]} selectedValues 선택 value 배열
  * @param {boolean} multiple 다중 선택 모드 여부
- * @returns {SelectedValue[]} 모드 규칙 적용 결과
+ * @desc 다중 선택은 전체 배열을 유지하고 단일 선택은 첫 value만 유지한다.
+ * @return {SelectedValue[]} 모드 규칙 적용 결과
  */
 export const normalizeSelectedValuesByMode = (
   selectedValues: SelectedValue[],

package/src/components/scrollbar/hooks/index.ts

@@ -1,4 +0,0 @@
-/**
- * Scrollbar Hooks; 현재 공개된 훅이 없는 placeholder 엔트리
- */
-export {};

package/src/components/scrollbar/index.scss

@@ -1 +0,0 @@
-@use "./styles/index.scss";

package/src/components/scrollbar/index.tsx

@@ -1,4 +0,0 @@
-/**
- * Scrollbar; 현재 public export가 없는 placeholder 카테고리 배럴
- */
-export * from "./markup";

package/src/components/scrollbar/markup/index.tsx

@@ -1,4 +0,0 @@
-/**
- * Scrollbar Markup; 현재 공개된 컴포넌트가 없는 placeholder 엔트리
- */
-export {};

package/src/components/scrollbar/types/index.ts

@@ -1,4 +0,0 @@
-/**
- * Scrollbar Types; 현재 공개된 타입이 없는 placeholder 엔트리
- */
-export {};

package/src/components/scrollbar/utils/index.ts

@@ -1,4 +0,0 @@
-/**
- * Scrollbar Utils; 현재 공개된 유틸이 없는 placeholder 엔트리
- */
-export {};

package/src/components/spinner/hooks/index.ts

@@ -1,4 +0,0 @@
-/**
- * Spinner Hooks; 현재 공개된 훅이 없는 placeholder 엔트리
- */
-export {};

package/src/components/spinner/index.scss

@@ -1 +0,0 @@
-@use "./styles/index.scss";

package/src/components/spinner/index.tsx

@@ -1,4 +0,0 @@
-/**
- * Spinner; 현재 public export가 없는 placeholder 카테고리 배럴
- */
-export * from "./markup";

package/src/components/spinner/markup/index.tsx

@@ -1,4 +0,0 @@
-/**
- * Spinner Markup; 현재 공개된 컴포넌트가 없는 placeholder 엔트리
- */
-export {};

package/src/components/spinner/types/index.ts

@@ -1,4 +0,0 @@
-/**
- * Spinner Types; 현재 공개된 타입이 없는 placeholder 엔트리
- */
-export {};

package/src/components/spinner/utils/index.ts

@@ -1,4 +0,0 @@
-/**
- * Spinner Utils; 현재 공개된 유틸이 없는 placeholder 엔트리
- */
-export {};

package/src/hooks/index.ts

@@ -1,4 +0,0 @@
-/**
- * shared hooks placeholder: 카테고리 간 재사용 로직을 이 디렉터리에 모아둔다.
- */
-export {};