@vmscloud/moz-ui-grid-vue 0.1.41

package/dist/legacy/types/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Excel 관련 타입 및 파라미터 barrel export
+ * - 기존 types/ 디렉토리의 개별 파일(pivot-props, props, slots 등)은
+ *   직접 import 경로가 안정적이라 별도 re-export 하지 않습니다.
+ */
+export type { IExcelInfo, IExcelAPI, AdditionalColumn } from './excel.types';
+export { DataType } from './excel.types';
+export { default as FileParameter } from './FileParameter';
+export { default as StreamingParameter } from './StreamingParameter';
+export type { SystemType } from './core';

package/dist/legacy/types/pivot-props.d.ts

@@ -0,0 +1,140 @@
+import { PivotRowField, PivotColumnField, PivotValueField, PivotFilterField, FieldDef, RowSelectionConfig, CellSelectionConfig } from '../../../../moz-ui-grid-core/src/index.ts';
+import { IContextMenuConfig } from './toolbar';
+/** PivotGrid 컴포넌트 Props */
+export interface PivotGridProps {
+    /** 레이아웃 식별자 (프리셋 저장/복원용, useUserLayoutModule 연동) */
+    name?: string;
+    /** 데이터 배열 */
+    data?: Record<string, unknown>[];
+    /** 피벗 행 필드 정의 */
+    rowFields: PivotRowField[];
+    /** 피벗 열 필드 정의 */
+    columnFields: PivotColumnField[];
+    /** 피벗 값 필드 정의 */
+    valueFields: PivotValueField[];
+    /** 그리드 높이 (CSS 값) */
+    height?: string | number;
+    /** 행 소계 표시 여부 */
+    showRowSubTotals?: boolean;
+    /** 행 총계 표시 여부 */
+    showRowGrandTotals?: boolean;
+    /** 열 소계 표시 여부 */
+    showColumnSubTotals?: boolean;
+    /** 열 총계 표시 여부 */
+    showColumnGrandTotals?: boolean;
+    /** 원본 행 추적 여부 */
+    trackSourceRows?: boolean;
+    /** 헤더 표시 여부 (기본: true) */
+    showHeader?: boolean;
+    /** 줄무늬 행 (기본: false) */
+    alternatingRows?: boolean;
+    /** 툴팁 모드 (기본: 'none') */
+    tooltipMode?: 'none' | 'overflow' | 'always';
+    /**
+     * 행 선택 설정 — `cellSelection`과 독립.
+     * 둘 다 미지정 시 코어 기본값은 `cellSelection: { mode: 'range' }`.
+     */
+    rowSelection?: RowSelectionConfig;
+    /**
+     * 셀 선택 설정 — `rowSelection`과 독립.
+     */
+    cellSelection?: CellSelectionConfig;
+    /**
+     * 셀 선택이 행 선택을 함의하는지 (Policy B fallback). 기본 false.
+     */
+    cellSelectionImpliesRows?: boolean;
+    /** 툴박스 표시 (기본: true) */
+    useToolBox?: boolean;
+    /** 툴박스 설정(톱니바퀴) 버튼 표시 (기본: true) */
+    useToolBoxSetting?: boolean;
+    /** 필터 버튼 표시 (기본: true) */
+    useFilter?: boolean;
+    /** 정렬 버튼 표시 (기본: true) */
+    useSort?: boolean;
+    /** 조건부 스타일 버튼 표시 (기본: true) */
+    useCustomCell?: boolean;
+    /** 푸터 표시 (기본: true) */
+    useExtendFooter?: boolean;
+    /** 집계 푸터 표시 (기본: false) */
+    useSummaryFooter?: boolean;
+    /** 컨텍스트 메뉴 사용 여부 (기본: true) */
+    useContextMenu?: boolean;
+    /** 컨텍스트 메뉴 설정 (엑셀 import/export 등) */
+    contextMenuConfig?: IContextMenuConfig;
+    /** 차트 버튼 표시 여부 (기본: false) */
+    useChart?: boolean;
+    /**
+     * 사용 가능한 전체 필드 정의 (FieldDef[]).
+     * 제공 시 `availableFields` / data[0] 추론보다 우선 사용됩니다.
+     */
+    fields?: FieldDef[];
+    /** 사용 가능한 전체 필드 목록 (제공 시 data[0] 추론 대신 사용) */
+    availableFields?: AvailableField[];
+    /** Multiple 차트 사용 여부 (기본: true) */
+    useMultipleChart?: boolean;
+    /** Grand Total 차트 포함 여부 (기본: false) */
+    chartIncludeGrandTotal?: boolean;
+    /** 시리즈별 차트 타입/색상 설정 */
+    chartMap?: Record<string, {
+        type?: 'bar' | 'line' | 'lineSymbols' | 'area';
+        color?: string;
+    }>;
+    /** 로딩 상태 표시 (기본: false) */
+    loading?: boolean;
+    /** 빈 상태 설정 — 객체를 넘겨야 EmptyState가 활성화됨 (레거시 ExtendPivotGrid와 동일한 opt-in) */
+    emptyState?: {
+        /** 커스텀 빈 상태 (customState 슬롯 사용) */
+        isCustomState?: boolean;
+        headerMsg?: string;
+        contentMsg?: string;
+        useImg?: boolean;
+        /** 빈 상태 이미지 강제 지정 (생략 시 totalRowCount/filteredRowCount로 자동 결정) */
+        selectImg?: 'Custom' | 'Result' | 'Data' | 'Search';
+    };
+}
+/** PivotOptionModal에서 사용하는 필드 항목 */
+export interface PivotFieldItem {
+    /** 필드명 */
+    field: string;
+    /** 표시 헤더 */
+    header?: string;
+    /** 필드가 속한 영역 */
+    area: 'row' | 'column' | 'value' | 'filter';
+    /** 값 필드인 경우 집계 함수 */
+    aggregate?: string;
+}
+/** 사용 가능한 필드 (데이터 키에서 추출) */
+export interface AvailableField {
+    /** 필드 키 */
+    field: string;
+    /** 표시 헤더 */
+    header: string;
+    /**
+     * 데이터 타입.
+     * `array` 는 PivotFieldPanel 의 `aggregatesFor` 분기에서 array 전용 집계 옵션
+     * (count/countAll/first/last) 만 노출하는 데 사용.
+     */
+    dataType: 'string' | 'number' | 'date' | 'boolean' | 'array';
+}
+/** PivotFieldPanel에서 관리하는 필드 설정 상태 */
+export interface PivotFieldPanelConfig {
+    rowFields: PivotRowField[];
+    columnFields: PivotColumnField[];
+    valueFields: PivotValueField[];
+    filterFields: PivotFilterField[];
+}
+/** PivotOptionModal 그리드 설정 payload */
+export interface PivotGridSettings {
+    showRowSubTotals: boolean;
+    showRowGrandTotals: boolean;
+    showColumnSubTotals: boolean;
+    showColumnGrandTotals: boolean;
+    rowSubTotalFields?: string[];
+    columnSubTotalFields?: string[];
+    totalsBeforeData: boolean;
+    showZeros: boolean;
+    /** 행 그룹 접기/펼치기 허용 여부 (default true) */
+    rowCollapsible: boolean;
+    /** 열 그룹 접기/펼치기 허용 여부 (default true) */
+    columnCollapsible: boolean;
+}

