@api-client/ui 0.1.1 → 0.1.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 (42) hide show
  1. package/build/src/core/Activity.d.ts +3 -3
  2. package/build/src/core/Activity.d.ts.map +1 -1
  3. package/build/src/core/Activity.js +8 -7
  4. package/build/src/core/Activity.js.map +1 -1
  5. package/build/src/core/ActivityManager.d.ts +9 -0
  6. package/build/src/core/ActivityManager.d.ts.map +1 -1
  7. package/build/src/core/ActivityManager.js +57 -12
  8. package/build/src/core/ActivityManager.js.map +1 -1
  9. package/build/src/core/Application.d.ts +1 -0
  10. package/build/src/core/Application.d.ts.map +1 -1
  11. package/build/src/core/Application.js +3 -0
  12. package/build/src/core/Application.js.map +1 -1
  13. package/build/src/core/Fragment.d.ts +9 -3
  14. package/build/src/core/Fragment.d.ts.map +1 -1
  15. package/build/src/core/Fragment.js +17 -8
  16. package/build/src/core/Fragment.js.map +1 -1
  17. package/build/src/core/FragmentManager.d.ts +17 -0
  18. package/build/src/core/FragmentManager.d.ts.map +1 -1
  19. package/build/src/core/FragmentManager.js +58 -2
  20. package/build/src/core/FragmentManager.js.map +1 -1
  21. package/build/src/core/renderer/Renderer.d.ts +4 -1
  22. package/build/src/core/renderer/Renderer.d.ts.map +1 -1
  23. package/build/src/core/renderer/Renderer.js +3 -0
  24. package/build/src/core/renderer/Renderer.js.map +1 -1
  25. package/build/src/elements/data-table/DataTable.d.ts +7 -0
  26. package/build/src/elements/data-table/DataTable.d.ts.map +1 -1
  27. package/build/src/elements/data-table/DataTable.js +8 -0
  28. package/build/src/elements/data-table/DataTable.js.map +1 -1
  29. package/package.json +1 -1
  30. package/src/core/Activity.ts +8 -7
  31. package/src/core/ActivityManager.ts +58 -12
  32. package/src/core/Application.ts +4 -0
  33. package/src/core/Fragment.ts +18 -8
  34. package/src/core/FragmentManager.ts +61 -3
  35. package/src/core/renderer/Renderer.ts +4 -1
  36. package/src/elements/data-table/DataTable.ts +7 -0
  37. package/test/core/activity.spec.ts +235 -2
  38. package/test/core/activity_manager.spec.ts +544 -0
  39. package/test/core/application.spec.ts +218 -0
  40. package/test/core/fragment.spec.ts +472 -0
  41. package/test/core/fragment_manager.spec.ts +404 -0
  42. package/web-test-runner.config.js +1 -1
