@simplysm/core-browser 13.0.69 → 13.0.71

package/README.md

@@ -1,239 +1,29 @@
 # @simplysm/core-browser
 
-A browser-specific utility package for the Simplysm framework. It provides frequently needed features in browser environments such as DOM element traversal, clipboard handling, Blob downloads, and binary downloads.
-
-This package includes both APIs that can be called directly as instance methods by extending `Element` and `HTMLElement` prototypes, and utilities in the form of static functions.
+Simplysm package - Core module (browser)
 
 ## Installation
 
-```bash
-npm install @simplysm/core-browser
-# or
 pnpm add @simplysm/core-browser
-```
-
-## Main Modules
-
-### Element Extension Methods
-
-Instance methods automatically added to `Element.prototype` when importing `"@simplysm/core-browser"`. Works as a side-effect import.
-
-| Method | Return Type | Description |
-|--------|-----------|------|
-| `findAll<T>(selector: string)` | `T[]` | Search all descendant elements by selector. Returns empty array for empty selector. |
-| `findFirst<T>(selector: string)` | `T \| undefined` | Search first matching element by selector. Returns `undefined` for empty selector. |
-| `prependChild<T>(child: T)` | `T` | Insert element as first child |
-| `getParents()` | `Element[]` | Return list of all parent elements (closest first) |
-| `findFocusableParent()` | `HTMLElement \| undefined` | Search for first focusable element among parents (uses tabbable) |
-| `findFirstFocusableChild()` | `HTMLElement \| undefined` | Search for first focusable element among children (uses tabbable) |
-| `isOffsetElement()` | `boolean` | Check if element has `position: relative`, `absolute`, `fixed`, or `sticky` |
-| `isVisible()` | `boolean` | Check element visibility (clientRects exist, not `visibility: hidden`, not `opacity: 0`) |
-
-### HTMLElement Extension Methods
-
-Instance methods automatically added to `HTMLElement.prototype`.
-
-| Method | Return Type | Description |
-|--------|-----------|------|
-| `repaint()` | `void` | Trigger forced repaint by causing forced synchronous layout |
-| `getRelativeOffset(parent: HTMLElement \| string)` | `{ top: number; left: number }` | Calculate document-based position relative to a parent element or CSS selector, suitable for CSS `top`/`left` (includes `window.scrollX/Y`, parent scroll, border widths, and CSS transforms) |
-| `scrollIntoViewIfNeeded(target: { top: number; left: number }, offset?: { top: number; left: number })` | `void` | Adjust scroll so that target position is visible past any fixed offset regions (top/left only) |
-
-### Static Functions
-
-| Function | Return Type | Description |
-|------|-----------|------|
-| `copyElement(event: ClipboardEvent)` | `void` | Copy value of first `input`/`textarea` within the event target element to clipboard |
-| `pasteToElement(event: ClipboardEvent)` | `void` | Paste clipboard text into the first `input`/`textarea` within the event target element |
-| `getBounds(els: Element[], timeout?: number)` | `Promise<ElementBounds[]>` | Query element bounds using `IntersectionObserver`. Results are returned in input order. Default timeout: 5000ms. |
-
-### Download Utilities
-
-| Function | Return Type | Description |
-|------|-----------|------|
-| `downloadBlob(blob: Blob, fileName: string)` | `void` | Download a Blob as a file |
-| `fetchUrlBytes(url: string, options?: { onProgress?: (progress: DownloadProgress) => void })` | `Promise<Uint8Array>` | Download binary data from a URL with optional progress callback |
-
-### File Dialog
-
-| Function | Return Type | Description |
-|------|-----------|------|
-| `openFileDialog(options?: { accept?: string; multiple?: boolean })` | `Promise<File[] \| undefined>` | Open a file selection dialog. Returns `undefined` if the user cancels without selecting. |
-
-### Types
-
-| Type | Description |
-|------|------|
-| `ElementBounds` | Element bounds information: `target: Element`, `top: number`, `left: number`, `width: number`, `height: number` |
-| `DownloadProgress` | Download progress: `receivedLength: number`, `contentLength: number` |
-
-## Usage Examples
-
-### Element Extension Methods
-
-```typescript
-import "@simplysm/core-browser";
-
-// Search descendant elements
-const buttons = container.findAll<HTMLButtonElement>("button.primary");
-const firstInput = container.findFirst<HTMLInputElement>("input[type='text']");
-
-// Insert element as first child
-const newEl = document.createElement("div");
-container.prependChild(newEl);
-
-// Query all parent elements (closest parent first)
-const parents = element.getParents();
-
-// Search focusable elements (based on tabbable library)
-const focusableParent = element.findFocusableParent();
-const focusableChild = element.findFirstFocusableChild();
-
-// Check element state
-if (element.isOffsetElement()) {
-  // position is one of relative, absolute, fixed, sticky
-}
-
-if (element.isVisible()) {
-  // Element is visible on screen (clientRects exist, visibility !== "hidden", opacity !== "0")
-}
-```
-
-### HTMLElement Extension Methods
-
-```typescript
-import "@simplysm/core-browser";
-
-// Forced repaint (useful for restarting CSS animations)
-element.repaint();
-
-// Calculate document-based position relative to a parent element (can be used directly for CSS top/left)
-const offset = element.getRelativeOffset(document.body);
-popup.style.top = `${offset.top}px`;
-popup.style.left = `${offset.left}px`;
-
-// Parent can also be specified by CSS selector (uses closest())
-const offset2 = element.getRelativeOffset(".scroll-container");
-
-// Adjust scroll position in table with fixed header/columns
-const scrollContainer = document.getElementById("table-body") as HTMLElement;
-const targetRow = document.getElementById("row-42") as HTMLElement;
-
-scrollContainer.scrollIntoViewIfNeeded(
-  { top: targetRow.offsetTop, left: targetRow.offsetLeft },
-  { top: 50, left: 120 }, // Fixed header height 50px, fixed column width 120px
-);
-```
-
-### Clipboard Handling
-
-```typescript
-import { copyElement, pasteToElement } from "@simplysm/core-browser";
-
-// Use in copy event handler
-// Copies value of the first input/textarea within the target element to clipboard
-element.addEventListener("copy", (e) => copyElement(e));
-
-// Use in paste event handler
-// Pastes clipboard content into the first input/textarea within the target element
-element.addEventListener("paste", (e) => pasteToElement(e));
-```
-
-### Asynchronous Element Bounds Query
-
-```typescript
-import { getBounds } from "@simplysm/core-browser";
-import type { ElementBounds } from "@simplysm/core-browser";
-
-const el1 = document.getElementById("item1")!;
-const el2 = document.getElementById("item2")!;
-
-// Query bounds information asynchronously using IntersectionObserver
-const bounds: ElementBounds[] = await getBounds([el1, el2]);
-
-for (const b of bounds) {
-  console.log(b.target);  // Target element being measured
-  console.log(b.top);     // Top position relative to viewport
-  console.log(b.left);    // Left position relative to viewport
-  console.log(b.width);   // Element width
-  console.log(b.height);  // Element height
-}
-
-// Specify custom timeout (default: 5000ms)
-// TimeoutError is thrown if timeout is exceeded
-const bounds2 = await getBounds([el1], 3000);
-```
-
-### Blob Download
-
-```typescript
-import { downloadBlob } from "@simplysm/core-browser";
-
-// Download Blob object as file
-const blob = new Blob(["Hello, World!"], { type: "text/plain" });
-downloadBlob(blob, "hello.txt");
-
-// Download binary data such as Excel files
-const excelBlob = new Blob([excelData], {
-  type: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
-});
-downloadBlob(excelBlob, "report.xlsx");
-```
-
-### Binary Download (with Progress Support)
-
-```typescript
-import { fetchUrlBytes } from "@simplysm/core-browser";
-import type { DownloadProgress } from "@simplysm/core-browser";
-
-// Basic usage
-const data: Uint8Array = await fetchUrlBytes("https://example.com/file.bin");
-
-// Using progress callback
-const data2 = await fetchUrlBytes("https://example.com/large-file.zip", {
-  onProgress: (progress: DownloadProgress) => {
-    const percent = progress.contentLength > 0
-      ? Math.round((progress.receivedLength / progress.contentLength) * 100)
-      : 0;
-    console.log(`Download progress: ${percent}%`);
-  },
-});
-```
 
