@warp-ds/elements 2.10.0-next.1 → 2.10.0-next.11

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 (254) hide show
  1. package/README.md +4 -0
  2. package/dist/api.js +1 -1
  3. package/dist/api.js.map +1 -1
  4. package/dist/custom-elements.json +233 -87
  5. package/dist/docs/affix/affix.md +2 -2
  6. package/dist/docs/affix/styling.md +1 -0
  7. package/dist/docs/alert/alert.md +2 -2
  8. package/dist/docs/alert/styling.md +1 -0
  9. package/dist/docs/attention/attention.md +2 -0
  10. package/dist/docs/attention/styling.md +1 -0
  11. package/dist/docs/badge/badge.md +2 -0
  12. package/dist/docs/badge/styling.md +1 -0
  13. package/dist/docs/box/box.md +22 -40
  14. package/dist/docs/box/examples.md +20 -38
  15. package/dist/docs/box/styling.md +1 -0
  16. package/dist/docs/breadcrumbs/breadcrumbs.md +8 -2
  17. package/dist/docs/breadcrumbs/examples.md +7 -1
  18. package/dist/docs/breadcrumbs/styling.md +1 -0
  19. package/dist/docs/button/button.md +73 -2
  20. package/dist/docs/button/styling.md +72 -0
  21. package/dist/docs/card/accessibility.md +74 -0
  22. package/dist/docs/card/api.md +9 -3
  23. package/dist/docs/card/card.md +236 -5
  24. package/dist/docs/card/examples.md +75 -0
  25. package/dist/docs/card/styling.md +1 -0
  26. package/dist/docs/card/usage.md +76 -0
  27. package/dist/docs/checkbox/api.md +128 -0
  28. package/dist/docs/checkbox/checkbox.md +134 -0
  29. package/dist/docs/checkbox-group/accessibility.md +71 -0
  30. package/dist/docs/checkbox-group/api.md +79 -0
  31. package/dist/docs/checkbox-group/checkbox-group.md +492 -0
  32. package/dist/docs/checkbox-group/examples.md +105 -0
  33. package/dist/docs/checkbox-group/styling.md +132 -0
  34. package/dist/docs/checkbox-group/usage.md +95 -0
  35. package/dist/docs/combobox/accessibility.md +71 -0
  36. package/dist/docs/combobox/api.md +60 -30
  37. package/dist/docs/combobox/combobox.md +205 -32
  38. package/dist/docs/combobox/examples.md +44 -0
  39. package/dist/docs/combobox/styling.md +1 -0
  40. package/dist/docs/combobox/usage.md +28 -0
  41. package/dist/docs/datepicker/accessibility.md +25 -0
  42. package/dist/docs/datepicker/api.md +22 -14
  43. package/dist/docs/datepicker/datepicker.md +208 -16
  44. package/dist/docs/datepicker/examples.md +75 -0
  45. package/dist/docs/datepicker/styling.md +1 -0
  46. package/dist/docs/datepicker/usage.md +84 -0
  47. package/dist/docs/expandable/api.md +20 -32
  48. package/dist/docs/expandable/examples.md +54 -0
  49. package/dist/docs/expandable/expandable.md +74 -32
  50. package/dist/docs/expandable/styling.md +1 -0
  51. package/dist/docs/icon/accessibility.md +5 -0
  52. package/dist/docs/icon/api.md +43 -0
  53. package/dist/docs/icon/examples.md +45 -0
  54. package/dist/docs/icon/icon.md +115 -0
  55. package/dist/docs/icon/styling.md +1 -0
  56. package/dist/docs/icon/usage.md +11 -0
  57. package/dist/docs/index.md +46 -0
  58. package/dist/docs/link/api.md +18 -22
  59. package/dist/docs/link/examples.md +75 -0
  60. package/dist/docs/link/link.md +113 -24
  61. package/dist/docs/link/styling.md +1 -0
  62. package/dist/docs/link/usage.md +18 -0
  63. package/dist/docs/modal/modal.md +2 -0
  64. package/dist/docs/modal/styling.md +1 -0
  65. package/dist/docs/modal-footer/modal-footer.md +0 -6
  66. package/dist/docs/modal-header/modal-header.md +0 -6
  67. package/dist/docs/page-indicator/page-indicator.md +2 -0
  68. package/dist/docs/page-indicator/styling.md +1 -0
  69. package/dist/docs/pagination/pagination.md +2 -0
  70. package/dist/docs/pagination/styling.md +1 -0
  71. package/dist/docs/pill/pill.md +2 -0
  72. package/dist/docs/pill/styling.md +1 -0
  73. package/dist/docs/radio/radio.md +1 -7
  74. package/dist/docs/select/select.md +2 -0
  75. package/dist/docs/select/styling.md +1 -0
  76. package/dist/docs/slider/slider.md +2 -0
  77. package/dist/docs/slider/styling.md +1 -0
  78. package/dist/docs/slider-thumb/slider-thumb.md +2 -0
  79. package/dist/docs/slider-thumb/styling.md +1 -0
  80. package/dist/docs/step-indicator/step-indicator.md +2 -0
  81. package/dist/docs/step-indicator/styling.md +1 -0
  82. package/dist/docs/switch/styling.md +1 -0
  83. package/dist/docs/switch/switch.md +2 -0
  84. package/dist/docs/tabs/styling.md +1 -0
  85. package/dist/docs/tabs/tabs.md +2 -0
  86. package/dist/docs/textarea/styling.md +1 -0
  87. package/dist/docs/textarea/textarea.md +2 -0
  88. package/dist/docs/textfield/styling.md +1 -0
  89. package/dist/docs/textfield/textfield.md +2 -0
  90. package/dist/index.d.ts +932 -341
  91. package/dist/packages/affix/affix.hydration.test.js +1 -1
  92. package/dist/packages/affix/affix.js +4 -4
  93. package/dist/packages/affix/affix.js.map +4 -4
  94. package/dist/packages/alert/alert.hydration.test.js +1 -1
  95. package/dist/packages/alert/alert.js +3 -3
  96. package/dist/packages/alert/alert.js.map +3 -3
  97. package/dist/packages/attention/attention.hydration.test.js +1 -1
  98. package/dist/packages/attention/attention.js +397 -446
  99. package/dist/packages/attention/attention.js.map +4 -4
  100. package/dist/packages/attention/attention.test.js +1 -1
  101. package/dist/packages/badge/badge.hydration.test.js +1 -1
  102. package/dist/packages/box/box.hydration.test.js +1 -1
  103. package/dist/packages/box/box.js +1 -1
  104. package/dist/packages/box/box.js.map +1 -1
  105. package/dist/packages/breadcrumbs/breadcrumbs.hydration.test.js +3 -2
  106. package/dist/packages/breadcrumbs/breadcrumbs.js +4 -4
  107. package/dist/packages/breadcrumbs/breadcrumbs.js.map +3 -3
  108. package/dist/packages/button/button.hydration.test.js +1 -1
  109. package/dist/packages/button/button.js +387 -436
  110. package/dist/packages/button/button.js.map +4 -4
  111. package/dist/packages/button/button.stories.d.ts +29 -0
  112. package/dist/packages/button/button.stories.js +176 -2
  113. package/dist/packages/button/styles.d.ts +22 -1
  114. package/dist/packages/button/styles.js +390 -1
  115. package/dist/packages/card/card.d.ts +9 -6
  116. package/dist/packages/card/card.hydration.test.js +1 -1
  117. package/dist/packages/card/card.js +3 -3
  118. package/dist/packages/card/card.js.map +4 -4
  119. package/dist/packages/checkbox/checkbox.d.ts +45 -14
  120. package/dist/packages/checkbox/checkbox.hydration.test.js +1 -1
  121. package/dist/packages/checkbox/checkbox.js +3 -3
  122. package/dist/packages/checkbox/checkbox.js.map +3 -3
  123. package/dist/packages/checkbox/checkbox.react.stories.d.ts +1 -1
  124. package/dist/packages/checkbox/checkbox.stories.d.ts +2 -2
  125. package/dist/packages/checkbox/checkbox.test.js +1 -1
  126. package/dist/packages/checkbox/react.d.ts +2 -2
  127. package/dist/packages/checkbox-group/checkbox-group.a11y.test.js +1 -1
  128. package/dist/packages/checkbox-group/checkbox-group.d.ts +35 -8
  129. package/dist/packages/checkbox-group/checkbox-group.hydration.test.js +1 -1
  130. package/dist/packages/checkbox-group/checkbox-group.js +6 -6
  131. package/dist/packages/checkbox-group/checkbox-group.js.map +4 -4
  132. package/dist/packages/checkbox-group/react.d.ts +3 -3
  133. package/dist/packages/combobox/combobox.a11y.test.js +24 -0
  134. package/dist/packages/combobox/combobox.d.ts +65 -45
  135. package/dist/packages/combobox/combobox.hydration.test.js +39 -1
  136. package/dist/packages/combobox/combobox.js +21 -21
  137. package/dist/packages/combobox/combobox.js.map +4 -4
  138. package/dist/packages/combobox/combobox.stories.js +28 -15
  139. package/dist/packages/combobox/combobox.test.js +110 -0
  140. package/dist/packages/datepicker/DatePicker.test.js +1 -1
  141. package/dist/packages/datepicker/datepicker.d.ts +22 -30
  142. package/dist/packages/datepicker/datepicker.hydration.test.js +1 -1
  143. package/dist/packages/datepicker/datepicker.js +49 -49
  144. package/dist/packages/datepicker/datepicker.js.map +4 -4
  145. package/dist/packages/datepicker/datepicker.test.js +1 -1
  146. package/dist/packages/expandable/expandable.d.ts +11 -32
  147. package/dist/packages/expandable/expandable.hydration.test.js +1 -1
  148. package/dist/packages/expandable/expandable.js +11 -11
  149. package/dist/packages/expandable/expandable.js.map +3 -3
  150. package/dist/packages/expandable/expandable.react.stories.d.ts +2 -2
  151. package/dist/packages/expandable/react.d.ts +1 -1
  152. package/dist/packages/icon/icon.d.ts +16 -4
  153. package/dist/packages/icon/icon.hydration.test.js +1 -1
  154. package/dist/packages/icon/icon.js +2 -2
  155. package/dist/packages/icon/icon.js.map +3 -3
  156. package/dist/packages/icon/icon.react.stories.d.ts +1 -1
  157. package/dist/packages/icon/react.d.ts +2 -2
  158. package/dist/packages/link/link.d.ts +15 -16
  159. package/dist/packages/link/link.hydration.test.js +1 -1
  160. package/dist/packages/link/link.js +420 -190
  161. package/dist/packages/link/link.js.map +4 -4
  162. package/dist/packages/link/link.test.js +1 -1
  163. package/dist/packages/link/styles.d.ts +5 -0
  164. package/dist/packages/link/styles.js +80 -0
  165. package/dist/packages/modal/modal.d.ts +1 -0
  166. package/dist/packages/modal/modal.hydration.test.js +1 -1
  167. package/dist/packages/modal/modal.js +4 -4
  168. package/dist/packages/modal/modal.js.map +3 -3
  169. package/dist/packages/modal/modal.react.stories.d.ts +4 -4
  170. package/dist/packages/modal/modal.react.stories.js +9 -1
  171. package/dist/packages/modal/react.d.ts +34 -4
  172. package/dist/packages/modal/react.js +30 -0
  173. package/dist/packages/modal-header/modal-header.js +11 -9
  174. package/dist/packages/modal-header/modal-header.js.map +4 -4
  175. package/dist/packages/page-indicator/page-indicator.hydration.test.js +1 -1
  176. package/dist/packages/page-indicator/page-indicator.js +5 -5
  177. package/dist/packages/page-indicator/page-indicator.js.map +3 -3
  178. package/dist/packages/pagination/pagination.hydration.test.js +1 -1
  179. package/dist/packages/pagination/pagination.js +4 -4
  180. package/dist/packages/pagination/pagination.js.map +4 -4
  181. package/dist/packages/pagination/pagination.test.js +1 -1
  182. package/dist/packages/pill/pill.hydration.test.js +1 -1
  183. package/dist/packages/pill/pill.js +3 -3
  184. package/dist/packages/pill/pill.js.map +4 -4
  185. package/dist/packages/radio/radio.hydration.test.js +1 -1
  186. package/dist/packages/radio/radio.js +3 -3
  187. package/dist/packages/radio/radio.js.map +3 -3
  188. package/dist/packages/radio/radio.test.js +1 -1
  189. package/dist/packages/radio-group/radio-group.a11y.test.js +7 -3
  190. package/dist/packages/radio-group/radio-group.hydration.test.js +6 -2
  191. package/dist/packages/radio-group/radio-group.js +11 -11
  192. package/dist/packages/radio-group/radio-group.js.map +4 -4
  193. package/dist/packages/select/select.a11y.test.js +6 -2
  194. package/dist/packages/select/select.hydration.test.js +1 -1
  195. package/dist/packages/select/select.js +7 -7
  196. package/dist/packages/select/select.js.map +4 -4
  197. package/dist/packages/select/select.test.js +4 -2
  198. package/dist/packages/slider/slider.hydration.test.js +7 -2
  199. package/dist/packages/slider/slider.js +5 -5
  200. package/dist/packages/slider/slider.js.map +4 -4
  201. package/dist/packages/slider/slider.react.stories.js +2 -2
  202. package/dist/packages/slider/slider.test.js +1 -1
  203. package/dist/packages/slider-thumb/slider-thumb.hydration.test.js +1 -1
  204. package/dist/packages/slider-thumb/slider-thumb.js +20 -20
  205. package/dist/packages/slider-thumb/slider-thumb.js.map +4 -4
  206. package/dist/packages/step/step.hydration.test.js +1 -1
  207. package/dist/packages/step/step.js +8 -8
  208. package/dist/packages/step/step.js.map +4 -4
  209. package/dist/packages/step-indicator/step-indicator.hydration.test.js +1 -1
  210. package/dist/packages/switch/switch.a11y.test.js +1 -1
  211. package/dist/packages/switch/switch.hydration.test.js +1 -1
  212. package/dist/packages/switch/switch.js +1 -1
  213. package/dist/packages/switch/switch.js.map +1 -1
  214. package/dist/packages/tab/tab.hydration.test.js +1 -1
  215. package/dist/packages/tab/tab.js +10 -10
  216. package/dist/packages/tab/tab.js.map +2 -2
  217. package/dist/packages/tab-panel/tab-panel.hydration.test.js +1 -1
  218. package/dist/packages/tab-panel/tab-panel.js +3 -3
  219. package/dist/packages/tab-panel/tab-panel.js.map +2 -2
  220. package/dist/packages/tabs/tabs.a11y.test.js +2 -2
  221. package/dist/packages/tabs/tabs.hydration.test.js +1 -1
  222. package/dist/packages/tabs/tabs.js +1 -1
  223. package/dist/packages/tabs/tabs.js.map +2 -2
  224. package/dist/packages/tabs/tabs.test.js +4 -4
  225. package/dist/packages/textarea/textarea.hydration.test.js +1 -1
  226. package/dist/packages/textarea/textarea.js +4 -4
  227. package/dist/packages/textarea/textarea.js.map +3 -3
  228. package/dist/packages/textarea/textarea.test.js +1 -1
  229. package/dist/packages/textfield/textfield.hydration.test.js +1 -1
  230. package/dist/packages/textfield/textfield.js +1 -1
  231. package/dist/packages/textfield/textfield.js.map +1 -1
  232. package/dist/packages/textfield/textfield.test.js +1 -1
  233. package/dist/packages/toast/toast.js +6 -6
  234. package/dist/packages/toast/toast.js.map +4 -4
  235. package/dist/packages/toast/toast.stories.d.ts +1 -5
  236. package/dist/packages/toast/toast.stories.js +0 -17
  237. package/dist/packages/toast-container/toast-container.js +2 -2
  238. package/dist/packages/toast-container/toast-container.js.map +2 -2
  239. package/dist/web-types.json +238 -103
  240. package/eik/index.js +2536 -0
  241. package/package.json +15 -9
  242. package/dist/docs/modal-footer/accessibility.md +0 -1
  243. package/dist/docs/modal-footer/examples.md +0 -1
  244. package/dist/docs/modal-footer/usage.md +0 -1
  245. package/dist/docs/modal-header/accessibility.md +0 -1
  246. package/dist/docs/modal-header/examples.md +0 -1
  247. package/dist/docs/modal-header/usage.md +0 -1
  248. package/dist/docs/radio/accessibility.md +0 -1
  249. package/dist/docs/radio/examples.md +0 -1
  250. package/dist/docs/radio/usage.md +0 -1
  251. package/dist/packages/button/styles/w-button.styles.d.ts +0 -1
  252. package/dist/packages/button/styles/w-button.styles.js +0 -282
  253. package/dist/packages/link/styles/w-link.styles.d.ts +0 -1
  254. package/dist/packages/link/styles/w-link.styles.js +0 -213