package/dist/legacy/types/props.d.ts

@@ -0,0 +1,176 @@
+import { FieldDef, PureSheetEventType, PivotRowField, PivotColumnField, PivotValueField, FormatRowCallback, PartialTranslationMap, GroupConfig, ColumnGroupDef, RowHeaderConfig, FieldRowTemplate, LoaderConfig, RowSelectionConfig, CellSelectionConfig, UndoStack } from '../../../../moz-ui-grid-core/src/index.ts';
+import { IContextMenuConfig } from './toolbar';
+/**
+ * MozGridVueCore Props
+ * PureSheet 엔진과의 bridge 역할에 필요한 핵심 Props.
+ */
+export interface MozGridVueCoreProps {
+    /** 컬럼 정의 (flat 모드 필수) */
+    fields: FieldDef[];
+    /** 데이터 배열 */
+    data?: Record<string, unknown>[];
+    /** 그리드 모드 (기본: 'flat') */
+    mode?: 'flat' | 'pivot';
+    /** 피벗 행 필드 (pivot 모드 전용) */
+    pivotRowFields?: PivotRowField[];
+    /** 피벗 열 필드 (pivot 모드 전용) */
+    pivotColumnFields?: PivotColumnField[];
+    /** 피벗 값 필드 (pivot 모드 전용) */
+    pivotValueFields?: PivotValueField[];
+    /** 그리드 높이 (CSS 값) */
+    height?: string | number;
+    /** 키 필드 (기본: ['id']) */
+    keyFields?: string[];
+    /** 테마 (기본: 'light') */
+    theme?: 'light' | 'dark' | 'auto';
+    /** 행 높이 (px) */
+    rowHeight?: number;
+    /** 헤더 높이 (px) */
+    headerHeight?: number;
+    /** 헤더 표시 여부 (기본: true) */
+    showHeader?: boolean;
+    /** 컬럼 리사이즈 (기본: true) */
+    resizableColumns?: boolean;
+    /** 컬럼 재정렬 (기본: true) */
+    reorderableColumns?: boolean;
+    /** @deprecated `rowHeader`를 사용하세요 (core가 warn 후 자동 매핑) */
+    showRowHeader?: boolean | {
+        width?: number;
+    };
+    /** 행 헤더 (구 showRowHeader) — 객체형으로 width/cellRenderer/headerRenderer 지정 */
+    rowHeader?: boolean | RowHeaderConfig;
+    /**
+     * 행 선택 설정 — `cellSelection`과 독립.
+     * 둘 다 미지정 시 코어 기본값은 `cellSelection: { mode: 'range' }` (셀 전용 Excel 스타일).
+     * @example { mode: 'multi' }                       // 행 헤더 트리거 자동 (셀 선택과 공존)
+     * @example { mode: 'multi', trigger: 'checkbox' }  // 체크박스 컬럼 트리거
+     */
+    rowSelection?: RowSelectionConfig;
+    /**
+     * 셀 선택 설정 — `rowSelection`과 독립.
+     * @example { mode: 'range' }
+     */
+    cellSelection?: CellSelectionConfig;
+    /**
+     * 셀 선택이 행 선택을 함의하는지 (Policy B fallback). 기본 false.
+     * @default false
+     */
+    cellSelectionImpliesRows?: boolean;
+    /** 편집 가능 (기본: false) */
+    editable?: boolean;
+    /** 툴팁 모드 (기본: 'none') */
+    tooltipMode?: 'none' | 'overflow' | 'always';
+    /** 줄무늬 행 (기본: false) */
+    alternatingRows?: boolean;
+    /** 컬럼 자동 맞춤 */
+    autoFitColumns?: boolean;
+    /** 동적 행 높이 (기본: false) */
+    dynamicRowHeights?: boolean;
+    /** 행 드래그 재정렬 (기본: false) */
+    reorderableRows?: boolean;
+    /** i18n 로케일 */
+    locale?: string;
+    /** 데이터 처리 엔진 (기본: 'native') */
+    engine?: 'aq' | 'native';
+    /** Web Worker 사용 여부 */
+    useWorker?: boolean;
+    /** Worker 데이터 로더 설정 (useWorker: true 시 사용) */
+    loader?: LoaderConfig;
+    /** 키 컬럼 편집 방지 (기본: false) */
+    preventKeyEdit?: boolean;
+    /** 상태 바 표시 여부 */
+    showStatusBar?: boolean;
+    /** 드래그 핸들 컬럼 표시 여부 */
+    showDragHandleColumn?: boolean;
+    /** 외부 Undo 스택 주입 */
+    undoStack?: InstanceType<typeof UndoStack>;
+    /** 행 포맷팅 콜백 */
+    formatRow?: FormatRowCallback;
+    /** 번역 오버라이드 */
+    translations?: PartialTranslationMap;
+    /** 행 CSS 스타일 */
+    rowStyle?: string;
+    /** 헤더 CSS 스타일 */
+    headerStyle?: string;
+    /** 행 높이 변경 감지 임계값 */
+    rowHeightChangeThreshold?: number;
+    /** 그룹화 설정 (flat 모드 전용) */
+    group?: GroupConfig;
+    /** 컬럼 그룹 — 다단계 헤더 (flat 모드 전용, 구 headerGroups) */
+    columnGroups?: ColumnGroupDef[];
+    /** Multi-Row 레이아웃 (flat 모드 전용) */
+    rowTemplate?: FieldRowTemplate;
+}
+/**
+ * MozGridVue 컴포넌트 Props
+ * Core Props + UI 옵션 (툴박스, 푸터, 컨텍스트 메뉴 등).
+ */
+export interface MozGridVueProps extends MozGridVueCoreProps {
+    /** 레이아웃 식별자 (프리셋 저장/복원용, useUserLayoutModule 연동) */
+    name?: string;
+    /** 툴박스 표시 (기본: true) */
+    useToolBox?: boolean;
+    /** 툴박스 설정(톱니바퀴) 버튼 표시 (기본: true) */
+    useToolBoxSetting?: boolean;
+    /** 푸터 표시 (기본: true) */
+    useExtendFooter?: boolean;
+    /** 집계 푸터 표시 (기본: false) */
+    useSummaryFooter?: boolean;
+    /** 정렬 버튼 표시 (기본: true) */
+    useSort?: boolean;
+    /** 조건부 스타일 버튼 표시 (기본: true) */
+    useCustomCell?: boolean;
+    /** 컨텍스트 메뉴 설정 */
+    contextMenuConfig?: IContextMenuConfig;
+    /** 컨텍스트 메뉴 사용 (기본: true) */
+    useContextMenu?: boolean;
+    /** 로딩 상태 표시 (기본: false) */
+    loading?: boolean;
+    /** 빈 상태 설정 — 객체를 넘겨야 EmptyState가 활성화됨 (레거시 ExtendFlexGrid와 동일한 opt-in) */
+    emptyState?: {
+        /** 커스텀 빈 상태 (customState 슬롯 사용) */
+        isCustomState?: boolean;
+        headerMsg?: string;
+        contentMsg?: string;
+        useImg?: boolean;
+        /** 빈 상태 이미지 강제 지정 (생략 시 totalRowCount/filteredRowCount로 자동 결정) */
+        selectImg?: 'Custom' | 'Result' | 'Data' | 'Search';
+    };
+}
+/** MozGridVue 컴포넌트 Emits */
+export interface MozGridVueEmits {
+    (e: 'ready', grid: unknown): void;
+    (e: 'data:loaded'): void;
+    (e: 'row:click', payload: unknown): void;
+    (e: 'row:dblclick', payload: unknown): void;
+    (e: 'row:pinned', payload: unknown): void;
+    (e: 'row:unpinned', payload: unknown): void;
+    (e: 'row:reordered', payload: unknown): void;
+    (e: 'cell:click', payload: unknown): void;
+    (e: 'cell:dblclick', payload: unknown): void;
+    (e: 'cell:change', payload: unknown): void;
+    (e: 'cell:beforeEdit', payload: unknown): void;
+    (e: 'cell:editCommitting', payload: unknown): void;
+    (e: 'cell:editCommitted', payload: unknown): void;
+    (e: 'cell:tooltip', payload: unknown): void;
+    (e: 'selection:changed', payload: unknown): void;
+    (e: 'column:resize', payload: unknown): void;
+    (e: 'column:reorder', payload: unknown): void;
+    (e: 'column:pin', payload: unknown): void;
+    (e: 'column:visibility', payload: unknown): void;
+    (e: 'sort:changed', payload: unknown): void;
+    (e: 'filter:changed', payload: unknown): void;
+    (e: 'scroll', payload: unknown): void;
+    (e: 'undo:stateChange', payload: unknown): void;
+    (e: 'clipboard:copy', payload: unknown): void;
+    (e: 'clipboard:paste', payload: unknown): void;
+    (e: 'validation:changed', payload: unknown): void;
+    (e: 'columnGroup:toggle', payload: unknown): void;
+    (e: 'contextmenu', payload: unknown): void;
+}
+/** Props → PureSheetConfig 변환에 사용하는 키 목록 */
+export declare const CONFIG_PROP_KEYS: readonly ["keyFields", "theme", "rowHeight", "headerHeight", "showHeader", "resizableColumns", "reorderableColumns", "showRowHeader", "rowHeader", "rowSelection", "cellSelection", "cellSelectionImpliesRows", "editable", "tooltipMode", "alternatingRows", "autoFitColumns", "dynamicRowHeights", "reorderableRows", "locale", "engine", "useWorker", "loader", "preventKeyEdit", "showStatusBar", "showDragHandleColumn", "undoStack", "formatRow", "translations", "rowStyle", "headerStyle", "rowHeightChangeThreshold"];
+/** flat 모드 전용 Props 키 목록 (pivot 모드에서는 제외) */
+export declare const FLAT_ONLY_PROP_KEYS: readonly ["group", "columnGroups", "rowTemplate"];
+/** emit으로 브릿지할 PureSheet 이벤트 목록 */
+export declare const BRIDGED_EVENTS: PureSheetEventType[];

