open-grid 1.6.1 → 1.7.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 (111) hide show
  1. package/CHANGELOG.md +28 -0
  2. package/dist/ExportProgressView-9Kt1SQxv.js +48 -0
  3. package/dist/ExportProgressView-B59uHIwt.cjs +48 -0
  4. package/dist/LcpMergeOrderer-BdUtV67j.js +114 -0
  5. package/dist/LcpMergeOrderer-C_ANVkGk.cjs +113 -0
  6. package/dist/OpenGrid-BUYQs1_w.cjs +9806 -0
  7. package/dist/OpenGrid-BmagF0yo.js +9819 -0
  8. package/dist/XlsxChannel-DOeHeP7h.cjs +95 -0
  9. package/dist/XlsxChannel-DdaiytFR.js +95 -0
  10. package/dist/XlsxWorkbookWriter-BTNtZ80J.js +199 -0
  11. package/dist/XlsxWorkbookWriter-_u5stfg4.cjs +198 -0
  12. package/dist/{index-VkKgQ506.js → index-B9_g5Eg3.js} +2 -2
  13. package/dist/{index-D0DJtKYI.cjs → index-CnyumyPV.cjs} +2 -2
  14. package/dist/open-grid-react.cjs +1 -1
  15. package/dist/open-grid-react.js +1 -1
  16. package/dist/open-grid-vue.cjs +1 -1
  17. package/dist/open-grid-vue.js +1 -1
  18. package/dist/open-grid.cjs +1 -1
  19. package/dist/open-grid.js +2 -2
  20. package/dist/sinks-BWkWQexV.js +149 -0
  21. package/dist/sinks-DPK0VxYG.cjs +143 -0
  22. package/dist/types/core/CFRenderBridge.d.ts +5 -1
  23. package/dist/types/core/CellEditManager.d.ts +26 -2
  24. package/dist/types/core/CellEventHandler.d.ts +6 -2
  25. package/dist/types/core/ColumnLayout.d.ts +8 -0
  26. package/dist/types/core/DataLayer.d.ts +48 -1
  27. package/dist/types/core/DetailManager.d.ts +43 -2
  28. package/dist/types/core/ExportManager.d.ts +24 -0
  29. package/dist/types/core/FindBarManager.d.ts +6 -2
  30. package/dist/types/core/FlatRowModel.d.ts +61 -3
  31. package/dist/types/core/FooterManager.d.ts +43 -1
  32. package/dist/types/core/FormulaController.d.ts +4 -4
  33. package/dist/types/core/GridComposer.d.ts +11 -1
  34. package/dist/types/core/GridRenderer.d.ts +84 -19
  35. package/dist/types/core/GroupTreeManager.d.ts +6 -4
  36. package/dist/types/core/KeyboardManager.d.ts +3 -2
  37. package/dist/types/core/MutationService.d.ts +10 -8
  38. package/dist/types/core/OpenGrid.d.ts +7 -5
  39. package/dist/types/core/RangeSelectionManager.d.ts +23 -2
  40. package/dist/types/core/RenderController.d.ts +126 -8
  41. package/dist/types/core/SortFilterManager.d.ts +10 -2
  42. package/dist/types/core/VirtualScroll.d.ts +12 -0
  43. package/dist/types/core/coordinate/CellTextPolicy.d.ts +58 -0
  44. package/dist/types/core/coordinate/ColumnGeometry.d.ts +60 -0
  45. package/dist/types/core/coordinate/ColumnWindow.d.ts +40 -0
  46. package/dist/types/core/coordinate/ColumnWindowPolicy.d.ts +89 -0
  47. package/dist/types/core/coordinate/ExtraColumns.d.ts +39 -0
  48. package/dist/types/core/coordinate/RangeRectCalculator.d.ts +35 -0
  49. package/dist/types/core/coordinate/ViewportHeightJudge.d.ts +28 -0
  50. package/dist/types/core/coordinate/geometryPorts.d.ts +250 -0
  51. package/dist/types/core/coordinate/ports.d.ts +5 -0
  52. package/dist/types/core/domain/footer/FooterValues.d.ts +50 -0
  53. package/dist/types/core/domain/footer/ports.d.ts +31 -0
  54. package/dist/types/core/domain/render/RenderPlanner.d.ts +17 -0
  55. package/dist/types/core/domain/render/RenderRequest.d.ts +91 -0
  56. package/dist/types/core/domain/render/ports.d.ts +169 -0
  57. package/dist/types/core/domain/resize/ResizeGesture.d.ts +25 -0
  58. package/dist/types/core/domain/resize/ResizeHitZone.d.ts +23 -0
  59. package/dist/types/core/domain/resize/ports.d.ts +64 -0
  60. package/dist/types/core/domain/sort/ComparisonOrderer.d.ts +11 -0
  61. package/dist/types/core/domain/sort/LcpMergeOrderer.d.ts +15 -0
  62. package/dist/types/core/domain/sort/RankIndex.d.ts +74 -0
  63. package/dist/types/core/domain/sort/SortCostEstimate.d.ts +36 -0
  64. package/dist/types/core/domain/sort/SortKeyColumn.d.ts +89 -0
  65. package/dist/types/core/domain/sort/SortKeyStore.d.ts +34 -0
  66. package/dist/types/core/domain/sort/Sorter.d.ts +54 -0
  67. package/dist/types/core/domain/sort/SyncSortRunner.d.ts +9 -0
  68. package/dist/types/core/domain/sort/commonPrefix.d.ts +5 -0
  69. package/dist/types/core/domain/sort/ports.d.ts +140 -0
  70. package/dist/types/core/export/ExportProgressView.d.ts +28 -0
  71. package/dist/types/core/export/channels/XlsxChannel.d.ts +29 -0
  72. package/dist/types/core/export/channels/XlsxWorkbookWriter.d.ts +17 -0
  73. package/dist/types/core/export/index.d.ts +2 -0
  74. package/dist/types/core/export/sinks.d.ts +81 -0
  75. package/dist/types/core/host/archCheck.d.ts +16 -1
  76. package/dist/types/core/i18n/locales/en.d.ts +6 -0
  77. package/dist/types/core/i18n/locales/ko.d.ts +6 -0
  78. package/dist/types/core/i18n/types.d.ts +8 -0
  79. package/dist/types/core/render/FooterView.d.ts +121 -0
  80. package/dist/types/core/render/GeometryApplier.d.ts +55 -0
  81. package/dist/types/core/render/HorizontalReveal.d.ts +26 -0
  82. package/dist/types/core/render/RangeOverlayAdapter.d.ts +10 -0
  83. package/dist/types/core/render/RenderScheduler.d.ts +225 -0
  84. package/dist/types/core/render/ResizeSinkAdapter.d.ts +35 -0
  85. package/dist/types/core/render/ScrollFollower.d.ts +34 -0
  86. package/dist/types/core/render/ScrollObserver.d.ts +47 -0
  87. package/dist/types/core/render/ScrollbarGutter.d.ts +19 -0
  88. package/dist/types/core/render/body/BodyEventRouter.d.ts +58 -0
  89. package/dist/types/core/render/body/BodyRowSet.d.ts +28 -0
  90. package/dist/types/core/render/body/BodyView.d.ts +185 -0
  91. package/dist/types/core/render/body/CellLocator.d.ts +36 -0
  92. package/dist/types/core/render/body/CellRegistry.d.ts +24 -0
  93. package/dist/types/core/render/body/ColumnPaintPlan.d.ts +19 -0
  94. package/dist/types/core/render/body/ExtraCellPainters.d.ts +20 -0
  95. package/dist/types/core/render/body/rows/BodyRowContext.d.ts +138 -0
  96. package/dist/types/core/render/body/rows/DataRowPainter.d.ts +58 -0
  97. package/dist/types/core/render/body/rows/DetailRowPainter.d.ts +24 -0
  98. package/dist/types/core/render/body/rows/GroupRowPainter.d.ts +32 -0
  99. package/dist/types/core/render/body/rows/RowPainterTable.d.ts +24 -0
  100. package/dist/types/core/render/body/rows/WindowLayout.d.ts +38 -0
  101. package/dist/types/core/render/dom.d.ts +10 -0
  102. package/dist/types/core/render/header/HeaderSortIndicator.d.ts +39 -0
  103. package/dist/types/core/render/header/HeaderView.d.ts +84 -0
  104. package/dist/types/core/render/header/ResizeHandleBinder.d.ts +110 -0
  105. package/dist/types/core/render/ports.d.ts +218 -0
  106. package/dist/types/core/renderers/CellRenderer.d.ts +7 -0
  107. package/dist/types/core/types.d.ts +70 -0
  108. package/dist/types/vue/OpenGrid.vue.d.ts +1 -1
  109. package/package.json +2 -8
  110. package/dist/OpenGrid-CLk8Vt7j.cjs +0 -7459
  111. package/dist/OpenGrid-D6YxCsnV.js +0 -7472