@@ -9,7 +9,7 @@
9
9
  {
10
10
  "kind": "class",
11
11
  "description": "",
12
- "name": "WIcon",
12
+ "name": "WarpIcon",
13
13
  "members": [
14
14
  {
15
15
  "kind": "field",
@@ -25,11 +25,15 @@
25
25
  "kind": "field",
26
26
  "name": "size",
27
27
  "type": {
28
- "text": "'small' | 'medium' | 'large' | string"
28
+ "text": "'small' | 'medium' | 'large' | PixelValue"
29
29
  },
30
- "description": "Size: small, medium, large or pixel value (e.g. \"32px\")",
30
+ "description": "Size: small, medium, large or pixel value (e.g. \"32px\").",
31
+ "default": "\"medium\"",
31
32
  "attribute": "size",
32
- "reflects": true
33
+ "reflects": true,
34
+ "parsedType": {
35
+ "text": "'small' | 'medium' | 'large' | `${number}px`"
36
+ }
33
37
  },
34
38
  {
35
39
  "kind": "field",
@@ -37,7 +41,7 @@
37
41
  "type": {
38
42
  "text": "string"
39
43
  },
40
- "description": "Locale used in CDN URL",
44
+ "description": "Locale used for `<title>` text.\n\nReads the `lang` attribute from `<html>`, falls back to 'en'.",
41
45
  "attribute": "locale",
42
46
  "reflects": true
43
47
  },
@@ -94,17 +98,21 @@
94
98
  {
95
99
  "name": "size",
96
100
  "type": {
97
- "text": "'small' | 'medium' | 'large' | string"
101
+ "text": "'small' | 'medium' | 'large' | PixelValue"
98
102
  },
99
- "description": "Size: small, medium, large or pixel value (e.g. \"32px\")",
100
- "fieldName": "size"
103
+ "description": "Size: small, medium, large or pixel value (e.g. \"32px\").",
104
+ "default": "\"medium\"",
105
+ "fieldName": "size",
106
+ "parsedType": {
107
+ "text": "'small' | 'medium' | 'large' | `${number}px`"
108
+ }
101
109
  },
102
110
  {
103
111
  "name": "locale",
104
112
  "type": {
105
113
  "text": "string"
106
114
  },
107
- "description": "Locale used in CDN URL",
115
+ "description": "Locale used for `<title>` text.\n\nReads the `lang` attribute from `<html>`, falls back to 'en'.",
108
116
  "fieldName": "locale"
109
117
  }
110
118
  ],
@@ -116,9 +124,23 @@
116
124
  "customElement": true,
117
125
  "modulePath": "packages/icon/icon.ts",
118
126
  "definitionPath": "packages/icon/icon.ts"
127
+ },
128
+ {
129
+ "kind": "variable",
130
+ "name": "WIcon",
131
+ "default": "WarpIcon",
132
+ "deprecated": "Exported for backwards compatibility. Use WarpIcon."
119
133
  }
