@splendidlabz/svelte 4.8.4 → 4.9.0

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.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,26 @@
1
1
  # @splendidlabz/svelte
2
2
 
3
+ ## 4.9.0
4
+
5
+ ### Minor Changes
6
+
7
+ - c1a3797: Replace JS breakpoint-driven tab placement with CSS-driven placement. Placement classes (tablist-top, tablist-left, tablist-right) now set a --placement CSS custom property that JS reads for keyboard navigation. Removes breakpointObserver from Tablist.
8
+
9
+ ### Patch Changes
10
+
11
+ - Updated dependencies [c1a3797]
12
+ - @splendidlabz/styles@4.7.0
13
+
14
+ ## 4.8.5
15
+
16
+ ### Patch Changes
17
+
18
+ - 7b9b628: Added early return in reloadScripts when no script elements found
19
+ - Updated dependencies [7b9b628]
20
+ - Updated dependencies [7b9b628]
21
+ - @splendidlabz/styles@4.6.8
22
+ - @splendidlabz/utils@1.11.3
23
+
3
24
  ## 4.8.4
4
25
 
5
26
  ### Patch Changes
@@ -1,3 +1,4 @@
1
+ // @vitest-environment node
1
2
  import { beforeAll, describe, expect, test } from 'vitest'
2
3
  import { loadSvelteComponent, renderComponent } from '../../test-utils.js'
3
4
 
@@ -1,15 +1,11 @@
1
1
  <script>
2
2
  import { preferHorizontalScroll as preferHorizontalScrollAction } from '@splendidlabz/utils/dom'
3
- import { breakpointObserver } from '../../actions/breakpoint-observer.js'
4
3
  import { init } from '../../utils'
5
- import { getTab, tablist, updatePlacement } from './tabs.svelte.js'
4
+ import { getTab, tablist } from './tabs.svelte.js'
6
5
 
7
6
  let {
8
7
  class: klass = '',
9
8
  target = null,
10
- breakpoints,
11
- breakpointType,
12
- placement: initialPlacement,
13
9
  scrollable = true,
14
10
  preferHorizontalScroll = true,
15
11
  preserveOutlines = true,
@@ -20,7 +16,6 @@
20
16
  ...rest
21
17
  } = $props()
22
18
 
23
- let placement = $state(_ => initialPlacement || 'top')
24
19
  let tab = $derived(getTab(target))
25
20
  let tablistClasses = $derived(getTablistClasses(tab))
26
21
 
@@ -32,13 +27,6 @@
32
27
  if (!tab) return ''
33
28
  const { placement } = tab.state
34
29
 
35
- const tablistClass = {
36
- top: 'tablist-top',
37
- left: 'tablist-left',
38
- right: 'tablist-right',
39
- }[placement]
40
-
41
- // Gah these need to change according to the placement
42
30
  const scrollableClass = [
43
31
  placement === 'top' && scrollable && 'scrollable-horizontal',
44
32
  placement === 'top' &&
@@ -47,12 +35,7 @@
47
35
  placement === 'top' && preserveOutlines && 'preserve-outlines',
48
36
  ].join(' ')
49
37
 
50
- return `${tablistClass} ${scrollableClass}`
51
- }
52
-
53
- function breakpointCB({ value }) {
54
- placement = value.placement
55
- updatePlacement(tab, value.placement)
38
+ return scrollableClass
56
39
  }
57
40
  </script>
58
41
 
@@ -61,17 +44,11 @@
61
44
  class="tablist {tablistClasses} {klass}"
62
45
  role="tablist"
63
46
  {target}
64
- use:breakpointObserver={{
65
- breakpoints,
66
- breakpointType,
67
- callback: breakpointCB,
68
- }}
69
47
  use:preferHorizontalScrollAction
70
48
  use:tablist={{
71
- state: { placement },
49
+ state: {},
72
50
  options: rest,
73
51
  }}
74
52
  >
75
- <!-- Need to add callback to breakpoint opts -->
76
53
  {@render children?.()}
77
54
  </div>
