velox-grid 0.11.0

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

@@ -0,0 +1,437 @@
+/**
+ * VeloxGrid - Core Grid Class v6.0
+ *
+ * A lightweight, high-performance data grid library
+ *
+ * Architecture:
+ * - Modular design with delegated components
+ * - GridRenderer: Rendering (header, body, cells)
+ * - GridFilterPopup: Filter UI
+ * - GridColumnMenu: Column context menu
+ * - GridDragManager: Column/Row drag & resize
+ * - GridHistory: Undo/Redo management
+ * - Column caching for performance
+ */
+import type { GridOptions, GridState, RowData, ColumnDefinition, SortState, SortDirection, FilterState, FilterCondition, CellValue, VeloxGridInstance, GridEvents, FilterOperator, CellIndex, Selection, ExportOptions, UndoAction, GridContext, RowStateType, ChangesResult, PaginationState } from '../types';
+import { type ImportResult } from '../utils/export';
+export declare class VeloxGrid implements VeloxGridInstance, GridContext {
+    private container;
+    private options;
+    private state;
+    private events;
+    private gridId;
+    rootElement: HTMLElement;
+    headerElement: HTMLElement;
+    bodyElement: HTMLElement;
+    bodyInner: HTMLElement;
+    footerElement: HTMLElement | null;
+    fixedLeftFooter: HTMLElement | null;
+    loadingOverlay: HTMLElement | null;
+    fixedLeftContainer: HTMLElement | null;
+    fixedLeftHeader: HTMLElement | null;
+    fixedLeftBody: HTMLElement | null;
+    fixedLeftBodyInner: HTMLElement | null;
+    fixedRightContainer: HTMLElement | null;
+    fixedRightHeader: HTMLElement | null;
+    fixedRightBody: HTMLElement | null;
+    fixedRightBodyInner: HTMLElement | null;
+    fixedRightFooter: HTMLElement | null;
+    paginationContainer: HTMLElement | null;
+    private infiniteScrollLoading;
+    private infiniteScrollAllLoaded;
+    private blockSelecting;
+    private measureCanvas;
+    private measureContext;
+    private boundHandleBlockSelectionEnd;
+    private boundHandleKeyDown;
+    private virtualState;
+    private dataIndexMap;
+    private columnCache;
+    private history;
+    private tooltip;
+    private editModeCleanup;
+    private renderer;
+    private filterPopupManager;
+    private columnMenuManager;
+    private dragManager;
+    private summary;
+    constructor(container: HTMLElement | string, options: GridOptions, events?: GridEvents);
+    rebuildDataIndexMap(): void;
+    initCheckableRows(): void;
+    invalidateColumnCache(): void;
+    /**
+     * Get special columns with displayOrder
+     * Phase 14.1: Helper method to generate special columns sorted by displayOrder
+     */
+    private getSpecialColumnsWithOrder;
+    /**
+     * Get fixed left columns
+     * Phase 14: Only include special columns when fixedOptions.colCount > 0
+     * Phase 14.1: Sort special columns by displayOrder
+     *
+     * Logic:
+     * - If colCount = 0: Fixed left is empty (special columns go to scrollable)
+     * - If colCount > 0: Fixed left = special columns (sorted by displayOrder) + first N data columns
+     */
+    getFixedLeftColumns(): ColumnDefinition[];
+    /**
+     * Get columns fixed to right (based on fixedOptions.rightCount)
+     * Phase 14: New method for right fixed columns
+     */
+    getFixedRightColumns(): ColumnDefinition[];
+    /**
+     * Get scrollable columns (middle area between fixed left and fixed right)
+     * Phase 14: Include special columns when colCount = 0
+     * Phase 14.1: Sort special columns by displayOrder
+     *
+     * Logic:
+     * - If colCount = 0: Scrollable = special columns (sorted by displayOrder) + all data columns (except fixed right)
+     * - If colCount > 0: Scrollable = middle data columns only (between fixed left and fixed right)
+     */
+    getScrollableColumns(): ColumnDefinition[];
+    /**
+     * Get data columns (exclude special columns)
+     * Phase 14: Helper method to filter out special columns
+     */
+    private getDataColumns;
+    /**
+     * Check if column is special (CheckBar, RowNumbers, DragHandle)
+     * Phase 14: Helper method to identify special columns
+     */
+    private isSpecialColumn;
+    getVisibleColumns(): ColumnDefinition[];
+    /**
+     * Check if grid has fixed left columns
+     * Phase 14: Only true when fixedOptions.colCount > 0
+     */
+    hasFixedLeft(): boolean;
+    /**
+     * Check if grid has fixed right columns
+     * Phase 14: New method for hasFixedRight
+     */
+    hasFixedRight(): boolean;
+    private build;
+    private buildLoadingOverlay;
+    calculateVirtualState(): void;
+    getVisibleRows(): {
+        data: RowData;
+        index: number;
+    }[];
+    render(): void;
+    renderHeader(): void;
+    renderBody(): void;
+    updateLoadingState(): void;
+    showFilterPopup(column: ColumnDefinition, anchor: HTMLElement): void;
+    closeFilterPopup(): void;
+    applyColumnFilter(field: string, operator: FilterOperator, value: CellValue): void;
+    removeColumnFilter(field: string): void;
+    private scrollHandlers;
+    private wheelHandler;
+    private detachEvents;
+    private attachEvents;
+    handleSort(field: string): void;
+    handleRowClick(rowIndex: number, e: MouseEvent): void;
+    handleRowSelection(rowIndex: number, e: MouseEvent): void;
+    handleCellClick(rowIndex: number, field: string, value: CellValue, e: MouseEvent): void;
+    handleCellSelection(rowIndex: number, field: string, e: MouseEvent): void;
+    selectCellRange(startRow: number, startField: string, endRow: number, endField: string): void;
+    startBlockSelection(rowIndex: number, field: string): void;
+    updateBlockSelection(rowIndex: number, field: string): void;
+    handleBlockSelectionEnd(): void;
+    handleRowDoubleClick(rowIndex: number, _e: MouseEvent): void;
+    handleKeyDown(e: KeyboardEvent): void;
+    private selectAllCells;
+    startResize(e: MouseEvent, column: ColumnDefinition): void;
+    applyDataTransformations(): void;
+    /**
+     * Clear all selection state (rows, cells, focused cell)
+     * Extracted to reduce code duplication
+     */
+    clearSelectionState(): void;
+    getData(): RowData[];
+    setData(data: RowData[]): void;
+    getRow(index: number): RowData | null;
+    getRowCount(): number;
+    getVisibleRowCount(): number;
+    addRow(row: RowData, index?: number): void;
+    updateRow(index: number, data: Partial<RowData>): void;
+    removeRow(index: number): void;
+    clearData(): void;
+    getSelectedRows(): number[];
+    getSelectedData(): RowData[];
+    selectRow(index: number, selected?: boolean): void;
+    selectAll(selected?: boolean): void;
+    clearSelection(): void;
+    isRowSelected(index: number): boolean;
+    selectCell(rowIndex: number, field: string, selected?: boolean): void;
+    getSelectedCells(): CellIndex[];
+    setFocusedCell(rowIndex: number, field: string): void;
+    getFocusedCell(): CellIndex | null;
+    setSelection(selection: Selection): void;
+    getSelection(): Selection | null;
+    getSelectionData(): CellValue[][];
+    checkItem(index: number, checked?: boolean): void;
+    checkItems(indices: number[], checked?: boolean): void;
+    checkAll(checked?: boolean): void;
+    uncheckAll(): void;
+    getCheckedItems(): number[];
+    getCheckedData(): RowData[];
+    isItemChecked(index: number): boolean;
+    isItemCheckable(index: number): boolean;
+    checkRow(index: number, checked?: boolean): void;
+    getCheckedRows(): number[];
+    sort(field: string, direction?: SortDirection): void;
+    clearSort(): void;
+    getSortState(): SortState[];
+    filter(conditions: FilterCondition | FilterCondition[]): void;
+    clearFilter(): void;
+    getFilterState(): FilterState | null;
+    startEdit(rowIndex: number, field: string): void;
+    renderEditCell(rowIndex: number, field: string, value: CellValue): void;
+    endEdit(save?: boolean): void;
+    cancelEdit(): void;
+    isEditing(): boolean;
+    /**
+     * End edit and move to adjacent cell (Phase 9)
+     */
+    private endEditAndMove;
+    getColumn(field: string): ColumnDefinition | null;
+    setColumnWidth(field: string, width: number): void;
+    showColumn(field: string): void;
+    hideColumn(field: string): void;
+    setColumns(columns: ColumnDefinition[]): void;
+    autoFitColumn(field: string): void;
+    autoFitAllColumns(): void;
+    measureTextWidth(text: string, font?: string): number;
+    scrollToRow(index: number): void;
+    scrollToTop(): void;
+    scrollToBottom(): void;
+    scrollToCell(rowIndex: number, field: string): void;
+    copy(): void;
+    paste(): void;
+    cut(): void;
+    pushUndo(action: UndoAction): void;
+    undo(): boolean;
+    redo(): boolean;
+    canUndo(): boolean;
+    canRedo(): boolean;
+    clearHistory(): void;
+    deleteSelectedCells(): void;
+    deleteSelectedRows(): void;
+    private createExportContext;
+    /**
+     * Export grid data to Excel (.xlsx) file
+     * Requires SheetJS library to be loaded via CDN:
+     * <script src="https://cdn.sheetjs.com/xlsx-0.20.1/package/dist/xlsx.full.min.js"></script>
+     */
+    exportToExcel(options?: ExportOptions): void;
+    /**
+     * Export grid data to CSV format
+     * @returns CSV string
+     */
+    exportToCSV(options?: ExportOptions): string;
+    /**
+     * Export grid data to JSON format
+     * @returns JSON string
+     */
+    exportToJSON(options?: ExportOptions): string;
+    /**
+     * Download grid data as CSV file
+     */
+    downloadCSV(options?: ExportOptions): void;
+    /**
+     * Download grid data as JSON file
+     */
+    downloadJSON(options?: ExportOptions): void;
+    /**
+     * Import data from CSV string
+     * @param csvString CSV content
+     * @param hasHeader Whether first row is header (default: true)
+     */
+    importFromCSV(csvString: string, hasHeader?: boolean): ImportResult;
+    /**
+     * Import data from Excel file
+     * Requires SheetJS library to be loaded via CDN
+     * @param file Excel file (File object)
+     * @param sheetIndex Sheet index to import (default: 0)
+     */
+    importFromExcel(file: File, sheetIndex?: number): Promise<ImportResult>;
+    /**
+     * Check if SheetJS library is available for Excel operations
+     */
+    static isExcelSupported(): boolean;
+    getCellValue(rowIndex: number, field: string): CellValue;
+    setCellValue(rowIndex: number, field: string, value: CellValue): void;
+    /**
+     * Get summary value for a specific field
+     * @param field Column field name
+     * @returns Calculated summary value
+     */
+    getSummaryValue(field: string): CellValue;
+    /**
+     * Get all summary values
+     * @returns Object with field names as keys and summary values
+     */
+    getSummaryValues(): Record<string, CellValue>;
+    /**
+     * Refresh summary calculations (clear cache)
+     */
+    refreshSummary(): void;
+    setOptions(options: Partial<GridOptions>): void;
+    getOptions(): GridOptions;
+    setLoading(loading: boolean): void;
+    refresh(): void;
+    /**
+     * Fix/unfix column to a position
+     */
+    fixColumn(field: string, position: 'left' | 'right' | false): void;
+    /**
+     * Reorder column to new position
+     */
+    reorderColumn(sourceField: string, targetField: string): void;
+    showColumnMenu(column: ColumnDefinition, anchor: HTMLElement): void;
+    closeColumnMenu(): void;
+    startColumnDrag(e: MouseEvent, column: ColumnDefinition): void;
+    /**
+     * Move row to new position
+     */
+    moveRow(fromIndex: number, toIndex: number): void;
+    startRowDrag(e: MouseEvent, rowIndex: number, rowElement: HTMLElement): void;
+    /** GridContext: 그리드 상태 반환 */
+    getState(): GridState;
+    /** GridContext: 이벤트 핸들러 반환 */
+    getEvents(): GridEvents;
+    /** GridContext: 그리드 고유 ID 반환 */
+    getGridId(): string;
+    /** GridContext: 표시 데이터 반환 */
+    getDisplayData(): RowData[];
+    /** GridContext: 가상 스크롤 상태 반환 */
+    getVirtualState(): typeof this.virtualState;
+    /** GridContext: 이벤트 발행 헬퍼 */
+    emitEvent<K extends keyof GridEvents>(event: K, ...args: Parameters<NonNullable<GridEvents[K]>>): void;
+    /** GridContext: Block selection 상태 확인 */
+    isBlockSelecting(): boolean;
+    /** GridContext: Tooltip 표시 */
+    showTooltip(cell: HTMLElement, value: CellValue, rowData: RowData, column: ColumnDefinition): void;
+    /** GridContext: Tooltip 숨기기 */
+    hideTooltip(): void;
+    /**
+     * Set fixed columns options
+     * @param options - Fixed options (colCount, rightCount)
+     */
+    setFixedOptions(options: import('../types').FixedOptions): void;
+    /**
+     * Rebuild DOM structure and re-attach events
+     * Phase 14: For dynamic fixed columns
+     */
+    private rebuildDOM;
+    /**
+     * Get current fixed columns options
+     * @returns Fixed options
+     */
+    getFixedOptions(): import('../types').FixedOptions;
+    /**
+     * Get row state by display index
+     * @param index - Display index (in displayData array)
+     * @returns Row state type
+     */
+    getRowState(index: number): RowStateType;
+    /**
+     * Get row state by row data object
+     * @param row - Row data object
+     * @returns Row state type
+     */
+    getRowStateByData(row: RowData): RowStateType;
+    /**
+     * Set row state manually
+     * @param index - Display index
+     * @param state - New state
+     */
+    setRowState(index: number, state: RowStateType): void;
+    /**
+     * Get all changes (created, updated, deleted rows)
+     * @returns Changes result with separated arrays
+     */
+    getChanges(): ChangesResult;
+    /**
+     * Get newly created rows
+     * @returns Array of created rows
+     */
+    getCreatedRows(): RowData[];
+    /**
+     * Get updated rows
+     * @returns Array of updated rows
+     */
+    getUpdatedRows(): RowData[];
+    /**
+     * Get deleted rows (marked for deletion)
+     * @returns Array of deleted rows
+     */
+    getDeletedRows(): RowData[];
+    /**
+     * Clear all row states (reset to 'none')
+     */
+    clearRowStates(): void;
+    /**
+     * Commit changes (mark all rows as 'none')
+     * This is typically called after successfully saving changes to server
+     */
+    commit(): void;
+    /**
+     * Remote 데이터 소스 여부 확인
+     */
+    isRemoteDataSource(): boolean;
+    /**
+     * 페이지네이션 상태 조회
+     */
+    getPaginationState(): PaginationState;
+    /**
+     * 특정 페이지로 이동
+     * @param page - 이동할 페이지 번호 (1-based)
+     */
+    goToPage(page: number): void;
+    /**
+     * 페이지 크기 변경
+     * @param pageSize - 새 페이지 크기
+     */
+    setPageSize(pageSize: number): void;
+    /**
+     * 서버에서 데이터 가져오기 (remote 모드)
+     */
+    fetchData(): Promise<void>;
+    /**
+     * 전체 페이지 수 재계산
+     */
+    private updateTotalPages;
+    /**
+     * 로컬 데이터에 페이지네이션 적용
+     * sort/filter 적용 후 현재 페이지 데이터만 displayData에 설정
+     */
+    private applyLocalPagination;
+    /**
+     * Infinite Scroll: 스크롤 바닥 감지 (Phase 18)
+     */
+    private checkInfiniteScroll;
+    /**
+     * Infinite Scroll: 다음 페이지 로드 (Phase 18)
+     */
+    private loadNextPage;
+    /**
+     * Local Infinite Scroll: 다음 페이지 데이터 추가 (Phase 18)
+     */
+    private applyLocalInfiniteScroll;
+    /**
+     * Infinite Scroll 상태 표시 렌더링 (Phase 18)
+     */
+    private renderInfiniteScrollStatus;
+    /**
+     * Pagination UI 렌더링 (Phase 18)
+     */
+    private renderPagination;
+    /**
+     * 페이지 버튼 생성 헬퍼 (Phase 18)
+     */
+    private createPageButton;
+    destroy(): void;
+}
+//# sourceMappingURL=VeloxGrid.d.ts.map

