open-grid 1.1.1 → 1.2.1

package/dist/types/core/RowManager.d.ts

@@ -1,29 +1,84 @@
 import { DataLayer } from './DataLayer.js';
+/**
+ * 행 선택(selection)과 체크(checkbox) 상태를 관리하는 매니저. / Manages row selection and checkbox state.
+ *
+ * 두 상태는 서로 독립적이다 — 선택은 활성/포커스 개념(단일 행만 유지 가능),
+ * 체크는 다중 표시(예: 체크박스 컬럼)를 위한 별도 집합이다.
+ * / The two states are independent — selection tracks an active/focus concept
+ * (can be limited to a single row), while checks are a separate set for
+ * multi-marking (e.g. a checkbox column).
+ */
 export declare class RowManager<T extends Record<string, any> = any> {
     private _selectedRows;
     private _checkedRows;
     private _data;
     constructor(data: DataLayer<T>);
+    /** 선택된 행 인덱스 집합(원본 참조). / Set of selected row indexes (live reference). */
     get selectedRows(): Set<number>;
+    /** 체크된 행 인덱스 집합(원본 참조). / Set of checked row indexes (live reference). */
     get checkedRows(): Set<number>;
+    /**
+     * 단일 행만 선택한다(기존 선택은 모두 해제). / Select exactly one row (clears any prior selection).
+     *
+     * @param ri - 선택할 행의 flat index / Flat index of the row to select
+     */
     selectSingle(ri: number): void;
+    /**
+     * 지정 행의 선택 상태를 토글한다(다중 선택 누적). / Toggle a row's selection state (accumulates for multi-select).
+     *
+     * @param ri - 토글할 행의 flat index / Flat index of the row to toggle
+     */
     selectToggle(ri: number): void;
+    /** 모든 행 선택을 해제한다. / Clear every row selection. */
     clearSelection(): void;
+    /**
+     * 지정 행의 체크 상태를 설정한다. / Set the checked state of a single row.
+     *
+     * @param ri - 대상 행의 flat index / Flat index of the target row
+     * @param checked - 체크 여부 / Whether the row should be checked
+     */
     check(ri: number, checked: boolean): void;
+    /**
+     * 전체 행을 체크하거나 전체 해제한다. / Check or uncheck every row.
+     *
+     * @param checked - `true` 면 전체 체크, `false` 면 전체 해제 / `true` to check all, `false` to clear all
+     * @param totalRows - 전체 행 수(체크 시 0..totalRows-1 을 채움) / Total row count (when checking, fills indexes 0..totalRows-1)
+     */
     checkAll(checked: boolean, totalRows: number): void;
+    /**
+     * 특정 컬럼 값이 주어진 목록에 포함된 행들을 체크한다. / Check every row whose column value is in the given list.
+     *
+     * @param field - 값을 비교할 컬럼 field 명 / Column field to compare values against
+     * @param values - 매칭 대상 값 목록 / Values to match against
+     */
     checkByValue(field: string, values: any[]): void;
+    /** 모든 체크를 해제한다. / Clear every checked row. */
     uncheckAll(): void;
+    /** @internal 미구현 스텁(rowId 기반 체크 API 예약). / @internal Unimplemented stub (reserved for a rowId-based check API). */
     checkById(_ids: string[]): void;
+    /** @internal 미구현 스텁(rowId 기반 체크 추가 API 예약). / @internal Unimplemented stub (reserved for a rowId-based add-check API). */
     addCheckById(_ids: string[]): void;
+    /** @internal 미구현 스텁(rowId 기반 체크 해제 API 예약). / @internal Unimplemented stub (reserved for a rowId-based uncheck API). */
     uncheckById(_ids: string[]): void;
+    /** 현재 선택된 행 데이터 배열을 반환한다(존재하지 않는 인덱스는 제외). / Return the currently selected row data (indexes with no backing row are skipped). */
     getSelections(): T[];
+    /** 체크된 행을 `{ row, rowIndex }` 쌍의 배열로 반환한다. / Return checked rows as an array of `{ row, rowIndex }` pairs. */
     getChecked(): Array<{
         row: T;
         rowIndex: number;
     }>;
+    /** 체크된 행의 데이터만 배열로 반환한다. / Return only the row data of checked rows. */
     getAllChecked(): T[];
+    /** 활성(선택) 행의 인덱스를 반환한다(없으면 -1). / Return the active (selected) row's index, or -1 if none. */
     getActiveRow(): number;
+    /**
+     * 지정 행을 활성 상태로 만든다(단일 선택과 동일 동작). / Make the given row active (same effect as single-select).
+     *
+     * @param index - 활성화할 행의 flat index / Flat index of the row to activate
+     */
     activate(index: number): void;
+    /** 선택을 해제한다(활성 행 없음). / Deselect (no active row). */
     deselect(): void;
+    /** 선택·체크 상태를 모두 초기화한다(주로 `setData`/`clearData` 시 호출). / Reset both selection and check state (typically called on `setData`/`clearData`). */
     reset(): void;
 }

