@asteby/metacore-runtime-react 53.7.0 → 53.8.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 (76) hide show
  1. package/CHANGELOG.md +32 -0
  2. package/dist/action-modal-dispatcher.d.ts.map +1 -1
  3. package/dist/action-modal-dispatcher.js +3 -1
  4. package/dist/api-context.d.ts.map +1 -1
  5. package/dist/api-context.js +15 -0
  6. package/dist/cache-scope.d.ts +52 -0
  7. package/dist/cache-scope.d.ts.map +1 -0
  8. package/dist/cache-scope.js +200 -0
  9. package/dist/capability-providers/index.d.ts +4 -0
  10. package/dist/capability-providers/index.d.ts.map +1 -0
  11. package/dist/capability-providers/index.js +3 -0
  12. package/dist/capability-providers/model.d.ts +201 -0
  13. package/dist/capability-providers/model.d.ts.map +1 -0
  14. package/dist/capability-providers/model.js +293 -0
  15. package/dist/capability-providers/provider-sortable-list.d.ts +86 -0
  16. package/dist/capability-providers/provider-sortable-list.d.ts.map +1 -0
  17. package/dist/capability-providers/provider-sortable-list.js +263 -0
  18. package/dist/capability-providers/reorder.d.ts +10 -0
  19. package/dist/capability-providers/reorder.d.ts.map +1 -0
  20. package/dist/capability-providers/reorder.js +31 -0
  21. package/dist/dashboard-types.d.ts +2 -4
  22. package/dist/dashboard-types.d.ts.map +1 -1
  23. package/dist/dynamic-kanban.d.ts.map +1 -1
  24. package/dist/dynamic-kanban.js +9 -4
  25. package/dist/dynamic-relation.d.ts.map +1 -1
  26. package/dist/dynamic-relation.js +5 -2
  27. package/dist/dynamic-table.d.ts +2 -0
  28. package/dist/dynamic-table.d.ts.map +1 -1
  29. package/dist/dynamic-table.js +40 -6
  30. package/dist/dynamic-view.d.ts.map +1 -1
  31. package/dist/dynamic-view.js +3 -1
  32. package/dist/index.d.ts +4 -1
  33. package/dist/index.d.ts.map +1 -1
  34. package/dist/index.js +5 -1
  35. package/dist/metadata-cache.d.ts +22 -2
  36. package/dist/metadata-cache.d.ts.map +1 -1
  37. package/dist/metadata-cache.js +73 -13
  38. package/dist/query-batch.d.ts +12 -0
  39. package/dist/query-batch.d.ts.map +1 -1
  40. package/dist/query-batch.js +70 -29
  41. package/dist/use-option-ids.d.ts.map +1 -1
  42. package/dist/use-option-ids.js +3 -1
  43. package/dist/use-options-resolver.d.ts +4 -1
  44. package/dist/use-options-resolver.d.ts.map +1 -1
  45. package/dist/use-options-resolver.js +27 -16
  46. package/dist/widgets/charts.d.ts.map +1 -1
  47. package/dist/widgets/charts.js +11 -43
  48. package/dist/widgets/widget-format.d.ts +1 -41
  49. package/dist/widgets/widget-format.d.ts.map +1 -1
  50. package/dist/widgets/widget-format.js +3 -138
  51. package/package.json +4 -4
  52. package/src/__tests__/charts-reexport.test.ts +30 -0
  53. package/src/action-modal-dispatcher.tsx +3 -1
  54. package/src/api-context.tsx +14 -0
  55. package/src/cache-scope-inflight.test.ts +369 -0
  56. package/src/cache-scope.test.ts +234 -0
  57. package/src/cache-scope.ts +202 -0
  58. package/src/capability-providers/index.ts +46 -0
  59. package/src/capability-providers/model.test.ts +186 -0
  60. package/src/capability-providers/model.ts +464 -0
  61. package/src/capability-providers/provider-sortable-list.test.tsx +284 -0
  62. package/src/capability-providers/provider-sortable-list.tsx +452 -0
  63. package/src/capability-providers/reorder.ts +29 -0
  64. package/src/dashboard-types.ts +2 -11
  65. package/src/dynamic-kanban.tsx +9 -4
  66. package/src/dynamic-relation.tsx +5 -2
  67. package/src/dynamic-table.tsx +41 -10
  68. package/src/dynamic-view.tsx +3 -1
  69. package/src/index.ts +13 -0
  70. package/src/metadata-cache.ts +85 -15
  71. package/src/query-batch.ts +71 -30
  72. package/src/use-option-ids.ts +3 -1
  73. package/src/use-options-resolver.ts +28 -15
  74. package/src/widgets/charts.tsx +26 -189
  75. package/src/widgets/widget-format.ts +14 -181
  76. package/vitest.setup.ts +16 -0
