@simplysm/core-common 13.0.100 → 14.0.4

package/dist/utils/str.js

@@ -1,128 +1,232 @@
+/**
+ * 문자열 유틸리티 함수
+ */
+//#region 한국어 조사 처리
+// 한국어 조사 매핑 테이블 (모듈 로드 시 한 번만 생성)
 const suffixTable = {
-  \uC744: { t: "\uC744", f: "\uB97C" },
-  \uC740: { t: "\uC740", f: "\uB294" },
-  \uC774: { t: "\uC774", f: "\uAC00" },
-  \uC640: { t: "\uACFC", f: "\uC640" },
-  \uB791: { t: "\uC774\uB791", f: "\uB791" },
-  \uB85C: { t: "\uC73C\uB85C", f: "\uB85C" },
-  \uB77C: { t: "\uC774\uB77C", f: "\uB77C" }
+    을: { t: "을", f: "를" },
+    은: { t: "은", f: "는" },
+    이: { t: "이", f: "가" },
+    와: { t: "과", f: "와" },
+    랑: { t: "이랑", f: "랑" },
+    로: { t: "으로", f: "로" },
+    라: { t: "이라", f: "라" },
 };
-function getKoreanSuffix(text, type) {
-  const table = suffixTable;
-  if (text.length === 0) {
-    return table[type].f;
-  }
-  const lastCharCode = text.charCodeAt(text.length - 1);
-  if (lastCharCode < 44032 || lastCharCode > 55203) {
-    return table[type].f;
-  }
-  const jongseongIndex = (lastCharCode - 44032) % 28;
-  const hasLast = jongseongIndex !== 0;
-  if (type === "\uB85C" && jongseongIndex === 8) {
-    return table[type].f;
-  }
-  return hasLast ? table[type].t : table[type].f;
+/**
+ * 받침 유무에 따라 적절한 한국어 조사 반환
+ * @param text 확인할 텍스트
+ * @param type 조사 타입
+ *   - `"을"`: 을/를 (목적격 조사)
+ *   - `"은"`: 은/는 (주격 보조사)
+ *   - `"이"`: 이/가 (주격 조사)
+ *   - `"와"`: 과/와 (접속 조사)
+ *   - `"랑"`: 이랑/랑 (접속 조사)
+ *   - `"로"`: 으로/로 (도구격 조사)
+ *   - `"라"`: 이라/라 (서술격 조사)
+ *
+ * @example
+ * getKoreanSuffix("Apple", "을") // "를"
+ * getKoreanSuffix("책", "이") // "이"
+ */
+export function getKoreanSuffix(text, type) {
+    const table = suffixTable;
+    if (text.length === 0) {
+        return table[type].f;
+    }
+    const lastCharCode = text.charCodeAt(text.length - 1);
+    // 한글 범위 확인 (0xAC00 ~ 0xD7A3)
+    if (lastCharCode < 0xac00 || lastCharCode > 0xd7a3) {
+        return table[type].f;
+    }
+    // 받침(종성) 존재 여부 판단
+    const jongseongIndex = (lastCharCode - 0xac00) % 28;
+    const hasLast = jongseongIndex !== 0;
+    // "로" 조사 특수 처리: 받침이 ㄹ (종성 인덱스 8)이면 "로" 사용
+    if (type === "로" && jongseongIndex === 8) {
+        return table[type].f;
+    }
+    return hasLast ? table[type].t : table[type].f;
 }
+//#endregion
+//#region 전각 → 반각 변환
+// 전각 → 반각 매핑 테이블 (모듈 로드 시 한 번만 생성)
 const fullWidthCharMap = {
-  "\uFF21": "A",
-  "\uFF22": "B",
-  "\uFF23": "C",
-  "\uFF24": "D",
-  "\uFF25": "E",
-  "\uFF26": "F",
-  "\uFF27": "G",
-  "\uFF28": "H",
-  "\uFF29": "I",
-  "\uFF2A": "J",
-  "\uFF2B": "K",
-  "\uFF2C": "L",
-  "\uFF2D": "M",
-  "\uFF2E": "N",
-  "\uFF2F": "O",
-  "\uFF30": "P",
-  "\uFF31": "Q",
-  "\uFF32": "R",
-  "\uFF33": "S",
-  "\uFF34": "T",
-  "\uFF35": "U",
-  "\uFF36": "V",
-  "\uFF37": "W",
-  "\uFF38": "X",
-  "\uFF39": "Y",
-  "\uFF3A": "Z",
-  "\uFF41": "a",
-  "\uFF42": "b",
-  "\uFF43": "c",
-  "\uFF44": "d",
-  "\uFF45": "e",
-  "\uFF46": "f",
-  "\uFF47": "g",
-  "\uFF48": "h",
-  "\uFF49": "i",
-  "\uFF4A": "j",
-  "\uFF4B": "k",
-  "\uFF4C": "l",
-  "\uFF4D": "m",
-  "\uFF4E": "n",
-  "\uFF4F": "o",
-  "\uFF50": "p",
-  "\uFF51": "q",
-  "\uFF52": "r",
-  "\uFF53": "s",
-  "\uFF54": "t",
-  "\uFF55": "u",
-  "\uFF56": "v",
-  "\uFF57": "w",
-  "\uFF58": "x",
-  "\uFF59": "y",
-  "\uFF5A": "z",
-  "\uFF10": "0",
-  "\uFF11": "1",
-  "\uFF12": "2",
-  "\uFF13": "3",
-  "\uFF14": "4",
-  "\uFF15": "5",
-  "\uFF16": "6",
-  "\uFF17": "7",
-  "\uFF18": "8",
-  "\uFF19": "9",
-  "\u3000": " ",
-  "\uFF09": ")",
-  "\uFF08": "("
+    "Ａ": "A",
+    "Ｂ": "B",
+    "Ｃ": "C",
+    "Ｄ": "D",
+    "Ｅ": "E",
+    "Ｆ": "F",
+    "Ｇ": "G",
+    "Ｈ": "H",
+    "Ｉ": "I",
+    "Ｊ": "J",
+    "Ｋ": "K",
+    "Ｌ": "L",
+    "Ｍ": "M",
+    "Ｎ": "N",
+    "Ｏ": "O",
+    "Ｐ": "P",
+    "Ｑ": "Q",
+    "Ｒ": "R",
+    "Ｓ": "S",
+    "Ｔ": "T",
+    "Ｕ": "U",
+    "Ｖ": "V",
+    "Ｗ": "W",
+    "Ｘ": "X",
+    "Ｙ": "Y",
+    "Ｚ": "Z",
+    "ａ": "a",
+    "ｂ": "b",
+    "ｃ": "c",
+    "ｄ": "d",
+    "ｅ": "e",
+    "ｆ": "f",
+    "ｇ": "g",
+    "ｈ": "h",
+    "ｉ": "i",
+    "ｊ": "j",
+    "ｋ": "k",
+    "ｌ": "l",
+    "ｍ": "m",
+    "ｎ": "n",
+    "ｏ": "o",
+    "ｐ": "p",
+    "ｑ": "q",
+    "ｒ": "r",
+    "ｓ": "s",
+    "ｔ": "t",
+    "ｕ": "u",
+    "ｖ": "v",
+    "ｗ": "w",
+    "ｘ": "x",
+    "ｙ": "y",
+    "ｚ": "z",
+    "０": "0",
+    "１": "1",
+    "２": "2",
+    "３": "3",
+    "４": "4",
+    "５": "5",
+    "６": "6",
+    "７": "7",
+    "８": "8",
+    "９": "9",
+    "　": " ",
+    "）": ")",
+    "（": "(",
 };
+// 정규식도 한 번만 생성
 const fullWidthCharRegex = new RegExp(`[${Object.keys(fullWidthCharMap).join("")}]`, "g");
-function replaceFullWidth(str) {
-  return str.replace(fullWidthCharRegex, (char) => fullWidthCharMap[char] ?? char);
+/**
+ * 전각 문자를 반각 문자로 변환
+ *
+ * 변환 대상:
+ * - 전각 대문자 (Ａ-Ｚ → A-Z)
+ * - 전각 소문자 (ａ-ｚ → a-z)
+ * - 전각 숫자 (０-９ → 0-9)
+ * - 전각 공백 (　 → 일반 공백)
+ * - 전각 괄호 (（） → ())
+ *
+ * @example
+ * replaceFullWidth("Ａ１２３") // "A123"
+ * replaceFullWidth("（株）") // "(株)"
+ */
+export function replaceFullWidth(str) {
+    return str.replace(fullWidthCharRegex, (char) => fullWidthCharMap[char] ?? char);
 }
-function toPascalCase(str) {
-  return str.replace(/[-._][a-z]/g, (m) => m[1].toUpperCase()).replace(/^[a-z]/, (m) => m.toUpperCase());
+//#endregion
+//#region 대소문자 변환
+/**
+ * PascalCase로 변환
+ * @example "hello-world" → "HelloWorld"
+ * @example "hello_world" → "HelloWorld"
+ * @example "hello.world" → "HelloWorld"
+ */
+export function toPascalCase(str) {
+    return str
+        .replace(/[-._][a-z]/g, (m) => m[1].toUpperCase())
+        .replace(/^[a-z]/, (m) => m.toUpperCase());
 }
-function toCamelCase(str) {
-  return str.replace(/[-._][a-z]/g, (m) => m[1].toUpperCase()).replace(/^[A-Z]/, (m) => m.toLowerCase());
+/**
+ * camelCase로 변환
+ * @example "hello-world" → "helloWorld"
+ * @example "hello_world" → "helloWorld"
+ * @example "HelloWorld" → "helloWorld"
+ */
+export function toCamelCase(str) {
+    return str
+        .replace(/[-._][a-z]/g, (m) => m[1].toUpperCase())
+        .replace(/^[A-Z]/, (m) => m.toLowerCase());
 }
-function toKebabCase(str) {
-  return toCaseWithSeparator(str, "-");
+/**
+ * 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) {
+    return toCaseWithSeparator(str, "-");
 }
-function toSnakeCase(str) {
-  return toCaseWithSeparator(str, "_");
+/**
+ * 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) {
+    return toCaseWithSeparator(str, "_");
 }
 function toCaseWithSeparator(str, separator) {
-  return str.replace(/^[A-Z]/, (m) => m.toLowerCase()).replace(/[-_]?[A-Z]/g, (m) => separator + m.toLowerCase());
+    return str
+        .replace(/^[A-Z]/, (m) => m.toLowerCase())
+        .replace(/[-_]?[A-Z]/g, (m) => separator + m.toLowerCase());
 }
-function isNullOrEmpty(str) {
-  return str == null || str === "";
+//#endregion
+//#region 기타
+/**
+ * 문자열이 undefined 또는 빈 문자열인지 검사 (타입 가드)
+ *
+ * @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) {
+    return str == null || str === "";
 }
-function insert(str, index, insertString) {
-  return str.substring(0, index) + insertString + str.substring(index);
+/**
+ * 특정 위치에 문자열 삽입
+ *
+ * @param str 원본 문자열
+ * @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, index, insertString) {
+    return str.substring(0, index) + insertString + str.substring(index);
 }
-export {
-  getKoreanSuffix,
-  insert,
-  isNullOrEmpty,
-  replaceFullWidth,
-  toCamelCase,
-  toKebabCase,
-  toPascalCase,
-  toSnakeCase
-};
-//# sourceMappingURL=str.js.map
+//#endregion
+//# sourceMappingURL=str.js.map

package/dist/utils/str.js.map

@@ -1,6 +1 @@
-{
-  "version": 3,
-  "sources": ["../../src/utils/str.ts"],
-  "mappings": "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",
-  "names": []
-}
+{"version":3,"file":"str.js","sourceRoot":"","sources":["../../src/utils/str.ts"],"names":[],"mappings":"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"}

package/dist/utils/template-strings.d.ts

@@ -1,12 +1,12 @@
 /**
- * Template string tag functions
- * For IDE code highlighting support (actual behavior is string concatenation + indent normalization)
+ * 템플릿 문자열 태그 함수
+ * IDE 코드 하이라이팅 지원용 (실제 동작은 문자열 결합 + 들여쓰기 정규화)
  */
 /**
- * Template tag for JavaScript code highlighting
- * @param strings Template string array
- * @param values Interpolated values
- * @returns String with normalized indentation
+ * JavaScript 코드 하이라이팅용 템플릿 태그
+ * @param strings 템플릿 문자열 배열
+ * @param values 보간된 값들
+ * @returns 들여쓰기가 정규화된 문자열
  * @example
  * const code = js`
  *   function hello() {
@@ -16,10 +16,10 @@
  */
 export declare function js(strings: TemplateStringsArray, ...values: unknown[]): string;
 /**
- * Template tag for TypeScript code highlighting
- * @param strings Template string array
- * @param values Interpolated values
- * @returns String with normalized indentation
+ * TypeScript 코드 하이라이팅용 템플릿 태그
+ * @param strings 템플릿 문자열 배열
+ * @param values 보간된 값들
+ * @returns 들여쓰기가 정규화된 문자열
  * @example
  * const code = ts`
  *   interface User {
@@ -30,10 +30,10 @@ export declare function js(strings: TemplateStringsArray, ...values: unknown[]):
  */
 export declare function ts(strings: TemplateStringsArray, ...values: unknown[]): string;
 /**
- * Template tag for HTML markup highlighting
- * @param strings Template string array
- * @param values Interpolated values
- * @returns String with normalized indentation
+ * HTML 마크업 하이라이팅용 템플릿 태그
+ * @param strings 템플릿 문자열 배열
+ * @param values 보간된 값들
+ * @returns 들여쓰기가 정규화된 문자열
  * @example
  * const markup = html`
  *   <div class="container">
@@ -43,10 +43,10 @@ export declare function ts(strings: TemplateStringsArray, ...values: unknown[]):
  */
 export declare function html(strings: TemplateStringsArray, ...values: unknown[]): string;
 /**
- * Template tag for MSSQL T-SQL highlighting
- * @param strings Template string array
- * @param values Interpolated values
- * @returns String with normalized indentation
+ * MSSQL T-SQL 하이라이팅용 템플릿 태그
+ * @param strings 템플릿 문자열 배열
+ * @param values 보간된 값들
+ * @returns 들여쓰기가 정규화된 문자열
  * @example
  * const query = tsql`
  *   SELECT TOP 10 *
@@ -56,10 +56,10 @@ export declare function html(strings: TemplateStringsArray, ...values: unknown[]
  */
 export declare function tsql(strings: TemplateStringsArray, ...values: unknown[]): string;
 /**
- * Template tag for MySQL SQL highlighting
- * @param strings Template string array
- * @param values Interpolated values
- * @returns String with normalized indentation
+ * MySQL SQL 하이라이팅용 템플릿 태그
+ * @param strings 템플릿 문자열 배열
+ * @param values 보간된 값들
+ * @returns 들여쓰기가 정규화된 문자열
  * @example
  * const query = mysql`
  *   SELECT *
@@ -69,10 +69,10 @@ export declare function tsql(strings: TemplateStringsArray, ...values: unknown[]
  */
 export declare function mysql(strings: TemplateStringsArray, ...values: unknown[]): string;
 /**
- * Template tag for PostgreSQL SQL highlighting
- * @param strings Template string array
- * @param values Interpolated values
- * @returns String with normalized indentation
+ * PostgreSQL SQL 하이라이팅용 템플릿 태그
+ * @param strings 템플릿 문자열 배열
+ * @param values 보간된 값들
+ * @returns 들여쓰기가 정규화된 문자열
  * @example
  * const query = pgsql`
  *   SELECT *

package/dist/utils/template-strings.js

@@ -1,49 +1,122 @@
-function js(strings, ...values) {
-  return _combine(strings, values);
+/**
+ * 템플릿 문자열 태그 함수
+ * IDE 코드 하이라이팅 지원용 (실제 동작은 문자열 결합 + 들여쓰기 정규화)
+ */
+/**
+ * JavaScript 코드 하이라이팅용 템플릿 태그
+ * @param strings 템플릿 문자열 배열
+ * @param values 보간된 값들
+ * @returns 들여쓰기가 정규화된 문자열
+ * @example
+ * const code = js`
+ *   function hello() {
+ *     return "world";
+ *   }
+ * `;
+ */
+export function js(strings, ...values) {
+    return _combine(strings, values);
 }
-function ts(strings, ...values) {
-  return _combine(strings, values);
+/**
+ * TypeScript 코드 하이라이팅용 템플릿 태그
+ * @param strings 템플릿 문자열 배열
+ * @param values 보간된 값들
+ * @returns 들여쓰기가 정규화된 문자열
+ * @example
+ * const code = ts`
+ *   interface User {
+ *     name: string;
+ *     age: number;
+ *   }
+ * `;
+ */
+export function ts(strings, ...values) {
+    return _combine(strings, values);
 }
-function html(strings, ...values) {
-  return _combine(strings, values);
+/**
+ * HTML 마크업 하이라이팅용 템플릿 태그
+ * @param strings 템플릿 문자열 배열
+ * @param values 보간된 값들
+ * @returns 들여쓰기가 정규화된 문자열
+ * @example
+ * const markup = html`
+ *   <div class="container">
+ *     <span>${name}</span>
+ *   </div>
+ * `;
+ */
+export function html(strings, ...values) {
+    return _combine(strings, values);
 }
-function tsql(strings, ...values) {
-  return _combine(strings, values);
+/**
+ * MSSQL T-SQL 하이라이팅용 템플릿 태그
+ * @param strings 템플릿 문자열 배열
+ * @param values 보간된 값들
+ * @returns 들여쓰기가 정규화된 문자열
+ * @example
+ * const query = tsql`
+ *   SELECT TOP 10 *
+ *   FROM Users
+ *   WHERE Name LIKE '%${keyword}%'
+ * `;
+ */
+export function tsql(strings, ...values) {
+    return _combine(strings, values);
 }
-function mysql(strings, ...values) {
-  return _combine(strings, values);
+/**
+ * MySQL SQL 하이라이팅용 템플릿 태그
+ * @param strings 템플릿 문자열 배열
+ * @param values 보간된 값들
+ * @returns 들여쓰기가 정규화된 문자열
+ * @example
+ * const query = mysql`
+ *   SELECT *
+ *   FROM users
+ *   LIMIT 10
+ * `;
+ */
+export function mysql(strings, ...values) {
+    return _combine(strings, values);
 }
-function pgsql(strings, ...values) {
-  return _combine(strings, values);
+/**
+ * PostgreSQL SQL 하이라이팅용 템플릿 태그
+ * @param strings 템플릿 문자열 배열
+ * @param values 보간된 값들
+ * @returns 들여쓰기가 정규화된 문자열
+ * @example
+ * const query = pgsql`
+ *   SELECT *
+ *   FROM users
+ *   OFFSET 0 LIMIT 10
+ * `;
+ */
+export function pgsql(strings, ...values) {
+    return _combine(strings, values);
 }
 function _combine(strings, values) {
-  const raw = strings.reduce((result, str, i) => {
-    const value = values[i] !== void 0 ? String(values[i]) : "";
-    return result + str + value;
-  }, "");
-  return _trimIndent(raw);
+    const raw = strings.reduce((result, str, i) => {
+        const value = values[i] !== undefined ? String(values[i]) : "";
+        return result + str + value;
+    }, "");
+    return _trimIndent(raw);
 }
 function _trimIndent(text) {
-  const lines = text.split("\n");
-  while (lines.length > 0 && lines[0].trim() === "") {
-    lines.shift();
-  }
-  while (lines.length > 0 && lines[lines.length - 1].trim() === "") {
-    lines.pop();
-  }
-  const minIndent = lines.filter((line) => line.trim() !== "").reduce((min, line) => {
-    var _a;
-    const indent = ((_a = line.match(/^ */)) == null ? void 0 : _a[0].length) ?? 0;
-    return Math.min(min, indent);
-  }, Infinity);
-  return lines.map((line) => line.trim() === "" ? "" : line.slice(minIndent)).join("\n");
-}
-export {
-  html,
-  js,
-  mysql,
-  pgsql,
-  ts,
-  tsql
-};
-//# sourceMappingURL=template-strings.js.map
+    const lines = text.split("\n");
+    // 앞뒤 빈 줄 제거 (연속된 빈 줄 모두 제거)
+    while (lines.length > 0 && lines[0].trim() === "") {
+        lines.shift();
+    }
+    while (lines.length > 0 && lines[lines.length - 1].trim() === "") {
+        lines.pop();
+    }
+    // 최소 들여쓰기 계산
+    const minIndent = lines
+        .filter((line) => line.trim() !== "")
+        .reduce((min, line) => {
+        const indent = line.match(/^ */)?.[0].length ?? 0;
+        return Math.min(min, indent);
+    }, Infinity);
+    // 들여쓰기 제거
+    return lines.map((line) => (line.trim() === "" ? "" : line.slice(minIndent))).join("\n");
+}
+//# sourceMappingURL=template-strings.js.map

package/dist/utils/template-strings.js.map

@@ -1,6 +1 @@
-{
-  "version": 3,
-  "sources": ["../../src/utils/template-strings.ts"],
-  "mappings": "AAiBO,SAAS,GAAG,YAAkC,QAA2B;AAC9E,SAAO,SAAS,SAAS,MAAM;AACjC;AAeO,SAAS,GAAG,YAAkC,QAA2B;AAC9E,SAAO,SAAS,SAAS,MAAM;AACjC;AAcO,SAAS,KAAK,YAAkC,QAA2B;AAChF,SAAO,SAAS,SAAS,MAAM;AACjC;AAcO,SAAS,KAAK,YAAkC,QAA2B;AAChF,SAAO,SAAS,SAAS,MAAM;AACjC;AAcO,SAAS,MAAM,YAAkC,QAA2B;AACjF,SAAO,SAAS,SAAS,MAAM;AACjC;AAcO,SAAS,MAAM,YAAkC,QAA2B;AACjF,SAAO,SAAS,SAAS,MAAM;AACjC;AAEA,SAAS,SAAS,SAA+B,QAA2B;AAC1E,QAAM,MAAM,QAAQ,OAAO,CAAC,QAAQ,KAAK,MAAM;AAC7C,UAAM,QAAQ,OAAO,CAAC,MAAM,SAAY,OAAO,OAAO,CAAC,CAAC,IAAI;AAC5D,WAAO,SAAS,MAAM;AAAA,EACxB,GAAG,EAAE;AACL,SAAO,YAAY,GAAG;AACxB;AAEA,SAAS,YAAY,MAAsB;AACzC,QAAM,QAAQ,KAAK,MAAM,IAAI;AAG7B,SAAO,MAAM,SAAS,KAAK,MAAM,CAAC,EAAE,KAAK,MAAM,IAAI;AACjD,UAAM,MAAM;AAAA,EACd;AACA,SAAO,MAAM,SAAS,KAAK,MAAM,MAAM,SAAS,CAAC,EAAE,KAAK,MAAM,IAAI;AAChE,UAAM,IAAI;AAAA,EACZ;AAGA,QAAM,YAAY,MACf,OAAO,CAAC,SAAS,KAAK,KAAK,MAAM,EAAE,EACnC,OAAO,CAAC,KAAK,SAAS;AA5H3B;AA6HM,UAAM,WAAS,UAAK,MAAM,KAAK,MAAhB,mBAAoB,GAAG,WAAU;AAChD,WAAO,KAAK,IAAI,KAAK,MAAM;AAAA,EAC7B,GAAG,QAAQ;AAGb,SAAO,MAAM,IAAI,CAAC,SAAU,KAAK,KAAK,MAAM,KAAK,KAAK,KAAK,MAAM,SAAS,CAAE,EAAE,KAAK,IAAI;AACzF;",
-  "names": []
-}
+{"version":3,"file":"template-strings.js","sourceRoot":"","sources":["../../src/utils/template-strings.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,EAAE,CAAC,OAA6B,EAAE,GAAG,MAAiB;IACpE,OAAO,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AACnC,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,EAAE,CAAC,OAA6B,EAAE,GAAG,MAAiB;IACpE,OAAO,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AACnC,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,IAAI,CAAC,OAA6B,EAAE,GAAG,MAAiB;IACtE,OAAO,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AACnC,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,IAAI,CAAC,OAA6B,EAAE,GAAG,MAAiB;IACtE,OAAO,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AACnC,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,KAAK,CAAC,OAA6B,EAAE,GAAG,MAAiB;IACvE,OAAO,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AACnC,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,KAAK,CAAC,OAA6B,EAAE,GAAG,MAAiB;IACvE,OAAO,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AACnC,CAAC;AAED,SAAS,QAAQ,CAAC,OAA6B,EAAE,MAAiB;IAChE,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE;QAC5C,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/D,OAAO,MAAM,GAAG,GAAG,GAAG,KAAK,CAAC;IAC9B,CAAC,EAAE,EAAE,CAAC,CAAC;IACP,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,WAAW,CAAC,IAAY;IAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAE/B,4BAA4B;IAC5B,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAClD,KAAK,CAAC,KAAK,EAAE,CAAC;IAChB,CAAC;IACD,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACjE,KAAK,CAAC,GAAG,EAAE,CAAC;IACd,CAAC;IAED,aAAa;IACb,MAAM,SAAS,GAAG,KAAK;SACpB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;SACpC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;QACpB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC;QAClD,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC/B,CAAC,EAAE,QAAQ,CAAC,CAAC;IAEf,UAAU;IACV,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC3F,CAAC"}