@@ -0,0 +1,218 @@
1
+ import { assert } from '@esm-bundle/chai'
2
+ import sinon from 'sinon'
3
+ import { fixture, html } from '@open-wc/testing'
4
+ import { Application, type UpdateRequest } from '../../src/core/Application.js'
5
+ import { Activity } from '../../src/core/Activity.js'
6
+ import { ActivityManager, ActivityState } from '../../src/core/ActivityManager.js'
7
+ import { ApplicationRenderer } from '../../src/core/renderer/ApplicationRenderer.js'
8
+ import { ThemeManager } from '../../src/core/ThemeManager.js'
9
+ import { nothing } from 'lit'
10
+
11
+ class TestActivity extends Activity {
12
+ static override action = 'test-activity'
13
+ renderSpy = sinon.spy(super.render)
14
+ override render() {
15
+ this.renderSpy()
16
+ return html`<div>Test Activity Content</div>`
17
+ }
18
+ }
19
+
20
+ class TestApplication extends Application {
21
+ onStartSpy = sinon.stub().resolves()
22
+ onStopSpy = sinon.stub().resolves()
23
+ onFirstRenderSpy = sinon.spy(super.onFirstRender)
24
+ onRenderedSpy = sinon.spy(super.onRendered)
25
+
26
+ override async onStart(): Promise<void> {
27
+ this.manager.registerActivity(TestActivity.action, TestActivity)
28
+ return this.onStartSpy()
29
+ }
30
+
31
+ override async onStop(): Promise<void> {
32
+ return this.onStopSpy()
33
+ }
34
+
35
+ override onFirstRender(): void {
36
+ // super.onFirstRender()
37
+ this.onFirstRenderSpy()
38
+ }
39
+
40
+ override onRendered(): void {
41
+ // super.onRendered()
42
+ this.onRenderedSpy()
43
+ }
44
+ }
45
+
46
+ async function basicFixture(): Promise<HTMLElement> {
47
+ return fixture(html`<div id="app-root"></div>`)
48
+ }
49
+
50
+ describe('Application', () => {
51
+ let renderRootElement: HTMLElement
52
+ let app: TestApplication
53
+
54
+ beforeEach(async () => {
55
+ renderRootElement = await basicFixture()
56
+ app = new TestApplication(renderRootElement)
57
+ })
58
+
59
+ afterEach(() => {
60
+ sinon.restore()
61
+ })
62
+
63
+ describe('Constructor and Getters', () => {
64
+ it('initializes ActivityManager', () => {
65
+ assert.instanceOf(app.manager, ActivityManager)
66
+ })
67
+
68
+ it('initializes ApplicationRenderer and sets render root', () => {
69
+ assert.instanceOf(app.renderer, ApplicationRenderer)
70
+ assert.strictEqual(app.renderer.renderRoot, renderRootElement)
71
+ })
72
+
73
+ it('initializes ThemeManager', () => {
74
+ assert.instanceOf(app.theme, ThemeManager)
75
+ })
76
+
77
+ it('initializes events EventTarget', () => {
78
+ assert.instanceOf(app.events, EventTarget)
79
+ })
80
+
81
+ it('adds activity:update listener to app.events', () => {
82
+ const spy = sinon.spy(app, 'requestUpdate')
83
+ app.events.dispatchEvent(new CustomEvent('activity:update', { detail: {} }))
84
+ assert.isTrue(spy.calledOnce)
85
+ })
86
+
87
+ it('getter "updateComplete" delegates to renderer', () => {
88
+ const promise = Promise.resolve()
89
+ sinon.stub(app.renderer, 'updateComplete').get(() => promise)
90
+ assert.strictEqual(app.updateComplete, promise)
91
+ })
92
+
93
+ it('getter "firstRendered" delegates to renderer', () => {
94
+ sinon.stub(app.renderer, 'firstRendered').get(() => true)
95
+ assert.isTrue(app.firstRendered)
96
+ })
97
+ })
98
+
99
+ describe('setRenderRoot()', () => {
100
+ it('calls renderer.setRenderRoot', async () => {
101
+ const newRoot = (await fixture(html`<div></div>`)) as HTMLElement
102
+ const spy = sinon.spy(app.renderer, 'setRenderRoot')
103
+ app.setRenderRoot(newRoot)
104
+ assert.isTrue(spy.calledOnceWith(newRoot))
105
+ })
106
+ })
107
+
108
+ describe('Lifecycle Methods', () => {
109
+ it('onFirstRender dispatches app:first-render event', () => {
110
+ const eventSpy = sinon.spy()
111
+ app.events.addEventListener('app:first-render', eventSpy)
112
+ app.onFirstRender()
113
+ assert.isTrue(eventSpy.calledOnce, 'app:first-render event should be dispatched')
114
+ assert.isTrue(app.onFirstRenderSpy.calledOnce, 'onFirstRender should be called')
115
+ })
116
+
117
+ it('onRendered can be called', () => {
118
+ app.onRendered()
119
+ assert.isTrue(app.onRenderedSpy.calledOnce)
120
+ })
121
+ })
122
+
123
+ describe('render()', () => {
124
+ it('returns nothing if no current activity', () => {
125
+ assert.strictEqual(app.render(), nothing)
126
+ })
127
+
128
+ it('returns nothing if current activity is not started', async () => {
129
+ app.manager.registerActivity(TestActivity.action, TestActivity)
130
+ await app.manager.createActivity({ action: TestActivity.action })
131
+ // Activity is created but not started
132
+ assert.strictEqual(app.render(), nothing)
133
+ })
134
+
135
+ it('calls render on the current activity if it is started or resumed', async () => {
136
+ await app.run() // This calls onStart which registers TestActivity
137
+ await app.manager.startActivity({ action: TestActivity.action })
138
+ const activity = app.getCurrentActivity() as TestActivity
139
+ activity.state = ActivityState.Started // Ensure state
140
+
141
+ app.render()
142
+ assert.isTrue(activity.renderSpy.calledOnce)
143
+
144
+ activity.state = ActivityState.Resumed // Ensure state
145
+ activity.renderSpy.resetHistory()
146
+ app.render()
147
+ assert.isTrue(activity.renderSpy.calledOnce)
148
+ })
149
+ })
150
+
151
+ describe('requestUpdate()', () => {
152
+ it('calls renderer.requestUpdate by default', () => {
153
+ const spy = sinon.spy(app.renderer, 'requestUpdate')
154
+ app.requestUpdate()
155
+ assert.isTrue(spy.calledOnce)
156
+ })
157
+
158
+ it('does not call renderer.requestUpdate if app:false option is passed', () => {
159
+ const spy = sinon.spy(app.renderer, 'requestUpdate')
160
+ app.requestUpdate({ app: false })
161
+ assert.isFalse(spy.called)
162
+ })
163
+
164
+ it('is called when activity:update event is dispatched on app.events', () => {
165
+ const requestUpdateSpy = sinon.spy(app, 'requestUpdate')
166
+ const detail: UpdateRequest = { activity: false }
167
+ app.events.dispatchEvent(new CustomEvent('activity:update', { detail }))
168
+ assert.isTrue(requestUpdateSpy.calledOnceWith(detail))
169
+ })
170
+ })
171
+
172
+ describe('run()', () => {
173
+ it('calls onStart', async () => {
174
+ await app.run()
175
+ assert.isTrue(app.onStartSpy.calledOnce)
176
+ })
177
+
178
+ it('calls requestUpdate', async () => {
179
+ const spy = sinon.spy(app, 'requestUpdate')
180
+ await app.run()
181
+ assert.isTrue(spy.calledOnce)
182
+ })
183
+ })
184
+
185
+ describe('stop()', () => {
186
+ it('removes activity:update listener', async () => {
187
+ const requestUpdateSpy = sinon.spy(app, 'requestUpdate')
188
+ await app.stop()
189
+ app.events.dispatchEvent(new CustomEvent('activity:update')) // Should not call requestUpdate
190
+ assert.isFalse(requestUpdateSpy.called)
191
+ })
192
+
193
+ it('calls onStop', async () => {
194
+ await app.stop()
195
+ assert.isTrue(app.onStopSpy.calledOnce)
196
+ })
197
+ })
198
+
199
+ describe('Activity Accessors', () => {
200
+ it('getCurrentActivity delegates to ActivityManager', () => {
201
+ const activity = new TestActivity(app)
202
+ const stub = sinon.stub(app.manager, 'getCurrentActivity').returns(activity)
203
+ assert.strictEqual(app.getCurrentActivity(), activity)
204
+ assert.isTrue(stub.calledOnce)
205
+ })
206
+
207
+ it('getApplication returns this', () => {
208
+ assert.strictEqual(app.getApplication(), app)
209
+ })
210
+
211
+ it('findActiveActivity delegates to ActivityManager', () => {
212
+ const activity = new TestActivity(app)
213
+ const stub = sinon.stub(app.manager, 'findActiveActivity').returns(activity)
214
+ assert.strictEqual(app.findActiveActivity('test-id'), activity)
215
+ assert.isTrue(stub.calledOnceWith('test-id'))
216
+ })
217
+ })
218
+ })
@@ -0,0 +1,472 @@
1
+ import { assert } from '@esm-bundle/chai'
2
+ import sinon from 'sinon'
3
+ import { fixture, html } from '@open-wc/testing'
4
+ import { Fragment } from '../../src/core/Fragment.js'
5
+ import { Activity } from '../../src/core/Activity.js'
6
+ import { Application } from '../../src/core/Application.js'
7
+ import { FragmentState, FragmentManager } from '../../src/core/FragmentManager.js'
8
+ import { IntentResult, type Intent, ActivityState } from '../../src/core/ActivityManager.js'
9
+ import { FragmentRenderer } from '../../src/core/renderer/FragmentRenderer.js'
10
+ import { EventTypes } from '../../src/events/EventTypes.js'
11
+ import { nothing } from 'lit'
12
+ import type { ActivityDetail } from '../../src/events/IntentEvents.js'
13
+
14
+ class TestActivity extends Activity {
15
+ static override action = 'test-activity'
16
+ startActivitySpy = sinon.spy(super.startActivity)
17
+ startActivityForResultSpy = sinon.stub().resolves(123) // Returns a mock request code
18
+ requestUpdateSpy = sinon.spy(super.requestUpdate)
19
+
20
+ override async startActivity(intent: Intent): Promise<void> {
21
+ return this.startActivitySpy(intent)
22
+ }
23
+
24
+ override async startActivityForResult(intent: Intent): Promise<number> {
25
+ return this.startActivityForResultSpy(intent)
26
+ }
27
+
28
+ override requestUpdate(): void {
29
+ this.requestUpdateSpy()
30
+ }
31
+ }
32
+
33
+ class TestApplication extends Application {
34
+ override async onStart(): Promise<void> {
35
+ this.manager.registerActivity(TestActivity.action, TestActivity)
36
+ }
37
+
38
+ requestUpdateSpy = sinon.spy(super.requestUpdate)
39
+ override requestUpdate(): void {
40
+ this.requestUpdateSpy()
41
+ }
42
+ }
43
+
44
+ class TestFragment extends Fragment {
45
+ onCreateSpy = sinon.spy(super.onCreate)
46
+ onAttachSpy = sinon.spy(super.onAttach)
47
+ onStartSpy = sinon.spy(super.onStart)
48
+ onResumeSpy = sinon.spy(super.onResume)
49
+ onPauseSpy = sinon.spy(super.onPause)
50
+ onStopSpy = sinon.spy(super.onStop)
51
+ onDetachSpy = sinon.spy(super.onDetach)
52
+ onDestroySpy = sinon.spy(super.onDestroy)
53
+ onDataSpy = sinon.spy(super.onData)
54
+ onFirstRenderSpy = sinon.spy(super.onFirstRender)
55
+ renderSpy = sinon.spy(super.render)
56
+ onActivityResultSpy = sinon.spy(super.onActivityResult)
57
+
58
+ override onCreate(data?: unknown) {
59
+ return this.onCreateSpy(data)
60
+ }
61
+ override onAttach(data?: unknown) {
62
+ return this.onAttachSpy(data)
63
+ }
64
+ override onStart() {
65
+ return this.onStartSpy()
66
+ }
67
+ override onResume() {
68
+ return this.onResumeSpy()
69
+ }
70
+ override onPause() {
71
+ return this.onPauseSpy()
72
+ }
73
+ override onStop() {
74
+ return this.onStopSpy()
75
+ }
76
+ override onDetach() {
77
+ return this.onDetachSpy()
78
+ }
79
+ override onDestroy() {
80
+ return this.onDestroySpy()
81
+ }
82
+ override onData(data: unknown) {
83
+ return this.onDataSpy(data)
84
+ }
85
+ override onFirstRender() {
86
+ return this.onFirstRenderSpy()
87
+ }
88
+ override render() {
89
+ return this.renderSpy()
90
+ }
91
+ override async onActivityResult(requestCode: number, resultCode: IntentResult, intent: Intent) {
92
+ return this.onActivityResultSpy(requestCode, resultCode, intent)
93
+ }
94
+ }
95
+
96
+ async function basicFixture(): Promise<HTMLElement> {
97
+ return fixture(html`<div id="app-root"></div>`)
98
+ }
99
+
100
+ describe('Fragment', () => {
101
+ let app: TestApplication
102
+ let activity: TestActivity
103
+ let fragment: TestFragment
104
+
105
+ beforeEach(async () => {
106
+ const renderRoot = await basicFixture()
107
+ app = new TestApplication(renderRoot)
108
+ await app.run() // To register activity
109
+ activity = new TestActivity(app) // Parent for the fragment
110
+ activity.state = ActivityState.Resumed // Mock activity as active
111
+ fragment = new TestFragment({ parent: activity })
112
+ })
113
+
114
+ afterEach(() => {
115
+ sinon.restore()
116
+ })
117
+
118
+ describe('Constructor and Initial State', () => {
119
+ it('initializes with state Initialized', () => {
120
+ assert.equal(fragment.state, FragmentState.Initialized)
121
+ })
122
+
123
+ it('sets parent if provided', () => {
124
+ assert.strictEqual(fragment.parent, activity)
125
+ })
126
+
127
+ it('initializes FragmentManager', () => {
128
+ assert.instanceOf(fragment['fragmentManager'], FragmentManager)
129
+ })
130
+
131
+ it('initializes FragmentRenderer', () => {
132
+ assert.instanceOf(fragment.renderer, FragmentRenderer)
133
+ })
134
+
135
+ it('initializes requestCode to -1', () => {
136
+ assert.equal(fragment.requestCode, -1)
137
+ })
138
+
139
+ it('initializes pendingActivityResult as an empty Map', () => {
140
+ assert.instanceOf(fragment.pendingActivityResult, Map)
141
+ assert.equal(fragment.pendingActivityResult.size, 0)
142
+ })
143
+ })
144
+
145
+ describe('Lifecycle Methods and Events', () => {
146
+ const lifecycleMethods: (keyof TestFragment & keyof Fragment)[] = [
147
+ 'onCreate',
148
+ 'onAttach',
149
+ 'onStart',
150
+ 'onResume',
151
+ 'onPause',
152
+ 'onStop',
153
+ 'onDetach',
154
+ 'onDestroy',
155
+ ]
156
+ lifecycleMethods.forEach((methodName) => {
157
+ it(`calls ${methodName} and dispatches fragment:${methodName.substring(2).toLowerCase()} event`, async () => {
158
+ const eventSpy = sinon.spy()
159
+ const eventName = `fragment:${methodName.substring(2).toLowerCase()}`
160
+ fragment.addEventListener(eventName, eventSpy)
161
+
162
+ const data = { test: 'data' }
163
+ if (methodName === 'onCreate' || methodName === 'onAttach') {
164
+ await fragment[methodName](data)
165
+ assert.isTrue((fragment[`${methodName}Spy`] as sinon.SinonSpy).calledOnceWith(data))
166
+ assert.isTrue(eventSpy.calledOnce)
167
+ assert.deepEqual(eventSpy.firstCall.args[0].detail, data)
168
+ } else {
169
+ // @ts-expect-error Testing dynamic method calls
170
+ await fragment[methodName]()
171
+ // @ts-expect-error Testing dynamic method calls
172
+ assert.isTrue((fragment[`${methodName}Spy`] as sinon.SinonSpy).calledOnce)
173
+ assert.isTrue(eventSpy.calledOnce)
174
+ }
175
+ })
176
+ })
177
+
178
+ it('calls fragmentManager.onDestroy in onDestroy', async () => {
179
+ const managerDestroySpy = sinon.spy(fragment['fragmentManager'], 'onDestroy')
180
+ await fragment.onDestroy()
181
+ assert.isTrue(managerDestroySpy.calledOnce)
182
+ })
183
+
184
+ it('calls onData and dispatches fragment:data event', () => {
185
+ const eventSpy = sinon.spy()
186
+ fragment.addEventListener('fragment:data', eventSpy)
187
+ const data = { info: 'test' }
188
+ fragment.onData(data)
189
+ assert.isTrue(fragment.onDataSpy.calledOnceWith(data))
190
+ assert.isTrue(eventSpy.calledOnce)
191
+ assert.deepEqual(eventSpy.firstCall.args[0].detail, data)
192
+ })
193
+
194
+ it('onFirstRender can be called', () => {
195
+ fragment.onFirstRender()
196
+ assert.isTrue(fragment.onFirstRenderSpy.calledOnce)
197
+ })
198
+ })
199
+
200
+ describe('Rendering', () => {
201
+ it('render returns nothing by default', () => {
202
+ assert.strictEqual(fragment.render(), nothing)
203
+ assert.isTrue(fragment.renderSpy.calledOnce)
204
+ })
205
+
206
+ it('render calls render on single visible child fragment', () => {
207
+ const childFragment = new TestFragment()
208
+ const childRenderSpy = sinon.spy(childFragment, 'render')
209
+ sinon.stub(fragment, 'getSingleVisibleFragment').returns(childFragment)
210
+
211
+ fragment.render()
212
+ assert.isTrue(childRenderSpy.calledOnce)
213
+ })
214
+
215
+ it('getSingleVisibleFragment returns fragment if only one is visible', () => {
216
+ const child = new TestFragment()
217
+ sinon.stub(fragment['fragmentManager'], 'getVisible').returns([child])
218
+ assert.strictEqual(fragment.getSingleVisibleFragment(), child)
219
+ })
220
+
221
+ it('getSingleVisibleFragment returns null if no fragments are visible', () => {
222
+ sinon.stub(fragment['fragmentManager'], 'getVisible').returns([])
223
+ assert.isNull(fragment.getSingleVisibleFragment())
224
+ })
225
+
226
+ it('getSingleVisibleFragment returns null if multiple fragments are visible', () => {
227
+ sinon.stub(fragment['fragmentManager'], 'getVisible').returns([new TestFragment(), new TestFragment()])
228
+ assert.isNull(fragment.getSingleVisibleFragment())
229
+ })
230
+
231
+ it('isRenderingFragments returns true if children map is not empty', () => {
232
+ fragment['children'].set('child1', new TestFragment())
233
+ assert.isTrue(fragment.isRenderingFragments())
234
+ })
235
+
236
+ it('isRenderingFragments returns false if children map is empty', () => {
237
+ assert.isFalse(fragment.isRenderingFragments())
238
+ })
239
+
240
+ it('getVisibleFragments delegates to fragmentManager', () => {
241
+ const managerSpy = sinon.spy(fragment['fragmentManager'], 'getVisible')
242
+ fragment.getVisibleFragments()
243
+ assert.isTrue(managerSpy.calledOnce)
244
+ })
245
+ })
246
+
247
+ describe('Child Fragment Management', () => {
248
+ it('addChild adds to children map and calls fragmentManager.attachFragment', async () => {
249
+ const child = new TestFragment()
250
+ const managerSpy = sinon.spy(fragment['fragmentManager'], 'attachFragment')
251
+ const data = { key: 'value' }
252
+ await fragment.addChild('childKey', child, data)
253
+
254
+ assert.strictEqual(fragment['children'].get('childKey'), child)
255
+ assert.isTrue(managerSpy.calledOnceWith('childKey', child, fragment, data))
256
+ })
257
+
258
+ it('removeChild removes from children map and calls fragmentManager.detachFragment', async () => {
259
+ const child = new TestFragment()
260
+ await fragment.addChild('childKey', child)
261
+ const managerSpy = sinon.spy(fragment['fragmentManager'], 'detachFragment')
262
+
263
+ await fragment.removeChild('childKey')
264
+
265
+ assert.isFalse(fragment['children'].has('childKey'))
266
+ assert.isTrue(managerSpy.calledOnceWith('childKey'))
267
+ })
268
+
269
+ it('removeChild does nothing if child not found', async () => {
270
+ const managerSpy = sinon.spy(fragment['fragmentManager'], 'detachFragment')
271
+ await fragment.removeChild('nonExistentKey')
272
+ assert.isFalse(managerSpy.called)
273
+ })
274
+ })
275
+
276
+ describe('requestUpdate()', () => {
277
+ it('calls renderer.requestUpdate by default', () => {
278
+ const rendererSpy = sinon.spy(fragment.renderer, 'requestUpdate')
279
+ fragment.requestUpdate()
280
+ assert.isTrue(rendererSpy.calledOnce)
281
+ })
282
+
283
+ it('does not call renderer.requestUpdate if fragment:false option is passed', () => {
284
+ const rendererSpy = sinon.spy(fragment.renderer, 'requestUpdate')
285
+ fragment.requestUpdate({ fragment: false })
286
+ assert.isFalse(rendererSpy.called)
287
+ })
288
+
289
+ it('calls parent.requestUpdate', () => {
290
+ const parentRequestUpdateSpy = sinon.spy(fragment.parent!, 'requestUpdate')
291
+ const opts = { app: false }
292
+ fragment.requestUpdate(opts)
293
+ assert.isTrue(parentRequestUpdateSpy.calledOnceWith(opts))
294
+ })
295
+
296
+ it('does not throw if parent is undefined', () => {
297
+ fragment.parent = undefined
298
+ assert.doesNotThrow(() => fragment.requestUpdate())
299
+ })
300
+ })
301
+
302
+ describe('Hierarchy Accessors', () => {
303
+ it('getApplication delegates to parent', () => {
304
+ sinon.stub(activity, 'getApplication').returns(app)
305
+ assert.strictEqual(fragment.getApplication(), app)
306
+ })
307
+
308
+ it('getActivity delegates to parent', () => {
309
+ sinon.stub(activity, 'getActivity').returns(activity)
310
+ assert.strictEqual(fragment.getActivity(), activity)
311
+ })
312
+ })
313
+
314
+ describe('Activity Interaction', () => {
315
+ it('startActivity calls activity.startActivity', async () => {
316
+ const intent = { action: TestActivity.action }
317
+ await fragment.startActivity(intent)
318
+ assert.isTrue(activity.startActivitySpy.calledOnceWith(intent))
319
+ })
320
+
321
+ it('startActivity throws if no activity', async () => {
322
+ fragment.parent = undefined
323
+ try {
324
+ await fragment.startActivity({ action: 'test' })
325
+ assert.fail('Should have thrown')
326
+ } catch (e) {
327
+ assert.equal((e as Error).message, 'The fragment has no activity. Unable to start an intent.')
328
+ }
329
+ })
330
+
331
+ it('startActivityForResult calls activity.startActivityForResult and sets requestCode', async () => {
332
+ const intent = { action: 'test-action-for-result' }
333
+ await fragment.startActivityForResult(intent)
334
+ assert.isTrue(activity.startActivityForResultSpy.calledOnceWith(intent))
335
+ assert.equal(fragment.requestCode, 123) // Mocked return value
336
+ })
337
+
338
+ it('startActivityForResult throws if no activity', async () => {
339
+ fragment.parent = undefined
340
+ try {
341
+ await fragment.startActivityForResult({ action: 'test' })
342
+ assert.fail('Should have thrown')
343
+ } catch (e) {
344
+ assert.equal((e as Error).message, 'The fragment has no activity. Unable to start an intent.')
345
+ }
346
+ })
347
+ })
348
+
349
+ describe('onActivityResult()', () => {
350
+ it('calls onResult from pendingActivityResult and removes it', async () => {
351
+ const requestCode = 123
352
+ const onResultSpy = sinon.spy()
353
+ fragment.pendingActivityResult.set(requestCode, { onResult: onResultSpy })
354
+ const intent = { action: 'result-action' }
355
+ await fragment.onActivityResult(requestCode, IntentResult.RESULT_OK, intent)
356
+
357
+ assert.isTrue(onResultSpy.calledOnceWith(IntentResult.RESULT_OK, intent))
358
+ assert.isFalse(fragment.pendingActivityResult.has(requestCode))
359
+ })
360
+
361
+ it('forwards to child fragment if child has request code', async () => {
362
+ const childFragment = new TestFragment()
363
+ const childOnActivityResultSpy = sinon.spy(childFragment, 'onActivityResult')
364
+ sinon.stub(childFragment, 'hasRequestCode').returns(true)
365
+ fragment.addChild('childKey', childFragment)
366
+
367
+ const requestCode = 456
368
+ const intent = { action: 'child-result' }
369
+ await fragment.onActivityResult(requestCode, IntentResult.RESULT_CANCELED, intent)
370
+
371
+ assert.isTrue(childOnActivityResultSpy.calledOnceWith(requestCode, IntentResult.RESULT_CANCELED, intent))
372
+ })
373
+
374
+ it('resets requestCode and logs if not handled and is base Fragment', async () => {
375
+ const consoleSpy = sinon.spy(console, 'info')
376
+ fragment.requestCode = 789
377
+ // Ensure the fragment instance is exactly Fragment, not a subclass that might override onActivityResult
378
+ Object.setPrototypeOf(fragment, Fragment.prototype)
379
+
380
+ await fragment.onActivityResult(789, IntentResult.RESULT_OK, { action: 'test-intent' })
381
+
382
+ assert.equal(fragment.requestCode, -1)
383
+ assert.isTrue(
384
+ consoleSpy.calledWith('Fragment#onActivityResult() not implemented', 789, IntentResult.RESULT_OK, {
385
+ action: 'test-intent',
386
+ })
387
+ )
388
+ consoleSpy.restore()
389
+ })
390
+ })
391
+
392
+ describe('hasRequestCode()', () => {
393
+ it('returns true if own requestCode matches', () => {
394
+ fragment.requestCode = 123
395
+ assert.isTrue(fragment.hasRequestCode(123))
396
+ })
397
+
398
+ it('returns true if a child fragment has the request code', () => {
399
+ const childFragment = new TestFragment()
400
+ sinon.stub(childFragment, 'hasRequestCode').returns(true)
401
+ fragment.addChild('childKey', childFragment)
402
+ assert.isTrue(fragment.hasRequestCode(456))
403
+ })
404
+
405
+ it('returns false if neither self nor children have the request code', () => {
406
+ fragment.requestCode = 123
407
+ const childFragment = new TestFragment()
408
+ sinon.stub(childFragment, 'hasRequestCode').returns(false)
409
+ fragment.addChild('childKey', childFragment)
410
+ assert.isFalse(fragment.hasRequestCode(789))
411
+ })
412
+ })
413
+
414
+ describe('handleIntentEvent()', () => {
415
+ it('handles startActivityForResult event, calls activity, sets requestCode and pending result', async () => {
416
+ const onResultSpy = sinon.spy()
417
+ const detail = { intent: { action: TestActivity.action }, onResult: onResultSpy }
418
+ const event = new CustomEvent(EventTypes.Intent.startActivityForResult, { detail })
419
+
420
+ await fragment.handleIntentEvent(event)
421
+
422
+ assert.isTrue(activity.startActivityForResultSpy.calledOnceWith(detail.intent))
423
+ assert.equal(fragment.requestCode, 123) // Mocked return
424
+ assert.isTrue(fragment.pendingActivityResult.has(123))
425
+ assert.strictEqual(fragment.pendingActivityResult.get(123)?.onResult, onResultSpy)
426
+ })
427
+
428
+ it('handles startActivity event, calls activity', async () => {
429
+ const detail = { intent: { action: TestActivity.action } }
430
+ const event = new CustomEvent(EventTypes.Intent.startActivity, { detail })
431
+
432
+ await fragment.handleIntentEvent(event)
433
+ assert.isTrue(activity.startActivitySpy.calledOnceWith(detail.intent))
434
+ })
435
+
436
+ it('throws error if no activity for startActivityForResult', async () => {
437
+ fragment.parent = undefined
438
+ const event = new CustomEvent(EventTypes.Intent.startActivityForResult, {
439
+ detail: {} as unknown as ActivityDetail,
440
+ })
441
+ try {
442
+ await fragment.handleIntentEvent(event)
443
+ assert.fail('Should have thrown')
444
+ } catch (e) {
445
+ assert.equal((e as Error).message, 'The fragment has no activity. Unable to start an intent.')
446
+ }
447
+ })
448
+
449
+ it('throws error for unrecognized event type', async () => {
450
+ const event = new CustomEvent('unknown-event', { detail: {} as unknown as ActivityDetail })
451
+ try {
452
+ await fragment.handleIntentEvent(event)
453
+ assert.fail('Should have thrown')
454
+ } catch (e) {
455
+ assert.equal((e as Error).message, `Unrecognized intent event: unknown-event`)
456
+ }
457
+ })
458
+ })
459
+
460
+ describe('Misc', () => {
461
+ it('rootClass returns undefined by default', () => {
462
+ assert.isUndefined(fragment.rootClass())
463
+ })
464
+
465
+ it('setRenderRoot calls renderer.setRenderRoot', async () => {
466
+ const newRoot = (await fixture(html`<div></div>`)) as HTMLElement
467
+ const spy = sinon.spy(fragment.renderer, 'setRenderRoot')
468
+ fragment.setRenderRoot(newRoot)
469
+ assert.isTrue(spy.calledOnceWith(newRoot))
470
+ })
471
+ })
472
+ })