package/dist/types/core/SkinRegistry.d.ts

@@ -1,53 +1,89 @@
 import { SkinTokenDelta } from './types.js';
+/** 스킨 정의 결과. / Result of a skin definition. */
 export interface SkinDefineResult {
-    /** 실제 등록된(가드레일 클램프가 반영된) 델타. */
+    /** 실제 등록된(가드레일 클램프가 반영된) 델타. / The actually registered delta (with guardrail clamps applied). */
     readonly delta: SkinTokenDelta;
-    /** 접근성 가드레일이 조정한 토큰 경고(있으면 콘솔에도 출력). */
+    /** 접근성 가드레일이 조정한 토큰 경고(있으면 콘솔에도 출력). / Warnings for tokens adjusted by accessibility guardrails (also logged to console when present). */
     readonly warnings: string[];
 }
-/** 스킨 델타가 색 리터럴을 담고 있는지 검사하고, 위반 시 던진다(FORM-only, Rule 2). */
+/**
+ * 스킨 델타가 색 리터럴을 담고 있는지 검사하고, 위반 시 던진다(FORM-only, Rule 2).
+ * / Assert a skin delta carries no color literal; throws on violation (FORM-only, Rule 2).
+ *
+ * @param id - 스킨 id / Skin id
+ * @param delta - 검사할 토큰 델타 / Token delta to validate
+ * @throws FORM 토큰이 아니거나 색 리터럴이 있으면 Error / Throws if a non-FORM token or a color literal is present
+ */
 export declare function assertFormOnly(id: string, delta: SkinTokenDelta): void;
 /**
- * HANMS 접근성 가드레일(불변식) 적용 — 정의 시점 클램프(§6.4, HANMS P0-4).
- *  - focus-width < 2px → 2px 로 클램프(가시 포커스 비협상).
+ * 접근성 가드레일(불변식) 적용 — 정의 시점 클램프(§6.4).
+ * / Apply accessibility guardrails (invariants) — clamp at definition time (§6.4).
+ *
+ *  - focus-width < 2px → 2px 로 클램프(가시 포커스 비협상). / clamp to 2px (visible focus is non-negotiable).
  *  - focus-style: none → solid.
+ *
  * 반환은 조정된 델타 + 경고 목록(silent override 아님 — 무엇을 클램프했는지 알린다).
+ * / Returns the adjusted delta plus a warning list (not a silent override — it reports what was clamped).
+ *
+ * @param id - 스킨 id / Skin id
+ * @param delta - 조정할 토큰 델타 / Token delta to adjust
+ * @returns 조정된 델타 + 경고 목록 / Adjusted delta plus warnings
  */
 export declare function applyGuardrails(id: string, delta: SkinTokenDelta): SkinDefineResult;
 /**
  * 프로세스 전역 스킨 등록소. defineSkin(사용자) 는 검증+가드레일+`<style>` 주입,
  * registerBuiltin(내장) 은 검증+가드레일만(CSS 는 skins.css 정적 번들 소유).
+ * / Process-global skin registry. `define` (user) does validation + guardrails + `<style>` injection;
+ * `registerBuiltin` (built-in) does validation + guardrails only (CSS is owned by the skins.css static bundle).
+ *
+ * @example
+ * skinRegistry.define('my-skin', { '--og-radius-md': '10px', '--og-border-style': 'solid' });
  */
 export declare class SkinRegistry {
     private _skins;
     private _styleEl;
-    /** 내장 스킨 등록(주입 없음 — CSS 는 skins.css 가 전달). 검증/가드레일은 동일 적용. */
+    /**
+     * 내장 스킨 등록(주입 없음 — CSS 는 skins.css 가 전달). 검증/가드레일은 동일 적용.
+     * / Register a built-in skin (no injection — CSS is delivered by skins.css). Validation/guardrails still apply.
+     *
+     * @param id - 스킨 id / Skin id
+     * @param delta - FORM 토큰 델타 / FORM token delta
+     */
     registerBuiltin(id: string, delta: SkinTokenDelta): void;
     /**
      * 사용자 스킨 등록. FORM-only 검증 + 가드레일 클램프 후 런타임 `<style>` 로
      * `.og-container[data-og-skin="id"]` 블록을 주입(브라우저 환경). 반환은 조정 결과.
+     * / Register a user skin. After FORM-only validation and guardrail clamps, injects a
+     * `.og-container[data-og-skin="id"]` block via a runtime `<style>` (browser env). Returns the adjusted result.
+     *
+     * @param id - 스킨 id / Skin id
+     * @param delta - FORM 토큰 델타 / FORM token delta
+     * @returns 조정된 델타 + 경고 목록 / Adjusted delta plus warnings
      */
     define(id: string, delta: SkinTokenDelta): SkinDefineResult;
+    /** 스킨 id 등록 여부. / Whether a skin id is registered. */
     has(id: string): boolean;
+    /** 등록된 스킨 델타 조회(없으면 undefined). / Get a registered skin delta (undefined if absent). */
     get(id: string): SkinTokenDelta | undefined;
-    /** 등록된 모든 스킨 id(내장 + 사용자). */
+    /** 등록된 모든 스킨 id(내장 + 사용자). / All registered skin ids (built-in + user). */
     list(): string[];
     /** 런타임 `<style>` 주입(테스트/SSR 등 document 없으면 no-op). 같은 태그를 누적 사용. */
     private _inject;
 }