120
134
  ],
121
135
  "exports": [
136
+ {
137
+ "kind": "js",
138
+ "name": "WarpIcon",
139
+ "declaration": {
140
+ "name": "WarpIcon",
141
+ "module": "packages/icon/icon.ts"
142
+ }
143
+ },
122
144
  {
123
145
  "kind": "js",
124
146
  "name": "WIcon",
@@ -131,7 +153,7 @@
131
153
  "kind": "custom-element-definition",
132
154
  "name": "w-icon",
133
155
  "declaration": {
134
- "name": "WIcon",
156
+ "name": "WarpIcon",
135
157
  "module": "packages/icon/icon.ts"
136
158
  }
137
159
  }
@@ -942,15 +964,6 @@
942
964
  "description": "Buttons are used to perform actions, with different visuals for different needs.\n\n[See Storybook for usage examples](https://warp-ds.github.io/elements/?path=/docs/buttons-link--docs)",
943
965
  "name": "WarpLink",
944
966
  "members": [
945
- {
946
- "kind": "field",
947
- "name": "shadowRootOptions",
948
- "type": {
949
- "text": "object"
950
- },
951
- "static": true,
952
- "default": "{ ...LitElement.shadowRootOptions, delegatesFocus: true, }"
953
- },
954
967
  {
955
968
  "kind": "field",
956
969
  "name": "autofocus",
@@ -958,6 +971,7 @@
958
971
  "text": "boolean"
959
972
  },
960
973
  "default": "false",
974
+ "description": "Focus the link after it is rendered",
961
975
  "attribute": "autofocus",
962
976
  "reflects": true
963
977
  },
@@ -967,6 +981,7 @@
967
981
  "type": {
968
982
  "text": "ButtonVariant"
969
983
  },
984
+ "description": "Visual style for the link/button.",
970
985
  "attribute": "variant",
971
986
  "reflects": true,
972
987
  "parsedType": {
@@ -980,6 +995,7 @@
980
995
  "text": "boolean"
981
996
  },
982
997
  "default": "false",
998
+ "description": "Render a smaller version",
983
999
  "attribute": "small",
984
1000
  "reflects": true
985
1001
  },
@@ -989,6 +1005,7 @@
989
1005
  "type": {
990
1006
  "text": "string"
991
1007
  },
1008
+ "description": "The URL the link points to",
992
1009
  "attribute": "href",
993
1010
  "reflects": true
994
1011
  },
@@ -999,6 +1016,7 @@
999
1016
  "text": "boolean"
1000
1017
  },
1001
1018
  "default": "false",
1019
+ "description": "Applies disabled styling, but you need to disable clicks on your own.\n\nThe component renders an `<a>` element; `disabled` affects styling, but does not inherently prevent navigation. If you need to fully disable interaction, omit `href` and/or prevent default click behavior.",
1002
1020
  "attribute": "disabled",
1003
1021
  "reflects": true
1004
1022
  },
@@ -1008,6 +1026,7 @@
1008
1026
  "type": {
1009
1027
  "text": "string"
1010
1028
  },
1029
+ "description": "Where to display the linked URL (e.g. `_blank`)",
1011
1030
  "attribute": "target",
1012
1031
  "reflects": true
1013
1032
  },
@@ -1017,6 +1036,7 @@
1017
1036
  "type": {
1018
1037
  "text": "string"
1019
1038
  },
1039
+ "description": "Relationship of the linked URL.\n\nIf `target=\"_blank\"` and `rel` is not provided, the component uses `noopener`.",
1020
1040
  "attribute": "rel",
1021
1041
  "reflects": true
1022
1042
  },
@@ -1027,6 +1047,7 @@
1027
1047
  "text": "boolean"
1028
1048
  },
1029
1049
  "default": "false",
1050
+ "description": "Makes the link take up the full width of its parent",
1030
1051
  "attribute": "full-width",
1031
1052
  "reflects": true
1032
1053
  }
@@ -1038,6 +1059,7 @@
1038
1059
  "text": "boolean"
1039
1060
  },
1040
1061
  "default": "false",
1062
+ "description": "Focus the link after it is rendered",
1041
1063
  "fieldName": "autofocus"
1042
1064
  },
1043
1065
  {
@@ -1045,6 +1067,7 @@
1045
1067
  "type": {
1046
1068
  "text": "ButtonVariant"
1047
1069
  },
1070
+ "description": "Visual style for the link/button.",
1048
1071
  "fieldName": "variant",
1049
1072
  "parsedType": {
1050
1073
  "text": "'negative' | 'primary' | 'secondary' | 'negativeQuiet' | 'utility' | 'quiet' | 'utilityQuiet' | 'overlay' | 'overlayInverted' | 'overlayQuiet' | 'overlayInvertedQuiet'"
@@ -1056,6 +1079,7 @@
1056
1079
  "text": "boolean"
1057
1080
  },
1058
1081
  "default": "false",
1082
+ "description": "Render a smaller version",
1059
1083
  "fieldName": "small"
1060
1084
  },
1061
1085
  {
@@ -1063,6 +1087,7 @@
1063
1087
  "type": {
1064
1088
  "text": "string"
1065
1089
  },
1090
+ "description": "The URL the link points to",
1066
1091
  "fieldName": "href"
1067
1092
  },
1068
1093
  {
@@ -1071,6 +1096,7 @@
1071
1096
  "text": "boolean"
1072
1097
  },
1073
1098
  "default": "false",
1099
+ "description": "Applies disabled styling, but you need to disable clicks on your own.\n\nThe component renders an `<a>` element; `disabled` affects styling, but does not inherently prevent navigation. If you need to fully disable interaction, omit `href` and/or prevent default click behavior.",
1074
1100
  "fieldName": "disabled"
1075
1101
  },
1076
1102
  {
@@ -1078,6 +1104,7 @@
1078
1104
  "type": {
1079
1105
  "text": "string"
1080
1106
  },
1107
+ "description": "Where to display the linked URL (e.g. `_blank`)",
1081
1108
  "fieldName": "target"
1082
1109
  },
1083
1110
  {
@@ -1085,6 +1112,7 @@
1085
1112
  "type": {
1086
1113
  "text": "string"
1087
1114
  },
1115
+ "description": "Relationship of the linked URL.\n\nIf `target=\"_blank\"` and `rel` is not provided, the component uses `noopener`.",
1088
1116
  "fieldName": "rel"
1089
1117
  },
1090
1118
  {
@@ -1093,6 +1121,7 @@
1093
1121
  "text": "boolean"
1094
1122
  },
1095
1123
  "default": "false",
1124
+ "description": "Makes the link take up the full width of its parent",
1096
1125
  "fieldName": "fullWidth"
1097
1126
  }
1098
1127
  ],
@@ -2235,6 +2264,7 @@
2235
2264
  "text": "boolean"
2236
2265
  },
2237
2266
  "default": "false",
2267
+ "description": "Whether the card is visually selected.\n\nUse this when the card represents a selected item or choice. This only controls the visual selected state; update it from your application state when the selection changes.",
2238
2268
  "attribute": "selected",
2239
2269
  "reflects": true
2240
2270
  },
@@ -2245,6 +2275,7 @@
2245
2275
  "text": "boolean"
2246
2276
  },
2247
2277
  "default": "false",
2278
+ "description": "Whether the card uses the flat visual treatment.\n\nFlat cards use a bordered surface instead of the default elevated surface. Use this for denser layouts or when the card sits inside another surface.",
2248
2279
  "attribute": "flat"
2249
2280
  },
2250
2281
  {
@@ -2254,6 +2285,7 @@
2254
2285
  "text": "boolean"
2255
2286
  },
2256
2287
  "default": "false",
2288
+ "description": "Whether the whole card is interactive.\n\nWhen set, the card becomes keyboard focusable and Enter or Space triggers a click on the card. Use this only when the whole card has one action or represents one selectable choice.",
2257
2289
  "attribute": "clickable"
2258
2290
  },
