@simplysm/core-browser 13.0.0-beta.2 → 13.0.0-beta.21

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

@@ -1,36 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,80 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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/src/extensions/element-ext.ts

@@ -1,246 +0,0 @@
-import { isFocusable } from "tabbable";
-import { TimeoutError } from "@simplysm/core-common";
-
-/**
- * 요소 bounds 정보 타입
- */
-export interface ElementBounds {
-  /** 측정 대상 요소 */
-  target: Element;
-  /** 뷰포트 기준 상단 위치 */
-  top: number;
-  /** 뷰포트 기준 왼쪽 위치 */
-  left: number;
-  /** 요소 너비 */
-  width: number;
-  /** 요소 높이 */
-  height: number;
-}
-
-declare global {
-  interface Element {
-    /**
-     * 셀렉터로 하위 요소 전체 검색
-     *
-     * @param selector - CSS 셀렉터
-     * @returns 매칭된 요소 배열 (빈 셀렉터는 빈 배열 반환)
-     */
-    findAll<T extends Element = Element>(selector: string): T[];
-
-    /**
-     * 셀렉터로 첫 번째 매칭 요소 검색
-     *
-     * @param selector - CSS 셀렉터
-     * @returns 첫 번째 매칭 요소 또는 undefined (빈 셀렉터는 undefined 반환)
-     */
-    findFirst<T extends Element = Element>(selector: string): T | undefined;
-
-    /**
-     * 요소를 첫 번째 자식으로 삽입
-     *
-     * @param child - 삽입할 자식 요소
-     * @returns 삽입된 자식 요소
-     */
-    prependChild<T extends Element>(child: T): T;
-
-    /**
-     * 모든 부모 요소 목록 반환 (가까운 순서)
-     *
-     * @returns 부모 요소 배열 (가까운 부모부터 순서대로)
-     */
-    getParents(): Element[];
-
-    /**
-     * 부모 중 첫 번째 포커스 가능 요소 검색 (tabbable 사용)
-     *
-     * @returns 포커스 가능한 첫 번째 부모 요소 또는 undefined
-     */
-    findFocusableParent(): HTMLElement | undefined;
-
-    /**
-     * 자식 중 첫 번째 포커스 가능 요소 검색 (tabbable 사용)
-     *
-     * @returns 포커스 가능한 첫 번째 자식 요소 또는 undefined
-     */
-    findFirstFocusableChild(): HTMLElement | undefined;
-
-    /**
-     * 요소가 offset 기준 요소인지 확인 (position: relative/absolute/fixed/sticky)
-     *
-     * @returns position 속성이 relative, absolute, fixed, sticky 중 하나면 true
-     */
-    isOffsetElement(): boolean;
-
-    /**
-     * 요소가 화면에 보이는지 확인
-     *
-     * @remarks
-     * clientRects 존재 여부, visibility: hidden, opacity: 0 여부를 확인한다.
-     *
-     * @returns 요소가 화면에 보이면 true
-     */
-    isVisible(): boolean;
-  }
-}
-
-Element.prototype.findAll = function <T extends Element = Element>(selector: string): T[] {
-  const trimmed = selector.trim();
-  if (trimmed === "") return [];
-  return Array.from(this.querySelectorAll<T>(trimmed));
-};
-
-Element.prototype.findFirst = function <T extends Element = Element>(selector: string): T | undefined {
-  const trimmed = selector.trim();
-  if (trimmed === "") return undefined;
-  return this.querySelector<T>(trimmed) ?? undefined;
-};
-
-Element.prototype.prependChild = function <T extends Element>(child: T): T {
-  return this.insertBefore(child, this.firstElementChild);
-};
-
-Element.prototype.getParents = function (): Element[] {
-  const result: Element[] = [];
-  let cursor = this.parentNode;
-  while (cursor !== null && cursor instanceof Element) {
-    result.push(cursor);
-    cursor = cursor.parentNode;
-  }
-  return result;
-};
-
-Element.prototype.findFocusableParent = function (): HTMLElement | undefined {
-  let parentEl = this.parentElement;
-  while (parentEl !== null) {
-    if (isFocusable(parentEl)) {
-      return parentEl;
-    }
-    parentEl = parentEl.parentElement;
-  }
-  return undefined;
-};
-
-Element.prototype.findFirstFocusableChild = function (): HTMLElement | undefined {
-  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 undefined;
-};
-
-Element.prototype.isOffsetElement = function (): boolean {
-  return ["relative", "absolute", "fixed", "sticky"].includes(getComputedStyle(this).position);
-};
-
-Element.prototype.isVisible = function (): boolean {
-  const style = getComputedStyle(this);
-  return this.getClientRects().length > 0 && style.visibility !== "hidden" && style.opacity !== "0";
-};
-
-// ============================================================================
-// 정적 함수 (이벤트 핸들러용 또는 여러 요소 대상)
-// ============================================================================
-
-/**
- * 요소 내용을 클립보드에 복사 (copy 이벤트 핸들러에서 사용)
- *
- * @param event - copy 이벤트 객체
- */
-export function copyElement(event: ClipboardEvent): void {
-  const clipboardData = event.clipboardData;
-  const target = event.target;
-  if (clipboardData == null || !(target instanceof Element)) return;
-
-  const firstInputEl = target.querySelector<HTMLInputElement | HTMLTextAreaElement>("input, textarea");
-  if (firstInputEl != null) {
-    clipboardData.setData("text/plain", firstInputEl.value);
-    event.preventDefault();
-  }
-}
-
-/**
- * 클립보드 내용을 요소에 붙여넣기 (paste 이벤트 핸들러에서 사용)
- *
- * @remarks
- * 대상 요소 내의 첫 번째 input/textarea를 찾아 전체 값을 클립보드 내용으로 교체한다.
- * 커서 위치나 선택 영역을 고려하지 않는다.
- *
- * @param event - paste 이벤트 객체
- */
-export function pasteToElement(event: ClipboardEvent): void {
-  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<HTMLInputElement | HTMLTextAreaElement>("input, textarea");
-  if (firstInputEl !== undefined) {
-    firstInputEl.value = contentText;
-    firstInputEl.dispatchEvent(new Event("input", { bubbles: true }));
-    event.preventDefault();
-  }
-}
-
-/**
- * IntersectionObserver를 사용하여 요소들의 bounds 정보 조회
- *
- * @param els - 대상 요소 배열
- * @param timeout - 타임아웃 (밀리초, 기본: 5000)
- * @throws {TimeoutError} 타임아웃 시간 내에 응답이 없을 경우
- */
-export async function getBounds(els: Element[], timeout: number = 5000): Promise<ElementBounds[]> {
-  // 중복 제거 및 입력 순서대로 결과를 정렬하기 위한 인덱스 맵
-  const indexMap = new Map(els.map((el, i) => [el, i] as const));
-  if (indexMap.size === 0) {
-    return [];
-  }
-
-  // 정렬 성능 최적화를 위한 인덱스 맵
-  const sortIndexMap = new Map(els.map((el, i) => [el, i] as const));
-
-  let observer: IntersectionObserver | undefined;
-
-  try {
-    return await Promise.race([
-      new Promise<ElementBounds[]>((resolve) => {
-        const results: ElementBounds[] = [];
-
-        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?.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<ElementBounds[]>((_, reject) =>
-        setTimeout(() => reject(new TimeoutError(undefined, `${timeout}ms 초과`)), timeout),
-      ),
-    ]);
-  } finally {
-    observer?.disconnect();
-  }
-}

package/src/extensions/html-element-ext.ts

@@ -1,117 +0,0 @@
-import { ArgumentError } from "@simplysm/core-common";
-
-declare global {
-  interface HTMLElement {
-    /**
-     * 강제 리페인트 (reflow 트리거)
-     */
-    repaint(): void;
-
-    /**
-     * 부모 요소 기준 상대 위치 계산 (CSS 포지셔닝용)
-     *
-     * @remarks
-     * 이 함수는 요소의 위치를 부모 요소 기준으로 계산하되, `window.scrollX/Y`를 포함하여
-     * CSS `top`/`left` 속성에 직접 사용할 수 있는 문서 기준 좌표를 반환한다.
-     *
-     * 주요 사용 사례:
-     * - 드롭다운, 팝업 등을 `document.body`에 append 후 위치 지정
-     * - 스크롤된 페이지에서도 올바르게 동작
-     *
-     * 계산에 포함되는 요소:
-     * - 뷰포트 기준 위치 (getBoundingClientRect)
-     * - 문서 스크롤 위치 (window.scrollX/Y)
-     * - 부모 요소 내부 스크롤 (parentEl.scrollTop/Left)
-     * - 중간 요소들의 border 두께
-     * - CSS transform 변환
-     *
-     * @param parent - 기준이 될 부모 요소 또는 셀렉터 (예: document.body, ".container")
-     * @returns CSS top/left 속성에 사용할 수 있는 좌표
-     * @throws {ArgumentError} 부모 요소를 찾을 수 없는 경우
-     */
-    getRelativeOffset(parent: HTMLElement | string): { top: number; left: number };
-
-    /**
-     * 대상이 offset 영역(고정 헤더/고정 열 등)에 가려진 경우, 보이도록 스크롤
-     *
-     * @remarks
-     * 이 함수는 대상이 스크롤 영역의 위쪽/왼쪽 경계를 벗어난 경우만 처리한다.
-     * 아래쪽/오른쪽으로 스크롤이 필요한 경우는 브라우저의 기본 포커스 스크롤 동작에 의존한다.
-     * 주로 고정 헤더나 고정 열이 있는 테이블에서 포커스 이벤트와 함께 사용된다.
-     *
-     * @param target - 대상의 컨테이너 내 위치 (offsetTop, offsetLeft)
-     * @param offset - 가려지면 안 되는 영역 크기 (예: 고정 헤더 높이, 고정 열 너비)
-     */
-    scrollIntoViewIfNeeded(target: { top: number; left: number }, offset?: { top: number; left: number }): void;
-  }
-}
-
-HTMLElement.prototype.repaint = function (): void {
-  // offsetHeight 접근 시 브라우저는 동기적 레이아웃 계산(forced synchronous layout)을 수행하며,
-  // 이로 인해 현재 배치된 스타일 변경사항이 즉시 적용되어 리페인트가 트리거된다.
-  void this.offsetHeight;
-};
-
-HTMLElement.prototype.getRelativeOffset = function (parent: HTMLElement | string): { top: number; left: number } {
-  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: { top: number; left: number },
-  offset: { top: number; left: number } = { top: 0, left: 0 },
-): void {
-  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;
-  }
-};

package/src/index.ts

@@ -1,11 +0,0 @@
-// core-browser: 브라우저 전용 유틸리티
-
-// extensions (side-effect)
-import "./extensions/element-ext";
-import "./extensions/html-element-ext";
-
-// re-exports
-export * from "./extensions/element-ext";
-export * from "./extensions/html-element-ext";
-export * from "./utils/blob";
-export * from "./utils/download";

package/src/utils/blob.ts

@@ -1,19 +0,0 @@
-export namespace BlobUtils {
-  /**
-   * Blob을 파일로 다운로드
-   *
-   * @param blob - 다운로드할 Blob 객체
-   * @param fileName - 저장될 파일 이름
-   */
-  export function download(blob: Blob, fileName: string): void {
-    const url = URL.createObjectURL(blob);
-    try {
-      const link = document.createElement("a");
-      link.href = url;
-      link.download = fileName;
-      link.click();
-    } finally {
-      setTimeout(() => URL.revokeObjectURL(url), 1000);
-    }
-  }
-}

package/src/utils/download.ts

@@ -1,66 +0,0 @@
-export interface DownloadProgress {
-  receivedLength: number;
-  contentLength: number;
-}
-
-/**
- * URL에서 바이너리 데이터 다운로드 (진행률 콜백 지원)
- */
-export async function downloadBytes(
-  url: string,
-  options?: { onProgress?: (progress: DownloadProgress) => void },
-): Promise<Uint8Array> {
-  const response = await fetch(url);
-  if (!response.ok) {
-    throw new Error(`Download failed: ${response.status} ${response.statusText}`);
-  }
-
-  const contentLength = Number(response.headers.get("Content-Length") ?? 0);
-  const reader = response.body?.getReader();
-  if (!reader) {
-    throw new Error("Response body is not readable");
-  }
-
-  try {
-    // Content-Length를 알 수 있으면 미리 할당하여 메모리 효율성 향상
-    if (contentLength > 0) {
-      const result = new Uint8Array(contentLength);
-      let receivedLength = 0;
-
-      while (true) {
-        const { done, value } = await reader.read();
-        if (done) break;
-
-        result.set(value, receivedLength);
-        receivedLength += value.length;
-        options?.onProgress?.({ receivedLength, contentLength });
-      }
-
-      return result;
-    }
-
-    // Content-Length를 모르면 청크 수집 후 병합 (chunked encoding)
-    const chunks: Uint8Array[] = [];
-    let receivedLength = 0;
-
-    while (true) {
-      const { done, value } = await reader.read();
-      if (done) break;
-
-      chunks.push(value);
-      receivedLength += value.length;
-    }
-
-    // 청크 병합
-    const result = new Uint8Array(receivedLength);
-    let position = 0;
-    for (const chunk of chunks) {
-      result.set(chunk, position);
-      position += chunk.length;
-    }
-
-    return result;
-  } finally {
-    reader.releaseLock();
-  }
-}