@object-ui/react 3.1.5 → 3.3.1

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 (109) hide show
  1. package/CHANGELOG.md +25 -0
  2. package/README.md +28 -3
  3. package/dist/SchemaRenderer.js +2 -2
  4. package/dist/components/form/FieldFactory.js +5 -2
  5. package/dist/context/AppShellContext.d.ts +26 -0
  6. package/dist/context/AppShellContext.js +67 -0
  7. package/dist/context/index.d.ts +1 -7
  8. package/dist/context/index.js +1 -7
  9. package/dist/hooks/index.d.ts +1 -0
  10. package/dist/hooks/index.js +1 -0
  11. package/dist/hooks/useDataRefresh.d.ts +36 -0
  12. package/dist/hooks/useDataRefresh.js +50 -0
  13. package/dist/hooks/useDiscovery.d.ts +12 -0
  14. package/dist/hooks/useDiscovery.js +6 -0
  15. package/dist/hooks/usePerformanceBudget.js +1 -1
  16. package/package.json +32 -9
  17. package/.turbo/turbo-build.log +0 -4
  18. package/src/LazyPluginLoader.tsx +0 -174
  19. package/src/SchemaRenderer.tsx +0 -266
  20. package/src/__tests__/LazyPluginLoader.test.tsx +0 -176
  21. package/src/__tests__/SchemaRenderer.aria.test.tsx +0 -118
  22. package/src/__tests__/SchemaRenderer.debug.test.tsx +0 -69
  23. package/src/__tests__/SchemaRenderer.errorBoundary.test.tsx +0 -114
  24. package/src/__tests__/SchemaRenderer.expressions.test.tsx +0 -131
  25. package/src/__tests__/SchemaRendererProvider.smoke.test.tsx +0 -132
  26. package/src/__tests__/ThemeProvider.test.tsx +0 -451
  27. package/src/__tests__/useNavigationOverlay.test.ts +0 -578
  28. package/src/__tests__/useOffline.test.ts +0 -198
  29. package/src/__tests__/usePageTransition.test.ts +0 -214
  30. package/src/__tests__/usePageVariables.test.tsx +0 -334
  31. package/src/__tests__/usePerformance.test.ts +0 -137
  32. package/src/__tests__/useViewData.test.tsx +0 -422
  33. package/src/__tests__/view-switching.test.tsx +0 -456
  34. package/src/components/form/FieldFactory.tsx +0 -509
  35. package/src/components/form/FormRenderer.test.tsx +0 -744
  36. package/src/components/form/FormRenderer.tsx +0 -258
  37. package/src/components/form/README.md +0 -352
  38. package/src/components/form/index.ts +0 -12
  39. package/src/context/ActionContext.tsx +0 -213
  40. package/src/context/DndContext.tsx +0 -260
  41. package/src/context/NotificationContext.tsx +0 -280
  42. package/src/context/SchemaRendererContext.tsx +0 -48
  43. package/src/context/ThemeContext.tsx +0 -325
  44. package/src/context/__tests__/ActionContext.test.tsx +0 -174
  45. package/src/context/__tests__/DndContext.test.tsx +0 -150
  46. package/src/context/__tests__/NotificationContext.test.tsx +0 -176
  47. package/src/context/__tests__/useDataScope.test.tsx +0 -91
  48. package/src/context/index.ts +0 -13
  49. package/src/hooks/__tests__/useActionEngine.test.ts +0 -170
  50. package/src/hooks/__tests__/useActionRunner.test.ts +0 -153
  51. package/src/hooks/__tests__/useAnimation.test.ts +0 -82
  52. package/src/hooks/__tests__/useColumnSummary.test.ts +0 -93
  53. package/src/hooks/__tests__/useCrudShortcuts.test.ts +0 -85
  54. package/src/hooks/__tests__/useDebugMode.test.ts +0 -83
  55. package/src/hooks/__tests__/useDensityMode.test.ts +0 -81
  56. package/src/hooks/__tests__/useDiscovery.test.tsx +0 -149
  57. package/src/hooks/__tests__/useDynamicApp.test.ts +0 -161
  58. package/src/hooks/__tests__/useETagCache.test.ts +0 -153
  59. package/src/hooks/__tests__/useExpression.test.ts +0 -86
  60. package/src/hooks/__tests__/useFocusTrap.test.ts +0 -294
  61. package/src/hooks/__tests__/useKeyboardShortcuts.test.ts +0 -144
  62. package/src/hooks/__tests__/usePageTransition.test.ts +0 -158
  63. package/src/hooks/__tests__/usePerformanceBudget.test.ts +0 -157
  64. package/src/hooks/__tests__/useReducedMotion.test.ts +0 -104
  65. package/src/hooks/__tests__/useSchemaPersistence.test.ts +0 -220
  66. package/src/hooks/__tests__/useViewSharing.test.ts +0 -121
  67. package/src/hooks/__tests__/useViewTransition.test.ts +0 -61
  68. package/src/hooks/index.ts +0 -35
  69. package/src/hooks/useActionEngine.ts +0 -84
  70. package/src/hooks/useActionRunner.ts +0 -119
  71. package/src/hooks/useAnimation.ts +0 -117
  72. package/src/hooks/useClientNotifications.ts +0 -251
  73. package/src/hooks/useColumnSummary.ts +0 -87
  74. package/src/hooks/useCrudShortcuts.ts +0 -126
  75. package/src/hooks/useDebugMode.ts +0 -95
  76. package/src/hooks/useDensityMode.ts +0 -102
  77. package/src/hooks/useDiscovery.ts +0 -154
  78. package/src/hooks/useDynamicApp.ts +0 -142
  79. package/src/hooks/useETagCache.ts +0 -404
  80. package/src/hooks/useExpression.ts +0 -56
  81. package/src/hooks/useFocusManagement.ts +0 -248
  82. package/src/hooks/useFocusTrap.ts +0 -138
  83. package/src/hooks/useGlobalUndo.ts +0 -98
  84. package/src/hooks/useKeyboardShortcuts.ts +0 -119
  85. package/src/hooks/useNavigationOverlay.ts +0 -190
  86. package/src/hooks/useOffline.ts +0 -301
  87. package/src/hooks/usePageTransition.ts +0 -187
  88. package/src/hooks/usePageVariables.tsx +0 -157
  89. package/src/hooks/usePerformance.ts +0 -246
  90. package/src/hooks/usePerformanceBudget.ts +0 -313
  91. package/src/hooks/useReducedMotion.ts +0 -53
  92. package/src/hooks/useSchemaPersistence.ts +0 -222
  93. package/src/hooks/useViewData.ts +0 -201
  94. package/src/hooks/useViewSharing.ts +0 -140
  95. package/src/hooks/useViewTransition.ts +0 -144
  96. package/src/index.ts +0 -41
  97. package/src/spec-bridge/SpecBridge.ts +0 -64
  98. package/src/spec-bridge/__tests__/P1SpecBridge.test.ts +0 -855
  99. package/src/spec-bridge/__tests__/SpecBridge.test.ts +0 -550
  100. package/src/spec-bridge/bridges/dashboard.ts +0 -180
  101. package/src/spec-bridge/bridges/form-view.ts +0 -109
  102. package/src/spec-bridge/bridges/list-view.ts +0 -187
  103. package/src/spec-bridge/bridges/page.ts +0 -136
  104. package/src/spec-bridge/index.ts +0 -14
  105. package/src/spec-bridge/types.ts +0 -38
  106. package/src/utils/i18n.ts +0 -10
  107. package/tsconfig.json +0 -17
  108. package/tsconfig.tsbuildinfo +0 -1
  109. package/vitest.config.ts +0 -2