-### File Selection Dialog
+**Peer Dependencies:** none
 
-```typescript
-import { openFileDialog } from "@simplysm/core-browser";
+## Source Index
 
-// Open file selection dialog (single file)
-const files = await openFileDialog({
-  accept: "image/*", // Optional: specify accepted file types
-});
-if (files) {
-  console.log("Selected file:", files[0].name);
-}
+### Extensions
 
-// Open file selection dialog (multiple files)
-const selectedFiles = await openFileDialog({
-  accept: ".pdf,.doc,.docx",
-  multiple: true,
-});
-if (selectedFiles) {
-  selectedFiles.forEach((file) => {
-    console.log("File:", file.name, "Size:", file.size);
-  });
-}
-```
+| Source | Exports | Description | Test |
+|--------|---------|-------------|------|
+| `src/extensions/element-ext.ts` | `ElementBounds`, `copyElement`, `pasteToElement`, `getBounds` | DOM clipboard operations and element bounds utilities | `element-ext.spec.ts` |
+| `src/extensions/html-element-ext.ts` | _(HTMLElement prototype augmentation only)_ | Repaint, relative offset, and scroll-into-view helpers | `html-element-ext.spec.ts` |
 
-## Caveats
+### Utils
 
-- This package is **browser-only**. It cannot be used in Node.js environments.
-- `Element` and `HTMLElement` prototype extensions work as **side-effect imports**. Extensions are automatically applied when importing `"@simplysm/core-browser"` or any item from the package.
-- The `getBounds()` function uses `IntersectionObserver` and works asynchronously. If all elements are not observed within the specified timeout (default 5000ms), a `TimeoutError` is thrown. Duplicate elements in the input array are deduplicated; results are returned in input order.
-- The `getRelativeOffset()` method accepts either an `HTMLElement` or a CSS selector string as the `parent` parameter. When a string is given, it uses `closest()` to find the nearest matching ancestor. It throws `ArgumentError` if the parent element cannot be found. The returned coordinates are document-based (include `window.scrollX/Y`) and are suitable for use as CSS `top`/`left` values. Intermediate element border widths, parent scroll position, and CSS `transform` are all included in the calculation.
-- The `scrollIntoViewIfNeeded()` method only handles cases where the target is beyond the top/left boundaries. The bottom/right directions rely on the browser's default focus scrolling.
-- The `fetchUrlBytes()` function improves memory efficiency by pre-allocating a buffer when the `Content-Length` header is available, and collects and merges chunks for chunked encoding. Throws an `Error` if the response status is not ok or if the response body is not readable.
-- The `pasteToElement()` function replaces the entire value of the target input/textarea. It does not consider cursor position or selection range. It dispatches an `input` event after the value is set.
+| Source | Exports | Description | Test |
+|--------|---------|-------------|------|
+| `src/utils/download.ts` | `downloadBlob` | Trigger browser file download from a Blob | `download.spec.ts` |
+| `src/utils/fetch.ts` | `DownloadProgress`, `fetchUrlBytes` | Fetch URL as Uint8Array with progress callback | - |
+| `src/utils/file-dialog.ts` | `openFileDialog` | Open native file selection dialog programmatically | - |
 
 ## License
 

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

