@warp-ds/elements 2.10.0-next.3 → 2.10.0-next.5

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 (159) hide show
  1. package/dist/custom-elements.json +77 -14
  2. package/dist/docs/affix/affix.md +2 -0
  3. package/dist/docs/affix/styling.md +1 -0
  4. package/dist/docs/alert/alert.md +2 -0
  5. package/dist/docs/alert/styling.md +1 -0
  6. package/dist/docs/attention/attention.md +2 -0
  7. package/dist/docs/attention/styling.md +1 -0
  8. package/dist/docs/badge/badge.md +2 -0
  9. package/dist/docs/badge/styling.md +1 -0
  10. package/dist/docs/box/box.md +22 -38
  11. package/dist/docs/box/examples.md +20 -38
  12. package/dist/docs/box/styling.md +1 -0
  13. package/dist/docs/breadcrumbs/breadcrumbs.md +8 -0
  14. package/dist/docs/breadcrumbs/examples.md +7 -1
  15. package/dist/docs/breadcrumbs/styling.md +1 -0
  16. package/dist/docs/button/button.md +73 -0
  17. package/dist/docs/button/styling.md +72 -0
  18. package/dist/docs/card/card.md +2 -0
  19. package/dist/docs/card/styling.md +1 -0
  20. package/dist/docs/checkbox/api.md +128 -0
  21. package/dist/docs/checkbox/checkbox.md +134 -0
  22. package/dist/docs/checkbox-group/accessibility.md +71 -0
  23. package/dist/docs/checkbox-group/api.md +79 -0
  24. package/dist/docs/checkbox-group/checkbox-group.md +492 -0
  25. package/dist/docs/checkbox-group/examples.md +105 -0
  26. package/dist/docs/checkbox-group/styling.md +132 -0
  27. package/dist/docs/checkbox-group/usage.md +95 -0
  28. package/dist/docs/combobox/combobox.md +2 -0
  29. package/dist/docs/combobox/styling.md +1 -0
  30. package/dist/docs/datepicker/accessibility.md +25 -0
  31. package/dist/docs/datepicker/api.md +22 -14
  32. package/dist/docs/datepicker/datepicker.md +208 -14
  33. package/dist/docs/datepicker/examples.md +75 -0
  34. package/dist/docs/datepicker/styling.md +1 -0
  35. package/dist/docs/datepicker/usage.md +84 -0
  36. package/dist/docs/expandable/api.md +20 -32
  37. package/dist/docs/expandable/examples.md +54 -0
  38. package/dist/docs/expandable/expandable.md +74 -32
  39. package/dist/docs/expandable/styling.md +1 -0
  40. package/dist/docs/icon/icon.md +2 -0
  41. package/dist/docs/icon/styling.md +1 -0
  42. package/dist/docs/link/link.md +2 -0
  43. package/dist/docs/link/styling.md +1 -0
  44. package/dist/docs/modal/modal.md +2 -0
  45. package/dist/docs/modal/styling.md +1 -0
  46. package/dist/docs/modal-footer/modal-footer.md +0 -6
  47. package/dist/docs/modal-header/modal-header.md +0 -6
  48. package/dist/docs/page-indicator/page-indicator.md +2 -0
  49. package/dist/docs/page-indicator/styling.md +1 -0
  50. package/dist/docs/pagination/pagination.md +2 -0
  51. package/dist/docs/pagination/styling.md +1 -0
  52. package/dist/docs/pill/pill.md +2 -0
  53. package/dist/docs/pill/styling.md +1 -0
  54. package/dist/docs/radio/radio.md +0 -6
  55. package/dist/docs/select/select.md +2 -0
  56. package/dist/docs/select/styling.md +1 -0
  57. package/dist/docs/slider/slider.md +2 -0
  58. package/dist/docs/slider/styling.md +1 -0
  59. package/dist/docs/slider-thumb/slider-thumb.md +2 -0
  60. package/dist/docs/slider-thumb/styling.md +1 -0
  61. package/dist/docs/step-indicator/step-indicator.md +2 -0
  62. package/dist/docs/step-indicator/styling.md +1 -0
  63. package/dist/docs/switch/styling.md +1 -0
  64. package/dist/docs/switch/switch.md +2 -0
  65. package/dist/docs/tabs/styling.md +1 -0
  66. package/dist/docs/tabs/tabs.md +2 -0
  67. package/dist/docs/textarea/styling.md +1 -0
  68. package/dist/docs/textarea/textarea.md +2 -0
  69. package/dist/docs/textfield/styling.md +1 -0
  70. package/dist/docs/textfield/textfield.md +2 -0
  71. package/dist/index.d.ts +164 -128
  72. package/dist/packages/affix/affix.hydration.test.js +1 -1
  73. package/dist/packages/alert/alert.hydration.test.js +1 -1
  74. package/dist/packages/attention/attention.hydration.test.js +1 -1
  75. package/dist/packages/attention/attention.js +397 -446
  76. package/dist/packages/attention/attention.js.map +4 -4
  77. package/dist/packages/badge/badge.hydration.test.js +1 -1
  78. package/dist/packages/box/box.hydration.test.js +1 -1
  79. package/dist/packages/breadcrumbs/breadcrumbs.hydration.test.js +3 -2
  80. package/dist/packages/button/button.hydration.test.js +1 -1
  81. package/dist/packages/button/button.js +387 -436
  82. package/dist/packages/button/button.js.map +4 -4
  83. package/dist/packages/button/button.stories.d.ts +29 -0
  84. package/dist/packages/button/button.stories.js +176 -2
  85. package/dist/packages/button/styles.d.ts +22 -1
  86. package/dist/packages/button/styles.js +390 -1
  87. package/dist/packages/card/card.hydration.test.js +1 -1
  88. package/dist/packages/checkbox/checkbox.d.ts +5 -3
  89. package/dist/packages/checkbox/checkbox.hydration.test.js +1 -1
  90. package/dist/packages/checkbox/checkbox.js +2 -2
  91. package/dist/packages/checkbox/checkbox.js.map +3 -3
  92. package/dist/packages/checkbox/checkbox.react.stories.d.ts +1 -1
  93. package/dist/packages/checkbox/checkbox.stories.d.ts +2 -2
  94. package/dist/packages/checkbox/react.d.ts +2 -2
  95. package/dist/packages/checkbox-group/checkbox-group.d.ts +5 -3
  96. package/dist/packages/checkbox-group/checkbox-group.hydration.test.js +1 -1
  97. package/dist/packages/checkbox-group/checkbox-group.js +6 -6
  98. package/dist/packages/checkbox-group/checkbox-group.js.map +3 -3
  99. package/dist/packages/checkbox-group/react.d.ts +3 -3
  100. package/dist/packages/datepicker/datepicker.d.ts +22 -30
  101. package/dist/packages/datepicker/datepicker.hydration.test.js +1 -1
  102. package/dist/packages/datepicker/datepicker.js.map +2 -2
  103. package/dist/packages/expandable/expandable.d.ts +11 -32
  104. package/dist/packages/expandable/expandable.hydration.test.js +1 -1
  105. package/dist/packages/expandable/expandable.js.map +2 -2
  106. package/dist/packages/expandable/expandable.react.stories.d.ts +2 -2
  107. package/dist/packages/expandable/react.d.ts +1 -1
  108. package/dist/packages/icon/icon.hydration.test.js +1 -1
  109. package/dist/packages/link/link.hydration.test.js +1 -1
  110. package/dist/packages/link/link.js +420 -190
  111. package/dist/packages/link/link.js.map +4 -4
  112. package/dist/packages/link/styles.d.ts +5 -0
  113. package/dist/packages/link/styles.js +80 -0
  114. package/dist/packages/modal/modal.d.ts +1 -0
  115. package/dist/packages/modal/modal.hydration.test.js +1 -1
  116. package/dist/packages/modal/modal.js +4 -4
  117. package/dist/packages/modal/modal.js.map +2 -2
  118. package/dist/packages/page-indicator/page-indicator.hydration.test.js +1 -1
  119. package/dist/packages/pagination/pagination.hydration.test.js +1 -1
  120. package/dist/packages/pill/pill.hydration.test.js +1 -1
  121. package/dist/packages/radio/radio.hydration.test.js +1 -1
  122. package/dist/packages/radio/radio.js.map +1 -1
  123. package/dist/packages/radio-group/radio-group.a11y.test.js +6 -2
  124. package/dist/packages/radio-group/radio-group.hydration.test.js +6 -2
  125. package/dist/packages/radio-group/radio-group.js +2 -2
  126. package/dist/packages/radio-group/radio-group.js.map +4 -4
  127. package/dist/packages/select/select.a11y.test.js +6 -2
  128. package/dist/packages/select/select.hydration.test.js +1 -1
  129. package/dist/packages/select/select.test.js +4 -2
  130. package/dist/packages/slider/slider.hydration.test.js +7 -2
  131. package/dist/packages/slider/slider.js.map +1 -1
  132. package/dist/packages/slider/slider.react.stories.js +2 -2
  133. package/dist/packages/slider-thumb/slider-thumb.hydration.test.js +1 -1
  134. package/dist/packages/step/step.hydration.test.js +1 -1
  135. package/dist/packages/step-indicator/step-indicator.hydration.test.js +1 -1
  136. package/dist/packages/switch/switch.hydration.test.js +1 -1
  137. package/dist/packages/tab/tab.hydration.test.js +1 -1
  138. package/dist/packages/tab-panel/tab-panel.hydration.test.js +1 -1
  139. package/dist/packages/tabs/tabs.a11y.test.js +1 -1
  140. package/dist/packages/tabs/tabs.hydration.test.js +1 -1
  141. package/dist/packages/tabs/tabs.test.js +3 -3
  142. package/dist/packages/textarea/textarea.hydration.test.js +1 -1
  143. package/dist/packages/textfield/textfield.hydration.test.js +1 -1
  144. package/dist/web-types.json +91 -28
  145. package/eik/index.js +115 -0
  146. package/package.json +7 -4
  147. package/dist/docs/modal-footer/accessibility.md +0 -1
  148. package/dist/docs/modal-footer/examples.md +0 -1
  149. package/dist/docs/modal-footer/usage.md +0 -1
  150. package/dist/docs/modal-header/accessibility.md +0 -1
  151. package/dist/docs/modal-header/examples.md +0 -1
  152. package/dist/docs/modal-header/usage.md +0 -1
  153. package/dist/docs/radio/accessibility.md +0 -1
  154. package/dist/docs/radio/examples.md +0 -1
  155. package/dist/docs/radio/usage.md +0 -1
  156. package/dist/packages/button/styles/w-button.styles.d.ts +0 -1
  157. package/dist/packages/button/styles/w-button.styles.js +0 -282
  158. package/dist/packages/link/styles/w-link.styles.d.ts +0 -1
  159. package/dist/packages/link/styles/w-link.styles.js +0 -213