@@ -1,422 +0,0 @@
1
- /**
2
- * ObjectUI — useViewData Tests
3
- * Copyright (c) 2024-present ObjectStack Inc.
4
- *
5
- * This source code is licensed under the MIT license found in the
6
- * LICENSE file in the root directory of this source tree.
7
- */
8
-
9
- import { describe, it, expect, vi } from 'vitest';
10
- import { renderHook, act, waitFor } from '@testing-library/react';
11
- import React from 'react';
12
- import { useViewData } from '../hooks/useViewData';
13
- import { SchemaRendererContext } from '../context/SchemaRendererContext';
14
- import type { DataSource, ViewData, QueryResult } from '@object-ui/types';
15
-
16
- // ---------------------------------------------------------------------------
17
- // Mock DataSource
18
- // ---------------------------------------------------------------------------
19
-
20
- function createMockDataSource(
21
- findResult: QueryResult<any> = { data: [], total: 0 },
22
- ): DataSource<any> {
23
- return {
24
- find: vi.fn().mockResolvedValue(findResult),
25
- findOne: vi.fn().mockResolvedValue(null),
26
- create: vi.fn().mockResolvedValue({}),
27
- update: vi.fn().mockResolvedValue({}),
28
- delete: vi.fn().mockResolvedValue(true),
29
- getObjectSchema: vi.fn().mockResolvedValue({ name: 'test', fields: {} }),
30
- };
31
- }
32
-
33
- // ---------------------------------------------------------------------------
34
- // Helpers
35
- // ---------------------------------------------------------------------------
36
-
37
- function createContextWrapper(dataSource?: any) {
38
- return ({ children }: { children: React.ReactNode }) =>
39
- React.createElement(
40
- SchemaRendererContext.Provider,
41
- { value: { dataSource: dataSource ?? null } },
42
- children,
43
- );
44
- }
45
-
46
- // ---------------------------------------------------------------------------
47
- // provider: 'value' (in-memory)
48
- // ---------------------------------------------------------------------------
49
-
50
- describe('useViewData — provider: value', () => {
51
- it('should load value data synchronously', async () => {
52
- const viewData: ViewData = {
53
- provider: 'value',
54
- items: [
55
- { id: '1', name: 'Alice' },
56
- { id: '2', name: 'Bob' },
57
- ],
58
- };
59
-
60
- const { result } = renderHook(() =>
61
- useViewData({ viewData, resource: 'users' }),
62
- );
63
-
64
- // Value provider resolves through the normal async path (Promise.resolve)
65
- await waitFor(() => {
66
- expect(result.current.loading).toBe(false);
67
- });
68
-
69
- expect(result.current.data).toHaveLength(2);
70
- expect(result.current.totalCount).toBe(2);
71
- expect(result.current.error).toBeNull();
72
- expect(result.current.dataSource).not.toBeNull();
73
- });
74
-
75
- it('should handle empty items', async () => {
76
- const viewData: ViewData = { provider: 'value', items: [] };
77
-
78
- const { result } = renderHook(() =>
79
- useViewData({ viewData, resource: 'users' }),
80
- );
81
-
82
- await waitFor(() => {
83
- expect(result.current.loading).toBe(false);
84
- });
85
-
86
- expect(result.current.data).toHaveLength(0);
87
- expect(result.current.totalCount).toBe(0);
88
- });
89
-
90
- it('should support filtering on value data', async () => {
91
- const viewData: ViewData = {
92
- provider: 'value',
93
- items: [
94
- { id: '1', name: 'Alice', role: 'admin' },
95
- { id: '2', name: 'Bob', role: 'user' },
96
- { id: '3', name: 'Charlie', role: 'admin' },
97
- ],
98
- };
99
-
100
- const { result } = renderHook(() =>
101
- useViewData({
102
- viewData,
103
- resource: 'users',
104
- params: { $filter: { role: 'admin' } },
105
- }),
106
- );
107
-
108
- await waitFor(() => {
109
- expect(result.current.loading).toBe(false);
110
- });
111
-
112
- expect(result.current.data).toHaveLength(2);
113
- expect(result.current.totalCount).toBe(2);
114
- });
115
- });
116
-
117
- // ---------------------------------------------------------------------------
118
- // provider: 'object' (context fallback)
119
- // ---------------------------------------------------------------------------
120
-
121
- describe('useViewData — provider: object', () => {
122
- it('should use context DataSource for object provider', async () => {
123
- const mockDS = createMockDataSource({
124
- data: [{ id: '1', name: 'Contact' }],
125
- total: 1,
126
- });
127
-
128
- const viewData: ViewData = { provider: 'object', object: 'contacts' };
129
-
130
- const { result } = renderHook(
131
- () => useViewData({ viewData, resource: 'contacts' }),
132
- { wrapper: createContextWrapper(mockDS) },
133
- );
134
-
135
- await waitFor(() => {
136
- expect(result.current.loading).toBe(false);
137
- });
138
-
139
- expect(mockDS.find).toHaveBeenCalledWith('contacts', undefined);
140
- expect(result.current.data).toHaveLength(1);
141
- expect(result.current.data[0].name).toBe('Contact');
142
- });
143
-
144
- it('should not fetch when no context DataSource available', async () => {
145
- const viewData: ViewData = { provider: 'object', object: 'contacts' };
146
-
147
- const { result } = renderHook(() =>
148
- useViewData({ viewData, resource: 'contacts' }),
149
- );
150
-
151
- await waitFor(() => {
152
- expect(result.current.loading).toBe(false);
153
- });
154
-
155
- expect(result.current.data).toEqual([]);
156
- expect(result.current.dataSource).toBeNull();
157
- });
158
- });
159
-
160
- // ---------------------------------------------------------------------------
161
- // Explicit DataSource override
162
- // ---------------------------------------------------------------------------
163
-
164
- describe('useViewData — explicit dataSource', () => {
165
- it('should use explicit dataSource over context', async () => {
166
- const contextDS = createMockDataSource();
167
- const explicitDS = createMockDataSource({
168
- data: [{ id: 'x' }],
169
- total: 1,
170
- });
171
-
172
- const { result } = renderHook(
173
- () =>
174
- useViewData({
175
- dataSource: explicitDS,
176
- resource: 'items',
177
- }),
178
- { wrapper: createContextWrapper(contextDS) },
179
- );
180
-
181
- await waitFor(() => {
182
- expect(result.current.loading).toBe(false);
183
- });
184
-
185
- expect(explicitDS.find).toHaveBeenCalled();
186
- expect(contextDS.find).not.toHaveBeenCalled();
187
- expect(result.current.data).toHaveLength(1);
188
- });
189
- });
190
-
191
- // ---------------------------------------------------------------------------
192
- // skip
193
- // ---------------------------------------------------------------------------
194
-
195
- describe('useViewData — skip', () => {
196
- it('should not fetch when skip is true', async () => {
197
- const mockDS = createMockDataSource();
198
- const viewData: ViewData = { provider: 'object', object: 'contacts' };
199
-
200
- const { result } = renderHook(
201
- () => useViewData({ viewData, resource: 'contacts', skip: true }),
202
- { wrapper: createContextWrapper(mockDS) },
203
- );
204
-
205
- // Should immediately be not-loading
206
- expect(result.current.loading).toBe(false);
207
- expect(mockDS.find).not.toHaveBeenCalled();
208
- expect(result.current.data).toEqual([]);
209
- });
210
- });
211
-
212
- // ---------------------------------------------------------------------------
213
- // refresh
214
- // ---------------------------------------------------------------------------
215
-
216
- describe('useViewData — refresh', () => {
217
- it('should re-fetch data on refresh', async () => {
218
- let callCount = 0;
219
- const mockDS: DataSource<any> = {
220
- ...createMockDataSource(),
221
- find: vi.fn().mockImplementation(async () => {
222
- callCount++;
223
- return {
224
- data: [{ id: String(callCount) }],
225
- total: 1,
226
- };
227
- }),
228
- };
229
-
230
- const viewData: ViewData = { provider: 'object', object: 'items' };
231
-
232
- const { result } = renderHook(
233
- () => useViewData({ viewData, resource: 'items' }),
234
- { wrapper: createContextWrapper(mockDS) },
235
- );
236
-
237
- await waitFor(() => {
238
- expect(result.current.loading).toBe(false);
239
- });
240
- expect(result.current.data[0].id).toBe('1');
241
-
242
- // Trigger refresh
243
- await act(async () => {
244
- await result.current.refresh();
245
- });
246
-
247
- expect(result.current.data[0].id).toBe('2');
248
- expect(mockDS.find).toHaveBeenCalledTimes(2);
249
- });
250
-
251
- it('should accept new params on refresh', async () => {
252
- const mockDS = createMockDataSource({ data: [], total: 0 });
253
- const viewData: ViewData = { provider: 'object', object: 'items' };
254
-
255
- const { result } = renderHook(
256
- () => useViewData({ viewData, resource: 'items' }),
257
- { wrapper: createContextWrapper(mockDS) },
258
- );
259
-
260
- await waitFor(() => {
261
- expect(result.current.loading).toBe(false);
262
- });
263
-
264
- await act(async () => {
265
- await result.current.refresh({ $top: 5, $filter: { status: 'active' } });
266
- });
267
-
268
- expect(mockDS.find).toHaveBeenLastCalledWith('items', {
269
- $top: 5,
270
- $filter: { status: 'active' },
271
- });
272
- });
273
- });
274
-
275
- // ---------------------------------------------------------------------------
276
- // fetchOne
277
- // ---------------------------------------------------------------------------
278
-
279
- describe('useViewData — fetchOne', () => {
280
- it('should fetch a single record', async () => {
281
- const mockDS: DataSource<any> = {
282
- ...createMockDataSource(),
283
- findOne: vi.fn().mockResolvedValue({ id: '42', name: 'Found' }),
284
- };
285
-
286
- const viewData: ViewData = { provider: 'object', object: 'items' };
287
-
288
- const { result } = renderHook(
289
- () => useViewData({ viewData, resource: 'items' }),
290
- { wrapper: createContextWrapper(mockDS) },
291
- );
292
-
293
- await waitFor(() => {
294
- expect(result.current.loading).toBe(false);
295
- });
296
-
297
- let record: any;
298
- await act(async () => {
299
- record = await result.current.fetchOne('42');
300
- });
301
-
302
- expect(record).toEqual({ id: '42', name: 'Found' });
303
- expect(mockDS.findOne).toHaveBeenCalledWith('items', '42');
304
- });
305
-
306
- it('should return null when dataSource is not available', async () => {
307
- const { result } = renderHook(() =>
308
- useViewData({ resource: 'items' }),
309
- );
310
-
311
- await waitFor(() => {
312
- expect(result.current.loading).toBe(false);
313
- });
314
-
315
- let record: any;
316
- await act(async () => {
317
- record = await result.current.fetchOne('42');
318
- });
319
-
320
- expect(record).toBeNull();
321
- });
322
- });
323
-
324
- // ---------------------------------------------------------------------------
325
- // Error handling
326
- // ---------------------------------------------------------------------------
327
-
328
- describe('useViewData — errors', () => {
329
- it('should capture fetch errors', async () => {
330
- const mockDS: DataSource<any> = {
331
- ...createMockDataSource(),
332
- find: vi.fn().mockRejectedValue(new Error('Network failure')),
333
- };
334
-
335
- const viewData: ViewData = { provider: 'object', object: 'items' };
336
-
337
- const { result } = renderHook(
338
- () => useViewData({ viewData, resource: 'items' }),
339
- { wrapper: createContextWrapper(mockDS) },
340
- );
341
-
342
- await waitFor(() => {
343
- expect(result.current.loading).toBe(false);
344
- });
345
-
346
- expect(result.current.error).toBeInstanceOf(Error);
347
- expect(result.current.error?.message).toBe('Network failure');
348
- expect(result.current.data).toEqual([]);
349
- expect(result.current.totalCount).toBe(0);
350
- });
351
-
352
- it('should wrap non-Error throws as Error', async () => {
353
- const mockDS: DataSource<any> = {
354
- ...createMockDataSource(),
355
- find: vi.fn().mockRejectedValue('string error'),
356
- };
357
-
358
- const viewData: ViewData = { provider: 'object', object: 'items' };
359
-
360
- const { result } = renderHook(
361
- () => useViewData({ viewData, resource: 'items' }),
362
- { wrapper: createContextWrapper(mockDS) },
363
- );
364
-
365
- await waitFor(() => {
366
- expect(result.current.loading).toBe(false);
367
- });
368
-
369
- expect(result.current.error).toBeInstanceOf(Error);
370
- expect(result.current.error?.message).toBe('string error');
371
- });
372
- });
373
-
374
- // ---------------------------------------------------------------------------
375
- // hasMore
376
- // ---------------------------------------------------------------------------
377
-
378
- describe('useViewData — hasMore', () => {
379
- it('should reflect hasMore from QueryResult', async () => {
380
- const mockDS = createMockDataSource({
381
- data: [{ id: '1' }],
382
- total: 100,
383
- hasMore: true,
384
- });
385
-
386
- const viewData: ViewData = { provider: 'object', object: 'items' };
387
-
388
- const { result } = renderHook(
389
- () => useViewData({ viewData, resource: 'items', params: { $top: 1 } }),
390
- { wrapper: createContextWrapper(mockDS) },
391
- );
392
-
393
- await waitFor(() => {
394
- expect(result.current.loading).toBe(false);
395
- });
396
-
397
- expect(result.current.hasMore).toBe(true);
398
- expect(result.current.totalCount).toBe(100);
399
- });
400
- });
401
-
402
- // ---------------------------------------------------------------------------
403
- // No resource
404
- // ---------------------------------------------------------------------------
405
-
406
- describe('useViewData — edge cases', () => {
407
- it('should not fetch when resource is empty', async () => {
408
- const mockDS = createMockDataSource();
409
- const viewData: ViewData = { provider: 'object', object: 'items' };
410
-
411
- const { result } = renderHook(
412
- () => useViewData({ viewData, resource: '' }),
413
- { wrapper: createContextWrapper(mockDS) },
414
- );
415
-
416
- await waitFor(() => {
417
- expect(result.current.loading).toBe(false);
418
- });
419
-
420
- expect(mockDS.find).not.toHaveBeenCalled();
421
- });
422
- });