2259
2291
  {
@@ -2283,6 +2315,7 @@
2283
2315
  "text": "boolean"
2284
2316
  },
2285
2317
  "default": "false",
2318
+ "description": "Whether the card is visually selected.\n\nUse this when the card represents a selected item or choice. This only controls the visual selected state; update it from your application state when the selection changes.",
2286
2319
  "fieldName": "selected"
2287
2320
  },
2288
2321
  {
@@ -2291,6 +2324,7 @@
2291
2324
  "text": "boolean"
2292
2325
  },
2293
2326
  "default": "false",
2327
+ "description": "Whether the card uses the flat visual treatment.\n\nFlat cards use a bordered surface instead of the default elevated surface. Use this for denser layouts or when the card sits inside another surface.",
2294
2328
  "fieldName": "flat"
2295
2329
  },
2296
2330
  {
@@ -2299,6 +2333,7 @@
2299
2333
  "text": "boolean"
2300
2334
  },
2301
2335
  "default": "false",
2336
+ "description": "Whether the whole card is interactive.\n\nWhen set, the card becomes keyboard focusable and Enter or Space triggers a click on the card. Use this only when the whole card has one action or represents one selectable choice.",
2302
2337
  "fieldName": "clickable"
2303
2338
  }
2304
2339
  ],
@@ -2338,7 +2373,7 @@
2338
2373
  {
2339
2374
  "kind": "class",
2340
2375
  "description": "",
2341
- "name": "WCheckbox",
2376
+ "name": "WarpCheckbox",
2342
2377
  "members": [
2343
2378
  {
2344
2379
  "kind": "field",
@@ -2359,7 +2394,7 @@
2359
2394
  {
2360
2395
  "kind": "field",
2361
2396
  "name": "name",
2362
- "description": "The name of the checkbox, submitted as a name/value pair with form data.",
2397
+ "description": "The name of the checkbox.\n\nWhen the checkbox is checked and belongs to a form, this name is submitted with the checkbox value. If the checkbox is inside a `w-checkbox-group` with a name, the group name is used when the checkbox does not have its own name.",
2363
2398
  "type": {
2364
2399
  "text": "string | undefined"
2365
2400
  },
@@ -2381,7 +2416,7 @@
2381
2416
  "text": "string | null"
2382
2417
  },
2383
2418
  "default": "null",
2384
- "description": "The value of the checkbox, submitted as a name/value pair with form data.",
2419
+ "description": "The value submitted when the checkbox is checked.\n\nIf no value attribute is set, the checkbox defaults to `on`. Unchecked and disabled checkboxes do not submit a value.",
2385
2420
  "attribute": "value",
2386
2421
  "reflects": true
2387
2422
  },
@@ -2392,7 +2427,7 @@
2392
2427
  "text": "boolean"
2393
2428
  },
2394
2429
  "default": "false",
2395
- "description": "Draws the checkbox in an indeterminate state.",
2430
+ "description": "Whether the checkbox is visually indeterminate.\n\nUse this for parent options that represent a mixed set of child selections. Clicking the checkbox clears the indeterminate state and sets the checkbox to checked.",
2396
2431
  "attribute": "indeterminate",
2397
2432
  "reflects": true
2398
2433
  },
@@ -2403,7 +2438,7 @@
2403
2438
  "text": "boolean"
2404
2439
  },
2405
2440
  "default": "false",
2406
- "description": "Draws the checkbox in a checked state (reflected to attribute).",
2441
+ "description": "Whether the checkbox is checked.\n\nChecked checkboxes submit their value with form data. The property is reflected to the `checked` attribute.",
2407
2442
  "attribute": "checked",
2408
2443
  "reflects": true
2409
2444
  },
@@ -2414,7 +2449,7 @@
2414
2449
  "text": "boolean"
2415
2450
  },
2416
2451
  "default": "false",
2417
- "description": "Disables the checkbox.",
2452
+ "description": "Whether the checkbox is disabled.\n\nDisabled checkboxes cannot be focused, changed, or submitted with form data.",
2418
2453
  "attribute": "disabled",
2419
2454
  "reflects": true
2420
2455
  },
@@ -2425,7 +2460,7 @@
2425
2460
  "text": "boolean"
2426
2461
  },
2427
2462
  "default": "false",
2428
- "description": "Makes the checkbox a required field.",
2463
+ "description": "Whether the checkbox must be checked before form submission.\n\nA required checkbox is invalid until it is checked. For requiring at least one option in a set, use `required` on `w-checkbox-group`.",
2429
2464
  "attribute": "required",
2430
2465
  "reflects": true
2431
2466
  },
@@ -2436,10 +2471,28 @@
2436
2471
  "text": "boolean"
2437
2472
  },
2438
2473
  "default": "false",
2439
- "description": "Draws the checkbox in an invalid state.",
2474
+ "description": "Whether the checkbox is visually invalid.\n\nUse this to show an externally managed validation error. Required validation also sets the invalid state after the user interacts with the checkbox or tries to submit the form.",
2440
2475
  "attribute": "invalid",
2441
2476
  "reflects": true
2442
2477
  },
2478
+ {
2479
+ "kind": "field",
2480
+ "name": "_groupInvalid",
2481
+ "type": {
2482
+ "text": "boolean | undefined"
2483
+ },
2484
+ "privacy": "private",
2485
+ "description": "Internal invalid state managed by parent checkbox-group.\nNon-reflecting to avoid DOM changes during hydration."
2486
+ },
2487
+ {
2488
+ "kind": "field",
2489
+ "name": "_groupName",
2490
+ "type": {
2491
+ "text": "string | undefined"
2492
+ },
2493
+ "privacy": "private",
2494
+ "description": "Internal name managed by parent checkbox-group.\nNon-reflecting to avoid DOM changes during hydration."
2495
+ },
2443
2496
  {
2444
2497
  "kind": "field",
2445
2498
  "name": "#defaultChecked",
@@ -2590,7 +2643,7 @@
2590
2643
  "attributes": [
2591
2644
  {
2592
2645
  "name": "name",
2593
- "description": "The name of the checkbox, submitted as a name/value pair with form data.",
2646
+ "description": "The name of the checkbox.\n\nWhen the checkbox is checked and belongs to a form, this name is submitted with the checkbox value. If the checkbox is inside a `w-checkbox-group` with a name, the group name is used when the checkbox does not have its own name.",
2594
2647
  "type": {
2595
2648
  "text": "string | undefined"
2596
2649
  },
@@ -2602,7 +2655,7 @@
2602
2655
  "text": "string | null"
2603
2656
  },
2604
2657
  "default": "null",
2605
- "description": "The value of the checkbox, submitted as a name/value pair with form data.",
2658
+ "description": "The value submitted when the checkbox is checked.\n\nIf no value attribute is set, the checkbox defaults to `on`. Unchecked and disabled checkboxes do not submit a value.",
2606
2659
  "fieldName": "value"
2607
2660
  },
2608
2661
  {
@@ -2611,7 +2664,7 @@
2611
2664
  "text": "boolean"
2612
2665
  },
2613
2666
  "default": "false",
2614
- "description": "Draws the checkbox in an indeterminate state.",
2667
+ "description": "Whether the checkbox is visually indeterminate.\n\nUse this for parent options that represent a mixed set of child selections. Clicking the checkbox clears the indeterminate state and sets the checkbox to checked.",
2615
2668
  "fieldName": "indeterminate"
2616
2669
  },
2617
2670
  {
@@ -2620,7 +2673,7 @@
2620
2673
  "text": "boolean"
2621
2674
  },
2622
2675
  "default": "false",
2623
- "description": "Draws the checkbox in a checked state (reflected to attribute).",
2676
+ "description": "Whether the checkbox is checked.\n\nChecked checkboxes submit their value with form data. The property is reflected to the `checked` attribute.",
2624
2677
  "fieldName": "checked"
2625
2678
  },
2626
2679
  {
@@ -2629,7 +2682,7 @@
2629
2682
  "text": "boolean"
2630
2683
  },
2631
2684
  "default": "false",
2632
- "description": "Disables the checkbox.",
2685
+ "description": "Whether the checkbox is disabled.\n\nDisabled checkboxes cannot be focused, changed, or submitted with form data.",
2633
2686
  "fieldName": "disabled"
2634
2687
  },
2635
2688
  {
@@ -2638,7 +2691,7 @@
2638
2691
  "text": "boolean"
2639
2692
  },
2640
2693
  "default": "false",
2641
- "description": "Makes the checkbox a required field.",
2694
+ "description": "Whether the checkbox must be checked before form submission.\n\nA required checkbox is invalid until it is checked. For requiring at least one option in a set, use `required` on `w-checkbox-group`.",
2642
2695
  "fieldName": "required"
2643
2696
  },
2644
2697
  {
@@ -2647,7 +2700,7 @@
2647
2700
  "text": "boolean"
2648
2701
  },
2649
2702
  "default": "false",
2650
- "description": "Draws the checkbox in an invalid state.",
2703
+ "description": "Whether the checkbox is visually invalid.\n\nUse this to show an externally managed validation error. Required validation also sets the invalid state after the user interacts with the checkbox or tries to submit the form.",
2651
2704
  "fieldName": "invalid"
2652
2705
  }
2653
2706
  ],
@@ -2661,13 +2714,31 @@
2661
2714
  "name": "LitElement",
2662
2715
  "package": "lit"