-/** Sharp/Gothic — 엔터프라이즈 고밀도·각짐(§3.1). HANMS: APPROVE-WITH-GUARDRAIL(G-S1). */
+/** Sharp/Gothic — 엔터프라이즈 고밀도·각짐(§3.1). / Sharp/Gothic — enterprise high-density, squared corners (§3.1). */
 export declare const SKIN_SHARP: SkinTokenDelta;
-/** Rounded — 소비자 SaaS 소프트(§3.2). HANMS: APPROVE. */
+/** Rounded — 소비자 SaaS 소프트(§3.2). / Rounded — consumer-SaaS soft look (§3.2). */
 export declare const SKIN_ROUNDED: SkinTokenDelta;
-/** Stitch — 핸드크래프트(§3.3). HANMS: APPROVE-WITH-GUARDRAIL(G-ST1~3). 색(리넨/자수)은 theme 축. */
+/** Stitch — 핸드크래프트(§3.3). 색(리넨/자수)은 theme 축. / Stitch — handcrafted look (§3.3); color (linen/embroidery) lives on the theme axis. */
 export declare const SKIN_STITCH: SkinTokenDelta;
-/** Flat/Minimal — 플랫 2.0(§3.5). HANMS: APPROVE-WITH-GUARDRAIL(G-F1: 플로팅 표면 1px 보더). */
+/** Flat/Minimal — 플랫 2.0(§3.5). / Flat/Minimal — flat 2.0 (§3.5). */
 export declare const SKIN_FLAT: SkinTokenDelta;
-/** High-Contrast — 접근성 우선·레퍼런스(§3.6). HANMS: APPROVE(안전 폴백). */
+/** High-Contrast — 접근성 우선·레퍼런스(§3.6). / High-Contrast — accessibility-first reference skin (§3.6). */
 export declare const SKIN_HIGH_CONTRAST: SkinTokenDelta;
-/** Material/Elevated — Neumorph 대체(HANMS §3): 중간 반경 + 정직한 그림자 엘리베이션. APPROVE. */
+/** Material/Elevated — 중간 반경 + 정직한 그림자 엘리베이션. / Material/Elevated — medium radius plus honest shadow elevation. */
 export declare const SKIN_MATERIAL: SkinTokenDelta;
-/** 내장 스킨 카탈로그(HANMS 확정 6종, Neumorph 제외). id → 델타. */
+/** 내장 스킨 카탈로그(확정 6종). id → 델타. / Built-in skin catalog (6 finalized skins). id → delta. */
 export declare const BUILTIN_SKINS: ReadonlyArray<readonly [string, SkinTokenDelta]>;
-/** 프로세스 전역 기본 레지스트리 — 내장 스킨을 부트스트랩 등록(주입 없음, CSS=skins.css). */
+/** 프로세스 전역 기본 레지스트리 — 내장 스킨을 부트스트랩 등록(주입 없음, CSS=skins.css).
+ *  / Process-global default registry — bootstraps the built-in skins (no injection; CSS=skins.css). */
 export declare const skinRegistry: SkinRegistry;

package/dist/types/core/SortFilterManager.d.ts

@@ -3,35 +3,116 @@ import { ColumnLayout } from './ColumnLayout.js';
 import { VirtualScroll } from './VirtualScroll.js';
 import { Pagination } from './Pagination.js';
 import { SortItem, FilterItem } from './types.js';
