@vmscloud/moz-ui-grid-react 0.1.19

package/dist/legacy/components/grid/toolbar/GridSetupPopover.d.ts

@@ -0,0 +1,25 @@
+import { ReactNode } from 'react';
+interface GridSetupPopoverProps {
+    /** trigger element. 클릭 시 popover 토글 */
+    trigger: ReactNode;
+    /** popover 내용 */
+    children: ReactNode;
+    /** 외부 제어 시 사용 (uncontrolled면 내부 상태) */
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+}
+export interface GridSetupPopoverHandle {
+    close: () => void;
+    toggle: () => void;
+}
+/**
+ * 설정 아이콘 바로 아래에 뜨는 popover.
+ *
+ * Tool Bar 보기 토글이 꺼져 ToolBox 컨테이너가 숨겨져도 popover 위치가 유지되도록
+ * Radix Popover 대신 자체 fixed-position 구현 + React Portal 사용.
+ * - trigger 클릭 시점에 좌표 측정 → state에 freeze
+ * - popover content는 document.body에 createPortal로 마운트 (ToolBox tree와 분리)
+ * - 외부 클릭 / Escape 키 / 리사이즈로 닫힘
+ */
+export declare const GridSetupPopover: import('react').ForwardRefExoticComponent<GridSetupPopoverProps & import('react').RefAttributes<GridSetupPopoverHandle>>;
+export {};

package/dist/legacy/components/grid/toolbar/GridToolBox.d.ts

@@ -0,0 +1,49 @@
+import { ReactNode } from 'react';
+import { GridOptionMenuItem } from './GridOptionModal';
+export interface GridToolBoxProps {
+    itemsLength?: number;
+    filterCount?: number;
+    sortCount?: number;
+    customCellCount?: number;
+    expanded?: boolean;
+    onExpandedChange?: (v: boolean) => void;
+    toolbarVisible?: boolean;
+    footerVisible?: boolean;
+    groupPanelVisible?: boolean;
+    onToolbarVisibleChange?: (v: boolean) => void;
+    onFooterVisibleChange?: (v: boolean) => void;
+    onGroupPanelVisibleChange?: (v: boolean) => void;
+    useToolBoxSetting?: boolean;
+    useSort?: boolean;
+    useCustomCell?: boolean;
+    /** 편집 모드 — Undo/Redo 버튼 표시 */
+    editable?: boolean;
+    /** CSV 내보내기 버튼 표시 */
+    useExportCsv?: boolean;
+    /** 열 표시/숨김 메뉴 사용 */
+    useViewSelectColumn?: boolean;
+    /** GridOptionModal 내 사용자 정의 메뉴 */
+    customMenu?: GridOptionMenuItem[];
+    onFilterClick?: () => void;
+    onSortClick?: () => void;
+    onCustomCellClick?: () => void;
+    onResetAllClick?: () => void;
+    onClickColumnPicker?: () => void;
+    onExportCsv?: () => void;
+    toolLeft?: ReactNode;
+    toolItems?: ReactNode;
+    toolItemsRight?: ReactNode;
+    toolBottom?: ReactNode;
+}
+/**
+ * Vue 측 GridToolBox.vue 1:1 포팅.
+ *
+ * 레이아웃 (height 50px, padding 8px 10px):
+ *   ┌───────────────────────────────────────────────────────────────┐
+ *   │ tool-left ……… [설정][필터][정렬][조건부][리셋] | [검색][△]    │
+ *   └───────────────────────────────────────────────────────────────┘
+ *
+ * 설정 클릭 시 설정 아이콘 바로 아래에 popover로 표시.
+ * 토글 접기 (△ → ▽)는 toolbar 자체를 숨김.
+ */
+export declare function GridToolBox(props: GridToolBoxProps): import("react/jsx-runtime").JSX.Element;

package/dist/legacy/components/pivot/MozPivotReact.d.ts