2663
2716
  },
2717
+ "parent": {
2718
+ "name": "w-checkbox-group",
2719
+ "description": ""
2720
+ },
2664
2721
  "tagName": "w-checkbox",
2665
2722
  "customElement": true,
2666
2723
  "modulePath": "packages/checkbox/checkbox.ts",
2667
2724
  "definitionPath": "packages/checkbox/checkbox.ts"
2725
+ },
2726
+ {
2727
+ "kind": "variable",
2728
+ "name": "WCheckbox",
2729
+ "default": "WarpCheckbox",
2730
+ "deprecated": "Use WarpCheckbox"
2668
2731
  }
2669
2732
  ],
2670
2733
  "exports": [
2734
+ {
2735
+ "kind": "js",
2736
+ "name": "WarpCheckbox",
2737
+ "declaration": {
2738
+ "name": "WarpCheckbox",
2739
+ "module": "packages/checkbox/checkbox.ts"
2740
+ }
2741
+ },
2671
2742
  {
2672
2743
  "kind": "js",
2673
2744
  "name": "WCheckbox",
@@ -2680,7 +2751,7 @@
2680
2751
  "kind": "custom-element-definition",
2681
2752
  "name": "w-checkbox",
2682
2753
  "declaration": {
2683
- "name": "WCheckbox",
2754
+ "name": "WarpCheckbox",
2684
2755
  "module": "packages/checkbox/checkbox.ts"
2685
2756
  }
2686
2757
  }
@@ -2693,7 +2764,7 @@
2693
2764
  {
2694
2765
  "kind": "class",
2695
2766
  "description": "",
2696
- "name": "WCheckboxGroup",
2767
+ "name": "WarpCheckboxGroup",
2697
2768
  "members": [
2698
2769
  {
2699
2770
  "kind": "field",
@@ -2710,7 +2781,7 @@
2710
2781
  "type": {
2711
2782
  "text": "string"
2712
2783
  },
2713
- "description": "The group label displayed above the checkboxes.",
2784
+ "description": "The group label displayed above the checkboxes.\n\nUse this to describe the shared question or topic for the checkbox options. The label is connected to the internal group for assistive technologies.",
2714
2785
  "attribute": "label",
2715
2786
  "reflects": true
2716
2787
  },
@@ -2720,7 +2791,7 @@
2720
2791
  "type": {
2721
2792
  "text": "string"
2722
2793
  },
2723
- "description": "The name applied to child checkboxes when they do not provide one.",
2794
+ "description": "The name applied to child checkboxes when they do not provide one.\n\nUse this when the grouped checkboxes should submit values under the same form field name. Individual checkboxes can still override the group name with their own `name`.",
2724
2795
  "attribute": "name",
2725
2796
  "reflects": true
2726
2797
  },
@@ -2731,7 +2802,7 @@
2731
2802
  "text": "boolean"
2732
2803
  },
2733
2804
  "default": "false",
2734
- "description": "Whether to show optional text next to the label.",
2805
+ "description": "Whether to show optional text next to the label.\n\nUse this to indicate that selecting an option from the group is not required.",
2735
2806
  "attribute": "optional",
2736
2807
  "reflects": true
2737
2808
  },
@@ -2741,6 +2812,7 @@
2741
2812
  "type": {
2742
2813
  "text": "string"
2743
2814
  },
2815
+ "description": "Help text displayed below the checkbox group.\n\nUse this for supporting guidance or validation feedback. When required validation fails, the group replaces this text with the localized required message.",
2744
2816
  "attribute": "help-text",
2745
2817
  "reflects": true
2746
2818
  },
@@ -2751,7 +2823,7 @@
2751
2823
  "text": "boolean"
2752
2824
  },
2753
2825
  "default": "false",
2754
- "description": "Makes the checkbox group required.",
2826
+ "description": "Whether at least one checkbox in the group must be selected.\n\nRequired validation is managed by the group. The individual checkboxes provide the submitted form values.",
2755
2827
  "attribute": "required",
2756
2828
  "reflects": true
2757
2829
  },
@@ -2762,7 +2834,7 @@
2762
2834
  "text": "boolean"
2763
2835
  },
2764
2836
  "default": "false",
2765
- "description": "Marks the checkbox group as invalid.",
2837
+ "description": "Whether the checkbox group is visually invalid.\n\nUse this to show an externally managed validation error for the group. The invalid state is also shared with child checkboxes for consistent styling and accessibility state.",
2766
2838
  "attribute": "invalid",
2767
2839
  "reflects": true
2768
2840
  },
@@ -3023,7 +3095,7 @@
3023
3095
  "type": {
3024
3096
  "text": "string"
3025
3097
  },
3026
- "description": "The group label displayed above the checkboxes.",
3098
+ "description": "The group label displayed above the checkboxes.\n\nUse this to describe the shared question or topic for the checkbox options. The label is connected to the internal group for assistive technologies.",
3027
3099
  "fieldName": "label"
3028
3100
  },
3029
3101
  {
@@ -3031,7 +3103,7 @@
3031
3103
  "type": {
3032
3104
  "text": "string"
3033
3105
  },
3034
- "description": "The name applied to child checkboxes when they do not provide one.",
3106
+ "description": "The name applied to child checkboxes when they do not provide one.\n\nUse this when the grouped checkboxes should submit values under the same form field name. Individual checkboxes can still override the group name with their own `name`.",
3035
3107
  "fieldName": "name"
3036
3108
  },
3037
3109
  {
@@ -3040,7 +3112,7 @@
3040
3112
  "text": "boolean"
3041
3113
  },
3042
3114
  "default": "false",
3043
- "description": "Whether to show optional text next to the label.",
3115
+ "description": "Whether to show optional text next to the label.\n\nUse this to indicate that selecting an option from the group is not required.",
3044
3116
  "fieldName": "optional"
3045
3117
  },
3046
3118
  {
@@ -3048,6 +3120,7 @@
3048
3120
  "type": {
3049
3121
  "text": "string"
3050
3122
  },
3123
+ "description": "Help text displayed below the checkbox group.\n\nUse this for supporting guidance or validation feedback. When required validation fails, the group replaces this text with the localized required message.",
3051
3124
  "fieldName": "helpText"
3052
3125
  },
3053
3126
  {
@@ -3056,7 +3129,7 @@
3056
3129
  "text": "boolean"
3057
3130
  },
3058
3131
  "default": "false",
3059
- "description": "Makes the checkbox group required.",
3132
+ "description": "Whether at least one checkbox in the group must be selected.\n\nRequired validation is managed by the group. The individual checkboxes provide the submitted form values.",
3060
3133
  "fieldName": "required"
3061
3134
  },
3062
3135
  {
@@ -3065,7 +3138,7 @@
3065
3138
  "text": "boolean"
3066
3139
  },
3067
3140
  "default": "false",
3068
- "description": "Marks the checkbox group as invalid.",
3141
+ "description": "Whether the checkbox group is visually invalid.\n\nUse this to show an externally managed validation error for the group. The invalid state is also shared with child checkboxes for consistent styling and accessibility state.",
3069
3142
  "fieldName": "invalid"
3070
3143
  }
3071
3144
  ],
@@ -3083,9 +3156,23 @@
3083
3156
  "customElement": true,
3084
3157
  "modulePath": "packages/checkbox-group/checkbox-group.ts",
3085
3158
  "definitionPath": "packages/checkbox-group/checkbox-group.ts"
3159
+ },
3160
+ {
3161
+ "kind": "variable",
3162
+ "name": "WCheckboxGroup",
3163
+ "default": "WarpCheckboxGroup",
3164
+ "deprecated": "Use WarpCheckboxGroup"
3086
3165
  }
3087
3166
  ],
3088
3167
  "exports": [
3168
+ {
3169
+ "kind": "js",
3170
+ "name": "WarpCheckboxGroup",
3171
+ "declaration": {
3172
+ "name": "WarpCheckboxGroup",
3173
+ "module": "packages/checkbox-group/checkbox-group.ts"
3174
+ }
3175
+ },
3089
3176
  {
3090
3177
  "kind": "js",
3091
3178
  "name": "WCheckboxGroup",
@@ -3098,7 +3185,7 @@
3098
3185
  "kind": "custom-element-definition",
3099
3186
  "name": "w-checkbox-group",
3100
3187
  "declaration": {
3101
- "name": "WCheckboxGroup",
3188
+ "name": "WarpCheckboxGroup",
3102
3189
  "module": "packages/checkbox-group/checkbox-group.ts"
3103
3190
  }
3104
3191
  }
@@ -3120,7 +3207,7 @@
3120
3207
  "text": "ComboboxOption[]"
3121
3208
  },
3122
3209
  "default": "[]",
3123
- "description": "The available options to select from",
3210
+ "description": "The available options to select from.\n\nUse this for framework usage, application state, or remote search results. When `options` contains entries, it is used instead of child `<option>` elements.",
3124
3211
  "attribute": "options"
3125
3212
  },
3126
3213
  {
@@ -3130,7 +3217,7 @@
3130
3217
  "text": "string | undefined"
3131
3218
  },
3132
3219
  "default": "''",
3133
- "description": "Label above input",
3220
+ "description": "The label displayed above the input.\n\nUse this to give the combobox a visible and accessible name.",
3134
3221
  "attribute": "label",
3135
3222
  "reflects": true