package/dist/index.d.ts CHANGED
@@ -9,8 +9,11 @@ import type { WarpBadge } from "./packages/badge/badge.ts";
9
9
  import type { WarpBox } from "./packages/box/box.ts";
10
10
  import type { WarpBreadcrumbs } from "./packages/breadcrumbs/breadcrumbs.ts";
11
11
  import type { WarpCard } from "./packages/card/card.ts";
12
- import type { WCheckbox } from "./packages/checkbox/checkbox.ts";
13
- import type { WCheckboxGroup } from "./packages/checkbox-group/checkbox-group.ts";
12
+ import type { WarpCheckbox, WCheckbox } from "./packages/checkbox/checkbox.ts";
13
+ import type {
14
+ WarpCheckboxGroup,
15
+ WCheckboxGroup,
16
+ } from "./packages/checkbox-group/checkbox-group.ts";
14
17
  import type { WarpCombobox } from "./packages/combobox/combobox.ts";
15
18
  import type { WarpDatepicker } from "./packages/datepicker/datepicker.ts";
16
19
  import type { WarpExpandable } from "./packages/expandable/expandable.ts";
@@ -773,73 +776,73 @@ When set, the card becomes keyboard focusable and Enter or Space triggers a clic
773
776
  textContent?: string | number;
774
777
  };
