@opencorestack/opengridx 0.1.6 → 0.1.7

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 (129) hide show
  1. package/CHANGELOG.md +15 -0
  2. package/README.md +9 -0
  3. package/dist/index.d.ts +6 -0
  4. package/dist/opengridx.es.js +6 -6
  5. package/dist/opengridx.es.js.map +1 -1
  6. package/dist/opengridx.umd.js +4 -4
  7. package/dist/opengridx.umd.js.map +1 -1
  8. package/docs/API_REFERENCE.md +177 -0
  9. package/docs/README.md +60 -0
  10. package/docs/components/cell.md +44 -0
  11. package/docs/components/column-group-header.md +57 -0
  12. package/docs/components/column-resize.md +63 -0
  13. package/docs/components/column-visibility.md +61 -0
  14. package/docs/components/datagrid.md +70 -0
  15. package/docs/components/filter-panel.md +26 -0
  16. package/docs/components/header.md +39 -0
  17. package/docs/components/pagination.md +34 -0
  18. package/docs/components/row.md +31 -0
  19. package/docs/components/toolbar.md +40 -0
  20. package/docs/components/tooltip.md +68 -0
  21. package/docs/customization/slots-api.md +227 -0
  22. package/docs/customization/theming.md +293 -0
  23. package/docs/features/aggregation-pivot.md +79 -0
  24. package/docs/features/cell-spanning.md +520 -0
  25. package/docs/features/clipboard.md +76 -0
  26. package/docs/features/custom-pagination.md +143 -0
  27. package/docs/features/data-source.md +72 -0
  28. package/docs/features/editing-reordering.md +99 -0
  29. package/docs/features/export-guide.md +434 -0
  30. package/docs/features/filtering.md +83 -0
  31. package/docs/features/infinite-scroll.md +87 -0
  32. package/docs/features/list-view.md +65 -0
  33. package/docs/features/loading-states.md +68 -0
  34. package/docs/features/master-detail.md +46 -0
  35. package/docs/features/pinning.md +67 -0
  36. package/docs/features/selection.md +70 -0
  37. package/docs/features/sorting-pagination.md +66 -0
  38. package/docs/features/state-persistence.md +67 -0
  39. package/docs/features/tree-data-grouping.md +67 -0
  40. package/docs/features/virtualization.md +188 -0
  41. package/docs/roadmap.md +71 -0
  42. package/lib/components/Cell/Cell.css +119 -0
  43. package/lib/components/Cell/Cell.tsx +264 -0
  44. package/lib/components/Cell/GridEditInputCell.css +62 -0
  45. package/lib/components/Cell/GridEditInputCell.tsx +152 -0
  46. package/lib/components/ColumnGroupHeader/ColumnGroupHeader.css +67 -0
  47. package/lib/components/ColumnGroupHeader/ColumnGroupHeader.tsx +220 -0
  48. package/lib/components/ColumnResizeHandle/ColumnResizeHandle.css +31 -0
  49. package/lib/components/ColumnResizeHandle/ColumnResizeHandle.tsx +85 -0
  50. package/lib/components/ColumnVisibilityPanel/ColumnVisibilityPanel.css +137 -0
  51. package/lib/components/ColumnVisibilityPanel/ColumnVisibilityPanel.tsx +190 -0
  52. package/lib/components/DataGrid/DataGrid.css +224 -0
  53. package/lib/components/DataGrid/DataGrid.tsx +2253 -0
  54. package/lib/components/DetailPanel/DetailPanel.css +36 -0
  55. package/lib/components/DetailPanel/DetailPanel.tsx +34 -0
  56. package/lib/components/FilterPanel/FilterPanel.css +196 -0
  57. package/lib/components/FilterPanel/FilterPanel.tsx +183 -0
  58. package/lib/components/FilterPanel/index.ts +1 -0
  59. package/lib/components/Header/ColumnMenu.css +68 -0
  60. package/lib/components/Header/ColumnMenu.tsx +249 -0
  61. package/lib/components/Header/Header.css +224 -0
  62. package/lib/components/Header/Header.tsx +516 -0
  63. package/lib/components/ListView/ListView.css +112 -0
  64. package/lib/components/ListView/ListViewRow.tsx +63 -0
  65. package/lib/components/Pagination/Pagination.css +91 -0
  66. package/lib/components/Pagination/Pagination.tsx +151 -0
  67. package/lib/components/QuickFilter/QuickFilter.css +23 -0
  68. package/lib/components/QuickFilter/QuickFilter.tsx +79 -0
  69. package/lib/components/Row/Row.css +126 -0
  70. package/lib/components/Row/Row.tsx +377 -0
  71. package/lib/components/Skeleton/Skeleton.css +55 -0
  72. package/lib/components/Skeleton/Skeleton.tsx +22 -0
  73. package/lib/components/SkeletonRow/SkeletonRow.css +32 -0
  74. package/lib/components/SkeletonRow/SkeletonRow.tsx +89 -0
  75. package/lib/components/SkeletonRow/index.ts +1 -0
  76. package/lib/components/Toolbar/GlobalSearch.css +113 -0
  77. package/lib/components/Toolbar/GlobalSearch.tsx +120 -0
  78. package/lib/components/Toolbar/GridToolbar.css +204 -0
  79. package/lib/components/Toolbar/GridToolbar.tsx +647 -0
  80. package/lib/components/Toolbar/PivotPanel.css +212 -0
  81. package/lib/components/Toolbar/PivotPanel.tsx +239 -0
  82. package/lib/components/Tooltip/Tooltip.css +59 -0
  83. package/lib/components/Tooltip/Tooltip.tsx +106 -0
  84. package/lib/components/ui/Button.css +89 -0
  85. package/lib/components/ui/Button.tsx +39 -0
  86. package/lib/components/ui/Checkbox.css +71 -0
  87. package/lib/components/ui/Checkbox.tsx +66 -0
  88. package/lib/components/ui/DragHandleIcon.css +19 -0
  89. package/lib/components/ui/DragHandleIcon.tsx +18 -0
  90. package/lib/components/ui/ExpandIcon.css +38 -0
  91. package/lib/components/ui/ExpandIcon.tsx +75 -0
  92. package/lib/components/ui/Input.css +59 -0
  93. package/lib/components/ui/Input.tsx +45 -0
  94. package/lib/components/ui/index.ts +15 -0
  95. package/lib/hooks/core/useDataGrid.ts +392 -0
  96. package/lib/hooks/core/useGridApiRef.ts +10 -0
  97. package/lib/hooks/features/useAggregation.ts +143 -0
  98. package/lib/hooks/features/useGridClipboard.ts +133 -0
  99. package/lib/hooks/features/useGridDataSource.ts +190 -0
  100. package/lib/hooks/features/useGridEditing.ts +100 -0
  101. package/lib/hooks/features/useGridSpanning.ts +349 -0
  102. package/lib/hooks/features/usePivot.ts +149 -0
  103. package/lib/hooks/useColumnReorder.ts +114 -0
  104. package/lib/hooks/useRowGrouping.ts +302 -0
  105. package/lib/hooks/useRowReorder.ts +83 -0
  106. package/lib/hooks/useTreeData.ts +323 -0
  107. package/lib/index.ts +106 -0
  108. package/lib/state/index.ts +17 -0
  109. package/lib/state/types.ts +48 -0
  110. package/lib/state/useGridStateStorage.ts +113 -0
  111. package/lib/styles/base/reset.css +21 -0
  112. package/lib/styles/base/variables.css +161 -0
  113. package/lib/styles/opengridx.css +27 -0
  114. package/lib/styles/opengridx.css.d.ts +4 -0
  115. package/lib/theme/DataGridThemeProvider.tsx +276 -0
  116. package/lib/theme/defaultStyles.ts +0 -0
  117. package/lib/theme/index.ts +21 -0
  118. package/lib/theme/presets.ts +148 -0
  119. package/lib/theme/types.ts +155 -0
  120. package/lib/types/index.ts +764 -0
  121. package/lib/utils/export/exportToExcelAdvanced.ts +516 -0
  122. package/lib/utils/export/index.ts +550 -0
  123. package/lib/utils/filtering/index.ts +240 -0
  124. package/lib/utils/pinning/index.ts +282 -0
  125. package/lib/utils/sorting/index.ts +55 -0
  126. package/lib/utils/virtualization/index.ts +106 -0
  127. package/lib/vite-env.d.ts +1 -0
  128. package/llms.txt +2 -1
  129. package/package.json +13 -4