+/**
+ * {@link SortFilterManager} 의존성 주입 계약. / Dependency-injection contract for {@link SortFilterManager}.
+ *
+ * 호스트 그리드가 데이터/렌더/i18n 접근을 함수로 넘겨 매니저를 데이터 소스와 분리한다.
+ * / The host grid passes data/render/i18n access as functions, decoupling the manager
+ * from its data source.
+ */
 export interface SortFilterDeps<T extends Record<string, any>> {
+    /** 현재 데이터 레이어 조회. / Look up the current data layer. */
     getData: () => DataLayer<T>;
+    /** 현재 컬럼 레이아웃 조회. / Look up the current column layout. */
     getColLayout: () => ColumnLayout<T>;
+    /** 통합검색(find) 필터 문자열 조회. / Look up the current find-filter string. */
     getFindFilter: () => string;
+    /** 가상 스크롤 인스턴스 조회(없으면 `null`). / Look up the virtual-scroll instance (or `null`). */
     getVs: () => VirtualScroll | null;
+    /** 페이지네이션 인스턴스 조회(없으면 `null`). / Look up the pagination instance (or `null`). */
     getPagination: () => Pagination | null;
+    /** 현재 그리드 옵션 조회. / Look up the current grid options. */
     getOptions: () => any;
+    /** 헤더(정렬/필터 표시)를 다시 그린다. / Re-render the header (sort/filter indicators). */
     renderHeader: () => void;
+    /** 바디를 다시 그린다. / Re-render the body. */
     doRender: () => void;
+    /** 스크린리더용 상태 안내. / Announce a status message for screen readers. */
     announce: (msg: string) => void;
+    /** i18n: 정렬 상태어 + announce 해석. / i18n: resolve sort state words + announce. */
+    t: (key: string, params?: Record<string, string | number>) => string;
+    /** 그리드 이벤트를 발행한다. / Emit a grid event. */
     emit: (event: string, ...args: any[]) => void;
-    /** C0.5/§2.5: 정렬/필터 후 F1 범위 선택을 rowId 집합 기준으로 재투영(해제 아님). */
+    /** C0.5/§2.5: 정렬/필터 후 F1 범위 선택을 rowId 집합 기준으로 재투영(해제 아님).
+     * / C0.5/§2.5: after sort/filter, re-project the F1 range selection by its rowId
+     * set instead of clearing it. */
     onReproject?: () => void;
 }
+/**
+ * 정렬·필터 상태와 적용을 담당하는 매니저. / Manages sort/filter state and their application.
+ *
+ * 정렬 목록(`SortItem[]`)과 컬럼별 필터(`FilterItem[]`)를 소유하고, 데이터 레이어에
+ * 적용한 뒤 헤더/바디 재렌더와 관련 이벤트 발행까지 처리한다.
+ * / Owns the sort list (`SortItem[]`) and per-column filters (`FilterItem[]`), applies
+ * them to the data layer, and drives header/body re-render plus related event emission.
+ */
 export declare class SortFilterManager<T extends Record<string, any> = any> {
     private _sortList;
     private _filters;
     private _d;
     constructor(deps: SortFilterDeps<T>);
+    /** 현재 정렬 목록(원본 참조). / Current sort list (live reference). */
     get sortList(): SortItem[];
+    /** 컬럼 field 별 필터 목록(원본 참조). / Filter items keyed by column field (live reference). */
     get filters(): Record<string, FilterItem[]>;
+    /**
+     * 헤더 정렬 클릭을 처리한다(단일/다중 정렬 토글). / Handle a header sort click (toggles single/multi sort).
+     *
+     * 같은 필드를 다시 클릭하면 asc→desc→해제 순으로 순환한다. `shiftKey` 와
+     * `multiSort` 옵션이 모두 켜져야 다중 정렬 목록에 누적된다.
+     * / Re-clicking the same field cycles asc → desc → removed. Multi-sort only
+     * accumulates when both `shiftKey` and the `multiSort` option are on.
+     *
+     * @param field - 정렬 대상 컬럼 field 명 / Column field to sort by
+     * @param shiftKey - 다중 정렬 결합 키(Shift) 눌림 여부 / Whether the multi-sort modifier (Shift) was held
+     */
     handleSortClick(field: string, shiftKey: boolean): void;
+    /**
+     * 프로그램적으로 정렬을 설정한다(단일 필드+방향, 또는 전체 정렬 목록). / Set sort programmatically (single field+direction, or a full sort list).
+     *
+     * @param fieldOrList - 정렬할 필드명, 또는 대체할 전체 `SortItem[]` / Field to sort by, or a full `SortItem[]` to replace the current list
+     * @param dir - `fieldOrList` 가 문자열일 때의 정렬 방향(기본 `'asc'`) / Sort direction when `fieldOrList` is a string (default `'asc'`)
+     * @example
+     * mgr.sort('name', 'desc');
+     * mgr.sort([{ field: 'age', dir: 'asc' }]);
+     */
     sort(fieldOrList: string | SortItem[], dir?: 'asc' | 'desc'): void;
+    /** 모든 정렬을 해제한다. / Clear all sorting. */
     resetSort(): void;
+    /**
+     * 초기 정렬 목록을 조용히 적용한다(렌더/이벤트 없이 데이터만). / Silently seed the initial sort list (data only, no render/events).
+     *
+     * @param sortList - 초기화 시 적용할 정렬 목록 / Sort list to apply at initialization
+     */
     initSort(sortList: SortItem[]): void;
+    /** 현재 정렬 목록의 복사본을 반환한다. / Return a copy of the current sort list. */
     getSortState(): SortItem[];
+    /**
+     * 특정 컬럼의 필터를 설정하고 적용한다. / Set and apply the filter for one column.
+     *
+     * @param field - 필터를 적용할 컬럼 field 명 / Column field to filter
+     * @param filterItems - 적용할 필터 조건 목록 / Filter conditions to apply
+     */
     setFilter(field: string, filterItems: FilterItem[]): void;
+    /**
+     * 필터를 해제한다(필드 지정 시 해당 필드만, 생략 시 전체). / Clear filters (one field if given, otherwise all).
+     *
+     * @param field - 해제할 컬럼 field 명. 생략하면 전체 필터 해제 / Column field to clear; omit to clear every filter
+     */
     resetFilter(field?: string): void;
+    /** 현재 컬럼별 필터 상태의 복사본을 반환한다. / Return a copy of the current per-column filter state. */
     getFilterState(): Record<string, FilterItem[]>;
+    /**
+     * 저장된 필터 상태를 복원하고 재적용한다(헤더/바디 재렌더는 호출측 책임). / Restore a saved filter state and reapply it (caller is responsible for header/body re-render).
+     *
+     * @param state - 복원할 컬럼별 필터 상태 / Per-column filter state to restore
+     */
     restoreFilter(state: Record<string, FilterItem[]>): void;
+    /**
+     * 통합검색 + 컬럼 필터를 데이터 레이어에 적용하고 행수를 재투영한다. / Apply find-filter and column filters to the data layer, then re-project row counts.
+     *
+     * 정렬과 달리 이 메서드는 헤더/바디를 직접 재렌더하지 않는다(호출측이 필요 시 처리).
+     * / Unlike sorting, this does not re-render header/body itself (callers handle that as needed).
+     */
     applyFilters(): void;
 }

