@uniai-fe/uds-primitives 0.3.48 → 0.3.49

package/src/utils/selected-values.ts

@@ -0,0 +1,70 @@
+/**
+ * Selected Values Utils; value 기반 선택 비교/정규화 유틸
+ */
+
+/**
+ * Select/Dropdown value 원시 타입
+ */
+export type SelectedValue = string | number;
+
+/**
+ * value를 비교 키 문자열로 정규화
+ * @param {SelectedValue | undefined} value 비교 대상 value
+ * @returns {string} 정규화된 키 문자열
+ */
+export const toSelectedValueKey = (value?: SelectedValue): string =>
+  value === undefined ? "" : String(value);
+
+/**
+ * 단일 value 동등성 비교
+ * @param {SelectedValue | undefined} previousValue 이전 value
+ * @param {SelectedValue | undefined} nextValue 다음 value
+ * @returns {boolean} 동등 여부
+ */
+export const isSameSelectedValue = (
+  previousValue?: SelectedValue,
+  nextValue?: SelectedValue,
+): boolean =>
+  toSelectedValueKey(previousValue) === toSelectedValueKey(nextValue);
+
+/**
+ * value 배열 동등성 비교
+ * @param {SelectedValue[]} previousValues 이전 value 배열
+ * @param {SelectedValue[]} nextValues 다음 value 배열
+ * @returns {boolean} 동등 여부
+ */
+export const isSameSelectedValueList = (
+  previousValues: SelectedValue[],
+  nextValues: SelectedValue[],
+): boolean =>
+  previousValues.length === nextValues.length &&
+  previousValues.every((selectedValue, index) =>
+    isSameSelectedValue(selectedValue, nextValues[index]),
+  );
+
+/**
+ * 단일 선택 value 정규화
+ * @param {SelectedValue[]} selectedValues 선택 value 배열
+ * @returns {SelectedValue | undefined} 단일 선택 결과
+ */
+export const normalizeSingleSelectedValue = (
+  selectedValues: SelectedValue[],
+): SelectedValue | undefined => selectedValues[0];
+
+/**
+ * 모드 기반 value 배열 정규화
+ * @param {SelectedValue[]} selectedValues 선택 value 배열
+ * @param {boolean} multiple 다중 선택 모드 여부
+ * @returns {SelectedValue[]} 모드 규칙 적용 결과
+ */
+export const normalizeSelectedValuesByMode = (
+  selectedValues: SelectedValue[],
+  multiple: boolean,
+): SelectedValue[] => {
+  if (multiple) {
+    return selectedValues;
+  }
+
+  const firstValue = normalizeSingleSelectedValue(selectedValues);
+  return firstValue === undefined ? [] : [firstValue];
+};