@vmscloud/moz-ui-grid-react 0.1.19

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

@@ -0,0 +1,62 @@
+import { PureSheet, FieldDef } from '@vmscloud/moz-ui-grid-core';
+import { IContextMenuConfig } from '../types/toolbar';
+/** 컨텍스트 메뉴 위치 */
+export interface ContextMenuPosition {
+    x: number;
+    y: number;
+}
+/** 컨텍스트 메뉴 컨텍스트 (우클릭 시 타겟 정보) */
+export interface ContextMenuContext {
+    area?: 'cell' | 'header';
+    rowIndex: number;
+    rowId?: string | number;
+    columnId: string;
+    groupId?: string;
+    field: FieldDef | null;
+    cellValue: unknown;
+    rowData: Record<string, unknown> | null;
+}
+/** wrapper UI(필터/정렬 팝업 등)와 통신하기 위한 콜백 */
+export interface ContextMenuCallbacks {
+    /** 컬럼별 필터 추가 — wrapper가 GridFilter popup을 연다 */
+    onOpenFilter?: (field: FieldDef) => void;
+    /** 컬럼 표시/숨김 popup 열기 */
+    onOpenColumnPicker?: () => void;
+    /** 그룹 패널 토글 */
+    onToggleGroupPanel?: () => void;
+    /** 일괄 편집 popup 열기 */
+    onOpenBulkEditor?: (field: FieldDef, cellValue: unknown) => void;
+}
+export interface UseContextMenuReturn {
+    /** 메뉴 표시 여부 */
+    visible: boolean;
+    /** 메뉴 위치 */
+    position: ContextMenuPosition;
+    /** 현재 컨텍스트 */
+    context: ContextMenuContext | null;
+    /** 메뉴 표시 */
+    show: (event: MouseEvent, ctx: ContextMenuContext) => void;
+    /** 메뉴 숨김 */
+    hide: () => void;
+    /** 그리드 인스턴스 연결 */
+    setGrid: (grid: PureSheet | null) => void;
+    /** 설정 업데이트 */
+    updateConfig: (config: Partial<IContextMenuConfig>) => void;
+    /** 메뉴 커맨드 실행 */
+    executeCommand: (commandId: string) => void;
+    /** 컬럼에 필터가 있는지 */
+    hasColumnFilter: (columnId: string) => boolean;
+    /** 컬럼에 정렬이 있는지 */
+    hasColumnSort: (columnId: string) => boolean;
+    /** 정리 */
+    destroy: () => void;
+}
+/**
+ * Vue `useContextMenu` composable 1:1 포팅 (React 버전).
+ *
+ * Vue의 `modules` 파라미터(filterModule/sortModule/...) 대신 wrapper UI와 통신하는
+ * 콜백(`onOpenFilter` 등)을 받는다. 직접 grid API로 처리 가능한 command(`RST_COL_FLT`,
+ * `DATA_COPY`, `PIN_UNPIN` 등)는 그리드에 바로 호출하고, popup을 열어야 하는 command
+ * (`ADD_FLT`, `COLUMN_VIEW_SELECT`, `GROUP_PANEL`, `BULK_EDIT`)는 콜백으로 위임한다.
+ */
+export declare function useContextMenu(initialConfig?: IContextMenuConfig, callbacks?: ContextMenuCallbacks): UseContextMenuReturn;

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

@@ -0,0 +1,16 @@
+import { PureSheet } from '@vmscloud/moz-ui-grid-core';
+export interface BulkEditorState {
+    visible: boolean;
+    columnId: string | null;
+    rows: Record<string, unknown>[];
+}
+export interface UseGridBulkEditorReturn extends BulkEditorState {
+    destroy: () => void;
+    open: (columnId: string, rows: Record<string, unknown>[]) => void;
+    close: () => void;
+    apply: (newValue: unknown) => Promise<void>;
+}
+/**
+ * Vue useGridBulkEditor composable의 React 대응 (일괄 편집 팝업).
+ */
+export declare function useGridBulkEditor(grid?: PureSheet | null): UseGridBulkEditorReturn;

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