@@ -0,0 +1,67 @@
1
+ <!--
2
+ Example: Responsive tabs — horizontal on mobile, vertical (left) on desktop.
3
+ Copy-paste this as a starting point. Adjust classes and breakpoints as needed.
4
+
5
+ Usage in Astro:
6
+ <TabsExample client:load />
7
+
8
+ The key concept: placement classes (tablist-top, tablist-left, tablist-right)
9
+ control both the CSS layout AND keyboard navigation automatically.
10
+ Use responsive prefixes to change placement at breakpoints.
11
+ -->
12
+ <script>
13
+ import Tab from './Tab.svelte'
14
+ import Tablist from './Tablist.svelte'
15
+ import Tabpanel from './Tabpanel.svelte'
16
+ import Tabpanels from './Tabpanels.svelte'
17
+ </script>
18
+
19
+ <div class="tabs-example" style="display: grid; gap: 1rem;">
20
+ <!--
21
+ Mobile: tablist-top (horizontal tabs)
22
+ Desktop (≥1000px): tablist-left (vertical tabs on the left)
23
+
24
+ Replace "max-bp10:" and "bp10:" with your own responsive prefixes,
25
+ or use standard Tailwind breakpoints like "max-md:" and "md:".
26
+
27
+ If you don't use responsive utility prefixes, use media queries in your CSS:
28
+ @media (max-width: 999px) { .my-tablist { --placement: top; } }
29
+ @media (min-width: 1000px) { .my-tablist { --placement: left; } }
30
+ -->
31
+ <Tablist
32
+ class="tablist-top"
33
+ target="example-panels"
34
+ >
35
+ <Tab active>First Tab</Tab>
36
+ <Tab>Second Tab</Tab>
37
+ <Tab>Third Tab</Tab>
38
+ </Tablist>
39
+
40
+ <Tabpanels id="example-panels">
41
+ <Tabpanel active>
42
+ <p>Content for the first tab.</p>
43
+ </Tabpanel>
44
+ <Tabpanel>
45
+ <p>Content for the second tab.</p>
46
+ </Tabpanel>
47
+ <Tabpanel>
48
+ <p>Content for the third tab.</p>
49
+ </Tabpanel>
50
+ </Tabpanels>
51
+ </div>
52
+
53
+ <style>
54
+ /*
55
+ For responsive placement, add media queries that change the placement class.
56
+ The CSS placement classes (tablist-top, tablist-left, tablist-right) each set
57
+ a --placement CSS custom property that JS reads for keyboard navigation.
58
+
59
+ Example with custom breakpoint:
60
+ @media (min-width: 1000px) {
61
+ :global(.tablist) {
62
+ This would need tablist-left class applied at this breakpoint.
63
+ If using Tailwind/utility CSS, apply via responsive prefix in the class attribute.
64
+ }
65
+ }
66
+ */
67
+ </style>
@@ -0,0 +1,44 @@
1
+ import { readFile } from 'node:fs/promises'
2
+ import { beforeAll, describe, expect, test } from 'vitest'
3
+ import { fileURLToPath } from 'node:url'
4
+ import path from 'node:path'
5
+
6
+ // Resolve the CSS file relative to this test
7
+ const cssPath = path.resolve(
8
+ fileURLToPath(import.meta.url),
9
+ '../../../../styles/src/components/svelte/tabs.css'
10
+ )
11
+
12
+ describe('tabs.css --placement custom property', () => {
13
+ let css
14
+
15
+ beforeAll(async () => {
16
+ css = await readFile(cssPath, 'utf8')
17
+ })
18
+
19
+ test('tablist-top sets --placement: top', () => {
20
+ // Match the @utility tablist-top block (may contain nested braces)
21
+ const match = css.match(/@utility tablist-top\s*\{[\s\S]*?\n\}/)
22
+ expect(match).toBeTruthy()
23
+ expect(match[0]).toContain('--placement: top')
24
+ })
25
+
26
+ test('.tablist-left sets --placement: left', () => {
27
+ // Should appear somewhere in the file — could be @layer or @utility
28
+ const leftBlock = css.match(/\.tablist-left\s*\{[^}]*\}/)
29
+ expect(leftBlock).toBeTruthy()
30
+ expect(leftBlock[0]).toContain('--placement: left')
31
+ })
32
+
33
+ test('.tablist-right sets --placement: right', () => {
34
+ const rightBlock = css.match(/\.tablist-right\s*\{[^}]*\}/)
35
+ expect(rightBlock).toBeTruthy()
36
+ expect(rightBlock[0]).toContain('--placement: right')
37
+ })
38
+
39
+ test('all three placements are covered', () => {
40
+ expect(css).toContain('--placement: top')
41
+ expect(css).toContain('--placement: left')
42
+ expect(css).toContain('--placement: right')
43
+ })
44
+ })
@@ -0,0 +1,553 @@
1
+ import { afterEach, describe, expect, test } from 'vitest'
2
+ import {
3
+ getTab,
4
+ tablist,
5
+ tabpanels,
6
+ selectTab,
7
+ selectNextTab,
8
+ selectPrevTab,
9
+ } from './tabs.svelte.js'
10
+
11
+ // ============================================
12
+ // Test Helpers
13
+ // ============================================
14
+
15
+ let testCounter = 0
16
+ const cleanupNodes = []
17
+
18
+ function uniqueId() {
19
+ return `test-panels-${++testCounter}`
20
+ }
21
+
22
+ function createTabsDOM({ placement = 'top', tabCount = 3, id } = {}) {
23
+ const panelId = id || uniqueId()
24
+
25
+ // Create tablist
26
+ const tablistNode = document.createElement('div')
27
+ tablistNode.classList.add('tablist')
28
+ tablistNode.setAttribute('role', 'tablist')
29
+ tablistNode.setAttribute('target', panelId)
30
+ if (placement) {
31
+ tablistNode.style.setProperty('--placement', placement)
32
+ }
33
+
34
+ for (let i = 0; i < tabCount; i++) {
35
+ const tab = document.createElement('button')
36
+ tab.setAttribute('role', 'tab')
37
+ tab.classList.add('tab')
38
+ tab.textContent = `Tab ${i}`
39
+ tab.setAttribute('tabindex', i === 0 ? '0' : '-1')
40
+ if (i === 0) tab.setAttribute('aria-selected', 'true')
41
+ tablistNode.appendChild(tab)
42
+ }
43
+
44
+ document.body.appendChild(tablistNode)
45
+
46
+ // Create tabpanels
47
+ const panelsNode = document.createElement('div')
48
+ panelsNode.id = panelId
49
+ panelsNode.classList.add('tabpanels')
50
+
51
+ for (let i = 0; i < tabCount; i++) {
52
+ const panel = document.createElement('div')
53
+ panel.setAttribute('role', 'tabpanel')
54
+ panel.classList.add('tabpanel')
55
+ panel.setAttribute('tabindex', '0')
56
+ panel.textContent = `Panel content ${i}`
57
+ if (i !== 0) panel.setAttribute('hidden', 'true')
58
+ panelsNode.appendChild(panel)
59
+ }
60
+
61
+ document.body.appendChild(panelsNode)
62
+ cleanupNodes.push(tablistNode, panelsNode)
63
+
64
+ return { tablistNode, panelsNode, panelId }
65
+ }
66
+
67
+ function initActions({ tablistNode, panelsNode }) {
68
+ const tablistAction = tablist(tablistNode, { state: {}, options: {} })
69
+ const panelsAction = tabpanels(panelsNode, {})
70
+ return { tablistAction, panelsAction }
71
+ }
72
+
73
+ function pressKey(node, key) {
74
+ node.dispatchEvent(new KeyboardEvent('keydown', { key, bubbles: true }))
75
+ }
76
+
77
+ function clickTab(tab) {
78
+ tab.dispatchEvent(new MouseEvent('click', { bubbles: true }))
79
+ }
80
+
81
+ function getTabElements(tablistNode) {
82
+ return Array.from(tablistNode.querySelectorAll('[role="tab"]'))
83
+ }
84
+
85
+ function getPanelElements(panelsNode) {
86
+ return Array.from(panelsNode.querySelectorAll('[role="tabpanel"]'))
87
+ }
88
+
89
+ afterEach(() => {
90
+ cleanupNodes.forEach(n => n.parentNode?.removeChild(n))
91
+ cleanupNodes.length = 0
92
+ })
93
+
94
+ // ============================================
95
+ // readPlacement
96
+ // ============================================
97
+
98
+ describe('readPlacement', () => {
99
+ test('reads --placement: top from CSS', async () => {
100
+ const { readPlacement } = await import('./tabs.svelte.js')
101
+ const node = document.createElement('div')
102
+ node.style.setProperty('--placement', 'top')
103
+ document.body.appendChild(node)
104
+ cleanupNodes.push(node)
105
+
106
+ expect(readPlacement(node)).toBe('top')
107
+ })
108
+
109
+ test('reads --placement: left from CSS', async () => {
110
+ const { readPlacement } = await import('./tabs.svelte.js')
111
+ const node = document.createElement('div')
112
+ node.style.setProperty('--placement', 'left')
113
+ document.body.appendChild(node)
114
+ cleanupNodes.push(node)
115
+
116
+ expect(readPlacement(node)).toBe('left')
117
+ })
118
+
119
+ test('reads --placement: right from CSS', async () => {
120
+ const { readPlacement } = await import('./tabs.svelte.js')
121
+ const node = document.createElement('div')
122
+ node.style.setProperty('--placement', 'right')
123
+ document.body.appendChild(node)
124
+ cleanupNodes.push(node)
125
+
126
+ expect(readPlacement(node)).toBe('right')
127
+ })
128
+
129
+ test('defaults to "top" when --placement is not set', async () => {
130
+ const { readPlacement } = await import('./tabs.svelte.js')
131
+ const node = document.createElement('div')
132
+ document.body.appendChild(node)
133
+ cleanupNodes.push(node)
134
+
135
+ expect(readPlacement(node)).toBe('top')
136
+ })
137
+ })
138
+
139
+ // ============================================
140
+ // Tab Selection (click)
141
+ // ============================================
142
+
143
+ describe('tab selection via click', () => {
144
+ test('clicking a tab selects it', () => {
145
+ const { tablistNode, panelsNode, panelId } = createTabsDOM()
146
+ const { tablistAction, panelsAction } = initActions({ tablistNode, panelsNode })
147
+
148
+ const tabs = getTabElements(tablistNode)
149
+ const panels = getPanelElements(panelsNode)
150
+
151
+ clickTab(tabs[1])
152
+
153
+ expect(tabs[1].getAttribute('aria-selected')).toBe('true')
154
+ expect(tabs[0].hasAttribute('aria-selected')).toBe(false)
155
+ expect(panels[1].hasAttribute('hidden')).toBe(false)
156
+ expect(panels[0].getAttribute('hidden')).toBe('true')
157
+
158
+ tablistAction.destroy()
159
+ panelsAction.destroy()
160
+ })
161
+
162
+ test('clicking a tab updates tabindex roving', () => {
163
+ const { tablistNode, panelsNode } = createTabsDOM()
164
+ const { tablistAction, panelsAction } = initActions({ tablistNode, panelsNode })
165
+
166
+ const tabs = getTabElements(tablistNode)
167
+
168
+ clickTab(tabs[2])
169
+
170
+ expect(tabs[2].getAttribute('tabindex')).toBe('0')
171
+ expect(tabs[0].getAttribute('tabindex')).toBe('-1')
172
+ expect(tabs[1].getAttribute('tabindex')).toBe('-1')
173
+
174
+ tablistAction.destroy()
175
+ panelsAction.destroy()
176
+ })
177
+
178
+ test('clicking the already-active tab does not break state', () => {
179
+ const { tablistNode, panelsNode } = createTabsDOM()
180
+ const { tablistAction, panelsAction } = initActions({ tablistNode, panelsNode })
181
+
182
+ const tabs = getTabElements(tablistNode)
183
+
184
+ clickTab(tabs[0])
185
+
186
+ expect(tabs[0].getAttribute('aria-selected')).toBe('true')
187
+
188
+ tablistAction.destroy()
189
+ panelsAction.destroy()
190
+ })
191
+ })
192
+
193
+ // ============================================
194
+ // Accessibility: ARIA attributes
195
+ // ============================================
196
+
197
+ describe('accessibility: ARIA attributes', () => {
198
+ test('only one tab has aria-selected at any time', () => {
199
+ const { tablistNode, panelsNode } = createTabsDOM()
200
+ const { tablistAction, panelsAction } = initActions({ tablistNode, panelsNode })
201
+
202
+ const tabs = getTabElements(tablistNode)
203
+
204
+ // Click through each tab
205
+ for (let i = 0; i < tabs.length; i++) {
206
+ clickTab(tabs[i])
207
+ const selected = tabs.filter(t => t.getAttribute('aria-selected') === 'true')
208
+ expect(selected.length).toBe(1)
209
+ expect(selected[0]).toBe(tabs[i])
210
+ }
211
+
212
+ tablistAction.destroy()
213
+ panelsAction.destroy()
214
+ })
215
+
216
+ test('only one panel is visible at any time', () => {
217
+ const { tablistNode, panelsNode } = createTabsDOM()
218
+ const { tablistAction, panelsAction } = initActions({ tablistNode, panelsNode })
219
+
220
+ const tabs = getTabElements(tablistNode)
221
+ const panels = getPanelElements(panelsNode)
222
+
223
+ for (let i = 0; i < tabs.length; i++) {
224
+ clickTab(tabs[i])
225
+ const visible = panels.filter(p => !p.hasAttribute('hidden'))
226
+ expect(visible.length).toBe(1)
227
+ expect(visible[0]).toBe(panels[i])
228
+ }
229
+
230
+ tablistAction.destroy()
231
+ panelsAction.destroy()
232
+ })
233
+
234
+ test('inactive tabs have tabindex="-1", active tab has tabindex="0"', () => {
235
+ const { tablistNode, panelsNode } = createTabsDOM()
236
+ const { tablistAction, panelsAction } = initActions({ tablistNode, panelsNode })
237
+
238
+ const tabs = getTabElements(tablistNode)
239
+
240
+ clickTab(tabs[1])
241
+
242
+ expect(tabs[1].getAttribute('tabindex')).toBe('0')
243
+ tabs.filter((_, i) => i !== 1).forEach(t => {
244
+ expect(t.getAttribute('tabindex')).toBe('-1')
245
+ })
246
+
247
+ tablistAction.destroy()
248
+ panelsAction.destroy()
249
+ })
250
+ })
251
+
252
+ // ============================================
253
+ // Keyboard Navigation: Horizontal (top)
254
+ // ============================================
255
+
256
+ describe('keyboard navigation: horizontal (placement=top)', () => {
257
+ test('ArrowRight selects next tab', () => {
258
+ const { tablistNode, panelsNode } = createTabsDOM({ placement: 'top' })
259
+ const { tablistAction, panelsAction } = initActions({ tablistNode, panelsNode })
260
+
261
+ const tabs = getTabElements(tablistNode)
262
+ tabs[0].focus()
263
+ pressKey(tablistNode, 'ArrowRight')
264
+
265
+ expect(tabs[1].getAttribute('aria-selected')).toBe('true')
266
+ expect(tabs[0].hasAttribute('aria-selected')).toBe(false)
267
+
268
+ tablistAction.destroy()
269
+ panelsAction.destroy()
270
+ })
271
+
272
+ test('ArrowLeft selects previous tab', () => {
273
+ const { tablistNode, panelsNode } = createTabsDOM({ placement: 'top' })
274
+ const { tablistAction, panelsAction } = initActions({ tablistNode, panelsNode })
275
+
276
+ const tabs = getTabElements(tablistNode)
277
+
278
+ // First select tab 1
279
+ clickTab(tabs[1])
280
+ pressKey(tablistNode, 'ArrowLeft')
281
+
282
+ expect(tabs[0].getAttribute('aria-selected')).toBe('true')
283
+
284
+ tablistAction.destroy()
285
+ panelsAction.destroy()
286
+ })
287
+
288
+ test('ArrowRight at last tab does nothing (no loop by default)', () => {
289
+ const { tablistNode, panelsNode } = createTabsDOM({ placement: 'top' })
290
+ const { tablistAction, panelsAction } = initActions({ tablistNode, panelsNode })
291
+
292
+ const tabs = getTabElements(tablistNode)
293
+
294
+ clickTab(tabs[2]) // last tab
295
+ pressKey(tablistNode, 'ArrowRight')
296
+
297
+ expect(tabs[2].getAttribute('aria-selected')).toBe('true')
298
+
299
+ tablistAction.destroy()
300
+ panelsAction.destroy()
301
+ })
302
+
303
+ test('ArrowLeft at first tab does nothing (no loop by default)', () => {
304
+ const { tablistNode, panelsNode } = createTabsDOM({ placement: 'top' })
305
+ const { tablistAction, panelsAction } = initActions({ tablistNode, panelsNode })
306
+
307
+ const tabs = getTabElements(tablistNode)
308
+ tabs[0].focus()
309
+ pressKey(tablistNode, 'ArrowLeft')
310
+
311
+ expect(tabs[0].getAttribute('aria-selected')).toBe('true')
312
+
313
+ tablistAction.destroy()
314
+ panelsAction.destroy()
315
+ })
316
+
317
+ test('ArrowUp/ArrowDown do NOT navigate tabs when placement is top', () => {
318
+ const { tablistNode, panelsNode } = createTabsDOM({ placement: 'top' })
319
+ const { tablistAction, panelsAction } = initActions({ tablistNode, panelsNode })
320
+
321
+ const tabs = getTabElements(tablistNode)
322
+ tabs[0].focus()
323
+
324
+ pressKey(tablistNode, 'ArrowUp')
325
+ expect(tabs[0].getAttribute('aria-selected')).toBe('true')
326
+
327
+ // ArrowDown focuses tabpanel, not next tab
328
+ // We verify tab selection doesn't change
329
+ pressKey(tablistNode, 'ArrowDown')
330
+ expect(tabs[0].getAttribute('aria-selected')).toBe('true')
331
+
332
+ tablistAction.destroy()
333
+ panelsAction.destroy()
334
+ })
335
+ })
336
+
337
+ // ============================================
338
+ // Keyboard Navigation: Vertical (left)
339
+ // ============================================
340
+
341
+ describe('keyboard navigation: vertical (placement=left)', () => {
342
+ test('ArrowDown selects next tab', () => {
343
+ const { tablistNode, panelsNode } = createTabsDOM({ placement: 'left' })
344
+ const { tablistAction, panelsAction } = initActions({ tablistNode, panelsNode })
345
+
346
+ const tabs = getTabElements(tablistNode)
347
+ tabs[0].focus()
348
+ pressKey(tablistNode, 'ArrowDown')
349
+
350
+ expect(tabs[1].getAttribute('aria-selected')).toBe('true')
351
+ expect(tabs[0].hasAttribute('aria-selected')).toBe(false)
352
+
353
+ tablistAction.destroy()
354
+ panelsAction.destroy()
355
+ })
356
+
357
+ test('ArrowUp selects previous tab', () => {
358
+ const { tablistNode, panelsNode } = createTabsDOM({ placement: 'left' })
359
+ const { tablistAction, panelsAction } = initActions({ tablistNode, panelsNode })
360
+
361
+ const tabs = getTabElements(tablistNode)
362
+
363
+ clickTab(tabs[1])
364
+ pressKey(tablistNode, 'ArrowUp')
365
+
366
+ expect(tabs[0].getAttribute('aria-selected')).toBe('true')
367
+
368
+ tablistAction.destroy()
369
+ panelsAction.destroy()
370
+ })
371
+
372
+ test('ArrowLeft/ArrowRight do NOT navigate tabs when placement is left', () => {
373
+ const { tablistNode, panelsNode } = createTabsDOM({ placement: 'left' })
374
+ const { tablistAction, panelsAction } = initActions({ tablistNode, panelsNode })
375
+
376
+ const tabs = getTabElements(tablistNode)
377
+ tabs[0].focus()
378
+
379
+ pressKey(tablistNode, 'ArrowLeft')
380
+ expect(tabs[0].getAttribute('aria-selected')).toBe('true')
381
+
382
+ // ArrowRight focuses tabpanel, not next tab
383
+ pressKey(tablistNode, 'ArrowRight')
384
+ expect(tabs[0].getAttribute('aria-selected')).toBe('true')
385
+
386
+ tablistAction.destroy()
387
+ panelsAction.destroy()
388
+ })
389
+ })
390
+
391
+ // ============================================
392
+ // Keyboard Navigation: Vertical (right)
393
+ // ============================================
394
+
395
+ describe('keyboard navigation: vertical (placement=right)', () => {
396
+ test('ArrowDown selects next tab', () => {
397
+ const { tablistNode, panelsNode } = createTabsDOM({ placement: 'right' })
398
+ const { tablistAction, panelsAction } = initActions({ tablistNode, panelsNode })
399
+
400
+ const tabs = getTabElements(tablistNode)
401
+ tabs[0].focus()
402
+ pressKey(tablistNode, 'ArrowDown')
403
+
404
+ expect(tabs[1].getAttribute('aria-selected')).toBe('true')
405
+
406
+ tablistAction.destroy()
407
+ panelsAction.destroy()
408
+ })
409
+
410
+ test('ArrowUp selects previous tab', () => {
411
+ const { tablistNode, panelsNode } = createTabsDOM({ placement: 'right' })
412
+ const { tablistAction, panelsAction } = initActions({ tablistNode, panelsNode })
413
+
414
+ const tabs = getTabElements(tablistNode)
415
+
416
+ clickTab(tabs[2])
417
+ pressKey(tablistNode, 'ArrowUp')
418
+
419
+ expect(tabs[1].getAttribute('aria-selected')).toBe('true')
420
+
421
+ tablistAction.destroy()
422
+ panelsAction.destroy()
423
+ })
424
+
425
+ test('ArrowLeft focuses tabpanel (does not navigate tabs)', () => {
426
+ const { tablistNode, panelsNode } = createTabsDOM({ placement: 'right' })
427
+ const { tablistAction, panelsAction } = initActions({ tablistNode, panelsNode })
428
+
429
+ const tabs = getTabElements(tablistNode)
430
+ tabs[0].focus()
431
+
432
+ pressKey(tablistNode, 'ArrowLeft')
433
+ // Tab 0 should still be selected (ArrowLeft goes to panel, doesn't change tab)
434
+ expect(tabs[0].getAttribute('aria-selected')).toBe('true')
435
+
436
+ tablistAction.destroy()
437
+ panelsAction.destroy()
438
+ })
439
+ })
440
+
441
+ // ============================================
442
+ // Placement from CSS (the core new behavior)
443
+ // ============================================
444
+
445
+ describe('tablist reads placement from CSS', () => {
446
+ test('reads --placement: left from CSS on mount', () => {
447
+ const { tablistNode, panelsNode, panelId } = createTabsDOM({ placement: 'left' })
448
+ const { tablistAction, panelsAction } = initActions({ tablistNode, panelsNode })
449
+
450
+ const tab = getTab(panelId)
451
+ expect(tab.state.placement).toBe('left')
452
+
453
+ tablistAction.destroy()
454
+ panelsAction.destroy()
455
+ })
456
+
457
+ test('reads --placement: right from CSS on mount', () => {
458
+ const { tablistNode, panelsNode, panelId } = createTabsDOM({ placement: 'right' })
459
+ const { tablistAction, panelsAction } = initActions({ tablistNode, panelsNode })
460
+
461
+ const tab = getTab(panelId)
462
+ expect(tab.state.placement).toBe('right')
463
+
464
+ tablistAction.destroy()
465
+ panelsAction.destroy()
466
+ })
467
+
468
+ test('defaults to "top" when --placement is not set', () => {
469
+ const { tablistNode, panelsNode, panelId } = createTabsDOM({})
470
+ tablistNode.style.removeProperty('--placement')
471
+ const { tablistAction, panelsAction } = initActions({ tablistNode, panelsNode })
472
+
473
+ const tab = getTab(panelId)
474
+ expect(tab.state.placement).toBe('top')
475
+
476
+ tablistAction.destroy()
477
+ panelsAction.destroy()
478
+ })
479
+ })
480
+
481
+ // ============================================
482
+ // CLS prevention: no JS-added placement classes
483
+ // ============================================
484
+
485
+ describe('CLS prevention', () => {
486
+ test('tablist action does NOT add tablist-top/left/right classes to the DOM', () => {
487
+ const { tablistNode, panelsNode } = createTabsDOM({ placement: 'left' })
488
+ const { tablistAction, panelsAction } = initActions({ tablistNode, panelsNode })
489
+
490
+ // The action should not add placement classes — CSS handles that
491
+ // The node should only have what was set during DOM creation
492
+ expect(tablistNode.classList.contains('tablist-left')).toBe(false)
493
+ expect(tablistNode.classList.contains('tablist-top')).toBe(false)
494
+ expect(tablistNode.classList.contains('tablist-right')).toBe(false)
495
+
496
+ tablistAction.destroy()
497
+ panelsAction.destroy()
498
+ })
499
+ })
500
+
501
+ // ============================================
502
+ // selectTab, selectNextTab, selectPrevTab
503
+ // ============================================
504
+
505
+ describe('selectTab API', () => {
506
+ test('selectTab changes active tab and panel', () => {
507
+ const { tablistNode, panelsNode, panelId } = createTabsDOM()
508
+ const { tablistAction, panelsAction } = initActions({ tablistNode, panelsNode })
509
+
510
+ const tab = getTab(panelId)
511
+ const tabs = getTabElements(tablistNode)
512
+ const panels = getPanelElements(panelsNode)
513
+
514
+ selectTab(tab, 2, { shouldFocusOnTab: false })
515
+
516
+ expect(tabs[2].getAttribute('aria-selected')).toBe('true')
517
+ expect(panels[2].hasAttribute('hidden')).toBe(false)
518
+ expect(panels[0].getAttribute('hidden')).toBe('true')
519
+
520
+ tablistAction.destroy()
521
+ panelsAction.destroy()
522
+ })
523
+
524
+ test('selectNextTab advances from current', () => {
525
+ const { tablistNode, panelsNode, panelId } = createTabsDOM()
526
+ const { tablistAction, panelsAction } = initActions({ tablistNode, panelsNode })
527
+
528
+ const tab = getTab(panelId)
529
+ const tabs = getTabElements(tablistNode)
530
+
531
+ selectNextTab(tab)
532
+
533
+ expect(tabs[1].getAttribute('aria-selected')).toBe('true')
534
+
535
+ tablistAction.destroy()
536
+ panelsAction.destroy()
537
+ })
538
+
539
+ test('selectPrevTab does nothing at index 0 without loop', () => {
540
+ const { tablistNode, panelsNode, panelId } = createTabsDOM()
541
+ const { tablistAction, panelsAction } = initActions({ tablistNode, panelsNode })
542
+
543
+ const tab = getTab(panelId)
544
+ const tabs = getTabElements(tablistNode)
545
+
546
+ selectPrevTab(tab)
547
+
548
+ expect(tabs[0].getAttribute('aria-selected')).toBe('true')
549
+
550
+ tablistAction.destroy()
551
+ panelsAction.destroy()
552
+ })
553
+ })
@@ -7,6 +7,15 @@ import {
7
7
  removeListeners,
8
8
  } from '@splendidlabz/utils/dom'
