@simplysm/core-browser 13.0.0-beta.1

package/dist/core-common/src/utils/path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../../../../core-common/src/utils/path.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAKtD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAMnE;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAIpD"}

package/dist/core-common/src/utils/primitive.d.ts

@@ -0,0 +1,18 @@
+import type { PrimitiveTypeMap, PrimitiveTypeStr } from "../common.types";
+/**
+ * 값에서 PrimitiveTypeStr 추론
+ *
+ * 런타임에서 값의 타입을 검사하여 해당하는 PrimitiveTypeStr을 반환합니다.
+ *
+ * @param value 타입을 추론할 값
+ * @returns 값에 해당하는 PrimitiveTypeStr
+ * @throws ArgumentError 지원하지 않는 타입인 경우
+ *
+ * @example
+ * getPrimitiveTypeStr("hello") // "string"
+ * getPrimitiveTypeStr(123) // "number"
+ * getPrimitiveTypeStr(new DateTime()) // "DateTime"
+ * getPrimitiveTypeStr(new Uint8Array()) // "Bytes"
+ */
+export declare function getPrimitiveTypeStr(value: PrimitiveTypeMap[PrimitiveTypeStr]): PrimitiveTypeStr;
+//# sourceMappingURL=primitive.d.ts.map

package/dist/core-common/src/utils/primitive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitive.d.ts","sourceRoot":"","sources":["../../../../../core-common/src/utils/primitive.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAE1E;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,gBAAgB,CAAC,gBAAgB,CAAC,GAAG,gBAAgB,CAU/F"}

package/dist/core-common/src/utils/str.d.ts