3136
3223
  },
@@ -3141,7 +3228,7 @@
3141
3228
  "text": "string | undefined"
3142
3229
  },
3143
3230
  "default": "''",
3144
- "description": "Input placeholder",
3231
+ "description": "Placeholder text displayed when the input is empty.\n\nUse this as a short hint for the expected input. Do not use placeholder text as a replacement for a label.",
3145
3232
  "attribute": "placeholder",
3146
3233
  "reflects": true
3147
3234
  },
@@ -3152,7 +3239,7 @@
3152
3239
  "text": "string"
3153
3240
  },
3154
3241
  "default": "''",
3155
- "description": "The input value",
3242
+ "description": "The selected or typed value.\n\nWhen an option is selected, this is set to the option value. The displayed text may differ when the option has a separate label.",
3156
3243
  "attribute": "value",
3157
3244
  "reflects": true
3158
3245
  },
@@ -3163,7 +3250,7 @@
3163
3250
  "text": "boolean"
3164
3251
  },
3165
3252
  "default": "false",
3166
- "description": "Whether the popover opens when focus is on the text field",
3253
+ "description": "Whether the option list opens when the input receives focus.\n\nUse this when users should see available options before they start typing.",
3167
3254
  "attribute": "open-on-focus",
3168
3255
  "reflects": true
3169
3256
  },
@@ -3174,7 +3261,7 @@
3174
3261
  "text": "boolean"
3175
3262
  },
3176
3263
  "default": "true",
3177
- "description": "Select active option on blur",
3264
+ "description": "Whether the active option is selected when the input loses focus.\n\nWhen enabled, the combobox selects the keyboard-highlighted option, or an option whose value exactly matches the current input value, on blur.",
3178
3265
  "attribute": "select-on-blur",
3179
3266
  "reflects": true
3180
3267
  },
@@ -3185,7 +3272,7 @@
3185
3272
  "text": "boolean"
3186
3273
  },
3187
3274
  "default": "false",
3188
- "description": "Whether the matching text segments in the options should be highlighted",
3275
+ "description": "Whether matching text segments in options are highlighted.\n\nUse this to visually emphasize the part of each option that matches the current input value.",
3189
3276
  "attribute": "match-text-segments",
3190
3277
  "reflects": true
3191
3278
  },
@@ -3196,7 +3283,7 @@
3196
3283
  "text": "boolean"
3197
3284
  },
3198
3285
  "default": "false",
3199
- "description": "Disable client-side static filtering",
3286
+ "description": "Whether built-in client-side filtering is disabled.\n\nUse this for remote search or externally filtered results. When disabled, all entries in `options` are rendered as provided.",
3200
3287
  "attribute": "disable-static-filtering",
3201
3288
  "reflects": true
3202
3289
  },
@@ -3207,7 +3294,7 @@
3207
3294
  "text": "boolean"
3208
3295
  },
3209
3296
  "default": "false",
3210
- "description": "Renders the input field in an invalid state",
3297
+ "description": "Whether the combobox is visually invalid.\n\nUse this to show an externally managed validation error. Pair it with `help-text` to explain how to fix the error.",
3211
3298
  "attribute": "invalid",
3212
3299
  "reflects": true
3213
3300
  },
@@ -3218,7 +3305,7 @@
3218
3305
  "text": "string | undefined"
3219
3306
  },
3220
3307
  "default": "''",
3221
- "description": "The content to display as the help text",
3308
+ "description": "Help text displayed below the input.\n\nUse this for supporting guidance or validation feedback.",
3222
3309
  "attribute": "help-text",
3223
3310
  "reflects": true
3224
3311
  },
@@ -3229,7 +3316,7 @@
3229
3316
  "text": "boolean"
3230
3317
  },
3231
3318
  "default": "false",
3232
- "description": "Whether the element is disabled",
3319
+ "description": "Whether the combobox is disabled.\n\nDisabled comboboxes cannot be focused, changed, or submitted with form data.",
3233
3320
  "attribute": "disabled",
3234
3321
  "reflects": true
3235
3322
  },
@@ -3240,7 +3327,7 @@
3240
3327
  "text": "boolean"
3241
3328
  },
3242
3329
  "default": "false",
3243
- "description": "Whether the element is required",
3330
+ "description": "Whether the combobox is required before form submission.\n\nUse this when the user must provide a value before submitting the form.",
3244
3331
  "attribute": "required",
3245
3332
  "reflects": true
3246
3333
  },
@@ -3251,7 +3338,7 @@
3251
3338
  "text": "boolean"
3252
3339
  },
3253
3340
  "default": "false",
3254
- "description": "Whether to show optional text",
3341
+ "description": "Whether to show optional text next to the label.\n\nUse this to indicate that the combobox is not required.",
3255
3342
  "attribute": "optional",
3256
3343
  "reflects": true
3257
3344
  },
@@ -3262,7 +3349,7 @@
3262
3349
  "text": "string | undefined"
3263
3350
  },
3264
3351
  "default": "''",
3265
- "description": "Name attribute for form submission",
3352
+ "description": "The name submitted with the combobox value.\n\nUse this when the combobox belongs to a form and its value should be included in form data.",
3266
3353
  "attribute": "name",
3267
3354
  "reflects": true
3268
3355
  },
@@ -3273,7 +3360,7 @@
3273
3360
  "text": "string | undefined"
3274
3361
  },
3275
3362
  "default": "'off'",
3276
- "description": "Autocomplete attribute for the input field",
3363
+ "description": "The autocomplete attribute passed to the internal input.\n\nDefaults to `off`. Set this when browser autocomplete should be enabled or scoped to a specific autocomplete token.",
3277
3364
  "attribute": "autocomplete",
3278
3365
  "reflects": true
3279
3366
  },
@@ -3286,6 +3373,14 @@
3286
3373
  },
3287
3374
  "default": "null"
3288
3375
  },
3376
+ {
3377
+ "kind": "field",
3378
+ "name": "#lightDomObserver",
3379
+ "privacy": "private",
3380
+ "type": {
3381
+ "text": "MutationObserver | undefined"
3382
+ }
3383
+ },
3289
3384
  {
3290
3385
  "kind": "method",
3291
3386
  "name": "resetFormControl",
@@ -3316,6 +3411,12 @@
3316
3411
  "privacy": "private",
3317
3412
  "readonly": true
3318
3413
  },
3414
+ {
3415
+ "kind": "field",
3416
+ "name": "_sourceOptions",
3417
+ "privacy": "private",
3418
+ "readonly": true
3419
+ },
3319
3420
  {
3320
3421
  "kind": "field",
3321
3422
  "name": "_navigationLabelOrDisplayValue",
@@ -3355,6 +3456,16 @@
3355
3456
  ],
3356
3457
  "description": "Generate options with unique IDs and match information"
3357
3458
  },
3459
+ {
3460
+ "kind": "method",
3461
+ "name": "#getOptionNodes",
3462
+ "privacy": "private"
3463
+ },
3464
+ {
3465
+ "kind": "method",
3466
+ "name": "#syncOptionsFromLightDom",
3467
+ "privacy": "private"
3468
+ },
3358
3469
  {
3359
3470
  "kind": "method",
3360
3471
  "name": "_getAriaText",
@@ -3533,7 +3644,7 @@
3533
3644
  "text": "ComboboxOption[]"
3534
3645
  },
3535
3646
  "default": "[]",
3536
- "description": "The available options to select from",
3647
+ "description": "The available options to select from.\n\nUse this for framework usage, application state, or remote search results. When `options` contains entries, it is used instead of child `<option>` elements.",
3537
3648
  "fieldName": "options"
3538
3649
  },
3539
3650
  {
@@ -3542,7 +3653,7 @@
3542
3653
  "text": "string | undefined"
3543
3654
  },
3544
3655
  "default": "''",
3545
- "description": "Label above input",
3656
+ "description": "The label displayed above the input.\n\nUse this to give the combobox a visible and accessible name.",
3546
3657
  "fieldName": "label"
3547
3658
  },
3548
3659
  {
@@ -3551,7 +3662,7 @@
3551
3662
  "text": "string | undefined"
3552
3663
  },
3553
3664
  "default": "''",
3554
- "description": "Input placeholder",
3665
+ "description": "Placeholder text displayed when the input is empty.\n\nUse this as a short hint for the expected input. Do not use placeholder text as a replacement for a label.",
3555
3666
  "fieldName": "placeholder"
3556
3667
  },
3557
3668
  {
@@ -3560,7 +3671,7 @@
3560
3671
  "text": "string"
3561
3672
  },
3562
3673
  "default": "''",
3563
- "description": "The input value",
3674
+ "description": "The selected or typed value.\n\nWhen an option is selected, this is set to the option value. The displayed text may differ when the option has a separate label.",
3564
3675
  "fieldName": "value"
3565
3676
  },
3566
3677
  {
@@ -3569,7 +3680,7 @@
3569
3680
  "text": "boolean"
3570
3681
  },
3571
3682
  "default": "false",
3572
- "description": "Whether the popover opens when focus is on the text field",
3683
+ "description": "Whether the option list opens when the input receives focus.\n\nUse this when users should see available options before they start typing.",
3573
3684
  "fieldName": "openOnFocus"
3574
3685
  },
3575
3686
  {
@@ -3578,7 +3689,7 @@
3578
3689
  "text": "boolean"
3579
3690
  },
