@yeongseoksong/framework 1.6.2 → 1.7.0

package/dist/util/index.cjs

@@ -1,199 +0,0 @@
-"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);
-var __async = (__this, __arguments, generator) => {
-  return new Promise((resolve, reject) => {
-    var fulfilled = (value) => {
-      try {
-        step(generator.next(value));
-      } catch (e) {
-        reject(e);
-      }
-    };
-    var rejected = (value) => {
-      try {
-        step(generator.throw(value));
-      } catch (e) {
-        reject(e);
-      }
-    };
-    var step = (x) => x.done ? resolve(x.value) : Promise.resolve(x.value).then(fulfilled, rejected);
-    step((generator = generator.apply(__this, __arguments)).next());
-  });
-};
-
-// util/index.ts
-var util_exports = {};
-__export(util_exports, {
-  COMPANY_NAME: () => COMPANY_NAME,
-  LOGO_ALT: () => LOGO_ALT,
-  LOGO_SRC: () => LOGO_SRC,
-  filterAndSort: () => filterAndSort,
-  fixJosa: () => fixJosa,
-  getFinalSound: () => getFinalSound,
-  hasFinalConsonant: () => hasFinalConsonant,
-  josa: () => josa,
-  runFinalizers: () => runFinalizers,
-  t: () => t,
-  withJosa: () => withJosa
-});
-module.exports = __toCommonJS(util_exports);
-
-// util/env.util.ts
-var _a;
-var COMPANY_NAME = (_a = process.env.NEXT_PUBLIC_COMPANY_NAME) != null ? _a : "";
-var _a2;
-var LOGO_SRC = (_a2 = process.env.NEXT_PUBLIC_LOGO_SRC) != null ? _a2 : "/logo.svg";
-var _a3;
-var LOGO_ALT = (_a3 = process.env.NEXT_PUBLIC_LOGO_ALT) != null ? _a3 : "\uB85C\uACE0";
-
-// util/text.util.ts
-var COMPANY_TOKEN = "%c";
-function t(text) {
-  return text.replaceAll(COMPANY_TOKEN, COMPANY_NAME);
-}
-
-// util/sort.util.ts
-function filterAndSort(items, direction = "asc") {
-  const sign = direction === "asc" ? 1 : -1;
-  return (items != null ? items : []).filter((item) => item.isShow).sort((a, b) => (a.order - b.order) * sign);
-}
-
-// util/finalize.util.ts
-function runFinalizers(finalize, label = "finalize") {
-  return __async(this, null, function* () {
-    if (!finalize) return;
-    const list = Array.isArray(finalize) ? finalize : [finalize];
-    for (const fn of list) {
-      try {
-        yield fn();
-      } catch (caught) {
-        console.error(`[${label}] finalize\uC5D0\uC11C \uC608\uC678\uAC00 \uBC1C\uC0DD\uD588\uC2B5\uB2C8\uB2E4.`, caught);
-      }
-    }
-  });
-}
-
-// util/josa.util.ts
-var HANGUL_BASE = 44032;
-var HANGUL_LAST = 55203;
-var JONG_RIEUL = 8;
-var DIGIT_FINAL = {
-  "0": "\u3147",
-  // 영
-  "1": "\u3139",
-  // 일
-  "2": null,
-  // 이
-  "3": "\u3141",
-  // 삼
-  "4": null,
-  // 사
-  "5": null,
-  // 오
-  "6": "\u3131",
-  // 육
-  "7": "\u3139",
-  // 칠
-  "8": "\u3139",
-  // 팔
-  "9": null
-  // 구
-};
-var ALPHA_FINAL = {
-  l: "\u3139",
-  // 엘
-  m: "\u3141",
-  // 엠
-  n: "\u3134",
-  // 엔
-  r: "\u3139",
-  // 아르
-  s: "\u3145",
-  // 에스
-  x: "\u3145",
-  // 엑스
-  f: "\u314D"
-  // 에프
-};
-var NO_FINAL = { has: false, rieul: false };
-function getFinalSound(word) {
-  const trimmed = word.trim();
-  if (!trimmed) return NO_FINAL;
-  for (let i = trimmed.length - 1; i >= 0; i -= 1) {
-    const char = trimmed[i];
-    const code = char.charCodeAt(0);
-    if (code >= HANGUL_BASE && code <= HANGUL_LAST) {
-      const jong = (code - HANGUL_BASE) % 28;
-      return { has: jong !== 0, rieul: jong === JONG_RIEUL };
-    }
-    if (char >= "0" && char <= "9") {
-      const final = DIGIT_FINAL[char];
-      return { has: final !== null, rieul: final === "\u3139" };
-    }
-    const lower = char.toLowerCase();
-    if (lower >= "a" && lower <= "z") {
-      const final = ALPHA_FINAL[lower];
-      return { has: Boolean(final), rieul: final === "\u3139" };
-    }
-  }
-  return NO_FINAL;
-}
-function hasFinalConsonant(word) {
-  return getFinalSound(word).has;
-}
-function josa(word, pair) {
-  const [withFinal, withoutFinal] = pair.split("/");
-  const sound = getFinalSound(word);
-  if (pair === "\uC73C\uB85C/\uB85C" && sound.rieul) return withoutFinal;
-  return sound.has ? withFinal : withoutFinal;
-}
-function withJosa(word, pair) {
-  return `${word}${josa(word, pair)}`;
-}
-function fixJosa(text) {
-  return text.replace(
-    /([^\s(])(은\(는\)|는\(은\)|이\(가\)|가\(이\)|을\(를\)|를\(을\)|과\(와\)|와\(과\))/g,
-    (_match, word, marker) => {
-      const [first, second] = marker.replace(")", "").split("(");
-      const pair = WITH_FINAL.has(first) ? `${first}/${second}` : `${second}/${first}`;
-      return `${word}${josa(word, pair)}`;
-    }
-  ).replace(
-    /([^\s(])\((으|이)\)(로|라|나|란|여)/g,
-    (_match, word, optional, tail) => {
-      const pair = `${optional}${tail}/${tail}`;
-      return `${word}${josa(word, pair)}`;
-    }
-  );
-}
-var WITH_FINAL = /* @__PURE__ */ new Set(["\uC740", "\uC774", "\uC744", "\uACFC"]);
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  COMPANY_NAME,
-  LOGO_ALT,
-  LOGO_SRC,
-  filterAndSort,
-  fixJosa,
-  getFinalSound,
-  hasFinalConsonant,
-  josa,
-  runFinalizers,
-  t,
-  withJosa
-});