package/dist/legacy/types/toolbar.d.ts

@@ -0,0 +1,225 @@
+/**
+ * Grid UI 타입 정의
+ *
+ * moz-wijmo-grid의 types.d.ts에서 포팅.
+ * ComparisonOperator, LogicalOperator, IFilterDef, ISortDef, ICustomCellRuleSet 등
+ * Wijmo 비의존 타입은 그대로 재사용합니다.
+ */
+/** 비교 연산자 */
+export type ComparisonOperator = '=' | '≠' | '%' | '!%' | '>' | '≥' | '<' | '≤' | '∅' | '●';
+/** 논리 연산자 */
+export type LogicalOperator = 'OR' | 'AND';
+/** 필터 조건 정의 */
+export interface IFilterDef {
+    /** 순서 */
+    sequence: number;
+    /** 컬럼 헤더 (표시용) */
+    header: string;
+    /** 컬럼 바인딩 키 (fieldId) */
+    binding: string;
+    /** 비교 연산자 */
+    comparison: ComparisonOperator;
+    /** 논리 연산자 (이전 조건과의 관계) */
+    logical?: LogicalOperator;
+    /** 데이터 타입 */
+    type?: 'string' | 'number' | 'boolean' | 'date';
+    /** 비교 값 */
+    variable: unknown;
+    /** between 연산자의 두 번째 값 */
+    variable2?: unknown;
+}
+/** 정렬 정의 */
+export interface ISortDef {
+    /** 순서 */
+    sequence: number;
+    /** 컬럼 헤더 (표시용) */
+    header: string;
+    /** 컬럼 바인딩 키 (fieldId) */
+    binding: string;
+    /** 오름차순 여부 */
+    ascending: boolean;
+    /** 피벗 값 기반 정렬 (GrandTotal 기준 값 필드 ID) */
+    byValue?: string;
+}
+/** 조건부 스타일 규칙 */
+export interface ICustomCellDef {
+    /** 순서 */
+    sequence: number;
+    /** 컬럼 헤더 */
+    header: string;
+    /** 컬럼 바인딩 키 */
+    binding: string;
+    /** 비교 연산자 */
+    comparison: ComparisonOperator;
+    /** 논리 연산자 */
+    logical?: LogicalOperator;
+    /** 데이터 타입 (Wijmo DataType 숫자 또는 문자열) */
+    type?: number | string;
+    /** 비교 값 */
+    variable: any;
+}
+/** 조건부 스타일 규칙셋 */
+export interface ICustomCellRuleSet {
+    /** 고유 ID */
+    id: string;
+    /** 규칙셋 이름 */
+    name?: string;
+    /** 우선순위 (낮을수록 먼저 적용, 높은 값이 덮어씀) */
+    priority: number;
+    /** 조건 모드: 'ui' (드롭다운 빌더) 또는 'formula' (수식 입력) */
+    mode?: 'ui' | 'formula';
+    /** 조건 규칙 목록 (UI 모드) */
+    rules: ICustomCellDef[];
+    /** 수식 문자열 (수식 모드) */
+    formula?: string;
+    /** 수식 검증 에러 메시지 */
+    formulaError?: string;
+    /** 배경색 */
+    backgroundColor: string;
+    /** 글꼴색 */
+    textColor: string;
+    /** 대상 컬럼 (비어있으면 전체 행) */
+    targetColumns?: string[];
+    /** 활성 여부 (기본: true) */
+    enabled?: boolean;
+}
+/** 조건부 스타일 전체 설정 */
+export interface ICustomCellConfig {
+    ruleSets: ICustomCellRuleSet[];
+}
+/**
+ * 사용자가 컬럼 옵션 패널에서 적용하는 시각 서식 단위 (정적 객체).
+ *
+ * 구조화된 shape — 각 키가 의미를 가짐. UI 컴포넌트와 1:1 바인딩.
+ * 미지정 키는 적용 안 됨 (기존 셀 스타일 그대로).
+ */
+export interface IColumnCellFormat {
+    /** CSS 색상 값 (`#FFE066`, `rgb(...)` 등) */
+    backgroundColor?: string;
+    color?: string;
+    fontWeight?: 'normal' | 'bold';
+    fontStyle?: 'normal' | 'italic';
+    textDecoration?: 'none' | 'underline';
+    /** CSS 폰트 크기 (예: '12px') */
+    fontSize?: string;
+    /** 추가 클래스 토큰 (사용자 정의 확장용) */
+    classes?: string[];
+}
+export interface IColumnHeaderFormat extends IColumnCellFormat {
+    /**
+     * 헤더 텍스트 정렬. 셀 정렬(`align`) 은 코어가 처리하지만 헤더는 wrapper layer 가
+     * inline style 로 적용 (헤더 셀이 flex container 라 `justifyContent` 도 동시 적용).
+     */
+    textAlign?: 'left' | 'center' | 'right';
+}
+/**
+ * 컬럼 옵션 패널이 관리하는 사용자 정의 시각 서식 전체 설정.
+ *
+ * - `cell[colId]` / `header[colId]` 키별로 부분 서식
+ * - 직렬화 가능 (함수 X)
+ * - `useColumnFormatter().config` 의 ref 타입
+ */
+export interface IColumnFormatConfig {
+    /** columnId → 사용자 셀 서식 */
+    cell: Record<string, IColumnCellFormat>;
+    /** columnId → 사용자 헤더 서식 */
+    header: Record<string, IColumnHeaderFormat>;
+}
+/** 컨텍스트 메뉴 항목 */
+export interface IContextMenuItem {
+    /** 메뉴 ID */
+    id: string;
+    /** 표시 텍스트 */
+    label: string;
+    /** 아이콘 */
+    icon?: string;
+    /** 비활성화 */
+    disabled?: boolean;
+    /** 구분선 */
+    separator?: boolean;
+    /** 하위 메뉴 */
+    children?: IContextMenuItem[];
+    /** 클릭 핸들러 */
+    handler?: () => void;
+    /**
+     * 메뉴 표시 순서 (낮을수록 위에 표시)
+     *
+     * 내장 메뉴와 커스텀 메뉴를 합친 후 이 값으로 정렬합니다.
+     * 미지정 시 기본값 50. 내장 메뉴: 필터/정렬=10, 복사=20, 고정=30, 내보내기=40
+     */
+    order?: number;
+}
+/** 컨텍스트 메뉴 설정 */
+export interface IContextMenuConfig {
+    /** 컬럼 선택 UI 표시 여부 (설정 모달 내) */
+    useViewSelectColumn?: boolean;
+    /** 고정 컬럼 메뉴 */
+    useFixedColumn?: boolean;
+    /** 그룹 메뉴 */
+    useGroupColumn?: boolean;
+    /** 컨텍스트 메뉴 활성화 */
+    useContextMenu?: boolean;
+    /** 정렬 메뉴 */
+    useSort?: boolean;
+    /** 필터 메뉴 */
+    useFilter?: boolean;
+    /** 조건부 스타일 메뉴 */
+    useCustomCell?: boolean;
+    /** 일괄 편집 메뉴 */
+    useBulkEditColumn?: boolean;
+    /** 데이터 복사 메뉴 */
+    useDataCopy?: boolean;
+    /** 헤더 포함 복사 메뉴 */
+    useDataWithHeaderCopy?: boolean;
+    /** 컬럼 자동 맞춤 메뉴 */
+    useAutoSizeColumns?: boolean;
+    /** CSV 내보내기 메뉴 */
+    useExportCsv?: boolean;
+    /** 행 고정(Pin) 메뉴 */
+    useRowPinning?: boolean;
+    /** 엑셀 가져오기/내보내기 메뉴 표시 (onImportExcel/onImportExcelAppend 콜백 필요) */
+    useExportImport?: boolean;
+    /** 엑셀 내보내기 메뉴 표시 (XLSX/CSV) */
+    useExportExcel?: boolean;
+    /** 엑셀 가져오기 — 덮어쓰기 모드 콜백 */
+    onImportExcel?: (ctx: IContextMenuExcelEventArgs) => void;
+    /** 엑셀 가져오기 — 추가 모드 콜백 */
+    onImportExcelAppend?: (ctx: IContextMenuExcelEventArgs) => void;
+    /** 엑셀 내보내기 — 서버 측 처리 콜백 (없으면 메뉴 비활성) */
+    onExportOriginalData?: (format: 'excel' | 'csv') => void;
+    /** 클라이언트 사이드 엑셀 가져오기 메뉴 활성화 (core grid.io.fromExcel 사용) */
+    useClientExcelImport?: boolean;
+    /** 클라이언트 사이드 엑셀 내보내기 메뉴 활성화 (core grid.io.toExcel 사용) */
+    useClientExcelExport?: boolean;
+    /** 원본(집계 전) 데이터 XLSX 내보내기 — core saveExcelToFile({exportSource:true}). 피벗/그룹/머지 무시. */
+    useExportOriginal?: boolean;
+    /** 클라이언트 import 기본 옵션 (mode/conflictStrategy/autoCommit 등) */
+    clientImportOptions?: Record<string, unknown>;
+    /** 클라이언트 export 기본 옵션 (scope/includeHeaders 등) */
+    clientExportOptions?: Record<string, unknown>;
+    /** 클라이언트 export 파일명 prefix (기본: 'export') */
+    exportFileName?: string;
+    /** 클라이언트 import 완료 후 콜백 */
+    onClientImportComplete?: (result: unknown) => void;
+    /** 클라이언트 export 완료 후 콜백 */
+    onClientExportComplete?: (blob: Blob) => void;
+    /** 커스텀 메뉴 항목 */
+    customMenu?: IContextMenuItem[];
+}
+/** 엑셀 가져오기 콜백에 전달되는 컨텍스트 */
+export interface IContextMenuExcelEventArgs {
+    /** PureSheet 인스턴스 */
+    grid: unknown;
+    /** 우클릭한 컬럼의 FieldDef (있을 경우) */
+    field?: unknown;
+}
+/** 집계 타입 */
+export type AggregateType = 'SUM' | 'AVERAGE' | 'COUNT' | 'MIN' | 'MAX';
+/** 푸터 집계 값 */
+export interface IAggregateValues {
+    SUM?: number;
+    AVERAGE?: number;
+    COUNT?: number;
+    MIN?: number;
+    MAX?: number;
+}