3580
3691
  "default": "true",
3581
- "description": "Select active option on blur",
3692
+ "description": "Whether the active option is selected when the input loses focus.\n\nWhen enabled, the combobox selects the keyboard-highlighted option, or an option whose value exactly matches the current input value, on blur.",
3582
3693
  "fieldName": "selectOnBlur"
3583
3694
  },
3584
3695
  {
@@ -3587,7 +3698,7 @@
3587
3698
  "text": "boolean"
3588
3699
  },
3589
3700
  "default": "false",
3590
- "description": "Whether the matching text segments in the options should be highlighted",
3701
+ "description": "Whether matching text segments in options are highlighted.\n\nUse this to visually emphasize the part of each option that matches the current input value.",
3591
3702
  "fieldName": "matchTextSegments"
3592
3703
  },
3593
3704
  {
@@ -3596,7 +3707,7 @@
3596
3707
  "text": "boolean"
3597
3708
  },
3598
3709
  "default": "false",
3599
- "description": "Disable client-side static filtering",
3710
+ "description": "Whether built-in client-side filtering is disabled.\n\nUse this for remote search or externally filtered results. When disabled, all entries in `options` are rendered as provided.",
3600
3711
  "fieldName": "disableStaticFiltering"
3601
3712
  },
3602
3713
  {
@@ -3605,7 +3716,7 @@
3605
3716
  "text": "boolean"
3606
3717
  },
3607
3718
  "default": "false",
3608
- "description": "Renders the input field in an invalid state",
3719
+ "description": "Whether the combobox is visually invalid.\n\nUse this to show an externally managed validation error. Pair it with `help-text` to explain how to fix the error.",
3609
3720
  "fieldName": "invalid"
3610
3721
  },
3611
3722
  {
@@ -3614,7 +3725,7 @@
3614
3725
  "text": "string | undefined"
3615
3726
  },
3616
3727
  "default": "''",
3617
- "description": "The content to display as the help text",
3728
+ "description": "Help text displayed below the input.\n\nUse this for supporting guidance or validation feedback.",
3618
3729
  "fieldName": "helpText"
3619
3730
  },
3620
3731
  {
@@ -3623,7 +3734,7 @@
3623
3734
  "text": "boolean"
3624
3735
  },
3625
3736
  "default": "false",
3626
- "description": "Whether the element is disabled",
3737
+ "description": "Whether the combobox is disabled.\n\nDisabled comboboxes cannot be focused, changed, or submitted with form data.",
3627
3738
  "fieldName": "disabled"
3628
3739
  },
3629
3740
  {
@@ -3632,7 +3743,7 @@
3632
3743
  "text": "boolean"
3633
3744
  },
3634
3745
  "default": "false",
3635
- "description": "Whether the element is required",
3746
+ "description": "Whether the combobox is required before form submission.\n\nUse this when the user must provide a value before submitting the form.",
3636
3747
  "fieldName": "required"
3637
3748
  },
3638
3749
  {
@@ -3641,7 +3752,7 @@
3641
3752
  "text": "boolean"
3642
3753
  },
3643
3754
  "default": "false",
3644
- "description": "Whether to show optional text",
3755
+ "description": "Whether to show optional text next to the label.\n\nUse this to indicate that the combobox is not required.",
3645
3756
  "fieldName": "optional"
3646
3757
  },
3647
3758
  {
@@ -3650,7 +3761,7 @@
3650
3761
  "text": "string | undefined"
3651
3762
  },
3652
3763
  "default": "''",
3653
- "description": "Name attribute for form submission",
3764
+ "description": "The name submitted with the combobox value.\n\nUse this when the combobox belongs to a form and its value should be included in form data.",
3654
3765
  "fieldName": "name"
3655
3766
  },
3656
3767
  {
@@ -3659,7 +3770,7 @@
3659
3770
  "text": "string | undefined"
3660
3771
  },
3661
3772
  "default": "'off'",
3662
- "description": "Autocomplete attribute for the input field",
3773
+ "description": "The autocomplete attribute passed to the internal input.\n\nDefaults to `off`. Set this when browser autocomplete should be enabled or scoped to a specific autocomplete token.",
3663
3774
  "fieldName": "autocomplete"
3664
3775
  }
3665
3776
  ],
@@ -3722,6 +3833,7 @@
3722
3833
  "type": {
3723
3834
  "text": "string"
3724
3835
  },
3836
+ "description": "The label displayed above the date input.\n\nUse this to give the datepicker a visible and accessible name.",
3725
3837
  "attribute": "label",
3726
3838
  "reflects": true
3727
3839
  },
@@ -3731,7 +3843,7 @@
3731
3843
  "type": {
3732
3844
  "text": "string"
3733
3845
  },
3734
- "description": "Takes precedence over the `<html>` lang attribute.",
3846
+ "description": "The locale used for calendar labels and date formatting.\n\nThis takes precedence over the `<html>` `lang` attribute. Supported built-in locales are `en`, `nb`, `sv`, `da`, and `fi`.",
3735
3847
  "attribute": "lang",
3736
3848
  "reflects": true
3737
3849
  },
@@ -3741,6 +3853,7 @@
3741
3853
  "type": {
3742
3854
  "text": "string"
3743
3855
  },
3856
+ "description": "The name submitted with the date value.\n\nUse this when the datepicker belongs to a form and its value should be included in form data.",
3744
3857
  "attribute": "name",
3745
3858
  "reflects": true
3746
3859
  },
@@ -3750,6 +3863,7 @@
3750
3863
  "type": {
3751
3864
  "text": "string"
3752
3865
  },
3866
+ "description": "The selected date value.\n\nUse an ISO date string in `YYYY-MM-DD` format. The value is submitted with the form and is reset to its initial value when the form resets.",
3753
3867
  "attribute": "value",
3754
3868
  "reflects": true
3755
3869
  },
@@ -3760,7 +3874,7 @@
3760
3874
  "text": "string"
3761
3875
  },
3762
3876
  "default": "'MMMM yyyy'",
3763
- "description": "Decides the format of the date as shown in the calendar header.\n\nThe syntax is defined by [date-fns/format](https://date-fns.org/v4.1.0/docs/format).",
3877
+ "description": "The date format used in the calendar header.\n\nThe syntax is defined by [date-fns/format](https://date-fns.org/v4.1.0/docs/format).",
3764
3878
  "attribute": "header-format"
3765
3879
  },
3766
3880
  {
@@ -3770,7 +3884,7 @@
3770
3884
  "text": "string"
3771
3885
  },
3772
3886
  "default": "'EEEEEE'",
3773
- "description": "Decides the format of the weekday as shown above the grid of dates in the calendar.\n\nThe syntax is defined by [date-fns/format](https://date-fns.org/v4.1.0/docs/format).",
3887
+ "description": "The weekday format shown above the calendar grid.\n\nThe syntax is defined by [date-fns/format](https://date-fns.org/v4.1.0/docs/format).",
3774
3888
  "attribute": "weekday-format"
3775
3889
  },
3776
3890
  {
@@ -3779,7 +3893,7 @@
3779
3893
  "type": {
3780
3894
  "text": "(day: Date) => boolean"
3781
3895
  },
3782
- "description": "Lets you control if a date in the calendar should be disabled.\n\nThis needs to be set on the element instance in JavaScript, not as an HTML attribute."
3896
+ "description": "Function used to disable dates in the calendar.\n\nSet this on the element instance in JavaScript, not as an HTML attribute. Disabled dates cannot be selected from the calendar."
3783
3897
  },
3784
3898
  {
3785
3899
  "kind": "field",
@@ -3788,7 +3902,7 @@
3788
3902
  "text": "string"
3789
3903
  },
3790
3904
  "default": "'PPPP'",
3791
- "description": "Decides the format of the day in the calendar as read to screen readers.\n\nThe syntax is defined by [date-fns/format](https://date-fns.org/v4.1.0/docs/format).",
3905
+ "description": "The date format used for calendar day accessible names.\n\nThe syntax is defined by [date-fns/format](https://date-fns.org/v4.1.0/docs/format).",
3792
3906
  "attribute": "day-format"
3793
3907
  },
3794
3908
  {
@@ -3995,6 +4109,7 @@
3995
4109
  "type": {
3996
4110
  "text": "string"
3997
4111
  },
4112
+ "description": "The label displayed above the date input.\n\nUse this to give the datepicker a visible and accessible name.",
3998
4113
  "fieldName": "label"
3999
4114
  },
4000
4115
  {
@@ -4002,7 +4117,7 @@
4002
4117
  "type": {
4003
4118
  "text": "string"
4004
4119
  },
4005
- "description": "Takes precedence over the `<html>` lang attribute.",
4120
+ "description": "The locale used for calendar labels and date formatting.\n\nThis takes precedence over the `<html>` `lang` attribute. Supported built-in locales are `en`, `nb`, `sv`, `da`, and `fi`.",
4006
4121
  "fieldName": "lang"
4007
4122
  },
4008
4123
  {
@@ -4010,6 +4125,7 @@
4010
4125
  "type": {
4011
4126
  "text": "string"
4012
4127
  },
4128
+ "description": "The name submitted with the date value.\n\nUse this when the datepicker belongs to a form and its value should be included in form data.",
4013
4129
  "fieldName": "name"
4014
4130
  },
