@simplysm/core-browser 13.0.100 → 14.0.4

package/dist/extensions/element-ext.js

@@ -1,126 +1,147 @@
 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.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.findFirst = function (selector) {
+    const trimmed = selector.trim();
+    if (trimmed === "")
+        return undefined;
+    return this.querySelector(trimmed) ?? undefined;
 };
-Element.prototype.prependChild = function(child) {
-  return this.insertBefore(child, this.firstElementChild);
+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.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;
+Element.prototype.findFocusableParent = function () {
+    let parentEl = this.parentElement;
+    while (parentEl !== null) {
+        if (isFocusable(parentEl)) {
+            return parentEl;
+        }
+        parentEl = parentEl.parentElement;
     }
-    parentEl = parentEl.parentElement;
-  }
-  return void 0;
+    return undefined;
 };
-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;
+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();
     }
-    node = walker.nextNode();
-  }
-  return void 0;
+    return undefined;
 };
-Element.prototype.isOffsetElement = function() {
-  return ["relative", "absolute", "fixed", "sticky"].includes(getComputedStyle(this).position);
+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";
+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.findFirst(
-    "input, textarea"
-  );
-  if (firstInputEl !== void 0) {
-    clipboardData.setData("text/plain", firstInputEl.value);
-    event.preventDefault();
-  }
+// ============================================================================
+// 정적 함수 (이벤트 핸들러 또는 다중 요소용)
+// ============================================================================
+/**
+ * 요소 내용을 클립보드에 복사 (copy 이벤트 핸들러와 함께 사용)
+ *
+ * @param event - copy 이벤트 객체
+ */
+export function copyElement(event) {
+    const clipboardData = event.clipboardData;
+    const target = event.target;
+    if (clipboardData == null || !(target instanceof Element))
+        return;
+    const firstInputEl = target.findFirst("input, textarea");
+    if (firstInputEl !== undefined) {
+        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();
-  }
+/**
+ * 클립보드 내용을 요소에 붙여넣기 (paste 이벤트 핸들러와 함께 사용)
+ *
+ * @remarks
+ * 대상 요소 내의 첫 번째 input/textarea를 찾아 전체 값을 클립보드 내용으로 교체합니다.
+ * 커서 위치나 선택 영역은 고려하지 않습니다.
+ *
+ * @param event - paste 이벤트 객체
+ */
+export 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 !== undefined) {
+        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 remaining = new Set(indexMap.keys());
-  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 (remaining.has(target)) {
-              remaining.delete(target);
-              results.push({
-                target,
-                top: entry.boundingClientRect.top,
-                left: entry.boundingClientRect.left,
-                width: entry.boundingClientRect.width,
-                height: entry.boundingClientRect.height
-              });
-            }
-          }
-          if (remaining.size === 0) {
-            observer == null ? void 0 : observer.disconnect();
-            resolve(
-              results.sort((a, b) => indexMap.get(a.target) - indexMap.get(b.target))
-            );
-          }
-        });
-        for (const el of indexMap.keys()) {
-          observer.observe(el);
-        }
-      }),
-      new Promise(
-        (_, reject) => setTimeout(() => reject(new TimeoutError(void 0, `${timeout}ms timeout`)), timeout)
-      )
-    ]);
-  } finally {
-    observer == null ? void 0 : observer.disconnect();
-  }
+/**
+ * IntersectionObserver를 사용하여 요소의 경계 정보 조회
+ *
+ * @param els - 대상 요소 배열
+ * @param timeout - 타임아웃 밀리초 (기본값: 5000)
+ * @throws {TimeoutError} 타임아웃 시간 내에 응답이 없는 경우
+ */
+export async function getBounds(els, timeout = 5000) {
+    // 중복 제거 및 입력 순서대로 결과 정렬을 위한 인덱스 맵
+    const indexMap = new Map(els.map((el, i) => [el, i]));
+    if (indexMap.size === 0) {
+        return [];
+    }
+    // 남은 요소를 추적하기 위한 Set
+    const remaining = new Set(indexMap.keys());
+    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 (remaining.has(target)) {
+                            remaining.delete(target);
+                            results.push({
+                                target,
+                                top: entry.boundingClientRect.top,
+                                left: entry.boundingClientRect.left,
+                                width: entry.boundingClientRect.width,
+                                height: entry.boundingClientRect.height,
+                            });
+                        }
+                    }
+                    if (remaining.size === 0) {
+                        observer?.disconnect();
+                        // 입력 순서대로 정렬
+                        resolve(results.sort((a, b) => indexMap.get(a.target) - indexMap.get(b.target)));
+                    }
+                });
+                for (const el of indexMap.keys()) {
+                    observer.observe(el);
+                }
+            }),
+            new Promise((_, reject) => setTimeout(() => reject(new TimeoutError(undefined, `${timeout}ms timeout`)), timeout)),
+        ]);
+    }
+    finally {
+        observer?.disconnect();
+    }
 }
-export {
-  copyElement,
-  getBounds,
-  pasteToElement
-};
-//# sourceMappingURL=element-ext.js.map
+//# sourceMappingURL=element-ext.js.map

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

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

package/dist/extensions/html-element-ext.d.ts