@@ -0,0 +1,47 @@
+import { PivotValueField, PivotFilterField } from '@vmscloud/moz-ui-grid-core';
+import { MozGridReactCoreHandle } from '../grid/MozGridReactCore';
+import { MozGridReactCoreProps } from '../../types/props';
+import { IContextMenuConfig } from '../../types/toolbar';
+import { PivotRowField, PivotColumnField, PivotFieldPanelConfig, AvailableField, PivotGridSettings } from '../../types/pivot-props';
+export interface PivotGridProps extends MozGridReactCoreProps {
+    pivotRowFields: PivotRowField[];
+    pivotColumnFields: PivotColumnField[];
+    pivotValueFields: PivotValueField[];
+    /** 필터 영역 필드 (현재 UI에선 미사용, 패널 라운드트립용) */
+    pivotFilterFields?: PivotFilterField[];
+    /** 사용 가능한 필드 목록 (PivotFieldPanel 좌측 목록) */
+    availableFields?: AvailableField[];
+    /** 피벗 설정 */
+    pivotSettings?: PivotGridSettings;
+    /** 설정 변경 (그리드 설정 popover에서) */
+    onUpdatePivotSettings?: (settings: PivotGridSettings) => void;
+    /** valueField 변경 (집계/형식/표시 방식) */
+    onUpdateValueField?: (payload: {
+        field: string;
+        changes: Partial<PivotValueField>;
+    }) => void;
+    /** PivotFieldPanel에서 필드 재배치 완료 — 호스트가 처리하지 않으면 내부에서 grid.pivot.setConfig로 자동 적용 */
+    onUpdateFieldPanelConfig?: (config: PivotFieldPanelConfig) => void;
+    /** 필드 패널 토글 콜백 (커스텀 동작이 필요하면 override; 미지정 시 내부 fieldPanelRef.show() 호출) */
+    onClickFieldPanel?: () => void;
+    /** ToolBox 옵션 (Vue PivotToolBox props 대응) */
+    useToolBoxSetting?: boolean;
+    useFilter?: boolean;
+    useSort?: boolean;
+    useCustomCell?: boolean;
+    useChart?: boolean;
+    chartActive?: boolean;
+    onClickChart?: () => void;
+    /** Multiple 모드 (행별 미니 차트) 활성. 기본 true. */
+    useMultipleChart?: boolean;
+    /** 차트 데이터에 Grand Total 포함. 기본 false. */
+    chartIncludeGrandTotal?: boolean;
+    /** 피벗 컨텍스트 메뉴 설정 (가져오기/내보내기 메뉴 등) */
+    contextMenuConfig?: IContextMenuConfig;
+}
+/**
+ * Vue 측 MozPivotVue.vue의 React 대응.
+ *
+ * Pivot 모드 MozGridReactCore + PivotToolBox + 설정 popover + 조건부 스타일 popup.
+ */
+export declare const MozPivotReact: import('react').ForwardRefExoticComponent<PivotGridProps & import('react').RefAttributes<MozGridReactCoreHandle>>;

package/dist/legacy/components/pivot/PivotContextMenu.d.ts

@@ -0,0 +1,23 @@
+import { ContextMenuContext, ContextMenuCallbacks } from '../../hooks/useContextMenu';
+import { IContextMenuConfig } from '../../types/toolbar';
+interface PivotContextMenuProps extends ContextMenuCallbacks {
+    config?: IContextMenuConfig;
+}
+export interface PivotContextMenuHandle {
+    open: (ctx: ContextMenuContext, position: {
+        left: number;
+        top: number;
+    }) => void;
+    close: () => void;
+}
+/**
+ * Vue 측 PivotContextMenu.vue 1:1 포팅.
+ *
+ * 피벗 그리드 전용 컨텍스트 메뉴. data cell에서만 표시되며 메뉴는:
+ *  - 필터 추가 / 선택값으로 필터링 / 열 필터 초기화
+ *  - 데이터 복사 / 헤더 포함 복사
+ *  - 가져오기 / 내보내기 (config에 따라 서브메뉴)
+ *  - 선택 영역 집계 표시 (template 슬롯)
+ */
+export declare const PivotContextMenu: import('react').ForwardRefExoticComponent<PivotContextMenuProps & import('react').RefAttributes<PivotContextMenuHandle>>;
+export {};

package/dist/legacy/components/pivot/PivotFieldChip.d.ts

