open-grid 0.2.0

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

@@ -0,0 +1,35 @@
+/**
+ * 셀 병합 관리 엔진.
+ *
+ * 두 가지 병합 방식 지원:
+ *  1. 동적 병합: mergeCells([{row, col, rowSpan, colSpan}])
+ *  2. 자동 병합: 같은 필드에 같은 값이 연속되면 자동으로 rowSpan
+ */
+export interface MergeCell {
+    row: number;
+    col: number;
+    rowSpan?: number;
+    colSpan?: number;
+}
+export interface MergeInfo {
+    rowSpan: number;
+    colSpan: number;
+    hidden: boolean;
+}
+export declare class MergeEngine {
+    private _map;
+    private static _key;
+    /** 수동 병합 정의 목록으로 맵 구성 */
+    applyMergeCells(cells: MergeCell[]): void;
+    /**
+     * 자동 병합: 지정 컬럼 인덱스 목록에 대해 연속 같은 값을 rowSpan으로 병합.
+     * data: 현재 표시 순서의 행 배열, colIndexes: 자동병합할 leaf 컬럼 인덱스
+     * fields: colIndexes[i] 에 대응하는 field 이름
+     */
+    applyAutoMerge(data: Record<string, any>[], colIndexes: number[], fields: string[]): void;
+    /** 셀 병합 정보 조회. 없으면 null */
+    getInfo(row: number, col: number): MergeInfo | null;
+    /** 병합 맵 초기화 */
+    clear(): void;
+    get isEmpty(): boolean;
+}

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

@@ -0,0 +1,49 @@
+export type OGDecimalLike = string | number | bigint | OGDecimal;
+export declare class OGDecimal {
+    private readonly _c;
+    private readonly _s;
+    constructor(coefficient: bigint, scale: number);
+    static from(value: OGDecimalLike): OGDecimal;
+    static zero(): OGDecimal;
+    static one(): OGDecimal;
+    private static _align;
+    add(other: OGDecimalLike): OGDecimal;
+    sub(other: OGDecimalLike): OGDecimal;
+    mul(other: OGDecimalLike): OGDecimal;
+    /**
+     * 나눗셈. precision = 결과 소수점 자리수 (기본 20).
+     * 수익 배분처럼 소수 수백 자리가 필요하면 precision을 높인다.
+     */
+    div(other: OGDecimalLike, precision?: number): OGDecimal;
+    /** 나머지 (정수 나머지와 동일한 개념을 소수에 적용) */
+    mod(other: OGDecimalLike): OGDecimal;
+    /** 부호 반전 */
+    neg(): OGDecimal;
+    /** 절댓값 */
+    abs(): OGDecimal;
+    eq(other: OGDecimalLike): boolean;
+    gt(other: OGDecimalLike): boolean;
+    lt(other: OGDecimalLike): boolean;
+    gte(other: OGDecimalLike): boolean;
+    lte(other: OGDecimalLike): boolean;
+    isZero(): boolean;
+    isNeg(): boolean;
+    isPos(): boolean;
+    /**
+     * 지정 소수점 자리수로 반올림(Half-up) 후 문자열 반환.
+     * 음원 배분 등 정확한 자리수 표시에 사용.
+     */
+    toFixed(dp: number): string;
+    /** 정규화(후행 0 제거) 후 최소 표현 문자열 반환 */
+    toString(): string;
+    /** number로 변환 (정밀도 손실 주의 — 표시 전용) */
+    toNumber(): number;
+    /** 정확한 합산 (내부적으로 BigInt 정수 연산) */
+    static sum(arr: OGDecimalLike[]): OGDecimal;
+    /** 정확한 평균. precision = 나눗셈 소수점 자리수 */
+    static avg(arr: OGDecimalLike[], precision?: number): OGDecimal;
+    /** 배열 최솟값 */
+    static min(arr: OGDecimalLike[]): OGDecimal;
+    /** 배열 최댓값 */
+    static max(arr: OGDecimalLike[]): OGDecimal;
+}

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