package/dist/types/core/VeloxGrid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VeloxGrid.d.ts","sourceRoot":"","sources":["../../../src/core/VeloxGrid.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,15 @@
+/**
+ * VeloxGrid Core Module Exports
+ */
+export { VeloxGrid } from './VeloxGrid';
+export { GridHistory } from './GridHistory';
+export { GridValidator } from './GridValidator';
+export { GridEditorFactory } from './GridEditorFactory';
+export { GridTooltip } from './GridTooltip';
+export { GridRenderer } from './GridRenderer';
+export { GridFilterPopup } from './GridFilterPopup';
+export { GridColumnMenu } from './GridColumnMenu';
+export { GridDragManager } from './GridDragManager';
+export { GridSummary } from './GridSummary';
+export type { HistoryOptions } from './GridHistory';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C,YAAY,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * VeloxGrid
+ * A fast, lightweight, and framework-agnostic data grid library
+ *
+ * @author bumki
+ * @license MIT
+ * @version 0.9.1
+ */
+export { VeloxGrid } from './core';
+export type { ValueType, CellValue, RowData, ColumnDefinition, GridOptions, SortDirection, SortState, FilterOperator, FilterCondition, FilterState, SelectionState, SelectionMode, SelectionStyle, CellIndex, Selection, CheckBarOptions, CheckBarState, RowNumbersOptions, RowDragOptions, RowStateType, RowStateManager, ChangesResult, EditState, CellEditEvent, ExportOptions, ImportResult, GridEvents, VeloxGridInstance, GridState, RenderContext, } from './types';
+export { createElement, addClass, removeClass, toggleClass, hasClass, setStyles, throttle, debounce, } from './utils/dom';
+export { deepClone, generateId, formatValue, parseValue, compareValues, sortData, filterData, escapeHtml, } from './utils/data';
+export { exportToExcel, exportToCSV, exportToJSON, downloadFile, downloadCSV, downloadJSON, parseCSV, importFromExcel, importFromExcelBySheetName, isSheetJSAvailable, type ExportContext, } from './utils/export';
+import './styles/velox-grid.css';
+export declare const VERSION = "0.11.0";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAGnC,YAAY,EAEV,SAAS,EACT,SAAS,EACT,OAAO,EAGP,gBAAgB,EAGhB,WAAW,EAGX,aAAa,EACb,SAAS,EACT,cAAc,EACd,eAAe,EACf,WAAW,EAGX,cAAc,EACd,aAAa,EACb,cAAc,EACd,SAAS,EACT,SAAS,EACT,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,cAAc,EAGd,YAAY,EACZ,eAAe,EACf,aAAa,EAGb,SAAS,EACT,aAAa,EAGb,aAAa,EACb,YAAY,EAGZ,UAAU,EAGV,iBAAiB,EAGjB,SAAS,EACT,aAAa,GACd,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,aAAa,EACb,QAAQ,EACR,WAAW,EACX,WAAW,EACX,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,QAAQ,GACT,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,SAAS,EACT,UAAU,EACV,WAAW,EACX,UAAU,EACV,aAAa,EACb,QAAQ,EACR,UAAU,EACV,UAAU,GACX,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,aAAa,EACb,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,eAAe,EACf,0BAA0B,EAC1B,kBAAkB,EAClB,KAAK,aAAa,GACnB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,yBAAyB,CAAC;AAGjC,eAAO,MAAM,OAAO,WAAW,CAAC"}