@@ -0,0 +1,17 @@
+export interface PivotFieldChipProps {
+    field: string;
+    header?: string;
+    area: 'row' | 'column' | 'value' | 'filter';
+    aggregate?: string;
+    /** 현재 칩이 설정 팝업의 대상인지 (톱니바퀴 색상 활성) */
+    settingsActive?: boolean;
+    onRemove?: () => void;
+    onOpenSettings?: () => void;
+}
+/**
+ * Vue 측 PivotFieldChip.vue 1:1 포팅.
+ *
+ * - value 영역: 드래그 핸들 + 집계 약어 + 라벨 + 설정 톱니바퀴
+ * - 그 외 영역(row/column/filter): 드래그 핸들 + 라벨 + 제거 버튼
+ */
+export declare function PivotFieldChip(props: PivotFieldChipProps): import("react/jsx-runtime").JSX.Element;

package/dist/legacy/components/pivot/PivotFieldDropZone.d.ts

@@ -0,0 +1,30 @@
+import { PivotRowField, PivotColumnField, PivotValueField, PivotFilterField } from '@vmscloud/moz-ui-grid-core';
+type AnyPivotField = PivotRowField | PivotColumnField | PivotValueField | PivotFilterField;
+export interface PivotFieldDropZoneProps {
+    area: 'row' | 'column' | 'value' | 'filter';
+    label: string;
+    fields: AnyPivotField[];
+    /** v-model:fields 대응 — fields 변경 시 호출 */
+    onFieldsChange: (fields: AnyPivotField[]) => void;
+    placeholder?: string;
+    /** 값 영역 칩의 톱니바퀴 활성화 표시용 (설정 팝업 대상 필드명) */
+    settingsActiveField?: string;
+    /** 드롭존 안에서 필드가 제거되었을 때 (X 버튼 클릭) */
+    onFieldRemoved?: (field: string) => void;
+    /** 외부에서 드롭된 아이템 (사용 가능 필드 목록에서 끌어온 경우) */
+    onItemDropped?: (item: {
+        field: string;
+        header?: string;
+    }) => void;
+    /** 값 영역 칩 설정 톱니바퀴 클릭 */
+    onOpenSettings?: (field: PivotValueField) => void;
+}
+/**
+ * Vue 측 PivotFieldDropZone.vue 1:1 포팅.
+ *
+ * Vue의 `<Dragging>` 컴포넌트를 native HTML5 DnD로 대체:
+ * - 영역 내부 정렬: index 기반 reorder
+ * - 외부 영역에서 드롭: onItemDropped 콜백 (호스트가 다른 영역에서 제거 처리)
+ */
+export declare function PivotFieldDropZone(props: PivotFieldDropZoneProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/legacy/components/pivot/PivotFieldPanel.d.ts

@@ -0,0 +1,26 @@
+import { PivotRowField, PivotColumnField, PivotValueField, PivotFilterField } from '@vmscloud/moz-ui-grid-core';
+import { AvailableField, PivotFieldPanelConfig } from '../../types/pivot-props';
+export interface PivotFieldPanelProps {
+    availableFields: AvailableField[];
+    rowFields?: PivotRowField[];
+    columnFields?: PivotColumnField[];
+    valueFields?: PivotValueField[];
+    filterFields?: PivotFilterField[];
+    /** 현재 그리드 행 수 — 10만건 이상이면 '바로 적용' 자동 해제 */
+    totalRowCount?: number;
+    onUpdateConfig?: (config: PivotFieldPanelConfig) => void;
+}
+export interface PivotFieldPanelHandle {
+    show: () => void;
+    hide: () => void;
+}
+/**
+ * Vue 측 PivotFieldPanel.vue 1:1 포팅.
+ *
+ * Popup 기반의 피벗 필드 설정 패널:
+ * - 왼쪽: 사용 가능한 필드 목록 (검색 + 체크박스 + 드래그)
+ * - 오른쪽: 행/열/값 드롭존 (PivotFieldDropZone)
+ * - 푸터: 바로 적용 체크박스 + 업데이트 버튼
+ * - 값 필드 칩의 톱니바퀴 클릭 시 작은 설정 팝업으로 aggregate 변경
+ */
+export declare const PivotFieldPanel: import('react').ForwardRefExoticComponent<PivotFieldPanelProps & import('react').RefAttributes<PivotFieldPanelHandle>>;

package/dist/legacy/components/pivot/PivotOptionModal.d.ts

@@ -0,0 +1,36 @@
+import { PivotValueField, PivotRowField, PivotColumnField } from '@vmscloud/moz-ui-grid-core';
+import { PivotGridSettings } from '../../types/pivot-props';
+export interface PivotOptionModalProps {
+    valueFields?: PivotValueField[];
+    rowFields?: PivotRowField[];
+    columnFields?: PivotColumnField[];
+    showRowSubTotals?: boolean;
+    showRowGrandTotals?: boolean;
+    showColumnSubTotals?: boolean;
+    showColumnGrandTotals?: boolean;
+    rowSubTotalFields?: string[];
+    columnSubTotalFields?: string[];
+    totalsBeforeData?: boolean;
+    showZeros?: boolean;
+    /** 푸터 표시 여부 (v-model:footerVisible) */
+    footerVisible?: boolean;
+    onFooterVisibleChange?: (v: boolean) => void;
+    /** 닫기 (Popover 호스트가 처리) */
+    onClose?: () => void;
+    /** 필드 패널 열기 */
+    onClickFieldPanel?: () => void;
+    /** 그리드 설정 변경 */
+    onUpdateGridSettings?: (settings: PivotGridSettings) => void;
+    /** 값 필드 설정 변경 */
+    onUpdateValueField?: (payload: {
+        field: string;
+        changes: Partial<PivotValueField>;
+    }) => void;
+}
+/**
+ * Vue 측 PivotOptionModal.vue 1:1 포팅.
+ *
+ * 3-level 네비게이션: Main → Grid 설정 / 값 필드 설정.
+ * GridSetupPopover 안에서 사용되어 설정 아이콘 바로 아래에 popover로 표시된다.
+ */
+export declare function PivotOptionModal(props: PivotOptionModalProps): import("react/jsx-runtime").JSX.Element;

package/dist/legacy/components/pivot/PivotToolBox.d.ts

@@ -0,0 +1,56 @@
+import { ReactNode } from 'react';
+export interface PivotToolBoxProps {
+    /** 설정(톱니바퀴) 표시 */
+    useToolBoxSetting?: boolean;
+    /** 필터 버튼 표시 */
+    useFilter?: boolean;
+    /** 정렬 버튼 표시 */
+    useSort?: boolean;
+    /** 조건부 스타일 버튼 표시 */
+    useCustomCell?: boolean;
+    /** 차트 버튼 표시 */
+    useChart?: boolean;
+    /** 차트 활성 상태 */
+    chartActive?: boolean;
+    /** 데이터 행 수 (0이면 버튼 비활성) */
+    itemsLength?: number;
+    /** 설정 popover 열림 상태(시각용) */
+    optionModalState?: boolean;
+    /** 필터·정렬·customCell count override (없으면 grid state에서 직접 구독) */
+    filterCount?: number;
+    sortCount?: number;
+    customCellCount?: number;
+    /**
+     * 필터 popup controlled prop (선택). 지정하면 외부가 visible 제어.
+     * 외부에서 PivotContextMenu 등이 필터를 띄울 수 있도록 노출.
+     */
+    filterPopupVisible?: boolean;
+    onFilterPopupVisibleChange?: (visible: boolean) => void;
+    /** 슬롯 영역 */
+    toolLeft?: ReactNode;
+    toolItems?: ReactNode;
+    toolItemsRight?: ReactNode;
+    /**
+     * 설정 popover 내용 (PivotOptionModal).
+     * Render prop으로 받아 popover의 `close()` 제어를 PivotOptionModal까지 전달한다.
+     * (예: "필드 설정" 클릭 시 popover를 닫고 PivotFieldPanel을 열기 위해)
+     */
+    optionPopup?: ReactNode | ((api: {
+        close: () => void;
+    }) => ReactNode);
+    /** 이벤트 (Vue defineEmits 대응) */
+    onClickSetting?: () => void;
+    onClickFilter?: () => void;
+    onClickSort?: () => void;
+    onClickCustomCell?: () => void;
+    onClickResetAll?: () => void;
+    onClickChart?: () => void;
+    onChangeSearchValue?: (value: string) => void;
+}
+/**
+ * Vue 측 PivotToolBox.vue 1:1 포팅.
+ *
+ * 레이아웃: 설정 | 필터 | 정렬 | customCell | 차트 | 리셋  ··· 검색  ▽
+ * 접기/펼치기 토글로 ToolBox 전체 표시 토글. 접혔을 때 14px 펼치기 바.
+ */
+export declare function PivotToolBox(props: PivotToolBoxProps): import("react/jsx-runtime").JSX.Element;

package/dist/legacy/components/pivot/chart/EChart.d.ts

@@ -0,0 +1,18 @@
+import { CSSProperties } from 'react';
+import * as echarts from 'echarts';
+/**
+ * EChart — echarts 직접 래퍼.
+ *
+ * Vue 측 EChart.vue 1:1 포팅. echarts-for-react를 쓰지 않고 echarts.init을 직접 호출해
+ * setOption 시 `notMerge: true`로 완전 교체. autoresize는 ResizeObserver로 처리.
+ */
+export interface EChartProps {
+    option: Record<string, unknown>;
+    autoresize?: boolean;
+    style?: CSSProperties;
+    className?: string;
+}
+export interface EChartHandle {
+    instance: echarts.ECharts | null;
+}
+export declare const EChart: import('react').ForwardRefExoticComponent<EChartProps & import('react').RefAttributes<EChartHandle>>;

package/dist/legacy/components/pivot/chart/MozPivotChart.d.ts

@@ -0,0 +1,23 @@
+import { PureSheet } from '@vmscloud/moz-ui-grid-core';
+/**
+ * MozPivotChart — 피벗 차트 최상위 컴포넌트.
+ *
+ * Vue 측 MozPivotChart.vue 1:1 포팅. PureSheet 코어의 `getSeriesData()` API로
+ * 차트 데이터를 가져오고, Multiple 모드(행별 미니 차트)와 Detail 모드(상세 차트)를 전환.
+ *
+ * 외부(부모)에서 `ref.current.refresh()`로 명시 갱신 가능 — `pivot.setConfig()`이
+ * 이벤트를 emit하지 않으므로 필드 설정 변경 시 부모가 setConfig를 await 한 뒤 호출해야 함.
+ */
+export interface MozPivotChartProps {
+    /** PureSheet 그리드 인스턴스 */
+    grid: PureSheet;
+    /** Multiple 모드 사용 */
+    useMultipleChart?: boolean;
+    /** Grand Total 포함 */
+    includeGrandTotal?: boolean;
+    onClose: () => void;
+}
+export interface MozPivotChartHandle {
+    refresh: () => Promise<void>;
+}
+export declare const MozPivotChart: import('react').ForwardRefExoticComponent<MozPivotChartProps & import('react').RefAttributes<MozPivotChartHandle>>;

package/dist/legacy/components/pivot/chart/PivotChartDetail.d.ts

@@ -0,0 +1,17 @@
+import { ChartType } from './chartUtils';
+/**
+ * PivotChartDetail — 상세 차트 (Detail 모드).
+ *
+ * Vue 측 PivotChartDetail.vue 1:1 포팅. legend·dataZoom 활성화.
+ */
+export interface PivotChartDetailProps {
+    xLabels: string[];
+    seriesData: {
+        name: string;
+        data: (number | null)[];
+    }[];
+    chartType: ChartType;
+    /** X축 라벨 줄수 — 호출자가 피벗 config 기반으로 계산해 전달 */
+    labelLines?: number;
+}
+export declare function PivotChartDetail(props: PivotChartDetailProps): import("react/jsx-runtime").JSX.Element;

package/dist/legacy/components/pivot/chart/PivotChartMini.d.ts

@@ -0,0 +1,19 @@
+import { ChartType } from './chartUtils';
+/**
+ * PivotChartMini — 미니 차트 (Multiple 모드에서 사용).
+ *
+ * Vue 측 PivotChartMini.vue 1:1 포팅. sparkline 스타일의 작은 차트.
+ */
+export interface PivotChartMiniProps {
+    xLabels: string[];
+    seriesData: {
+        name: string;
+        data: (number | null)[];
+    }[];
+    chartType: ChartType;
+    width?: number;
+    height?: number;
+    /** X축 라벨 줄수 — 미니 차트는 라벨이 숨겨지므로 영향 적지만 일관성 위해 받음 */
+    labelLines?: number;
+}
+export declare function PivotChartMini(props: PivotChartMiniProps): import("react/jsx-runtime").JSX.Element;

package/dist/legacy/components/pivot/chart/PivotChartMultiple.d.ts

@@ -0,0 +1,16 @@
+import { PivotSeriesCategory } from '@vmscloud/moz-ui-grid-core';
+import { ChartType } from './chartUtils';
+/**
+ * PivotChartMultiple — Multiple 모드 (행별 미니 차트 목록).
+ *
+ * Vue 측 PivotChartMultiple.vue 1:1 포팅. IntersectionObserver로 lazy 렌더링.
+ */
+export interface PivotChartMultipleProps {
+    categories: PivotSeriesCategory[];
+    xLabels: string[];
+    chartType: ChartType;
+    /** X축 라벨 줄수 — 자식(PivotChartMini)에 forwarding */
+    labelLines?: number;
+    onSelect: (categoryName: string) => void;
+}
+export declare function PivotChartMultiple(props: PivotChartMultipleProps): import("react/jsx-runtime").JSX.Element;

package/dist/legacy/components/pivot/chart/PivotChartToolbar.d.ts

@@ -0,0 +1,32 @@
+import { ChartType } from './chartUtils';
+/**
+ * PivotChartToolbar — 차트 타입/카테고리/시리즈 선택 UI.
+ *
+ * Vue 측 PivotChartToolbar.vue 1:1 포팅.
+ */
+export interface PivotChartToolbarProps {
+    chartType: ChartType;
+    rowFields: {
+        field: string;
+        header?: string;
+    }[];
+    columnFields: {
+        field: string;
+        header?: string;
+    }[];
+    valueFields: {
+        field: string;
+        header?: string;
+    }[];
+    selectedRowField: string;
+    selectedColumnField: string;
+    selectedValueFields: string[];
+    showBack?: boolean;
+    onUpdateChartType: (type: ChartType) => void;
+    onUpdateSelectedRowField: (field: string) => void;
+    onUpdateSelectedColumnField: (field: string) => void;
+    onUpdateSelectedValueFields: (fields: string[]) => void;
+    onBack: () => void;
+    onClose: () => void;
+}
+export declare function PivotChartToolbar(props: PivotChartToolbarProps): import("react/jsx-runtime").JSX.Element;

package/dist/legacy/components/pivot/chart/chartUtils.d.ts

@@ -0,0 +1,45 @@
+/**
+ * chartUtils — ECharts 옵션 생성 유틸
+ *
+ * 차트 데이터를 ECharts option 객체로 변환합니다.
+ * 스타일은 moz-ui-chart 라이브러리 (MozEChartSeriesType) 기준에 맞춤.
+ */
+export type ChartType = 'bar' | 'line' | 'lineSymbols' | 'area';
+/** 시리즈별 차트 설정 (chartMap) */
+export interface ChartSeriesConfig {
+    type?: ChartType;
+    color?: string;
+}
+/** ECharts 옵션 생성 입력 */
+export interface EChartsConfig {
+    chartType: ChartType;
+    xLabels: string[];
+    seriesData: {
+        name: string;
+        data: (number | null)[];
+    }[];
+    showTooltip?: boolean;
+    showLegend?: boolean;
+    showDataZoom?: boolean;
+    /** 미니 차트 모드 (축/라벨 최소화) */
+    mini?: boolean;
+    /** 시리즈별 차트 타입/색상 설정 */
+    chartMap?: Record<string, ChartSeriesConfig>;
+    /**
+     * X축 라벨의 줄수 — 회전·자동생략 계산에 사용.
+     *
+     * 호출자가 피벗 config에서 직접 계산해 전달 (결정론적):
+     *   labelLines = (selectedColumnField === 'all' ? columnFields.length : 1)
+     *              + (selectedValueFields.length > 1 ? 1 : 0)
+     *
+     * 미지정 시 xLabels의 '\n'을 측정 (fallback).
+     */
+    labelLines?: number;
+}
+/** ECharts option 생성 */
+export declare function toEChartsOption(config: EChartsConfig): Record<string, unknown>;
+/** 차트 타입 옵션 목록 */
+export declare const CHART_TYPE_OPTIONS: {
+    value: ChartType;
+    label: string;
+}[];

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

@@ -0,0 +1,31 @@
+import { MutableRefObject } from 'react';
+import { PureSheet } from '@vmscloud/moz-ui-grid-core';
+import { ReactRenderer } from '../../bridge/ReactRenderer';
+import { TemplateRegistry } from '../../types/slots';
+import { UseGridCustomCellReturn } from '../hooks/useGridCustomCell';
+/**
+ * Vue 측 src/types/injection-keys.ts의 React 대응.
+ * 각 Context는 MozGridReactCore가 Provider로 값을 주입하고, 하위 컴포넌트가 useContext로 소비.
+ */
+/**
+ * PureSheet 인스턴스 Context.
+ *
+ * 값은 인스턴스 자체 (state로 관리). ref가 아니라 state여야 consumer가 mount 시점에
+ * re-render된다. (이전엔 MutableRefObject를 넘겨서 ref.current 변경이 React로 전파되지
+ * 않아 GridFilter/Sort/ColumnPicker 등이 grid mount 후에도 빈 상태로 남는 버그가 있었음.)
+ */
+export declare const GridInstanceContext: import('react').Context<PureSheet | null>;
+/** 그리드 컨테이너 HTMLElement Context (ref는 컨테이너 측정용으로만 사용 — reactivity 불필요) */
+export declare const GridContainerContext: import('react').Context<MutableRefObject<HTMLElement | null> | null>;
+/** ReactRenderer Context */
+export declare const GridRendererContext: import('react').Context<ReactRenderer | null>;
+/** 템플릿 레지스트리 Context */
+export declare const GridTemplateRegistryContext: import('react').Context<TemplateRegistry | null>;
+/** 필터 모듈 Context (Phase 4에서 hook 인터페이스 확정) */
+export declare const GridFilterModuleContext: import('react').Context<unknown>;
+/** 정렬 모듈 Context */
+export declare const GridSortModuleContext: import('react').Context<unknown>;
+/** 조건부 스타일 모듈 Context */
+export declare const GridCustomCellModuleContext: import('react').Context<UseGridCustomCellReturn | null>;
+/** 일괄 편집 모듈 Context */
+export declare const GridBulkEditorModuleContext: import('react').Context<unknown>;

package/dist/legacy/contracts/notification.contract.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Vue 측 contracts/notification.contract.ts의 React 대응.
+ *
+ * 호스트 앱이 알림 시스템(toast/notification list)을 주입할 수 있도록 Context 계약 정의.
+ */
+export type SSENotificationType = 'INFO' | 'WARNING' | 'ERROR' | 'SUCCESS';
+export type ExcelNotificationOperationType = 'IMPORT' | 'EXPORT' | 'EXPORT_CSV';
+export interface NotificationItem {
+    id: string;
+    type: SSENotificationType;
+    operation?: ExcelNotificationOperationType;
+    title: string;
+    message?: string;
+    progress?: number;
+    createdAt: number;
+}
+export interface GridNotificationContract {
+    show: (item: Omit<NotificationItem, 'id' | 'createdAt'>) => string;
+    update: (id: string, patch: Partial<NotificationItem>) => void;
+    remove: (id: string) => void;
+    list: NotificationItem[];
+}
+export declare const GridNotificationContext: import('react').Context<GridNotificationContract | null>;
+/** Vue측 GridNotificationKey 대응 (Symbol injection key의 React 대응) */
+export declare const GridNotificationKey: unique symbol;
+/**
+ * Vue의 `provideGridNotification` 대응.
+ *
+ * 호스트 앱에서 `<GridNotificationProvider value={...}>...</GridNotificationProvider>`로 사용.
+ */
+export declare const GridNotificationProvider: import('react').Provider<GridNotificationContract | null>;
+export declare function useGridNotificationStore(): GridNotificationContract | null;
+/** Vue측 provideGridNotification — React에서는 GridNotificationProvider 사용 권장 */
+export declare function provideGridNotification(contract: GridNotificationContract): GridNotificationContract;

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

@@ -0,0 +1,16 @@
+export { useGridInstance } from './useGridInstance';
+export { useGridEvents } from './useGridEvents';
+export { useGridSelection } from './useGridSelection';
+export { useGridChanges } from './useGridChanges';
+export { useGridUndoRedo, type UseGridUndoRedoReturn } from './useGridUndoRedo';
+export { useGridValidation, type UseGridValidationReturn } from './useGridValidation';
+export { useGridColumns, type UseGridColumnsReturn } from './useGridColumns';
+export { useGridSelect } from './useGridSelect';
+export { useSearchHighlight } from './useSearchHighlight';
+export { useCellTooltip } from './useCellTooltip';
+export { useGridFilter, type UseGridFilterReturn } from './useGridFilter';
+export { useGridSort, type UseGridSortReturn } from './useGridSort';
+export { useGridCustomCell, type UseGridCustomCellReturn } from './useGridCustomCell';
+export { useGridCustomCellModule } from './useGridCustomCellModule';
+export { useGridBulkEditor, type UseGridBulkEditorReturn, type BulkEditorState } from './useGridBulkEditor';
+export { useContextMenu, type UseContextMenuReturn, type ContextMenuContext, type ContextMenuPosition, type ContextMenuCallbacks, } from './useContextMenu';

package/dist/legacy/hooks/useCellTooltip.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Vue useCellTooltip composable의 React 대응 (간단 wrapper).
+ *
+ * core가 tooltipMode 옵션으로 자동 관리. 별도 호출은 필요 없음.
+ */
+export declare function useCellTooltip(): {
+    grid: import('@vmscloud/moz-ui-grid-core').PureSheet | null;
+};

package/dist/legacy/hooks/useClientExcelExport.d.ts

@@ -0,0 +1,27 @@
+import { PureSheet } from '@vmscloud/moz-ui-grid-core';
+/**
+ * Vue 측 useClientExcelExport composable의 React 대응.
+ *
+ * PureSheet의 grid.io API를 사용해 클라이언트 단에서 직접 xlsx/csv를 생성.
+ * Vue 버전과 동일한 함수 이름 유지: runClientExport, exportCsv, generateSessionId.
+ */
+export interface ClientExcelExportConfig {
+    fileName?: string;
+    /** 헤더 포함 여부 */
+    includeHeader?: boolean;
+    /** 가시 컬럼만 export */
+    visibleOnly?: boolean;
+    /** csv 구분자 */
+    csvDelimiter?: string;
+    /** ISO/UTF8 BOM 추가 */
+    withBom?: boolean;
+}
+export declare function generateSessionId(): string;
+/**
+ * xlsx 내보내기. core의 grid.io.exportXlsx() API에 위임.
+ */
+export declare function runClientExport(grid: PureSheet, config?: ClientExcelExportConfig): Promise<Blob | null>;
+/**
+ * csv 내보내기. core의 grid.io.exportCsv() API에 위임.
+ */
+export declare function exportCsv(grid: PureSheet, config?: ClientExcelExportConfig): Promise<Blob | null>;

package/dist/legacy/hooks/useClientExcelStore.d.ts

@@ -0,0 +1,18 @@
+import { PureSheet } from '@vmscloud/moz-ui-grid-core';
+/**
+ * Vue 측 useClientExcelStore composable의 React 대응.
+ *
+ * 모듈 레벨 싱글톤 — ContextMenu와 팝업이 같은 상태 공유.
+ * useSyncExternalStore로 React 컴포넌트 갱신.
+ */
+interface ClientExcelStoreState {
+    showPopup: boolean;
+    activeGrid: PureSheet | null;
+    defaultImportOptions: Record<string, unknown>;
+}
+export interface UseClientExcelStoreReturn extends ClientExcelStoreState {
+    show(grid: PureSheet, options?: Record<string, unknown>): void;
+    hide(): void;
+}
+export declare function useClientExcelStore(): UseClientExcelStoreReturn;
+export {};