@@ -0,0 +1,213 @@
+import { EventEmitter } from './EventEmitter.js';
+import { FilterSelectConfig } from './FilterSelect.js';
+import { MergeCell } from './MergeEngine.js';
+import { GridOptions, OpenGridInstance, ColumnDef, SortItem, FilterItem, ExportOptions, Position, TriggerHandler, TriggerEvent } from './types.js';
+
+export declare class OpenGrid<T extends Record<string, any> = any> extends EventEmitter implements OpenGridInstance<T> {
+    private _container;
+    private _options;
+    private _data;
+    private _colLayout;
+    private _vs;
+    private _ro;
+    private _renderer;
+    private _sfMgr;
+    private _rowMgr;
+    private _editMgr;
+    private _trigMgr;
+    private _destroyed;
+    private _colWidths;
+    private _filterPanel;
+    private _filterSelect;
+    private _pagination;
+    private _dnd;
+    private _mergeEngine;
+    private _liveRegion;
+    private _ctxMenu;
+    private _cmHandler;
+    private _cmKbdHandler;
+    private _wsManager;
+    private _exportMgr;
+    private _footerMgr;
+    private _kbdMgr;
+    private _findMgr;
+    private _grpMgr;
+    private _cellEvt;
+    constructor(container: string | HTMLElement, options: GridOptions<T>);
+    private _mount;
+    private _initContextMenu;
+    openContextMenu(e: MouseEvent, items?: import('./types').ContextMenuItem[]): void;
+    closeContextMenu(): void;
+    setFilterSelect(config: FilterSelectConfig | null): void;
+    setOptions(opts: Partial<GridOptions<T>>): void;
+    /**
+     * 컬럼 마스킹 ON/OFF 전환.
+     * enabled=true  → 마스킹 적용 (기본 상태)
+     * enabled=false → 컬럼 전체 마스킹 해제 (원문 표시)
+     */
+    setMaskEnabled(field: string, enabled: boolean): void;
+    /** 현재 컬럼 마스킹 활성 여부 반환. true=마스킹 중, false=해제됨 */
+    getMaskEnabled(field: string): boolean;
+    private _initWorksheets;
+    addWorksheet(name: string, columns?: import('./types').ColumnDef<T>[], data?: T[]): void;
+    removeWorksheet(name: string): void;
+    switchWorksheet(name: string): void;
+    renameWorksheet(oldName: string, newName: string): void;
+    getWorksheet(name: string): import('./types').WorksheetState<T> | undefined;
+    getWorksheetNames(): string[];
+    exportSheetsExcel(filename?: string): void;
+    private _paginationHeight;
+    private _onResize;
+    private _recalcWidths;
+    private _renderHeader;
+    private _doRender;
+    private _handleGroupToggle;
+    private _visRange;
+    private _visCount;
+    private _handleSortClick;
+    private _isToggleCol;
+    private _handleCellClick;
+    private _handleCellDblClick;
+    private _handleCellMouseOver;
+    private _handleCellMouseOut;
+    private _handleCellMouseDown;
+    private _handleCellMouseUp;
+    private _handleCellMouseMove;
+    private _handleCellKeyEvt;
+    private _handleRowCheck;
+    private _handleFilterIconClick;
+    private _handleAllCheck;
+    private _handleRowDrop;
+    /** 행을 드롭으로 이동할 때 실행된다 */
+    /** ???꾩튂 ?대룞 */
+    reorderRow(fromIndex: number, toIndex: number): void;
+    private _handleColResize;
+    private _handleKeyDown;
+    private _setFocusCell;
+    private _announce;
+    private _bindOptionEvents;
+    setData(data: T[]): void;
+    getData(): T[];
+    getSourceRows(): T[];
+    pushData(data: T[]): void;
+    prefixData(data: T[]): void;
+    clearData(): void;
+    insertRow(item: Partial<T>, position?: Position): void;
+    pushRow(items: Partial<T> | Partial<T>[]): void;
+    /** @deprecated 하위호환 alias → pushRow */
+    appendRows(items: Partial<T> | Partial<T>[]): void;
+    unshiftRow(items: Partial<T> | Partial<T>[]): void;
+    /** @deprecated 하위호환 alias → unshiftRow */
+    prependRows(items: Partial<T> | Partial<T>[]): void;
+    deleteRow(rowIndex: number | number[]): void;
+    deleteById(_ids: string[]): void;
+    readCell(rowIndex: number, field: string): any;
+    getDisplayValue(rowIndex: number, field: string): string;
+    writeCell(rowIndex: number, field: string, value: any): void;
+    getRowAt(rowIndex: number): T;
+    getChanges(): {
+        added: T[];
+        edited: T[];
+        removed: T[];
+    };
+    getEditedRows(): T[];
+    getChangedRows(): T[];
+    getChangedColumns(): Array<{
+        row: T;
+        fields: string[];
+        diff: Array<{
+            field: string;
+            oldValue: any;
+            newValue: any;
+        }>;
+    }>;
+    getAddedRows(): T[];
+    getRemovedRows(): T[];
+    getOriginalRow(rowIndex: number): T | undefined;
+    getRowsWithState(stateField: string): T[];
+    undo(): void;
+    redo(): void;
+    clearHistory(): void;
+    getColumnDefs(): ColumnDef<T>[];
+    getAllColumnDefs(): ColumnDef<T>[];
+    getColumnCount(): number;
+    applyColumns(columns: ColumnDef<T>[]): void;
+    insertColumn(colDef: ColumnDef<T>, position?: Position): void;
+    deleteColumn(field: string): void;
+    private _reorderColumn;
+    hideColumn(field: string | string[]): void;
+    showColumn(field: string | string[]): void;
+    getColumnIndex(field: string): number;
+    getFieldAt(idx: number): string;
+    getColValues(field: string, _all?: boolean): any[];
+    getUniqueValues(field: string, all?: boolean): any[];
+    setColWidths(_widths: number[]): void;
+    calcColWidths(_fitToGrid?: boolean): number[];
+    getSelections(): T[];
+    getActiveRow(): number;
+    activate(index: number): void;
+    deselect(): void;
+    getChecked(): Array<{
+        row: T;
+        rowIndex: number;
+    }>;
+    getAllChecked(): T[];
+    checkById(_ids: string[]): void;
+    addCheckById(_ids: string[]): void;
+    checkByValue(field: string, values: any[]): void;
+    uncheckById(_ids: string[]): void;
+    uncheckAll(): void;
+    orderBy(fieldOrList: string | SortItem[], dir?: 'asc' | 'desc'): void;
+    resetOrder(): void;
+    setFilter(field: string, filterItems: FilterItem[]): void;
+    resetFilter(field?: string): void;
+    getFilterState(): Record<string, FilterItem[]>;
+    restoreFilter(state: Record<string, FilterItem[]>): void;
+    private _applyFilters;
+    freeze(n: number): void;
+    /** ?섎룞 蹂묓빀: [{row, col, rowSpan?, colSpan?}] */
+    mergeCells(cells: MergeCell[]): void;
+    /** 자동 병합: 지정 필드 컬럼에서 연속 같은 값을 rowSpan으로 묶는다 */
+    /** ?먮룞 蹂묓빀: 吏€??field 而щ읆?먯꽌 ?곗냽 媛숈? 媛믪쓣 rowSpan */
+    autoMerge(fields: string[]): void;
+    /** 蹂묓빀 ?댁젣 */
+    clearMerge(): void;
+    freezeRows(_n: number): void;
+    groupBy(fields: string[]): void;
+    clearGroup(): void;
+    expandAll(): void;
+    collapseAll(): void;
+    enableTree(): void;
+    disableTree(): void;
+    expandNodes(ids: any | any[], open?: boolean): void;
+    expandAllNodes(): void;
+    collapseAllNodes(): void;
+    addTreeRow(_item: Partial<T>, _pid: string, _pos?: Position): void;
+    exportExcel(options?: ExportOptions | string): void;
+    exportCsv(options?: ExportOptions | string): void;
+    exportJson(options?: ExportOptions | string): void;
+    print(options?: {
+        title?: string;
+        excludeFields?: string[];
+    }): void;
+    toArray(keyValue?: boolean): any[];
+    jumpToRow(rowIndex: number): void;
+    jumpToCol(_field: string): void;
+    getScrollPos(): {
+        x: number;
+        y: number;
+    };
+    setFooter(fd: any[]): void;
+    getFooterData(): any[];
+    getFooterValue(field: string): any;
+    private _renderFooterEl;
+    resize(w?: number, h?: number): void;
+    setTheme(theme: string): void;
+    setThemeVar(k: string, v: string): void;
+    addTrigger(event: TriggerEvent | string, handler: TriggerHandler): this;
+    removeTrigger(event: TriggerEvent | string, handler: TriggerHandler): this;
+    clearTriggers(event?: TriggerEvent | string): this;
+    private _mkCtx;
+    private _trig;
+    destroy(): void;
+}

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