@@ -0,0 +1,10 @@
+/**
+ * Vue useGridChanges composable의 React 대응.
+ *
+ * 변경된 셀 정보 stream. cell:change 이벤트를 누적해서 반환.
+ * 단순 구현 — 실제 ChangeTracker 통합은 PureSheet API에 의존.
+ */
+export declare function useGridChanges(): {
+    changes: unknown[];
+    clear: () => void;
+};

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

@@ -0,0 +1,11 @@
+import { ColumnState } from '@vmscloud/moz-ui-grid-core';
+export interface UseGridColumnsReturn {
+    columns: ColumnState[];
+    refresh: () => void;
+}
+/**
+ * Vue useGridColumns composable의 React 대응.
+ *
+ * 컬럼 상태(너비/순서/가시성) 변경을 감지해 리렌더링합니다.
+ */
+export declare function useGridColumns(): UseGridColumnsReturn;

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

@@ -0,0 +1,32 @@
+import { PureSheet, FieldDef } from '@vmscloud/moz-ui-grid-core';
+import { ICustomCellConfig } from '../types/toolbar';
+export interface UseGridCustomCellReturn {
+    /** 팝업 표시 여부 */
+    showCustomCell: boolean;
+    /** 현재 선택된 컬럼 */
+    hitColumn: FieldDef | null;
+    /** 현재 규칙셋 설정 */
+    config: ICustomCellConfig;
+    /** 팝업 열기 */
+    showCustomCellHandler: (field?: FieldDef) => void;
+    /** 팝업 닫기 */
+    hideCustomCellHandler: () => void;
+    /** 그리드 연결 */
+    setGrid: (grid: PureSheet | null) => void;
+    /** 설정 교체 */
+    setCustomCell: (config: ICustomCellConfig) => void;
+    /** 현재 설정 가져오기 */
+    getCustomCell: () => ICustomCellConfig;
+    /** 스타일 적용 (그리드 다시 렌더링) */
+    applyCellStyle: () => void;
+    /** 전체 초기화 */
+    clearCustomCell: () => void;
+    /** 정리 */
+    destroy: () => void;
+}
+/**
+ * 그리드 조건부 스타일 모듈 (Vue useGridCustomCell 1:1 포팅).
+ *
+ * Wijmo formatItem → PureSheet formatRow 기반.
+ */
+export declare function useGridCustomCell(): UseGridCustomCellReturn;

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

@@ -0,0 +1,9 @@
+import { UseGridCustomCellReturn } from './useGridCustomCell';
+/**
+ * MozGridReact 트리 안에서 wrapper가 생성·주입한 조건부 스타일 모듈을 꺼낸다.
+ *
+ * Vue 측 `inject(GRID_CUSTOM_CELL_MODULE_KEY)` 대응.
+ *
+ * Provider 외부에서 호출하면 null을 반환한다 (호스트가 단독 MozGridReactCore 사용 시).
+ */
+export declare function useGridCustomCellModule(): UseGridCustomCellReturn | null;

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

@@ -0,0 +1,13 @@
+import { PureSheetEventType } from '@vmscloud/moz-ui-grid-core';
+/**
+ * Vue useGridEvents composable의 React 대응.
+ *
+ * PureSheet 이벤트 listener를 자동 등록/해제합니다.
+ *
+ * @example
+ * useGridEvents({
+ *   'row:click': (payload) => console.log(payload),
+ *   'cell:change': (payload) => console.log(payload),
+ * });
+ */
+export declare function useGridEvents(handlers: Partial<Record<PureSheetEventType, (payload: unknown) => void>>): void;

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

@@ -0,0 +1,19 @@
+import { PureSheet } from '@vmscloud/moz-ui-grid-core';
+import { IFilterDef } from '../types/toolbar';
+export interface UseGridFilterReturn {
+    filters: IFilterDef[];
+    setGrid: (grid: PureSheet | null) => void;
+    destroy: () => void;
+    addFilter: (filter?: Partial<IFilterDef>) => void;
+    removeFilter: (sequence: number) => void;
+    updateFilter: (sequence: number, patch: Partial<IFilterDef>) => void;
+    applyFilters: () => Promise<void>;
+    resetFilters: () => Promise<void>;
+}
+/**
+ * Vue useGridFilter composable의 React 대응. (state holder)
+ *
+ * 본격적인 필터 UI는 GridFilter 컴포넌트가 내부 상태로 관리한다.
+ * 이 hook은 호스트 쪽에서 필터 상태를 외부에서 관리하고 싶을 때 사용한다.
+ */
+export declare function useGridFilter(): UseGridFilterReturn;

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