4015
4131
  {
@@ -4017,6 +4133,7 @@
4017
4133
  "type": {
4018
4134
  "text": "string"
4019
4135
  },
4136
+ "description": "The selected date value.\n\nUse an ISO date string in `YYYY-MM-DD` format. The value is submitted with the form and is reset to its initial value when the form resets.",
4020
4137
  "fieldName": "value"
4021
4138
  },
4022
4139
  {
@@ -4025,7 +4142,7 @@
4025
4142
  "text": "string"
4026
4143
  },
4027
4144
  "default": "'MMMM yyyy'",
4028
- "description": "Decides the format of the date as shown in the calendar header.\n\nThe syntax is defined by [date-fns/format](https://date-fns.org/v4.1.0/docs/format).",
4145
+ "description": "The date format used in the calendar header.\n\nThe syntax is defined by [date-fns/format](https://date-fns.org/v4.1.0/docs/format).",
4029
4146
  "fieldName": "headerFormat"
4030
4147
  },
4031
4148
  {
@@ -4034,7 +4151,7 @@
4034
4151
  "text": "string"
4035
4152
  },
4036
4153
  "default": "'EEEEEE'",
4037
- "description": "Decides the format of the weekday as shown above the grid of dates in the calendar.\n\nThe syntax is defined by [date-fns/format](https://date-fns.org/v4.1.0/docs/format).",
4154
+ "description": "The weekday format shown above the calendar grid.\n\nThe syntax is defined by [date-fns/format](https://date-fns.org/v4.1.0/docs/format).",
4038
4155
  "fieldName": "weekdayFormat"
4039
4156
  },
4040
4157
  {
@@ -4043,7 +4160,7 @@
4043
4160
  "text": "string"
4044
4161
  },
4045
4162
  "default": "'PPPP'",
4046
- "description": "Decides the format of the day in the calendar as read to screen readers.\n\nThe syntax is defined by [date-fns/format](https://date-fns.org/v4.1.0/docs/format).",
4163
+ "description": "The date format used for calendar day accessible names.\n\nThe syntax is defined by [date-fns/format](https://date-fns.org/v4.1.0/docs/format).",
4047
4164
  "fieldName": "dayFormat"
4048
4165
  }
4049
4166
  ],
@@ -4088,7 +4205,7 @@
4088
4205
  "declarations": [
4089
4206
  {
4090
4207
  "kind": "class",
4091
- "description": "Expandable is a layout component used for creating expandable content areas on a page.\n\n[See Storybook for usage examples](https://warp-ds.github.io/elements/?path=/docs/layout-expandable--docs)",
4208
+ "description": "Expandable is a layout component used for creating expandable content areas on a page.",
4092
4209
  "name": "WarpExpandable",
4093
4210
  "slots": [
4094
4211
  {
@@ -4104,6 +4221,7 @@
4104
4221
  "text": "boolean"
4105
4222
  },
4106
4223
  "default": "false",
4224
+ "description": "Controls component's expanded state",
4107
4225
  "attribute": "expanded",
4108
4226
  "reflects": true
4109
4227
  },
@@ -4113,6 +4231,7 @@
4113
4231
  "type": {
4114
4232
  "text": "string"
4115
4233
  },
4234
+ "description": "Component title. Used to display the title value which is always present regardless of whether the component is open or closed.",
4116
4235
  "attribute": "title"
4117
4236
  },
4118
4237
  {
@@ -4122,6 +4241,7 @@
4122
4241
  "text": "boolean"
4123
4242
  },
4124
4243
  "default": "false",
4244
+ "description": "Will make the expandable a Box",
4125
4245
  "attribute": "box"
4126
4246
  },
4127
4247
  {
@@ -4131,6 +4251,7 @@
4131
4251
  "text": "boolean"
4132
4252
  },
4133
4253
  "default": "false",
4254
+ "description": "Will make the expandable full-width on the sm breakpoint size",
4134
4255
  "attribute": "bleed"
4135
4256
  },
4136
4257
  {
@@ -4139,6 +4260,7 @@
4139
4260
  "type": {
4140
4261
  "text": "string"
4141
4262
  },
4263
+ "deprecated": "Probably does not work the way you expect. The class must exist inside the shadow DOM of the component.",
4142
4264
  "attribute": "button-class"
4143
4265
  },
4144
4266
  {
@@ -4147,6 +4269,7 @@
4147
4269
  "type": {
4148
4270
  "text": "string"
4149
4271
  },
4272
+ "deprecated": "Probably does not work the way you expect. The class must exist inside the shadow DOM of the component.",
4150
4273
  "attribute": "content-class"
4151
4274
  },
4152
4275
  {
@@ -4156,6 +4279,7 @@
4156
4279
  "text": "boolean"
4157
4280
  },
4158
4281
  "default": "false",
4282
+ "description": "Controls chevron visibility",
4159
4283
  "attribute": "no-chevron"
4160
4284
  },
4161
4285
  {
@@ -4165,6 +4289,7 @@
4165
4289
  "text": "boolean"
4166
4290
  },
4167
4291
  "default": "false",
4292
+ "description": "Will animate the expansion/collapse",
4168
4293
  "attribute": "animated"
4169
4294
  },
4170
4295
  {
@@ -4173,6 +4298,7 @@
4173
4298
  "type": {
4174
4299
  "text": "number"
4175
4300
  },
4301
+ "description": "Wrap the toggle button in a heading element with the specified level. If headingLevel is not specified, the button will not be wrapped by a heading element.",
4176
4302
  "attribute": "heading-level"
4177
4303
  },
4178
4304
  {
@@ -4181,6 +4307,7 @@
4181
4307
  "type": {
4182
4308
  "text": "boolean"
4183
4309
  },
4310
+ "privacy": "private",
4184
4311
  "default": "true",
4185
4312
  "attribute": "_hasTitle"
4186
4313
  },
@@ -4190,6 +4317,7 @@
4190
4317
  "type": {
4191
4318
  "text": "boolean"
4192
4319
  },
4320
+ "privacy": "private",
4193
4321
  "default": "false",
4194
4322
  "attribute": "_showChevronUp"
4195
4323
  },
@@ -4237,6 +4365,7 @@
4237
4365
  "text": "boolean"
4238
4366
  },
4239
4367
  "default": "false",
4368
+ "description": "Controls component's expanded state",
4240
4369
  "fieldName": "expanded"
4241
4370
  },
4242
4371
  {
@@ -4244,6 +4373,7 @@
4244
4373
  "type": {
4245
4374
  "text": "string"
4246
4375
  },
4376
+ "description": "Component title. Used to display the title value which is always present regardless of whether the component is open or closed.",
4247
4377
  "fieldName": "title"
4248
4378
  },
4249
4379
  {
@@ -4252,6 +4382,7 @@
4252
4382
  "text": "boolean"
4253
4383
  },
4254
4384
  "default": "false",
4385
+ "description": "Will make the expandable a Box",
4255
4386
  "fieldName": "box"
4256
4387
  },
4257
4388
  {
@@ -4260,6 +4391,7 @@
4260
4391
  "text": "boolean"
4261
4392
  },
4262
4393
  "default": "false",
4394
+ "description": "Will make the expandable full-width on the sm breakpoint size",
4263
4395
  "fieldName": "bleed"
4264
4396
  },
4265
4397
  {
@@ -4267,6 +4399,7 @@
4267
4399
  "type": {
4268
4400
  "text": "string"
4269
4401
  },
4402
+ "deprecated": "Probably does not work the way you expect. The class must exist inside the shadow DOM of the component.",
4270
4403
  "fieldName": "buttonClass"
4271
4404
  },
4272
4405
  {
@@ -4274,6 +4407,7 @@
4274
4407
  "type": {
4275
4408
  "text": "string"
4276
4409
  },
4410
+ "deprecated": "Probably does not work the way you expect. The class must exist inside the shadow DOM of the component.",
4277
4411
  "fieldName": "contentClass"
4278
4412
  },
4279
4413
  {
@@ -4282,6 +4416,7 @@
4282
4416
  "text": "boolean"
4283
4417
  },
4284
4418
  "default": "false",
4419
+ "description": "Controls chevron visibility",
4285
4420
  "fieldName": "noChevron"
4286
4421
  },
4287
4422
  {
@@ -4290,6 +4425,7 @@
4290
4425
  "text": "boolean"
4291
4426
  },
4292
4427
  "default": "false",
4428
+ "description": "Will animate the expansion/collapse",
4293
4429
  "fieldName": "animated"
4294
4430
  },
4295
4431
  {
@@ -4297,6 +4433,7 @@
4297
4433
  "type": {
4298
4434
  "text": "number"
4299
4435
  },
4436
+ "description": "Wrap the toggle button in a heading element with the specified level. If headingLevel is not specified, the button will not be wrapped by a heading element.",
4300
4437
  "fieldName": "headingLevel"
4301
4438
  },
4302
4439
  {
@@ -4420,6 +4557,15 @@
4420
4557
  },
4421
4558
  "privacy": "private"
4422
4559
  },
4560
+ {
4561
+ "kind": "field",
4562
+ "name": "_isClosing",
4563
+ "type": {
4564
+ "text": "boolean"
4565
+ },
4566
+ "privacy": "private",
4567
+ "default": "false"
4568
+ },
4423
4569
  {
4424
4570
  "kind": "method",
4425
4571
  "name": "open",