@@ -0,0 +1,35 @@
+export interface OrgChartColumnDef {
+    field: string;
+    className?: string;
+    style?: string | ((value: any, row: Record<string, any>) => string);
+    renderer?: (value: any, row: Record<string, any>) => HTMLElement | string;
+}
+export interface OrgChartOptions {
+    idField: string;
+    parentIdField: string;
+    columns: OrgChartColumnDef[];
+    nodeWidth?: number;
+    nodeHeight?: number;
+    levelGap?: number;
+    siblingGap?: number;
+    expandOnLoad?: boolean;
+    onNodeClick?: (id: any, data: Record<string, any>) => void;
+}
+export declare class OrgChart {
+    private _container;
+    private _opts;
+    private _data;
+    private _roots;
+    private _expandedKeys;
+    private _selectedId;
+    constructor(selector: string | HTMLElement, opts: OrgChartOptions);
+    setData(data: Record<string, any>[]): void;
+    setTheme(theme: string): void;
+    expandAll(): void;
+    collapseAll(): void;
+    private _toggle;
+    private _rebuild;
+    private _calcLayout;
+    private _line;
+    private _render;
+}

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

@@ -0,0 +1,34 @@
+export interface PageChangeEvent {
+    page: number;
+    pageSize: number;
+    totalRows: number;
+    totalPages: number;
+}
+export type PageChangeFn = (e: PageChangeEvent) => void;
+/**
+ * 그리드 하단 페이지네이션 UI + 상태 관리.
+ * DataLayer의 _displayIndexes 슬라이싱을 담당.
+ */
+export declare class Pagination {
+    private _el;
+    private _page;
+    private _pageSize;
+    private _totalRows;
+    private _onChange;
+    constructor(container: HTMLElement, pageSize: number, onChange: PageChangeFn);
+    get page(): number;
+    get pageSize(): number;
+    get totalPages(): number;
+    /** 전체 행 수 갱신 → 현재 페이지 유효성 검사 후 재렌더 */
+    setTotalRows(n: number): void;
+    setPageSize(size: number): void;
+    goTo(page: number): void;
+    /** 현재 페이지의 [startIndex, endIndex] 반환 (DataLayer 인덱스 기준) */
+    getRange(): {
+        start: number;
+        end: number;
+    };
+    private _emit;
+    private _render;
+    destroy(): void;
+}

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