@@ -0,0 +1,9 @@
+import { PureSheet } from '@vmscloud/moz-ui-grid-core';
+/**
+ * Vue useGridInstance composable의 React 대응.
+ *
+ * MozGridReactCore 트리 내부에서 호출. PureSheet 인스턴스를 직접 가져옵니다.
+ * 초기화 전(useEffect 첫 실행 전)에는 null을 반환합니다.
+ * MozGridReactCore가 grid를 useState로 관리해 mount 시 consumer가 자동 re-render.
+ */
+export declare function useGridInstance(): PureSheet | null;

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

@@ -0,0 +1,10 @@
+/**
+ * Vue useGridSelect composable의 React 대응.
+ *
+ * 행 선택/해제 등 셀렉션 명령. selection:changed 이벤트와 분리된 명령 API.
+ */
+export declare function useGridSelect(): {
+    selectAll: () => void;
+    deselectAll: () => void;
+    selectRow: (rowId: string | number) => void;
+};

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

@@ -0,0 +1,6 @@
+/**
+ * Vue useGridSelection composable의 React 대응.
+ *
+ * 현재 선택된 행/셀 정보를 반환합니다. 선택 변경 시 자동 리렌더.
+ */
+export declare function useGridSelection(): unknown;

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

@@ -0,0 +1,16 @@
+import { PureSheet } from '@vmscloud/moz-ui-grid-core';
+import { ISortDef } from '../types/toolbar';
+export interface UseGridSortReturn {
+    sorts: ISortDef[];
+    setGrid: (grid: PureSheet | null) => void;
+    destroy: () => void;
+    addSort: (sort?: Partial<ISortDef>) => void;
+    removeSort: (sequence: number) => void;
+    updateSort: (sequence: number, patch: Partial<ISortDef>) => void;
+    applySorts: () => Promise<void>;
+    resetSorts: () => Promise<void>;
+}
+/**
+ * Vue useGridSort composable의 React 대응. (state holder)
+ */
+export declare function useGridSort(): UseGridSortReturn;

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

@@ -0,0 +1,10 @@
+export interface UseGridUndoRedoReturn {
+    canUndo: boolean;
+    canRedo: boolean;
+    undo: () => void;
+    redo: () => void;
+}
+/**
+ * Vue useGridUndoRedo composable의 React 대응.
+ */
+export declare function useGridUndoRedo(): UseGridUndoRedoReturn;

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

@@ -0,0 +1,9 @@
+import { ValidationError } from '@vmscloud/moz-ui-grid-core';
+export interface UseGridValidationReturn {
+    errors: ValidationError[];
+    hasErrors: boolean;
+}
+/**
+ * Vue useGridValidation composable의 React 대응.
+ */
+export declare function useGridValidation(): UseGridValidationReturn;

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

@@ -0,0 +1,9 @@
+/**
+ * Vue 측 useSearchHighlight composable의 React 대응.
+ *
+ * Core가 `search:highlighted` 이벤트를 발행할 때 매치된 셀(.ps-search-match)의
+ * .ps-cell-content 텍스트에서 키워드 부분만 <mark class="ps-search-hl">로 래핑.
+ *
+ * MozGridReactCore가 mount 시 자동 호출 (Vue MozGridVueCore와 동일).
+ */
+export declare function useSearchHighlight(): void;

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