package/dist/types/core/TriggerManager.d.ts

@@ -1,9 +1,55 @@
 import { TriggerContext, TriggerHandler, TriggerEvent } from './types.js';
+/**
+ * before/after 트리거 훅 레지스트리. / Registry for before/after trigger hooks.
+ *
+ * 그리드 연산(`operation`) 앞뒤로 사용자 핸들러를 실행한다. `before:*` 훅은
+ * 컨텍스트를 `cancel()` 하여 연산을 취소할 수 있고, `after:*` 훅 뒤에는 `complete`
+ * 훅이 추가로 실행된다.
+ * / Runs user handlers around grid operations. A `before:*` hook may cancel the
+ * operation via `ctx.cancel()`; after any `after:*` hook, registered `complete`
+ * hooks also fire.
+ */
 export declare class TriggerManager {
     private _triggers;
+    /**
+     * 트리거 이벤트에 핸들러를 등록한다. / Register a handler for a trigger event.
+     *
+     * @param event - 트리거 이벤트명(예: `before:setValue`) / Trigger event name (e.g. `before:setValue`)
+     * @param handler - 실행할 핸들러 / Handler to run
+     */
     add(event: TriggerEvent | string, handler: TriggerHandler): void;
+    /**
+     * 등록된 핸들러를 제거한다. / Remove a previously registered handler.
+     *
+     * @param event - 트리거 이벤트명 / Trigger event name
+     * @param handler - 제거할 핸들러(등록 시와 동일 참조) / Handler to remove (same reference used at registration)
+     */
     remove(event: TriggerEvent | string, handler: TriggerHandler): void;
+    /**
+     * 특정 이벤트 또는 전체 트리거를 해제한다. / Clear one event's triggers, or all of them.
+     *
+     * @param event - 지우려는 이벤트명. 생략하면 전체 삭제 / Event to clear; omit to clear everything
+     */
     clear(event?: TriggerEvent | string): void;
+    /**
+     * 트리거 실행용 컨텍스트 객체를 생성한다. / Build a context object for trigger execution.
+     *
+     * @param operation - 연산 이름 / Operation name
+     * @param args - 연산 인자 배열 / Operation argument array
+     * @returns `cancel()` 로 취소 가능한 트리거 컨텍스트 / A trigger context cancellable via `cancel()`
+     */
     mkCtx(operation: string, args: any[]): TriggerContext;
+    /**
+     * 이벤트에 등록된 핸들러를 순차 실행한다. / Run handlers registered for an event, in order.
+     *
+     * `before:*` 훅 중 하나라도 `ctx.cancel()` 을 호출하면 즉시 중단하고 `false` 를
+     * 반환한다. `after:*` 이벤트는 완료 후 `complete` 훅도 실행한다.
+     * / If any `before:*` hook calls `ctx.cancel()`, execution stops immediately and
+     * returns `false`. For `after:*` events, `complete` hooks also run afterward.
+     *
+     * @param event - 실행할 이벤트명 / Event name to run
+     * @param ctx - 트리거 컨텍스트 / Trigger context
+     * @returns 취소되지 않았으면 `true` / `true` unless the operation was cancelled
+     */
     exec(event: string, ctx: TriggerContext): boolean;
 }

