@basiln/utils 0.1.8 → 0.1.10

package/README.md

@@ -23,6 +23,9 @@ yarn add @basiln/utils
 - [composeEventHandlers](#composeeventhandlers)
 - [getVar](#getvar)
 - [Format](#format)
+- [DomainFormat](#domainformat)
+- [useCombinedRefs](#usecombinedrefs)
+- [useControllableState](#usecontrollablestate)
 
 ### `If`
 
@@ -322,3 +325,63 @@ Format.phone('01012345678'); // '010-1234-5678'
 Format.commaize('123456'); // '123,456'
 Format.padTime(1); // '01'
 ```
+
+---
+
+### `DomainFormat`
+
+도메인 관련 데이터를 원하는 형식으로 변환하는 포맷팅 유틸입니다.
+
+#### 사용법
+
+```tsx
+// 기본
+DomainFormat.modeName('H'); // 난방
+DomainFormat.modeColor('H'); // #e77676
+DomainFormat.wind(3) // 강풍
+DomainFormat.airLevelName(4) // 좋음
+DomainFormat.airLevelColor(1) // #ff5d47
+DomainFormat.userLevel({level: '1'}) // 마스터
+DomainFormat.userLevel({level: '1', language: 'en'}) // MASTER
+
+// Mode 추가가 필요한 경우 
+DomainFormat.modeName('R', {R: '실외기 잠금'}); // 실외기 잠금
+DomainFormat.modeColor('R', {N: 'gray'}); // 'gray'
+```
+---
+### `useCombinedRefs`
+컴포넌트 내부에 선언된 ref와, 사용하는 부분에서 forwarded된 ref를 합칠 수 있도록 하는 hook 입니다.
+#### 사용법
+```tsx
+const TextField = forwardRef((props, forwardedRef) => {
+    const ref = useRef<HTMLInputElement | null>(null);
+    const combinedRefs = useCombinedRefs(ref, forwardedRef);
+    return <input ref={ref} />
+})
+```
+---
+### `useControllableState`
+사용자의 입력을 통해 상태를 관리할 때와 사용자의 입력을 상태로 관리하지 않고 싶을 때 두 경우 모두를 지원하는 hook 입니다.
+#### 사용법 ([참고](https://github.com/seedn-corp/leaf-airmate-web-fe/blob/20bec52b87814e7c0a9f174b08bdaa0bff2e8680/src/components/historyInfo/Select/index.tsx#L14-L33))
+```tsx
+  const [value, setValue] = useControllableState({
+    prop: valueFromProps,
+    defaultProp: defaultValue,
+    onChange: onValueChange,
+  });
+  return (
+    <SelectProvider
+      value={value}
+      onValueChange={setValue}
+      triggerWidth={triggerWidth}
+      onTriggerWidthChange={setTriggerWidth}
+    >
+      <SelectPrimitive.Root value={value} onValueChange={setValue} {...restProps}>
+        <div ref={ref}>{children}</div>
+      </SelectPrimitive.Root>
+    </SelectProvider>
+  );
+});
+
+```
+

package/dist/DomainFormat.js

@@ -0,0 +1,123 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/DomainFormat.ts
+var DomainFormat_exports = {};
+__export(DomainFormat_exports, {
+  DomainFormat: () => DomainFormat
+});
+module.exports = __toCommonJS(DomainFormat_exports);
+function formatModeName(mode, customMapping = {}) {
+  const defaultModeMapping = {
+    H: "\uB09C\uBC29",
+    C: "\uB0C9\uBC29",
+    W: "\uC1A1\uD48D"
+  };
+  const combinedMapping = { ...defaultModeMapping, ...customMapping };
+  if (!(mode in combinedMapping)) {
+    throw new Error(`\uC9C0\uC6D0\uD558\uC9C0 \uC54A\uB294 \uBAA8\uB4DC\uC785\uB2C8\uB2E4. mode: ${mode}`);
+  }
+  return combinedMapping[mode];
+}
+function formatModeColor(mode, customMapping = {}) {
+  const defaultColorMapping = {
+    H: "#e77676",
+    C: "#9fc6ff",
+    W: "#a8e379"
+  };
+  const combinedMapping = { ...defaultColorMapping, ...customMapping };
+  if (!(mode in combinedMapping)) {
+    throw new Error(`\uC9C0\uC6D0\uD558\uC9C0 \uC54A\uB294 \uBAA8\uB4DC\uC785\uB2C8\uB2E4. mode: ${mode}`);
+  }
+  return combinedMapping[mode];
+}
+function formatWind(wind, customMapping = {}) {
+  const defaultWindMapping = {
+    1: "\uBBF8\uD48D",
+    2: "\uC57D\uD48D",
+    3: "\uAC15\uD48D"
+  };
+  const combinedMapping = { ...defaultWindMapping, ...customMapping };
+  if (!(wind in combinedMapping)) {
+    throw new Error(`\uC9C0\uC6D0\uD558\uC9C0 \uC54A\uB294 \uD48D\uB7C9\uC785\uB2C8\uB2E4. wind: ${wind}`);
+  }
+  return combinedMapping[wind];
+}
+function formatAirLevelName(level) {
+  const airLevelMapping = {
+    1: "\uB9E4\uC6B0 \uB098\uC068",
+    2: "\uB098\uC068",
+    3: "\uBCF4\uD1B5",
+    4: "\uC88B\uC74C",
+    5: "\uB9E4\uC6B0 \uC88B\uC74C"
+  };
+  if (!(level in airLevelMapping)) {
+    throw new Error(`\uC9C0\uC6D0\uD558\uC9C0 \uC54A\uB294 \uB808\uBCA8\uC785\uB2C8\uB2E4. level: ${level}`);
+  }
+  return airLevelMapping[level];
+}
+function formatAirLevelColor(level) {
+  const colorMapping = {
+    1: "#ff5d47",
+    2: "#ff961c",
+    3: "#ffca42",
+    4: "#63ff60",
+    5: "#49ffe9"
+  };
+  if (!(level in colorMapping)) {
+    throw new Error(`\uC9C0\uC6D0\uD558\uC9C0 \uC54A\uB294 \uB808\uBCA8\uC785\uB2C8\uB2E4. level: ${level}`);
+  }
+  return colorMapping[level];
+}
+var formatUserLevel = ({ level, language = "ko" }) => {
+  const userLevelMapping = {
+    en: {
+      "1": "MASTER",
+      "2": "MASTER KID",
+      "3": "SENIOR",
+      "4": "JUNIOR"
+    },
+    ko: {
+      "1": "\uB9C8\uC2A4\uD130",
+      "2": "\uB9C8\uC2A4\uD130\uD0A4\uC988",
+      "3": "\uC2DC\uB2C8\uC5B4",
+      "4": "\uC8FC\uB2C8\uC5B4"
+    }
+  };
+  if (!(language in userLevelMapping)) {
+    throw new Error(`\uC9C0\uC6D0\uD558\uC9C0 \uC54A\uB294 \uC5B8\uC5B4\uC785\uB2C8\uB2E4. language: ${language}`);
+  }
+  if (!(level in userLevelMapping[language])) {
+    throw new Error(`\uC9C0\uC6D0\uD558\uC9C0 \uC54A\uB294 \uB808\uBCA8\uC785\uB2C8\uB2E4. level: ${level}`);
+  }
+  return userLevelMapping[language][level];
+};
+var DomainFormat = {
+  modeName: formatModeName,
+  modeColor: formatModeColor,
+  wind: formatWind,
+  airLevelName: formatAirLevelName,
+  airLevelColor: formatAirLevelColor,
+  userLevel: formatUserLevel
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DomainFormat
+});
+//# sourceMappingURL=DomainFormat.js.map

package/dist/DomainFormat.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/DomainFormat.ts"],"sourcesContent":["export type Mode = 'H' | 'C' | 'W';\nexport type Wind = 1 | 2 | 3;\nexport type AirLevel = 1 | 2 | 3 | 4 | 5;\nexport type UserLevel = '1' | '2' | '3' | '4';\nexport type Language = 'en' | 'ko';\n\nfunction formatModeName(mode: Mode, customMapping: Record<string, string> = {}): string {\n  const defaultModeMapping: Record<Mode, string> = {\n    H: '난방',\n    C: '냉방',\n    W: '송풍',\n  };\n\n  const combinedMapping = { ...defaultModeMapping, ...customMapping };\n\n  if (!(mode in combinedMapping)) {\n    throw new Error(`지원하지 않는 모드입니다. mode: ${mode}`);\n  }\n\n  return combinedMapping[mode];\n}\n\nfunction formatModeColor(mode: Mode, customMapping: Record<string, string> = {}) {\n  const defaultColorMapping: Record<Mode, string> = {\n    H: '#e77676',\n    C: '#9fc6ff',\n    W: '#a8e379',\n  };\n\n  const combinedMapping = { ...defaultColorMapping, ...customMapping };\n\n  if (!(mode in combinedMapping)) {\n    throw new Error(`지원하지 않는 모드입니다. mode: ${mode}`);\n  }\n\n  return combinedMapping[mode];\n}\n\nfunction formatWind(wind: Wind, customMapping: Record<string, string> = {}) {\n  const defaultWindMapping: Record<Wind, string> = {\n    1: '미풍',\n    2: '약풍',\n    3: '강풍',\n  };\n\n  const combinedMapping = { ...defaultWindMapping, ...customMapping };\n\n  if (!(wind in combinedMapping)) {\n    throw new Error(`지원하지 않는 풍량입니다. wind: ${wind}`);\n  }\n\n  return combinedMapping[wind];\n}\n\nfunction formatAirLevelName(level: AirLevel) {\n  const airLevelMapping: Record<AirLevel, string> = {\n    1: '매우 나쁨',\n    2: '나쁨',\n    3: '보통',\n    4: '좋음',\n    5: '매우 좋음',\n  };\n\n  if (!(level in airLevelMapping)) {\n    throw new Error(`지원하지 않는 레벨입니다. level: ${level}`);\n  }\n\n  return airLevelMapping[level];\n}\n\nfunction formatAirLevelColor(level: AirLevel) {\n  const colorMapping: Record<AirLevel, string> = {\n    1: '#ff5d47',\n    2: '#ff961c',\n    3: '#ffca42',\n    4: '#63ff60',\n    5: '#49ffe9',\n  };\n\n  if (!(level in colorMapping)) {\n    throw new Error(`지원하지 않는 레벨입니다. level: ${level}`);\n  }\n\n  return colorMapping[level];\n}\n\nconst formatUserLevel = ({ level, language = 'ko' }: { level: UserLevel; language?: Language }) => {\n  const userLevelMapping: Record<Language, Record<UserLevel, string>> = {\n    en: {\n      '1': 'MASTER',\n      '2': 'MASTER KID',\n      '3': 'SENIOR',\n      '4': 'JUNIOR',\n    },\n    ko: {\n      '1': '마스터',\n      '2': '마스터키즈',\n      '3': '시니어',\n      '4': '주니어',\n    },\n  };\n\n  if (!(language in userLevelMapping)) {\n    throw new Error(`지원하지 않는 언어입니다. language: ${language}`);\n  }\n\n  if (!(level in userLevelMapping[language])) {\n    throw new Error(`지원하지 않는 레벨입니다. level: ${level}`);\n  }\n\n  return userLevelMapping[language][level];\n};\n\nexport const DomainFormat = {\n  modeName: formatModeName,\n  modeColor: formatModeColor,\n  wind: formatWind,\n  airLevelName: formatAirLevelName,\n  airLevelColor: formatAirLevelColor,\n  userLevel: formatUserLevel,\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,eAAe,MAAY,gBAAwC,CAAC,GAAW;AACtF,QAAM,qBAA2C;AAAA,IAC/C,GAAG;AAAA,IACH,GAAG;AAAA,IACH,GAAG;AAAA,EACL;AAEA,QAAM,kBAAkB,EAAE,GAAG,oBAAoB,GAAG,cAAc;AAElE,MAAI,EAAE,QAAQ,kBAAkB;AAC9B,UAAM,IAAI,MAAM,+EAAwB,IAAI,EAAE;AAAA,EAChD;AAEA,SAAO,gBAAgB,IAAI;AAC7B;AAEA,SAAS,gBAAgB,MAAY,gBAAwC,CAAC,GAAG;AAC/E,QAAM,sBAA4C;AAAA,IAChD,GAAG;AAAA,IACH,GAAG;AAAA,IACH,GAAG;AAAA,EACL;AAEA,QAAM,kBAAkB,EAAE,GAAG,qBAAqB,GAAG,cAAc;AAEnE,MAAI,EAAE,QAAQ,kBAAkB;AAC9B,UAAM,IAAI,MAAM,+EAAwB,IAAI,EAAE;AAAA,EAChD;AAEA,SAAO,gBAAgB,IAAI;AAC7B;AAEA,SAAS,WAAW,MAAY,gBAAwC,CAAC,GAAG;AAC1E,QAAM,qBAA2C;AAAA,IAC/C,GAAG;AAAA,IACH,GAAG;AAAA,IACH,GAAG;AAAA,EACL;AAEA,QAAM,kBAAkB,EAAE,GAAG,oBAAoB,GAAG,cAAc;AAElE,MAAI,EAAE,QAAQ,kBAAkB;AAC9B,UAAM,IAAI,MAAM,+EAAwB,IAAI,EAAE;AAAA,EAChD;AAEA,SAAO,gBAAgB,IAAI;AAC7B;AAEA,SAAS,mBAAmB,OAAiB;AAC3C,QAAM,kBAA4C;AAAA,IAChD,GAAG;AAAA,IACH,GAAG;AAAA,IACH,GAAG;AAAA,IACH,GAAG;AAAA,IACH,GAAG;AAAA,EACL;AAEA,MAAI,EAAE,SAAS,kBAAkB;AAC/B,UAAM,IAAI,MAAM,gFAAyB,KAAK,EAAE;AAAA,EAClD;AAEA,SAAO,gBAAgB,KAAK;AAC9B;AAEA,SAAS,oBAAoB,OAAiB;AAC5C,QAAM,eAAyC;AAAA,IAC7C,GAAG;AAAA,IACH,GAAG;AAAA,IACH,GAAG;AAAA,IACH,GAAG;AAAA,IACH,GAAG;AAAA,EACL;AAEA,MAAI,EAAE,SAAS,eAAe;AAC5B,UAAM,IAAI,MAAM,gFAAyB,KAAK,EAAE;AAAA,EAClD;AAEA,SAAO,aAAa,KAAK;AAC3B;AAEA,IAAM,kBAAkB,CAAC,EAAE,OAAO,WAAW,KAAK,MAAiD;AACjG,QAAM,mBAAgE;AAAA,IACpE,IAAI;AAAA,MACF,KAAK;AAAA,MACL,KAAK;AAAA,MACL,KAAK;AAAA,MACL,KAAK;AAAA,IACP;AAAA,IACA,IAAI;AAAA,MACF,KAAK;AAAA,MACL,KAAK;AAAA,MACL,KAAK;AAAA,MACL,KAAK;AAAA,IACP;AAAA,EACF;AAEA,MAAI,EAAE,YAAY,mBAAmB;AACnC,UAAM,IAAI,MAAM,mFAA4B,QAAQ,EAAE;AAAA,EACxD;AAEA,MAAI,EAAE,SAAS,iBAAiB,QAAQ,IAAI;AAC1C,UAAM,IAAI,MAAM,gFAAyB,KAAK,EAAE;AAAA,EAClD;AAEA,SAAO,iBAAiB,QAAQ,EAAE,KAAK;AACzC;AAEO,IAAM,eAAe;AAAA,EAC1B,UAAU;AAAA,EACV,WAAW;AAAA,EACX,MAAM;AAAA,EACN,cAAc;AAAA,EACd,eAAe;AAAA,EACf,WAAW;AACb;","names":[]}

package/dist/DomainFormat.mjs

@@ -0,0 +1,7 @@
+import {
+  DomainFormat
+} from "./chunk-WWR7M6ID.mjs";
+export {
+  DomainFormat
+};
+//# sourceMappingURL=DomainFormat.mjs.map

package/dist/DomainFormat.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/chunk-D2YRH4XY.mjs

@@ -0,0 +1,19 @@
+// src/useCombinedRefs.ts
+import { useCallback } from "react";
+var useCombinedRefs = (...refs) => useCallback(
+  (element) => refs.forEach((ref) => {
+    if (!ref) {
+      return;
+    }
+    if (typeof ref === "function") {
+      return ref(element);
+    }
+    ref.current = element;
+  }),
+  [refs]
+);
+
+export {
+  useCombinedRefs
+};
+//# sourceMappingURL=chunk-D2YRH4XY.mjs.map

package/dist/chunk-D2YRH4XY.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/useCombinedRefs.ts"],"sourcesContent":["import { type Ref, useCallback } from 'react';\n// Reference: https://github.com/facebook/react/issues/13029#issuecomment-497641073\nexport const useCombinedRefs = <T>(...refs: Array<Ref<T>>): Ref<T> =>\n  useCallback(\n    (element: T) =>\n      refs.forEach((ref) => {\n        if (!ref) {\n          return;\n        }\n        if (typeof ref === 'function') {\n          return ref(element);\n        }\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        (ref as any).current = element;\n      }),\n    [refs]\n  );\n"],"mappings":";AAAA,SAAmB,mBAAmB;AAE/B,IAAM,kBAAkB,IAAO,SACpC;AAAA,EACE,CAAC,YACC,KAAK,QAAQ,CAAC,QAAQ;AACpB,QAAI,CAAC,KAAK;AACR;AAAA,IACF;AACA,QAAI,OAAO,QAAQ,YAAY;AAC7B,aAAO,IAAI,OAAO;AAAA,IACpB;AAEA,IAAC,IAAY,UAAU;AAAA,EACzB,CAAC;AAAA,EACH,CAAC,IAAI;AACP;","names":[]}

package/dist/chunk-HOC4D4DT.mjs

@@ -0,0 +1,57 @@
+import {
+  usePreservedCallback_default
+} from "./chunk-QGQNMD22.mjs";
+
+// src/useControllableState.ts
+import * as React from "react";
+function noop() {
+}
+var useControllableState = ({
+  prop,
+  defaultProp,
+  onChange = noop
+}) => {
+  const [uncontrolledProp, setUncontrolledProp] = useUncontrolledState({
+    defaultProp,
+    onChange
+  });
+  const isControlled = prop !== void 0;
+  const value = isControlled ? prop : uncontrolledProp;
+  const handleChange = usePreservedCallback_default(onChange);
+  const setValue = React.useCallback(
+    (nextValue) => {
+      if (isControlled) {
+        const setter = nextValue;
+        const value2 = typeof nextValue === "function" ? setter(prop) : nextValue;
+        if (value2 !== prop) handleChange(value2);
+      } else {
+        setUncontrolledProp(nextValue);
+      }
+    },
+    [isControlled, prop, setUncontrolledProp, handleChange]
+  );
+  return [value, setValue];
+};
+var useUncontrolledState = ({
+  defaultProp,
+  onChange = noop
+}) => {
+  const uncontrolledState = React.useState(defaultProp);
+  const [value] = uncontrolledState;
+  const prevValueRef = React.useRef(value);
+  const handleChange = usePreservedCallback_default(onChange);
+  React.useEffect(() => {
+    if (prevValueRef.current !== value) {
+      handleChange(value);
+      prevValueRef.current = value;
+    }
+  }, [value, prevValueRef, handleChange]);
+  return uncontrolledState;
+};
+var useControllableState_default = useControllableState;
+
+export {
+  useControllableState,
+  useControllableState_default
+};
+//# sourceMappingURL=chunk-HOC4D4DT.mjs.map

package/dist/chunk-HOC4D4DT.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/useControllableState.ts"],"sourcesContent":["import * as React from 'react';\n\nimport usePreservedCallback from './usePreservedCallback';\n// eslint-disable-next-line @typescript-eslint/no-empty-function\nfunction noop() {}\nexport type UseControllableStateParams<T> = {\n  prop?: T | undefined;\n  defaultProp?: T | undefined;\n  onChange?: (state: T) => void;\n};\ntype SetStateFn<T> = (prevState?: T) => T;\n/**\n * @description\n * Radix UI's useControllableState\n */\nexport const useControllableState = <T>({\n  prop,\n  defaultProp,\n  onChange = noop,\n}: UseControllableStateParams<T>) => {\n  const [uncontrolledProp, setUncontrolledProp] = useUncontrolledState({\n    defaultProp,\n    onChange,\n  });\n  const isControlled = prop !== undefined;\n  const value = isControlled ? prop : uncontrolledProp;\n  const handleChange = usePreservedCallback(onChange);\n  const setValue: React.Dispatch<React.SetStateAction<T | undefined>> = React.useCallback(\n    (nextValue) => {\n      if (isControlled) {\n        const setter = nextValue as SetStateFn<T>;\n        const value = typeof nextValue === 'function' ? setter(prop) : nextValue;\n        if (value !== prop) handleChange(value as T);\n      } else {\n        setUncontrolledProp(nextValue);\n      }\n    },\n    [isControlled, prop, setUncontrolledProp, handleChange]\n  );\n  return [value, setValue] as const;\n};\nconst useUncontrolledState = <T>({\n  defaultProp,\n  onChange = noop,\n}: Omit<UseControllableStateParams<T>, 'prop'>) => {\n  const uncontrolledState = React.useState<T | undefined>(defaultProp);\n  const [value] = uncontrolledState;\n  const prevValueRef = React.useRef(value);\n  const handleChange = usePreservedCallback(onChange);\n  React.useEffect(() => {\n    if (prevValueRef.current !== value) {\n      handleChange(value as T);\n      prevValueRef.current = value;\n    }\n  }, [value, prevValueRef, handleChange]);\n  return uncontrolledState;\n};\nexport default useControllableState;\n"],"mappings":";;;;;AAAA,YAAY,WAAW;AAIvB,SAAS,OAAO;AAAC;AAWV,IAAM,uBAAuB,CAAI;AAAA,EACtC;AAAA,EACA;AAAA,EACA,WAAW;AACb,MAAqC;AACnC,QAAM,CAAC,kBAAkB,mBAAmB,IAAI,qBAAqB;AAAA,IACnE;AAAA,IACA;AAAA,EACF,CAAC;AACD,QAAM,eAAe,SAAS;AAC9B,QAAM,QAAQ,eAAe,OAAO;AACpC,QAAM,eAAe,6BAAqB,QAAQ;AAClD,QAAM,WAAsE;AAAA,IAC1E,CAAC,cAAc;AACb,UAAI,cAAc;AAChB,cAAM,SAAS;AACf,cAAMA,SAAQ,OAAO,cAAc,aAAa,OAAO,IAAI,IAAI;AAC/D,YAAIA,WAAU,KAAM,cAAaA,MAAU;AAAA,MAC7C,OAAO;AACL,4BAAoB,SAAS;AAAA,MAC/B;AAAA,IACF;AAAA,IACA,CAAC,cAAc,MAAM,qBAAqB,YAAY;AAAA,EACxD;AACA,SAAO,CAAC,OAAO,QAAQ;AACzB;AACA,IAAM,uBAAuB,CAAI;AAAA,EAC/B;AAAA,EACA,WAAW;AACb,MAAmD;AACjD,QAAM,oBAA0B,eAAwB,WAAW;AACnE,QAAM,CAAC,KAAK,IAAI;AAChB,QAAM,eAAqB,aAAO,KAAK;AACvC,QAAM,eAAe,6BAAqB,QAAQ;AAClD,EAAM,gBAAU,MAAM;AACpB,QAAI,aAAa,YAAY,OAAO;AAClC,mBAAa,KAAU;AACvB,mBAAa,UAAU;AAAA,IACzB;AAAA,EACF,GAAG,CAAC,OAAO,cAAc,YAAY,CAAC;AACtC,SAAO;AACT;AACA,IAAO,+BAAQ;","names":["value"]}

package/dist/chunk-QGQNMD22.mjs

@@ -0,0 +1,15 @@
+// src/usePreservedCallback.ts
+import { useEffect, useMemo, useRef } from "react";
+var usePreservedCallback = (callback) => {
+  const callbackRef = useRef(callback);
+  useEffect(() => {
+    callbackRef.current = callback;
+  }, [callback]);
+  return useMemo(() => (...args) => callbackRef.current?.(...args), []);
+};
+var usePreservedCallback_default = usePreservedCallback;
+
+export {
+  usePreservedCallback_default
+};
+//# sourceMappingURL=chunk-QGQNMD22.mjs.map

package/dist/chunk-QGQNMD22.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/usePreservedCallback.ts"],"sourcesContent":["import { useEffect, useMemo, useRef } from 'react';\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nconst usePreservedCallback = <T extends (...args: any[]) => any>(callback: T): T => {\n  const callbackRef = useRef(callback);\n  useEffect(() => {\n    callbackRef.current = callback;\n  }, [callback]);\n  return useMemo(() => ((...args) => callbackRef.current?.(...args)) as T, []);\n};\nexport default usePreservedCallback;\n"],"mappings":";AAAA,SAAS,WAAW,SAAS,cAAc;AAE3C,IAAM,uBAAuB,CAAoC,aAAmB;AAClF,QAAM,cAAc,OAAO,QAAQ;AACnC,YAAU,MAAM;AACd,gBAAY,UAAU;AAAA,EACxB,GAAG,CAAC,QAAQ,CAAC;AACb,SAAO,QAAQ,MAAO,IAAI,SAAS,YAAY,UAAU,GAAG,IAAI,GAAS,CAAC,CAAC;AAC7E;AACA,IAAO,+BAAQ;","names":[]}

package/dist/chunk-WWR7M6ID.mjs

@@ -0,0 +1,99 @@
+// src/DomainFormat.ts
+function formatModeName(mode, customMapping = {}) {
+  const defaultModeMapping = {
+    H: "\uB09C\uBC29",
+    C: "\uB0C9\uBC29",
+    W: "\uC1A1\uD48D"
+  };
+  const combinedMapping = { ...defaultModeMapping, ...customMapping };
+  if (!(mode in combinedMapping)) {
+    throw new Error(`\uC9C0\uC6D0\uD558\uC9C0 \uC54A\uB294 \uBAA8\uB4DC\uC785\uB2C8\uB2E4. mode: ${mode}`);
+  }
+  return combinedMapping[mode];
+}
+function formatModeColor(mode, customMapping = {}) {
+  const defaultColorMapping = {
+    H: "#e77676",
+    C: "#9fc6ff",
+    W: "#a8e379"
+  };
+  const combinedMapping = { ...defaultColorMapping, ...customMapping };
+  if (!(mode in combinedMapping)) {
+    throw new Error(`\uC9C0\uC6D0\uD558\uC9C0 \uC54A\uB294 \uBAA8\uB4DC\uC785\uB2C8\uB2E4. mode: ${mode}`);
+  }
+  return combinedMapping[mode];
+}
+function formatWind(wind, customMapping = {}) {
+  const defaultWindMapping = {
+    1: "\uBBF8\uD48D",
+    2: "\uC57D\uD48D",
+    3: "\uAC15\uD48D"
+  };
+  const combinedMapping = { ...defaultWindMapping, ...customMapping };
+  if (!(wind in combinedMapping)) {
+    throw new Error(`\uC9C0\uC6D0\uD558\uC9C0 \uC54A\uB294 \uD48D\uB7C9\uC785\uB2C8\uB2E4. wind: ${wind}`);
+  }
+  return combinedMapping[wind];
+}
+function formatAirLevelName(level) {
+  const airLevelMapping = {
+    1: "\uB9E4\uC6B0 \uB098\uC068",
+    2: "\uB098\uC068",
+    3: "\uBCF4\uD1B5",
+    4: "\uC88B\uC74C",
+    5: "\uB9E4\uC6B0 \uC88B\uC74C"
+  };
+  if (!(level in airLevelMapping)) {
+    throw new Error(`\uC9C0\uC6D0\uD558\uC9C0 \uC54A\uB294 \uB808\uBCA8\uC785\uB2C8\uB2E4. level: ${level}`);
+  }
+  return airLevelMapping[level];
+}
+function formatAirLevelColor(level) {
+  const colorMapping = {
+    1: "#ff5d47",
+    2: "#ff961c",
+    3: "#ffca42",
+    4: "#63ff60",
+    5: "#49ffe9"
+  };
+  if (!(level in colorMapping)) {
+    throw new Error(`\uC9C0\uC6D0\uD558\uC9C0 \uC54A\uB294 \uB808\uBCA8\uC785\uB2C8\uB2E4. level: ${level}`);
+  }
+  return colorMapping[level];
+}
+var formatUserLevel = ({ level, language = "ko" }) => {
+  const userLevelMapping = {
+    en: {
+      "1": "MASTER",
+      "2": "MASTER KID",
+      "3": "SENIOR",
+      "4": "JUNIOR"
+    },
+    ko: {
+      "1": "\uB9C8\uC2A4\uD130",
+      "2": "\uB9C8\uC2A4\uD130\uD0A4\uC988",
+      "3": "\uC2DC\uB2C8\uC5B4",
+      "4": "\uC8FC\uB2C8\uC5B4"
+    }
+  };
+  if (!(language in userLevelMapping)) {
+    throw new Error(`\uC9C0\uC6D0\uD558\uC9C0 \uC54A\uB294 \uC5B8\uC5B4\uC785\uB2C8\uB2E4. language: ${language}`);
+  }
+  if (!(level in userLevelMapping[language])) {
+    throw new Error(`\uC9C0\uC6D0\uD558\uC9C0 \uC54A\uB294 \uB808\uBCA8\uC785\uB2C8\uB2E4. level: ${level}`);
+  }
+  return userLevelMapping[language][level];
+};
+var DomainFormat = {
+  modeName: formatModeName,
+  modeColor: formatModeColor,
+  wind: formatWind,
+  airLevelName: formatAirLevelName,
+  airLevelColor: formatAirLevelColor,
+  userLevel: formatUserLevel
+};
+
+export {
+  DomainFormat
+};
+//# sourceMappingURL=chunk-WWR7M6ID.mjs.map

package/dist/chunk-WWR7M6ID.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/DomainFormat.ts"],"sourcesContent":["export type Mode = 'H' | 'C' | 'W';\nexport type Wind = 1 | 2 | 3;\nexport type AirLevel = 1 | 2 | 3 | 4 | 5;\nexport type UserLevel = '1' | '2' | '3' | '4';\nexport type Language = 'en' | 'ko';\n\nfunction formatModeName(mode: Mode, customMapping: Record<string, string> = {}): string {\n  const defaultModeMapping: Record<Mode, string> = {\n    H: '난방',\n    C: '냉방',\n    W: '송풍',\n  };\n\n  const combinedMapping = { ...defaultModeMapping, ...customMapping };\n\n  if (!(mode in combinedMapping)) {\n    throw new Error(`지원하지 않는 모드입니다. mode: ${mode}`);\n  }\n\n  return combinedMapping[mode];\n}\n\nfunction formatModeColor(mode: Mode, customMapping: Record<string, string> = {}) {\n  const defaultColorMapping: Record<Mode, string> = {\n    H: '#e77676',\n    C: '#9fc6ff',\n    W: '#a8e379',\n  };\n\n  const combinedMapping = { ...defaultColorMapping, ...customMapping };\n\n  if (!(mode in combinedMapping)) {\n    throw new Error(`지원하지 않는 모드입니다. mode: ${mode}`);\n  }\n\n  return combinedMapping[mode];\n}\n\nfunction formatWind(wind: Wind, customMapping: Record<string, string> = {}) {\n  const defaultWindMapping: Record<Wind, string> = {\n    1: '미풍',\n    2: '약풍',\n    3: '강풍',\n  };\n\n  const combinedMapping = { ...defaultWindMapping, ...customMapping };\n\n  if (!(wind in combinedMapping)) {\n    throw new Error(`지원하지 않는 풍량입니다. wind: ${wind}`);\n  }\n\n  return combinedMapping[wind];\n}\n\nfunction formatAirLevelName(level: AirLevel) {\n  const airLevelMapping: Record<AirLevel, string> = {\n    1: '매우 나쁨',\n    2: '나쁨',\n    3: '보통',\n    4: '좋음',\n    5: '매우 좋음',\n  };\n\n  if (!(level in airLevelMapping)) {\n    throw new Error(`지원하지 않는 레벨입니다. level: ${level}`);\n  }\n\n  return airLevelMapping[level];\n}\n\nfunction formatAirLevelColor(level: AirLevel) {\n  const colorMapping: Record<AirLevel, string> = {\n    1: '#ff5d47',\n    2: '#ff961c',\n    3: '#ffca42',\n    4: '#63ff60',\n    5: '#49ffe9',\n  };\n\n  if (!(level in colorMapping)) {\n    throw new Error(`지원하지 않는 레벨입니다. level: ${level}`);\n  }\n\n  return colorMapping[level];\n}\n\nconst formatUserLevel = ({ level, language = 'ko' }: { level: UserLevel; language?: Language }) => {\n  const userLevelMapping: Record<Language, Record<UserLevel, string>> = {\n    en: {\n      '1': 'MASTER',\n      '2': 'MASTER KID',\n      '3': 'SENIOR',\n      '4': 'JUNIOR',\n    },\n    ko: {\n      '1': '마스터',\n      '2': '마스터키즈',\n      '3': '시니어',\n      '4': '주니어',\n    },\n  };\n\n  if (!(language in userLevelMapping)) {\n    throw new Error(`지원하지 않는 언어입니다. language: ${language}`);\n  }\n\n  if (!(level in userLevelMapping[language])) {\n    throw new Error(`지원하지 않는 레벨입니다. level: ${level}`);\n  }\n\n  return userLevelMapping[language][level];\n};\n\nexport const DomainFormat = {\n  modeName: formatModeName,\n  modeColor: formatModeColor,\n  wind: formatWind,\n  airLevelName: formatAirLevelName,\n  airLevelColor: formatAirLevelColor,\n  userLevel: formatUserLevel,\n};\n"],"mappings":";AAMA,SAAS,eAAe,MAAY,gBAAwC,CAAC,GAAW;AACtF,QAAM,qBAA2C;AAAA,IAC/C,GAAG;AAAA,IACH,GAAG;AAAA,IACH,GAAG;AAAA,EACL;AAEA,QAAM,kBAAkB,EAAE,GAAG,oBAAoB,GAAG,cAAc;AAElE,MAAI,EAAE,QAAQ,kBAAkB;AAC9B,UAAM,IAAI,MAAM,+EAAwB,IAAI,EAAE;AAAA,EAChD;AAEA,SAAO,gBAAgB,IAAI;AAC7B;AAEA,SAAS,gBAAgB,MAAY,gBAAwC,CAAC,GAAG;AAC/E,QAAM,sBAA4C;AAAA,IAChD,GAAG;AAAA,IACH,GAAG;AAAA,IACH,GAAG;AAAA,EACL;AAEA,QAAM,kBAAkB,EAAE,GAAG,qBAAqB,GAAG,cAAc;AAEnE,MAAI,EAAE,QAAQ,kBAAkB;AAC9B,UAAM,IAAI,MAAM,+EAAwB,IAAI,EAAE;AAAA,EAChD;AAEA,SAAO,gBAAgB,IAAI;AAC7B;AAEA,SAAS,WAAW,MAAY,gBAAwC,CAAC,GAAG;AAC1E,QAAM,qBAA2C;AAAA,IAC/C,GAAG;AAAA,IACH,GAAG;AAAA,IACH,GAAG;AAAA,EACL;AAEA,QAAM,kBAAkB,EAAE,GAAG,oBAAoB,GAAG,cAAc;AAElE,MAAI,EAAE,QAAQ,kBAAkB;AAC9B,UAAM,IAAI,MAAM,+EAAwB,IAAI,EAAE;AAAA,EAChD;AAEA,SAAO,gBAAgB,IAAI;AAC7B;AAEA,SAAS,mBAAmB,OAAiB;AAC3C,QAAM,kBAA4C;AAAA,IAChD,GAAG;AAAA,IACH,GAAG;AAAA,IACH,GAAG;AAAA,IACH,GAAG;AAAA,IACH,GAAG;AAAA,EACL;AAEA,MAAI,EAAE,SAAS,kBAAkB;AAC/B,UAAM,IAAI,MAAM,gFAAyB,KAAK,EAAE;AAAA,EAClD;AAEA,SAAO,gBAAgB,KAAK;AAC9B;AAEA,SAAS,oBAAoB,OAAiB;AAC5C,QAAM,eAAyC;AAAA,IAC7C,GAAG;AAAA,IACH,GAAG;AAAA,IACH,GAAG;AAAA,IACH,GAAG;AAAA,IACH,GAAG;AAAA,EACL;AAEA,MAAI,EAAE,SAAS,eAAe;AAC5B,UAAM,IAAI,MAAM,gFAAyB,KAAK,EAAE;AAAA,EAClD;AAEA,SAAO,aAAa,KAAK;AAC3B;AAEA,IAAM,kBAAkB,CAAC,EAAE,OAAO,WAAW,KAAK,MAAiD;AACjG,QAAM,mBAAgE;AAAA,IACpE,IAAI;AAAA,MACF,KAAK;AAAA,MACL,KAAK;AAAA,MACL,KAAK;AAAA,MACL,KAAK;AAAA,IACP;AAAA,IACA,IAAI;AAAA,MACF,KAAK;AAAA,MACL,KAAK;AAAA,MACL,KAAK;AAAA,MACL,KAAK;AAAA,IACP;AAAA,EACF;AAEA,MAAI,EAAE,YAAY,mBAAmB;AACnC,UAAM,IAAI,MAAM,mFAA4B,QAAQ,EAAE;AAAA,EACxD;AAEA,MAAI,EAAE,SAAS,iBAAiB,QAAQ,IAAI;AAC1C,UAAM,IAAI,MAAM,gFAAyB,KAAK,EAAE;AAAA,EAClD;AAEA,SAAO,iBAAiB,QAAQ,EAAE,KAAK;AACzC;AAEO,IAAM,eAAe;AAAA,EAC1B,UAAU;AAAA,EACV,WAAW;AAAA,EACX,MAAM;AAAA,EACN,cAAc;AAAA,EACd,eAAe;AAAA,EACf,WAAW;AACb;","names":[]}

package/dist/index.d.mts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React from 'react';
-import React__default, { ReactNode, FC, PropsWithChildren, HTMLAttributes, CSSProperties, ComponentPropsWithoutRef } from 'react';
+import React__default, { ReactNode, FC, PropsWithChildren, HTMLAttributes, CSSProperties, ComponentPropsWithoutRef, Ref } from 'react';
 import * as styled_components from 'styled-components';
 
 type ChooseWhenProps = {
@@ -225,4 +225,39 @@ declare function formatCommaizeNumber(value: Value): string;
  */
 declare function padTime(value: Value): string;
 
-export { Choose, type ChooseOtherwiseProps, type ChooseProps, type ChooseWhenProps, type DebouncedFunction, Flex, type FlexProps, Format, type HexToRgbaProps, If, type IfProps, type JosaProps, type MultiLineEllipsisProps, SafeArea, type SafeAreaCssValueProps, type SafeAreaProps, Spacing, type SpacingProps, Validate, type VariableType, composeEventHandlers, createContext, debounce, ellipsis, getVar, hexToRgba, josa, multiLineEllipsis, queryString, useSafeArea };
+type Mode = 'H' | 'C' | 'W';
+type Wind = 1 | 2 | 3;
+type AirLevel = 1 | 2 | 3 | 4 | 5;
+type UserLevel = '1' | '2' | '3' | '4';
+type Language = 'en' | 'ko';
+declare function formatModeName(mode: Mode, customMapping?: Record<string, string>): string;
+declare function formatModeColor(mode: Mode, customMapping?: Record<string, string>): string;
+declare function formatWind(wind: Wind, customMapping?: Record<string, string>): string;
+declare function formatAirLevelName(level: AirLevel): string;
+declare function formatAirLevelColor(level: AirLevel): string;
+declare const DomainFormat: {
+    modeName: typeof formatModeName;
+    modeColor: typeof formatModeColor;
+    wind: typeof formatWind;
+    airLevelName: typeof formatAirLevelName;
+    airLevelColor: typeof formatAirLevelColor;
+    userLevel: ({ level, language }: {
+        level: UserLevel;
+        language?: Language;
+    }) => string;
+};
+
+declare const useCombinedRefs: <T>(...refs: Array<Ref<T>>) => Ref<T>;
+
+type UseControllableStateParams<T> = {
+    prop?: T | undefined;
+    defaultProp?: T | undefined;
+    onChange?: (state: T) => void;
+};
+/**
+ * @description
+ * Radix UI's useControllableState
+ */
+declare const useControllableState: <T>({ prop, defaultProp, onChange, }: UseControllableStateParams<T>) => readonly [T | undefined, React.Dispatch<React.SetStateAction<T | undefined>>];
+
+export { type AirLevel, Choose, type ChooseOtherwiseProps, type ChooseProps, type ChooseWhenProps, type DebouncedFunction, DomainFormat, Flex, type FlexProps, Format, type HexToRgbaProps, If, type IfProps, type JosaProps, type Mode, type MultiLineEllipsisProps, SafeArea, type SafeAreaCssValueProps, type SafeAreaProps, Spacing, type SpacingProps, type UseControllableStateParams, type UserLevel, Validate, type VariableType, type Wind, composeEventHandlers, createContext, debounce, ellipsis, getVar, hexToRgba, josa, multiLineEllipsis, queryString, useCombinedRefs, useControllableState, useSafeArea };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React from 'react';
-import React__default, { ReactNode, FC, PropsWithChildren, HTMLAttributes, CSSProperties, ComponentPropsWithoutRef } from 'react';
+import React__default, { ReactNode, FC, PropsWithChildren, HTMLAttributes, CSSProperties, ComponentPropsWithoutRef, Ref } from 'react';
 import * as styled_components from 'styled-components';
 
 type ChooseWhenProps = {
@@ -225,4 +225,39 @@ declare function formatCommaizeNumber(value: Value): string;
  */
 declare function padTime(value: Value): string;
 
-export { Choose, type ChooseOtherwiseProps, type ChooseProps, type ChooseWhenProps, type DebouncedFunction, Flex, type FlexProps, Format, type HexToRgbaProps, If, type IfProps, type JosaProps, type MultiLineEllipsisProps, SafeArea, type SafeAreaCssValueProps, type SafeAreaProps, Spacing, type SpacingProps, Validate, type VariableType, composeEventHandlers, createContext, debounce, ellipsis, getVar, hexToRgba, josa, multiLineEllipsis, queryString, useSafeArea };
+type Mode = 'H' | 'C' | 'W';
+type Wind = 1 | 2 | 3;
+type AirLevel = 1 | 2 | 3 | 4 | 5;
+type UserLevel = '1' | '2' | '3' | '4';
+type Language = 'en' | 'ko';
+declare function formatModeName(mode: Mode, customMapping?: Record<string, string>): string;
+declare function formatModeColor(mode: Mode, customMapping?: Record<string, string>): string;
+declare function formatWind(wind: Wind, customMapping?: Record<string, string>): string;
+declare function formatAirLevelName(level: AirLevel): string;
+declare function formatAirLevelColor(level: AirLevel): string;
+declare const DomainFormat: {
+    modeName: typeof formatModeName;
+    modeColor: typeof formatModeColor;
+    wind: typeof formatWind;
+    airLevelName: typeof formatAirLevelName;
+    airLevelColor: typeof formatAirLevelColor;
+    userLevel: ({ level, language }: {
+        level: UserLevel;
+        language?: Language;
+    }) => string;
+};
+
+declare const useCombinedRefs: <T>(...refs: Array<Ref<T>>) => Ref<T>;
+
+type UseControllableStateParams<T> = {
+    prop?: T | undefined;
+    defaultProp?: T | undefined;
+    onChange?: (state: T) => void;
+};
+/**
+ * @description
+ * Radix UI's useControllableState
+ */
+declare const useControllableState: <T>({ prop, defaultProp, onChange, }: UseControllableStateParams<T>) => readonly [T | undefined, React.Dispatch<React.SetStateAction<T | undefined>>];
+
+export { type AirLevel, Choose, type ChooseOtherwiseProps, type ChooseProps, type ChooseWhenProps, type DebouncedFunction, DomainFormat, Flex, type FlexProps, Format, type HexToRgbaProps, If, type IfProps, type JosaProps, type Mode, type MultiLineEllipsisProps, SafeArea, type SafeAreaCssValueProps, type SafeAreaProps, Spacing, type SpacingProps, type UseControllableStateParams, type UserLevel, Validate, type VariableType, type Wind, composeEventHandlers, createContext, debounce, ellipsis, getVar, hexToRgba, josa, multiLineEllipsis, queryString, useCombinedRefs, useControllableState, useSafeArea };