@solid-design-system/components 1.6.0 → 1.8.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.
Files changed (76) hide show
  1. package/dist/components/es/accordion-group.js +1 -1
  2. package/dist/components/es/accordion.js +1 -1
  3. package/dist/components/es/dropdown.js +1 -0
  4. package/dist/components/es/event.js +1 -0
  5. package/dist/components/es/popup.js +1 -0
  6. package/dist/components/es/solid-components2.js +1 -1
  7. package/dist/components/es/solid-element.js +1 -1
  8. package/dist/components/umd/solid-components.js +15 -15
  9. package/dist/custom-elements.json +1 -1
  10. package/dist/package/components/dropdown/dropdown.d.ts +49 -0
  11. package/dist/package/components/dropdown/dropdown.js +335 -0
  12. package/dist/package/components/popup/popup.d.ts +42 -0
  13. package/dist/package/components/popup/popup.js +318 -0
  14. package/dist/package/internal/offset.d.ts +4 -0
  15. package/dist/package/internal/offset.js +9 -0
  16. package/dist/package/internal/scroll.d.ts +3 -0
  17. package/dist/package/internal/scroll.js +27 -0
  18. package/dist/package/internal/tabbable.d.ts +4 -0
  19. package/dist/package/internal/tabbable.js +50 -0
  20. package/dist/package/solid-components.d.ts +2 -0
  21. package/dist/package/solid-components.js +14 -10
  22. package/dist/package/styles/tailwind.css.js +1 -1
  23. package/dist/versioned-components/es/accordion-group.js +1 -1
  24. package/dist/versioned-components/es/accordion.js +1 -1
  25. package/dist/versioned-components/es/badge.js +1 -1
  26. package/dist/versioned-components/es/brandshape.js +1 -1
  27. package/dist/versioned-components/es/button.js +2 -2
  28. package/dist/versioned-components/es/divider.js +1 -1
  29. package/dist/versioned-components/es/dropdown.js +1 -0
  30. package/dist/versioned-components/es/event.js +1 -0
  31. package/dist/versioned-components/es/icon.js +1 -1
  32. package/dist/versioned-components/es/include.js +1 -1
  33. package/dist/versioned-components/es/link.js +1 -1
  34. package/dist/versioned-components/es/popup.js +1 -0
  35. package/dist/versioned-components/es/solid-components2.js +1 -1
  36. package/dist/versioned-components/es/solid-element.js +1 -1
  37. package/dist/versioned-components/es/spinner.js +1 -1
  38. package/dist/versioned-components/es/teaser.js +1 -1
  39. package/dist/versioned-package/components/accordion/accordion.d.ts +1 -1
  40. package/dist/versioned-package/components/accordion/accordion.js +2 -2
  41. package/dist/versioned-package/components/accordion-group/accordion-group.d.ts +1 -1
  42. package/dist/versioned-package/components/accordion-group/accordion-group.js +3 -3
  43. package/dist/versioned-package/components/badge/badge.d.ts +1 -1
  44. package/dist/versioned-package/components/badge/badge.js +1 -1
  45. package/dist/versioned-package/components/brandshape/brandshape.d.ts +1 -1
  46. package/dist/versioned-package/components/brandshape/brandshape.js +1 -1
  47. package/dist/versioned-package/components/button/button.d.ts +1 -1
  48. package/dist/versioned-package/components/button/button.js +4 -4
  49. package/dist/versioned-package/components/divider/divider.d.ts +1 -1
  50. package/dist/versioned-package/components/divider/divider.js +2 -2
  51. package/dist/versioned-package/components/dropdown/dropdown.d.ts +49 -0
  52. package/dist/versioned-package/components/dropdown/dropdown.js +335 -0
  53. package/dist/versioned-package/components/icon/icon.d.ts +1 -1
  54. package/dist/versioned-package/components/icon/icon.js +1 -1
  55. package/dist/versioned-package/components/include/include.d.ts +1 -1
  56. package/dist/versioned-package/components/include/include.js +1 -1
  57. package/dist/versioned-package/components/link/link.d.ts +1 -1
  58. package/dist/versioned-package/components/link/link.js +2 -2
  59. package/dist/versioned-package/components/popup/popup.d.ts +42 -0
  60. package/dist/versioned-package/components/popup/popup.js +318 -0
  61. package/dist/versioned-package/components/spinner/spinner.d.ts +1 -1
  62. package/dist/versioned-package/components/spinner/spinner.js +1 -1
  63. package/dist/versioned-package/components/teaser/teaser.js +1 -1
  64. package/dist/versioned-package/internal/form.js +1 -1
  65. package/dist/versioned-package/internal/offset.d.ts +4 -0
  66. package/dist/versioned-package/internal/offset.js +9 -0
  67. package/dist/versioned-package/internal/scroll.d.ts +3 -0
  68. package/dist/versioned-package/internal/scroll.js +27 -0
  69. package/dist/versioned-package/internal/tabbable.d.ts +4 -0
  70. package/dist/versioned-package/internal/tabbable.js +50 -0
  71. package/dist/versioned-package/solid-components.d.ts +2 -0
  72. package/dist/versioned-package/solid-components.js +14 -10
  73. package/dist/versioned-package/styles/tailwind.css.js +1 -1
  74. package/dist/vscode.html-custom-data.json +653 -11
  75. package/dist/web-types.json +1240 -64
  76. package/package.json +28 -19