package/dist/types/core/WorksheetManager.d.ts

@@ -1,23 +1,85 @@
 import { ColumnDef, WorksheetState } from './types.js';
+/** 시트 전환 시 호출되는 콜백. / Callback invoked when the active sheet switches. */
 export type SwitchCallback<T> = (name: string, state: WorksheetState<T>) => void;
+/** i18n: 탭 UI aria 해석기(주입 없으면 전역 t). / i18n: tab-UI aria resolver (global t when not injected). */
+export type WorksheetT = (key: string, params?: Record<string, string | number>) => string;
+/**
+ * 그리드 다중 워크시트(탭) 관리자. / Manages the grid's multiple worksheets (tabs).
+ *
+ * 시트별로 독립적인 `columns`/`data` 를 `Map` 으로 보유하고, 탭 클릭 시
+ * `onSwitch` 콜백을 통해 `OpenGrid.setData`/`applyColumns` 로 화면을 전환시킨다.
+ * 탭 UI는 그리드 컨테이너 하단에 `.og-sheet-tabs` 영역으로 삽입된다.
+ * / Holds independent `columns`/`data` per sheet in a `Map`; a tab click drives the
+ * `onSwitch` callback, which the caller uses to run `OpenGrid.setData`/`applyColumns`.
+ * The tab UI is inserted as a `.og-sheet-tabs` region at the bottom of the grid container.
+ */
 export declare class WorksheetManager<T extends Record<string, any> = any> {
     private _sheets;
     private _active;
     private _tabBar;
     private _onSwitch;
-    constructor(container: HTMLElement, onSwitch: SwitchCallback<T>);
+    private _t;
+    constructor(container: HTMLElement, onSwitch: SwitchCallback<T>, t?: WorksheetT);
+    /**
+     * 새 시트를 추가한다. / Add a new sheet.
+     *
+     * 첫 번째로 추가되는 시트는 자동으로 활성화된다. / The first sheet ever added is auto-activated.
+     *
+     * @param name - 시트 이름(고유해야 함) / Sheet name (must be unique)
+     * @param columns - 시트 컬럼 정의(기본 빈 배열) / Sheet column definitions (default empty array)
+     * @param data - 시트 초기 데이터(기본 빈 배열) / Initial sheet data (default empty array)
+     */
     add(name: string, columns?: ColumnDef<T>[], data?: T[]): void;
+    /**
+     * 시트를 제거한다. / Remove a sheet.
+     *
+     * 마지막 남은 시트는 제거할 수 없다(예외 발생). 활성 시트를 제거하면 남은 시트 중
+     * 첫 번째로 자동 전환한다. / The last remaining sheet cannot be removed (throws).
+     * Removing the active sheet auto-switches to the first remaining sheet.
+     *
+     * @param name - 제거할 시트 이름 / Name of the sheet to remove
+     */
     remove(name: string): void;
+    /**
+     * 시트 이름을 변경한다. / Rename a sheet.
+     *
+     * 삽입 순서(`Map` 순회 순서) 유지를 위해 내부적으로 시트 맵을 재구성한다.
+     * / Internally rebuilds the sheet map to preserve insertion order (`Map` iteration order).
+     *
+     * @param oldName - 기존 시트 이름 / Current sheet name
+     * @param newName - 새 시트 이름(고유해야 함) / New sheet name (must be unique)
+     */
     rename(oldName: string, newName: string): void;
+    /**
+     * 지정 시트를 활성화하고 `onSwitch` 콜백을 실행한다. / Activate the given sheet and invoke the `onSwitch` callback.
+     *
+     * @param name - 활성화할 시트 이름 / Name of the sheet to activate
+     */
     switch(name: string): void;
+    /**
+     * 시트 상태를 조회한다. / Look up a sheet's state.
+     *
+     * @param name - 조회할 시트 이름 / Name of the sheet to look up
+     * @returns 시트 상태, 없으면 `undefined` / The sheet state, or `undefined`
+     */
     get(name: string): WorksheetState<T> | undefined;
+    /** 등록된 모든 시트 이름 목록(삽입 순서). / Names of all registered sheets, in insertion order. */
     getNames(): string[];
+    /** 현재 활성 시트 이름. / Name of the currently active sheet. */
     getActive(): string;
-    /** 현재 활성 시트의 data를 갱신 (그리드 편집 동기화용) */
+    /**
+     * 지정 시트의 데이터를 갱신한다(그리드 편집 동기화용). / Update a sheet's data (for syncing grid edits back).
+     *
+     * @param name - 갱신할 시트 이름 / Name of the sheet to update
+     * @param data - 새 데이터 배열 / New data array
+     */
     syncData(name: string, data: T[]): void;
+    /** 탭 바 DOM 을 제거한다. / Remove the tab-bar DOM. */
     destroy(): void;
+    /** @internal 탭 바 컨테이너를 생성해 그리드 컨테이너에 삽입한다. / Creates the tab-bar container and appends it to the grid container. */
     private _buildTabBar;
+    /** @internal 탭 바를 전체 재렌더한다(시트 목록 + '+' 버튼). / Fully re-renders the tab bar (sheet list + '+' button). */
     private _renderTabs;
-    /** 탭 더블클릭 → input으로 전환해 이름 변경 */
+    /** @internal 탭 더블클릭 → input으로 전환해 이름 변경. / Double-click on a tab switches it to an input for inline rename. */
     private _startRename;
 }