@@ -0,0 +1,36 @@
+import { SVGProps } from 'react';
+export type IconSize = '10' | '12' | '14' | '16' | '18' | '20' | '22' | '30';
+interface BaseIconProps extends Omit<SVGProps<SVGSVGElement>, 'color' | 'size'> {
+    size?: IconSize | number;
+    color?: string;
+    disabled?: boolean;
+    thin?: boolean;
+}
+export declare function IconArrowUpCenter({ size, color, thin, ...rest }: BaseIconProps): import("react/jsx-runtime").JSX.Element;
+export declare function IconFilter({ size, color, ...rest }: BaseIconProps): import("react/jsx-runtime").JSX.Element;
+export declare function IconResetGridToolbar({ size, color, ...rest }: BaseIconProps): import("react/jsx-runtime").JSX.Element;
+export declare function IconSetting({ size, color, ...rest }: BaseIconProps): import("react/jsx-runtime").JSX.Element;
+export declare function IconSort({ size, color, ...rest }: BaseIconProps): import("react/jsx-runtime").JSX.Element;
+export declare function IconCustomCell({ size, color, ...rest }: BaseIconProps): import("react/jsx-runtime").JSX.Element;
+export declare function IconUndo({ size, color, ...rest }: BaseIconProps): import("react/jsx-runtime").JSX.Element;
+export declare function IconRedo({ size, color, ...rest }: BaseIconProps): import("react/jsx-runtime").JSX.Element;
+export declare function IconDownload({ size, color, disabled, ...rest }: BaseIconProps): import("react/jsx-runtime").JSX.Element;
+export declare function IconSearch({ size, color, disabled, ...rest }: BaseIconProps): import("react/jsx-runtime").JSX.Element;
+export declare function IconClose({ size, color, disabled, thin, ...rest }: BaseIconProps): import("react/jsx-runtime").JSX.Element;
+export declare function IconAdd({ size, color, disabled, ...rest }: BaseIconProps): import("react/jsx-runtime").JSX.Element;
+export declare function IconArrowLeft({ size, color, ...rest }: BaseIconProps): import("react/jsx-runtime").JSX.Element;
+export declare function IconArrowRight({ size, color, disabled, ...rest }: BaseIconProps): import("react/jsx-runtime").JSX.Element;
+export declare function IconArrowLeftWithTail({ size, color, disabled, ...rest }: BaseIconProps): import("react/jsx-runtime").JSX.Element;
+export declare function IconArrowUpWithTail({ size, color, ...rest }: BaseIconProps): import("react/jsx-runtime").JSX.Element;
+export declare function IconArrowDownWithTail({ size, color, ...rest }: BaseIconProps): import("react/jsx-runtime").JSX.Element;
+export declare function IconDragHandler({ size, color, ...rest }: BaseIconProps): import("react/jsx-runtime").JSX.Element;
+export declare function IconReset({ size, color, ...rest }: BaseIconProps): import("react/jsx-runtime").JSX.Element;
+export declare function IconChart({ size, color, ...rest }: BaseIconProps): import("react/jsx-runtime").JSX.Element;
+export declare function IconInfoFilled({ size, color, ...rest }: BaseIconProps): import("react/jsx-runtime").JSX.Element;
+export declare function IconToastWarning({ size, color, ...rest }: BaseIconProps): import("react/jsx-runtime").JSX.Element;
+export declare function IconColorPicker({ size, color, ...rest }: BaseIconProps): import("react/jsx-runtime").JSX.Element;
+export declare function IconDecide({ size, color, ...rest }: BaseIconProps): import("react/jsx-runtime").JSX.Element;
+export declare function IconSettingFilled({ size, color, ...rest }: BaseIconProps): import("react/jsx-runtime").JSX.Element;
+/** @deprecated 호환용 alias */
+export declare const IconInfo: typeof IconInfoFilled;
+export {};

package/dist/legacy/index.d.ts

