@simplysm/core-common 14.0.99 → 14.0.101

package/src/utils/str.ts

@@ -26,10 +26,6 @@ const suffixTable = {
  *   - `"랑"`: 이랑/랑 (접속 조사)
  *   - `"로"`: 으로/로 (도구격 조사)
  *   - `"라"`: 이라/라 (서술격 조사)
- *
- * @example
- * getKoreanSuffix("Apple", "을") // "를"
- * getKoreanSuffix("책", "이") // "이"
  */
 export function getKoreanSuffix(
   text: string,
@@ -145,10 +141,6 @@ const fullWidthCharRegex = new RegExp(`[${Object.keys(fullWidthCharMap).join("")
  * - 전각 숫자 (０-９ → 0-9)
  * - 전각 공백 (　 → 일반 공백)
  * - 전각 괄호 (（） → ())
- *
- * @example
- * replaceFullWidth("Ａ１２３") // "A123"
- * replaceFullWidth("（株）") // "(株)"
  */
 export function replaceFullWidth(str: string): string {
   return str.replace(fullWidthCharRegex, (char) => fullWidthCharMap[char] ?? char);
@@ -160,9 +152,6 @@ export function replaceFullWidth(str: string): string {
 
 /**
  * PascalCase로 변환
- * @example "hello-world" → "HelloWorld"
- * @example "hello_world" → "HelloWorld"
- * @example "hello.world" → "HelloWorld"
  */
 export function toPascalCase(str: string): string {
   return str
@@ -172,9 +161,6 @@ export function toPascalCase(str: string): string {
 
 /**
  * camelCase로 변환
- * @example "hello-world" → "helloWorld"
- * @example "hello_world" → "helloWorld"
- * @example "HelloWorld" → "helloWorld"
  */
 export function toCamelCase(str: string): string {
   return str
@@ -184,13 +170,6 @@ export function toCamelCase(str: string): string {
 
 /**
  * kebab-case로 변환
- *
- * @example "HelloWorld" → "hello-world"
- * @example "helloWorld" → "hello-world"
- * @example "hello_world" → "hello_world" (소문자만이면 변환 없음)
- * @example "Hello_World" → "hello-_world" (기존 구분자 유지)
- * @example "Hello-World" → "hello--world" (기존 구분자 유지)
- * @example "XMLParser" → "x-m-l-parser" (연속 대문자 분리)
  */
 export function toKebabCase(str: string): string {
   return toCaseWithSeparator(str, "-");
@@ -198,13 +177,6 @@ export function toKebabCase(str: string): string {
 
 /**
  * snake_case로 변환
- *
- * @example "HelloWorld" → "hello_world"
- * @example "helloWorld" → "hello_world"
- * @example "hello-world" → "hello-world" (소문자만이면 변환 없음)
- * @example "Hello-World" → "hello_-world" (기존 구분자 유지)
- * @example "Hello_World" → "hello__world" (기존 구분자 유지)
- * @example "XMLParser" → "x_m_l_parser" (연속 대문자 분리)
  */
 export function toSnakeCase(str: string): string {
   return toCaseWithSeparator(str, "_");
@@ -225,16 +197,6 @@ function toCaseWithSeparator(str: string, separator: string): string {
  *
  * @param str 검사할 문자열
  * @returns undefined, null, 또는 빈 문자열이면 true
- *
- * @example
- * const name: string | undefined = getValue();
- * if (isNullOrEmpty(name)) {
- *   // name: "" | undefined
- *   console.log("Name is empty");
- * } else {
- *   // name: string (non-empty string)
- *   console.log(`Name: ${name}`);
- * }
  */
 export function isNullOrEmpty(str: string | undefined): str is "" | undefined {
   return str == null || str === "";
@@ -247,11 +209,6 @@ export function isNullOrEmpty(str: string | undefined): str is "" | undefined {
  * @param index 삽입할 위치 (0부터 시작)
  * @param insertString 삽입할 문자열
  * @returns 삽입이 적용된 새 문자열
- *
- * @example
- * insert("Hello World", 5, ","); // "Hello, World"
- * insert("abc", 0, "X"); // "Xabc"
- * insert("abc", 3, "X"); // "abcX"
  */
 export function insert(str: string, index: number, insertString: string): string {
   return str.substring(0, index) + insertString + str.substring(index);

package/src/utils/template-strings.ts

@@ -8,12 +8,6 @@
  * @param strings 템플릿 문자열 배열
  * @param values 보간된 값들
  * @returns 들여쓰기가 정규화된 문자열
- * @example
- * const code = js`
- *   function hello() {
- *     return "world";
- *   }
- * `;
  */
 export function js(strings: TemplateStringsArray, ...values: unknown[]): string {
   return _combine(strings, values);
@@ -24,13 +18,6 @@ export function js(strings: TemplateStringsArray, ...values: unknown[]): string
  * @param strings 템플릿 문자열 배열
  * @param values 보간된 값들
  * @returns 들여쓰기가 정규화된 문자열
- * @example
- * const code = ts`
- *   interface User {
- *     name: string;
- *     age: number;
- *   }
- * `;
  */
 export function ts(strings: TemplateStringsArray, ...values: unknown[]): string {
   return _combine(strings, values);
@@ -41,12 +28,6 @@ export function ts(strings: TemplateStringsArray, ...values: unknown[]): string
  * @param strings 템플릿 문자열 배열
  * @param values 보간된 값들
  * @returns 들여쓰기가 정규화된 문자열
- * @example
- * const markup = html`
- *   <div class="container">
- *     <span>${name}</span>
- *   </div>
- * `;
  */
 export function html(strings: TemplateStringsArray, ...values: unknown[]): string {
   return _combine(strings, values);
@@ -57,12 +38,6 @@ export function html(strings: TemplateStringsArray, ...values: unknown[]): strin
  * @param strings 템플릿 문자열 배열
  * @param values 보간된 값들
  * @returns 들여쓰기가 정규화된 문자열
- * @example
- * const query = tsql`
- *   SELECT TOP 10 *
- *   FROM Users
- *   WHERE Name LIKE '%${keyword}%'
- * `;
  */
 export function tsql(strings: TemplateStringsArray, ...values: unknown[]): string {
   return _combine(strings, values);
@@ -73,12 +48,6 @@ export function tsql(strings: TemplateStringsArray, ...values: unknown[]): strin
  * @param strings 템플릿 문자열 배열
  * @param values 보간된 값들
  * @returns 들여쓰기가 정규화된 문자열
- * @example
- * const query = mysql`
- *   SELECT *
- *   FROM users
- *   LIMIT 10
- * `;
  */
 export function mysql(strings: TemplateStringsArray, ...values: unknown[]): string {
   return _combine(strings, values);
@@ -89,12 +58,6 @@ export function mysql(strings: TemplateStringsArray, ...values: unknown[]): stri
  * @param strings 템플릿 문자열 배열
  * @param values 보간된 값들
  * @returns 들여쓰기가 정규화된 문자열
- * @example
- * const query = pgsql`
- *   SELECT *
- *   FROM users
- *   OFFSET 0 LIMIT 10
- * `;
  */
 export function pgsql(strings: TemplateStringsArray, ...values: unknown[]): string {
   return _combine(strings, values);

package/src/utils/transferable.ts

@@ -25,14 +25,6 @@ type Transferable = ArrayBuffer;
  *
  * @note 순환 참조 시 transferableEncode에서 TypeError 발생 (경로 정보 포함)
  * @note 같은 객체가 여러 곳에서 참조되면 캐싱된 인코딩 결과를 재사용
- *
- * @example
- * // Worker로 데이터 전송
- * const { result, transferList } = transferableEncode(data);
- * worker.postMessage(result, transferList);
- *
- * // Worker에서 데이터 수신
- * const decoded = decode(event.data);
  */
 
 //#region encode

package/src/utils/wait.ts

@@ -10,9 +10,6 @@ import { TimeoutError } from "../errors/timeout-error";
  * @param maxCount 최대 시도 횟수 (undefined이면 무제한)
  *
  * @note 첫 번째 호출에서 조건이 true이면 즉시 반환.
- * @example
- * // maxCount=3: 최대 3번 조건 확인, 모두 false이면 TimeoutError 발생
- * await waitUntil(() => someCondition, 100, 3);
  * @throws TimeoutError 최대 시도 횟수를 초과했을 때
  */
 export async function until(

package/src/utils/xml.ts

@@ -15,9 +15,6 @@ import { XMLBuilder, XMLParser } from "fast-xml-parser";
  *   - 속성: `$` 객체에 그룹화
  *   - 텍스트 노드: `_` key에 저장
  *   - 자식 요소: array로 변환 (루트 요소 제외)
- * @example
- * xmlParse('<root id="1"><item>hello</item></root>');
- * // { root: { $: { id: "1" }, item: [{ _: "hello" }] } }
  */
 export function parse(str: string, options?: { stripTagPrefix?: boolean }): unknown {
   const result = new XMLParser({
@@ -44,14 +41,6 @@ export function parse(str: string, options?: { stripTagPrefix?: boolean }): unkn
  * @param obj 직렬화할 객체
  * @param options fast-xml-parser XmlBuilderOptions (선택사항)
  * @returns XML 문자열
- * @example
- * xmlStringify({
- *   root: {
- *     $: { id: "1" },
- *     item: [{ _: "hello" }, { _: "world" }],
- *   },
- * });
- * // '<root id="1"><item>hello</item><item>world</item></root>'
  */
 export function stringify(obj: unknown, options?: XmlBuilderOptions): string {
   return new XMLBuilder({

package/src/utils/zip.ts

@@ -22,37 +22,6 @@ export interface ZipArchiveProgress {
  *
  * ZIP 파일의 읽기, 쓰기, 압축, 해제를 처리.
  * 동일 파일의 중복 해제를 방지하기 위해 내부 캐싱 사용.
- *
- * @example
- * // ZIP 파일 읽기
- * const archive = new ZipArchive(zipBytes);
- * try {
- *   const content = await archive.get("file.txt");
- * } finally {
- *   await archive.close();
- * }
- *
- * @example
- * // ZIP 파일 생성
- * const archive = new ZipArchive();
- * try {
- *   archive.write("file.txt", textBytes);
- *   archive.write("data.json", jsonBytes);
- *   const zipBytes = await archive.compress();
- * } finally {
- *   await archive.close();
- * }
- *
- * @example
- * // 모든 파일 추출 (진행률 보고 포함)
- * const archive = new ZipArchive(zipBytes);
- * try {
- *   const files = await archive.extractAll((progress) => {
- *     console.log(`${progress.fileName}: ${progress.extractedSize}/${progress.totalSize}`);
- *   });
- * } finally {
- *   await archive.close();
- * }
  */
 export class ZipArchive {
   private readonly _reader?: ZipReader<Blob | Bytes>;