package/dist/types/react/VeloxGridReact.d.ts

@@ -0,0 +1,40 @@
+/**
+ * VeloxGrid React Component
+ * @description React wrapper for VeloxGrid
+ * Phase 17: Framework Wrappers (React)
+ *
+ * GridOptions를 Props로 전달하고, GridEvents를 콜백으로 바인딩합니다.
+ * ref를 통해 VeloxGrid 인스턴스의 모든 public 메서드에 접근할 수 있습니다.
+ */
+import type { VeloxGridReactProps, VeloxGridReactRef } from './types';
+/**
+ * VeloxGridReact 컴포넌트
+ *
+ * @example
+ * ```tsx
+ * import { VeloxGridReact } from 'velox-grid/react';
+ *
+ * function App() {
+ *   const gridRef = useRef<VeloxGridReactRef>(null);
+ *
+ *   return (
+ *     <VeloxGridReact
+ *       ref={gridRef}
+ *       columns={[
+ *         { field: 'name', header: 'Name', width: 150 },
+ *         { field: 'age', header: 'Age', type: 'number', width: 80 },
+ *       ]}
+ *       data={[
+ *         { name: 'Alice', age: 30 },
+ *         { name: 'Bob', age: 25 },
+ *       ]}
+ *       height={400}
+ *       editable={true}
+ *       onCellEditEnd={(e) => console.log('Edit:', e)}
+ *     />
+ *   );
+ * }
+ * ```
+ */
+export declare const VeloxGridReact: import("react").ForwardRefExoticComponent<VeloxGridReactProps & import("react").RefAttributes<VeloxGridReactRef>>;
+//# sourceMappingURL=VeloxGridReact.d.ts.map