@@ -283,3 +283,10 @@ export declare function hasRenderer(typeName: string): boolean;
283
283
  * @returns 셀 렌더러 / A cell renderer
284
284
  */
285
285
  export declare function createRenderer(col: ColumnDef): CellRenderer;
286
+ /**
287
+ * 내장 렌더러면 새 인스턴스를(그 컬럼 칸들이 나눠 쓸 것), 사용자가 등록한 팩토리면 null 을 돌려준다(그때는 칸마다 createRenderer).
288
+ *
289
+ * A fresh built-in renderer (to be shared by that column's cells), or null for a user-registered factory (then createRenderer per cell).
290
+ * @internal
291
+ */
292
+ export declare function createBuiltinRenderer(col: ColumnDef): CellRenderer | null;
@@ -2680,6 +2680,46 @@ export interface ExportOptions {
2680
2680
  * 导出完成后调用的钩子。接收生成的文件 blob。
2681
2681
  */
2682
2682
  onAfter?: (blob: Blob) => void;
2683
+ /**
2684
+ * 대량 엑셀 내보내기 진척 콜백(done 행 / total 행).
2685
+ *
2686
+ * Progress callback for large Excel exports (done rows / total rows).
2687
+ *
2688
+ * 大量の Excel エクスポートの進捗コールバック(done 行 / total 行)。
2689
+ *
2690
+ * 大批量 Excel 导出的进度回调(done 行 / total 行)。
2691
+ */
2692
+ onProgress?: (done: number, total: number) => void;
2693
+ /**
2694
+ * 대량 엑셀 내보내기를 취소하는 신호.
2695
+ *
2696
+ * Signal to cancel a large Excel export.
2697
+ *
2698
+ * 大量の Excel エクスポートを取り消すシグナル。
2699
+ *
2700
+ * 取消大批量 Excel 导出的信号。
2701
+ */
2702
+ signal?: AbortSignal;
2703
+ /**
2704
+ * 엑셀 스트리밍 사용 방식. 기본 'auto'(5만 행 이상이면 스트리밍), 'force' 항상, 'off' 기존 방식.
2705
+ *
2706
+ * Excel streaming mode. Default 'auto' (stream from 50k rows), 'force' always, 'off' legacy path.
2707
+ *
2708
+ * Excel ストリーミングの方式。既定 'auto'(5万行以上でストリーミング)、'force' 常に、'off' 従来方式。
2709
+ *
2710
+ * Excel 流式导出方式。默认 'auto'(5 万行起流式),'force' 始终,'off' 旧方式。
2711
+ */
2712
+ stream?: 'auto' | 'force' | 'off';
2713
+ /**
2714
+ * 스트리밍 내보내기 중 오류가 났을 때 부를 훅.
2715
+ *
2716
+ * Hook called when a streaming export fails.
2717
+ *
2718
+ * ストリーミングのエクスポート中にエラーが起きたときに呼ぶフック。
2719
+ *
2720
+ * 流式导出出错时调用的钩子。
2721
+ */
2722
+ onError?: (error: unknown) => void;
2683
2723
  }
