qcell-react 1.1.0 → 1.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qcell-react",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "QCELL component for React. Righttech Co., Ltd. All rights reserved.",
   "main": "dist/index.js",
   "types": "./src/types/index.d.ts",

package/src/types/index.d.ts

@@ -1,30 +1,376 @@
 import * as React from "react";
 
-export interface QCELLInstance {
-  setData?: (data: any[]) => void;
+export type QCELLAnyObject = Record<string, any>;
+export type QCELLRowData = QCELLAnyObject | any[];
+export type QCELLStyle = React.CSSProperties | QCELLAnyObject;
+
+export interface QCELLColumn {
+  key?: string;
+  title?: string[];
+  width?: string | number;
+  sort?: boolean;
+  type?: string;
+  format?: QCELLAnyObject;
+  style?: QCELLStyle;
+  [key: string]: any;
+}
+
+export interface QCELLRowHeight {
+  header?: number;
+  data?: number;
+  footer?: number;
+  [key: string]: any;
+}
 
-  removeRow?: () => void;
-  deleteRow?: (row: number) => void;
-  removeRows?: (count: number) => void;
-  deleteRows?: (row: number, count: number) => void;
-  deleteRowsEx?: (rows: number[]) => void;
+export interface QCELLPagination {
+  unitlist?: number[];
+  pageunit?: number;
+  pagecount?: number;
+  mode?: "simple" | "extend" | string;
+  [key: string]: any;
+}
 
-  addRow?: (row: any) => void;
-  insertRow?: (row: number, data: any) => void;
-  addRows?: (rows: any[]) => void;
-  insertRows?: (row: number, rows: any[]) => void;
-  insertRowsEx?: (items: [number, any][]) => void;
+export interface ObjPropertyType {
+  id?: string;
+  parentid?: string;
+  width?: string | number;
+  height?: string | number;
+  data?: {
+    input?: QCELLRowData[];
+    [key: string]: any;
+  } | QCELLRowData[];
+  columns?: QCELLColumn[];
+  rowheight?: QCELLRowHeight;
+  rowHeight?: QCELLRowHeight;
+  pagination?: QCELLPagination;
+  [key: string]: any;
+}
 
-  setPageUnit?: (pageUnit: number) => void;
+export interface QCELLInstance {
+  /** QCELL의 모든 설정을 초기화하고 UI를 재생성합니다. */
+  rebuild?: (bUsePrevData?: any) => boolean;
+  /** QCELL 의 크기 변경된 정보로 UI를 재구성 합니다. */
+  resize?: (bUsePrevData?: any) => boolean;
+  setBottomPanelData?: (strData: any) => any;
+  /** QCELL의 현재 화면을 갱신합니다. */
+  refresh?: () => boolean;
+  /** 그리드를 초기화 한다.. */
+  initGrid?: (bUsePrevData?: any) => boolean;
+  /** QCELL의 ID를 반환합니다. */
+  getID?: () => string;
+  /** 입력받은 조건에 해당하는 행(또는 열) 인덱스를 반환합니다. */
+  getIdx?: (axis: string, type?: string, point_of_time?: string) => number;
+  /** 입력받은 영역에 해당하는 행의 개수를 반환합니다. */
+  getRows?: (type?: string) => number;
+  /** 입력받은 영역에 해당하는 열의 개수를 반환합니다. */
+  getCols?: (type?: string) => number;
+  /** 지정한 영역의 행 높이를 반환합니다. */
+  getRowHeight?: (type?: string) => number;
+  /** 전체 열의 너비값을 배열로 반환합니다. */
+  getColWidths?: () => any[];
+  /** 컬럼을 삭제 한다. */
+  removeColumn?: (nCol: number) => boolean;
+  /** 컬럼을 추가 한다. */
+  insertColumn?: (nCol: number, objCol: Record<string, any>) => boolean;
+  /** 컬럼을 생성 시점으로 초기화 한다. */
+  resetColumns?: () => boolean;
+  /** 입력받은 "key" 속성값이 설정된 열들의 인덱스를 배열로 반환합니다. */
+  getColsOfKey?: (key: string) => any[];
+  /** 입력받은 "key" 속성값이 설정된 열들의 인덱스를 넘버로 반환합니다. */
+  getColOfKey?: (key: string) => number;
+  /** 입력받은 열 인덱스에 해당하는 열에 설정된 "key" 속성값을 반환합니다. */
+  getKeyOfCol?: (col: number) => string;
+  /** 입력받은 열 인덱스에 해당하는 열에 설정된 "key" 값을 변경 합니다. */
+  setKeyOfCol?: (col: number, key: string) => string;
+  /** 입력받은 열 인덱스의 열 ID를 반환합니다. */
+  getColID?: (col: number) => string;
+  /** 입력받은 열 ID에 해당하는 열 인덱스를 반환합니다. */
+  getColOfID?: (id: string) => number;
+  /** 입력한 열 인덱스에 해당하는 열의 너비를 반환합니다.(단위: pixel) */
+  getColWidth?: (col: number) => number;
+  /** 입력한 열 인덱스에 해당하는 열의 너비를 반환합니다.(단위: pixel) */
+  getColWidthEx?: (col: any) => number;
+  /** 입력받은 열 인덱스에 해당하는 컬럼의 넓이를 변경합니다.(단위: pixel) */
+  setColWidth?: (col: number, colwidth: number) => boolean;
+  /** 입력받은 열 인덱스에 해당하는 컬럼의 넓이를 변경합니다.(단위: pixel) */
+  setColWidthEx?: (key: string, colwidth: number) => boolean;
+  /** 입력한 열 인덱스에 해당하는 열의 타입을 반환합니다. */
+  getColType?: (col: number) => string;
+  /** 입력받은 열 인덱스에 해당하는 열에 Format을 설정합니다. */
+  setColFormatStatic?: (nCol: number, formatstatic: Record<string, any>) => boolean;
+  /** 입력한 열 인덱스에 해당하는 열의 속성을 반환한다.. */
+  getColAttribute?: (col: number, strName: any) => string;
+  /** 고정열 인텍스를 반환한다. */
+  getFrozenRows?: () => number;
+  /** 고정행을 새로 설정 한다. */
+  setFrozenRows?: (nIndex: number) => boolean;
+  /** 고정행 인텍스를 반환한다. */
+  getFrozenCols?: () => number;
+  /** 고정열을 새로 설정 한다. */
+  setFrozenCols?: (nIndex: number) => boolean;
+  /** 오른쪽 고정열 인텍스를 반환한다. */
+  getFrozenRightCols?: () => number;
+  /** 고정열을 새로 설정 한다. */
+  setFrozenRightCols?: (nIndex: number) => boolean;
+  /** 하단 고정행 인텍스를 반환한다. */
+  getFrozenBottomRows?: () => number;
+  /** 하단 고정행을 새로 설정 한다. */
+  setFrozenBottomRows?: (nIndex: number) => boolean;
+  /** 현재 컬럼의 정보를 얻는다. */
+  getColumnInfo?: (nCol: number) => Record<string, any>;
+  /** 현재 컬럼들의 최신 정보를 얻는다. */
+  getCurrentColumnsInfo?: () => any[];
+  /** resize action 수행 여부 설정. */
+  setResizeAction?: (bData: any) => any[];
+  /** 행 스타일을 반복하여 적용하는 "highlightrepeat" 속성의 값을 반환합니다. */
+  getHighlightRepeat?: () => number;
+  /** 행 스타일을 반복하여 적용하는 "highlightrepeat" 속성의 주기를 설정합니다. */
+  setHighlightRepeat?: (cycle: number) => boolean;
+  /** 지정한 열의 셀에 "셀 단위 스타일"을 설정합니다. */
+  setColStyle?: (col: number, style: Record<string, any>, type?: string) => boolean;
+  /** 지정한 열의 셀에 설정된 "셀 단위 스타일"을 제거합니다. */
+  removeColStyle?: (col: number, type?: string) => boolean;
+  /** 지정한 행의 셀에 "셀 단위 스타일"을 설정합니다. */
+  setRowStyle?: (row: number, style: Record<string, any>, type?: string) => boolean;
+  /** 지정한 행의 셀에 설정된 "셀 단위 스타일"을 제거합니다. */
+  removeRowStyle?: (row: number, type?: string) => boolean;
+  /** 지정한 인덱스의 셀에 설정된 "셀 단위 스타일" 정보를 반환합니다. ("열 단위 스타일"이 함께 설정된 경우라도 "셀 단위 스타일" 정보만을 반환합니다.) */
+  getCellStyle?: (row: number, col: number) => Record<string, any>;
+  /** 지정한 셀에 "셀 단위 스타일"을 설정합니다. */
+  setCellStyle?: (row: number, col: number, style: Record<string, any>) => boolean;
+  /** 지정한 범위 내의 셀들에 "셀 단위 스타일"을 설정합니다. */
+  setCellStyles?: (firstrow: number, firstcol: number, lastrow: number, lastcol: number, style: Record<string, any>) => boolean;
+  /** 지정한 셀에 설정된 "셀 단위 스타일"을 제거합니다. */
+  removeCellStyle?: (row: number, col: number) => boolean;
+  /** 지정한 범위 내의 셀들에 "셀 단위 스타일"을 제거합니다. */
+  removeCellStyles?: (firstrow: number, firstcol: number, lastrow: number, lastcol: number) => boolean;
+  /** QCELL에 적용된 모든 "셀 단위 스타일"을 제거합니다. */
+  clearCellStyles?: () => boolean;
+  /** QCELL 생성 이후 적용된 모든 스타일변경사항("열 단위 스타일", "셀 단위 스타일", "highlightrepeat")을 초기화합니다. */
+  clearDynamicStyles?: () => boolean;
+  /** 가장 마지막에 선택된 셀의 행 인덱스를 반환합니다. */
+  getSelectedRow?: () => number;
+  /** 가장 마지막에 선택된 셀의 열 인덱스를 반환합니다. */
+  getSelectedCol?: () => number;
+  /** 선택된 셀들의 행 인덱스를 배열로 반환합니다. */
+  getSelectedRows?: () => any[];
+  /** 선택된 셀들의 열 인덱스를 배열로 반환합니다. */
+  getSelectedCols?: () => any[];
+  /** 입력받은 열 인덱스에 해당하는 컬럼을 특정 위치로 이동시킵니다. */
+  moveCol?: (beforecol: number, aftercol: number) => boolean;
+  /** 입력받은 행 인덱스로 세로 스크롤바의 scrollTop을 설정합니다. */
+  scrollTop?: (row: number) => any[];
+  /** 스크롤바의 scrollTop을 반환합니다. */
+  getScrollTop?: () => number;
+  /** 스크롤바의 scrollTop을 반환합니다. */
+  getScrollLeft?: () => number;
+  /** 입력받은 열 인덱스로 가로 스크롤바의 scrollLeft를 설정합니다. */
+  scrollLeft?: (col: number) => any[];
+  /** 입력받은 타입에 해당하는 스크롤바의 표시 여부를 반환합니다. */
+  isScroll?: (type?: string) => boolean;
+  /** 갱신된 화면 위치 반환 */
+  getUpdateInfo?: () => Record<string, any>;
+  /** QCELL의 데이터를 반환합니다. */
+  getData?: () => any[];
+  /** QCELL의 모든 데이터를 반환합니다. */
+  getAllData?: () => any[];
+  /** QCELL의 모든 데이터를 포멧이 적용 된 형태로 반환합니다. */
+  getAllDataWithFormat?: () => any[];
+  /** 입력받은 데이터로 QCELL 데이터를 갱신합니다. */
+  setData?: (data: any[], bForce?: boolean) => boolean;
+  /** QCELL 데이터를 초기화합니다. */
+  clearData?: () => boolean;
+  /** 입력받은 행 인덱스의 "행 단위 데이터"를 객체(또는 배열)로 반환합니다. */
+  getRowData?: (row: number) => Record<string, any> | any[] | any;
+  /** 입력받은 행 인덱스의 "행 단위 데이터"를 format 이 적용되어 객체(또는 배열)로 반환합니다. */
+  getRowDataWithFormat?: (row: number) => Record<string, any> | any[] | any;
+  /** 현재 선택되어진 행 인덱스의 "행 단위 데이터"를 객체(또는 배열)로 반환합니다. */
+  getSelectedRowData?: () => Record<string, any> | any[] | any;
+  /** 입력받은 행 인덱스의 "행 단위 데이터"를 갱신합니다. */
+  setRowData?: (row: number, data: Record<string, any> | any[]) => boolean;
+  /** 입력받은 행 인덱스의 "행 단위 데이터"를 갱신합니다. */
+  setRowDataEx?: (row: number, data: Record<string, any> | any[]) => boolean;
+  /** 입력받은 열의 "열 단위 데이터"를 배열로 반환합니다. */
+  getColData?: (col: number) => any[];
+  /** 입력받은 열 인덱스의 "열 단위 데이터"를 갱신합니다. */
+  setColData?: (col: number, data: any[]) => boolean;
+  /** 입력받은 행,열 인덱스에 해당하는 셀의 데이터를 반환합니다. */
+  getCellData?: (row: number, col: number) => any;
+  /** 입력받은 행,key 에 해당하는 셀의 데이터를 반환합니다. */
+  getCellDataEx?: (row: number, key: string) => any;
+  /** 입력받은 행,key 에 해당하는 셀의 초기 데이터를 반환합니다. */
+  getInitCellDataEx?: (row: number, key: string) => any;
+  /** 입력받은 행,열 인덱스에 해당하는 셀의 데이터를 갱신합니다. */
+  setCellData?: (row: number, col: number, data: any) => boolean;
+  /** 입력받은 행,Key 에 해당하는 셀의 데이터를 갱신합니다. */
+  setCellDataEx?: (row: number, key: number, data: any) => boolean;
+  /** 지정한 셀의 현재 표기된 텍스트를 반환합니다. */
+  getCellLabel?: (row: number, col: number) => any;
+  /** 지정한 셀의 설정한 데이터를 출력합니다. */
+  setCellLabel?: (row: number, col: number, data: any) => boolean;
+  /** Server와의 통신을 통해 데이터를 바인딩합니다. */
+  requestData?: (properties: any) => any;
+  /** Progress 이미지를 화면에 출력합니다. */
+  showProgress?: () => boolean;
+  /** Progress 이미지를 화면에서 숨김 처리합니다. */
+  hideProgress?: (time: number) => boolean;
+  /** header의 title을 동적으로 변경시 사용 */
+  setHeaderCellValue?: (row: number, col: number, data: any) => boolean;
+  /** header의 title을 동적으로 변경시 사용 */
+  setHeaderCellValueEx?: (row: number, key: string, data: any) => boolean;
+  /** header의 title을 동적으로 변경시 사용 */
+  getHeaderCellValueEx?: (row: number, key: string) => string;
+  /** QCELL속성 original: true일 때 사용한 가능한 데이터 초기화 */
+  resetData?: () => boolean;
+  /** 포커스된 행의 데이터 반환 */
+  getFocusRowData?: () => boolean;
+  /** 자동 생성된 frozenbottomdata 에 Key 에 해당하는 셀의 데이터를 갱신합니다. */
+  setFrozenDataEx?: (key: number, data: any) => boolean;
+  /** 자동 생성된 frozenbottomdata의 key 에 해당하는 셀의 데이터를 반환합니다. */
+  getFrozenDataEx?: (key: string) => any;
+  /** frozenbottom cell 의 style을 가져온 다. */
+  getFrozenCellStyleEx?: (col: any) => any;
+  /** emptymessage 사용 여부 반환. */
+  getUseEmptyMessage?: () => boolean;
+  /** emptymessage 사용 여부 설정. */
+  setUseEmptyMessage?: (bUse: boolean) => any;
+  /** row data 전체를 지정된 위치로 변경. */
+  swapData?: (nSrcRow: any, nDestRow: any) => boolean;
+  resetCustomPanel?: (text: any) => any;
+  getCustomPanel?: () => any;
+  lookup?: (arrCondition: any, strOperator: any) => any;
+  resetLookup?: () => any;
+  /** QCELL의 데이터를 특정 조건을 기준으로 정렬합니다. (조건이 2개이상이면 다중정렬) */
+  sort?: (sortlist: string) => boolean;
+  /** QCELL의 데이터를 특정 조건을 기준으로 정렬합니다. (조건이 2개이상이면 다중정렬) */
+  sortEx?: (sortlist: string) => boolean;
+  /** 입력받은 이벤트를 QCELL에 추가합니다. */
+  bind?: (eventname: string, handler: any, data: Record<string, any>) => boolean;
+  /** 입력받은 이벤트를 QCELL에서 제거합니다. */
+  unbind?: (eventname: string) => boolean;
+  /** QCELL에 추가된 사용자 이벤트 정보를 반환합니다. */
+  getUserEventInfo?: () => Record<string, any>;
+  /** 입력한 이벤트의 핸들러를 강제로 실행합니다. */
+  trigger?: (eventname: string) => boolean;
+  /** 특정 Cell을 click한 것과 동일한 효과로 선택합니다. */
+  clickCell?: (row: number, col: number) => boolean;
+  /** 특정 Cell을 double click한 것과 동일한 효과로 선택합니다. */
+  dblClickCell?: (row: number, col: number) => boolean;
+  /** 특정 Cell을 focus 효과를 내며 선택합니다. */
+  focusCell?: (row: number, col: number, nTime: any) => boolean;
+  /** QCELL 에서 출력되는 내용을 엑셀파일로 저장합니다. (IE9 이하의 브라우저는 Server를 통하여 저장, 그 외의 브라우저는 자체 저장 및 Server틑 통한 저장 지원) */
+  excelDownload?: (properties?: any[]) => boolean;
+  /** QCELL 에서 업로드한 엑셀파일의 정보를 설정합니다. (IE9 이하의 브라우저는 Server를 통하여 업로드, 그 외의 브라우저는 자체 업로드 및 Server틑 통한 업로드 지원) */
+  excelUpload?: (properties: string) => boolean;
+  /** QCELL 에서 엑셀로 저장할 때 필요한 정보들을 추출합니다. (.excelDownload() API에서 파라미터 filename과 url외 동일) */
+  excelExportInfo?: (properties?: any[]) => Record<string, any>;
+  /** QCELL을 HTML파일로 저장합니다. */
+  htmlDownload?: (properties?: boolean) => boolean;
+  /** QCELL을 HTML파일을 반환합니다.. */
+  htmlExport?: (properties?: boolean) => string;
+  /** QCELL을 PDF파일로 저장합니다. */
+  pdfDownload?: (properties?: boolean) => boolean;
+  /** QCELL을 txt파일로 다운로드 한다. */
+  txtDownload?: (properties?: boolean) => boolean;
+  /** QCELL 에서 출력되는 내용을 대용량 엑셀파일로 저장합니다. (Server를 통하여 저장)<br>기존 다운로드에서의 속성 border, headershow, colwidth, huge, label들은 true로 지정되어 동작하며 기존의 totaldata는 제거 */
+  excelDownloadURLHuge?: (properties?: any[]) => boolean;
+  /** QCELL 에서 엑셀로 저장할 때 필요한 정보들을 추출합니다. (.excelDownloadURLHuge() API에서 파라미터 filename과 url외 동일)<br>기존 다운로드에서의 속성 border, headershow, colwidth, huge, label들은 true로 지정되어 동작하며 기존의 totaldata는 제거 */
+  exportCellInfoURLHuge?: (properties?: any[]) => Record<string, any>;
+  /** 병합할 영역과 방식을 설정합니다. */
+  merge?: (strArea: string, strMergeType: string) => boolean;
+  /** "현재 페이지 번호"를 설정합니다. */
+  setPageIndex?: (index: number) => boolean;
+  /** "현재 페이지 번호"를 반환합니다. */
+  getPageIndex?: () => number;
+  /** "페이지 출력 행의 수"를 설정합니다. */
+  setPageUnit?: (index: number) => boolean;
+  /** "페이지 출력 행의 수"를 반환합니다. */
   getPageUnit?: () => number;
+  /** pagination 속성 "param"을 설정합니다. */
+  setPaginationParam?: (property: Record<string, any>) => boolean;
+  /** pagination 속성 "param"을 반환합니다. */
+  getPaginationParam?: () => Record<string, any>;
+  /** pagination 속성 "datacount"를 설정합니다. */
+  setPaginationDatacount?: (count: number) => boolean;
+  /** pagination 속성 "datacount"을 반환합니다. */
+  getPaginationDatacount?: () => number;
+  /** pagination 속성 "url"를 설정합니다. */
+  setPaginationUrl?: (url: string) => boolean;
+  /** pagination 속성 "url"을 반환합니다. */
+  getPaginationUrl?: () => string;
+  /** pagination 속성 "loadonce"를 설정합니다. */
+  setPaginationLoadonce?: (loadonce: boolean) => boolean;
+  /** pagination 속성 "loadonce"을 반환합니다. */
+  getPaginationLoadonce?: () => boolean;
+  /** pagination 사용 중 설정된 sort정보를 초기화합니다. */
+  setPaginationInitSort?: () => boolean;
+  /** rowheader "checkbox"인 열 인덱스의 checkbox에서 check 된 행 인덱스들을 배열로 반환합니다. */
+  getRowheaderChecked?: (nCol: number) => any[];
+  /** rowheader "checkbox"로 입력받은 행,열 인덱스에 해당하는 checkbox의 상태값을 갱신합니다. */
+  setRowheaderChecked?: (nRow: number, nCol: number, bState: boolean) => boolean;
+  /** rowheader "checkbox"로 입력받은 행의 배열,열 인덱스에 해당하는 checkbox를 check상태로 갱신합니다. */
+  setRowheaderCheckedArr?: (arrRow: any[], nCol: number) => boolean;
+  /** 입력받은 정보를 이용하여 QCELL의 데이터를 활용하여 Grand total 을 추가합니다.. */
+  setGrandTotal?: (properties: string) => boolean;
+  /** GrandTotal를 해제합니다. */
+  clearGrandTotal?: () => boolean;
+  /** 입력받은 정보를 이용하여 QCELL의 데이터를 계층화(Tree)합니다. */
+  setTree?: (properties: string) => boolean;
+  /** 해당 위치에 새로운 트리 노드를 추가합니다. */
+  insertTreeNode?: (arrKey: any, objData: any, strPosition: any) => boolean;
+  /** 해당 위치에 트리 노드를 하위를 포함 하여 삭제 합니다.. */
+  removeTreeNode?: (arrKey: any) => boolean;
+  /** 해당 위치에 트리 노드의 데이터를 변경 합니다. */
+  updateTreeNode?: (arrKey: any, objData: any) => boolean;
+  /** 해당 위치에 트리 노드의 위치를 변경 합니다. */
+  moveTreeNode?: (arrKey: any, nPos: any) => boolean;
+  /** 해당 위치에 트리 노드의 위치를 변경 합니다. */
+  moveTreeNodeEx?: (arrSrcKey: any, arrDestKey: any, nPos: any) => boolean;
+  /** Tree 의 상태값을 가져 옵니다. */
+  getTreeState?: (strState: any) => string;
+  /** Tree 의 상태값을 초기화 합니다.. */
+  clearTreeState?: () => boolean;
+  /** 입력받은 정보를 이용하여 QCELL의 데이터를 그룹화(Groupping)합니다. */
+  setHierachy?: (properties: string) => boolean;
+  /** contextmenu에서 비활성화할 메뉴의 id를 설정합니다. */
+  setDisableContextmenu?: (ids: any[]) => boolean;
+  /** contextmenu에서 비활성화 된 메뉴 중 활성화 할 메뉴의 id를 설정합니다. */
+  setAbleContextmenu?: (ids: any[]) => boolean;
+  /** contextmenu를 설정합니다. */
+  setContextmenu?: (obj: Record<string, any>) => boolean;
+  /** 현재 마우스 커서가 위치한 Contextmenu의 id를 반환합니다. */
+  getContextmenuId?: () => string;
+  /** 컬럼별 필터를 설정합니다. */
+  filter?: (col: number, values: any) => boolean;
+  /** 컬럼별 필터를 설정합니다. */
+  filterEx?: (col: number, values: any) => boolean;
+  /** 컬럼별 필터를 해제합니다.. */
+  resetFilter?: (col: number) => boolean;
+  /** 컬럼별 필터를 해제합니다.. */
+  resetFilterEx?: (col: number) => boolean;
+  /** 입력받은 정보를 이용하여 QCELL의 데이터를 그룹화(Groupping)합니다. */
+  setGroup?: (properties: string) => boolean;
+  /** 그룹화(Groupping)를 해제합니다. */
+  clearGroup?: () => boolean;
+  /** row data 전체를 지정된 위치로 변경. */
+  moveData?: (nSrcRow: any, nDestRow: any) => boolean;
+  /** 해당 row 이하에서 대상 컬럼 중 특정 데이터 를 찾음. */
+  findRow?: (data: string, startRow: number, targetCol: number) => number;
+  /** 해당 row 이하에서 대상 컬럼 중 특정 데이터 를 찾음. */
+  findRowEx?: (data: string, startRow: number, key: string) => number;
 
+  /**
+   * QCELL 내부 API가 많으므로, 선언되지 않은 레거시/확장 API도 사용할 수 있게 열어둡니다.
+   */
   [key: string]: any;
 }
 
 export interface QCELLType {
-  create: (property: Record<string, any>) => void;
+  create: (property: ObjPropertyType | QCELLAnyObject) => void;
   getInstance: (id: string) => QCELLInstance | null;
   deleteInstance: (id: string) => void;
+  hasInstance?: (id: string) => boolean;
+  getInstanceIDs?: () => string[];
   [key: string]: any;
 }
 
@@ -33,18 +379,19 @@ export interface QCELLReactRef {
   getQCELL: () => QCELLType;
 }
 
-export interface ObjPropertyType {
-  id: string;
-  parentid?: string;
-  data?: any;
-  columns?: any[];
-  [key: string]: any;
-}
-
 export interface QCELLReactProps {
+  id?: string;
   width?: string | number;
   height: string | number;
-  objProperty: ObjPropertyType;
+  objProperty?: ObjPropertyType;
+
+  data?: QCELLRowData[] | { input?: QCELLRowData[]; [key: string]: any };
+  columns?: QCELLColumn[];
+  rowHeight?: QCELLRowHeight;
+  rowheight?: QCELLRowHeight;
+  pagination?: QCELLPagination;
+
+  [key: string]: any;
 }
 
 declare const QCELLReact: React.ForwardRefExoticComponent<
@@ -52,4 +399,4 @@ declare const QCELLReact: React.ForwardRefExoticComponent<
     React.RefAttributes<QCELLReactRef>
 >;
 
-export default QCELLReact;
+export default QCELLReact;