package/dist/types/react/VeloxGridReact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VeloxGridReact.d.ts","sourceRoot":"","sources":["../../../src/react/VeloxGridReact.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AA6EtE;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,cAAc,mHAyN1B,CAAC"}

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

@@ -0,0 +1,9 @@
+/**
+ * VeloxGrid React Wrapper
+ * @description React component and hook for VeloxGrid
+ * Phase 17: Framework Wrappers (React)
+ */
+export { VeloxGridReact } from './VeloxGridReact';
+export { useVeloxGrid } from './useVeloxGrid';
+export type { VeloxGridReactProps, VeloxGridReactRef } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/react/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/react/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,YAAY,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC"}

package/dist/types/react/types.d.ts

@@ -0,0 +1,55 @@
+/**
+ * VeloxGrid React Wrapper Types
+ * Phase 17: Framework Wrappers (React)
+ */
+import type { GridOptions, GridEvents, VeloxGridInstance } from '../types';
+/**
+ * VeloxGridReact 컴포넌트 Props
+ * GridOptions의 모든 옵션을 Props로 전달할 수 있으며,
+ * GridEvents의 모든 이벤트를 콜백 Props로 전달할 수 있습니다.
+ *
+ * @example
+ * ```tsx
+ * <VeloxGridReact
+ *   columns={columns}
+ *   data={data}
+ *   height={400}
+ *   editable={true}
+ *   onCellEditEnd={(e) => console.log(e)}
+ * />
+ * ```
+ */
+export interface VeloxGridReactProps extends GridOptions, GridEvents {
+    /**
+     * 컨테이너에 적용할 CSS 클래스
+     * GridOptions.className과 별개로 wrapper div에 적용됩니다.
+     */
+    wrapperClassName?: string;
+    /**
+     * 컨테이너에 적용할 인라인 스타일
+     */
+    wrapperStyle?: React.CSSProperties;
+}
+/**
+ * VeloxGridReact ref를 통해 접근 가능한 메서드
+ * VeloxGridInstance의 모든 메서드를 포함합니다.
+ *
+ * @example
+ * ```tsx
+ * const gridRef = useRef<VeloxGridReactRef>(null);
+ *
+ * // 데이터 조회
+ * const data = gridRef.current?.getData();
+ *
+ * // 행 추가
+ * gridRef.current?.addRow({ name: 'New', value: 100 });
+ * ```
+ */
+export interface VeloxGridReactRef extends VeloxGridInstance {
+    /**
+     * 내부 VeloxGrid 인스턴스에 직접 접근
+     * 일반적으로 ref 메서드를 사용하되, 고급 시나리오에서 사용
+     */
+    getGridInstance(): VeloxGridInstance | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types/react/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/react/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE3E;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,mBAAoB,SAAQ,WAAW,EAAE,UAAU;IAClE;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;OAEG;IACH,YAAY,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;CACpC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,iBAAkB,SAAQ,iBAAiB;IAC1D;;;OAGG;IACH,eAAe,IAAI,iBAAiB,GAAG,IAAI,CAAC;CAC7C"}

package/dist/types/react/useVeloxGrid.d.ts

@@ -0,0 +1,54 @@
+/**
+ * useVeloxGrid Hook
+ * @description VeloxGrid 인스턴스를 React에서 편리하게 사용하기 위한 Hook
+ * Phase 17: Framework Wrappers (React)
+ *
+ * @example
+ * ```tsx
+ * import { useVeloxGrid } from 'velox-grid/react';
+ *
+ * function App() {
+ *   const { containerRef, grid } = useVeloxGrid({
+ *     columns: [
+ *       { field: 'name', header: 'Name' },
+ *       { field: 'age', header: 'Age', type: 'number' },
+ *     ],
+ *     data: [{ name: 'Alice', age: 30 }],
+ *     height: 400,
+ *     editable: true,
+ *     onCellEditEnd: (e) => console.log(e),
+ *   });
+ *
+ *   return (
+ *     <div>
+ *       <button onClick={() => grid?.addRow({ name: 'New', age: 0 })}>
+ *         Add Row
+ *       </button>
+ *       <div ref={containerRef} />
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+import type { GridOptions, GridEvents, VeloxGridInstance } from '../types';
+type UseVeloxGridOptions = GridOptions & Partial<GridEvents>;
+interface UseVeloxGridReturn {
+    /** 그리드가 마운트될 컨테이너 ref (div에 연결) */
+    containerRef: React.RefObject<HTMLDivElement | null>;
+    /** VeloxGrid 인스턴스 (초기화 전 null) */
+    grid: VeloxGridInstance | null;
+    /** 그리드 초기화 여부 */
+    isReady: boolean;
+}
+/**
+ * useVeloxGrid Hook
+ *
+ * GridOptions + GridEvents를 받아서 VeloxGrid 인스턴스를 생성하고 관리합니다.
+ * containerRef를 div에 연결하면 자동으로 그리드가 초기화됩니다.
+ *
+ * @param options - GridOptions와 GridEvents를 합친 옵션 객체
+ * @returns containerRef, grid 인스턴스, isReady 상태
+ */
+export declare function useVeloxGrid(options: UseVeloxGridOptions): UseVeloxGridReturn;
+export {};
+//# sourceMappingURL=useVeloxGrid.d.ts.map

package/dist/types/react/useVeloxGrid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useVeloxGrid.d.ts","sourceRoot":"","sources":["../../../src/react/useVeloxGrid.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE3E,KAAK,mBAAmB,GAAG,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAE7D,UAAU,kBAAkB;IAC1B,mCAAmC;IACnC,YAAY,EAAE,KAAK,CAAC,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IACrD,kCAAkC;IAClC,IAAI,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC/B,iBAAiB;IACjB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,kBAAkB,CAkC7E"}