@@ -0,0 +1,20 @@
+import { ColumnDef } from './types.js';
+
+export type PivotAgg = 'SUM' | 'COUNT' | 'AVG' | 'MIN' | 'MAX';
+export interface PivotConfig {
+    rowFields: string[];
+    colFields: string[];
+    valueFields: string[];
+    agg?: PivotAgg;
+    format?: string;
+}
+export interface PivotResult {
+    columns: ColumnDef[];
+    data: any[];
+    colKeys: string[][];
+}
+export declare class PivotEngine {
+    compute(data: any[], config: PivotConfig): PivotResult;
+    private _cartesian;
+    private _aggregate;
+}

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

@@ -0,0 +1,18 @@
+export type RowDropCallback = (fromIndex: number, toIndex: number) => void;
+/**
+ * 행 드래그앤드롭 관리자.
+ * 행 DOM에 드래그 핸들을 심고, 드롭 위치를 표시한 뒤 콜백으로 알림.
+ */
+export declare class RowDragDrop {
+    private _drag;
+    private _onDrop;
+    private _bodyEl;
+    private _rowHeight;
+    constructor(bodyEl: HTMLElement, rowHeight: number, onDrop: RowDropCallback);
+    /** 행 엘리먼트에 드래그 핸들 삽입 */
+    attachHandle(rowEl: HTMLElement, rowIndex: number, totalRows: number): HTMLElement;
+    private _startDrag;
+    private _onMouseMove;
+    private _onMouseUp;
+    destroy(): void;
+}

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