@@ -1,98 +1,98 @@
 /**
- * 요소 bounds 정보 타입
+ * Element bounds information type
  */
 export interface ElementBounds {
-    /** 측정 대상 요소 */
+    /** Element to be measured */
     target: Element;
-    /** 뷰포트 기준 상단 위치 */
+    /** Top position relative to viewport */
     top: number;
-    /** 뷰포트 기준 왼쪽 위치 */
+    /** Left position relative to viewport */
     left: number;
-    /** 요소 너비 */
+    /** Element width */
     width: number;
-    /** 요소 높이 */
+    /** Element height */
     height: number;
 }
 declare global {
     interface Element {
         /**
-         * 셀렉터로 하위 요소 전체 검색
+         * Find all child elements matching selector
          *
-         * @param selector - CSS 셀렉터
-         * @returns 매칭된 요소 배열 (빈 셀렉터는 빈 배열 반환)
+         * @param selector - CSS selector
+         * @returns Array of matching elements (empty selector returns empty array)
          */
         findAll<T extends Element = Element>(selector: string): T[];
         /**
-         * 셀렉터로 첫 번째 매칭 요소 검색
+         * Find first element matching selector
          *
-         * @param selector - CSS 셀렉터
-         * @returns 첫 번째 매칭 요소 또는 undefined (빈 셀렉터는 undefined 반환)
+         * @param selector - CSS selector
+         * @returns First matching element or undefined (empty selector returns undefined)
          */
         findFirst<T extends Element = Element>(selector: string): T | undefined;
         /**
-         * 요소를 첫 번째 자식으로 삽입
+         * Insert element as first child
          *
-         * @param child - 삽입할 자식 요소
-         * @returns 삽입된 자식 요소
+         * @param child - Child element to insert
+         * @returns Inserted child element
          */
         prependChild<T extends Element>(child: T): T;
         /**
-         * 모든 부모 요소 목록 반환 (가까운 순서)
+         * Get all parent elements (in order of proximity)
          *
-         * @returns 부모 요소 배열 (가까운 부모부터 순서대로)
+         * @returns Array of parent elements (from closest to farthest)
          */
         getParents(): Element[];
         /**
-         * 부모 중 첫 번째 포커스 가능 요소 검색 (tabbable 사용)
+         * Find first focusable parent element (using tabbable)
          *
-         * @returns 포커스 가능한 첫 번째 부모 요소 또는 undefined
+         * @returns First focusable parent element or undefined
          */
         findFocusableParent(): HTMLElement | undefined;
         /**
-         * 자식 중 첫 번째 포커스 가능 요소 검색 (tabbable 사용)
+         * Find first focusable child element (using tabbable)
          *
-         * @returns 포커스 가능한 첫 번째 자식 요소 또는 undefined
+         * @returns First focusable child element or undefined
          */
         findFirstFocusableChild(): HTMLElement | undefined;
         /**
-         * 요소가 offset 기준 요소인지 확인 (position: relative/absolute/fixed/sticky)
+         * Check if element is an offset parent (position: relative/absolute/fixed/sticky)
          *
-         * @returns position 속성이 relative, absolute, fixed, sticky 중 하나면 true
+         * @returns true if position property is one of relative, absolute, fixed, or sticky
          */
         isOffsetElement(): boolean;
         /**
-         * 요소가 화면에 보이는지 확인
+         * Check if element is visible on screen
          *
          * @remarks
-         * clientRects 존재 여부, visibility: hidden, opacity: 0 여부를 확인한다.
+         * Checks existence of clientRects, visibility: hidden, and opacity: 0.
          *
-         * @returns 요소가 화면에 보이면 true
+         * @returns true if element is visible on screen
          */
         isVisible(): boolean;
     }
 }
 /**
- * 요소 내용을 클립보드에 복사 (copy 이벤트 핸들러에서 사용)
+ * Copy element content to clipboard (use with copy event handler)
  *
- * @param event - copy 이벤트 객체
+ * @param event - copy event object
  */
 export declare function copyElement(event: ClipboardEvent): void;
 /**
- * 클립보드 내용을 요소에 붙여넣기 (paste 이벤트 핸들러에서 사용)
+ * Paste clipboard content to element (use with paste event handler)
  *
  * @remarks
- * 대상 요소 내의 첫 번째 input/textarea를 찾아 전체 값을 클립보드 내용으로 교체한다.
- * 커서 위치나 선택 영역을 고려하지 않는다.
+ * Finds the first input/textarea within the target element and replaces its entire value with clipboard content.
+ * Does not consider cursor position or selection.
  *
- * @param event - paste 이벤트 객체
+ * @param event - paste event object
  */
 export declare function pasteToElement(event: ClipboardEvent): void;
 /**
- * IntersectionObserver를 사용하여 요소들의 bounds 정보 조회
+ * Get bounds information for elements using IntersectionObserver
  *
- * @param els - 대상 요소 배열
- * @param timeout - 타임아웃 (밀리초, 기본: 5000)
- * @throws {TimeoutError} 타임아웃 시간 내에 응답이 없을 경우
+ * @param els - Array of target elements
+ * @param timeout - Timeout in milliseconds (default: 5000)
+ * @throws {TimeoutError} If no response within timeout duration
  */
 export declare function getBounds(els: Element[], timeout?: number): Promise<ElementBounds[]>;
 //# sourceMappingURL=element-ext.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"element-ext.d.ts","sourceRoot":"","sources":["..\\..\\src\\extensions\\element-ext.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,eAAe;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,mBAAmB;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,YAAY;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,OAAO;QACf;;;;;WAKG;QACH,OAAO,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC,EAAE,CAAC;QAE5D;;;;;WAKG;QACH,SAAS,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;QAExE;;;;;WAKG;QACH,YAAY,CAAC,CAAC,SAAS,OAAO,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC;QAE7C;;;;WAIG;QACH,UAAU,IAAI,OAAO,EAAE,CAAC;QAExB;;;;WAIG;QACH,mBAAmB,IAAI,WAAW,GAAG,SAAS,CAAC;QAE/C;;;;WAIG;QACH,uBAAuB,IAAI,WAAW,GAAG,SAAS,CAAC;QAEnD;;;;WAIG;QACH,eAAe,IAAI,OAAO,CAAC;QAE3B;;;;;;;WAOG;QACH,SAAS,IAAI,OAAO,CAAC;KACtB;CACF;AAkED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAYvD;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAa1D;AAED;;;;;;GAMG;AACH,wBAAsB,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,OAAO,GAAE,MAAa,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAoDhG"}