@@ -0,0 +1,120 @@
1
+ import React, { useState, useEffect, useRef } from 'react';
2
+
3
+
4
+ interface GlobalSearchProps {
5
+ value?: string;
6
+ onChange: (value: string) => void;
7
+ placeholder?: string;
8
+ debounceMs?: number;
9
+ }
10
+
11
+ function SearchIcon() {
12
+ return (
13
+ <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2.5" strokeLinecap="round" strokeLinejoin="round">
14
+ <circle cx="11" cy="11" r="8" />
15
+ <line x1="21" y1="21" x2="16.65" y2="16.65" />
16
+ </svg>
17
+ );
18
+ }
19
+
20
+ function CloseIcon() {
21
+ return (
22
+ <svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round">
23
+ <line x1="18" y1="6" x2="6" y2="18" />
24
+ <line x1="6" y1="6" x2="18" y2="18" />
25
+ </svg>
26
+ );
27
+ }
28
+
29
+ export function GlobalSearch({ value = '', onChange, placeholder = 'Search...', debounceMs = 250 }: GlobalSearchProps) {
30
+ const [isExpanded, setIsExpanded] = useState(false);
31
+ const [localValue, setLocalValue] = useState(value);
32
+ const inputRef = useRef<HTMLInputElement>(null);
33
+ const containerRef = useRef<HTMLDivElement>(null);
34
+
35
+ // Sync local value with prop
36
+ useEffect(() => {
37
+ setLocalValue(value);
38
+ if (value && !isExpanded) {
39
+ setIsExpanded(true);
40
+ }
41
+ }, [value, isExpanded]);
42
+
43
+ // Debounce change
44
+ useEffect(() => {
45
+ const handler = setTimeout(() => {
46
+ if (localValue !== value) {
47
+ onChange(localValue);
48
+ }
49
+ }, debounceMs);
50
+ return () => clearTimeout(handler);
51
+ }, [localValue, onChange, debounceMs, value]);
52
+
53
+ const handleFocus = () => {
54
+ setIsExpanded(true);
55
+ };
56
+
57
+ const handleClear = (e: React.MouseEvent) => {
58
+ e.stopPropagation();
59
+ setLocalValue('');
60
+ inputRef.current?.focus();
61
+ onChange(''); // Immediate clear
62
+ };
63
+
64
+ // Close on blur if empty
65
+ const handleBlur = () => {
66
+ if (!localValue) {
67
+ setIsExpanded(false);
68
+ }
69
+ };
70
+
71
+ // Click outside to collapse if empty
72
+ useEffect(() => {
73
+ const handleClickOutside = (event: MouseEvent) => {
74
+ if (containerRef.current && !containerRef.current.contains(event.target as Node)) {
75
+ if (!localValue) {
76
+ setIsExpanded(false);
77
+ }
78
+ }
79
+ };
80
+
81
+ document.addEventListener('mousedown', handleClickOutside);
82
+ return () => document.removeEventListener('mousedown', handleClickOutside);
83
+ }, [localValue]);
84
+
85
+ return (
86
+ <div
87
+ ref={containerRef}
88
+ className={`ogx-global-search${isExpanded ? ' ogx-global-search--expanded' : ''}`}
89
+ onClick={() => {
90
+ if (!isExpanded) {
91
+ setIsExpanded(true);
92
+
93
+ setTimeout(() => inputRef.current?.focus(), 50);
94
+ }
95
+ }}
96
+ >
97
+ <div className="ogx-global-search__icon-wrapper">
98
+ <SearchIcon />
99
+ </div>
100
+ <input
101
+ ref={inputRef}
102
+ id="ogx-global-search-input"
103
+ name="ogx-global-search"
104
+ className="ogx-global-search__input"
105
+ value={localValue}
106
+ onChange={(e) => setLocalValue(e.target.value)}
107
+ onFocus={handleFocus}
108
+ onBlur={handleBlur}
109
+ placeholder={placeholder}
110
+ aria-label="Global Search"
111
+ autoComplete="off"
112
+ />
113
+ {localValue && (
114
+ <button className="ogx-global-search__clear" onClick={handleClear} aria-label="Clear search">
115
+ <CloseIcon />
116
+ </button>
117
+ )}
118
+ </div>
119
+ );
120
+ }
@@ -0,0 +1,204 @@
1
+ .ogx-toolbar {
2
+ display: flex;
3
+ align-items: center;
4
+ gap: var(--ogx-spacing-sm);
5
+ padding: var(--ogx-spacing-sm) var(--ogx-spacing-sm);
6
+ border-bottom: var(--ogx-border-width-thin) solid var(--ogx-grid-border-color);
7
+ background: var(--ogx-grid-header-background);
8
+ min-height: 44px;
9
+ position: relative;
10
+ z-index: 100;
11
+ }
12
+ .ogx-toolbar__left {
13
+ display: flex;
14
+ align-items: center;
15
+ gap: var(--ogx-spacing-sm);
16
+ }
17
+ .ogx-toolbar__spacer {
18
+ flex: 1;
19
+ }
20
+ .ogx-toolbar__actions {
21
+ display: flex;
22
+ align-items: center;
23
+ gap: var(--ogx-spacing-xs);
24
+ flex-wrap: nowrap;
25
+ flex-shrink: 0;
26
+ padding-right: 5px;
27
+ }
28
+ .ogx-toolbar__dropdown-wrapper {
29
+ position: relative;
30
+ }
31
+ .ogx-toolbar__icon-btn {
32
+ display: inline-flex;
33
+ align-items: center;
34
+ justify-content: center;
35
+ width: 34px;
36
+ height: 34px;
37
+ padding: 0;
38
+ border: none;
39
+ border-radius: 8px;
40
+ background: transparent;
41
+ color: var(--ogx-grid-header-text);
42
+ cursor: pointer;
43
+ transition: background 0.15s, color 0.15s;
44
+ position: relative;
45
+ }
46
+ .ogx-toolbar__icon-btn:hover {
47
+ background: var(--ogx-grid-header-hover-background);
48
+ }
49
+ .ogx-toolbar__icon-btn--active {
50
+ background: var(--ogx-grid-header-hover-background);
51
+ outline: none;
52
+ }
53
+ .ogx-toolbar__icon-btn:focus {
54
+ outline: none;
55
+ }
56
+ .ogx-toolbar__icon-btn:focus-visible {
57
+ outline: 2px solid var(--ogx-color-primary);
58
+ outline-offset: 1px;
59
+ }
60
+ .ogx-toolbar__dot {
61
+ position: absolute;
62
+ top: 4px;
63
+ right: 4px;
64
+ width: 8px;
65
+ height: 8px;
66
+ border-radius: 50%;
67
+ background: var(--ogx-color-success, #10b981);
68
+ border: 1.5px solid var(--ogx-grid-header-background, #fff);
69
+ pointer-events: none;
70
+ }
71
+ .ogx-toolbar__panel {
72
+ position: fixed;
73
+ width: 380px;
74
+ max-width: calc(100vw - 24px);
75
+ background: var(--ogx-overlay-background, var(--ogx-grid-background));
76
+ border: var(--ogx-border-width-thin) solid var(--ogx-overlay-border, var(--ogx-grid-border-color));
77
+ border-radius: var(--ogx-border-radius-lg);
78
+ box-shadow: var(--ogx-overlay-shadow, var(--ogx-shadow-lg));
79
+ z-index: 9999;
80
+ overflow: hidden;
81
+ animation: ogx-panel-in 0.15s ease-out;
82
+ }
83
+ @keyframes ogx-panel-in {
84
+ from { opacity: 0; transform: translateY(-6px) scale(0.98); }
85
+ to { opacity: 1; transform: translateY(0) scale(1); }
86
+ }
87
+ .ogx-toolbar__panel-header {
88
+ display: flex;
89
+ align-items: center;
90
+ justify-content: space-between;
91
+ padding: var(--ogx-spacing-sm) var(--ogx-spacing-md);
92
+ border-bottom: var(--ogx-border-width-thin) solid var(--ogx-overlay-border, var(--ogx-grid-border-color));
93
+ background: var(--ogx-grid-header-background);
94
+ }
95
+ .ogx-toolbar__panel-title {
96
+ display: flex;
97
+ align-items: center;
98
+ gap: var(--ogx-spacing-xs);
99
+ font-family: var(--ogx-font-family);
100
+ font-size: var(--ogx-font-size-sm);
101
+ font-weight: 600;
102
+ color: var(--ogx-grid-header-text);
103
+ }
104
+ .ogx-toolbar__clear-btn {
105
+ padding: 2px 8px;
106
+ border: var(--ogx-border-width-thin) solid var(--ogx-border-color);
107
+ border-radius: var(--ogx-border-radius-sm);
108
+ background: transparent;
109
+ color: var(--ogx-color-error, #ef4444);
110
+ font-family: var(--ogx-font-family);
111
+ font-size: var(--ogx-font-size-xs);
112
+ font-weight: 500;
113
+ cursor: pointer;
114
+ transition: background 0.15s, border-color 0.15s;
115
+ }
116
+ .ogx-toolbar__clear-btn:hover {
117
+ background: var(--ogx-toolbar-btn-danger-bg, rgba(239, 68, 68, 0.08));
118
+ border-color: var(--ogx-color-error, #ef4444);
119
+ }
120
+ .ogx-toolbar__panel-body {
121
+ padding: var(--ogx-spacing-xs) 0;
122
+ max-height: 360px;
123
+ overflow-y: auto;
124
+ }
125
+ .ogx-toolbar__empty {
126
+ padding: var(--ogx-spacing-md) var(--ogx-spacing-md);
127
+ font-family: var(--ogx-font-family);
128
+ font-size: var(--ogx-font-size-sm);
129
+ color: var(--ogx-grid-header-text);
130
+ line-height: 1.5;
131
+ text-align: center;
132
+ }
133
+ .ogx-toolbar__empty code {
134
+ font-family: var(--ogx-font-family-mono);
135
+ font-size: 0.9em;
136
+ background: var(--ogx-grid-header-background);
137
+ padding: 1px 4px;
138
+ border-radius: 3px;
139
+ }
140
+ .ogx-toolbar__agg-row {
141
+ display: flex;
142
+ align-items: center;
143
+ gap: var(--ogx-spacing-md);
144
+ padding: 8px var(--ogx-spacing-md);
145
+ border-bottom: var(--ogx-border-width-thin) solid var(--ogx-overlay-border, var(--ogx-grid-border-color));
146
+ transition: background 0.1s;
147
+ }
148
+ .ogx-toolbar__agg-row:last-child {
149
+ border-bottom: none;
150
+ }
151
+ .ogx-toolbar__agg-row:hover {
152
+ background: var(--ogx-overlay-item-hover-bg, var(--ogx-grid-row-hover-background));
153
+ }
154
+ .ogx-toolbar__agg-label {
155
+ flex: 0 0 100px;
156
+ font-family: var(--ogx-font-family);
157
+ font-size: var(--ogx-font-size-xs);
158
+ font-weight: 500;
159
+ color: var(--ogx-grid-row-text);
160
+ overflow: hidden;
161
+ text-overflow: ellipsis;
162
+ white-space: nowrap;
163
+ }
164
+ .ogx-toolbar__agg-pills {
165
+ display: flex;
166
+ gap: 4px;
167
+ flex-wrap: wrap;
168
+ }
169
+ .ogx-toolbar__pill {
170
+ display: inline-flex;
171
+ align-items: center;
172
+ padding: 3px 6px;
173
+ border: var(--ogx-border-width-thin) solid var(--ogx-overlay-border, var(--ogx-border-color));
174
+ border-radius: 999px;
175
+ background: transparent;
176
+ color: var(--ogx-grid-row-text);
177
+ font-family: var(--ogx-font-family-mono, monospace);
178
+ font-size: 10px;
179
+ font-weight: 500;
180
+ cursor: pointer;
181
+ text-transform: uppercase;
182
+ letter-spacing: 0.03em;
183
+ transition: background 0.15s, border-color 0.15s, color 0.15s;
184
+ line-height: 1;
185
+ white-space: nowrap;
186
+ }
187
+ .ogx-toolbar__pill:hover {
188
+ background: var(--ogx-grid-header-hover-background);
189
+ border-color: var(--ogx-color-primary);
190
+ color: var(--ogx-color-primary);
191
+ }
192
+ .ogx-toolbar__pill--active {
193
+ background: var(--ogx-toolbar-chip-active-bg, var(--ogx-color-primary));
194
+ border-color: var(--ogx-toolbar-chip-active-bg, var(--ogx-color-primary));
195
+ color: var(--ogx-toolbar-chip-active-text, #fff);
196
+ font-weight: 700;
197
+ }
198
+ .ogx-toolbar__pill--active:hover {
199
+ background: var(--ogx-toolbar-btn-primary-hover, var(--ogx-color-primary-dark));
200
+ border-color: var(--ogx-toolbar-btn-primary-hover, var(--ogx-color-primary-dark));
201
+ color: var(--ogx-toolbar-btn-primary-text, #fff);
202
+ }
203
+
204
+ /* Tooltip classes removed - migrated to Tooltip component */