@@ -305,6 +305,103 @@
305
305
  ],
306
306
  "references": []
307
307
  },
308
+ {
309
+ "name": "sd-dropdown",
310
+ "description": "Dropdowns expose additional content that \"drops down\" in a panel.\n\n\n---\n\n\n\n\n### **Events:**\n - **sd-show** - Emitted when the dropdown opens.\n- **sd-after-show** - Emitted after the dropdown opens and all animations are complete.\n- **sd-hide** - Emitted when the dropdown closes.\n- **sd-after-hide** - Emitted after the dropdown closes and all animations are complete.\n\n### **Methods:**\n - **show()** - Shows the dropdown panel.\n- **hide()** - Hides the dropdown panel\n- **reposition()** - Instructs the dropdown menu to reposition. Useful when the position or size of the trigger changes when the menu\nis activated.\n\n### **Slots:**\n - _default_ - The dropdown's main content.\n- **trigger** - The dropdown's trigger, usually a `<sd-button>` element.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **trigger** - The container that wraps the trigger.\n- **panel** - The panel that gets shown when the dropdown is open.",
311
+ "attributes": [
312
+ {
313
+ "name": "open",
314
+ "description": "Indicates whether or not the dropdown is open. You can toggle this attribute to show and hide the dropdown, or you\ncan use the `show()` and `hide()` methods and this attribute will reflect the dropdown's open state.",
315
+ "values": []
316
+ },
317
+ {
318
+ "name": "rounded",
319
+ "description": "Indicates whether or not the dropdown should be styled with rounded corners.",
320
+ "values": []
321
+ },
322
+ {
323
+ "name": "placement",
324
+ "description": "The preferred placement of the dropdown panel. Note that the actual placement may vary as needed to keep the panel\ninside of the viewport.",
325
+ "values": [
326
+ {
327
+ "name": ""
328
+ },
329
+ {
330
+ "name": "top"
331
+ },
332
+ {
333
+ "name": "top-start"
334
+ },
335
+ {
336
+ "name": "top-end"
337
+ },
338
+ {
339
+ "name": "bottom"
340
+ },
341
+ {
342
+ "name": "bottom-start"
343
+ },
344
+ {
345
+ "name": "bottom-end"
346
+ },
347
+ {
348
+ "name": "right"
349
+ },
350
+ {
351
+ "name": "right-start"
352
+ },
353
+ {
354
+ "name": "right-end"
355
+ },
356
+ {
357
+ "name": "left"
358
+ },
359
+ {
360
+ "name": "left-start"
361
+ },
362
+ {
363
+ "name": "left-end"
364
+ }
365
+ ]
366
+ },
367
+ {
368
+ "name": "disabled",
369
+ "description": "Disables the dropdown so the panel will not open.",
370
+ "values": []
371
+ },
372
+ {
373
+ "name": "stay-open-on-select",
374
+ "description": "By default, the dropdown is closed when an item is selected. This attribute will keep it open instead. Useful for\ndropdowns that allow for multiple interactions.",
375
+ "values": []
376
+ },
377
+ {
378
+ "name": "distance",
379
+ "description": "The distance in pixels from which to offset the panel away from its trigger. This defaults to `0` for `rounded=false` and to a minimum of `1` for `rounded=true`.",
380
+ "values": []
381
+ },
382
+ {
383
+ "name": "skidding",
384
+ "description": "The distance in pixels from which to offset the panel along its trigger.",
385
+ "values": []
386
+ },
387
+ {
388
+ "name": "no-auto-size",
389
+ "description": "Indicates whether or not the dropdown should automatically resize its content's width/height regarding the available space on screen.",
390
+ "values": []
391
+ },
392
+ {
393
+ "name": "no-flip",
394
+ "description": "When set to true, the placement of the dropdown will not flip to the opposite site to keep it in view.",
395
+ "values": []
396
+ },
397
+ {
398
+ "name": "hoist",
399
+ "description": "Enable this option to prevent the panel from being clipped when the component is placed inside a container with\n`overflow: auto|scroll`. Hoisting uses a fixed positioning strategy that works in many, but not all, scenarios.",
400
+ "values": []
401
+ }
402
+ ],
403
+ "references": []
404
+ },
308
405
  {
309
406
  "name": "sd-icon",
310
407
  "description": "Icons are symbols that can be used to represent various options within an application.\n\n\n---\n\n\n\n\n### **Events:**\n - **sd-load** - Emitted when the icon has loaded.\n- **sd-error** - Emitted when the icon fails to load due to an error.",
@@ -439,6 +536,230 @@
439
536
  ],
440
537
  "references": []
441
538
  },
