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.
Files changed (70) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +366 -0
  3. package/dist/OpenGrid-CAodJLLm.cjs +90 -0
  4. package/dist/OpenGrid-CAodJLLm.cjs.map +1 -0
  5. package/dist/OpenGrid-CfZy3e7Q.js +4376 -0
  6. package/dist/OpenGrid-CfZy3e7Q.js.map +1 -0
  7. package/dist/open-grid-base.css +1595 -0
  8. package/dist/open-grid-react.cjs +2 -0
  9. package/dist/open-grid-react.cjs.map +1 -0
  10. package/dist/open-grid-react.js +91 -0
  11. package/dist/open-grid-react.js.map +1 -0
  12. package/dist/open-grid-themes.css +630 -0
  13. package/dist/open-grid-vue.cjs +2 -0
  14. package/dist/open-grid-vue.cjs.map +1 -0
  15. package/dist/open-grid-vue.js +84 -0
  16. package/dist/open-grid-vue.js.map +1 -0
  17. package/dist/open-grid.cjs +7 -0
  18. package/dist/open-grid.cjs.map +1 -0
  19. package/dist/open-grid.js +311 -0
  20. package/dist/open-grid.js.map +1 -0
  21. package/dist/types/bench/perf.d.ts +16 -0
  22. package/dist/types/core/CellEditManager.d.ts +46 -0
  23. package/dist/types/core/CellEventHandler.d.ts +28 -0
  24. package/dist/types/core/CellTypeRegistry.d.ts +5 -0
  25. package/dist/types/core/ColumnLayout.d.ts +41 -0
  26. package/dist/types/core/ContextMenu.d.ts +33 -0
  27. package/dist/types/core/DataLayer.d.ts +65 -0
  28. package/dist/types/core/EventEmitter.d.ts +11 -0
  29. package/dist/types/core/ExportManager.d.ts +28 -0
  30. package/dist/types/core/FilterPanel.d.ts +20 -0
  31. package/dist/types/core/FilterSelect.d.ts +96 -0
  32. package/dist/types/core/FindBarManager.d.ts +26 -0
  33. package/dist/types/core/FooterManager.d.ts +16 -0
  34. package/dist/types/core/FormulaEngine.d.ts +10 -0
  35. package/dist/types/core/GridRenderer.d.ts +42 -0
  36. package/dist/types/core/GroupEngine.d.ts +47 -0
  37. package/dist/types/core/GroupTreeManager.d.ts +43 -0
  38. package/dist/types/core/KeyboardManager.d.ts +26 -0
  39. package/dist/types/core/MaskingEngine.d.ts +25 -0
  40. package/dist/types/core/MathUtils.d.ts +26 -0
  41. package/dist/types/core/MergeEngine.d.ts +35 -0
  42. package/dist/types/core/OGDecimal.d.ts +49 -0
  43. package/dist/types/core/OpenGrid.d.ts +213 -0
  44. package/dist/types/core/OrgChart.d.ts +35 -0
  45. package/dist/types/core/Pagination.d.ts +34 -0
  46. package/dist/types/core/PivotEngine.d.ts +20 -0
  47. package/dist/types/core/RowDragDrop.d.ts +18 -0
  48. package/dist/types/core/RowManager.d.ts +30 -0
  49. package/dist/types/core/SortFilterManager.d.ts +36 -0
  50. package/dist/types/core/TreeEngine.d.ts +34 -0
  51. package/dist/types/core/TriggerManager.d.ts +10 -0
  52. package/dist/types/core/VirtualScroll.d.ts +31 -0
  53. package/dist/types/core/WorksheetManager.d.ts +24 -0
  54. package/dist/types/core/XmlConverter.d.ts +88 -0
  55. package/dist/types/core/editors/CellEditor.d.ts +55 -0
  56. package/dist/types/core/editors/DateEditor.d.ts +15 -0
  57. package/dist/types/core/editors/SelectEditor.d.ts +21 -0
  58. package/dist/types/core/renderers/CellRenderer.d.ts +138 -0
  59. package/dist/types/core/types.d.ts +497 -0
  60. package/dist/types/index.d.ts +9 -0
  61. package/dist/types/react/OpenGrid.d.ts +34 -0
  62. package/dist/types/react/index.d.ts +2 -0
  63. package/dist/types/vue/OpenGrid.vue.d.ts +80 -0
  64. package/dist/types/vue/index.d.ts +2 -0
  65. package/dist/types/vue/types.d.ts +28 -0
  66. package/dist/xlsx.min-Bx-LxWOf.cjs +138 -0
  67. package/dist/xlsx.min-Bx-LxWOf.cjs.map +1 -0
  68. package/dist/xlsx.min-Wavxcamn.js +11907 -0
  69. package/dist/xlsx.min-Wavxcamn.js.map +1 -0
  70. 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,2 @@
1
+ export { OpenGridReact as OpenGrid } from './OpenGrid.js';
2
+ export type { OpenGridProps } from './OpenGrid.js';
@@ -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,2 @@
1
+ export { default as OpenGrid } from './OpenGrid.vue';
2
+ export type { OpenGridProps, OpenGridEmits } from './types.js';
@@ -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
+ }