@@ -0,0 +1,30 @@
+import { DataLayer } from './DataLayer.js';
+
+export declare class RowManager<T extends Record<string, any> = any> {
+    private _selectedRows;
+    private _checkedRows;
+    private _data;
+    constructor(data: DataLayer<T>);
+    get selectedRows(): Set<number>;
+    get checkedRows(): Set<number>;
+    selectSingle(ri: number): void;
+    selectToggle(ri: number): void;
+    clearSelection(): void;
+    check(ri: number, checked: boolean): void;
+    checkAll(checked: boolean, totalRows: number): void;
+    checkByValue(field: string, values: any[]): void;
+    uncheckAll(): void;
+    checkById(_ids: string[]): void;
+    addCheckById(_ids: string[]): void;
+    uncheckById(_ids: string[]): void;
+    getSelections(): T[];
+    getChecked(): Array<{
+        row: T;
+        rowIndex: number;
+    }>;
+    getAllChecked(): T[];
+    getActiveRow(): number;
+    activate(index: number): void;
+    deselect(): void;
+    reset(): void;
+}

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

@@ -0,0 +1,36 @@
+import { DataLayer } from './DataLayer.js';
+import { ColumnLayout } from './ColumnLayout.js';
+import { VirtualScroll } from './VirtualScroll.js';
+import { Pagination } from './Pagination.js';
+import { SortItem, FilterItem } from './types.js';
+
+export interface SortFilterDeps<T extends Record<string, any>> {
+    getData: () => DataLayer<T>;
+    getColLayout: () => ColumnLayout<T>;
+    getFindFilter: () => string;
+    getVs: () => VirtualScroll | null;
+    getPagination: () => Pagination | null;
+    getOptions: () => any;
+    renderHeader: () => void;
+    doRender: () => void;
+    announce: (msg: string) => void;
+    emit: (event: string, ...args: any[]) => void;
+}
+export declare class SortFilterManager<T extends Record<string, any> = any> {
+    private _sortList;
+    private _filters;
+    private _d;
+    constructor(deps: SortFilterDeps<T>);
+    get sortList(): SortItem[];
+    get filters(): Record<string, FilterItem[]>;
+    handleSortClick(field: string, shiftKey: boolean): void;
+    sort(fieldOrList: string | SortItem[], dir?: 'asc' | 'desc'): void;
+    resetSort(): void;
+    initSort(sortList: SortItem[]): void;
+    getSortState(): SortItem[];
+    setFilter(field: string, filterItems: FilterItem[]): void;
+    resetFilter(field?: string): void;
+    getFilterState(): Record<string, FilterItem[]>;
+    restoreFilter(state: Record<string, FilterItem[]>): void;
+    applyFilters(): void;
+}

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