539
+ {
540
+ "name": "sd-popup",
541
+ "description": "Popup is a utility that lets you declaratively anchor \"popup\" containers to another element.\n\n\n---\n\n\n\n\n### **Events:**\n - **sd-reposition** - Emitted when the popup is repositioned. This event can fire a lot, so avoid putting expensive operations in your listener or consider debouncing it.\n\n### **Methods:**\n - **reposition()** - Forces the popup to recalculate and reposition itself.\n\n### **Slots:**\n - _default_ - The popup's content.\n- **anchor** - The element the popup will be anchored to. If the anchor lives outside of the popup, you can use the `anchor` attribute or property instead.\n\n### **CSS Properties:**\n - **--arrow-size** - The size of the arrow. Note that an arrow won't be shown unless the `arrow` attribute is used. _(default: 6px)_\n- **--arrow-color** - The color of the arrow. _(default: var(--sd-color-neutral-0))_\n- **--auto-size-available-width** - A read-only custom property that determines the amount of width the popup can be before overflowing. Useful for positioning child elements that need to overflow. This property is only available when using `auto-size`. _(default: undefined)_\n- **--auto-size-available-height** - A read-only custom property that determines the amount of height the popup can be before overflowing. Useful for positioning child elements that need to overflow. This property is only available when using `auto-size`. _(default: undefined)_\n\n### **CSS Parts:**\n - **arrow** - The arrow's container. Avoid setting `top|bottom|left|right` properties, as these values are assigned dynamically as the popup moves. This is most useful for applying a background color to match the popup, and maybe a border or box shadow.\n- **popup** - The popup's container. Useful for setting a background color, box shadow, etc.",
542
+ "attributes": [
543
+ {
544
+ "name": "anchor",
545
+ "description": "The element the popup will be anchored to. If the anchor lives outside of the popup, you can provide its `id` or a\nreference to it here. If the anchor lives inside the popup, use the `anchor` slot instead.",
546
+ "values": [
547
+ {
548
+ "name": "Element"
549
+ }
550
+ ]
551
+ },
552
+ {
553
+ "name": "active",
554
+ "description": "Activates the positioning logic and shows the popup. When this attribute is removed, the positioning logic is torn\ndown and the popup will be hidden.",
555
+ "values": []
556
+ },
557
+ {
558
+ "name": "placement",
559
+ "description": "The preferred placement of the popup. Note that the actual placement will vary as configured to keep the\npanel inside of the viewport.",
560
+ "values": [
561
+ {
562
+ "name": ""
563
+ },
564
+ {
565
+ "name": "top"
566
+ },
567
+ {
568
+ "name": "top-start"
569
+ },
570
+ {
571
+ "name": "top-end"
572
+ },
573
+ {
574
+ "name": "bottom"
575
+ },
576
+ {
577
+ "name": "bottom-start"
578
+ },
579
+ {
580
+ "name": "bottom-end"
581
+ },
582
+ {
583
+ "name": "right"
584
+ },
585
+ {
586
+ "name": "right-start"
587
+ },
588
+ {
589
+ "name": "right-end"
590
+ },
591
+ {
592
+ "name": "left"
593
+ },
594
+ {
595
+ "name": "left-start"
596
+ },
597
+ {
598
+ "name": "left-end"
599
+ }
600
+ ]
601
+ },
602
+ {
603
+ "name": "strategy",
604
+ "description": "Determines how the popup is positioned. The `absolute` strategy works well in most cases, but if\noverflow is clipped, using a `fixed` position strategy can often workaround it.",
605
+ "values": [
606
+ {
607
+ "name": "absolute"
608
+ },
609
+ {
610
+ "name": "fixed"
611
+ }
612
+ ]
613
+ },
614
+ {
615
+ "name": "distance",
616
+ "description": "The distance in pixels from which to offset the panel away from its anchor.",
617
+ "values": []
618
+ },
619
+ {
620
+ "name": "skidding",
621
+ "description": "The distance in pixels from which to offset the panel along its anchor.",
622
+ "values": []
623
+ },
624
+ {
625
+ "name": "arrow",
626
+ "description": "Attaches an arrow to the popup. The arrow's size and color can be customized using the `--arrow-size` and\n`--arrow-color` custom properties. For additional customizations, you can also target the arrow using\n`::part(arrow)` in your stylesheet.",
627
+ "values": []
628
+ },
629
+ {
630
+ "name": "arrow-placement",
631
+ "description": "The placement of the arrow. The default is `anchor`, which will align the arrow as close to the center of the\nanchor as possible, considering available space and `arrow-padding`. A value of `start`, `end`, or `center` will\nalign the arrow to the start, end, or center of the popover instead.",
632
+ "values": [
633
+ {
634
+ "name": "start"
635
+ },
636
+ {
637
+ "name": "end"
638
+ },
639
+ {
640
+ "name": "center"
641
+ },
642
+ {
643
+ "name": "anchor"
644
+ }
645
+ ]
646
+ },
647
+ {
648
+ "name": "arrow-padding",
649
+ "description": "The amount of padding between the arrow and the edges of the popup. If the popup has a border-radius, for example,\nthis will prevent it from overflowing the corners.",
650
+ "values": []
651
+ },
652
+ {
653
+ "name": "flip",
654
+ "description": "When set, placement of the popup will flip to the opposite site to keep it in view. You can use\n`flipFallbackPlacements` to further configure how the fallback placement is determined.",
655
+ "values": []
656
+ },
657
+ {
658
+ "name": "flip-fallback-placements",
659
+ "description": "If the preferred placement doesn't fit, popup will be tested in these fallback placements until one fits. Must be a\nstring of any number of placements separated by a space, e.g. \"top bottom left\". If no placement fits, the flip\nfallback strategy will be used instead.",
660
+ "values": []
661
+ },
662
+ {
663
+ "name": "flip-fallback-strategy",
664
+ "description": "When neither the preferred placement nor the fallback placements fit, this value will be used to determine whether\nthe popup should be positioned using the best available fit based on available space or as it was initially\npreferred.",
665
+ "values": [
666
+ {
667
+ "name": "best-fit"
668
+ },
669
+ {
670
+ "name": "initial"
671
+ }
672
+ ]
673
+ },
674
+ {
675
+ "name": "flipBoundary",
676
+ "description": "The flip boundary describes clipping element(s) that overflow will be checked relative to when flipping. By\ndefault, the boundary includes overflow ancestors that will cause the element to be clipped. If needed, you can\nchange the boundary by passing a reference to one or more elements to this property.",
677
+ "values": [
678
+ {
679
+ "name": "Element"
680
+ },
681
+ {
682
+ "name": "Element[]"
683
+ }
684
+ ]
685
+ },
686
+ {
687
+ "name": "flip-padding",
688
+ "description": "The amount of padding, in pixels, to exceed before the flip behavior will occur.",
689
+ "values": []
690
+ },
691
+ {
692
+ "name": "shift",
693
+ "description": "Moves the popup along the axis to keep it in view when clipped.",
694
+ "values": []
695
+ },
696
+ {
697
+ "name": "shiftBoundary",
698
+ "description": "The shift boundary describes clipping element(s) that overflow will be checked relative to when shifting. By\ndefault, the boundary includes overflow ancestors that will cause the element to be clipped. If needed, you can\nchange the boundary by passing a reference to one or more elements to this property.",
699
+ "values": [
700
+ {
701
+ "name": "Element"
702
+ },
703
+ {
704
+ "name": "Element[]"
705
+ }
706
+ ]
707
+ },
708
+ {
709
+ "name": "shift-padding",
710
+ "description": "The amount of padding, in pixels, to exceed before the shift behavior will occur.",
711
+ "values": []
712
+ },
713
+ {
714
+ "name": "auto-size",
715
+ "description": "When set, this will cause the popup to automatically resize itself to prevent it from overflowing.",
716
+ "values": [
717
+ {
718
+ "name": "horizontal"
719
+ },
720
+ {
721
+ "name": "vertical"
722
+ },
723
+ {
724
+ "name": "both"
725
+ }
726
+ ]
727
+ },
728
+ {
729
+ "name": "sync",
730
+ "description": "Syncs the popup's width or height to that of the anchor element.",
731
+ "values": [
732
+ {
733
+ "name": "width"
734
+ },
735
+ {
736
+ "name": "height"
737
+ },
738
+ {
739
+ "name": "both"
740
+ }
741
+ ]
742
+ },
743
+ {
744
+ "name": "autoSizeBoundary",
745
+ "description": "The auto-size boundary describes clipping element(s) that overflow will be checked relative to when resizing. By\ndefault, the boundary includes overflow ancestors that will cause the element to be clipped. If needed, you can\nchange the boundary by passing a reference to one or more elements to this property.",
746
+ "values": [
747
+ {
748
+ "name": "Element"
749
+ },
750
+ {
751
+ "name": "Element[]"
752
+ }
753
+ ]
754
+ },
755
+ {
756
+ "name": "auto-size-padding",
757
+ "description": "The amount of padding, in pixels, to exceed before the auto-size behavior will occur.",
758
+ "values": []
759
+ }
760
+ ],
761
+ "references": []
762
+ },
442
763
  {
443
764
  "name": "sd-spinner",
444
765
  "description": "Spinners are used to show the progress of an indeterminate operation.\n\n\n---\n\n\n",
@@ -499,7 +820,7 @@
499
820
  "references": []
500
821
  },
