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