@@ -0,0 +1,103 @@
+/**
+ * 문자열 유틸리티 함수
+ */
+/**
+ * 한글 조사를 받침에 따라 적절히 반환
+ * @param text 텍스트
+ * @param type 조사 타입
+ *   - `"을"`: 을/를
+ *   - `"은"`: 은/는
+ *   - `"이"`: 이/가
+ *   - `"와"`: 과/와
+ *   - `"랑"`: 이랑/랑
+ *   - `"로"`: 으로/로
+ *   - `"라"`: 이라/라
+ *
+ * @example
+ * getSuffix("사과", "을") // "를"
+ * getSuffix("책", "이") // "이"
+ */
+export declare function strGetSuffix(text: string, type: "을" | "은" | "이" | "와" | "랑" | "로" | "라"): string;
+/**
+ * 전각(Full-width) 문자를 반각(Half-width) 문자로 변환
+ *
+ * 변환 대상:
+ * - 전각 영문 대문자 (Ａ-Ｚ → A-Z)
+ * - 전각 영문 소문자 (ａ-ｚ → a-z)
+ * - 전각 숫자 (０-９ → 0-9)
+ * - 전각 공백 (　 → 일반 공백)
+ * - 전각 괄호 (（） → ())
+ *
+ * @example
+ * replaceSpecialDefaultChar("Ａ１２３") // "A123"
+ * replaceSpecialDefaultChar("（株）") // "(株)"
+ */
+export declare function strReplaceFullWidth(str: string): string;
+/**
+ * PascalCase로 변환
+ * @example "hello-world" → "HelloWorld"
+ * @example "hello_world" → "HelloWorld"
+ * @example "hello.world" → "HelloWorld"
+ */
+export declare function strToPascalCase(str: string): string;
+/**
+ * camelCase로 변환
+ * @example "hello-world" → "helloWorld"
+ * @example "hello_world" → "helloWorld"
+ * @example "HelloWorld" → "helloWorld"
+ */
+export declare function strToCamelCase(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 declare function strToKebabCase(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 declare function strToSnakeCase(str: string): string;
+/**
+ * undefined 또는 빈 문자열 여부 체크 (타입 가드)
+ *
+ * @param str 체크할 문자열
+ * @returns undefined, null, 빈 문자열이면 true
+ *
+ * @example
+ * const name: string | undefined = getValue();
+ * if (strIsNullOrEmpty(name)) {
+ *   // name: "" | undefined
+ *   console.log("이름이 비어있습니다");
+ * } else {
+ *   // name: string (비어있지 않은 문자열)
+ *   console.log(`이름: ${name}`);
+ * }
+ */
+export declare function strIsNullOrEmpty(str: string | undefined): str is "" | undefined;
+/**
+ * 문자열 특정 위치에 삽입
+ *
+ * @param str 원본 문자열
+ * @param index 삽입할 위치 (0부터 시작)
+ * @param insertString 삽입할 문자열
+ * @returns 삽입된 새 문자열
+ *
+ * @example
+ * strInsert("Hello World", 5, ","); // "Hello, World"
+ * strInsert("abc", 0, "X"); // "Xabc"
+ * strInsert("abc", 3, "X"); // "abcX"
+ */
+export declare function strInsert(str: string, index: number, insertString: string): string;
+//# sourceMappingURL=str.d.ts.map

package/dist/core-common/src/utils/str.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"str.d.ts","sourceRoot":"","sources":["../../../../../core-common/src/utils/str.ts"],"names":[],"mappings":"AAAA;;GAEG;AAeH;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,MAAM,CAyBhG;AA8ED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEvD;AAMD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAElD;AAUD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,GAAG,IAAI,EAAE,GAAG,SAAS,CAE/E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAElF"}

package/dist/core-common/src/utils/template-strings.d.ts

@@ -0,0 +1,84 @@
+/**
+ * 템플릿 문자열 태그 함수들
+ * IDE 코드 하이라이팅 지원용 (실제 동작은 문자열 조합 + 들여쓰기 정리)
+ */
+/**
+ * JavaScript 코드 하이라이팅용 템플릿 태그
+ * @param strings 템플릿 문자열 배열
+ * @param values 보간된 값들
+ * @returns 들여쓰기가 정리된 문자열
+ * @example
+ * const code = js`
+ *   function hello() {
+ *     return "world";
+ *   }
+ * `;
+ */
+export declare function js(strings: TemplateStringsArray, ...values: unknown[]): string;
+/**
+ * TypeScript 코드 하이라이팅용 템플릿 태그
+ * @param strings 템플릿 문자열 배열
+ * @param values 보간된 값들
+ * @returns 들여쓰기가 정리된 문자열
+ * @example
+ * const code = ts`
+ *   interface User {
+ *     name: string;
+ *     age: number;
+ *   }
+ * `;
+ */
+export declare function ts(strings: TemplateStringsArray, ...values: unknown[]): string;
+/**
+ * HTML 마크업 하이라이팅용 템플릿 태그
+ * @param strings 템플릿 문자열 배열
+ * @param values 보간된 값들
+ * @returns 들여쓰기가 정리된 문자열
+ * @example
+ * const markup = html`
+ *   <div class="container">
+ *     <span>${name}</span>
+ *   </div>
+ * `;
+ */
+export declare function html(strings: TemplateStringsArray, ...values: unknown[]): string;
+/**
+ * MSSQL T-SQL 하이라이팅용 템플릿 태그
+ * @param strings 템플릿 문자열 배열
+ * @param values 보간된 값들
+ * @returns 들여쓰기가 정리된 문자열
+ * @example
+ * const query = tsql`
+ *   SELECT TOP 10 *
+ *   FROM Users
+ *   WHERE Name LIKE '%${keyword}%'
+ * `;
+ */
+export declare function tsql(strings: TemplateStringsArray, ...values: unknown[]): string;
+/**
+ * MySQL SQL 하이라이팅용 템플릿 태그
+ * @param strings 템플릿 문자열 배열
+ * @param values 보간된 값들
+ * @returns 들여쓰기가 정리된 문자열
+ * @example
+ * const query = mysql`
+ *   SELECT *
+ *   FROM users
+ *   LIMIT 10
+ * `;
+ */
+export declare function mysql(strings: TemplateStringsArray, ...values: unknown[]): string;
+/**
+ * PostgreSQL SQL 하이라이팅용 템플릿 태그
+ * @param strings 템플릿 문자열 배열
+ * @param values 보간된 값들
+ * @returns 들여쓰기가 정리된 문자열
+ * @example
+ * const query = pgsql`
+ *   SELECT *
+ *   FROM users
+ *   OFFSET 0 LIMIT 10
+ * `;
+ */
+export declare function pgsql(strings: TemplateStringsArray, ...values: unknown[]): string;
+//# sourceMappingURL=template-strings.d.ts.map

package/dist/core-common/src/utils/template-strings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-strings.d.ts","sourceRoot":"","sources":["../../../../../core-common/src/utils/template-strings.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;GAWG;AACH,wBAAgB,EAAE,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAE9E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,EAAE,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAE9E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAEhF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAEhF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAEjF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAEjF"}

package/dist/core-common/src/utils/transferable.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Worker 간 전송 가능한 객체 타입
+ *
+ * 이 코드에서는 ArrayBuffer만 사용됩니다.
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API/Transferable_objects
+ */
+type Transferable = ArrayBuffer;
+/**
+ * Transferable 변환 유틸리티 함수
+ *
+ * Worker 간 데이터 전송을 위한 직렬화/역직렬화를 수행합니다.
+ * structuredClone이 지원하지 않는 커스텀 타입들을 처리합니다.
+ *
+ * 지원 타입:
+ * - Date, DateTime, DateOnly, Time, Uuid, RegExp
+ * - Error (cause, code, detail 포함)
+ * - Uint8Array (다른 TypedArray는 미지원, 일반 객체로 처리됨)
+ * - Array, Map, Set, 일반 객체
+ *
+ * @note 순환 참조가 있으면 transferableEncode 시 TypeError 발생 (경로 정보 포함)
+ * @note 동일 객체가 여러 곳에서 참조되면 캐시된 인코딩 결과를 재사용합니다
+ *
+ * @example
+ * // Worker로 데이터 전송
+ * const { result, transferList } = transferableEncode(data);
+ * worker.postMessage(result, transferList);
+ *
+ * // Worker에서 데이터 수신
+ * const decoded = transferableDecode(event.data);
+ */
+/**
+ * 심플리즘 타입을 사용한 객체를 일반 객체로 변환
+ * Worker에 전송할 수 있는 형태로 직렬화
+ *
+ * @throws 순환 참조 감지 시 TypeError
+ */
+export declare function transferableEncode(obj: unknown): {
+    result: unknown;
+    transferList: Transferable[];
+};
+/**
+ * serialize 객체를 심플리즘 타입 사용 객체로 변환
+ * Worker로부터 받은 데이터를 역직렬화
+ */
+export declare function transferableDecode(obj: unknown): unknown;
+export {};
+//# sourceMappingURL=transferable.d.ts.map

package/dist/core-common/src/utils/transferable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transferable.d.ts","sourceRoot":"","sources":["../../../../../core-common/src/utils/transferable.ts"],"names":[],"mappings":"AAKA;;;;;GAKG;AACH,KAAK,YAAY,GAAG,WAAW,CAAC;AAEhC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG;IAChD,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,EAAE,YAAY,EAAE,CAAC;CAC9B,CAMA;AAqID;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CA2ExD"}

package/dist/core-common/src/utils/wait.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 조건이 참이 될 때까지 대기
+ * @param forwarder 조건 함수
+ * @param milliseconds 체크 간격 (기본: 100ms)
+ * @param maxCount 최대 시도 횟수 (undefined면 무제한)
+ *
+ * @note 조건이 첫 번째 호출에서 true면 즉시 반환됩니다.
+ * @example
+ * // maxCount=3: 최대 3번 조건 확인 후 모두 false면 TimeoutError
+ * await waitUntil(() => someCondition, 100, 3);
+ * @throws TimeoutError 최대 시도 횟수 초과 시
+ */
+export declare function waitUntil(forwarder: () => boolean | Promise<boolean>, milliseconds?: number, maxCount?: number): Promise<void>;
+/**
+ * 지정된 시간만큼 대기
+ * @param millisecond 대기 시간 (ms)
+ */
+export declare function waitTime(millisecond: number): Promise<void>;
+//# sourceMappingURL=wait.d.ts.map

package/dist/core-common/src/utils/wait.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait.d.ts","sourceRoot":"","sources":["../../../../../core-common/src/utils/wait.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;GAWG;AACH,wBAAsB,SAAS,CAC7B,SAAS,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,EAC3C,YAAY,CAAC,EAAE,MAAM,EACrB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAUf;AAED;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEjE"}

package/dist/core-common/src/utils/xml.d.ts

@@ -0,0 +1,36 @@
+/**
+ * XML 변환 유틸리티
+ */
+import type { XmlBuilderOptions } from "fast-xml-parser";
+/**
+ * XML 문자열을 객체로 파싱
+ * @param str XML 문자열
+ * @param options 옵션
+ * @param options.stripTagPrefix 태그 prefix 제거 여부 (namespace)
+ * @returns 파싱된 객체. 구조:
+ *   - 속성: `$` 객체에 그룹화
+ *   - 텍스트 노드: `_` 키에 저장
+ *   - 자식 요소: 배열로 변환 (루트 요소 제외)
+ * @example
+ * xmlParse('<root id="1"><item>hello</item></root>');
+ * // { root: { $: { id: "1" }, item: [{ _: "hello" }] } }
+ */
+export declare function xmlParse(str: string, options?: {
+    stripTagPrefix?: boolean;
+}): unknown;
+/**
+ * 객체를 XML 문자열로 직렬화
+ * @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 declare function xmlStringify(obj: unknown, options?: XmlBuilderOptions): string;
+//# sourceMappingURL=xml.d.ts.map

package/dist/core-common/src/utils/xml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xml.d.ts","sourceRoot":"","sources":["../../../../../core-common/src/utils/xml.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAKzD;;;;;;;;;;;;GAYG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;IAAE,cAAc,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAarF;AAMD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAS9E"}

package/dist/core-common/src/zip/sd-zip.d.ts

@@ -0,0 +1,80 @@
+import type { Bytes } from "../common.types";
+export interface ZipArchiveProgress {
+    fileName: string;
+    totalSize: number;
+    extractedSize: number;
+}
+/**
+ * ZIP 아카이브 처리 클래스
+ *
+ * ZIP 파일의 읽기, 쓰기, 압축/해제를 처리합니다.
+ * 내부 캐시를 사용하여 동일 파일의 중복 압축 해제를 방지합니다.
+ *
+ * @example
+ * // ZIP 파일 읽기
+ * await using archive = new ZipArchive(zipBytes);
+ * const content = await archive.get("file.txt");
+ *
+ * @example
+ * // ZIP 파일 생성
+ * await using archive = new ZipArchive();
+ * archive.write("file.txt", textBytes);
+ * archive.write("data.json", jsonBytes);
+ * const zipBytes = await archive.compress();
+ *
+ * @example
+ * // 전체 압축 해제 (진행률 표시)
+ * await using archive = new ZipArchive(zipBytes);
+ * const files = await archive.extractAll((progress) => {
+ *   console.log(`${progress.fileName}: ${progress.extractedSize}/${progress.totalSize}`);
+ * });
+ */
+export declare class ZipArchive {
+    private readonly _reader?;
+    private readonly _cache;
+    private _entries?;
+    /**
+     * ZipArchive 생성
+     * @param data ZIP 데이터 (생략 시 새 아카이브 생성)
+     */
+    constructor(data?: Blob | Bytes);
+    private _getEntries;
+    /**
+     * 모든 파일을 압축 해제
+     * @param progressCallback 진행률 콜백
+     */
+    extractAll(progressCallback?: (progress: ZipArchiveProgress) => void): Promise<Map<string, Bytes | undefined>>;
+    /**
+     * 특정 파일 압축 해제
+     * @param fileName 파일 이름
+     */
+    get(fileName: string): Promise<Bytes | undefined>;
+    /**
+     * 파일 존재 여부 확인
+     * @param fileName 파일 이름
+     */
+    exists(fileName: string): Promise<boolean>;
+    /**
+     * 파일 쓰기 (캐시에 저장)
+     * @param fileName 파일 이름
+     * @param bytes 파일 내용
+     */
+    write(fileName: string, bytes: Bytes): void;
+    /**
+     * 캐시된 파일들을 ZIP으로 압축
+     *
+     * @remarks
+     * 내부적으로 `extractAll()`을 호출하여 모든 파일을 메모리에 로드한 후 압축합니다.
+     * 대용량 ZIP 파일의 경우 메모리 사용량에 주의가 필요합니다.
+     */
+    compress(): Promise<Bytes>;
+    /**
+     * 리더 닫기 및 캐시 정리
+     */
+    close(): Promise<void>;
+    /**
+     * await using 지원
+     */
+    [Symbol.asyncDispose](): Promise<void>;
+}
+//# sourceMappingURL=sd-zip.d.ts.map

package/dist/core-common/src/zip/sd-zip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sd-zip.d.ts","sourceRoot":"","sources":["../../../../../core-common/src/zip/sd-zip.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAE7C,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAA0B;IACnD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwC;IAC/D,OAAO,CAAC,QAAQ,CAAC,CAA6D;IAE9E;;;OAGG;gBACS,IAAI,CAAC,EAAE,IAAI,GAAG,KAAK;YAUjB,WAAW;IAQzB;;;OAGG;IACG,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,kBAAkB,KAAK,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,GAAG,SAAS,CAAC,CAAC;IAkDpH;;;OAGG;IACG,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC;IAwBvD;;;OAGG;IACG,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAgBhD;;;;OAIG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI;IAM3C;;;;;;OAMG;IACG,QAAQ,IAAI,OAAO,CAAC,KAAK,CAAC;IAiBhC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B;;OAEG;IACG,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC;CAI7C"}

package/dist/extensions/element-ext.js

@@ -0,0 +1,122 @@
+import { isFocusable } from "tabbable";
+import { TimeoutError } from "@simplysm/core-common";
+Element.prototype.findAll = function(selector) {
+  const trimmed = selector.trim();
+  if (trimmed === "") return [];
+  return Array.from(this.querySelectorAll(trimmed));
+};
+Element.prototype.findFirst = function(selector) {
+  const trimmed = selector.trim();
+  if (trimmed === "") return void 0;
+  return this.querySelector(trimmed) ?? void 0;
+};
+Element.prototype.prependChild = function(child) {
+  return this.insertBefore(child, this.firstElementChild);
+};
+Element.prototype.getParents = function() {
+  const result = [];
+  let cursor = this.parentNode;
+  while (cursor !== null && cursor instanceof Element) {
+    result.push(cursor);
+    cursor = cursor.parentNode;
+  }
+  return result;
+};
+Element.prototype.findFocusableParent = function() {
+  let parentEl = this.parentElement;
+  while (parentEl !== null) {
+    if (isFocusable(parentEl)) {
+      return parentEl;
+    }
+    parentEl = parentEl.parentElement;
+  }
+  return void 0;
+};
+Element.prototype.findFirstFocusableChild = function() {
+  const walker = document.createTreeWalker(this, NodeFilter.SHOW_ELEMENT);
+  let node = walker.nextNode();
+  while (node !== null) {
+    if (node instanceof HTMLElement && isFocusable(node)) {
+      return node;
+    }
+    node = walker.nextNode();
+  }
+  return void 0;
+};
+Element.prototype.isOffsetElement = function() {
+  return ["relative", "absolute", "fixed", "sticky"].includes(getComputedStyle(this).position);
+};
+Element.prototype.isVisible = function() {
+  const style = getComputedStyle(this);
+  return this.getClientRects().length > 0 && style.visibility !== "hidden" && style.opacity !== "0";
+};
+function copyElement(event) {
+  const clipboardData = event.clipboardData;
+  const target = event.target;
+  if (clipboardData == null || !(target instanceof Element)) return;
+  const firstInputEl = target.querySelector("input, textarea");
+  if (firstInputEl != null) {
+    clipboardData.setData("text/plain", firstInputEl.value);
+    event.preventDefault();
+  }
+}
+function pasteToElement(event) {
+  const clipboardData = event.clipboardData;
+  const target = event.target;
+  if (clipboardData == null || !(target instanceof Element)) return;
+  const contentText = clipboardData.getData("text/plain");
+  const firstInputEl = target.findFirst("input, textarea");
+  if (firstInputEl !== void 0) {
+    firstInputEl.value = contentText;
+    firstInputEl.dispatchEvent(new Event("input", { bubbles: true }));
+    event.preventDefault();
+  }
+}
+async function getBounds(els, timeout = 5e3) {
+  const indexMap = new Map(els.map((el, i) => [el, i]));
+  if (indexMap.size === 0) {
+    return [];
+  }
+  const sortIndexMap = new Map(els.map((el, i) => [el, i]));
+  let observer;
+  try {
+    return await Promise.race([
+      new Promise((resolve) => {
+        const results = [];
+        observer = new IntersectionObserver((entries) => {
+          for (const entry of entries) {
+            const target = entry.target;
+            if (indexMap.has(target)) {
+              indexMap.delete(target);
+              results.push({
+                target,
+                top: entry.boundingClientRect.top,
+                left: entry.boundingClientRect.left,
+                width: entry.boundingClientRect.width,
+                height: entry.boundingClientRect.height
+              });
+            }
+          }
+          if (indexMap.size === 0) {
+            observer == null ? void 0 : observer.disconnect();
+            resolve(results.sort((a, b) => sortIndexMap.get(a.target) - sortIndexMap.get(b.target)));
+          }
+        });
+        for (const el of indexMap.keys()) {
+          observer.observe(el);
+        }
+      }),
+      new Promise(
+        (_, reject) => setTimeout(() => reject(new TimeoutError(void 0, `${timeout}ms \uCD08\uACFC`)), timeout)
+      )
+    ]);
+  } finally {
+    observer == null ? void 0 : observer.disconnect();
+  }
+}
+export {
+  copyElement,
+  getBounds,
+  pasteToElement
+};
+//# sourceMappingURL=element-ext.js.map

package/dist/extensions/element-ext.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/extensions/element-ext.ts"],
+  "sourcesContent": ["import { isFocusable } from \"tabbable\";\nimport { TimeoutError } from \"@simplysm/core-common\";\n\n/**\n * \uC694\uC18C bounds \uC815\uBCF4 \uD0C0\uC785\n */\nexport interface ElementBounds {\n  /** \uCE21\uC815 \uB300\uC0C1 \uC694\uC18C */\n  target: Element;\n  /** \uBDF0\uD3EC\uD2B8 \uAE30\uC900 \uC0C1\uB2E8 \uC704\uCE58 */\n  top: number;\n  /** \uBDF0\uD3EC\uD2B8 \uAE30\uC900 \uC67C\uCABD \uC704\uCE58 */\n  left: number;\n  /** \uC694\uC18C \uB108\uBE44 */\n  width: number;\n  /** \uC694\uC18C \uB192\uC774 */\n  height: number;\n}\n\ndeclare global {\n  interface Element {\n    /**\n     * \uC140\uB809\uD130\uB85C \uD558\uC704 \uC694\uC18C \uC804\uCCB4 \uAC80\uC0C9\n     *\n     * @param selector - CSS \uC140\uB809\uD130\n     * @returns \uB9E4\uCE6D\uB41C \uC694\uC18C \uBC30\uC5F4 (\uBE48 \uC140\uB809\uD130\uB294 \uBE48 \uBC30\uC5F4 \uBC18\uD658)\n     */\n    findAll<T extends Element = Element>(selector: string): T[];\n\n    /**\n     * \uC140\uB809\uD130\uB85C \uCCAB \uBC88\uC9F8 \uB9E4\uCE6D \uC694\uC18C \uAC80\uC0C9\n     *\n     * @param selector - CSS \uC140\uB809\uD130\n     * @returns \uCCAB \uBC88\uC9F8 \uB9E4\uCE6D \uC694\uC18C \uB610\uB294 undefined (\uBE48 \uC140\uB809\uD130\uB294 undefined \uBC18\uD658)\n     */\n    findFirst<T extends Element = Element>(selector: string): T | undefined;\n\n    /**\n     * \uC694\uC18C\uB97C \uCCAB \uBC88\uC9F8 \uC790\uC2DD\uC73C\uB85C \uC0BD\uC785\n     *\n     * @param child - \uC0BD\uC785\uD560 \uC790\uC2DD \uC694\uC18C\n     * @returns \uC0BD\uC785\uB41C \uC790\uC2DD \uC694\uC18C\n     */\n    prependChild<T extends Element>(child: T): T;\n\n    /**\n     * \uBAA8\uB4E0 \uBD80\uBAA8 \uC694\uC18C \uBAA9\uB85D \uBC18\uD658 (\uAC00\uAE4C\uC6B4 \uC21C\uC11C)\n     *\n     * @returns \uBD80\uBAA8 \uC694\uC18C \uBC30\uC5F4 (\uAC00\uAE4C\uC6B4 \uBD80\uBAA8\uBD80\uD130 \uC21C\uC11C\uB300\uB85C)\n     */\n    getParents(): Element[];\n\n    /**\n     * \uBD80\uBAA8 \uC911 \uCCAB \uBC88\uC9F8 \uD3EC\uCEE4\uC2A4 \uAC00\uB2A5 \uC694\uC18C \uAC80\uC0C9 (tabbable \uC0AC\uC6A9)\n     *\n     * @returns \uD3EC\uCEE4\uC2A4 \uAC00\uB2A5\uD55C \uCCAB \uBC88\uC9F8 \uBD80\uBAA8 \uC694\uC18C \uB610\uB294 undefined\n     */\n    findFocusableParent(): HTMLElement | undefined;\n\n    /**\n     * \uC790\uC2DD \uC911 \uCCAB \uBC88\uC9F8 \uD3EC\uCEE4\uC2A4 \uAC00\uB2A5 \uC694\uC18C \uAC80\uC0C9 (tabbable \uC0AC\uC6A9)\n     *\n     * @returns \uD3EC\uCEE4\uC2A4 \uAC00\uB2A5\uD55C \uCCAB \uBC88\uC9F8 \uC790\uC2DD \uC694\uC18C \uB610\uB294 undefined\n     */\n    findFirstFocusableChild(): HTMLElement | undefined;\n\n    /**\n     * \uC694\uC18C\uAC00 offset \uAE30\uC900 \uC694\uC18C\uC778\uC9C0 \uD655\uC778 (position: relative/absolute/fixed/sticky)\n     *\n     * @returns position \uC18D\uC131\uC774 relative, absolute, fixed, sticky \uC911 \uD558\uB098\uBA74 true\n     */\n    isOffsetElement(): boolean;\n\n    /**\n     * \uC694\uC18C\uAC00 \uD654\uBA74\uC5D0 \uBCF4\uC774\uB294\uC9C0 \uD655\uC778\n     *\n     * @remarks\n     * clientRects \uC874\uC7AC \uC5EC\uBD80, visibility: hidden, opacity: 0 \uC5EC\uBD80\uB97C \uD655\uC778\uD55C\uB2E4.\n     *\n     * @returns \uC694\uC18C\uAC00 \uD654\uBA74\uC5D0 \uBCF4\uC774\uBA74 true\n     */\n    isVisible(): boolean;\n  }\n}\n\nElement.prototype.findAll = function <T extends Element = Element>(selector: string): T[] {\n  const trimmed = selector.trim();\n  if (trimmed === \"\") return [];\n  return Array.from(this.querySelectorAll<T>(trimmed));\n};\n\nElement.prototype.findFirst = function <T extends Element = Element>(selector: string): T | undefined {\n  const trimmed = selector.trim();\n  if (trimmed === \"\") return undefined;\n  return this.querySelector<T>(trimmed) ?? undefined;\n};\n\nElement.prototype.prependChild = function <T extends Element>(child: T): T {\n  return this.insertBefore(child, this.firstElementChild);\n};\n\nElement.prototype.getParents = function (): Element[] {\n  const result: Element[] = [];\n  let cursor = this.parentNode;\n  while (cursor !== null && cursor instanceof Element) {\n    result.push(cursor);\n    cursor = cursor.parentNode;\n  }\n  return result;\n};\n\nElement.prototype.findFocusableParent = function (): HTMLElement | undefined {\n  let parentEl = this.parentElement;\n  while (parentEl !== null) {\n    if (isFocusable(parentEl)) {\n      return parentEl;\n    }\n    parentEl = parentEl.parentElement;\n  }\n  return undefined;\n};\n\nElement.prototype.findFirstFocusableChild = function (): HTMLElement | undefined {\n  const walker = document.createTreeWalker(this, NodeFilter.SHOW_ELEMENT);\n  let node = walker.nextNode();\n  while (node !== null) {\n    if (node instanceof HTMLElement && isFocusable(node)) {\n      return node;\n    }\n    node = walker.nextNode();\n  }\n  return undefined;\n};\n\nElement.prototype.isOffsetElement = function (): boolean {\n  return [\"relative\", \"absolute\", \"fixed\", \"sticky\"].includes(getComputedStyle(this).position);\n};\n\nElement.prototype.isVisible = function (): boolean {\n  const style = getComputedStyle(this);\n  return this.getClientRects().length > 0 && style.visibility !== \"hidden\" && style.opacity !== \"0\";\n};\n\n// ============================================================================\n// \uC815\uC801 \uD568\uC218 (\uC774\uBCA4\uD2B8 \uD578\uB4E4\uB7EC\uC6A9 \uB610\uB294 \uC5EC\uB7EC \uC694\uC18C \uB300\uC0C1)\n// ============================================================================\n\n/**\n * \uC694\uC18C \uB0B4\uC6A9\uC744 \uD074\uB9BD\uBCF4\uB4DC\uC5D0 \uBCF5\uC0AC (copy \uC774\uBCA4\uD2B8 \uD578\uB4E4\uB7EC\uC5D0\uC11C \uC0AC\uC6A9)\n *\n * @param event - copy \uC774\uBCA4\uD2B8 \uAC1D\uCCB4\n */\nexport function copyElement(event: ClipboardEvent): void {\n  const clipboardData = event.clipboardData;\n  const target = event.target;\n  if (clipboardData == null || !(target instanceof Element)) return;\n\n  const firstInputEl = target.querySelector<HTMLInputElement | HTMLTextAreaElement>(\"input, textarea\");\n  if (firstInputEl != null) {\n    clipboardData.setData(\"text/plain\", firstInputEl.value);\n    event.preventDefault();\n  }\n}\n\n/**\n * \uD074\uB9BD\uBCF4\uB4DC \uB0B4\uC6A9\uC744 \uC694\uC18C\uC5D0 \uBD99\uC5EC\uB123\uAE30 (paste \uC774\uBCA4\uD2B8 \uD578\uB4E4\uB7EC\uC5D0\uC11C \uC0AC\uC6A9)\n *\n * @remarks\n * \uB300\uC0C1 \uC694\uC18C \uB0B4\uC758 \uCCAB \uBC88\uC9F8 input/textarea\uB97C \uCC3E\uC544 \uC804\uCCB4 \uAC12\uC744 \uD074\uB9BD\uBCF4\uB4DC \uB0B4\uC6A9\uC73C\uB85C \uAD50\uCCB4\uD55C\uB2E4.\n * \uCEE4\uC11C \uC704\uCE58\uB098 \uC120\uD0DD \uC601\uC5ED\uC744 \uACE0\uB824\uD558\uC9C0 \uC54A\uB294\uB2E4.\n *\n * @param event - paste \uC774\uBCA4\uD2B8 \uAC1D\uCCB4\n */\nexport function pasteToElement(event: ClipboardEvent): void {\n  const clipboardData = event.clipboardData;\n  const target = event.target;\n  if (clipboardData == null || !(target instanceof Element)) return;\n\n  const contentText = clipboardData.getData(\"text/plain\");\n\n  const firstInputEl = target.findFirst<HTMLInputElement | HTMLTextAreaElement>(\"input, textarea\");\n  if (firstInputEl !== undefined) {\n    firstInputEl.value = contentText;\n    firstInputEl.dispatchEvent(new Event(\"input\", { bubbles: true }));\n    event.preventDefault();\n  }\n}\n\n/**\n * IntersectionObserver\uB97C \uC0AC\uC6A9\uD558\uC5EC \uC694\uC18C\uB4E4\uC758 bounds \uC815\uBCF4 \uC870\uD68C\n *\n * @param els - \uB300\uC0C1 \uC694\uC18C \uBC30\uC5F4\n * @param timeout - \uD0C0\uC784\uC544\uC6C3 (\uBC00\uB9AC\uCD08, \uAE30\uBCF8: 5000)\n * @throws {TimeoutError} \uD0C0\uC784\uC544\uC6C3 \uC2DC\uAC04 \uB0B4\uC5D0 \uC751\uB2F5\uC774 \uC5C6\uC744 \uACBD\uC6B0\n */\nexport async function getBounds(els: Element[], timeout: number = 5000): Promise<ElementBounds[]> {\n  // \uC911\uBCF5 \uC81C\uAC70 \uBC0F \uC785\uB825 \uC21C\uC11C\uB300\uB85C \uACB0\uACFC\uB97C \uC815\uB82C\uD558\uAE30 \uC704\uD55C \uC778\uB371\uC2A4 \uB9F5\n  const indexMap = new Map(els.map((el, i) => [el, i] as const));\n  if (indexMap.size === 0) {\n    return [];\n  }\n\n  // \uC815\uB82C \uC131\uB2A5 \uCD5C\uC801\uD654\uB97C \uC704\uD55C \uC778\uB371\uC2A4 \uB9F5\n  const sortIndexMap = new Map(els.map((el, i) => [el, i] as const));\n\n  let observer: IntersectionObserver | undefined;\n\n  try {\n    return await Promise.race([\n      new Promise<ElementBounds[]>((resolve) => {\n        const results: ElementBounds[] = [];\n\n        observer = new IntersectionObserver((entries) => {\n          for (const entry of entries) {\n            const target = entry.target;\n            if (indexMap.has(target)) {\n              indexMap.delete(target);\n              results.push({\n                target,\n                top: entry.boundingClientRect.top,\n                left: entry.boundingClientRect.left,\n                width: entry.boundingClientRect.width,\n                height: entry.boundingClientRect.height,\n              });\n            }\n          }\n\n          if (indexMap.size === 0) {\n            observer?.disconnect();\n            // \uC785\uB825 \uC21C\uC11C\uB300\uB85C \uC815\uB82C\n            resolve(results.sort((a, b) => sortIndexMap.get(a.target)! - sortIndexMap.get(b.target)!));\n          }\n        });\n\n        for (const el of indexMap.keys()) {\n          observer.observe(el);\n        }\n      }),\n      new Promise<ElementBounds[]>((_, reject) =>\n        setTimeout(() => reject(new TimeoutError(undefined, `${timeout}ms \uCD08\uACFC`)), timeout),\n      ),\n    ]);\n  } finally {\n    observer?.disconnect();\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/extensions/html-element-ext.js

@@ -0,0 +1,50 @@
+import { ArgumentError } from "@simplysm/core-common";
+HTMLElement.prototype.repaint = function() {
+  void this.offsetHeight;
+};
+HTMLElement.prototype.getRelativeOffset = function(parent) {
+  const parentEl = typeof parent === "string" ? this.closest(parent) : parent;
+  if (!(parentEl instanceof HTMLElement)) {
+    throw new ArgumentError({ parent });
+  }
+  const elementRect = this.getBoundingClientRect();
+  const parentRect = parentEl.getBoundingClientRect();
+  const scrollLeft = window.scrollX;
+  const scrollTop = window.scrollY;
+  const relativeOffset = {
+    top: elementRect.top - parentRect.top + scrollTop + (parentEl.scrollTop || 0),
+    left: elementRect.left - parentRect.left + scrollLeft + (parentEl.scrollLeft || 0)
+  };
+  let currentEl = this.parentElement;
+  while (currentEl !== null && currentEl !== parentEl) {
+    const style = getComputedStyle(currentEl);
+    relativeOffset.top += parseFloat(style.borderTopWidth) || 0;
+    relativeOffset.left += parseFloat(style.borderLeftWidth) || 0;
+    currentEl = currentEl.parentElement;
+  }
+  const elTransform = getComputedStyle(this).transform;
+  const parentTransform = getComputedStyle(parentEl).transform;
+  if (elTransform !== "none" || parentTransform !== "none") {
+    const elementMatrix = new DOMMatrix(elTransform);
+    const parentMatrix = new DOMMatrix(parentTransform);
+    if (!elementMatrix.isIdentity || !parentMatrix.isIdentity) {
+      const transformedPoint = parentMatrix.inverse().multiply(elementMatrix).transformPoint(new DOMPoint(relativeOffset.left, relativeOffset.top));
+      relativeOffset.left = transformedPoint.x;
+      relativeOffset.top = transformedPoint.y;
+    }
+  }
+  return relativeOffset;
+};
+HTMLElement.prototype.scrollIntoViewIfNeeded = function(target, offset = { top: 0, left: 0 }) {
+  const scroll = {
+    top: this.scrollTop,
+    left: this.scrollLeft
+  };
+  if (target.top - scroll.top < offset.top) {
+    this.scrollTop = target.top - offset.top;
+  }
+  if (target.left - scroll.left < offset.left) {
+    this.scrollLeft = target.left - offset.left;
+  }
+};
+//# sourceMappingURL=html-element-ext.js.map

package/dist/extensions/html-element-ext.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/extensions/html-element-ext.ts"],
+  "sourcesContent": ["import { ArgumentError } from \"@simplysm/core-common\";\n\ndeclare global {\n  interface HTMLElement {\n    /**\n     * \uAC15\uC81C \uB9AC\uD398\uC778\uD2B8 (reflow \uD2B8\uB9AC\uAC70)\n     */\n    repaint(): void;\n\n    /**\n     * \uBD80\uBAA8 \uC694\uC18C \uAE30\uC900 \uC0C1\uB300 \uC704\uCE58 \uACC4\uC0B0 (CSS \uD3EC\uC9C0\uC154\uB2DD\uC6A9)\n     *\n     * @remarks\n     * \uC774 \uD568\uC218\uB294 \uC694\uC18C\uC758 \uC704\uCE58\uB97C \uBD80\uBAA8 \uC694\uC18C \uAE30\uC900\uC73C\uB85C \uACC4\uC0B0\uD558\uB418, `window.scrollX/Y`\uB97C \uD3EC\uD568\uD558\uC5EC\n     * CSS `top`/`left` \uC18D\uC131\uC5D0 \uC9C1\uC811 \uC0AC\uC6A9\uD560 \uC218 \uC788\uB294 \uBB38\uC11C \uAE30\uC900 \uC88C\uD45C\uB97C \uBC18\uD658\uD55C\uB2E4.\n     *\n     * \uC8FC\uC694 \uC0AC\uC6A9 \uC0AC\uB840:\n     * - \uB4DC\uB86D\uB2E4\uC6B4, \uD31D\uC5C5 \uB4F1\uC744 `document.body`\uC5D0 append \uD6C4 \uC704\uCE58 \uC9C0\uC815\n     * - \uC2A4\uD06C\uB864\uB41C \uD398\uC774\uC9C0\uC5D0\uC11C\uB3C4 \uC62C\uBC14\uB974\uAC8C \uB3D9\uC791\n     *\n     * \uACC4\uC0B0\uC5D0 \uD3EC\uD568\uB418\uB294 \uC694\uC18C:\n     * - \uBDF0\uD3EC\uD2B8 \uAE30\uC900 \uC704\uCE58 (getBoundingClientRect)\n     * - \uBB38\uC11C \uC2A4\uD06C\uB864 \uC704\uCE58 (window.scrollX/Y)\n     * - \uBD80\uBAA8 \uC694\uC18C \uB0B4\uBD80 \uC2A4\uD06C\uB864 (parentEl.scrollTop/Left)\n     * - \uC911\uAC04 \uC694\uC18C\uB4E4\uC758 border \uB450\uAED8\n     * - CSS transform \uBCC0\uD658\n     *\n     * @param parent - \uAE30\uC900\uC774 \uB420 \uBD80\uBAA8 \uC694\uC18C \uB610\uB294 \uC140\uB809\uD130 (\uC608: document.body, \".container\")\n     * @returns CSS top/left \uC18D\uC131\uC5D0 \uC0AC\uC6A9\uD560 \uC218 \uC788\uB294 \uC88C\uD45C\n     * @throws {ArgumentError} \uBD80\uBAA8 \uC694\uC18C\uB97C \uCC3E\uC744 \uC218 \uC5C6\uB294 \uACBD\uC6B0\n     */\n    getRelativeOffset(parent: HTMLElement | string): { top: number; left: number };\n\n    /**\n     * \uB300\uC0C1\uC774 offset \uC601\uC5ED(\uACE0\uC815 \uD5E4\uB354/\uACE0\uC815 \uC5F4 \uB4F1)\uC5D0 \uAC00\uB824\uC9C4 \uACBD\uC6B0, \uBCF4\uC774\uB3C4\uB85D \uC2A4\uD06C\uB864\n     *\n     * @remarks\n     * \uC774 \uD568\uC218\uB294 \uB300\uC0C1\uC774 \uC2A4\uD06C\uB864 \uC601\uC5ED\uC758 \uC704\uCABD/\uC67C\uCABD \uACBD\uACC4\uB97C \uBC97\uC5B4\uB09C \uACBD\uC6B0\uB9CC \uCC98\uB9AC\uD55C\uB2E4.\n     * \uC544\uB798\uCABD/\uC624\uB978\uCABD\uC73C\uB85C \uC2A4\uD06C\uB864\uC774 \uD544\uC694\uD55C \uACBD\uC6B0\uB294 \uBE0C\uB77C\uC6B0\uC800\uC758 \uAE30\uBCF8 \uD3EC\uCEE4\uC2A4 \uC2A4\uD06C\uB864 \uB3D9\uC791\uC5D0 \uC758\uC874\uD55C\uB2E4.\n     * \uC8FC\uB85C \uACE0\uC815 \uD5E4\uB354\uB098 \uACE0\uC815 \uC5F4\uC774 \uC788\uB294 \uD14C\uC774\uBE14\uC5D0\uC11C \uD3EC\uCEE4\uC2A4 \uC774\uBCA4\uD2B8\uC640 \uD568\uAED8 \uC0AC\uC6A9\uB41C\uB2E4.\n     *\n     * @param target - \uB300\uC0C1\uC758 \uCEE8\uD14C\uC774\uB108 \uB0B4 \uC704\uCE58 (offsetTop, offsetLeft)\n     * @param offset - \uAC00\uB824\uC9C0\uBA74 \uC548 \uB418\uB294 \uC601\uC5ED \uD06C\uAE30 (\uC608: \uACE0\uC815 \uD5E4\uB354 \uB192\uC774, \uACE0\uC815 \uC5F4 \uB108\uBE44)\n     */\n    scrollIntoViewIfNeeded(target: { top: number; left: number }, offset?: { top: number; left: number }): void;\n  }\n}\n\nHTMLElement.prototype.repaint = function (): void {\n  // offsetHeight \uC811\uADFC \uC2DC \uBE0C\uB77C\uC6B0\uC800\uB294 \uB3D9\uAE30\uC801 \uB808\uC774\uC544\uC6C3 \uACC4\uC0B0(forced synchronous layout)\uC744 \uC218\uD589\uD558\uBA70,\n  // \uC774\uB85C \uC778\uD574 \uD604\uC7AC \uBC30\uCE58\uB41C \uC2A4\uD0C0\uC77C \uBCC0\uACBD\uC0AC\uD56D\uC774 \uC989\uC2DC \uC801\uC6A9\uB418\uC5B4 \uB9AC\uD398\uC778\uD2B8\uAC00 \uD2B8\uB9AC\uAC70\uB41C\uB2E4.\n  void this.offsetHeight;\n};\n\nHTMLElement.prototype.getRelativeOffset = function (parent: HTMLElement | string): { top: number; left: number } {\n  const parentEl = typeof parent === \"string\" ? this.closest(parent) : parent;\n\n  if (!(parentEl instanceof HTMLElement)) {\n    throw new ArgumentError({ parent });\n  }\n\n  const elementRect = this.getBoundingClientRect();\n  const parentRect = parentEl.getBoundingClientRect();\n\n  const scrollLeft = window.scrollX;\n  const scrollTop = window.scrollY;\n\n  const relativeOffset = {\n    top: elementRect.top - parentRect.top + scrollTop + (parentEl.scrollTop || 0),\n    left: elementRect.left - parentRect.left + scrollLeft + (parentEl.scrollLeft || 0),\n  };\n\n  let currentEl = this.parentElement;\n  while (currentEl !== null && currentEl !== parentEl) {\n    const style = getComputedStyle(currentEl);\n    relativeOffset.top += parseFloat(style.borderTopWidth) || 0;\n    relativeOffset.left += parseFloat(style.borderLeftWidth) || 0;\n    currentEl = currentEl.parentElement;\n  }\n\n  const elTransform = getComputedStyle(this).transform;\n  const parentTransform = getComputedStyle(parentEl).transform;\n\n  if (elTransform !== \"none\" || parentTransform !== \"none\") {\n    const elementMatrix = new DOMMatrix(elTransform);\n    const parentMatrix = new DOMMatrix(parentTransform);\n\n    if (!elementMatrix.isIdentity || !parentMatrix.isIdentity) {\n      const transformedPoint = parentMatrix\n        .inverse()\n        .multiply(elementMatrix)\n        .transformPoint(new DOMPoint(relativeOffset.left, relativeOffset.top));\n\n      relativeOffset.left = transformedPoint.x;\n      relativeOffset.top = transformedPoint.y;\n    }\n  }\n\n  return relativeOffset;\n};\n\nHTMLElement.prototype.scrollIntoViewIfNeeded = function (\n  target: { top: number; left: number },\n  offset: { top: number; left: number } = { top: 0, left: 0 },\n): void {\n  const scroll = {\n    top: this.scrollTop,\n    left: this.scrollLeft,\n  };\n\n  if (target.top - scroll.top < offset.top) {\n    this.scrollTop = target.top - offset.top;\n  }\n  if (target.left - scroll.left < offset.left) {\n    this.scrollLeft = target.left - offset.left;\n  }\n};\n"],
+  "mappings": "AAAA,SAAS,qBAAqB;AAgD9B,YAAY,UAAU,UAAU,WAAkB;AAGhD,OAAK,KAAK;AACZ;AAEA,YAAY,UAAU,oBAAoB,SAAU,QAA6D;AAC/G,QAAM,WAAW,OAAO,WAAW,WAAW,KAAK,QAAQ,MAAM,IAAI;AAErE,MAAI,EAAE,oBAAoB,cAAc;AACtC,UAAM,IAAI,cAAc,EAAE,OAAO,CAAC;AAAA,EACpC;AAEA,QAAM,cAAc,KAAK,sBAAsB;AAC/C,QAAM,aAAa,SAAS,sBAAsB;AAElD,QAAM,aAAa,OAAO;AAC1B,QAAM,YAAY,OAAO;AAEzB,QAAM,iBAAiB;AAAA,IACrB,KAAK,YAAY,MAAM,WAAW,MAAM,aAAa,SAAS,aAAa;AAAA,IAC3E,MAAM,YAAY,OAAO,WAAW,OAAO,cAAc,SAAS,cAAc;AAAA,EAClF;AAEA,MAAI,YAAY,KAAK;AACrB,SAAO,cAAc,QAAQ,cAAc,UAAU;AACnD,UAAM,QAAQ,iBAAiB,SAAS;AACxC,mBAAe,OAAO,WAAW,MAAM,cAAc,KAAK;AAC1D,mBAAe,QAAQ,WAAW,MAAM,eAAe,KAAK;AAC5D,gBAAY,UAAU;AAAA,EACxB;AAEA,QAAM,cAAc,iBAAiB,IAAI,EAAE;AAC3C,QAAM,kBAAkB,iBAAiB,QAAQ,EAAE;AAEnD,MAAI,gBAAgB,UAAU,oBAAoB,QAAQ;AACxD,UAAM,gBAAgB,IAAI,UAAU,WAAW;AAC/C,UAAM,eAAe,IAAI,UAAU,eAAe;AAElD,QAAI,CAAC,cAAc,cAAc,CAAC,aAAa,YAAY;AACzD,YAAM,mBAAmB,aACtB,QAAQ,EACR,SAAS,aAAa,EACtB,eAAe,IAAI,SAAS,eAAe,MAAM,eAAe,GAAG,CAAC;AAEvE,qBAAe,OAAO,iBAAiB;AACvC,qBAAe,MAAM,iBAAiB;AAAA,IACxC;AAAA,EACF;AAEA,SAAO;AACT;AAEA,YAAY,UAAU,yBAAyB,SAC7C,QACA,SAAwC,EAAE,KAAK,GAAG,MAAM,EAAE,GACpD;AACN,QAAM,SAAS;AAAA,IACb,KAAK,KAAK;AAAA,IACV,MAAM,KAAK;AAAA,EACb;AAEA,MAAI,OAAO,MAAM,OAAO,MAAM,OAAO,KAAK;AACxC,SAAK,YAAY,OAAO,MAAM,OAAO;AAAA,EACvC;AACA,MAAI,OAAO,OAAO,OAAO,OAAO,OAAO,MAAM;AAC3C,SAAK,aAAa,OAAO,OAAO,OAAO;AAAA,EACzC;AACF;",
+  "names": []
+}