@basiln/utils 0.1.1 → 0.1.2

package/dist/index.mjs

@@ -0,0 +1,64 @@
+import {
+  createContext
+} from "./chunk-Z4QPISK7.mjs";
+import {
+  ellipsis,
+  multiLineEllipsis
+} from "./chunk-XBGZ3YNL.mjs";
+import {
+  getVar
+} from "./chunk-WHYNBO2G.mjs";
+import {
+  hexToRgba
+} from "./chunk-OIJ4AVT7.mjs";
+import {
+  josa
+} from "./chunk-SJJHTYZC.mjs";
+import "./chunk-C7VOPXT2.mjs";
+import "./chunk-GQPOYY4X.mjs";
+import {
+  queryString
+} from "./chunk-U4T3KW7L.mjs";
+import {
+  Choose
+} from "./chunk-7WNTKDNW.mjs";
+import {
+  Flex
+} from "./chunk-Q3B6WSD7.mjs";
+import {
+  If
+} from "./chunk-UFRXNT2I.mjs";
+import {
+  SafeArea
+} from "./chunk-WOYL5AA5.mjs";
+import {
+  useSafeArea
+} from "./chunk-FUGA35PJ.mjs";
+import {
+  Spacing
+} from "./chunk-LKUAG7PE.mjs";
+import {
+  Validate
+} from "./chunk-R23KSR7N.mjs";
+import "./chunk-T7K7QYTL.mjs";
+import {
+  composeEventHandlers
+} from "./chunk-QD5QDTUG.mjs";
+export {
+  Choose,
+  Flex,
+  If,
+  SafeArea,
+  Spacing,
+  Validate,
+  composeEventHandlers,
+  createContext,
+  ellipsis,
+  getVar,
+  hexToRgba,
+  josa,
+  multiLineEllipsis,
+  queryString,
+  useSafeArea
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

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

package/dist/josa.js

@@ -0,0 +1,133 @@
+"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/josa.ts
+var josa_exports = {};
+__export(josa_exports, {
+  josa: () => josa
+});
+module.exports = __toCommonJS(josa_exports);
+
+// src/constants/josa.ts
+var COMPLETE_HANGUL_START_CHARCODE = "\uAC00".charCodeAt(0);
+var COMPLETE_HANGUL_END_CHARCODE = "\uD7A3".charCodeAt(0);
+var NUMBER_OF_JONGSEONG = 28;
+var DISASSEMBLED_CONSONANTS_BY_CONSONANT = {
+  "": "",
+  \u3131: "\u3131",
+  \u3132: "\u3132",
+  \u3133: "\u3131\u3145",
+  \u3134: "\u3134",
+  \u3135: "\u3134\u3148",
+  \u3136: "\u3134\u314E",
+  \u3137: "\u3137",
+  \u3138: "\u3138",
+  \u3139: "\u3139",
+  \u313A: "\u3139\u3131",
+  \u313B: "\u3139\u3141",
+  \u313C: "\u3139\u3142",
+  \u313D: "\u3139\u3145",
+  \u313E: "\u3139\u314C",
+  \u313F: "\u3139\u314D",
+  \u3140: "\u3139\u314E",
+  \u3141: "\u3141",
+  \u3142: "\u3142",
+  \u3143: "\u3143",
+  \u3144: "\u3142\u3145",
+  \u3145: "\u3145",
+  \u3146: "\u3146",
+  \u3147: "\u3147",
+  \u3148: "\u3148",
+  \u3149: "\u3149",
+  \u314A: "\u314A",
+  \u314B: "\u314B",
+  \u314C: "\u314C",
+  \u314D: "\u314D",
+  \u314E: "\u314E"
+};
+var JONGSEONGS = [
+  "",
+  "\u3131",
+  "\u3132",
+  "\u3133",
+  "\u3134",
+  "\u3135",
+  "\u3136",
+  "\u3137",
+  "\u3139",
+  "\u313A",
+  "\u313B",
+  "\u313C",
+  "\u313D",
+  "\u313E",
+  "\u313F",
+  "\u3140",
+  "\u3141",
+  "\u3142",
+  "\u3144",
+  "\u3145",
+  "\u3146",
+  "\u3147",
+  "\u3148",
+  "\u314A",
+  "\u314B",
+  "\u314C",
+  "\u314D",
+  "\u314E"
+].map((consonant) => DISASSEMBLED_CONSONANTS_BY_CONSONANT[consonant]);
+
+// src/hasBatchim.ts
+function hasBatchim(str) {
+  const lastChar = str[str.length - 1];
+  if (!lastChar)
+    return false;
+  const charCode = lastChar.charCodeAt(0);
+  if (charCode < COMPLETE_HANGUL_START_CHARCODE || charCode > COMPLETE_HANGUL_END_CHARCODE) {
+    return false;
+  }
+  const batchimCode = (charCode - COMPLETE_HANGUL_START_CHARCODE) % NUMBER_OF_JONGSEONG;
+  return batchimCode > 0;
+}
+
+// src/josa.ts
+function josa(props) {
+  const { word, josa: josa2 } = props;
+  if (!word) {
+    return word;
+  }
+  return `${word}${josaPicker({
+    word,
+    josa: josa2
+  })}`;
+}
+function josaPicker(props) {
+  const { word, josa: josa2 } = props;
+  if (!word) {
+    return josa2.split("/")[0];
+  }
+  const has\uBC1B\uCE68 = hasBatchim(word);
+  const index = has\uBC1B\uCE68 ? 0 : 1;
+  return josa2.split("/")[index];
+}
+josa.pick = josaPicker;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  josa
+});
+//# sourceMappingURL=josa.js.map