package/dist/util/index.d.ts

@@ -1,114 +0,0 @@
-import { CommonInfo } from '../types/index.js';
-import 'react';
-
-/**
- * 소비자 앱이 주입하는 상수들.
- *
- * 값은 소비자 앱의 `NEXT_PUBLIC_*` 환경변수에서 온다. 번들러가 빌드 시점에
- * 리터럴로 치환하므로, tsup이 ui/util 번들을 나눠도 양쪽에 같은 값이 박힌다.
- * (모듈 전역 변수로 주입하던 이전 방식은 번들이 갈리면서 값이 공유되지 않았다.)
- *
- * `process.env.X` 형태로 통째로 접근해야 한다. 구조분해(`const { X } = process.env`)는
- * 번들러의 정적 치환 대상이 아니라서 undefined가 된다.
- */
-/** `%c` 토큰이 치환될 회사명. 소비자 앱에서 필수. */
-declare const COMPANY_NAME: string;
-/** 헤더 로고 이미지 경로. */
-declare const LOGO_SRC: string;
-/** 헤더 로고 대체 텍스트. */
-declare const LOGO_ALT: string;
-
-/** 문자열 안의 `%c`를 회사명으로 치환한다. 서버/클라이언트 양쪽에서 안전하다. */
-declare function t(text: string): string;
-
-type SortDirection = 'asc' | 'desc';
-/**
- * isShow 필터 + order 정렬. 기본은 오름차순(`asc`) — 기존 호출부와 동일하다.
- * CommonInfo를 extends 하는 모든 타입에 사용 가능
- */
-declare function filterAndSort<T extends CommonInfo>(items: T[] | undefined, direction?: SortDirection): T[];
-
-/**
- * 어떤 작업이 끝난 뒤 항상 돌려야 하는 뒷정리 — 라우팅, 모달 닫기, 목록 새로고침 등.
- *
- * 폼에 딸린 개념이 아니다. 제출·삭제·업로드처럼 "끝나면 정리한다"가 필요한 곳이면
- * 어느 스토어에서든 같은 타입과 실행기를 쓴다.
- */
-/**
- * 뒷정리 함수. **인자를 받지 않는다** — 대개 결과와 무관한 정리·이동이라
- * 기존 함수(`close`, `refetch`, `() => router.push('/')`)를 그대로 꽂을 수 있어야 한다.
- * 반환값은 무시하고, 프로미스면 기다린다.
- */
-type Finalizer = () => unknown | Promise<unknown>;
-/** 하나 또는 여러 개. 여러 개면 넘긴 순서대로 실행된다. */
-type Finalizers = Finalizer | Finalizer[];
-/**
- * `finalize`를 하나든 여러 개든 같은 방식으로 실행한다.
- *
- * 여기서 터진 예외는 **본 작업의 결과를 뒤집지 않는다** — 작업은 이미 끝났고, 뒷정리
- * 하나가 실패했다고 성공 알림을 취소하거나 처리되지 않은 rejection을 만들 이유가 없다.
- * 대신 콘솔에 남겨 개발 중에 눈에 띄게 한다.
- *
- * @param label 콘솔 메시지에 붙일 호출부 이름 (예: `'useSdForm'`)
- */
-declare function runFinalizers(finalize: Finalizers | undefined, label?: string): Promise<void>;
-
-/**
- * 한글 조사(은/는, 이/가, 을/를 …)를 앞 단어에 맞춰 고르는 순수 유틸.
- *
- * 회사명·사용자 이름·품목명처럼 **런타임에 정해지는 값** 뒤에 조사가 붙을 때 필요하다.
- * `"%c은(는)"`처럼 두 형태를 병기하면 읽기 불편하고, 한쪽만 쓰면 값에 따라 어색해진다.
- *
- * DOM·React·Mantine에 의존하지 않는 순수 함수라 서버·클라이언트 어디서든 쓴다.
- */
-/** 지원하는 조사 쌍. 표기는 '받침 있을 때/없을 때' 순서다. */
-type JosaPair = '은/는' | '이/가' | '을/를' | '과/와' | '으로/로' | '아/야' | '이라/라' | '이나/나' | '이란/란' | '이여/여';
-interface FinalSound {
-    /** 받침이 있는지 */
-    has: boolean;
-    /** 받침이 ㄹ인지 — '으로/로'는 ㄹ 받침을 받침 없음처럼 다룬다 */
-    rieul: boolean;
-}
-/**
- * 단어의 마지막 소리에서 받침 정보를 읽는다.
- *
- * 한글 음절 · 숫자 · 알파벳까지 본다. 괄호나 문장부호로 끝나면 그 앞 글자를 찾아
- * 올라간다("(주)가나(주)" 같은 표기도 마지막 실제 글자를 기준으로 판단하기 위해서다).
- * 판단할 근거가 없으면 받침 없음으로 본다 — 한국어에서 더 자연스러운 쪽이다.
- */
-declare function getFinalSound(word: string): FinalSound;
-/** 받침이 있으면 `true`. 판단할 수 없으면 `false`(받침 없음으로 본다). */
-declare function hasFinalConsonant(word: string): boolean;
-/**
- * 단어에 맞는 조사 **하나만** 돌려준다.
- *
- * ```ts
- * josa('가나전자', '은/는')  // '는'
- * josa('한빛', '은/는')      // '은'
- * josa('서울', '으로/로')    // '로'  ← ㄹ 받침은 '로'
- * josa('URL', '을/를')       // '을'  ← 엘
- * ```
- */
-declare function josa(word: string, pair: JosaPair): string;
-/**
- * 단어와 조사를 붙여서 돌려준다.
- *
- * ```ts
- * withJosa('가나전자', '이/가')  // '가나전자가'
- * ```
- */
-declare function withJosa(word: string, pair: JosaPair): string;
-/**
- * 문장에 병기된 조사 표기를 실제 값에 맞게 하나로 정리한다.
- *
- * 원고를 `"%c은(는) 무엇입니까"`처럼 쓰고, 치환이 끝난 뒤 이 함수를 한 번 돌리면
- * `"가나전자는 무엇입니까"`가 된다. 알아보는 표기는 두 가지다.
- *
- * - `은(는)` `이(가)` `을(를)` `과(와)` — 앞이 받침 있는 형태, 괄호 안이 없는 형태
- * - `(으)로` `(이)라` `(이)나` `(이)란` `(이)여` — 괄호 안이 받침 있을 때만 붙는 음절
- *
- * 두 형태의 순서가 뒤바뀐 표기(`는(은)`)도 같은 규칙으로 받는다.
- */
-declare function fixJosa(text: string): string;
-
-export { COMPANY_NAME, type Finalizer, type Finalizers, type JosaPair, LOGO_ALT, LOGO_SRC, type SortDirection, filterAndSort, fixJosa, getFinalSound, hasFinalConsonant, josa, runFinalizers, t, withJosa };