@@ -0,0 +1,71 @@
+/**
+ * @vmscloud/moz-ui-grid-react
+ *
+ * React 18+ wrapping library for @vmscloud/moz-ui-grid-core
+ * 고성능 그리드 엔진을 React 컴포넌트로 래핑하여 제공합니다.
+ *
+ * Vue 버전(@vmscloud/moz-ui-grid-vue)과 외관·동작·API가 동등합니다.
+ */
+export { MozConfigProvider, MozLocaleContext, useMozLocale, useMozContextWrapper, MozContextWrapperContext, koKR, enUS, zhCN, jaJP, type MozConfigProviderProps, type ContextWrapper, type MozLocaleMessages, } from './locale';
+export { cn, generateUUID, pxToRem, uniqueId, shallowEqual, formatMessage } from './utils';
+export { MozGridReact } from './components/grid/MozGridReact';
+export { MozGridReactCore, type MozGridReactCoreHandle } from './components/grid/MozGridReactCore';
+export { CellTemplate } from './components/grid/CellTemplate';
+export { HeaderTemplate } from './components/grid/HeaderTemplate';
+export { CellEditor } from './components/grid/CellEditor';
+export { DetailTemplate } from './components/grid/DetailTemplate';
+export { GroupTemplate } from './components/grid/GroupTemplate';
+export { GridToolBox } from './components/grid/toolbar/GridToolBox';
+export { GridOptionModal } from './components/grid/toolbar/GridOptionModal';
+export { ColumnPicker } from './components/grid/toolbar/ColumnPicker';
+export { GridBulkEditor } from './components/grid/bulk-editor/GridBulkEditor';
+export { GridContextMenu, type GridContextMenuHandle } from './components/grid/context-menu/GridContextMenu';
+export { GridSearchInput } from './components/common/toolbar/GridSearchInput';
+export { GridFilter } from './components/common/filter/GridFilter';
+export { GridSort } from './components/common/sort/GridSort';
+export { GridCustomCell } from './components/common/custom-cell/GridCustomCell';
+export { GridFooter } from './components/common/footer/GridFooter';
+export { Dragging, draggingEventBus } from './components/common/Dragging';
+export { MozPivotReact } from './components/pivot/MozPivotReact';
+export { PivotToolBox } from './components/pivot/PivotToolBox';
+export { PivotOptionModal } from './components/pivot/PivotOptionModal';
+export { PivotFieldPanel } from './components/pivot/PivotFieldPanel';
+export { PivotContextMenu } from './components/pivot/PivotContextMenu';
+export { MozPivotChart, type MozPivotChartHandle, type MozPivotChartProps } from './components/pivot/chart/MozPivotChart';
+export { PivotChartDetail } from './components/pivot/chart/PivotChartDetail';
+export { PivotChartMini } from './components/pivot/chart/PivotChartMini';
+export { PivotChartMultiple } from './components/pivot/chart/PivotChartMultiple';
+export { PivotChartToolbar } from './components/pivot/chart/PivotChartToolbar';
+export { EChart, type EChartHandle, type EChartProps } from './components/pivot/chart/EChart';
+export { toEChartsOption, CHART_TYPE_OPTIONS, type ChartType, type ChartSeriesConfig, type EChartsConfig, } from './components/pivot/chart/chartUtils';
+/** @deprecated PivotGrid → MozPivotReact로 이름 변경됨 */
+export { MozPivotReact as PivotGrid } from './components/pivot/MozPivotReact';
+export { ClientExcelUploadPopup } from './components/common/excel/ClientExcelUploadPopup';
+export { useClientExcelStore, type UseClientExcelStoreReturn, } from './hooks/useClientExcelStore';
+export { runClientExport, exportCsv, generateSessionId, type ClientExcelExportConfig, } from './hooks/useClientExcelExport';
+export { pickFile, downloadBlob } from './utils/file';
+export { GridNotificationProvider, GridNotificationContext, GridNotificationKey, useGridNotificationStore, provideGridNotification, type GridNotificationContract, type NotificationItem, type SSENotificationType, type ExcelNotificationOperationType, } from './contracts/notification.contract';
+export { IconAdd, IconArrowDownWithTail, IconArrowLeft, IconArrowLeftWithTail, IconArrowRight, IconArrowUpCenter, IconArrowUpWithTail, IconChart, IconClose, IconCustomCell, IconDownload, IconDragHandler, IconFilter, IconInfoFilled, IconReset, IconResetGridToolbar, IconSearch, IconSetting, IconSort, IconToastWarning, } from './icons';
+export type { PivotGridProps, PivotFieldItem, AvailableField, PivotFieldPanelConfig, PivotGridSettings, } from './types/pivot-props';
+export { useGridInstance, useGridEvents, useGridSelection, useGridChanges, useGridUndoRedo, useGridValidation, useGridColumns, useGridSelect, useSearchHighlight, useCellTooltip, useGridFilter, useGridSort, useGridCustomCell, useGridBulkEditor, useContextMenu, type UseGridUndoRedoReturn, type UseGridValidationReturn, type UseGridColumnsReturn, type UseGridFilterReturn, type UseGridSortReturn, type UseGridCustomCellReturn, type UseGridBulkEditorReturn, type UseContextMenuReturn, type BulkEditorState, } from './hooks';
+export { ReactRenderer } from '../bridge/ReactRenderer';
+export { createTemplateRegistry } from '../bridge/templateRegistry';
+export { buildFieldDefs } from '../bridge/fieldBuilder';
+export { GridInstanceContext, GridContainerContext, GridRendererContext, GridTemplateRegistryContext, GridFilterModuleContext, GridSortModuleContext, GridCustomCellModuleContext, GridBulkEditorModuleContext, } from './contexts';
+export type { MozGridReactCoreProps, MozGridReactProps, } from './types/props';
+export type { CellSlotProps, HeaderSlotProps, EditorSlotProps, DetailSlotProps, GroupSlotProps, TemplateRegistry, TemplateEntry, } from '../types/slots';
+export type { ComparisonOperator, LogicalOperator, IFilterDef, ISortDef, ICustomCellDef, ICustomCellRuleSet, ICustomCellConfig, IContextMenuItem, IContextMenuConfig, IContextMenuExcelEventArgs, AggregateType, IAggregateValues, } from './types/toolbar';
+export type { PureSheetConfig, FieldDef, PureSheetEventType, SortState, FilterState, FilterOperator, Row, ColumnDef, ColumnState, EditorConfig, GridState, GridActivity, ViewState, RowSelectionMode, CellSelectionMode, RowSelectionTrigger, RowSelectionConfig, CellSelectionConfig, DataType, AggregateFunc, RowState, ValidationRule, ValidationError, ValidationTrigger, GroupConfig, GroupingConfig, TreeConfig, MasterDetailConfig, ColumnGroupDef, FormatRowCallback, PartialTranslationMap, IPivotAPI, PivotState, PivotConfig, PivotRowField, PivotColumnField, PivotValueField, PivotResult, PivotHeaderNode, PivotRow, ShowValueAs, IRowsAPI, IColumnsAPI, IChangesAPI, IUndoManagerAPI, IGroupAPI, ITreeAPI, IMasterDetailAPI, IValidationAPI, IClipboardAPI, IHeadersAPI, } from '@vmscloud/moz-ui-grid-core';
+export { UndoStack } from '@vmscloud/moz-ui-grid-core';
+export { getRowHeaderCell, getCornerCell, ROW_HEADER_COLUMN_ID } from '@vmscloud/moz-ui-grid-core';
+export { CheckBox, type CheckBoxProps } from './ui/checkbox';
+export { Toggle, type ToggleProps } from './ui/toggle';
+export { Button, type ButtonProps, type ButtonType, type ButtonAction } from './ui/button';
+export { Input, type InputProps, type InputHandle } from './ui/input';
+export { NumberInput, type NumberInputProps } from './ui/number-input';
+export { DateInput, type DateInputProps } from './ui/date-input';
+export { EmptyState, type EmptyStateProps, type EmptyStateMessages } from './ui/empty-state';
+export { Popup, type PopupProps, type PopupPreset, type PopupDialogIcon } from './ui/popup';
+export { ContextMenu, type ContextMenuProps, type ContextMenuHandle, type IContextMenu, type ContextPosition } from './ui/context-menu';
+export { Select, type SelectProps, type SelectHandle, type DisplayFormatter } from './ui/select';
+export { MultiSelect, type MultiSelectProps } from './ui/multi-select';