package/dist/legacy/utils/async/debounce.d.ts

@@ -0,0 +1,4 @@
+/**
+ * 특정 키에 대한 함수 호출을 디바운스하는 함수입니다.
+ */
+export declare const debounce: (key: string, callback: (...args: any[]) => void, wait: number) => void;

package/dist/legacy/utils/crypto/crypto.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 간단한 Base64 헬퍼.
+ * - moz-wijmo-grid에는 XOR/AES 암호화 유틸이 있지만, 엑셀 모듈에서는
+ *   `encodeUnescapeBtoa`만 사용하므로 crypto-js 의존성을 제거하고 최소화합니다.
+ */
+export declare const encodeUnescapeBtoa: (text?: string) => string;
+export declare const decodeEscapeAtob: (text?: string) => string;

package/dist/legacy/utils/dialog/dialog.d.ts

@@ -0,0 +1,19 @@
+type DialogIcon = 'error' | 'warning' | 'success' | 'info';
+type DialogAction = 'confirm' | 'save' | 'check' | 'close' | 'no-footer';
+export declare const showConfirm: (options: {
+    title?: string;
+    message: string;
+    type?: DialogIcon;
+}) => Promise<boolean>;
+export declare function showDialog(options: {
+    title?: string;
+    message: string;
+    preset?: DialogAction;
+    type?: DialogIcon;
+    actions?: {
+        positive?: string;
+        negative?: string;
+    };
+}): Promise<boolean>;
+export declare const showMessage: (message: any, result: boolean | DialogIcon, options?: Record<string, any>) => void;
+export {};

