open-grid 0.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +366 -0
- package/dist/OpenGrid-CAodJLLm.cjs +90 -0
- package/dist/OpenGrid-CAodJLLm.cjs.map +1 -0
- package/dist/OpenGrid-CfZy3e7Q.js +4376 -0
- package/dist/OpenGrid-CfZy3e7Q.js.map +1 -0
- package/dist/open-grid-base.css +1595 -0
- package/dist/open-grid-react.cjs +2 -0
- package/dist/open-grid-react.cjs.map +1 -0
- package/dist/open-grid-react.js +91 -0
- package/dist/open-grid-react.js.map +1 -0
- package/dist/open-grid-themes.css +630 -0
- package/dist/open-grid-vue.cjs +2 -0
- package/dist/open-grid-vue.cjs.map +1 -0
- package/dist/open-grid-vue.js +84 -0
- package/dist/open-grid-vue.js.map +1 -0
- package/dist/open-grid.cjs +7 -0
- package/dist/open-grid.cjs.map +1 -0
- package/dist/open-grid.js +311 -0
- package/dist/open-grid.js.map +1 -0
- package/dist/types/bench/perf.d.ts +16 -0
- package/dist/types/core/CellEditManager.d.ts +46 -0
- package/dist/types/core/CellEventHandler.d.ts +28 -0
- package/dist/types/core/CellTypeRegistry.d.ts +5 -0
- package/dist/types/core/ColumnLayout.d.ts +41 -0
- package/dist/types/core/ContextMenu.d.ts +33 -0
- package/dist/types/core/DataLayer.d.ts +65 -0
- package/dist/types/core/EventEmitter.d.ts +11 -0
- package/dist/types/core/ExportManager.d.ts +28 -0
- package/dist/types/core/FilterPanel.d.ts +20 -0
- package/dist/types/core/FilterSelect.d.ts +96 -0
- package/dist/types/core/FindBarManager.d.ts +26 -0
- package/dist/types/core/FooterManager.d.ts +16 -0
- package/dist/types/core/FormulaEngine.d.ts +10 -0
- package/dist/types/core/GridRenderer.d.ts +42 -0
- package/dist/types/core/GroupEngine.d.ts +47 -0
- package/dist/types/core/GroupTreeManager.d.ts +43 -0
- package/dist/types/core/KeyboardManager.d.ts +26 -0
- package/dist/types/core/MaskingEngine.d.ts +25 -0
- package/dist/types/core/MathUtils.d.ts +26 -0
- package/dist/types/core/MergeEngine.d.ts +35 -0
- package/dist/types/core/OGDecimal.d.ts +49 -0
- package/dist/types/core/OpenGrid.d.ts +213 -0
- package/dist/types/core/OrgChart.d.ts +35 -0
- package/dist/types/core/Pagination.d.ts +34 -0
- package/dist/types/core/PivotEngine.d.ts +20 -0
- package/dist/types/core/RowDragDrop.d.ts +18 -0
- package/dist/types/core/RowManager.d.ts +30 -0
- package/dist/types/core/SortFilterManager.d.ts +36 -0
- package/dist/types/core/TreeEngine.d.ts +34 -0
- package/dist/types/core/TriggerManager.d.ts +10 -0
- package/dist/types/core/VirtualScroll.d.ts +31 -0
- package/dist/types/core/WorksheetManager.d.ts +24 -0
- package/dist/types/core/XmlConverter.d.ts +88 -0
- package/dist/types/core/editors/CellEditor.d.ts +55 -0
- package/dist/types/core/editors/DateEditor.d.ts +15 -0
- package/dist/types/core/editors/SelectEditor.d.ts +21 -0
- package/dist/types/core/renderers/CellRenderer.d.ts +138 -0
- package/dist/types/core/types.d.ts +497 -0
- package/dist/types/index.d.ts +9 -0
- package/dist/types/react/OpenGrid.d.ts +34 -0
- package/dist/types/react/index.d.ts +2 -0
- package/dist/types/vue/OpenGrid.vue.d.ts +80 -0
- package/dist/types/vue/index.d.ts +2 -0
- package/dist/types/vue/types.d.ts +28 -0
- package/dist/xlsx.min-Bx-LxWOf.cjs +138 -0
- package/dist/xlsx.min-Bx-LxWOf.cjs.map +1 -0
- package/dist/xlsx.min-Wavxcamn.js +11907 -0
- package/dist/xlsx.min-Wavxcamn.js.map +1 -0
- package/package.json +102 -0
|
@@ -0,0 +1,497 @@
|
|
|
1
|
+
export type DataType = 'string' | 'number' | 'date' | 'boolean' | 'select' | 'radio' | 'img' | 'html' | 'barcode';
|
|
2
|
+
export type { MaskType, MaskDef } from './MaskingEngine.js';
|
|
3
|
+
export type SelectionMode = 'single' | 'row' | 'multiple' | 'cells';
|
|
4
|
+
export type SortDir = 'asc' | 'desc';
|
|
5
|
+
export type Position = 'first' | 'last' | 'before' | 'after' | number;
|
|
6
|
+
export type RendererType = 'text' | 'number' | 'date' | 'checkbox' | 'button' | 'link' | 'image' | 'icon' | 'switch' | 'sparkline' | 'template' | 'custom' | 'badge' | 'progress' | 'rating' | 'radio' | 'img' | 'html' | 'barcode';
|
|
7
|
+
export type EditorType = 'text' | 'number' | 'date' | 'select' | 'checkbox' | 'custom';
|
|
8
|
+
export interface CellEvent<T = any> {
|
|
9
|
+
type: string;
|
|
10
|
+
rowIndex: number;
|
|
11
|
+
columnIndex: number;
|
|
12
|
+
field: string;
|
|
13
|
+
value: any;
|
|
14
|
+
row: T;
|
|
15
|
+
column: ColumnDef<T>;
|
|
16
|
+
target: HTMLElement;
|
|
17
|
+
originalEvent: MouseEvent;
|
|
18
|
+
}
|
|
19
|
+
export interface EditEvent<T = any> {
|
|
20
|
+
type: string;
|
|
21
|
+
rowIndex: number;
|
|
22
|
+
columnIndex: number;
|
|
23
|
+
field: string;
|
|
24
|
+
oldValue: any;
|
|
25
|
+
newValue: any;
|
|
26
|
+
row: T;
|
|
27
|
+
column: ColumnDef<T>;
|
|
28
|
+
cancel?: boolean;
|
|
29
|
+
}
|
|
30
|
+
export interface RowEvent<T = any> {
|
|
31
|
+
type: string;
|
|
32
|
+
rowIndex: number;
|
|
33
|
+
row: T;
|
|
34
|
+
target: HTMLElement;
|
|
35
|
+
originalEvent: MouseEvent;
|
|
36
|
+
}
|
|
37
|
+
export interface CellKeyEvent<T = any> {
|
|
38
|
+
type: string;
|
|
39
|
+
rowIndex: number;
|
|
40
|
+
columnIndex: number;
|
|
41
|
+
field: string;
|
|
42
|
+
value: any;
|
|
43
|
+
row: T;
|
|
44
|
+
column: ColumnDef<T>;
|
|
45
|
+
key: string;
|
|
46
|
+
target: HTMLElement;
|
|
47
|
+
originalEvent: KeyboardEvent;
|
|
48
|
+
}
|
|
49
|
+
export interface SortEvent {
|
|
50
|
+
field: string;
|
|
51
|
+
dir: SortDir;
|
|
52
|
+
sortList: SortItem[];
|
|
53
|
+
}
|
|
54
|
+
export interface FilterEvent {
|
|
55
|
+
field: string;
|
|
56
|
+
filterItems: FilterItem[];
|
|
57
|
+
allFilters: Record<string, FilterItem[]>;
|
|
58
|
+
}
|
|
59
|
+
export interface ScrollEvent {
|
|
60
|
+
scrollLeft: number;
|
|
61
|
+
scrollTop: number;
|
|
62
|
+
isAtTop: boolean;
|
|
63
|
+
isAtBottom: boolean;
|
|
64
|
+
}
|
|
65
|
+
export interface DragDropEvent<T = any> {
|
|
66
|
+
sourceRows: T[];
|
|
67
|
+
sourceIndexes: number[];
|
|
68
|
+
targetIndex: number;
|
|
69
|
+
targetGridId?: string;
|
|
70
|
+
}
|
|
71
|
+
export interface SelectionEvent<T = any> {
|
|
72
|
+
rows: T[];
|
|
73
|
+
rowIndexes: number[];
|
|
74
|
+
cells?: CellRange[];
|
|
75
|
+
}
|
|
76
|
+
export interface CellRange {
|
|
77
|
+
startRow: number;
|
|
78
|
+
endRow: number;
|
|
79
|
+
startCol: number;
|
|
80
|
+
endCol: number;
|
|
81
|
+
}
|
|
82
|
+
export interface RendererDef {
|
|
83
|
+
type: RendererType;
|
|
84
|
+
[key: string]: any;
|
|
85
|
+
}
|
|
86
|
+
export interface EditorDef {
|
|
87
|
+
type: EditorType;
|
|
88
|
+
options?: Array<string | {
|
|
89
|
+
label: string;
|
|
90
|
+
value: any;
|
|
91
|
+
}>;
|
|
92
|
+
multiple?: boolean;
|
|
93
|
+
min?: number;
|
|
94
|
+
max?: number;
|
|
95
|
+
step?: number;
|
|
96
|
+
format?: string;
|
|
97
|
+
placeholder?: string;
|
|
98
|
+
[key: string]: any;
|
|
99
|
+
}
|
|
100
|
+
export interface ColumnDef<T = any> {
|
|
101
|
+
field: string;
|
|
102
|
+
header: string;
|
|
103
|
+
width?: number;
|
|
104
|
+
minWidth?: number;
|
|
105
|
+
maxWidth?: number;
|
|
106
|
+
flex?: number;
|
|
107
|
+
type?: DataType;
|
|
108
|
+
format?: string;
|
|
109
|
+
valueMap?: Record<string, string>;
|
|
110
|
+
renderer?: RendererType | RendererDef;
|
|
111
|
+
editable?: boolean | ((row: T, rowIndex: number) => boolean);
|
|
112
|
+
editor?: EditorType | EditorDef;
|
|
113
|
+
align?: 'left' | 'center' | 'right';
|
|
114
|
+
headerAlign?: 'left' | 'center' | 'right';
|
|
115
|
+
cellStyle?: CSSProperties | ((value: any, row: T, rowIndex: number) => CSSProperties);
|
|
116
|
+
headerStyle?: CSSProperties;
|
|
117
|
+
sortable?: boolean;
|
|
118
|
+
filterable?: boolean;
|
|
119
|
+
resizable?: boolean;
|
|
120
|
+
hidden?: boolean;
|
|
121
|
+
frozen?: boolean;
|
|
122
|
+
colSpan?: boolean | ((row: T, rowIndex: number) => boolean);
|
|
123
|
+
rowSpan?: boolean;
|
|
124
|
+
children?: ColumnDef<T>[];
|
|
125
|
+
tooltip?: string | ((value: any, row: T) => string);
|
|
126
|
+
options?: Array<string | {
|
|
127
|
+
label: string;
|
|
128
|
+
value: any;
|
|
129
|
+
}>;
|
|
130
|
+
optionsFn?: (row: T, rowIndex: number) => Array<string | {
|
|
131
|
+
label: string;
|
|
132
|
+
value: any;
|
|
133
|
+
}>;
|
|
134
|
+
group?: string;
|
|
135
|
+
alt?: string;
|
|
136
|
+
sanitize?: boolean;
|
|
137
|
+
barcodeHeight?: number;
|
|
138
|
+
precision?: number;
|
|
139
|
+
formula?: string | ((row: T, D: any) => any);
|
|
140
|
+
formulaPrecision?: number;
|
|
141
|
+
mask?: import('./MaskingEngine.js').MaskType | import('./MaskingEngine.js').MaskDef;
|
|
142
|
+
treeNodeIcon?: TreeNodeIconDef | ((row: T, hasChildren: boolean, expanded: boolean) => string);
|
|
143
|
+
_colIndex?: number;
|
|
144
|
+
_depth?: number;
|
|
145
|
+
_leaf?: boolean;
|
|
146
|
+
_maskRevealed?: boolean;
|
|
147
|
+
_maskRevealedRows?: Set<number>;
|
|
148
|
+
}
|
|
149
|
+
export interface TreeNodeIconDef {
|
|
150
|
+
/** 접힌 branch 노드 아이콘 (Bootstrap Icons 클래스, 기본: 'bi-folder2') */
|
|
151
|
+
branch?: string;
|
|
152
|
+
/** 펼친 branch 노드 아이콘 (기본: 'bi-folder2-open') */
|
|
153
|
+
branchOpen?: string;
|
|
154
|
+
/** 리프 노드 아이콘 (기본: 'bi-file-earmark') */
|
|
155
|
+
leaf?: string;
|
|
156
|
+
}
|
|
157
|
+
type CSSProperties = Partial<Record<keyof CSSStyleDeclaration, string>>;
|
|
158
|
+
export interface SortItem {
|
|
159
|
+
field: string;
|
|
160
|
+
dir: SortDir;
|
|
161
|
+
}
|
|
162
|
+
export interface FilterItem {
|
|
163
|
+
operator: '=' | '!=' | '>' | '>=' | '<' | '<=' | 'contains' | 'startsWith' | 'endsWith';
|
|
164
|
+
value: any;
|
|
165
|
+
}
|
|
166
|
+
export type SummaryOp = 'SUM' | 'AVG' | 'MIN' | 'MAX' | 'COUNT';
|
|
167
|
+
export interface SummaryFieldDef {
|
|
168
|
+
field: string;
|
|
169
|
+
op: SummaryOp;
|
|
170
|
+
label?: string;
|
|
171
|
+
}
|
|
172
|
+
export interface SummaryOptions {
|
|
173
|
+
fields: string[];
|
|
174
|
+
ops?: SummaryOp | SummaryOp[];
|
|
175
|
+
position?: 'top' | 'bottom';
|
|
176
|
+
rows?: Array<{
|
|
177
|
+
op: SummaryOp;
|
|
178
|
+
label?: string;
|
|
179
|
+
customFn?: (items: any[]) => number;
|
|
180
|
+
}>;
|
|
181
|
+
}
|
|
182
|
+
export interface FooterDef {
|
|
183
|
+
field?: string;
|
|
184
|
+
op?: SummaryOp;
|
|
185
|
+
label?: string;
|
|
186
|
+
/**
|
|
187
|
+
* 숫자 포맷 문자열
|
|
188
|
+
* '#,##0' → 천 단위 콤마, 정수
|
|
189
|
+
* '#,##0.00' → 천 단위 콤마, 소수 2자리
|
|
190
|
+
* '0' → 정수 (콤마 없음)
|
|
191
|
+
* '0.00' → 소수 2자리 (콤마 없음)
|
|
192
|
+
* '2' → 소수 2자리 (하위 호환)
|
|
193
|
+
*/
|
|
194
|
+
format?: string;
|
|
195
|
+
align?: 'left' | 'center' | 'right';
|
|
196
|
+
/** 이 셀이 오른쪽으로 몇 컬럼을 병합할지 (기본: 1) */
|
|
197
|
+
colspan?: number;
|
|
198
|
+
renderer?: RendererType | RendererDef;
|
|
199
|
+
}
|
|
200
|
+
export interface PrintOptions {
|
|
201
|
+
title?: string;
|
|
202
|
+
excludeFields?: string[];
|
|
203
|
+
showFooter?: boolean;
|
|
204
|
+
}
|
|
205
|
+
export type ExportStyleMode = 'theme' | 'none' | 'custom';
|
|
206
|
+
export interface ExportOptions {
|
|
207
|
+
filename?: string;
|
|
208
|
+
sheetName?: string;
|
|
209
|
+
includeHeader?: boolean;
|
|
210
|
+
exceptFields?: string[];
|
|
211
|
+
headers?: ExportHeaderRow[];
|
|
212
|
+
footers?: ExportHeaderRow[];
|
|
213
|
+
styleMode?: ExportStyleMode;
|
|
214
|
+
/** true 시 마스킹 활성 컬럼의 값을 마스킹된 형태로 내보냄 (기본: false = 원본 값) */
|
|
215
|
+
maskOnExport?: boolean;
|
|
216
|
+
onBefore?: () => void | Promise<void>;
|
|
217
|
+
onAfter?: (blob: Blob) => void;
|
|
218
|
+
}
|
|
219
|
+
export interface ExportHeaderRow {
|
|
220
|
+
text: string;
|
|
221
|
+
height?: number;
|
|
222
|
+
style?: {
|
|
223
|
+
fontSize?: number;
|
|
224
|
+
textAlign?: 'left' | 'center' | 'right';
|
|
225
|
+
bold?: boolean;
|
|
226
|
+
color?: string;
|
|
227
|
+
background?: string;
|
|
228
|
+
};
|
|
229
|
+
}
|
|
230
|
+
export interface GridOptions<T = any> {
|
|
231
|
+
columns: ColumnDef<T>[];
|
|
232
|
+
height?: number | string;
|
|
233
|
+
width?: number | string;
|
|
234
|
+
rowHeight?: number;
|
|
235
|
+
headerHeight?: number;
|
|
236
|
+
footerHeight?: number;
|
|
237
|
+
autoHeight?: boolean;
|
|
238
|
+
fillWidth?: boolean;
|
|
239
|
+
defaultColumnWidth?: number;
|
|
240
|
+
editable?: boolean;
|
|
241
|
+
editMode?: 'click' | 'dblclick' | 'none';
|
|
242
|
+
history?: boolean;
|
|
243
|
+
historySize?: number;
|
|
244
|
+
selection?: SelectionMode;
|
|
245
|
+
clipboard?: boolean;
|
|
246
|
+
sortable?: boolean;
|
|
247
|
+
multiSort?: boolean;
|
|
248
|
+
filterable?: boolean;
|
|
249
|
+
defaultSort?: SortItem[];
|
|
250
|
+
frozenColumns?: number;
|
|
251
|
+
frozenRows?: number;
|
|
252
|
+
rowNumber?: boolean;
|
|
253
|
+
stateColumn?: boolean;
|
|
254
|
+
checkColumn?: boolean;
|
|
255
|
+
draggable?: boolean;
|
|
256
|
+
mergeCells?: boolean;
|
|
257
|
+
groupBy?: string[];
|
|
258
|
+
summary?: SummaryOptions;
|
|
259
|
+
treeMode?: 'auto' | 'flat';
|
|
260
|
+
treeId?: string;
|
|
261
|
+
treeParentId?: string;
|
|
262
|
+
expandOnLoad?: boolean;
|
|
263
|
+
pagination?: boolean;
|
|
264
|
+
pageSize?: number;
|
|
265
|
+
footer?: FooterDef[];
|
|
266
|
+
footerPosition?: 'top' | 'bottom';
|
|
267
|
+
ariaLabel?: string;
|
|
268
|
+
theme?: string;
|
|
269
|
+
cssVars?: Record<string, string>;
|
|
270
|
+
contextMenu?: boolean | ContextMenuItem[];
|
|
271
|
+
worksheets?: WorksheetDef[];
|
|
272
|
+
calcPrecision?: number;
|
|
273
|
+
columnReorder?: boolean;
|
|
274
|
+
onReady?: (grid: OpenGridInstance<T>) => void;
|
|
275
|
+
onCellClick?: (e: CellEvent<T>) => void;
|
|
276
|
+
onCellDblClick?: (e: CellEvent<T>) => void;
|
|
277
|
+
onEditStart?: (e: EditEvent<T>) => void;
|
|
278
|
+
onEditEnd?: (e: EditEvent<T>) => void;
|
|
279
|
+
onEditBefore?: (e: EditEvent<T>) => boolean;
|
|
280
|
+
onRowClick?: (e: RowEvent<T>) => void;
|
|
281
|
+
onSelectionChange?: (e: SelectionEvent<T>) => void;
|
|
282
|
+
onSortChange?: (e: SortEvent) => void;
|
|
283
|
+
onFilterChange?: (e: FilterEvent) => void;
|
|
284
|
+
onScroll?: (e: ScrollEvent) => void;
|
|
285
|
+
onDrop?: (e: DragDropEvent<T>) => void;
|
|
286
|
+
onRowDrop?: (e: {
|
|
287
|
+
fromIndex: number;
|
|
288
|
+
toIndex: number;
|
|
289
|
+
}) => void;
|
|
290
|
+
onColumnReorder?: (e: {
|
|
291
|
+
fromIndex: number;
|
|
292
|
+
toIndex: number;
|
|
293
|
+
field: string;
|
|
294
|
+
}) => void;
|
|
295
|
+
onDataChange?: (data: T[]) => void;
|
|
296
|
+
onRowDblClick?: (e: RowEvent<T>) => void;
|
|
297
|
+
onRowMouseOver?: (e: RowEvent<T>) => void;
|
|
298
|
+
onRowMouseOut?: (e: RowEvent<T>) => void;
|
|
299
|
+
onRowMouseDown?: (e: RowEvent<T>) => void;
|
|
300
|
+
onRowMouseUp?: (e: RowEvent<T>) => void;
|
|
301
|
+
onRowMouseMove?: (e: RowEvent<T>) => void;
|
|
302
|
+
onCellMouseOver?: (e: CellEvent<T>) => void;
|
|
303
|
+
onCellMouseOut?: (e: CellEvent<T>) => void;
|
|
304
|
+
onCellMouseDown?: (e: CellEvent<T>) => void;
|
|
305
|
+
onCellMouseUp?: (e: CellEvent<T>) => void;
|
|
306
|
+
onCellMouseMove?: (e: CellEvent<T>) => void;
|
|
307
|
+
onCellKeyDown?: (e: CellKeyEvent<T>) => void;
|
|
308
|
+
onCellKeyUp?: (e: CellKeyEvent<T>) => void;
|
|
309
|
+
onCellKeyPress?: (e: CellKeyEvent<T>) => void;
|
|
310
|
+
}
|
|
311
|
+
export interface OpenGridInstance<T = any> {
|
|
312
|
+
setData(data: T[]): void;
|
|
313
|
+
getData(): T[];
|
|
314
|
+
getSourceRows(): T[];
|
|
315
|
+
pushData(data: T[]): void;
|
|
316
|
+
prefixData(data: T[]): void;
|
|
317
|
+
clearData(): void;
|
|
318
|
+
insertRow(item: Partial<T>, position?: Position): void;
|
|
319
|
+
pushRow(items: Partial<T> | Partial<T>[]): void;
|
|
320
|
+
unshiftRow(items: Partial<T> | Partial<T>[]): void;
|
|
321
|
+
deleteRow(rowIndex: number | number[]): void;
|
|
322
|
+
deleteById(ids: string[]): void;
|
|
323
|
+
readCell<K extends keyof T>(rowIndex: number, field: K): T[K];
|
|
324
|
+
readCell(rowIndex: number, field: string): any;
|
|
325
|
+
getDisplayValue(rowIndex: number, field: string): string;
|
|
326
|
+
writeCell(rowIndex: number, field: string, value: any): void;
|
|
327
|
+
getRowAt(rowIndex: number): T;
|
|
328
|
+
getChanges(): {
|
|
329
|
+
added: T[];
|
|
330
|
+
edited: T[];
|
|
331
|
+
removed: T[];
|
|
332
|
+
};
|
|
333
|
+
getEditedRows(): T[];
|
|
334
|
+
getChangedRows(): T[];
|
|
335
|
+
getChangedColumns(): Array<{
|
|
336
|
+
row: T;
|
|
337
|
+
fields: string[];
|
|
338
|
+
diff: Array<{
|
|
339
|
+
field: string;
|
|
340
|
+
oldValue: any;
|
|
341
|
+
newValue: any;
|
|
342
|
+
}>;
|
|
343
|
+
}>;
|
|
344
|
+
getAddedRows(): T[];
|
|
345
|
+
getRemovedRows(): T[];
|
|
346
|
+
getOriginalRow(rowIndex: number): T | undefined;
|
|
347
|
+
getRowsWithState(stateField: string): T[];
|
|
348
|
+
undo(): void;
|
|
349
|
+
redo(): void;
|
|
350
|
+
clearHistory(): void;
|
|
351
|
+
getColumnDefs(): ColumnDef<T>[];
|
|
352
|
+
getAllColumnDefs(): ColumnDef<T>[];
|
|
353
|
+
getColumnCount(): number;
|
|
354
|
+
applyColumns(columns: ColumnDef<T>[]): void;
|
|
355
|
+
insertColumn(colDef: ColumnDef<T>, position?: Position): void;
|
|
356
|
+
deleteColumn(field: string): void;
|
|
357
|
+
hideColumn(field: string | string[]): void;
|
|
358
|
+
showColumn(field: string | string[]): void;
|
|
359
|
+
getColumnIndex(field: string): number;
|
|
360
|
+
getFieldAt(index: number): string;
|
|
361
|
+
getColValues(field: string, all?: boolean): any[];
|
|
362
|
+
getUniqueValues(field: string, all?: boolean): any[];
|
|
363
|
+
setColWidths(widths: number[]): void;
|
|
364
|
+
calcColWidths(fitToGrid?: boolean): number[];
|
|
365
|
+
getSelections(): T[];
|
|
366
|
+
getActiveRow(): number;
|
|
367
|
+
activate(index: number): void;
|
|
368
|
+
deselect(): void;
|
|
369
|
+
getChecked(): Array<{
|
|
370
|
+
row: T;
|
|
371
|
+
rowIndex: number;
|
|
372
|
+
}>;
|
|
373
|
+
getAllChecked(): T[];
|
|
374
|
+
checkById(ids: string[]): void;
|
|
375
|
+
addCheckById(ids: string[]): void;
|
|
376
|
+
checkByValue(field: string, values: any[]): void;
|
|
377
|
+
uncheckById(ids: string[]): void;
|
|
378
|
+
uncheckAll(): void;
|
|
379
|
+
orderBy(field: string, dir?: SortDir): void;
|
|
380
|
+
orderBy(sortList: SortItem[]): void;
|
|
381
|
+
resetOrder(): void;
|
|
382
|
+
setFilter(field: string, filterItems: FilterItem[]): void;
|
|
383
|
+
resetFilter(field?: string): void;
|
|
384
|
+
getFilterState(): Record<string, FilterItem[]>;
|
|
385
|
+
restoreFilter(state: Record<string, FilterItem[]>): void;
|
|
386
|
+
freeze(columnCount: number): void;
|
|
387
|
+
freezeRows(rowCount: number): void;
|
|
388
|
+
groupBy(fields: string[]): void;
|
|
389
|
+
clearGroup(): void;
|
|
390
|
+
addTreeRow(item: Partial<T>, parentId: string, position?: Position): void;
|
|
391
|
+
expandAll(): void;
|
|
392
|
+
collapseAll(): void;
|
|
393
|
+
expandNodes(ids: string | string[], open?: boolean): void;
|
|
394
|
+
exportExcel(options?: ExportOptions | string): void;
|
|
395
|
+
exportCsv(options?: ExportOptions | string): void;
|
|
396
|
+
exportJson(options?: ExportOptions | string): void;
|
|
397
|
+
toArray(keyValue?: boolean): any[];
|
|
398
|
+
print(options?: PrintOptions): void;
|
|
399
|
+
jumpToRow(rowIndex: number): void;
|
|
400
|
+
jumpToCol(field: string): void;
|
|
401
|
+
getScrollPos(): {
|
|
402
|
+
x: number;
|
|
403
|
+
y: number;
|
|
404
|
+
};
|
|
405
|
+
setFooter(footerDef: FooterDef[]): void;
|
|
406
|
+
getFooterData(): any[];
|
|
407
|
+
getFooterValue(field: string): any;
|
|
408
|
+
resize(width?: number, height?: number): void;
|
|
409
|
+
setTheme(theme: string): void;
|
|
410
|
+
setThemeVar(varName: string, value: string): void;
|
|
411
|
+
destroy(): void;
|
|
412
|
+
setOptions(opts: Partial<GridOptions<T>>): void;
|
|
413
|
+
/** 컬럼 마스킹 ON/OFF. enabled=true → 마스킹 적용, enabled=false → 전체 해제 */
|
|
414
|
+
setMaskEnabled(field: string, enabled: boolean): void;
|
|
415
|
+
/** 현재 마스킹 활성 여부 반환 (true=마스킹 중) */
|
|
416
|
+
getMaskEnabled(field: string): boolean;
|
|
417
|
+
openContextMenu(e: MouseEvent, items?: ContextMenuItem[]): void;
|
|
418
|
+
closeContextMenu(): void;
|
|
419
|
+
setFilterSelect(config: import('./FilterSelect.js').FilterSelectConfig | null): void;
|
|
420
|
+
addWorksheet(name: string, columns?: ColumnDef<T>[], data?: T[]): void;
|
|
421
|
+
removeWorksheet(name: string): void;
|
|
422
|
+
switchWorksheet(name: string): void;
|
|
423
|
+
renameWorksheet(oldName: string, newName: string): void;
|
|
424
|
+
getWorksheet(name: string): WorksheetState<T> | undefined;
|
|
425
|
+
getWorksheetNames(): string[];
|
|
426
|
+
exportSheetsExcel(filename?: string): void;
|
|
427
|
+
on(event: string, handler: Function): OpenGridInstance<T>;
|
|
428
|
+
once(event: string, handler: Function): OpenGridInstance<T>;
|
|
429
|
+
off(event: string, handler?: Function): OpenGridInstance<T>;
|
|
430
|
+
emit(event: string, data?: any): void;
|
|
431
|
+
/**
|
|
432
|
+
* 트리거 등록.
|
|
433
|
+
* - 'before:{op}' : 작업 실행 전 호출. ctx.cancel() 시 해당 작업 중단.
|
|
434
|
+
* - 'after:{op}' : 작업 완료 후 호출. ctx.result에 결과 포함.
|
|
435
|
+
* - 'complete' : 모든 작업 완료 후 공통 핸들러.
|
|
436
|
+
*
|
|
437
|
+
* @example
|
|
438
|
+
* grid.addTrigger('before:insertRow', ctx => {
|
|
439
|
+
* if (!ctx.args[0]?.name) ctx.cancel(); // 이름 없으면 삽입 중단
|
|
440
|
+
* });
|
|
441
|
+
* grid.addTrigger('after:setData', ctx => {
|
|
442
|
+
* console.log('로드 완료:', ctx.result, '건');
|
|
443
|
+
* });
|
|
444
|
+
*/
|
|
445
|
+
addTrigger(event: TriggerEvent | string, handler: TriggerHandler): this;
|
|
446
|
+
/** 트리거 제거 */
|
|
447
|
+
removeTrigger(event: TriggerEvent | string, handler: TriggerHandler): this;
|
|
448
|
+
/** 트리거 전체 또는 특정 이벤트 클리어 */
|
|
449
|
+
clearTriggers(event?: TriggerEvent | string): this;
|
|
450
|
+
}
|
|
451
|
+
export interface ContextMenuItem {
|
|
452
|
+
id?: string;
|
|
453
|
+
label?: string;
|
|
454
|
+
icon?: string;
|
|
455
|
+
action?: string | (() => void);
|
|
456
|
+
disabled?: boolean;
|
|
457
|
+
type?: 'divider';
|
|
458
|
+
}
|
|
459
|
+
export type { FilterSelectColumn, FilterSelectConfig } from './FilterSelect.js';
|
|
460
|
+
export interface WorksheetDef<T = any> {
|
|
461
|
+
name: string;
|
|
462
|
+
columns?: ColumnDef<T>[];
|
|
463
|
+
data?: T[];
|
|
464
|
+
}
|
|
465
|
+
export interface WorksheetState<T = any> {
|
|
466
|
+
name: string;
|
|
467
|
+
columns: ColumnDef<T>[];
|
|
468
|
+
data: T[];
|
|
469
|
+
}
|
|
470
|
+
/**
|
|
471
|
+
* 트리거 컨텍스트.
|
|
472
|
+
* before:{op} 핸들러에서 ctx.cancel() 호출 → 해당 작업이 실행되지 않음.
|
|
473
|
+
* after:{op} / complete 핸들러에서는 ctx.result로 결과 확인 가능.
|
|
474
|
+
*/
|
|
475
|
+
export interface TriggerContext<TResult = any> {
|
|
476
|
+
/** 작업 이름 (setData, insertRow, deleteRow, writeCell, ...) */
|
|
477
|
+
readonly operation: string;
|
|
478
|
+
/** 작업에 전달된 인수 배열 */
|
|
479
|
+
readonly args: any[];
|
|
480
|
+
/** 작업 결과 (after:* / complete 에서만 채워짐) */
|
|
481
|
+
result?: TResult;
|
|
482
|
+
/** 취소 여부 — cancel() 호출 후 true가 됨 */
|
|
483
|
+
readonly cancelled: boolean;
|
|
484
|
+
/** 추가 정보 (트리거 간 데이터 공유 등) */
|
|
485
|
+
extra?: Record<string, any>;
|
|
486
|
+
/** 작업 시작 타임스탬프 (ms) */
|
|
487
|
+
readonly timestamp: number;
|
|
488
|
+
/**
|
|
489
|
+
* 작업 취소 — before:{op} 핸들러에서만 유효.
|
|
490
|
+
* 이후 핸들러도 실행되지 않으며 실제 작업도 중단된다.
|
|
491
|
+
*/
|
|
492
|
+
cancel(): void;
|
|
493
|
+
}
|
|
494
|
+
/** 트리거 핸들러 함수 타입 */
|
|
495
|
+
export type TriggerHandler<TResult = any> = (ctx: TriggerContext<TResult>) => void;
|
|
496
|
+
/** 지원되는 트리거 이벤트명 */
|
|
497
|
+
export type TriggerEvent = 'before:setData' | 'after:setData' | 'before:insertRow' | 'after:insertRow' | 'before:deleteRow' | 'after:deleteRow' | 'before:writeCell' | 'after:writeCell' | 'before:applyColumns' | 'after:applyColumns' | 'before:orderBy' | 'after:orderBy' | 'before:setFilter' | 'after:setFilter' | 'before:groupBy' | 'after:groupBy' | 'complete';
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
|
|
2
|
+
export { OpenGrid } from './core/OpenGrid.js';
|
|
3
|
+
export { OrgChart } from './core/OrgChart.js';
|
|
4
|
+
export { XmlConverter } from './core/XmlConverter.js';
|
|
5
|
+
export type { OrgChartOptions, OrgChartColumnDef } from './core/OrgChart.js';
|
|
6
|
+
export type { TreeNodeIconDef } from './core/types.js';
|
|
7
|
+
export type { FilterSelectConfig, FilterSelectColumn } from './core/FilterSelect.js';
|
|
8
|
+
export type { GridOptions, ColumnDef, OpenGridInstance, CellEvent, CellKeyEvent, EditEvent, RowEvent, SortItem, FilterItem, ExportOptions, FooterDef, SummaryOptions, RendererDef, EditorDef, DataType, SelectionMode, SortDir, Position, TriggerContext, TriggerHandler, TriggerEvent, } from './core/types.js';
|
|
9
|
+
export type { XmlParseOptions, XmlStringifyOptions, SapParseResult, } from './core/XmlConverter.js';
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
import { default as React, CSSProperties } from 'react';
|
|
2
|
+
import { GridOptions, ColumnDef, OpenGridInstance } from '../core/types.js';
|
|
3
|
+
|
|
4
|
+
export interface OpenGridProps<T extends Record<string, any> = any> {
|
|
5
|
+
data?: T[];
|
|
6
|
+
columns: ColumnDef<T>[];
|
|
7
|
+
height?: number | string;
|
|
8
|
+
width?: number | string;
|
|
9
|
+
editable?: boolean;
|
|
10
|
+
sortable?: boolean;
|
|
11
|
+
filterable?: boolean;
|
|
12
|
+
rowNumber?: boolean;
|
|
13
|
+
checkColumn?: boolean;
|
|
14
|
+
frozenColumns?: number;
|
|
15
|
+
theme?: string;
|
|
16
|
+
options?: Partial<GridOptions<T>>;
|
|
17
|
+
style?: CSSProperties;
|
|
18
|
+
className?: string;
|
|
19
|
+
stateColumn?: boolean;
|
|
20
|
+
draggable?: boolean;
|
|
21
|
+
onReady?: (grid: OpenGridInstance<T>) => void;
|
|
22
|
+
onDataChange?: (data: T[]) => void;
|
|
23
|
+
onCellClick?: (e: any) => void;
|
|
24
|
+
onRowClick?: (e: any) => void;
|
|
25
|
+
onEditEnd?: (e: any) => void;
|
|
26
|
+
onSortChange?: (e: any) => void;
|
|
27
|
+
onFilterChange?: (e: any) => void;
|
|
28
|
+
onRowDrop?: (e: {
|
|
29
|
+
fromIndex: number;
|
|
30
|
+
toIndex: number;
|
|
31
|
+
}) => void;
|
|
32
|
+
}
|
|
33
|
+
export declare function OpenGridReact<T extends Record<string, any> = any>({ data, columns, height, width, editable, sortable, filterable, rowNumber, checkColumn, stateColumn, draggable, frozenColumns, theme, options, style, className, onReady, onDataChange, onCellClick, onRowClick, onEditEnd, onSortChange, onFilterChange, onRowDrop, }: OpenGridProps<T>): import("react/jsx-runtime").JSX.Element;
|
|
34
|
+
export declare const OpenGridWithRef: React.ForwardRefExoticComponent<OpenGridProps<any> & React.RefAttributes<OpenGridInstance<any>>>;
|
|
@@ -0,0 +1,80 @@
|
|
|
1
|
+
import { OpenGridInstance } from '../core/types.js';
|
|
2
|
+
import { OpenGridProps } from './types.js';
|
|
3
|
+
|
|
4
|
+
declare const _default: import('vue').DefineComponent<import('vue').ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<OpenGridProps<any>>, {
|
|
5
|
+
data: () => never[];
|
|
6
|
+
height: number;
|
|
7
|
+
width: string;
|
|
8
|
+
editable: boolean;
|
|
9
|
+
sortable: boolean;
|
|
10
|
+
filterable: boolean;
|
|
11
|
+
rowNumber: boolean;
|
|
12
|
+
checkColumn: boolean;
|
|
13
|
+
stateColumn: boolean;
|
|
14
|
+
draggable: boolean;
|
|
15
|
+
frozenColumns: number;
|
|
16
|
+
theme: string;
|
|
17
|
+
}>>, {
|
|
18
|
+
grid: import('vue').ShallowRef<OpenGridInstance<any> | null, OpenGridInstance<any> | null>;
|
|
19
|
+
}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
|
|
20
|
+
"update:data": (data: any[]) => void;
|
|
21
|
+
ready: (grid: OpenGridInstance<any>) => void;
|
|
22
|
+
"cell-click": (event: any) => void;
|
|
23
|
+
"row-click": (event: any) => void;
|
|
24
|
+
"edit-end": (event: any) => void;
|
|
25
|
+
"sort-change": (event: any) => void;
|
|
26
|
+
"filter-change": (event: any) => void;
|
|
27
|
+
"row-check": (event: any) => void;
|
|
28
|
+
}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<OpenGridProps<any>>, {
|
|
29
|
+
data: () => never[];
|
|
30
|
+
height: number;
|
|
31
|
+
width: string;
|
|
32
|
+
editable: boolean;
|
|
33
|
+
sortable: boolean;
|
|
34
|
+
filterable: boolean;
|
|
35
|
+
rowNumber: boolean;
|
|
36
|
+
checkColumn: boolean;
|
|
37
|
+
stateColumn: boolean;
|
|
38
|
+
draggable: boolean;
|
|
39
|
+
frozenColumns: number;
|
|
40
|
+
theme: string;
|
|
41
|
+
}>>> & Readonly<{
|
|
42
|
+
onReady?: (grid: OpenGridInstance<any>) => any;
|
|
43
|
+
"onUpdate:data"?: (data: any[]) => any;
|
|
44
|
+
"onCell-click"?: (event: any) => any;
|
|
45
|
+
"onRow-click"?: (event: any) => any;
|
|
46
|
+
"onEdit-end"?: (event: any) => any;
|
|
47
|
+
"onSort-change"?: (event: any) => any;
|
|
48
|
+
"onFilter-change"?: (event: any) => any;
|
|
49
|
+
"onRow-check"?: (event: any) => any;
|
|
50
|
+
}>, {
|
|
51
|
+
data: any[] | undefined;
|
|
52
|
+
height: number | string;
|
|
53
|
+
width: number | string;
|
|
54
|
+
theme: string;
|
|
55
|
+
editable: boolean;
|
|
56
|
+
sortable: boolean;
|
|
57
|
+
filterable: boolean;
|
|
58
|
+
frozenColumns: number;
|
|
59
|
+
rowNumber: boolean;
|
|
60
|
+
stateColumn: boolean;
|
|
61
|
+
checkColumn: boolean;
|
|
62
|
+
draggable: boolean;
|
|
63
|
+
}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
|
|
64
|
+
export default _default;
|
|
65
|
+
type __VLS_TypePropsToRuntimeProps<T> = {
|
|
66
|
+
[K in keyof T]-?: {} extends Pick<T, K> ? {
|
|
67
|
+
type: import('vue').PropType<T[K]>;
|
|
68
|
+
} : {
|
|
69
|
+
type: import('vue').PropType<T[K]>;
|
|
70
|
+
required: true;
|
|
71
|
+
};
|
|
72
|
+
};
|
|
73
|
+
type __VLS_WithDefaults<P, D> = {
|
|
74
|
+
[K in keyof Pick<P, keyof P>]: K extends keyof D ? __VLS_Prettify<P[K] & {
|
|
75
|
+
default: D[K];
|
|
76
|
+
}> : P[K];
|
|
77
|
+
};
|
|
78
|
+
type __VLS_Prettify<T> = {
|
|
79
|
+
[K in keyof T]: T[K];
|
|
80
|
+
} & {};
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
import { GridOptions, ColumnDef, OpenGridInstance } from '../core/types.js';
|
|
2
|
+
|
|
3
|
+
export interface OpenGridProps<T = any> {
|
|
4
|
+
data?: T[];
|
|
5
|
+
columns: ColumnDef<T>[];
|
|
6
|
+
height?: number | string;
|
|
7
|
+
width?: number | string;
|
|
8
|
+
editable?: boolean;
|
|
9
|
+
sortable?: boolean;
|
|
10
|
+
filterable?: boolean;
|
|
11
|
+
rowNumber?: boolean;
|
|
12
|
+
checkColumn?: boolean;
|
|
13
|
+
stateColumn?: boolean;
|
|
14
|
+
draggable?: boolean;
|
|
15
|
+
frozenColumns?: number;
|
|
16
|
+
theme?: string;
|
|
17
|
+
options?: Partial<GridOptions<T>>;
|
|
18
|
+
}
|
|
19
|
+
export interface OpenGridEmits<T = any> {
|
|
20
|
+
(e: 'update:data', data: T[]): void;
|
|
21
|
+
(e: 'ready', grid: OpenGridInstance<T>): void;
|
|
22
|
+
(e: 'cell-click', event: any): void;
|
|
23
|
+
(e: 'row-click', event: any): void;
|
|
24
|
+
(e: 'edit-end', event: any): void;
|
|
25
|
+
(e: 'sort-change', event: any): void;
|
|
26
|
+
(e: 'filter-change', event: any): void;
|
|
27
|
+
(e: 'row-check', event: any): void;
|
|
28
|
+
}
|