package/dist/types/core/XmlConverter.d.ts

@@ -1,74 +1,104 @@
 /**
  * XmlConverter — XML ↔ 그리드 데이터 양방향 변환 유틸리티.
+ * / XmlConverter — bidirectional XML ↔ grid-data conversion utility.
  *
- * 지원 포맷:
+ * 지원 포맷 / Supported formats:
  *   A. Element 방식  <row><name>홍길동</name></row>
  *   B. Attribute 방식  <row name="홍길동" />
  *   C. SAP BAPI XML 응답  <RETURN><TYPE>S</TYPE><BELNR>...</BELNR></RETURN>
  *   D. SAP IDoc XML  <IDOC><E1HEADER SEGMENT="1"><BUKRS>1000</BUKRS></IDOC>
  *
  * 외부 의존성 없음 — 브라우저 내장 DOMParser 사용.
+ * / No external dependency — uses the browser's built-in DOMParser.
  */
+/** XML → 데이터 파싱 옵션. / Options for parsing XML into data. */
 export interface XmlParseOptions {
-    /** 루트 엘리먼트 태그명 (생략 시 문서 루트 자동 사용) */
+    /** 루트 엘리먼트 태그명. 생략 시 문서 루트 자동 사용. / Root element tag name; falls back to the document root when omitted. */
     rootTag?: string;
-    /** 행 엘리먼트 태그명 (생략 시 루트의 첫 번째 자식 자동 감지) */
+    /** 행 엘리먼트 태그명. 생략 시 루트의 첫 번째 자식 자동 감지. / Row element tag name; auto-detected from the root's first child when omitted. */
     rowTag?: string;
-    /** 값 추출 방식: 'element' | 'attribute' | 'auto'(기본) */
+    /** 값 추출 방식: 'element' | 'attribute' | 'auto'(기본). / Value extraction mode: 'element' | 'attribute' | 'auto' (default). @defaultValue 'auto' */
     mode?: 'element' | 'attribute' | 'auto';
-    /** XML 태그명 → 그리드 field명 매핑 (생략 시 태그명 그대로 사용) */
+    /** XML 태그명 → 그리드 field명 매핑. 생략 시 태그명 그대로 사용. / XML tag name → grid field name map; tag names are used as-is when omitted. */
     fieldMap?: Record<string, string>;
-    /** 텍스트 값 앞뒤 공백 제거 (기본 true) */
+    /** 텍스트 값 앞뒤 공백 제거. 기본 true. / Trim whitespace around text values. Default true. @defaultValue true */
     trim?: boolean;
 }
+/** 데이터 → XML 직렬화 옵션. / Options for serializing data into XML. */
 export interface XmlStringifyOptions {
-    /** 루트 태그명 (기본 'rows') */
+    /** 루트 태그명. 기본 'rows'. / Root tag name. Default 'rows'. @defaultValue 'rows' */
     rootTag?: string;
-    /** 행 태그명 (기본 'row') */
+    /** 행 태그명. 기본 'row'. / Row tag name. Default 'row'. @defaultValue 'row' */
     rowTag?: string;
-    /** 출력 방식: 'element'(기본) | 'attribute' */
+    /** 출력 방식: 'element'(기본) | 'attribute'. / Output mode: 'element' (default) | 'attribute'. @defaultValue 'element' */
     mode?: 'element' | 'attribute';
-    /** 그리드 field명 → XML 태그명 매핑 */
+    /** 그리드 field명 → XML 태그명 매핑. / Grid field name → XML tag name map. */
     fieldMap?: Record<string, string>;
-    /** XML 선언부 포함 여부 (기본 true) */
+    /** XML 선언부 포함 여부. 기본 true. / Whether to include the XML declaration. Default true. @defaultValue true */
     declaration?: boolean;
-    /** 들여쓰기 공백 수 (기본 2) */
+    /** 들여쓰기 공백 수. 기본 2. / Indentation space count. Default 2. @defaultValue 2 */
     indent?: number;
-    /** null/undefined 처리 문자열 (기본 '') */
+    /** null/undefined 처리 문자열. 기본 ''. / String used for null/undefined values. Default ''. @defaultValue '' */
     nullAs?: string;
-    /** 출력에서 제외할 필드 목록 */
+    /** 출력에서 제외할 필드 목록. / Field names to exclude from the output. */
     excludeFields?: string[];
 }