501
822
  {
502
- "name": "sd-1-6-0-accordion-group",
823
+ "name": "sd-1-8-0-accordion-group",
503
824
  "description": "Short summary of the component's intended use.\n\n\n---\n\n\n\n\n### **Slots:**\n - _default_ - The default slot where `<sd-accordion>` elements are placed.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.",
504
825
  "attributes": [
505
826
  {
@@ -511,7 +832,7 @@
511
832
  "references": []
512
833
  },
513
834
  {
514
- "name": "sd-1-6-0-accordion",
835
+ "name": "sd-1-8-0-accordion",
515
836
  "description": "Accordion shows a brief summary and expands to show additional content.\n\n\n---\n\n\n\n\n### **Events:**\n - **sd-show** - Emitted when the accordion opens.\n- **sd-after-show** - Emitted after the accordion opens and all animations are complete.\n- **sd-hide** - Emitted when the accordion closes.\n- **sd-after-hide** - Emitted after the accordion closes and all animations are complete.\n\n### **Methods:**\n - **show()** - Shows the accordion.\n- **hide()** - Hides the accordion\n\n### **Slots:**\n - _default_ - The accordion main content.\n- **summary** - The accordion summary. Alternatively, you can use the `summary` attribute.\n- **expand-icon** - Optional expand icon to use instead of the default. Works best with `<sd-icon>`.\n- **collapse-icon** - Optional collapse icon to use instead of the default. Works best with `<sd-icon>`.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **header** - The header that wraps both the summary and the expand/collapse icon.\n- **summary** - The container that wraps the summary.\n- **summary-icon** - The container that wraps the expand/collapse icons.\n- **content** - The accordion content.",
516
837
  "attributes": [
517
838
  {
@@ -528,7 +849,7 @@
528
849
  "references": []
529
850
  },
530
851
  {
531
- "name": "sd-1-6-0-badge",
852
+ "name": "sd-1-8-0-badge",
532
853
  "description": "Badges are used to draw attention and display statuses or counts.\n\n\n---\n\n\n\n\n### **Slots:**\n - _default_ - The badge's content.\n\n### **CSS Parts:**\n - **base** - The badge's base wrapper.\n- **content** - The badge's main content.",
533
854
  "attributes": [
534
855
  {
@@ -570,7 +891,7 @@
570
891
  "references": []
571
892
  },
572
893
  {
573
- "name": "sd-1-6-0-brandshape",
894
+ "name": "sd-1-8-0-brandshape",
574
895
  "description": "The Brandshape highlights a piece of content.\n\n\n---\n\n\n\n\n### **Slots:**\n - _default_ - The content inside the brandshape.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **content** - Middle content wrapper.\n- **shape-top** - Top shape.\n- **shape-middle** - Middle shape.\n- **shape-bottom** - Bottom shape.",
575
896
  "attributes": [
576
897
  {
@@ -607,7 +928,7 @@
607
928
  "references": []
608
929
  },
609
930
  {
610
- "name": "sd-1-6-0-button",
931
+ "name": "sd-1-8-0-button",
611
932
  "description": "Buttons represent actions that are available to the user.\n\n\n---\n\n\n\n\n### **Events:**\n - **sd-blur** - Emitted when the button loses focus.\n- **sd-focus** - Emitted when the button gains focus.\n\n### **Methods:**\n - **click()** - Simulates a click on the button.\n- **focus(options: _FocusOptions_)** - Sets focus on the button.\n- **blur()** - Removes focus from the button.\n- **checkValidity()** - Checks for validity but does not show the browser's validation message.\n- **reportValidity()** - Checks for validity and shows the browser's validation message if the control is invalid.\n- **setCustomValidity(message: _string_)** - Sets a custom validation message. Pass an empty string to restore validity.\n\n### **Slots:**\n - _default_ - The button's label.\n- **icon-left** - A prefix icon or similar element.\n- **icon-right** - A suffix icon or similar element.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **icon-left** - The container that wraps the left icon area.\n- **label** - The button's label.\n- **icon-right** - The container that wraps the right icon area.",
612
933
  "attributes": [
613
934
  {
@@ -779,7 +1100,7 @@
779
1100
  "references": []
780
1101
  },
781
1102
  {
782
- "name": "sd-1-6-0-divider",
1103
+ "name": "sd-1-8-0-divider",
783
1104
  "description": "Dividers are used to visually separate or group elements.\n\n\n---\n\n\n",
784
1105
  "attributes": [
785
1106
  {
@@ -803,7 +1124,104 @@
803
1124
  "references": []
804
1125
  },
805
1126
  {
806
- "name": "sd-1-6-0-icon",
1127
+ "name": "sd-1-8-0-dropdown",
1128
+ "description": "Dropdowns expose additional content that \"drops down\" in a panel.\n\n\n---\n\n\n\n\n### **Events:**\n - **sd-show** - Emitted when the dropdown opens.\n- **sd-after-show** - Emitted after the dropdown opens and all animations are complete.\n- **sd-hide** - Emitted when the dropdown closes.\n- **sd-after-hide** - Emitted after the dropdown closes and all animations are complete.\n\n### **Methods:**\n - **show()** - Shows the dropdown panel.\n- **hide()** - Hides the dropdown panel\n- **reposition()** - Instructs the dropdown menu to reposition. Useful when the position or size of the trigger changes when the menu\nis activated.\n\n### **Slots:**\n - _default_ - The dropdown's main content.\n- **trigger** - The dropdown's trigger, usually a `<sd-button>` element.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **trigger** - The container that wraps the trigger.\n- **panel** - The panel that gets shown when the dropdown is open.",
1129
+ "attributes": [
1130
+ {
1131
+ "name": "open",
1132
+ "description": "Indicates whether or not the dropdown is open. You can toggle this attribute to show and hide the dropdown, or you\ncan use the `show()` and `hide()` methods and this attribute will reflect the dropdown's open state.",
1133
+ "values": []
1134
+ },
1135
+ {
1136
+ "name": "rounded",
1137
+ "description": "Indicates whether or not the dropdown should be styled with rounded corners.",
1138
+ "values": []
1139
+ },
1140
+ {
1141
+ "name": "placement",
1142
+ "description": "The preferred placement of the dropdown panel. Note that the actual placement may vary as needed to keep the panel\ninside of the viewport.",
1143
+ "values": [
1144
+ {
1145
+ "name": ""
1146
+ },
1147
+ {
1148
+ "name": "top"
1149
+ },
1150
+ {
1151
+ "name": "top-start"
1152
+ },
1153
+ {
1154
+ "name": "top-end"
1155
+ },
1156
+ {
1157
+ "name": "bottom"
1158
+ },
1159
+ {
1160
+ "name": "bottom-start"
1161
+ },
1162
+ {
1163
+ "name": "bottom-end"
1164
+ },
1165
+ {
1166
+ "name": "right"
1167
+ },
1168
+ {
1169
+ "name": "right-start"
1170
+ },
1171
+ {
1172
+ "name": "right-end"
1173
+ },
1174
+ {
1175
+ "name": "left"
1176
+ },
1177
+ {
1178
+ "name": "left-start"
1179
+ },
1180
+ {
1181
+ "name": "left-end"
1182
+ }
1183
+ ]
1184
+ },
1185
+ {
1186
+ "name": "disabled",
1187
+ "description": "Disables the dropdown so the panel will not open.",
1188
+ "values": []
1189
+ },
1190
+ {
1191
+ "name": "stay-open-on-select",
1192
+ "description": "By default, the dropdown is closed when an item is selected. This attribute will keep it open instead. Useful for\ndropdowns that allow for multiple interactions.",
1193
+ "values": []
1194
+ },
1195
+ {
1196
+ "name": "distance",
1197
+ "description": "The distance in pixels from which to offset the panel away from its trigger. This defaults to `0` for `rounded=false` and to a minimum of `1` for `rounded=true`.",
1198
+ "values": []
1199
+ },
1200
+ {
1201
+ "name": "skidding",
1202
+ "description": "The distance in pixels from which to offset the panel along its trigger.",
1203
+ "values": []
1204
+ },
1205
+ {
1206
+ "name": "no-auto-size",
1207
+ "description": "Indicates whether or not the dropdown should automatically resize its content's width/height regarding the available space on screen.",
1208
+ "values": []
1209
+ },
1210
+ {
1211
+ "name": "no-flip",
1212
+ "description": "When set to true, the placement of the dropdown will not flip to the opposite site to keep it in view.",
1213
+ "values": []
1214
+ },
1215
+ {
1216
+ "name": "hoist",
1217
+ "description": "Enable this option to prevent the panel from being clipped when the component is placed inside a container with\n`overflow: auto|scroll`. Hoisting uses a fixed positioning strategy that works in many, but not all, scenarios.",
1218
+ "values": []
1219
+ }
1220
+ ],
1221
+ "references": []
1222
+ },
1223
+ {
1224
+ "name": "sd-1-8-0-icon",
807
1225
  "description": "Icons are symbols that can be used to represent various options within an application.\n\n\n---\n\n\n\n\n### **Events:**\n - **sd-load** - Emitted when the icon has loaded.\n- **sd-error** - Emitted when the icon fails to load due to an error.",
808
1226
  "attributes": [
809
1227
  {
@@ -845,7 +1263,7 @@
845
1263
  "references": []
846
1264
  },
847
1265
  {
848
- "name": "sd-1-6-0-include",
1266
+ "name": "sd-1-8-0-include",
849
1267
  "description": "Includes give you the power to embed external HTML files into the page.\n\n\n---\n\n\n\n\n### **Events:**\n - **sd-load** - Emitted when the included file is loaded.\n- **sd-error** - Emitted when the included file fails to load due to an error.",
850
1268
  "attributes": [
851
1269
  {
@@ -877,7 +1295,7 @@
877
1295
  "references": []
878
1296
  },
879
1297
  {
880
- "name": "sd-1-6-0-link",
1298
+ "name": "sd-1-8-0-link",
881
1299
  "description": "A link component.\n\n\n---\n\n\n\n\n### **Events:**\n - **sd-blur** - Emitted when the link loses focus.\n- **sd-focus** - Emitted when the link gains focus.\n\n### **Methods:**\n - **focus(options: _FocusOptions_)** - Sets focus on the button.\n- **blur()** - Removes focus from the button.\n\n### **Slots:**\n - _default_ - The default slot.\n- **icon-left** - The icon to display on the left side of the link.\n- **icon-right** - The icon to display on the right side of the link.\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **icon-left** - The container that wraps the left icon area.\n- **label** - The link's label.\n- **icon-right** - The container that wraps the right icon area.",
882
1300
  "attributes": [
883
1301
  {
@@ -937,7 +1355,231 @@
937
1355
  "references": []
938
1356
  },
939
1357
  {
940
- "name": "sd-1-6-0-spinner",
1358
+ "name": "sd-1-8-0-popup",
1359
+ "description": "Popup is a utility that lets you declaratively anchor \"popup\" containers to another element.\n\n\n---\n\n\n\n\n### **Events:**\n - **sd-reposition** - Emitted when the popup is repositioned. This event can fire a lot, so avoid putting expensive operations in your listener or consider debouncing it.\n\n### **Methods:**\n - **reposition()** - Forces the popup to recalculate and reposition itself.\n\n### **Slots:**\n - _default_ - The popup's content.\n- **anchor** - The element the popup will be anchored to. If the anchor lives outside of the popup, you can use the `anchor` attribute or property instead.\n\n### **CSS Properties:**\n - **--arrow-size** - The size of the arrow. Note that an arrow won't be shown unless the `arrow` attribute is used. _(default: 6px)_\n- **--arrow-color** - The color of the arrow. _(default: var(--sd-color-neutral-0))_\n- **--auto-size-available-width** - A read-only custom property that determines the amount of width the popup can be before overflowing. Useful for positioning child elements that need to overflow. This property is only available when using `auto-size`. _(default: undefined)_\n- **--auto-size-available-height** - A read-only custom property that determines the amount of height the popup can be before overflowing. Useful for positioning child elements that need to overflow. This property is only available when using `auto-size`. _(default: undefined)_\n\n### **CSS Parts:**\n - **arrow** - The arrow's container. Avoid setting `top|bottom|left|right` properties, as these values are assigned dynamically as the popup moves. This is most useful for applying a background color to match the popup, and maybe a border or box shadow.\n- **popup** - The popup's container. Useful for setting a background color, box shadow, etc.",
1360
+ "attributes": [
1361
+ {
1362
+ "name": "anchor",
1363
+ "description": "The element the popup will be anchored to. If the anchor lives outside of the popup, you can provide its `id` or a\nreference to it here. If the anchor lives inside the popup, use the `anchor` slot instead.",
1364
+ "values": [
1365
+ {
1366
+ "name": "Element"
1367
+ }
1368
+ ]
1369
+ },
1370
+ {
1371
+ "name": "active",
1372
+ "description": "Activates the positioning logic and shows the popup. When this attribute is removed, the positioning logic is torn\ndown and the popup will be hidden.",
1373
+ "values": []
1374
+ },
1375
+ {
1376
+ "name": "placement",
1377
+ "description": "The preferred placement of the popup. Note that the actual placement will vary as configured to keep the\npanel inside of the viewport.",
1378
+ "values": [
1379
+ {
1380
+ "name": ""
1381
+ },
1382
+ {
1383
+ "name": "top"
1384
+ },
1385
+ {
1386
+ "name": "top-start"
1387
+ },
1388
+ {
1389
+ "name": "top-end"
1390
+ },
1391
+ {
1392
+ "name": "bottom"
1393
+ },
1394
+ {
1395
+ "name": "bottom-start"
1396
+ },
1397
+ {
1398
+ "name": "bottom-end"
1399
+ },
1400
+ {
1401
+ "name": "right"
1402
+ },
1403
+ {
1404
+ "name": "right-start"
1405
+ },
1406
+ {
1407
+ "name": "right-end"
1408
+ },
1409
+ {
1410
+ "name": "left"
1411
+ },
1412
+ {
1413
+ "name": "left-start"
1414
+ },
1415
+ {
1416
+ "name": "left-end"
1417
+ }
1418
+ ]
1419
+ },
1420
+ {
1421
+ "name": "strategy",
1422
+ "description": "Determines how the popup is positioned. The `absolute` strategy works well in most cases, but if\noverflow is clipped, using a `fixed` position strategy can often workaround it.",
1423
+ "values": [
1424
+ {
1425
+ "name": "absolute"
1426
+ },
1427
+ {
1428
+ "name": "fixed"
1429
+ }
1430
+ ]
1431
+ },
1432
+ {
1433
+ "name": "distance",
1434
+ "description": "The distance in pixels from which to offset the panel away from its anchor.",
1435
+ "values": []
1436
+ },
1437
+ {
1438
+ "name": "skidding",
1439
+ "description": "The distance in pixels from which to offset the panel along its anchor.",
1440
+ "values": []
1441
+ },
1442
+ {
1443
+ "name": "arrow",
1444
+ "description": "Attaches an arrow to the popup. The arrow's size and color can be customized using the `--arrow-size` and\n`--arrow-color` custom properties. For additional customizations, you can also target the arrow using\n`::part(arrow)` in your stylesheet.",
1445
+ "values": []
1446
+ },
1447
+ {
1448
+ "name": "arrow-placement",
1449
+ "description": "The placement of the arrow. The default is `anchor`, which will align the arrow as close to the center of the\nanchor as possible, considering available space and `arrow-padding`. A value of `start`, `end`, or `center` will\nalign the arrow to the start, end, or center of the popover instead.",
1450
+ "values": [
1451
+ {
1452
+ "name": "start"
1453
+ },
1454
+ {
1455
+ "name": "end"
1456
+ },
1457
+ {
1458
+ "name": "center"
1459
+ },
1460
+ {
1461
+ "name": "anchor"
1462
+ }
1463
+ ]
1464
+ },
1465
+ {
1466
+ "name": "arrow-padding",
1467
+ "description": "The amount of padding between the arrow and the edges of the popup. If the popup has a border-radius, for example,\nthis will prevent it from overflowing the corners.",
1468
+ "values": []
1469
+ },
1470
+ {
1471
+ "name": "flip",
1472
+ "description": "When set, placement of the popup will flip to the opposite site to keep it in view. You can use\n`flipFallbackPlacements` to further configure how the fallback placement is determined.",
1473
+ "values": []
1474
+ },
1475
+ {
1476
+ "name": "flip-fallback-placements",
1477
+ "description": "If the preferred placement doesn't fit, popup will be tested in these fallback placements until one fits. Must be a\nstring of any number of placements separated by a space, e.g. \"top bottom left\". If no placement fits, the flip\nfallback strategy will be used instead.",
1478
+ "values": []
1479
+ },
1480
+ {
1481
+ "name": "flip-fallback-strategy",
1482
+ "description": "When neither the preferred placement nor the fallback placements fit, this value will be used to determine whether\nthe popup should be positioned using the best available fit based on available space or as it was initially\npreferred.",
1483
+ "values": [
1484
+ {
1485
+ "name": "best-fit"
1486
+ },
1487
+ {
1488
+ "name": "initial"
1489
+ }
1490
+ ]
1491
+ },
1492
+ {
1493
+ "name": "flipBoundary",
1494
+ "description": "The flip boundary describes clipping element(s) that overflow will be checked relative to when flipping. By\ndefault, the boundary includes overflow ancestors that will cause the element to be clipped. If needed, you can\nchange the boundary by passing a reference to one or more elements to this property.",
1495
+ "values": [
1496
+ {
1497
+ "name": "Element"
1498
+ },
1499
+ {
1500
+ "name": "Element[]"
1501
+ }
1502
+ ]
1503
+ },
1504
+ {
1505
+ "name": "flip-padding",
1506
+ "description": "The amount of padding, in pixels, to exceed before the flip behavior will occur.",
1507
+ "values": []
1508
+ },
1509
+ {
1510
+ "name": "shift",
1511
+ "description": "Moves the popup along the axis to keep it in view when clipped.",
1512
+ "values": []
1513
+ },
1514
+ {
1515
+ "name": "shiftBoundary",
1516
+ "description": "The shift boundary describes clipping element(s) that overflow will be checked relative to when shifting. By\ndefault, the boundary includes overflow ancestors that will cause the element to be clipped. If needed, you can\nchange the boundary by passing a reference to one or more elements to this property.",
1517
+ "values": [
1518
+ {
1519
+ "name": "Element"
1520
+ },
1521
+ {
1522
+ "name": "Element[]"
1523
+ }
1524
+ ]
1525
+ },
1526
+ {
1527
+ "name": "shift-padding",
1528
+ "description": "The amount of padding, in pixels, to exceed before the shift behavior will occur.",
1529
+ "values": []
1530
+ },
1531
+ {
1532
+ "name": "auto-size",
1533
+ "description": "When set, this will cause the popup to automatically resize itself to prevent it from overflowing.",
1534
+ "values": [
1535
+ {
1536
+ "name": "horizontal"
1537
+ },
1538
+ {
1539
+ "name": "vertical"
1540
+ },
1541
+ {
1542
+ "name": "both"
1543
+ }
1544
+ ]
1545
+ },
1546
+ {
1547
+ "name": "sync",
1548
+ "description": "Syncs the popup's width or height to that of the anchor element.",
1549
+ "values": [
1550
+ {
1551
+ "name": "width"
1552
+ },
1553
+ {
1554
+ "name": "height"
1555
+ },
1556
+ {
1557
+ "name": "both"
1558
+ }
1559
+ ]
1560
+ },
1561
+ {
1562
+ "name": "autoSizeBoundary",
1563
+ "description": "The auto-size boundary describes clipping element(s) that overflow will be checked relative to when resizing. By\ndefault, the boundary includes overflow ancestors that will cause the element to be clipped. If needed, you can\nchange the boundary by passing a reference to one or more elements to this property.",
1564
+ "values": [
1565
+ {
1566
+ "name": "Element"
1567
+ },
1568
+ {
1569
+ "name": "Element[]"
1570
+ }
1571
+ ]
1572
+ },
1573
+ {
1574
+ "name": "auto-size-padding",
1575
+ "description": "The amount of padding, in pixels, to exceed before the auto-size behavior will occur.",
1576
+ "values": []
1577
+ }
1578
+ ],
1579
+ "references": []
1580
+ },
1581
+ {
1582
+ "name": "sd-1-8-0-spinner",
941
1583
  "description": "Spinners are used to show the progress of an indeterminate operation.\n\n\n---\n\n\n",
942
1584
  "attributes": [
943
1585
  {
@@ -959,7 +1601,7 @@
959
1601
  "references": []
960
1602
  },
961
1603
  {
962
- "name": "sd-1-6-0-teaser",
1604
+ "name": "sd-1-8-0-teaser",
963
1605
  "description": "Teasers group information into flexible containers so users can browse a collection of related items and actions.\n\n\n---\n\n\n\n\n### **Slots:**\n - _default_ - An optional main content slot.\n- **media** - An optional media slot.\n- **meta** - An optional meta slot.\n- **headline** - headline slot.\n\n### **CSS Properties:**\n - **--distribution-media** - The distribution ratio of the media. _(default: undefined)_\n- **--distribution-content** - The distribution ratio of the content. _(default: undefined)_\n\n### **CSS Parts:**\n - **base** - The component's base wrapper.\n- **media** - The container that wraps the media.\n- **content** - The container that wraps the content.\n- **meta** - The container that wraps the meta.\n- **headline** - The container that wraps the headline.\n- **main** - The container that wraps the main content.",
964
1606
  "attributes": [
965
1607
  {