@@ -0,0 +1,284 @@
1
+ // @vitest-environment happy-dom
2
+ import * as React from 'react'
3
+ import { afterEach, describe, expect, it, vi } from 'vitest'
4
+ import { cleanup, fireEvent, render, screen } from '@testing-library/react'
5
+ import { ProviderSortableList, type ProviderSortableItem } from './provider-sortable-list'
6
+ import { dropIndexFromPointer, moveId, moveItem } from './reorder'
7
+ import { providerStatus } from './model'
8
+
9
+ afterEach(cleanup)
10
+
11
+ const items: ProviderSortableItem[] = [
12
+ { id: 'a', label: 'Alfa', status: 'ready' },
13
+ { id: 'b', label: 'Beta', status: 'missing_credentials' },
14
+ { id: 'c', label: 'Gamma', status: 'sandbox' },
15
+ { id: 'x', label: 'Zeta', status: 'unavailable' },
16
+ ]
17
+ const ids = () => [...document.querySelectorAll('li[data-id]:not([data-ineligible])')].map((e) => e.getAttribute('data-id'))
18
+ const handle = (id: string) => document.querySelector(`[data-handle="${id}"]`) as HTMLElement
19
+
20
+ describe('reorder helpers', () => {
21
+ it('moveItem / moveId clamp and no-op', () => {
22
+ expect(moveItem(['a', 'b', 'c'], 0, 2)).toEqual(['b', 'c', 'a'])
23
+ expect(moveItem(['a', 'b', 'c'], 0, -1)).toEqual(['a', 'b', 'c'])
24
+ expect(moveId(['a', 'b', 'c'], 'c', -1)).toEqual(['a', 'c', 'b'])
25
+ expect(moveId(['a', 'b'], 'zz', 1)).toEqual(['a', 'b'])
26
+ })
27
+ it('dropIndexFromPointer counts midpoints above the pointer', () => {
28
+ expect(dropIndexFromPointer(5, [10, 30])).toBe(0)
29
+ expect(dropIndexFromPointer(20, [10, 30])).toBe(1)
30
+ expect(dropIndexFromPointer(99, [10, 30])).toBe(2)
31
+ })
32
+ })
33
+
34
+ describe('ProviderSortableList', () => {
35
+ it('shows status badges, inherited note, and ineligible after the sortable ones', () => {
36
+ render(<ProviderSortableList items={items} onReorder={() => {}} inherited />)
37
+ expect(screen.getByText('Listo')).toBeTruthy()
38
+ expect(screen.getByText('Sin credenciales')).toBeTruthy()
39
+ expect(screen.getByText('Sandbox')).toBeTruthy()
40
+ expect(screen.getByText('No atiende')).toBeTruthy()
41
+ expect(screen.getByText('Hereda de la organización')).toBeTruthy()
42
+ expect(ids()).toEqual(['a', 'b', 'c'])
43
+ })
44
+
45
+ it('keyboard: grab, move, drop emits the new order', () => {
46
+ const onReorder = vi.fn()
47
+ render(<ProviderSortableList items={items} onReorder={onReorder} />)
48
+ fireEvent.keyDown(handle('a'), { key: ' ' })
49
+ fireEvent.keyDown(handle('a'), { key: 'ArrowDown' })
50
+ fireEvent.keyDown(handle('a'), { key: 'ArrowDown' })
51
+ expect(ids()).toEqual(['b', 'c', 'a'])
52
+ expect(onReorder).not.toHaveBeenCalled()
53
+ fireEvent.keyDown(handle('a'), { key: ' ' })
54
+ expect(onReorder).toHaveBeenCalledExactlyOnceWith(['b', 'c', 'a'])
55
+ })
56
+
57
+ it('keyboard: Escape cancels and restores the order', () => {
58
+ const onReorder = vi.fn()
59
+ render(<ProviderSortableList items={items} onReorder={onReorder} />)
60
+ fireEvent.keyDown(handle('b'), { key: 'Enter' })
61
+ fireEvent.keyDown(handle('b'), { key: 'ArrowUp' })
62
+ fireEvent.keyDown(handle('b'), { key: 'Escape' })
63
+ expect(ids()).toEqual(['a', 'b', 'c'])
64
+ expect(onReorder).not.toHaveBeenCalled()
65
+ })
66
+
67
+ it('keyboard: arrows do nothing unless grabbed; edges clamp', () => {
68
+ const onReorder = vi.fn()
69
+ render(<ProviderSortableList items={items} onReorder={onReorder} />)
70
+ fireEvent.keyDown(handle('a'), { key: 'ArrowDown' })
71
+ expect(ids()).toEqual(['a', 'b', 'c'])
72
+ fireEvent.keyDown(handle('a'), { key: ' ' })
73
+ fireEvent.keyDown(handle('a'), { key: 'ArrowUp' })
74
+ fireEvent.keyDown(handle('a'), { key: ' ' })
75
+ expect(onReorder).not.toHaveBeenCalled()
76
+ })
77
+
78
+ it('pointer: dragging over the midpoints emits the new order', () => {
79
+ const onReorder = vi.fn()
80
+ render(<ProviderSortableList items={items} onReorder={onReorder} />)
81
+ const tops: Record<string, number> = { a: 0, b: 40, c: 80 }
82
+ for (const [id, top] of Object.entries(tops)) {
83
+ const li = document.querySelector(`li[data-id="${id}"]`) as HTMLElement
84
+ li.getBoundingClientRect = () => ({ top, height: 30, bottom: top + 30, left: 0, right: 100, width: 100, x: 0, y: top, toJSON() {} }) as DOMRect
85
+ }
86
+ fireEvent.pointerDown(handle('a'), { button: 0, pointerId: 1 })
87
+ fireEvent.pointerMove(handle('a'), { clientY: 100, pointerId: 1 })
88
+ expect(ids()).toEqual(['b', 'c', 'a'])
89
+ fireEvent.pointerUp(handle('a'), { pointerId: 1 })
90
+ expect(onReorder).toHaveBeenCalledExactlyOnceWith(['b', 'c', 'a'])
91
+ })
92
+
93
+ it('a non-eligible item has no handle, never enters the order and cannot be dragged', () => {
94
+ const onReorder = vi.fn()
95
+ render(<ProviderSortableList items={items} onReorder={onReorder} />)
96
+ expect(handle('x')).toBeNull()
97
+ const li = document.querySelector('li[data-id="x"]') as HTMLElement
98
+ expect(li.getAttribute('aria-disabled')).toBe('true')
99
+ fireEvent.pointerDown(li, { button: 0 })
100
+ fireEvent.keyDown(li, { key: ' ' })
101
+ fireEvent.keyDown(li, { key: 'ArrowUp' })
102
+ expect(onReorder).not.toHaveBeenCalled()
103
+ // Moving the last sortable item down never passes the ineligible one.
104
+ fireEvent.keyDown(handle('c'), { key: ' ' })
105
+ fireEvent.keyDown(handle('c'), { key: 'ArrowDown' })
106
+ fireEvent.keyDown(handle('c'), { key: ' ' })
107
+ expect(onReorder).not.toHaveBeenCalled()
108
+ // `eligible: false` also excludes an item whose status is ready.
109
+ render(<ProviderSortableList items={[{ id: 'q', label: 'Q', status: 'ready', eligible: false }]} onReorder={onReorder} />)
110
+ expect(handle('q')).toBeNull()
111
+ })
112
+
113
+ it('honors the order prop and disabled', () => {
114
+ const onReorder = vi.fn()
115
+ render(<ProviderSortableList items={items} order={['c', 'a']} onReorder={onReorder} disabled />)
116
+ expect(ids()).toEqual(['c', 'a', 'b'])
117
+ fireEvent.keyDown(handle('c'), { key: ' ' })
118
+ fireEvent.keyDown(handle('c'), { key: 'ArrowDown' })
119
+ fireEvent.keyDown(handle('c'), { key: ' ' })
120
+ expect(onReorder).not.toHaveBeenCalled()
121
+ })
122
+ })
123
+
124
+ describe('ProviderSortableList: robustness', () => {
125
+ it('items changing mid-grab never crash and drop the vanished grab', () => {
126
+ const onReorder = vi.fn()
127
+ const { rerender } = render(<ProviderSortableList items={items} onReorder={onReorder} />)
128
+ fireEvent.keyDown(handle('b'), { key: ' ' })
129
+ fireEvent.keyDown(handle('b'), { key: 'ArrowDown' })
130
+ // refetch removes the grabbed provider (e.g. addon uninstalled)
131
+ rerender(<ProviderSortableList items={items.filter((i) => i.id !== 'b')} onReorder={onReorder} />)
132
+ expect(ids()).toEqual(['a', 'c'])
133
+ expect(document.querySelector('[data-grabbed]')).toBeNull()
134
+ expect(onReorder).not.toHaveBeenCalled()
135
+ // another id vanishes while a different one stays grabbed: still no crash, order reconciled
136
+ fireEvent.keyDown(handle('a'), { key: ' ' })
137
+ rerender(<ProviderSortableList items={items.filter((i) => i.id === 'a')} onReorder={onReorder} />)
138
+ expect(ids()).toEqual(['a'])
139
+ fireEvent.keyDown(handle('a'), { key: ' ' })
140
+ expect(onReorder).not.toHaveBeenCalled()
141
+ })
142
+
143
+ it('a new provider arriving mid-grab is appended and the draft stays valid', () => {
144
+ const onReorder = vi.fn()
145
+ const { rerender } = render(<ProviderSortableList items={items} onReorder={onReorder} />)
146
+ fireEvent.keyDown(handle('a'), { key: ' ' })
147
+ fireEvent.keyDown(handle('a'), { key: 'ArrowDown' })
148
+ rerender(<ProviderSortableList items={[...items, { id: 'n', label: 'Nuevo', status: 'ready' }]} onReorder={onReorder} />)
149
+ expect(ids()).toEqual(['b', 'a', 'c', 'n'])
150
+ fireEvent.keyDown(handle('a'), { key: ' ' })
151
+ expect(onReorder).toHaveBeenCalledExactlyOnceWith(['b', 'a', 'c', 'n'])
152
+ })
153
+
154
+ it('keyboard keeps the focus and the grab on the handle after moving down', () => {
155
+ // Moving the focused <li> in the DOM blurs the handle (happy-dom does it
156
+ // too); the grab must survive and the focus must come back.
157
+ render(<ProviderSortableList items={items} onReorder={() => {}} />)
158
+ handle('a').focus()
159
+ fireEvent.keyDown(handle('a'), { key: ' ' })
160
+ fireEvent.keyDown(handle('a'), { key: 'ArrowDown' })
161
+ fireEvent.keyDown(handle('a'), { key: 'ArrowDown' })
162
+ expect(ids()).toEqual(['b', 'c', 'a'])
163
+ expect(document.activeElement).toBe(handle('a'))
164
+ expect(handle('a').getAttribute('aria-pressed')).toBe('true')
165
+ })
166
+
167
+ it('pointer: moves and release outside the handle (window) still finish the drag', () => {
168
+ const onReorder = vi.fn()
169
+ render(<ProviderSortableList items={items} onReorder={onReorder} />)
170
+ const tops: Record<string, number> = { a: 0, b: 40, c: 80 }
171
+ for (const [id, top] of Object.entries(tops)) {
172
+ const li = document.querySelector(`li[data-id="${id}"]`) as HTMLElement
173
+ li.getBoundingClientRect = () => ({ top, height: 30, bottom: top + 30, left: 0, right: 100, width: 100, x: 0, y: top, toJSON() {} }) as DOMRect
174
+ }
175
+ fireEvent.pointerDown(handle('a'), { button: 0, pointerId: 1 })
176
+ fireEvent.pointerMove(window, { clientY: 100, pointerId: 1 })
177
+ expect(ids()).toEqual(['b', 'c', 'a'])
178
+ fireEvent.pointerUp(window, { pointerId: 1 })
179
+ expect(onReorder).toHaveBeenCalledExactlyOnceWith(['b', 'c', 'a'])
180
+ expect(document.querySelector('[data-grabbed]')).toBeNull()
181
+ })
182
+
183
+ it('pointer: pointercancel cancels, and a click without moving emits and announces nothing', () => {
184
+ const onReorder = vi.fn()
185
+ render(<ProviderSortableList items={items} onReorder={onReorder} />)
186
+ fireEvent.pointerDown(handle('a'), { button: 0, pointerId: 1 })
187
+ fireEvent.pointerCancel(window, { pointerId: 1 })
188
+ expect(document.querySelector('[data-grabbed]')).toBeNull()
189
+ fireEvent.pointerDown(handle('b'), { button: 0, pointerId: 2 })
190
+ fireEvent.pointerUp(window, { pointerId: 2 })
191
+ expect(onReorder).not.toHaveBeenCalled()
192
+ expect(document.querySelector('[role="status"]')?.textContent).not.toContain('soltado')
193
+ })
194
+
195
+ it('disabled turning true mid-grab drops the grab', () => {
196
+ const { rerender } = render(<ProviderSortableList items={items} onReorder={() => {}} />)
197
+ fireEvent.keyDown(handle('a'), { key: ' ' })
198
+ rerender(<ProviderSortableList items={items} onReorder={() => {}} disabled />)
199
+ expect(document.querySelector('[data-grabbed]')).toBeNull()
200
+ })
201
+ })
202
+
203
+ describe('ProviderSortableList: statuses, controls and a11y', () => {
204
+ it('shows unhealthy and disabled; enabled=false and disabled are never sortable', () => {
205
+ const onReorder = vi.fn()
206
+ render(
207
+ <ProviderSortableList
208
+ items={[
209
+ { id: 'a', label: 'Alfa', status: 'unhealthy' },
210
+ { id: 'd', label: 'Delta', status: 'disabled' },
211
+ { id: 'e', label: 'Eps', status: 'ready', enabled: false },
212
+ ]}
213
+ onReorder={onReorder}
214
+ />,
215
+ )
216
+ expect(ids()).toEqual(['a'])
217
+ expect(screen.getByText('Con fallas')).toBeTruthy()
218
+ expect(screen.getAllByText('Desactivado')).toHaveLength(2)
219
+ expect(handle('d')).toBeNull()
220
+ expect(handle('e')).toBeNull()
221
+ })
222
+
223
+ it('inherited and enabled switches call back; per-item actions render', () => {
224
+ const onInherited = vi.fn()
225
+ const onEnabled = vi.fn()
226
+ render(
227
+ <ProviderSortableList
228
+ items={[{ id: 'a', label: 'Alfa', status: 'missing_credentials', actions: <a href="#c">conectar</a> }]}
229
+ onReorder={() => {}}
230
+ inherited
231
+ onInheritedChange={onInherited}
232
+ onEnabledChange={onEnabled}
233
+ />,
234
+ )
235
+ fireEvent.click(screen.getByLabelText('Hereda de la organización'))
236
+ expect(onInherited).toHaveBeenCalledWith(false)
237
+ fireEvent.click(screen.getByLabelText('Activar Alfa'))
238
+ expect(onEnabled).toHaveBeenCalledWith('a', false)
239
+ expect(screen.getByText('conectar')).toBeTruthy()
240
+ })
241
+
242
+ it('textLabel names the handle when label is not text; keyboard help is linked', () => {
243
+ render(<ProviderSortableList items={[{ id: 'uuid-1', label: <b>Alfa</b>, textLabel: 'Alfa', status: 'ready' }]} onReorder={() => {}} />)
244
+ const h = handle('uuid-1')
245
+ expect(h.getAttribute('aria-label')).toBe('Reordenar Alfa')
246
+ const help = document.getElementById(h.getAttribute('aria-describedby') ?? '')
247
+ expect(help?.textContent).toMatch(/Espacio/)
248
+ })
249
+
250
+ it('ineligible items live in their own list, and the live region is a single polite status', () => {
251
+ render(<ProviderSortableList items={items} onReorder={() => {}} />)
252
+ expect(document.querySelectorAll('ol > li[data-ineligible]')).toHaveLength(0)
253
+ expect(document.querySelectorAll('ul[aria-label] > li[data-ineligible]')).toHaveLength(1)
254
+ const live = document.querySelector('[role="status"]') as HTMLElement
255
+ expect(live.getAttribute('aria-live')).toBe('polite')
256
+ })
257
+
258
+ it('labels override the defaults', () => {
259
+ render(<ProviderSortableList items={[{ id: 'a', label: 'A', status: 'ready' }]} onReorder={() => {}} labels={{ ready: 'Ready' }} />)
260
+ expect(screen.getByText('Ready')).toBeTruthy()
261
+ })
262
+ })
263
+
264
+ describe('providerStatus', () => {
265
+ const p = { addon_key: 'p', installed: true, default: false, countries: ['MX'] }
266
+ it('maps serving, credentials and environment', () => {
267
+ expect(providerStatus(p, undefined, { code: 'us', countries: ['US'] })).toBe('unavailable')
268
+ expect(providerStatus(p, { addon_key: 'p', connection: { state: 'missing_credentials' } }, null)).toBe('missing_credentials')
269
+ expect(providerStatus(p, { addon_key: 'p', connection: { state: 'connected', environment: 'sandbox' } }, null)).toBe('sandbox')
270
+ expect(providerStatus(p, { addon_key: 'p', connection: { state: 'connected', environment: 'production' } }, null)).toBe('ready')
271
+ expect(providerStatus(p, undefined, null)).toBe('ready')
272
+ })
273
+ it('a provider that is not installed is unavailable, never ready', () => {
274
+ expect(providerStatus({ ...p, installed: false }, undefined, null)).toBe('unavailable')
275
+ expect(providerStatus({ ...p, installed: false }, { addon_key: 'p', connection: { state: 'connected', environment: 'production' } }, null)).toBe('unavailable')
276
+ })
277
+ it('disabled and unhealthy come from the row, in precedence order', () => {
278
+ const connected = { addon_key: 'p', connection: { state: 'connected' as const, environment: 'production' as const } }
279
+ expect(providerStatus(p, connected, null, { enabled: false })).toBe('disabled')
280
+ expect(providerStatus(p, connected, null, { healthy: false })).toBe('unhealthy')
281
+ expect(providerStatus(p, { addon_key: 'p', connection: { state: 'missing_credentials' } }, null, { healthy: false })).toBe('missing_credentials')
282
+ expect(providerStatus(p, connected, { code: 'us', countries: ['US'] }, { enabled: false })).toBe('unavailable')
283
+ })
284
+ })