package/dist/josa.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/josa.ts","../src/constants/josa.ts","../src/hasBatchim.ts"],"sourcesContent":["import { hasBatchim } from './hasBatchim';\n\ntype JosaOption = '이/가' | '을/를' | '은/는';\n\ntype ExtractJosaOption<T> = T extends `${infer A}/${infer B}` ? A | B : never;\n\nexport type JosaProps<U extends JosaOption> = {\n  word: string;\n  josa: U;\n};\n\n/**\n * 주어진 단어와 조사 옵션을 기반으로 올바른 조사를 반환합니다.\n * @returns 단어와 올바른 조사가 결합된 문자열\n */\nexport function josa<U extends JosaOption>(\n  props: JosaProps<U>\n): `${JosaProps<U>['word']}${ExtractJosaOption<U>}` {\n  const { word, josa } = props;\n\n  if (!word) {\n    return word as `${JosaProps<U>['word']}${ExtractJosaOption<U>}`;\n  }\n\n  return `${word}${josaPicker({\n    word,\n    josa,\n  })}` as `${JosaProps<U>['word']}${ExtractJosaOption<U>}`;\n}\n\n/**\n * 주어진 단어와 조사 옵션을 기반으로 올바른 조사를 선택합니다.\n * @returns 올바른 조사\n */\nfunction josaPicker<U extends JosaOption>(\n  props: JosaProps<U>\n): ExtractJosaOption<U> {\n  const { word, josa } = props;\n\n  if (!word) {\n    return josa.split('/')[0] as ExtractJosaOption<U>;\n  }\n\n  const has받침 = hasBatchim(word);\n  const index = has받침 ? 0 : 1;\n\n  return josa.split('/')[index] as ExtractJosaOption<U>;\n}\n\njosa.pick = josaPicker;\n","export const COMPLETE_HANGUL_START_CHARCODE = '가'.charCodeAt(0);\nexport const COMPLETE_HANGUL_END_CHARCODE = '힣'.charCodeAt(0);\n\nexport const NUMBER_OF_JONGSEONG = 28;\nexport const NUMBER_OF_JUNGSEONG = 21;\n\nconst DISASSEMBLED_CONSONANTS_BY_CONSONANT = {\n  '': '',\n  ㄱ: 'ㄱ',\n  ㄲ: 'ㄲ',\n  ㄳ: 'ㄱㅅ',\n  ㄴ: 'ㄴ',\n  ㄵ: 'ㄴㅈ',\n  ㄶ: 'ㄴㅎ',\n  ㄷ: 'ㄷ',\n  ㄸ: 'ㄸ',\n  ㄹ: 'ㄹ',\n  ㄺ: 'ㄹㄱ',\n  ㄻ: 'ㄹㅁ',\n  ㄼ: 'ㄹㅂ',\n  ㄽ: 'ㄹㅅ',\n  ㄾ: 'ㄹㅌ',\n  ㄿ: 'ㄹㅍ',\n  ㅀ: 'ㄹㅎ',\n  ㅁ: 'ㅁ',\n  ㅂ: 'ㅂ',\n  ㅃ: 'ㅃ',\n  ㅄ: 'ㅂㅅ',\n  ㅅ: 'ㅅ',\n  ㅆ: 'ㅆ',\n  ㅇ: 'ㅇ',\n  ㅈ: 'ㅈ',\n  ㅉ: 'ㅉ',\n  ㅊ: 'ㅊ',\n  ㅋ: 'ㅋ',\n  ㅌ: 'ㅌ',\n  ㅍ: 'ㅍ',\n  ㅎ: 'ㅎ',\n} as const;\n\nexport const JONGSEONGS = (\n  [\n    '',\n    'ㄱ',\n    'ㄲ',\n    'ㄳ',\n    'ㄴ',\n    'ㄵ',\n    'ㄶ',\n    'ㄷ',\n    'ㄹ',\n    'ㄺ',\n    'ㄻ',\n    'ㄼ',\n    'ㄽ',\n    'ㄾ',\n    'ㄿ',\n    'ㅀ',\n    'ㅁ',\n    'ㅂ',\n    'ㅄ',\n    'ㅅ',\n    'ㅆ',\n    'ㅇ',\n    'ㅈ',\n    'ㅊ',\n    'ㅋ',\n    'ㅌ',\n    'ㅍ',\n    'ㅎ',\n  ] as const\n).map((consonant) => DISASSEMBLED_CONSONANTS_BY_CONSONANT[consonant]);\n","import {\n  COMPLETE_HANGUL_END_CHARCODE,\n  COMPLETE_HANGUL_START_CHARCODE,\n  NUMBER_OF_JONGSEONG,\n} from './constants/josa';\n\n/**\n * 한글 음절의 받침 유무를 확인합니다.\n * @param str - 검사할 문자열\n * @returns 받침이 있으면 true, 없으면 false\n */\nexport function hasBatchim(str: string): boolean {\n  const lastChar = str[str.length - 1];\n  if (!lastChar) return false;\n\n  const charCode = lastChar.charCodeAt(0);\n\n  // 한글 완성형 문자인지 확인\n  if (\n    charCode < COMPLETE_HANGUL_START_CHARCODE ||\n    charCode > COMPLETE_HANGUL_END_CHARCODE\n  ) {\n    return false;\n  }\n\n  // 받침 코드 계산\n  const batchimCode =\n    (charCode - COMPLETE_HANGUL_START_CHARCODE) % NUMBER_OF_JONGSEONG;\n\n  return batchimCode > 0; // 받침이 있으면 true\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAO,IAAM,iCAAiC,SAAI,WAAW,CAAC;AACvD,IAAM,+BAA+B,SAAI,WAAW,CAAC;AAErD,IAAM,sBAAsB;AAGnC,IAAM,uCAAuC;AAAA,EAC3C,IAAI;AAAA,EACJ,QAAG;AAAA,EACH,QAAG;AAAA,EACH,QAAG;AAAA,EACH,QAAG;AAAA,EACH,QAAG;AAAA,EACH,QAAG;AAAA,EACH,QAAG;AAAA,EACH,QAAG;AAAA,EACH,QAAG;AAAA,EACH,QAAG;AAAA,EACH,QAAG;AAAA,EACH,QAAG;AAAA,EACH,QAAG;AAAA,EACH,QAAG;AAAA,EACH,QAAG;AAAA,EACH,QAAG;AAAA,EACH,QAAG;AAAA,EACH,QAAG;AAAA,EACH,QAAG;AAAA,EACH,QAAG;AAAA,EACH,QAAG;AAAA,EACH,QAAG;AAAA,EACH,QAAG;AAAA,EACH,QAAG;AAAA,EACH,QAAG;AAAA,EACH,QAAG;AAAA,EACH,QAAG;AAAA,EACH,QAAG;AAAA,EACH,QAAG;AAAA,EACH,QAAG;AACL;AAEO,IAAM,aACX;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,EACA,IAAI,CAAC,cAAc,qCAAqC,SAAS,CAAC;;;AC5D7D,SAAS,WAAW,KAAsB;AAC/C,QAAM,WAAW,IAAI,IAAI,SAAS,CAAC;AACnC,MAAI,CAAC;AAAU,WAAO;AAEtB,QAAM,WAAW,SAAS,WAAW,CAAC;AAGtC,MACE,WAAW,kCACX,WAAW,8BACX;AACA,WAAO;AAAA,EACT;AAGA,QAAM,eACH,WAAW,kCAAkC;AAEhD,SAAO,cAAc;AACvB;;;AFfO,SAAS,KACd,OACkD;AAClD,QAAM,EAAE,MAAM,MAAAA,MAAK,IAAI;AAEvB,MAAI,CAAC,MAAM;AACT,WAAO;AAAA,EACT;AAEA,SAAO,GAAG,OAAO,WAAW;AAAA,IAC1B;AAAA,IACA,MAAAA;AAAA,EACF,CAAC;AACH;AAMA,SAAS,WACP,OACsB;AACtB,QAAM,EAAE,MAAM,MAAAA,MAAK,IAAI;AAEvB,MAAI,CAAC,MAAM;AACT,WAAOA,MAAK,MAAM,GAAG,EAAE,CAAC;AAAA,EAC1B;AAEA,QAAM,kBAAQ,WAAW,IAAI;AAC7B,QAAM,QAAQ,kBAAQ,IAAI;AAE1B,SAAOA,MAAK,MAAM,GAAG,EAAE,KAAK;AAC9B;AAEA,KAAK,OAAO;","names":["josa"]}

package/dist/josa.mjs

@@ -0,0 +1,9 @@
+import {
+  josa
+} from "./chunk-SJJHTYZC.mjs";
+import "./chunk-C7VOPXT2.mjs";
+import "./chunk-GQPOYY4X.mjs";
+export {
+  josa
+};
+//# sourceMappingURL=josa.mjs.map

package/dist/josa.mjs.map

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

package/dist/queryString.js

@@ -0,0 +1,91 @@
+"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/queryString.ts
+var queryString_exports = {};
+__export(queryString_exports, {
+  queryString: () => queryString
+});
+module.exports = __toCommonJS(queryString_exports);
+function createSearchParamString(params) {
+  return new URLSearchParams(
+    Object.entries(params).filter(([, value]) => value != null).map(([key, value]) => {
+      if (Array.isArray(value)) {
+        return value.map((x) => [key, x]);
+      }
+      return [[key, value]];
+    }).flat()
+  ).toString().replace(/\+/g, "%20");
+}
+function createQueryString(params) {
+  const queryString2 = createSearchParamString(params);
+  if (queryString2 === "") {
+    return "";
+  }
+  return `?${queryString2}`;
+}
+function fromEntries(iterable) {
+  const result = {};
+  for (const [key, value] of Array.from(iterable)) {
+    if (result[key]) {
+      if (Array.isArray(result[key])) {
+        result[key].push(value);
+      } else {
+        result[key] = [result[key], value];
+      }
+    } else {
+      result[key] = value;
+    }
+  }
+  return result;
+}
+function parseQueryString(queryString2 = typeof location !== "undefined" ? location.search : "") {
+  const query = queryString2.trim().replace(/^[?#&]/, "");
+  return fromEntries(new URLSearchParams(query));
+}
+function getQueryString(name, parser) {
+  const value = queryString.parse()[name];
+  if (parser == null || value == null) {
+    return value;
+  } else {
+    return parser(value);
+  }
+}
+function setQueryString({
+  qs,
+  key,
+  value
+}) {
+  const parsed = parseQueryString(qs);
+  return createQueryString({
+    ...parsed,
+    [key]: value
+  });
+}
+var queryString = {
+  create: createQueryString,
+  parse: parseQueryString,
+  get: getQueryString,
+  set: setQueryString
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  queryString
+});
+//# sourceMappingURL=queryString.js.map

package/dist/queryString.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/queryString.ts"],"sourcesContent":["/**\n * @description 쿼리 스트링을 생성합니다.\n * @example createSearchParamString({ a: 1, b: 2, c: 3 }) // 'a=1&b=2&c=3'\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nfunction createSearchParamString(params: Record<string, any>) {\n  return (\n    new URLSearchParams(\n      Object.entries(params)\n        .filter(([, value]) => value != null)\n        .map(([key, value]) => {\n          if (Array.isArray(value)) {\n            return value.map((x) => [key, x]);\n          }\n          return [[key, value]];\n        })\n        .flat()\n    )\n      .toString()\n      // Convert space characters to '%20' according to RFC3986 spec, from RFC1738.\n      .replace(/\\+/g, '%20')\n  );\n}\n\n/**\n * @description 물음표를 포함한 쿼리 스트링을 생성합니다.\n * @example createQueryString({ a: 1, b: 2, c: 3 }) // '?a=1&b=2&c=3'\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nfunction createQueryString(params: Record<string, any>) {\n  const queryString = createSearchParamString(params);\n\n  if (queryString === '') {\n    return '';\n  }\n\n  return `?${queryString}`;\n}\n\n/**\n * @description 이터러블에서 키와 값을 가진 객체로 변환합니다.\n * @example fromEntries([['a', 1], ['b', 2], ['c', 3]]) // { a: 1, b: 2, c: 3 }\n */\nfunction fromEntries<T extends readonly [string | number, unknown]>(\n  iterable: Iterable<T>\n) {\n  const result: Record<string | number | symbol, T[1]> = {};\n\n  for (const [key, value] of Array.from(iterable)) {\n    if (result[key]) {\n      if (Array.isArray(result[key])) {\n        (result[key] as Array<string | number>).push(value as string | number);\n      } else {\n        result[key] = [result[key], value];\n      }\n    } else {\n      result[key] = value;\n    }\n  }\n\n  return result;\n}\n\n/**\n * @description 쿼리 스트링을 객체로 변환합니다.\n * @example parseQueryString('?a=1&b=2&c=3') // { a: '1', b: '2', c: '3' }\n */\nfunction parseQueryString<Result = Record<string, string>>(\n  queryString: string = typeof location !== 'undefined' ? location.search : ''\n): Result {\n  const query = queryString.trim().replace(/^[?#&]/, '');\n\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  return fromEntries(new URLSearchParams(query)) as any;\n}\n\n/**\n * @description 쿼리 스트링에서 특정 키의 값을 가져옵니다.\n *\n * @param name 가져올 쿼리 스트링의 키\n * @param parser 가져온 값을 파싱할 함수\n * @returns 파싱된 값\n *\n * @example\n * url: 'http://example.com/?a=1'\n * getQueryString('a') // '1'\n * getQueryString('a', parseInt) // 1\n * getQueryString('b') // undefined\n * getQueryString('b', parseInt) // undefined\n */\nfunction getQueryString(name: string): string | undefined;\nfunction getQueryString<T>(\n  name: string,\n  parser: (val: string) => T\n): T | undefined;\nfunction getQueryString<T = string>(name: string, parser?: (val: string) => T) {\n  const value = queryString.parse<{ [name: string]: string | undefined }>()[\n    name\n  ];\n\n  if (parser == null || value == null) {\n    return value;\n  } else {\n    return parser(value);\n  }\n}\n\n/**\n * @description 기존 쿼리 스트링에 새로운 쿼리 스트링을 추가합니다.\n * @example setQueryString({ qs: '?a=1', key: 'b', value: '2' }) // '?a=1&b=2'\n */\nfunction setQueryString({\n  qs,\n  key,\n  value,\n}: {\n  qs: string;\n  key: string;\n  value: string;\n}) {\n  const parsed = parseQueryString(qs);\n\n  return createQueryString({\n    ...parsed,\n    [key]: value,\n  });\n}\n\nexport const queryString = {\n  create: createQueryString,\n  parse: parseQueryString,\n  get: getQueryString,\n  set: setQueryString,\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAKA,SAAS,wBAAwB,QAA6B;AAC5D,SACE,IAAI;AAAA,IACF,OAAO,QAAQ,MAAM,EAClB,OAAO,CAAC,CAAC,EAAE,KAAK,MAAM,SAAS,IAAI,EACnC,IAAI,CAAC,CAAC,KAAK,KAAK,MAAM;AACrB,UAAI,MAAM,QAAQ,KAAK,GAAG;AACxB,eAAO,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAAA,MAClC;AACA,aAAO,CAAC,CAAC,KAAK,KAAK,CAAC;AAAA,IACtB,CAAC,EACA,KAAK;AAAA,EACV,EACG,SAAS,EAET,QAAQ,OAAO,KAAK;AAE3B;AAOA,SAAS,kBAAkB,QAA6B;AACtD,QAAMA,eAAc,wBAAwB,MAAM;AAElD,MAAIA,iBAAgB,IAAI;AACtB,WAAO;AAAA,EACT;AAEA,SAAO,IAAIA;AACb;AAMA,SAAS,YACP,UACA;AACA,QAAM,SAAiD,CAAC;AAExD,aAAW,CAAC,KAAK,KAAK,KAAK,MAAM,KAAK,QAAQ,GAAG;AAC/C,QAAI,OAAO,GAAG,GAAG;AACf,UAAI,MAAM,QAAQ,OAAO,GAAG,CAAC,GAAG;AAC9B,QAAC,OAAO,GAAG,EAA6B,KAAK,KAAwB;AAAA,MACvE,OAAO;AACL,eAAO,GAAG,IAAI,CAAC,OAAO,GAAG,GAAG,KAAK;AAAA,MACnC;AAAA,IACF,OAAO;AACL,aAAO,GAAG,IAAI;AAAA,IAChB;AAAA,EACF;AAEA,SAAO;AACT;AAMA,SAAS,iBACPA,eAAsB,OAAO,aAAa,cAAc,SAAS,SAAS,IAClE;AACR,QAAM,QAAQA,aAAY,KAAK,EAAE,QAAQ,UAAU,EAAE;AAGrD,SAAO,YAAY,IAAI,gBAAgB,KAAK,CAAC;AAC/C;AAqBA,SAAS,eAA2B,MAAc,QAA6B;AAC7E,QAAM,QAAQ,YAAY,MAA8C,EACtE,IACF;AAEA,MAAI,UAAU,QAAQ,SAAS,MAAM;AACnC,WAAO;AAAA,EACT,OAAO;AACL,WAAO,OAAO,KAAK;AAAA,EACrB;AACF;AAMA,SAAS,eAAe;AAAA,EACtB;AAAA,EACA;AAAA,EACA;AACF,GAIG;AACD,QAAM,SAAS,iBAAiB,EAAE;AAElC,SAAO,kBAAkB;AAAA,IACvB,GAAG;AAAA,IACH,CAAC,GAAG,GAAG;AAAA,EACT,CAAC;AACH;AAEO,IAAM,cAAc;AAAA,EACzB,QAAQ;AAAA,EACR,OAAO;AAAA,EACP,KAAK;AAAA,EACL,KAAK;AACP;","names":["queryString"]}

package/dist/queryString.mjs

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

package/dist/queryString.mjs.map

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

package/dist/useSafeArea.js

@@ -0,0 +1,49 @@
+"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/useSafeArea.ts
+var useSafeArea_exports = {};
+__export(useSafeArea_exports, {
+  useSafeArea: () => useSafeArea
+});
+module.exports = __toCommonJS(useSafeArea_exports);
+
+// src/coerceCssPixelValue.ts
+function coerceCssPixelValue(value) {
+  return typeof value === "string" ? value : `${value}px`;
+}
+
+// src/useSafeArea.ts
+var useSafeArea = ({
+  top: T = 0,
+  bottom: B = 0,
+  left: L = 0,
+  right: R = 0
+} = {}) => {
+  const top = `max(${coerceCssPixelValue(T)}, env(safe-area-inset-top))`;
+  const bottom = `max(${coerceCssPixelValue(B)}, env(safe-area-inset-bottom))`;
+  const left = `max(${coerceCssPixelValue(L)}, env(safe-area-inset-left))`;
+  const right = `max(${coerceCssPixelValue(R)}, env(safe-area-inset-right))`;
+  return { top, bottom, left, right };
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useSafeArea
+});
+//# sourceMappingURL=useSafeArea.js.map

package/dist/useSafeArea.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/useSafeArea.ts","../src/coerceCssPixelValue.ts"],"sourcesContent":["import { coerceCssPixelValue, type CSSPixelValue } from './coerceCssPixelValue';\n\nexport type SafeAreaCssValueProps = {\n  top?: CSSPixelValue;\n  bottom?: CSSPixelValue;\n  left?: CSSPixelValue;\n  right?: CSSPixelValue;\n};\n\nconst useSafeArea = ({\n  top: T = 0,\n  bottom: B = 0,\n  left: L = 0,\n  right: R = 0,\n}: SafeAreaCssValueProps = {}) => {\n  const top = `max(${coerceCssPixelValue(T)}, env(safe-area-inset-top))`;\n  const bottom = `max(${coerceCssPixelValue(B)}, env(safe-area-inset-bottom))`;\n  const left = `max(${coerceCssPixelValue(L)}, env(safe-area-inset-left))`;\n  const right = `max(${coerceCssPixelValue(R)}, env(safe-area-inset-right))`;\n\n  return { top, bottom, left, right };\n};\n\nexport { useSafeArea };\n","export type CSSPixelValue = string | number;\n\nexport function coerceCssPixelValue(value: CSSPixelValue): string {\n  return typeof value === 'string' ? value : `${value}px`;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACEO,SAAS,oBAAoB,OAA8B;AAChE,SAAO,OAAO,UAAU,WAAW,QAAQ,GAAG;AAChD;;;ADKA,IAAM,cAAc,CAAC;AAAA,EACnB,KAAK,IAAI;AAAA,EACT,QAAQ,IAAI;AAAA,EACZ,MAAM,IAAI;AAAA,EACV,OAAO,IAAI;AACb,IAA2B,CAAC,MAAM;AAChC,QAAM,MAAM,OAAO,oBAAoB,CAAC;AACxC,QAAM,SAAS,OAAO,oBAAoB,CAAC;AAC3C,QAAM,OAAO,OAAO,oBAAoB,CAAC;AACzC,QAAM,QAAQ,OAAO,oBAAoB,CAAC;AAE1C,SAAO,EAAE,KAAK,QAAQ,MAAM,MAAM;AACpC;","names":[]}

package/dist/useSafeArea.mjs

@@ -0,0 +1,8 @@
+import {
+  useSafeArea
+} from "./chunk-FUGA35PJ.mjs";
+import "./chunk-T7K7QYTL.mjs";
+export {
+  useSafeArea
+};
+//# sourceMappingURL=useSafeArea.mjs.map

package/dist/useSafeArea.mjs.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@basiln/utils",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "exports": {
     ".": "./src/index.ts",
     "./package.json": "./package.json"
@@ -29,6 +29,7 @@
     "@types/node": "^22.9.1",
     "@types/react": "^18.3.12",
     "@types/react-dom": "^18.3.1",
+    "@types/styled-components": "^5.1.34",
     "@typescript-eslint/eslint-plugin": "^5.49.0",
     "@typescript-eslint/parser": "^5.49.0",
     "eslint": "^8.33.0",
@@ -38,11 +39,13 @@
     "eslint-plugin-no-relative-import-paths": "^1.5.5",
     "eslint-plugin-react-hooks": "^5.0.0",
     "eslint-plugin-react-refresh": "^0.4.14",
+    "styled-components": "^6.1.13",
     "tsup": "^6.5.0",
     "typescript": "^4.9.5"
   },
   "peerDependencies": {
     "react": "^18",
-    "react-dom": "^18"
+    "react-dom": "^18",
+    "styled-components": "^6"
   }
 }

package/src/Flex.tsx

@@ -0,0 +1,51 @@
+import { memo, type CSSProperties, type HTMLAttributes } from 'react';
+import { styled } from 'styled-components';
+
+import { coerceCssPixelValue, type CSSPixelValue } from './coerceCssPixelValue';
+
+type Justify = CSSProperties['justifyContent'];
+type Align = CSSProperties['alignItems'];
+type Direction = CSSProperties['flexDirection'];
+
+export type FlexProps = HTMLAttributes<HTMLDivElement> & {
+  gap?: CSSPixelValue;
+  justify?: Justify;
+  align?: Align;
+  direction?: Direction;
+};
+
+export const Flex = memo(function Flex(props: FlexProps) {
+  const {
+    gap = 0,
+    justify = 'center',
+    align = 'center',
+    direction = 'row',
+    children,
+    ...restProps
+  } = props;
+
+  return (
+    <Container
+      $gap={gap}
+      $justify={justify}
+      $align={align}
+      $direction={direction}
+      {...restProps}
+    >
+      {children}
+    </Container>
+  );
+});
+
+export const Container = styled.div<{
+  $gap: CSSPixelValue;
+  $justify: Justify;
+  $align: Align;
+  $direction: Direction;
+}>`
+  display: flex;
+  flex-direction: ${({ $direction }) => $direction};
+  gap: ${({ $gap }) => coerceCssPixelValue($gap)};
+  align-items: ${({ $align }) => $align};
+  justify-content: ${({ $justify }) => $justify};
+`;

package/src/SafeArea.tsx

@@ -0,0 +1,46 @@
+import React, {
+  memo,
+  type ComponentPropsWithoutRef,
+  type ReactNode,
+} from 'react';
+
+import { Spacing } from './Spacing';
+import { useSafeArea } from './useSafeArea';
+
+export type SafeAreaProps<T extends React.ElementType = 'div'> = {
+  as?: T;
+  children: ReactNode;
+} & ComponentPropsWithoutRef<T>;
+
+export const SafeArea = <T extends React.ElementType = 'div'>({
+  as,
+  children,
+  ...props
+}: SafeAreaProps<T>) => {
+  const Component = as || 'div';
+
+  return (
+    <Component {...props}>
+      <SafeAreaTop />
+      {children}
+      <SafeAreaBottom />
+    </Component>
+  );
+};
+
+const SafeAreaTop = memo(function SafeAreaTop(
+  props: Omit<ComponentPropsWithoutRef<typeof Spacing>, 'size'>
+) {
+  const { top } = useSafeArea();
+  return <Spacing {...props} size={top} />;
+});
+
+const SafeAreaBottom = memo(function SafeAreaBottom(
+  props: Omit<ComponentPropsWithoutRef<typeof Spacing>, 'size'>
+) {
+  const { bottom } = useSafeArea();
+  return <Spacing {...props} size={bottom} />;
+});
+
+SafeArea.Top = SafeAreaTop;
+SafeArea.Bottom = SafeAreaBottom;

package/src/Spacing.tsx

@@ -0,0 +1,30 @@
+import { memo, type HTMLAttributes } from 'react';
+import { styled } from 'styled-components';
+
+import { coerceCssPixelValue, type CSSPixelValue } from './coerceCssPixelValue';
+
+type AxisDirection = 'vertical' | 'horizontal';
+
+export type SpacingProps = Omit<HTMLAttributes<HTMLDivElement>, 'children'> & {
+  direction?: AxisDirection;
+  size: CSSPixelValue;
+};
+
+export const Spacing = memo(function Spacing(props: SpacingProps) {
+  const { direction = 'horizontal', size, ...restProps } = props;
+
+  return (
+    <SpacingContainer $direction={direction} $size={size} {...restProps} />
+  );
+});
+
+const SpacingContainer = styled.div<{
+  $direction: SpacingProps['direction'];
+  $size: SpacingProps['size'];
+}>`
+  flex: none;
+  width: ${({ $direction, $size }) =>
+    $direction === 'horizontal' ? coerceCssPixelValue($size) : undefined};
+  height: ${({ $direction, $size }) =>
+    $direction === 'vertical' ? coerceCssPixelValue($size) : undefined};
+`;

package/src/Validate.ts

@@ -0,0 +1,25 @@
+/**
+ *
+ * @see 이메일 주소가 RFC 5322 표준을 따르는지 검사합니다.  {@link https://emailregex.com/}
+ */
+function isEmail(email: string) {
+  const regExp =
+    /^(([^<>()\[\]\\.,;:\s@"]+(\.[^<>()\[\]\\.,;:\s@"]+)*)|(".+"))@((\[[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}])|(([a-zA-Z\-0-9]+\.)+[a-zA-Z]{2,}))$/;
+  return regExp.test(email);
+}
+
+function isPhoneNumber(phoneNumber: string) {
+  // 하이픈 있는 형식
+  const regExpWithHyphen = /^01([0|1|6|7|8|9])-([0-9]{3,4})-([0-9]{4})$/;
+  // 하이픈 없는 형식
+  const regExpWithoutHyphen = /^01([0|1|6|7|8|9])([0-9]{3,4})([0-9]{4})$/;
+
+  return (
+    regExpWithHyphen.test(phoneNumber) || regExpWithoutHyphen.test(phoneNumber)
+  );
+}
+
+export const Validate = {
+  email: isEmail,
+  phoneNumber: isPhoneNumber,
+};

package/src/coerceCssPixelValue.ts

@@ -0,0 +1,5 @@
+export type CSSPixelValue = string | number;
+
+export function coerceCssPixelValue(value: CSSPixelValue): string {
+  return typeof value === 'string' ? value : `${value}px`;
+}

package/src/constants/josa.ts

@@ -0,0 +1,72 @@
+export const COMPLETE_HANGUL_START_CHARCODE = '가'.charCodeAt(0);
+export const COMPLETE_HANGUL_END_CHARCODE = '힣'.charCodeAt(0);
+
+export const NUMBER_OF_JONGSEONG = 28;
+export const NUMBER_OF_JUNGSEONG = 21;
+
+const DISASSEMBLED_CONSONANTS_BY_CONSONANT = {
+  '': '',
+  ㄱ: 'ㄱ',
+  ㄲ: 'ㄲ',
+  ㄳ: 'ㄱㅅ',
+  ㄴ: 'ㄴ',
+  ㄵ: 'ㄴㅈ',
+  ㄶ: 'ㄴㅎ',
+  ㄷ: 'ㄷ',
+  ㄸ: 'ㄸ',
+  ㄹ: 'ㄹ',
+  ㄺ: 'ㄹㄱ',
+  ㄻ: 'ㄹㅁ',
+  ㄼ: 'ㄹㅂ',
+  ㄽ: 'ㄹㅅ',
+  ㄾ: 'ㄹㅌ',
+  ㄿ: 'ㄹㅍ',
+  ㅀ: 'ㄹㅎ',
+  ㅁ: 'ㅁ',
+  ㅂ: 'ㅂ',
+  ㅃ: 'ㅃ',
+  ㅄ: 'ㅂㅅ',
+  ㅅ: 'ㅅ',
+  ㅆ: 'ㅆ',
+  ㅇ: 'ㅇ',
+  ㅈ: 'ㅈ',
+  ㅉ: 'ㅉ',
+  ㅊ: 'ㅊ',
+  ㅋ: 'ㅋ',
+  ㅌ: 'ㅌ',
+  ㅍ: 'ㅍ',
+  ㅎ: 'ㅎ',
+} as const;
+
+export const JONGSEONGS = (
+  [
+    '',
+    'ㄱ',
+    'ㄲ',
+    'ㄳ',
+    'ㄴ',
+    'ㄵ',
+    'ㄶ',
+    'ㄷ',
+    'ㄹ',
+    'ㄺ',
+    'ㄻ',
+    'ㄼ',
+    'ㄽ',
+    'ㄾ',
+    'ㄿ',
+    'ㅀ',
+    'ㅁ',
+    'ㅂ',
+    'ㅄ',
+    'ㅅ',
+    'ㅆ',
+    'ㅇ',
+    'ㅈ',
+    'ㅊ',
+    'ㅋ',
+    'ㅌ',
+    'ㅍ',
+    'ㅎ',
+  ] as const
+).map((consonant) => DISASSEMBLED_CONSONANTS_BY_CONSONANT[consonant]);