2684
2724
  /**
2685
2725
  * 내보내기 제목/푸터 행.
@@ -2814,6 +2854,36 @@ export interface GridOptions<T = any> {
2814
2854
  * 单元格内容过长而换行时,让行高随内容自动增高。与列的 wrap 配合使用。
2815
2855
  */
2816
2856
  autoHeight?: boolean;
2857
+ /**
2858
+ * 가로로 보이는 컬럼(과 앞뒤 여유)만 칸을 만듭니다(기본 켬). 컬럼이 많고 칸 글자가 길 때 가로 스크롤·너비 조절이 가벼워집니다.
2859
+ * 화면 밖 컬럼은 칸 요소 대신 폭만 차지하는 빈 자리로 둡니다 — 칸 DOM 을 직접 찾는 바깥 코드가 화면 밖 칸을 꼭 찾아야 하면 끕니다.
2860
+ * 켜 두어도 자동 높이(autoHeight)·셀 병합이 있거나 그리드 폭을 모를 때(숨은 컨테이너 등)는 저절로 전 컬럼을 그립니다.
2861
+ * 끄면 지금까지처럼 보이는 행의 모든 컬럼 칸을 만듭니다.
2862
+ * 주의: 행 안 자식 순서에 기대는 바깥 CSS(`.og-row > :nth-child(n)`)는 빈 자리 요소와 창 때문에 어긋납니다. 사용자 렌더러가 칸 안에 만든 임시 상태(입력 중 글자·열린 목록·포커스)는 그 컬럼이 창에서 나가면 사라집니다(들어올 때 다시 그림).
2863
+ * 화면 밖 컬럼으로 가려면 `grid.jumpToCol(field)` 를 씁니다.
2864
+ *
2865
+ * Create cells only for horizontally visible columns (plus a margin on each side); on by default. Lighter horizontal scrolling
2866
+ * and width resizing with many columns and long cell text. Off-screen columns become width-only gaps instead of cell elements —
2867
+ * turn it off if outside code must find off-screen cell DOM. Even when on, all columns are painted automatically with autoHeight,
2868
+ * cell merges, or an unknown grid width (e.g. a hidden container). When off, every column's cell is created for visible rows, as before.
2869
+ * Caution: outside CSS that relies on child order inside a row (`.og-row > :nth-child(n)`) drifts because of gap elements and the window. Temporary state a custom renderer keeps inside a cell (typed text, an open list, focus) is lost when that column leaves the window (it is re-rendered on return).
2870
+ * To bring an off-screen column into view use `grid.jumpToCol(field)`.
2871
+ *
2872
+ * 横に見えている列(と前後の余裕)だけセルを作ります(既定で有効)。列が多くセルの文字が長いとき、横スクロールや幅の調整が軽くなります。
2873
+ * 画面外の列はセル要素の代わりに幅だけを占める空きにします — 画面外のセル DOM を外部コードが直接探す必要があるときは無効にします。
2874
+ * 有効でも、autoHeight・セル結合があるとき、グリッドの幅が分からないとき(非表示のコンテナなど)は自動的に全列を描きます。
2875
+ * 無効にすると、これまでどおり見えている行のすべての列のセルを作ります。
2876
+ * 注意: 行内の子の順番に頼る外部 CSS(`.og-row > :nth-child(n)`)は空き要素と表示範囲のためずれます。カスタムレンダラーがセル内に持つ一時的な状態(入力中の文字・開いたリスト・フォーカス)は、その列が表示範囲から出ると消えます(戻ると描き直します)。
2877
+ * 画面外の列へ移るには `grid.jumpToCol(field)` を使います。
2878
+ *
2879
+ * 只为横向可见的列(及前后余量)创建单元格(默认开启)。列多且单元格文字长时,横向滚动和调整列宽更轻快。
2880
+ * 屏幕外的列不创建单元格元素,只留占宽度的空位 — 若外部代码必须直接查找屏幕外的单元格 DOM,请关闭。
2881
+ * 即使开启,在 autoHeight、存在单元格合并、或不知道表格宽度时(如隐藏的容器)也会自动绘制全部列。
2882
+ * 关闭时与以前一样,为可见行的所有列创建单元格。
2883
+ * 注意:依赖行内子元素顺序的外部 CSS(`.og-row > :nth-child(n)`)会因空位元素和可见窗口而错位。自定义渲染器在单元格内保留的临时状态(输入中的文字、打开的列表、焦点)在该列离开窗口时会丢失(回来时重新绘制)。
2884
+ * 要转到屏幕外的列,请用 `grid.jumpToCol(field)`。
2885
+ */
2886
+ virtualColumns?: boolean;
2817
2887
  /**
2818
2888
  * 컬럼 폭의 합이 컨테이너를 꽉 채우도록 늘립니다. 오른쪽에 빈 공간을 남기고 싶지 않을 때.
2819
2889
  *
@@ -29,8 +29,8 @@ declare const _default: import('vue').DefineComponent<__VLS_Props, {
29
29
  sortable: boolean;
30
30
  filterable: boolean;
31
31
  theme: string;
32
- frozenColumns: number;
33
32
  rowNumber: boolean;
33
+ frozenColumns: number;
34
34
  stateColumn: boolean;
35
35
  checkColumn: boolean;
36
36
  draggable: boolean;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "open-grid",
3
- "version": "1.6.1",
3
+ "version": "1.7.0",
4
4
  "description": "초경량·제로 의존성 데이터 그리드 — React·Vue·Angular·jQuery·Vanilla 어디서나. 가상 스크롤·인라인 편집·다국어(i18n), MIT 라이선스, AI 친화 override 가이드. / Ultra-light data grid with a zero-dependency core — works with React, Vue, Angular, jQuery, or vanilla JS. Virtual scroll, inline editing, i18n. MIT-licensed, endlessly customizable, with an AI-friendly override guide.",
5
5
  "type": "module",
6
6
  "main": "dist/open-grid.cjs",
@@ -82,15 +82,11 @@
82
82
  "test": "vitest run",
83
83
  "test:watch": "vitest",
84
84
  "test:coverage": "vitest run --coverage",
85
- "test:e2e": "playwright test",
86
85
  "docs": "typedoc",
87
86
  "size": "node scripts/check-bundle-size.mjs",
88
87
  "arch:check": "node scripts/arch-check.mjs",
89
88
  "lint": "eslint src --ext .ts,.tsx,.vue",
90
- "preview": "vite preview",
91
- "build:deploy": "vite build --config vite.config.deploy.ts",
92
- "obfuscate": "node scripts/obfuscate.mjs",
93
- "deploy": "npm run build && npm run build:deploy && npm run obfuscate"
89
+ "preview": "vite preview"
94
90
  },
95
91
  "peerDependencies": {
96
92
  "react": ">=18.0.0",
@@ -113,7 +109,6 @@
113
109
  }
114
110
  },
115
111
  "devDependencies": {
116
- "@playwright/test": "^1.44.0",
117
112
  "@types/react": "^18.3.0",
118
113
  "@types/react-dom": "^18.3.0",
119
114
  "@typescript-eslint/eslint-plugin": "^7.0.0",
@@ -123,7 +118,6 @@
123
118
  "@vitest/coverage-v8": "^1.6.1",
124
119
  "ajv": "^8.20.0",
125
120
  "eslint": "^9.0.0",
126
- "javascript-obfuscator": "^5.4.3",
127
121
  "jsdom": "^29.1.1",
128
122
  "react": "^18.3.0",
129
123
  "react-dom": "^18.3.0",