package/dist/legacy/utils/excel/ExcelGuard.d.ts

@@ -0,0 +1,73 @@
+/**
+ * ExcelGuard
+ *
+ * - 목적: 프런트엔드에서 유저당 동시 엑셀 업로드/다운로드를 1건으로 제한하기 위한 임시 가드
+ * - 동작: 단일 탭 인메모리 락으로만 제어 (크로스 탭/새로고침 복원 없음)
+ */
+/**
+ * 유저 식별 가능한 락 키 생성
+ * @param tenantId 테넌트 ID
+ * @param userId 사용자 ID
+ * @returns `${LOCK_PREFIX}:${tenantId}:${userId}` 형식의 키
+ */
+export declare const getUserLockKey: (tenantId?: string, userId?: string) => string;
+/**
+ * 현재 락 여부 확인
+ * - localStorage에 키가 있고, 만료되지 않았으면 true
+ * - 만료되었으면 정리 후 false
+ */
+export declare const isLocked: (key: string) => boolean;
+/**
+ * 락 설정 + 브로드캐스트 전파
+ * @param key getUserLockKey로 생성한 키
+ * @param sessionId 다운로드 세션 ID (진행 중인 다운로드 식별용)
+ * @param ttlMs 만료 시간(ms). 기본 5분: 서버 비정상 종료 등 대비
+ */
+export declare const lock: (key: string, sessionId: string, ttlMs?: number) => void;
+/**
+ * 락 해제 + 브로드캐스트 전파
+ * @param key getUserLockKey로 생성한 키
+ */
+export declare const unlock: (key: string) => void;
+/**
+ * 크로스 탭 동기화 초기화
+ * - excel_lock / excel_unlock 이벤트 수신 시 localStorage를 동기화
+ * - 한 번만 초기화되도록 가드
+ */
+/**
+ * 초기화 훅 (단일 탭 모드에서는 실질 동작 없음)
+ */
+export declare const initExcelGuard: () => void;
+/**
+ * 세션 목록 로컬 스토리지 키 생성
+ * @deprecated 크로스 탭/새로고침 동기화를 더 이상 지원하지 않습니다.
+ */
+export declare const getSessionsKey: (tenantId?: string, userId?: string) => string;
+/**
+ * 저장된 모든 세션 조회 (sessionId -> fileName)
+ * @deprecated 크로스 탭/새로고침 동기화를 더 이상 지원하지 않습니다.
+ */
+export declare const getAllSessions: (tenantId?: string, userId?: string) => Record<string, string>;
+/**
+ * 세션 저장 또는 업데이트
+ * @deprecated 단일 탭 모드에서는 세션이 로컬스토리지에 저장되지 않습니다.
+ */
+export declare const setSession: (_tenantId: string, _userId: string, _sessionId: string, _fileName: string, _operationType?: "upload" | "download") => void;
+/**
+ * 세션 파일명 업데이트
+ * @deprecated 단일 탭 모드에서는 세션이 로컬스토리지에 저장되지 않습니다.
+ */
+export declare const updateSessionFileName: (_tenantId: string, _userId: string, _sessionId: string, _fileName: string) => void;
+/**
+ * 세션 제거
+ * @deprecated 단일 탭 모드에서는 세션이 로컬스토리지에 저장되지 않습니다.
+ */
+export declare const removeSession: (_tenantId: string, _userId: string, _sessionId: string) => void;
+declare const _default: {
+    getUserLockKey: (tenantId?: string, userId?: string) => string;
+    isLocked: (key: string) => boolean;
+    lock: (key: string, sessionId: string, ttlMs?: number) => void;
+    unlock: (key: string) => void;
+    initExcelGuard: () => void;
+};
+export default _default;