+/** SAP XML 파싱 결과 구조. / Result structure of SAP XML parsing. */
 export interface SapParseResult {
+    /** 문서 헤더(DOCUMENTHEADER) 필드 맵. / Document header (DOCUMENTHEADER) field map. */
     header: Record<string, string>;
+    /** 라인 아이템 행 배열. / Line-item row array. */
     items: Record<string, string>[];
+    /** RETURN 메시지 행 배열(복수). / RETURN message rows (may be multiple). */
     returns: Record<string, string>[];
+    /** 파싱에 사용한 원본 Document(선택). / The source Document used for parsing (optional). */
     raw?: Document;
 }
+/**
+ * XML ↔ 그리드 데이터 변환기(정적 메서드 모음). / XML ↔ grid-data converter (static methods).
+ *
+ * @example
+ * const rows = XmlConverter.parse('<rows><row><name>Kim</name></row></rows>');
+ * const xml  = XmlConverter.stringify(rows);
+ */
 export declare class XmlConverter {
     /**
-     * XML 문자열을 파싱하여 그리드 데이터 배열로 변환.
-     * Element / Attribute 방식 자동 감지.
+     * XML 문자열을 파싱하여 그리드 데이터 배열로 변환. Element / Attribute 방식 자동 감지.
+     * / Parse an XML string into a grid-data array. Auto-detects element vs. attribute style.
      *
-     * @throws XML 파싱 오류 시 Error 발생
+     * @param xml - 파싱할 XML 문자열 / XML string to parse
+     * @param options - 파싱 옵션 / Parse options
+     * @returns 행 객체 배열 / Array of row objects
+     * @throws XML 파싱 오류 시 Error 발생 / Throws an Error on XML parse failure
      */
     static parse(xml: string, options?: XmlParseOptions): Record<string, any>[];
     /**
-     * 그리드 데이터 배열을 XML 문자열로 직렬화.
+     * 그리드 데이터 배열을 XML 문자열로 직렬화. / Serialize a grid-data array into an XML string.
+     *
+     * @param data - 직렬화할 행 배열 / Row array to serialize
+     * @param options - 직렬화 옵션 / Serialize options
+     * @returns XML 문자열 / XML string
      */
     static stringify(data: Record<string, any>[], options?: XmlStringifyOptions): string;
     /**
      * SAP BAPI XML 응답을 파싱하여 { header, items, returns } 구조로 반환.
+     * / Parse a SAP BAPI XML response into a { header, items, returns } structure.
      *
-     * 지원 패턴:
+     * 지원 패턴 / Supported patterns:
      *   <DOCUMENTHEADER>...</DOCUMENTHEADER>
      *   <ACCOUNTGL><ITEM>...</ITEM></ACCOUNTGL>
      *   <RETURN><TYPE>S</TYPE><MESSAGE>...</MESSAGE></RETURN>
+     *
+     * @param xml - SAP BAPI XML 응답 문자열 / SAP BAPI XML response string
+     * @returns 파싱 결과 구조 / Parsed result structure
      */
     static parseSap(xml: string): SapParseResult;
     /**
-     * BAPI 페이로드 객체를 SAP XML 형식으로 직렬화.
-     * sapGenPayload()의 결과 또는 단일 document 객체를 받음.
+     * BAPI 페이로드 객체를 SAP XML 형식으로 직렬화. sapGenPayload() 결과 또는 단일 document 객체를 받음.
+     * / Serialize a BAPI payload object into SAP XML. Accepts a sapGenPayload() result or a single document object.
+     *
+     * @param payload - BAPI 페이로드 객체 / BAPI payload object
+     * @returns SAP XML 문자열 / SAP XML string
      */
     static stringifySap(payload: {
         BAPI_FUNCTION?: string;
@@ -77,8 +107,11 @@ export declare class XmlConverter {
         [key: string]: any;
     }): string;
     /**
-     * sapGenPayload()의 { totalDocuments, documents[] } 결과를
-     * 다건 BAPI XML로 직렬화.
+     * sapGenPayload() 의 { totalDocuments, documents[] } 결과를 다건 BAPI XML 로 직렬화.
+     * / Serialize a sapGenPayload() { totalDocuments, documents[] } result into a multi-document BAPI XML.
+     *
+     * @param payload - documents 배열을 담은 페이로드 / Payload holding the documents array
+     * @returns 다건 BAPI XML 문자열 / Multi-document BAPI XML string
      */
     static stringifySapBatch(payload: {
         documents: any[];