@@ -0,0 +1,34 @@
+export interface TreeNode<T = any> {
+    _isTree: true;
+    _treeId: any;
+    _treeParentId: any;
+    _depth: number;
+    _expanded: boolean;
+    _hasChildren: boolean;
+    _childCount: number;
+    _isLastChild: boolean;
+    _ancestorHasMore: boolean[];
+    data: T;
+    children: TreeNode<T>[];
+}
+export type TreeItem<T> = TreeNode<T>;
+export declare function isTreeNode<T>(item: any): item is TreeNode<T>;
+export interface TreeBuildOptions {
+    idField: string;
+    parentIdField: string;
+    expandOnLoad?: boolean;
+}
+/**
+ * flat 데이터를 트리 구조로 변환.
+ * parentId가 null/undefined/''인 행이 루트 노드.
+ */
+export declare function buildTree<T extends Record<string, any>>(data: T[], opts: TreeBuildOptions, expandedKeys?: Set<any>): TreeNode<T>[];
+/**
+ * 트리를 화면에 표시할 flat 배열로 변환.
+ * 접힌 노드(_expanded=false)의 자식은 제외.
+ */
+export declare function flattenTree<T>(nodes: TreeNode<T>[]): TreeNode<T>[];
+/** 특정 id 노드의 펼침 상태 토글 */
+export declare function toggleTreeNode<T>(expandedKeys: Set<any>, nodeId: any): void;
+/** 모든 노드 id 수집 */
+export declare function collectAllTreeIds<T>(nodes: TreeNode<T>[]): any[];

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

@@ -0,0 +1,10 @@
+import { TriggerContext, TriggerHandler, TriggerEvent } from './types.js';
+
+export declare class TriggerManager {
+    private _triggers;
+    add(event: TriggerEvent | string, handler: TriggerHandler): void;
+    remove(event: TriggerEvent | string, handler: TriggerHandler): void;
+    clear(event?: TriggerEvent | string): void;
+    mkCtx(operation: string, args: any[]): TriggerContext;
+    exec(event: string, ctx: TriggerContext): boolean;
+}

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

@@ -0,0 +1,31 @@
+export interface VirtualScrollOptions {
+    rowHeight: number;
+    overscan?: number;
+    onRender: (startIndex: number, endIndex: number) => void;
+}
+export interface VirtualScrollRange {
+    startIndex: number;
+    endIndex: number;
+    offsetY: number;
+}
+export declare class VirtualScroll {
+    private container;
+    private rowHeight;
+    private overscan;
+    private _totalRows;
+    private _scrollTop;
+    private _viewportHeight;
+    private _rafId;
+    private onRender;
+    constructor(container: HTMLElement, options: VirtualScrollOptions);
+    private _onScroll;
+    private _scheduleRender;
+    getVisibleRange(): VirtualScrollRange;
+    setTotalRows(count: number): void;
+    setViewportHeight(height: number): void;
+    setRowHeight(height: number): void;
+    scrollToRow(rowIndex: number): void;
+    getTotalHeight(): number;
+    private _updateSpacerHeight;
+    destroy(): void;
+}

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

@@ -0,0 +1,24 @@
+import { ColumnDef, WorksheetState } from './types.js';
+
+export type SwitchCallback<T> = (name: string, state: WorksheetState<T>) => void;
+export declare class WorksheetManager<T extends Record<string, any> = any> {
+    private _sheets;
+    private _active;
+    private _tabBar;
+    private _onSwitch;
+    constructor(container: HTMLElement, onSwitch: SwitchCallback<T>);
+    add(name: string, columns?: ColumnDef<T>[], data?: T[]): void;
+    remove(name: string): void;
+    rename(oldName: string, newName: string): void;
+    switch(name: string): void;
+    get(name: string): WorksheetState<T> | undefined;
+    getNames(): string[];
+    getActive(): string;
+    /** 현재 활성 시트의 data를 갱신 (그리드 편집 동기화용) */
+    syncData(name: string, data: T[]): void;
+    destroy(): void;
+    private _buildTabBar;
+    private _renderTabs;
+    /** 탭 더블클릭 → input으로 전환해 이름 변경 */
+    private _startRename;
+}

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

