@object-ui/react 3.3.0 → 3.3.2

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 (103) hide show
  1. package/CHANGELOG.md +18 -0
  2. package/README.md +21 -1
  3. package/dist/SchemaRenderer.js +19 -2
  4. package/dist/context/AppShellContext.d.ts +26 -0
  5. package/dist/context/AppShellContext.js +67 -0
  6. package/dist/context/index.d.ts +1 -7
  7. package/dist/context/index.js +1 -7
  8. package/package.json +32 -9
  9. package/.turbo/turbo-build.log +0 -4
  10. package/src/LazyPluginLoader.tsx +0 -174
  11. package/src/SchemaRenderer.tsx +0 -266
  12. package/src/__tests__/LazyPluginLoader.test.tsx +0 -176
  13. package/src/__tests__/SchemaRenderer.aria.test.tsx +0 -118
  14. package/src/__tests__/SchemaRenderer.debug.test.tsx +0 -69
  15. package/src/__tests__/SchemaRenderer.errorBoundary.test.tsx +0 -114
  16. package/src/__tests__/SchemaRenderer.expressions.test.tsx +0 -131
  17. package/src/__tests__/SchemaRendererProvider.smoke.test.tsx +0 -132
  18. package/src/__tests__/ThemeProvider.test.tsx +0 -451
  19. package/src/__tests__/useNavigationOverlay.test.ts +0 -578
  20. package/src/__tests__/useOffline.test.ts +0 -198
  21. package/src/__tests__/usePageTransition.test.ts +0 -214
  22. package/src/__tests__/usePageVariables.test.tsx +0 -334
  23. package/src/__tests__/usePerformance.test.ts +0 -137
  24. package/src/__tests__/useViewData.test.tsx +0 -422
  25. package/src/__tests__/view-switching.test.tsx +0 -456
  26. package/src/components/form/FieldFactory.tsx +0 -516
  27. package/src/components/form/FormRenderer.test.tsx +0 -744
  28. package/src/components/form/FormRenderer.tsx +0 -258
  29. package/src/components/form/README.md +0 -352
  30. package/src/components/form/index.ts +0 -12
  31. package/src/context/ActionContext.tsx +0 -213
  32. package/src/context/DndContext.tsx +0 -260
  33. package/src/context/NotificationContext.tsx +0 -280
  34. package/src/context/SchemaRendererContext.tsx +0 -48
  35. package/src/context/ThemeContext.tsx +0 -325
  36. package/src/context/__tests__/ActionContext.test.tsx +0 -174
  37. package/src/context/__tests__/DndContext.test.tsx +0 -150
  38. package/src/context/__tests__/NotificationContext.test.tsx +0 -176
  39. package/src/context/__tests__/useDataScope.test.tsx +0 -91
  40. package/src/context/index.ts +0 -13
  41. package/src/hooks/__tests__/useActionEngine.test.ts +0 -170
  42. package/src/hooks/__tests__/useActionRunner.test.ts +0 -153
  43. package/src/hooks/__tests__/useAnimation.test.ts +0 -82
  44. package/src/hooks/__tests__/useColumnSummary.test.ts +0 -93
  45. package/src/hooks/__tests__/useCrudShortcuts.test.ts +0 -85
  46. package/src/hooks/__tests__/useDataRefresh.test.ts +0 -115
  47. package/src/hooks/__tests__/useDebugMode.test.ts +0 -83
  48. package/src/hooks/__tests__/useDensityMode.test.ts +0 -81
  49. package/src/hooks/__tests__/useDiscovery.test.tsx +0 -247
  50. package/src/hooks/__tests__/useDynamicApp.test.ts +0 -161
  51. package/src/hooks/__tests__/useETagCache.test.ts +0 -153
  52. package/src/hooks/__tests__/useExpression.test.ts +0 -86
  53. package/src/hooks/__tests__/useFocusTrap.test.ts +0 -294
  54. package/src/hooks/__tests__/useKeyboardShortcuts.test.ts +0 -144
  55. package/src/hooks/__tests__/usePageTransition.test.ts +0 -158
  56. package/src/hooks/__tests__/usePerformanceBudget.test.ts +0 -157
  57. package/src/hooks/__tests__/useReducedMotion.test.ts +0 -104
  58. package/src/hooks/__tests__/useSchemaPersistence.test.ts +0 -220
  59. package/src/hooks/__tests__/useViewSharing.test.ts +0 -121
  60. package/src/hooks/__tests__/useViewTransition.test.ts +0 -61
  61. package/src/hooks/index.ts +0 -36
  62. package/src/hooks/useActionEngine.ts +0 -84
  63. package/src/hooks/useActionRunner.ts +0 -119
  64. package/src/hooks/useAnimation.ts +0 -117
  65. package/src/hooks/useClientNotifications.ts +0 -251
  66. package/src/hooks/useColumnSummary.ts +0 -87
  67. package/src/hooks/useCrudShortcuts.ts +0 -126
  68. package/src/hooks/useDataRefresh.ts +0 -58
  69. package/src/hooks/useDebugMode.ts +0 -95
  70. package/src/hooks/useDensityMode.ts +0 -102
  71. package/src/hooks/useDiscovery.ts +0 -168
  72. package/src/hooks/useDynamicApp.ts +0 -142
  73. package/src/hooks/useETagCache.ts +0 -404
  74. package/src/hooks/useExpression.ts +0 -56
  75. package/src/hooks/useFocusManagement.ts +0 -248
  76. package/src/hooks/useFocusTrap.ts +0 -138
  77. package/src/hooks/useGlobalUndo.ts +0 -98
  78. package/src/hooks/useKeyboardShortcuts.ts +0 -119
  79. package/src/hooks/useNavigationOverlay.ts +0 -190
  80. package/src/hooks/useOffline.ts +0 -301
  81. package/src/hooks/usePageTransition.ts +0 -187
  82. package/src/hooks/usePageVariables.tsx +0 -157
  83. package/src/hooks/usePerformance.ts +0 -246
  84. package/src/hooks/usePerformanceBudget.ts +0 -313
  85. package/src/hooks/useReducedMotion.ts +0 -53
  86. package/src/hooks/useSchemaPersistence.ts +0 -222
  87. package/src/hooks/useViewData.ts +0 -201
  88. package/src/hooks/useViewSharing.ts +0 -140
  89. package/src/hooks/useViewTransition.ts +0 -144
  90. package/src/index.ts +0 -41
  91. package/src/spec-bridge/SpecBridge.ts +0 -64
  92. package/src/spec-bridge/__tests__/P1SpecBridge.test.ts +0 -855
  93. package/src/spec-bridge/__tests__/SpecBridge.test.ts +0 -550
  94. package/src/spec-bridge/bridges/dashboard.ts +0 -180
  95. package/src/spec-bridge/bridges/form-view.ts +0 -109
  96. package/src/spec-bridge/bridges/list-view.ts +0 -187
  97. package/src/spec-bridge/bridges/page.ts +0 -136
  98. package/src/spec-bridge/index.ts +0 -14
  99. package/src/spec-bridge/types.ts +0 -38
  100. package/src/utils/i18n.ts +0 -10
  101. package/tsconfig.json +0 -17
  102. package/tsconfig.tsbuildinfo +0 -1
  103. 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
- });