775
778
 
776
- export type WCheckboxProps = {
779
+ export type WarpCheckboxProps = {
777
780
  /** The name of the checkbox.
778
781
 
779
782
  When 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. */
780
- name?: WCheckbox["name"];
783
+ name?: WarpCheckbox["name"];
781
784
  /** The value submitted when the checkbox is checked.
782
785
 
783
786
  If no value attribute is set, the checkbox defaults to `on`. Unchecked and disabled checkboxes do not submit a value. */
784
- value?: WCheckbox["value"];
787
+ value?: WarpCheckbox["value"];
785
788
  /** Whether the checkbox is visually indeterminate.
786
789
 
787
790
  Use 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. */
788
- indeterminate?: WCheckbox["indeterminate"];
791
+ indeterminate?: WarpCheckbox["indeterminate"];
789
792
  /** Whether the checkbox is checked.
790
793
 
791
794
  Checked checkboxes submit their value with form data. The property is reflected to the `checked` attribute. */
792
- checked?: WCheckbox["checked"];
795
+ checked?: WarpCheckbox["checked"];
793
796
  /** Whether the checkbox is disabled.
794
797
 
795
798
  Disabled checkboxes cannot be focused, changed, or submitted with form data. */
796
- disabled?: WCheckbox["disabled"];
799
+ disabled?: WarpCheckbox["disabled"];
797
800
  /** Whether the checkbox must be checked before form submission.
798
801
 
799
802
  A required checkbox is invalid until it is checked. For requiring at least one option in a set, use `required` on `w-checkbox-group`. */
800
- required?: WCheckbox["required"];
803
+ required?: WarpCheckbox["required"];
801
804
  /** Whether the checkbox is visually invalid.
802
805
 
803
806
  Use 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. */
804
- invalid?: WCheckbox["invalid"];
807
+ invalid?: WarpCheckbox["invalid"];
805
808
  /** */
806
- input?: WCheckbox["input"];
809
+ input?: WarpCheckbox["input"];
807
810
 
808
811
  /** */
809
812
  onchange?: (e: Event) => void;
810
813
  };
811
814
 
812
- export type WCheckboxSolidJsProps = {
815
+ export type WarpCheckboxSolidJsProps = {
813
816
  /** The name of the checkbox.
814
817
 
815
818
  When 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. */
816
- "prop:name"?: WCheckbox["name"];
819
+ "prop:name"?: WarpCheckbox["name"];
817
820
  /** The value submitted when the checkbox is checked.
818
821
 
819
822
  If no value attribute is set, the checkbox defaults to `on`. Unchecked and disabled checkboxes do not submit a value. */
820
- "prop:value"?: WCheckbox["value"];
823
+ "prop:value"?: WarpCheckbox["value"];
821
824
  /** Whether the checkbox is visually indeterminate.
822
825
 
823
826
  Use 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. */
824
- "prop:indeterminate"?: WCheckbox["indeterminate"];
827
+ "prop:indeterminate"?: WarpCheckbox["indeterminate"];
825
828
  /** Whether the checkbox is checked.
826
829
 
827
830
  Checked checkboxes submit their value with form data. The property is reflected to the `checked` attribute. */
828
- "prop:checked"?: WCheckbox["checked"];
831
+ "prop:checked"?: WarpCheckbox["checked"];
829
832
  /** Whether the checkbox is disabled.
830
833
 
831
834
  Disabled checkboxes cannot be focused, changed, or submitted with form data. */
832
- "prop:disabled"?: WCheckbox["disabled"];
835
+ "prop:disabled"?: WarpCheckbox["disabled"];
833
836
  /** Whether the checkbox must be checked before form submission.
834
837
 
835
838
  A required checkbox is invalid until it is checked. For requiring at least one option in a set, use `required` on `w-checkbox-group`. */
836
- "prop:required"?: WCheckbox["required"];
839
+ "prop:required"?: WarpCheckbox["required"];
837
840
  /** Whether the checkbox is visually invalid.
838
841
 
839
842
  Use 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. */
840
- "prop:invalid"?: WCheckbox["invalid"];
843
+ "prop:invalid"?: WarpCheckbox["invalid"];
841
844
  /** */
842
- "prop:input"?: WCheckbox["input"];
845
+ "prop:input"?: WarpCheckbox["input"];
843
846
  /** */
844
847
  "on:change"?: (e: Event) => void;
845
848
 
@@ -849,66 +852,66 @@ Use this to show an externally managed validation error. Required validation als
849
852
  textContent?: string | number;
850
853
  };
851
854
 
852
- export type WCheckboxGroupProps = {
855
+ export type WarpCheckboxGroupProps = {
853
856
  /** The group label displayed above the checkboxes.
854
857
 
855
858
  Use this to describe the shared question or topic for the checkbox options. The label is connected to the internal group for assistive technologies. */
856
- label?: WCheckboxGroup["label"];
859
+ label?: WarpCheckboxGroup["label"];
857
860
  /** The name applied to child checkboxes when they do not provide one.
858
861
 
859
862
  Use 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`. */
860
- name?: WCheckboxGroup["name"];
863
+ name?: WarpCheckboxGroup["name"];
861
864
  /** Whether to show optional text next to the label.
862
865
 
863
866
  Use this to indicate that selecting an option from the group is not required. */
864
- optional?: WCheckboxGroup["optional"];
867
+ optional?: WarpCheckboxGroup["optional"];
865
868
  /** Help text displayed below the checkbox group.
866
869
 
867
870
  Use this for supporting guidance or validation feedback. When required validation fails, the group replaces this text with the localized required message. */
868
- "help-text"?: WCheckboxGroup["helpText"];
871
+ "help-text"?: WarpCheckboxGroup["helpText"];
869
872
  /** Help text displayed below the checkbox group.
870
873
 
871
874
  Use this for supporting guidance or validation feedback. When required validation fails, the group replaces this text with the localized required message. */
872
- helpText?: WCheckboxGroup["helpText"];
875
+ helpText?: WarpCheckboxGroup["helpText"];
873
876
  /** Whether at least one checkbox in the group must be selected.
874
877
 
875
878
  Required validation is managed by the group. The individual checkboxes provide the submitted form values. */
876
- required?: WCheckboxGroup["required"];
879
+ required?: WarpCheckboxGroup["required"];
877
880
  /** Whether the checkbox group is visually invalid.
878
881
 
879
882
  Use 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. */
880
- invalid?: WCheckboxGroup["invalid"];
883
+ invalid?: WarpCheckboxGroup["invalid"];
881
884
  };
882
885
 
883
- export type WCheckboxGroupSolidJsProps = {
886
+ export type WarpCheckboxGroupSolidJsProps = {
884
887
  /** The group label displayed above the checkboxes.
885
888
 
886
889
  Use this to describe the shared question or topic for the checkbox options. The label is connected to the internal group for assistive technologies. */
887
- "prop:label"?: WCheckboxGroup["label"];
890
+ "prop:label"?: WarpCheckboxGroup["label"];
888
891
  /** The name applied to child checkboxes when they do not provide one.
889
892
 
890
893
  Use 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`. */
891
- "prop:name"?: WCheckboxGroup["name"];
894
+ "prop:name"?: WarpCheckboxGroup["name"];
892
895
  /** Whether to show optional text next to the label.
893
896
 
894
897
  Use this to indicate that selecting an option from the group is not required. */
895
- "prop:optional"?: WCheckboxGroup["optional"];
898
+ "prop:optional"?: WarpCheckboxGroup["optional"];
896
899
  /** Help text displayed below the checkbox group.
897
900
 
898
901
  Use this for supporting guidance or validation feedback. When required validation fails, the group replaces this text with the localized required message. */
899
- "attr:help-text"?: WCheckboxGroup["helpText"];
902
+ "attr:help-text"?: WarpCheckboxGroup["helpText"];
900
903
  /** Help text displayed below the checkbox group.
901
904
 
902
905
  Use this for supporting guidance or validation feedback. When required validation fails, the group replaces this text with the localized required message. */
903
- "prop:helpText"?: WCheckboxGroup["helpText"];
906
+ "prop:helpText"?: WarpCheckboxGroup["helpText"];
904
907
  /** Whether at least one checkbox in the group must be selected.
905
908
 
906
909
  Required validation is managed by the group. The individual checkboxes provide the submitted form values. */
907
- "prop:required"?: WCheckboxGroup["required"];
910
+ "prop:required"?: WarpCheckboxGroup["required"];
908
911
  /** Whether the checkbox group is visually invalid.
909
912
 
910
913
  Use 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. */
911
- "prop:invalid"?: WCheckboxGroup["invalid"];
914
+ "prop:invalid"?: WarpCheckboxGroup["invalid"];
912
915
 
913
916
  /** Set the innerHTML of the element */
914
917
  innerHTML?: string;
@@ -1088,41 +1091,49 @@ Defaults to `off`. Set this when browser autocomplete should be enabled or scope
1088
1091
  };
1089
1092
 
1090
1093
  export type WarpDatepickerProps = {
1091
- /** */
1094
+ /** The label displayed above the date input.
1095
+
1096
+ Use this to give the datepicker a visible and accessible name. */
1092
1097
  label?: WarpDatepicker["label"];
1093
- /** Takes precedence over the `<html>` lang attribute. */
1098
+ /** The locale used for calendar labels and date formatting.
1099
+
1100
+ This takes precedence over the `<html>` `lang` attribute. Supported built-in locales are `en`, `nb`, `sv`, `da`, and `fi`. */
1094
1101
  lang?: WarpDatepicker["lang"];
1095
- /** */
1102
+ /** The name submitted with the date value.
1103
+
1104
+ Use this when the datepicker belongs to a form and its value should be included in form data. */
1096
1105
  name?: WarpDatepicker["name"];
1097
- /** */
1106
+ /** The selected date value.
1107
+
1108
+ Use 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. */
1098
1109
  value?: WarpDatepicker["value"];
1099
- /** Decides the format of the date as shown in the calendar header.
1110
+ /** The date format used in the calendar header.
1100
1111
 
1101
1112
  The syntax is defined by [date-fns/format](https://date-fns.org/v4.1.0/docs/format). */
1102
1113
  "header-format"?: WarpDatepicker["headerFormat"];
1103
- /** Decides the format of the date as shown in the calendar header.
1114
+ /** The date format used in the calendar header.
1104
1115
 
1105
1116
  The syntax is defined by [date-fns/format](https://date-fns.org/v4.1.0/docs/format). */
1106
1117
  headerFormat?: WarpDatepicker["headerFormat"];
1107
- /** Decides the format of the weekday as shown above the grid of dates in the calendar.
1118
+ /** The weekday format shown above the calendar grid.
1108
1119
 
1109
1120
  The syntax is defined by [date-fns/format](https://date-fns.org/v4.1.0/docs/format). */
1110
1121
  "weekday-format"?: WarpDatepicker["weekdayFormat"];
1111
- /** Decides the format of the weekday as shown above the grid of dates in the calendar.
1122
+ /** The weekday format shown above the calendar grid.
1112
1123
 
1113
1124
  The syntax is defined by [date-fns/format](https://date-fns.org/v4.1.0/docs/format). */
1114
1125
  weekdayFormat?: WarpDatepicker["weekdayFormat"];
1115
- /** Decides the format of the day in the calendar as read to screen readers.
1126
+ /** The date format used for calendar day accessible names.
1116
1127
 
1117
1128
  The syntax is defined by [date-fns/format](https://date-fns.org/v4.1.0/docs/format). */
1118
1129
  "day-format"?: WarpDatepicker["dayFormat"];
1119
- /** Decides the format of the day in the calendar as read to screen readers.
1130
+ /** The date format used for calendar day accessible names.
1120
1131
 
1121
1132
  The syntax is defined by [date-fns/format](https://date-fns.org/v4.1.0/docs/format). */
1122
1133
  dayFormat?: WarpDatepicker["dayFormat"];
1123
- /** Lets you control if a date in the calendar should be disabled.
1134
+ /** Function used to disable dates in the calendar.
1124
1135
 
1125
- This needs to be set on the element instance in JavaScript, not as an HTML attribute. */
1136
+ Set this on the element instance in JavaScript, not as an HTML attribute. Disabled dates cannot be selected from the calendar. */
1126
1137
  isDayDisabled?: WarpDatepicker["isDayDisabled"];
1127
1138
  /** */
1128
1139
  isCalendarOpen?: WarpDatepicker["isCalendarOpen"];
@@ -1149,41 +1160,49 @@ the query will point to an element that doesn't exist anymore. */
1149
1160
  };
1150
1161
 
1151
1162
  export type WarpDatepickerSolidJsProps = {
1152
- /** */
1163
+ /** The label displayed above the date input.
1164
+
1165
+ Use this to give the datepicker a visible and accessible name. */
1153
1166
  "prop:label"?: WarpDatepicker["label"];
1154
- /** Takes precedence over the `<html>` lang attribute. */
1167
+ /** The locale used for calendar labels and date formatting.
1168
+
1169
+ This takes precedence over the `<html>` `lang` attribute. Supported built-in locales are `en`, `nb`, `sv`, `da`, and `fi`. */
1155
1170
  "prop:lang"?: WarpDatepicker["lang"];
1156
- /** */
1171
+ /** The name submitted with the date value.
1172
+
1173
+ Use this when the datepicker belongs to a form and its value should be included in form data. */
1157
1174
  "prop:name"?: WarpDatepicker["name"];
1158
- /** */
1175
+ /** The selected date value.
1176
+
1177
+ Use 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. */
1159
1178
  "prop:value"?: WarpDatepicker["value"];
1160
- /** Decides the format of the date as shown in the calendar header.
1179
+ /** The date format used in the calendar header.
1161
1180
 
1162
1181
  The syntax is defined by [date-fns/format](https://date-fns.org/v4.1.0/docs/format). */
1163
1182
  "attr:header-format"?: WarpDatepicker["headerFormat"];
1164
- /** Decides the format of the date as shown in the calendar header.
1183
+ /** The date format used in the calendar header.
1165
1184
 
1166
1185
  The syntax is defined by [date-fns/format](https://date-fns.org/v4.1.0/docs/format). */
1167
1186
  "prop:headerFormat"?: WarpDatepicker["headerFormat"];
1168
- /** Decides the format of the weekday as shown above the grid of dates in the calendar.
1187
+ /** The weekday format shown above the calendar grid.
1169
1188
 
1170
1189
  The syntax is defined by [date-fns/format](https://date-fns.org/v4.1.0/docs/format). */
1171
1190
  "attr:weekday-format"?: WarpDatepicker["weekdayFormat"];
1172
- /** Decides the format of the weekday as shown above the grid of dates in the calendar.
1191
+ /** The weekday format shown above the calendar grid.
1173
1192
 
1174
1193
  The syntax is defined by [date-fns/format](https://date-fns.org/v4.1.0/docs/format). */
1175
1194
  "prop:weekdayFormat"?: WarpDatepicker["weekdayFormat"];
1176
- /** Decides the format of the day in the calendar as read to screen readers.
1195
+ /** The date format used for calendar day accessible names.
1177
1196
 
1178
1197
  The syntax is defined by [date-fns/format](https://date-fns.org/v4.1.0/docs/format). */
1179
1198
  "attr:day-format"?: WarpDatepicker["dayFormat"];
1180
- /** Decides the format of the day in the calendar as read to screen readers.
1199
+ /** The date format used for calendar day accessible names.
1181
1200
 
1182
1201
  The syntax is defined by [date-fns/format](https://date-fns.org/v4.1.0/docs/format). */
1183
1202
  "prop:dayFormat"?: WarpDatepicker["dayFormat"];
1184
- /** Lets you control if a date in the calendar should be disabled.
1203
+ /** Function used to disable dates in the calendar.
1185
1204
 
1186
- This needs to be set on the element instance in JavaScript, not as an HTML attribute. */
1205
+ Set this on the element instance in JavaScript, not as an HTML attribute. Disabled dates cannot be selected from the calendar. */
1187
1206
  "prop:isDayDisabled"?: WarpDatepicker["isDayDisabled"];
1188
1207
  /** */
1189
1208
  "prop:isCalendarOpen"?: WarpDatepicker["isCalendarOpen"];
@@ -1215,31 +1234,31 @@ the query will point to an element that doesn't exist anymore. */
1215
1234
  };
1216
1235
 
1217
1236
  export type WarpExpandableProps = {
1218
- /** */
1237
+ /** Controls component's expanded state */
1219
1238
  expanded?: WarpExpandable["expanded"];
1220
- /** */
1239
+ /** Component title. Used to display the title value which is always present regardless of whether the component is open or closed. */
1221
1240
  title?: WarpExpandable["title"];
1222
- /** */
1241
+ /** Will make the expandable a Box */
1223
1242
  box?: WarpExpandable["box"];
1224
- /** */
1243
+ /** Will make the expandable full-width on the sm breakpoint size */
1225
1244
  bleed?: WarpExpandable["bleed"];
1226
- /** */
1245
+ /** @deprecated Probably does not work the way you expect. The class must exist inside the shadow DOM of the component. */
1227
1246
  "button-class"?: WarpExpandable["buttonClass"];
1228
- /** */
1247
+ /** @deprecated Probably does not work the way you expect. The class must exist inside the shadow DOM of the component. */
1229
1248
  buttonClass?: WarpExpandable["buttonClass"];
1230
- /** */
1249
+ /** @deprecated Probably does not work the way you expect. The class must exist inside the shadow DOM of the component. */
1231
1250
  "content-class"?: WarpExpandable["contentClass"];
1232
- /** */
1251
+ /** @deprecated Probably does not work the way you expect. The class must exist inside the shadow DOM of the component. */
1233
1252
  contentClass?: WarpExpandable["contentClass"];
1234
- /** */
1253
+ /** Controls chevron visibility */
1235
1254
  "no-chevron"?: WarpExpandable["noChevron"];
1236
- /** */
1255
+ /** Controls chevron visibility */
1237
1256
  noChevron?: WarpExpandable["noChevron"];
1238
- /** */
1257
+ /** Will animate the expansion/collapse */
1239
1258
  animated?: WarpExpandable["animated"];
1240
- /** */
1259
+ /** 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. */
1241
1260
  "heading-level"?: WarpExpandable["headingLevel"];
1242
- /** */
1261
+ /** 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. */
1243
1262
  headingLevel?: WarpExpandable["headingLevel"];
1244
1263
  /** */
1245
1264
  _hasTitle?: WarpExpandable["_hasTitle"];
@@ -1248,31 +1267,31 @@ export type WarpExpandableProps = {
1248
1267
  };
1249
1268
 
1250
1269
  export type WarpExpandableSolidJsProps = {
1251
- /** */
1270
+ /** Controls component's expanded state */
1252
1271
  "prop:expanded"?: WarpExpandable["expanded"];
1253
- /** */
1272
+ /** Component title. Used to display the title value which is always present regardless of whether the component is open or closed. */
1254
1273
  "prop:title"?: WarpExpandable["title"];
1255
- /** */
1274
+ /** Will make the expandable a Box */
1256
1275
  "prop:box"?: WarpExpandable["box"];
1257
- /** */
1276
+ /** Will make the expandable full-width on the sm breakpoint size */
1258
1277
  "prop:bleed"?: WarpExpandable["bleed"];
1259
- /** */
1278
+ /** @deprecated Probably does not work the way you expect. The class must exist inside the shadow DOM of the component. */
1260
1279
  "attr:button-class"?: WarpExpandable["buttonClass"];
1261
- /** */
1280
+ /** @deprecated Probably does not work the way you expect. The class must exist inside the shadow DOM of the component. */
1262
1281
  "prop:buttonClass"?: WarpExpandable["buttonClass"];
1263
- /** */
1282
+ /** @deprecated Probably does not work the way you expect. The class must exist inside the shadow DOM of the component. */
1264
1283
  "attr:content-class"?: WarpExpandable["contentClass"];
1265
- /** */
1284
+ /** @deprecated Probably does not work the way you expect. The class must exist inside the shadow DOM of the component. */
1266
1285
  "prop:contentClass"?: WarpExpandable["contentClass"];
1267
- /** */
1286
+ /** Controls chevron visibility */
1268
1287
  "bool:no-chevron"?: WarpExpandable["noChevron"];
1269
- /** */
1288
+ /** Controls chevron visibility */
1270
1289
  "prop:noChevron"?: WarpExpandable["noChevron"];
1271
- /** */
1290
+ /** Will animate the expansion/collapse */
1272
1291
  "prop:animated"?: WarpExpandable["animated"];
1273
- /** */
1292
+ /** 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. */
1274
1293
  "attr:heading-level"?: WarpExpandable["headingLevel"];
1275
- /** */
1294
+ /** 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. */
1276
1295
  "prop:headingLevel"?: WarpExpandable["headingLevel"];
1277
1296
  /** */
1278
1297
  "prop:_hasTitle"?: WarpExpandable["_hasTitle"];
@@ -2454,7 +2473,9 @@ export type CustomElements = {
2454
2473
  * - `checkValidity() => boolean`: Checks whether the checkbox passes constraint validation
2455
2474
  * - `reportValidity() => boolean`: Checks validity and shows the browser's validation message if invalid
2456
2475
  */
2457
- "w-checkbox": Partial<WCheckboxProps & BaseProps<WCheckbox> & BaseEvents>;
2476
+ "w-checkbox": Partial<
2477
+ WarpCheckboxProps & BaseProps<WarpCheckbox> & BaseEvents
2478
+ >;
2458
2479
 
2459
2480
  /**
2460
2481
  *
@@ -2491,7 +2512,7 @@ export type CustomElements = {
2491
2512
  * - `focus(options?: FocusOptions) => void`: Sets focus on the checkbox group.
2492
2513
  */
2493
2514
  "w-checkbox-group": Partial<
2494
- WCheckboxGroupProps & BaseProps<WCheckboxGroup> & BaseEvents
2515
+ WarpCheckboxGroupProps & BaseProps<WarpCheckboxGroup> & BaseEvents
2495
2516
  >;
2496
2517
 
2497
2518
  /**
@@ -2570,22 +2591,30 @@ export type CustomElements = {
2570
2591
  *
2571
2592
  * Component attributes and properties that can be applied to the element or by using JavaScript.
2572
2593
  *
2573
- * - `label`: undefined
2574
- * - `lang`: Takes precedence over the `<html>` lang attribute.
2575
- * - `name`: undefined
2576
- * - `value`: undefined
2577
- * - `header-format`/`headerFormat`: Decides the format of the date as shown in the calendar header.
2594
+ * - `label`: The label displayed above the date input.
2595
+ *
2596
+ * Use this to give the datepicker a visible and accessible name.
2597
+ * - `lang`: The locale used for calendar labels and date formatting.
2598
+ *
2599
+ * This takes precedence over the `<html>` `lang` attribute. Supported built-in locales are `en`, `nb`, `sv`, `da`, and `fi`.
2600
+ * - `name`: The name submitted with the date value.
2601
+ *
2602
+ * Use this when the datepicker belongs to a form and its value should be included in form data.
2603
+ * - `value`: The selected date value.
2604
+ *
2605
+ * Use 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.
2606
+ * - `header-format`/`headerFormat`: The date format used in the calendar header.
2578
2607
  *
2579
2608
  * The syntax is defined by [date-fns/format](https://date-fns.org/v4.1.0/docs/format).
2580
- * - `weekday-format`/`weekdayFormat`: Decides the format of the weekday as shown above the grid of dates in the calendar.
2609
+ * - `weekday-format`/`weekdayFormat`: The weekday format shown above the calendar grid.
2581
2610
  *
2582
2611
  * The syntax is defined by [date-fns/format](https://date-fns.org/v4.1.0/docs/format).
2583
- * - `day-format`/`dayFormat`: Decides the format of the day in the calendar as read to screen readers.
2612
+ * - `day-format`/`dayFormat`: The date format used for calendar day accessible names.
2584
2613
  *
2585
2614
  * The syntax is defined by [date-fns/format](https://date-fns.org/v4.1.0/docs/format).
2586
- * - `isDayDisabled`: Lets you control if a date in the calendar should be disabled.
2615
+ * - `isDayDisabled`: Function used to disable dates in the calendar.
2587
2616
  *
2588
- * This needs to be set on the element instance in JavaScript, not as an HTML attribute. (property only)
2617
+ * Set this on the element instance in JavaScript, not as an HTML attribute. Disabled dates cannot be selected from the calendar. (property only)
2589
2618
  * - `isCalendarOpen`: undefined (property only)
2590
2619
  * - `navigationDate`: undefined (property only)
2591
2620
  * - `selectedDate`: undefined (property only) (readonly)
@@ -2616,21 +2645,19 @@ export type CustomElements = {
2616
2645
  /**
2617
2646
  * Expandable is a layout component used for creating expandable content areas on a page.
2618
2647
  *
2619
- * [See Storybook for usage examples](https://warp-ds.github.io/elements/?path=/docs/layout-expandable--docs)
2620
- *
2621
2648
  * ## Attributes & Properties
2622
2649
  *
2623
2650
  * Component attributes and properties that can be applied to the element or by using JavaScript.
2624
2651
  *
2625
- * - `expanded`: undefined
2626
- * - `title`: undefined
2627
- * - `box`: undefined
2628
- * - `bleed`: undefined
2652
+ * - `expanded`: Controls component's expanded state
2653
+ * - `title`: Component title. Used to display the title value which is always present regardless of whether the component is open or closed.
2654
+ * - `box`: Will make the expandable a Box
2655
+ * - `bleed`: Will make the expandable full-width on the sm breakpoint size
2629
2656
  * - `button-class`/`buttonClass`: undefined
2630
2657
  * - `content-class`/`contentClass`: undefined
2631
- * - `no-chevron`/`noChevron`: undefined
2632
- * - `animated`: undefined
2633
- * - `heading-level`/`headingLevel`: undefined
2658
+ * - `no-chevron`/`noChevron`: Controls chevron visibility
2659
+ * - `animated`: Will animate the expansion/collapse
2660
+ * - `heading-level`/`headingLevel`: 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.
2634
2661
  * - `_hasTitle`: undefined
2635
2662
  * - `_showChevronUp`: undefined
2636
2663
  *
@@ -3503,7 +3530,10 @@ export type CustomElementsSolidJs = {
3503
3530
  * - `reportValidity() => boolean`: Checks validity and shows the browser's validation message if invalid
3504
3531
  */
3505
3532
  "w-checkbox": Partial<
3506
- WCheckboxProps & WCheckboxSolidJsProps & BaseProps<WCheckbox> & BaseEvents
3533
+ WarpCheckboxProps &
3534
+ WarpCheckboxSolidJsProps &
3535
+ BaseProps<WarpCheckbox> &
3536
+ BaseEvents
3507
3537
  >;
3508
3538
 
3509
3539
  /**
@@ -3541,9 +3571,9 @@ export type CustomElementsSolidJs = {
3541
3571
  * - `focus(options?: FocusOptions) => void`: Sets focus on the checkbox group.
3542
3572
  */
3543
3573
  "w-checkbox-group": Partial<
3544
- WCheckboxGroupProps &
3545
- WCheckboxGroupSolidJsProps &
3546
- BaseProps<WCheckboxGroup> &
3574
+ WarpCheckboxGroupProps &
3575
+ WarpCheckboxGroupSolidJsProps &
3576
+ BaseProps<WarpCheckboxGroup> &
3547
3577
  BaseEvents
3548
3578
  >;
3549
3579
 
@@ -3626,22 +3656,30 @@ export type CustomElementsSolidJs = {
3626
3656
  *
3627
3657
  * Component attributes and properties that can be applied to the element or by using JavaScript.
3628
3658
  *
3629
- * - `label`: undefined
3630
- * - `lang`: Takes precedence over the `<html>` lang attribute.
3631
- * - `name`: undefined
3632
- * - `value`: undefined
3633
- * - `header-format`/`headerFormat`: Decides the format of the date as shown in the calendar header.
3659
+ * - `label`: The label displayed above the date input.
3660
+ *
3661
+ * Use this to give the datepicker a visible and accessible name.
3662
+ * - `lang`: The locale used for calendar labels and date formatting.
3663
+ *
3664
+ * This takes precedence over the `<html>` `lang` attribute. Supported built-in locales are `en`, `nb`, `sv`, `da`, and `fi`.
3665
+ * - `name`: The name submitted with the date value.
3666
+ *
3667
+ * Use this when the datepicker belongs to a form and its value should be included in form data.
3668
+ * - `value`: The selected date value.
3669
+ *
3670
+ * Use 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.
3671
+ * - `header-format`/`headerFormat`: The date format used in the calendar header.
3634
3672
  *
3635
3673
  * The syntax is defined by [date-fns/format](https://date-fns.org/v4.1.0/docs/format).
3636
- * - `weekday-format`/`weekdayFormat`: Decides the format of the weekday as shown above the grid of dates in the calendar.
3674
+ * - `weekday-format`/`weekdayFormat`: The weekday format shown above the calendar grid.
3637
3675
  *
3638
3676
  * The syntax is defined by [date-fns/format](https://date-fns.org/v4.1.0/docs/format).
3639
- * - `day-format`/`dayFormat`: Decides the format of the day in the calendar as read to screen readers.
3677
+ * - `day-format`/`dayFormat`: The date format used for calendar day accessible names.
3640
3678
  *
3641
3679
  * The syntax is defined by [date-fns/format](https://date-fns.org/v4.1.0/docs/format).
3642
- * - `isDayDisabled`: Lets you control if a date in the calendar should be disabled.
3680
+ * - `isDayDisabled`: Function used to disable dates in the calendar.
3643
3681
  *
3644
- * This needs to be set on the element instance in JavaScript, not as an HTML attribute. (property only)
3682
+ * Set this on the element instance in JavaScript, not as an HTML attribute. Disabled dates cannot be selected from the calendar. (property only)
3645
3683
  * - `isCalendarOpen`: undefined (property only)
3646
3684
  * - `navigationDate`: undefined (property only)
3647
3685
  * - `selectedDate`: undefined (property only) (readonly)
@@ -3675,21 +3713,19 @@ export type CustomElementsSolidJs = {
3675
3713
  /**
3676
3714
  * Expandable is a layout component used for creating expandable content areas on a page.
3677
3715
  *
3678
- * [See Storybook for usage examples](https://warp-ds.github.io/elements/?path=/docs/layout-expandable--docs)
3679
- *
3680
3716
  * ## Attributes & Properties
3681
3717
  *
3682
3718
  * Component attributes and properties that can be applied to the element or by using JavaScript.
3683
3719
  *
3684
- * - `expanded`: undefined
3685
- * - `title`: undefined
3686
- * - `box`: undefined
3687
- * - `bleed`: undefined
3720
+ * - `expanded`: Controls component's expanded state
3721
+ * - `title`: Component title. Used to display the title value which is always present regardless of whether the component is open or closed.
3722
+ * - `box`: Will make the expandable a Box
3723
+ * - `bleed`: Will make the expandable full-width on the sm breakpoint size
3688
3724
  * - `button-class`/`buttonClass`: undefined
3689
3725
  * - `content-class`/`contentClass`: undefined
3690
- * - `no-chevron`/`noChevron`: undefined
3691
- * - `animated`: undefined
3692
- * - `heading-level`/`headingLevel`: undefined
3726
+ * - `no-chevron`/`noChevron`: Controls chevron visibility
3727
+ * - `animated`: Will animate the expansion/collapse
3728
+ * - `heading-level`/`headingLevel`: 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.
3693
3729
  * - `_hasTitle`: undefined
3694
3730
  * - `_showChevronUp`: undefined
3695
3731
  *
@@ -1,4 +1,4 @@
1
- import { describe, expect, test, beforeEach, afterEach } from 'vitest';
1
+ import { afterEach, beforeEach, describe, expect, test } from 'vitest';
2
2
  import { setupHydrationWarningCapture, testHydration } from '../../tests/react-hydration';
3
3
  import './affix.js';
4
4
  describe('w-affix React SSR hydration', () => {
@@ -1,4 +1,4 @@
1
- import { describe, expect, test, beforeEach, afterEach } from 'vitest';
1
+ import { afterEach, beforeEach, describe, expect, test } from 'vitest';
2
2
  import { setupHydrationWarningCapture, testHydration } from '../../tests/react-hydration';
3
3
  import './alert.js';
4
4
  describe('w-alert React SSR hydration', () => {
@@ -1,4 +1,4 @@
1
- import { describe, expect, test, beforeEach, afterEach } from 'vitest';
1
+ import { afterEach, beforeEach, describe, expect, test } from 'vitest';
2
2
  import { setupHydrationWarningCapture, testHydration } from '../../tests/react-hydration';
3
3
  // Import the custom element definition
4
4
  import './attention.js';