package/dist/legacy/locale/MozConfigProvider.d.ts

@@ -0,0 +1,31 @@
+import { ReactNode } from 'react';
+import { MozLocaleMessages } from './types';
+import { ContextWrapper } from './contextWrapper';
+export interface MozConfigProviderProps {
+    /** locale 메시지. 미지정 시 koKR 사용 */
+    locale?: MozLocaleMessages;
+    /**
+     * 셀·헤더·에디터 템플릿과 slot root 를 감쌀 함수. 소비자의 Provider 트리를 그대로 넘긴다.
+     *
+     * ```tsx
+     * const wrap = (node: ReactNode) => <QueryClientProvider client={qc}>{node}</QueryClientProvider>;
+     * <MozConfigProvider contextWrapper={wrap}>
+     *   <MozGridReact ... />
+     * </MozConfigProvider>
+     * ```
+     *
+     * **참조 동일성을 유지하세요** — 매 렌더 새 함수를 주면 마운트된 템플릿이 매번 다시
+     * 렌더된다. `useCallback` 이나 모듈 상수로 고정하는 것을 권장한다.
+     *
+     * `@vmscloud/moz-ui-components-react` 의 `MozConfigProvider contextWrapper` 와 같은 계약.
+     */
+    contextWrapper?: ContextWrapper;
+    children?: ReactNode;
+}
+/**
+ * 다국어 설정 + 템플릿 context wrapper Provider.
+ *
+ * Vue의 `<MozConfigProvider :locale="..." />`와 동일하게 하위 트리의 모든 컴포넌트에
+ * locale을 전달하고, 추가로 템플릿 독립 root 에 주입할 소비자 wrapper 를 전달한다.
+ */
+export declare function MozConfigProvider({ locale, contextWrapper, children }: MozConfigProviderProps): import("react/jsx-runtime").JSX.Element;