+{"version":3,"file":"element-ext.d.ts","sourceRoot":"","sources":["..\\..\\src\\extensions\\element-ext.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,6BAA6B;IAC7B,MAAM,EAAE,OAAO,CAAC;IAChB,wCAAwC;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,OAAO;QACf;;;;;WAKG;QACH,OAAO,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC,EAAE,CAAC;QAE5D;;;;;WAKG;QACH,SAAS,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;QAExE;;;;;WAKG;QACH,YAAY,CAAC,CAAC,SAAS,OAAO,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC;QAE7C;;;;WAIG;QACH,UAAU,IAAI,OAAO,EAAE,CAAC;QAExB;;;;WAIG;QACH,mBAAmB,IAAI,WAAW,GAAG,SAAS,CAAC;QAE/C;;;;WAIG;QACH,uBAAuB,IAAI,WAAW,GAAG,SAAS,CAAC;QAEnD;;;;WAIG;QACH,eAAe,IAAI,OAAO,CAAC;QAE3B;;;;;;;WAOG;QACH,SAAS,IAAI,OAAO,CAAC;KACtB;CACF;AAkED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAYvD;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAa1D;AAED;;;;;;GAMG;AACH,wBAAsB,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,OAAO,GAAE,MAAa,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAoDhG"}

package/dist/extensions/element-ext.js

@@ -111,7 +111,7 @@ async function getBounds(els, timeout = 5e3) {
         }
       }),
       new Promise(
-        (_, reject) => setTimeout(() => reject(new TimeoutError(void 0, `${timeout}ms \uCD08\uACFC`)), timeout)
+        (_, reject) => setTimeout(() => reject(new TimeoutError(void 0, `${timeout}ms timeout`)), timeout)
       )
     ]);
   } finally {

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

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

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

@@ -1,45 +1,45 @@
 declare global {
     interface HTMLElement {
         /**
-         * 강제 리페인트 (reflow 트리거)
+         * Force repaint (triggers reflow)
          */
         repaint(): void;
         /**
-         * 부모 요소 기준 상대 위치 계산 (CSS 포지셔닝용)
+         * Calculate relative position based on parent element (for CSS positioning)
          *
          * @remarks
-         * 이 함수는 요소의 위치를 부모 요소 기준으로 계산하되, `window.scrollX/Y`를 포함하여
-         * CSS `top`/`left` 속성에 직접 사용할 수 있는 문서 기준 좌표를 반환한다.
+         * 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.
          *
-         * 주요 사용 사례:
-         * - 드롭다운, 팝업 등을 `document.body`에 append 후 위치 지정
-         * - 스크롤된 페이지에서도 올바르게 동작
+         * Common use cases:
+         * - Position dropdowns, popups after appending to `document.body`
+         * - Works correctly on scrolled pages
          *
-         * 계산에 포함되는 요소:
-         * - 뷰포트 기준 위치 (getBoundingClientRect)
-         * - 문서 스크롤 위치 (window.scrollX/Y)
-         * - 부모 요소 내부 스크롤 (parentEl.scrollTop/Left)
-         * - 중간 요소들의 border 두께
-         * - CSS transform 변환
+         * 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
          *
-         * @param parent - 기준이 될 부모 요소 또는 셀렉터 (예: document.body, ".container")
-         * @returns CSS top/left 속성에 사용할 수 있는 좌표
-         * @throws {ArgumentError} 부모 요소를 찾을 수 없는 경우
+         * @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
          */
         getRelativeOffset(parent: HTMLElement | string): {
             top: number;
             left: number;
         };
         /**
-         * 대상이 offset 영역(고정 헤더/고정 열 등)에 가려진 경우, 보이도록 스크롤
+         * Scroll to make target visible if hidden by offset area (e.g., fixed header/column)
          *
          * @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 - 대상의 컨테이너 내 위치 (offsetTop, offsetLeft)
-         * @param offset - 가려지면 안 되는 영역 크기 (예: 고정 헤더 높이, 고정 열 너비)
+         * @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)
          */
         scrollIntoViewIfNeeded(target: {
             top: number;

package/dist/utils/download.d.ts

@@ -1,8 +1,8 @@
 /**
- * Blob을 파일로 다운로드
+ * Download Blob as file
  *
- * @param blob - 다운로드할 Blob 객체
- * @param fileName - 저장될 파일 이름
+ * @param blob - Blob object to download
+ * @param fileName - File name to save as
  */
 export declare function downloadBlob(blob: Blob, fileName: string): void;
 //# sourceMappingURL=download.d.ts.map

package/dist/utils/fetch.d.ts

@@ -3,7 +3,7 @@ export interface DownloadProgress {
     contentLength: number;
 }
 /**
- * URL에서 바이너리 데이터 다운로드 (진행률 콜백 지원)
+ * Download binary data from URL (with progress callback support)
  */
 export declare function fetchUrlBytes(url: string, options?: {
     onProgress?: (progress: DownloadProgress) => void;

package/dist/utils/file-dialog.d.ts

@@ -1,5 +1,5 @@
 /**
- * 파일 선택 다이얼로그를 프로그래밍 방식으로 열기
+ * Programmatically open file selection dialog
  */
 export declare function openFileDialog(options?: {
     accept?: string;

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@simplysm/core-browser",
-  "version": "13.0.69",
-  "description": "심플리즘 패키지 - 코어 모듈 (browser)",
-  "author": "김석래",
+  "version": "13.0.71",
+  "description": "Simplysm package - Core module (browser)",
+  "author": "simplysm",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
@@ -14,7 +14,8 @@
   "types": "./dist/index.d.ts",
   "files": [
     "dist",
-    "src"
+    "src",
+    "tests"
   ],
   "sideEffects": [
     "./dist/extensions/element-ext.js",
@@ -22,7 +23,7 @@
   ],
   "dependencies": {
     "tabbable": "^6.4.0",
-    "@simplysm/core-common": "13.0.69"
+    "@simplysm/core-common": "13.0.71"
   },
   "devDependencies": {
     "happy-dom": "^20.7.0"