@@ -1,45 +1,45 @@
 declare global {
     interface HTMLElement {
         /**
-         * Force repaint (triggers reflow)
+         * 강제 리페인트 (reflow 트리거)
          */
         repaint(): void;
         /**
-         * Calculate relative position based on parent element (for CSS positioning)
+         * 부모 요소 기준 상대 위치 계산 (CSS 포지셔닝용)
          *
          * @remarks
-         * Calculates element position relative to parent element, returning document-based coordinates
-         * including `window.scrollX/Y` that can be directly used in CSS `top`/`left` properties.
+         * 부모 요소 기준으로 요소 위치를 계산하며, CSS `top`/`left` 속성에 바로 사용할 수 있는
+         * `window.scrollX/Y`를 포함한 문서 기반 좌표를 반환합니다.
          *
-         * Common use cases:
-         * - Position dropdowns, popups after appending to `document.body`
-         * - Works correctly on scrolled pages
+         * 주요 사용 사례:
+         * - `document.body`에 append한 후 드롭다운, 팝업 위치 지정
+         * - 스크롤된 페이지에서도 정상 동작
          *
-         * Factors included in calculation:
-         * - Viewport-relative position (getBoundingClientRect)
-         * - Document scroll position (window.scrollX/Y)
-         * - Parent element internal scroll (parentEl.scrollTop/Left)
-         * - Border thickness of intermediate elements
-         * - CSS transform transformations
+         * 계산에 포함되는 요소:
+         * - 뷰포트 기준 위치 (getBoundingClientRect)
+         * - 문서 스크롤 위치 (window.scrollX/Y)
+         * - 부모 요소 내부 스크롤 (parentEl.scrollTop/Left)
+         * - 중간 요소의 border 두께
+         * - CSS transform 변환
          *
-         * @param parent - Parent element or selector to use as reference (e.g., document.body, ".container")
-         * @returns Coordinates usable in CSS top/left properties
-         * @throws {ArgumentError} If parent element cannot be found
+         * @param parent - 기준이 되는 부모 요소 또는 선택자 (예: document.body, ".container")
+         * @returns CSS top/left 속성에 사용 가능한 좌표
+         * @throws {ArgumentError} 부모 요소를 찾을 수 없는 경우
          */
         getRelativeOffset(parent: HTMLElement | string): {
             top: number;
             left: number;
         };
         /**
-         * Scroll to make target visible if hidden by offset area (e.g., fixed header/column)
+         * offset 영역(예: 고정 헤더/컬럼)에 가려진 경우 대상이 보이도록 스크롤
          *
          * @remarks
-         * Only handles cases where target extends beyond top/left boundaries of scroll area.
-         * For scrolling needed downward/rightward, relies on browser's default focus scroll behavior.
-         * Typically used with focus events on tables with fixed headers or columns.
+         * 대상이 스크롤 영역의 상단/좌측 경계를 벗어나는 경우만 처리합니다.
+         * 하단/우측 방향 스크롤이 필요한 경우는 브라우저의 기본 포커스 스크롤 동작에 의존합니다.
+         * 주로 고정 헤더나 컬럼이 있는 테이블의 포커스 이벤트에서 사용됩니다.
          *
-         * @param target - Target position within container (offsetTop, offsetLeft)
-         * @param offset - Size of area that must not be obscured (e.g., fixed header height, fixed column width)
+         * @param target - 컨테이너 내 대상 위치 (offsetTop, offsetLeft)
+         * @param offset - 가려지면 안 되는 영역의 크기 (예: 고정 헤더 높이, 고정 컬럼 너비)
          */
         scrollIntoViewIfNeeded(target: {
             top: number;

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

@@ -1,50 +1,55 @@
 import { ArgumentError } from "@simplysm/core-common";
-HTMLElement.prototype.repaint = function() {
-  void this.offsetHeight;
+HTMLElement.prototype.repaint = function () {
+    // offsetHeight에 접근하면 브라우저에서 강제 동기 레이아웃이 트리거되어,
+    // 현재 레이아웃의 스타일 변경이 즉시 적용되고 리페인트가 발생합니다.
+    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;
+HTMLElement.prototype.getRelativeOffset = function (parent) {
+    const parentEl = typeof parent === "string" ? this.closest(parent) : parent;
+    if (!(parentEl instanceof HTMLElement)) {
+        throw new ArgumentError({ parent });
     }
-  }
-  return relativeOffset;
+    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;
-  }
+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
+//# sourceMappingURL=html-element-ext.js.map

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

@@ -1,6 +1 @@
-{
-  "version": 3,
-  "sources": ["../../src/extensions/html-element-ext.ts"],
-  "mappings": "AAAA,SAAS,qBAAqB;AAmD9B,YAAY,UAAU,UAAU,WAAkB;AAGhD,OAAK,KAAK;AACZ;AAEA,YAAY,UAAU,oBAAoB,SAAU,QAGlD;AACA,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": []
-}
+{"version":3,"file":"html-element-ext.js","sourceRoot":"","sources":["..\\..\\src\\extensions\\html-element-ext.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,5 +1,8 @@
+// core-browser: 브라우저 전용 유틸리티
+// 확장 (사이드 이펙트)
 import "./extensions/element-ext.js";
 import "./extensions/html-element-ext.js";
+// 재내보내기
 export * from "./extensions/element-ext.js";
 export * from "./extensions/html-element-ext.js";
 export * from "./utils/download.js";
@@ -7,4 +10,4 @@ export * from "./utils/fetch.js";
 export * from "./utils/file-dialog.js";
 export * from "./utils/IndexedDbStore.js";
 export * from "./utils/IndexedDbVirtualFs.js";
-//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1,6 +1 @@
-{
-  "version": 3,
-  "sources": ["../src/index.ts"],
-  "mappings": "AAGA,OAAO;AACP,OAAO;AAGP,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;",
-  "names": []
-}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["..\\src\\index.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAE7B,eAAe;AACf,OAAO,0BAA0B,CAAC;AAClC,OAAO,+BAA+B,CAAC;AAEvC,QAAQ;AACR,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC"}