@@ -0,0 +1,88 @@
+/**
+ * XmlConverter — XML ↔ 그리드 데이터 양방향 변환 유틸리티.
+ *
+ * 지원 포맷:
+ *   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 사용.
+ */
+export interface XmlParseOptions {
+    /** 루트 엘리먼트 태그명 (생략 시 문서 루트 자동 사용) */
+    rootTag?: string;
+    /** 행 엘리먼트 태그명 (생략 시 루트의 첫 번째 자식 자동 감지) */
+    rowTag?: string;
+    /** 값 추출 방식: 'element' | 'attribute' | 'auto'(기본) */
+    mode?: 'element' | 'attribute' | 'auto';
+    /** XML 태그명 → 그리드 field명 매핑 (생략 시 태그명 그대로 사용) */
+    fieldMap?: Record<string, string>;
+    /** 텍스트 값 앞뒤 공백 제거 (기본 true) */
+    trim?: boolean;
+}
+export interface XmlStringifyOptions {
+    /** 루트 태그명 (기본 'rows') */
+    rootTag?: string;
+    /** 행 태그명 (기본 'row') */
+    rowTag?: string;
+    /** 출력 방식: 'element'(기본) | 'attribute' */
+    mode?: 'element' | 'attribute';
+    /** 그리드 field명 → XML 태그명 매핑 */
+    fieldMap?: Record<string, string>;
+    /** XML 선언부 포함 여부 (기본 true) */
+    declaration?: boolean;
+    /** 들여쓰기 공백 수 (기본 2) */
+    indent?: number;
+    /** null/undefined 처리 문자열 (기본 '') */
+    nullAs?: string;
+    /** 출력에서 제외할 필드 목록 */
+    excludeFields?: string[];
+}
+export interface SapParseResult {
+    header: Record<string, string>;
+    items: Record<string, string>[];
+    returns: Record<string, string>[];
+    raw?: Document;
+}
+export declare class XmlConverter {
+    /**
+     * XML 문자열을 파싱하여 그리드 데이터 배열로 변환.
+     * Element / Attribute 방식 자동 감지.
+     *
+     * @throws XML 파싱 오류 시 Error 발생
+     */
+    static parse(xml: string, options?: XmlParseOptions): Record<string, any>[];
+    /**
+     * 그리드 데이터 배열을 XML 문자열로 직렬화.
+     */
+    static stringify(data: Record<string, any>[], options?: XmlStringifyOptions): string;
+    /**
+     * SAP BAPI XML 응답을 파싱하여 { header, items, returns } 구조로 반환.
+     *
+     * 지원 패턴:
+     *   <DOCUMENTHEADER>...</DOCUMENTHEADER>
+     *   <ACCOUNTGL><ITEM>...</ITEM></ACCOUNTGL>
+     *   <RETURN><TYPE>S</TYPE><MESSAGE>...</MESSAGE></RETURN>
+     */
+    static parseSap(xml: string): SapParseResult;
+    /**
+     * BAPI 페이로드 객체를 SAP XML 형식으로 직렬화.
+     * sapGenPayload()의 결과 또는 단일 document 객체를 받음.
+     */
+    static stringifySap(payload: {
+        BAPI_FUNCTION?: string;
+        DOCUMENTHEADER?: Record<string, any>;
+        ACCOUNTGL?: Record<string, any>[];
+        [key: string]: any;
+    }): string;
+    /**
+     * sapGenPayload()의 { totalDocuments, documents[] } 결과를
+     * 다건 BAPI XML로 직렬화.
+     */
+    static stringifySapBatch(payload: {
+        documents: any[];
+    }): string;
+    private static _escText;
+    private static _escAttr;
+}