9
9
 
10
+ /**
11
+ * Reads the --placement CSS custom property from a node's computed style.
12
+ * Falls back to 'top' if not set.
13
+ */
14
+ export function readPlacement(node) {
15
+ const value = getComputedStyle(node).getPropertyValue('--placement').trim()
16
+ return value || 'top'
17
+ }
18
+
10
19
  // ========================
11
20
  // Shared State
12
21
  // ========================
@@ -70,7 +79,7 @@ export function tablist(node, props) {
70
79
  id: targetId,
71
80
  state: {
72
81
  ...DEFAULT_TABLIST_OPTIONS.state,
73
- placement: props.state.placement,
82
+ placement: readPlacement(node),
74
83
  activeTabIndex,
75
84
  length: tablistItems.length,
76
85
  },
@@ -101,12 +110,23 @@ export function tablist(node, props) {
101
110
 
102
111
  addListeners(listeners)
103
112
 
113
+ // Re-read placement from CSS on resize (handles responsive breakpoints)
114
+ function handleResize() {
115
+ const newPlacement = readPlacement(node)
116
+ if (newPlacement !== Tab.state.placement) {
117
+ updatePlacement(Tab, newPlacement)
118
+ }
119
+ }
120
+
121
+ window.addEventListener('resize', handleResize)
122
+
104
123
  const { autoplay } = Tab.options
105
124
  if (autoplay) setAutoplayInterval(Tab)
106
125
 
107
126
  return {
108
127
  destroy() {
109
128
  removeListeners(listeners)
129
+ window.removeEventListener('resize', handleResize)
110
130
  },
111
131
  }
112
132
 
@@ -154,13 +174,17 @@ export function tabpanels(node, props) {
154
174
  node.querySelectorAll('[role="tabpanel"]'),
155
175
  ).filter(tab => tab.closest('.tabpanels') === node)
156
176
 
177
+ const existingTab = getTab(tabpanelsId)
157
178
  let activeTabIndex
158
- activeTabIndex = tabpanelItems.findIndex(
159
- tabpanel => !tabpanel.hasAttribute('hidden'),
160
- )
161
- if (activeTabIndex === -1) activeTabIndex = 0
179
+ if (existingTab?.nodes?.tablist != null) {
180
+ activeTabIndex = existingTab.state.activeTabIndex ?? 0
181
+ } else {
182
+ activeTabIndex = tabpanelItems.findIndex(
183
+ tabpanel => !tabpanel.hasAttribute('hidden'),
184
+ )
185
+ if (activeTabIndex === -1) activeTabIndex = 0
186
+ }
162
187
 
163
- // Initialize the Tab
164
188
  const Tab = initTab({
165
189
  id: tabpanelsId,
166
190
  state: { activeTabIndex, length: tabpanelItems.length },
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@splendidlabz/svelte",
3
3
  "type": "module",
4
- "version": "4.8.4",
4
+ "version": "4.9.0",
5
5
  "sideEffects": false,
6
6
  "homepage": "https://splendidlabz.com/docs/svelte",
7
7
  "scripts": {
@@ -34,7 +34,9 @@
34
34
  "devDependencies": {
35
35
  "@splendidlabz/eslint-config": "2.1.3",
36
36
  "@sveltejs/vite-plugin-svelte": "^6.2.4",
37
+ "@testing-library/svelte": "^5.3.1",
37
38
  "@tsconfig/svelte": "^5.0.4",
39
+ "happy-dom": "^20.8.8",
38
40
  "svelte": "^5.25.6",
39
41
  "svelte-check": "^4.2.1",
40
42
  "vitest": "^3.1.1"
@@ -2,6 +2,8 @@ export function reloadScripts(node) {
2
2
  let scripts = []
3
3
  const scriptElements = Array.from(node.querySelectorAll('script'))
4
4
 
5
+ if (scriptElements.length === 0) return
6
+
5
7
  scriptElements.forEach(origScript => {
6
8
  const script = document.createElement('script')
7
9
  Array.from(origScript.attributes).forEach(attr => {
package/vitest.config.js CHANGED
@@ -5,4 +5,7 @@ export default defineConfig({
5
5
  plugins: [
6
6
  svelte({ configFile: false }),
7
7
  ],
8
+ test: {
9
+ environment: 'happy-dom',
10
+ },
8
11
  })