package/dist/legacy/locale/contextWrapper.d.ts

@@ -0,0 +1,19 @@
+import { ContextWrapper } from '../../bridge/ReactRenderer';
+/**
+ * 셀·헤더·에디터 템플릿과 slot 이 렌더될 때 감쌀 소비자 Provider 트리.
+ *
+ * 템플릿 콘텐츠는 `ReactRenderer.mountInstance` 가 만드는 **독립 React root** 에 렌더되므로
+ * 소비자 앱의 React context 가 닿지 않는다. 그동안 `MozGridReactCore` 가 renderer 의
+ * `setContextWrapper` 에 `MozLocaleContext.Provider` 하나만 넘겨 locale 은 전파됐지만,
+ * 소비자가 자기 Provider(아이콘셋·QueryClient·테마 등)를 끼워 넣을 경로가 없었다.
+ *
+ * 소비자가 `MozConfigProvider contextWrapper` 로 wrapper 를 주면 각 템플릿 root 가 그 트리
+ * 안에서 렌더돼 context 를 되찾는다. Provider 없으면 `null`(기존 동작).
+ *
+ * `@vmscloud/moz-ui-components-react` 0.1.5 의 `MozConfigProvider contextWrapper` 와 같은
+ * 계약이다 — 소비자는 두 패키지에 같은 wrapper 를 넘기면 된다.
+ */
+export declare const MozContextWrapperContext: import('react').Context<ContextWrapper | null>;
+/** 현재 트리에 설정된 템플릿 context wrapper (없으면 `null`). */
+export declare function useMozContextWrapper(): ContextWrapper | null;
+export type { ContextWrapper };

package/dist/legacy/locale/en.d.ts

@@ -0,0 +1,2 @@
+import { MozLocaleMessages } from './types';
+export declare const enUS: MozLocaleMessages;

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

@@ -0,0 +1,8 @@
+export { MozConfigProvider, type MozConfigProviderProps } from './MozConfigProvider';
+export { enUS } from './en';
+export { koKR } from './ko';
+export { zhCN } from './zh';
+export { jaJP } from './ja';
+export { useMozLocale, MozLocaleContext } from './useMozLocale';
+export { useMozContextWrapper, MozContextWrapperContext, type ContextWrapper } from './contextWrapper';
+export type { MozLocaleMessages } from './types';

package/dist/legacy/locale/ja.d.ts

@@ -0,0 +1,2 @@
+import { MozLocaleMessages } from './types';
+export declare const jaJP: MozLocaleMessages;

package/dist/legacy/locale/ko.d.ts

@@ -0,0 +1,2 @@
+import { MozLocaleMessages } from './types';
+export declare const koKR: MozLocaleMessages;