@dxc-technology/halstack-react 0.0.0-75a707a → 0.0.0-75a7c98

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.mts CHANGED
@@ -13,23 +13,31 @@ type Margin = {
13
13
  };
14
14
  type SVG = ReactNode & SVGProps<SVGSVGElement>;
15
15
 
16
- type Props$K = {
16
+ type AccordionItemProps = {
17
17
  /**
18
18
  * The panel label.
19
19
  */
20
20
  label: string;
21
21
  /**
22
- * Initial state of the panel, only when it is uncontrolled.
22
+ * Additional info label positioned under the label.
23
23
  */
24
- defaultIsExpanded?: boolean;
24
+ subLabel?: string;
25
25
  /**
26
- * Represents the state of the panel. When true, the component will be
27
- * expanded. If undefined, the component will be uncontrolled and its
28
- * value will be managed internally by the component.
26
+ * Badge component to add extra value to the accordion.
29
27
  */
30
- isExpanded?: boolean;
28
+ badge?: {
29
+ position: "before" | "after";
30
+ element: ReactNode;
31
+ };
32
+ /**
33
+ * Status light component to add extra value to the accordion.
34
+ */
35
+ statusLight?: ReactNode;
31
36
  /**
32
- * Material Symbol name or SVG element used as the icon that will be placed next to panel label.
37
+ * Material Symbol name or SVG element used as the icon that will be
38
+ * placed next to panel label. When using Material Symbols, replace spaces with underscores.
39
+ * By default they are outlined if you want it to be filled
40
+ * prefix the symbol name with "filled_".
33
41
  */
34
42
  icon?: string | SVG;
35
43
  /**
@@ -40,84 +48,74 @@ type Props$K = {
40
48
  * If true, the component will be disabled.
41
49
  */
42
50
  disabled?: boolean;
43
- /**
44
- * This function will be called when the user clicks the accordion to expand or collapse
45
- * the panel. The new state of the panel will be passed as a parameter.
46
- */
47
- onChange?: (isExpanded: boolean) => void;
48
51
  /**
49
52
  * The expanded panel of the accordion. This area can be used to render
50
53
  * custom content.
51
54
  */
52
55
  children: ReactNode;
56
+ /**
57
+ * Value of the tabindex attribute.
58
+ */
59
+ tabIndex?: number;
60
+ };
61
+ type CommonProps$9 = {
53
62
  /**
54
63
  * Size of the margin to be applied to the component ('xxsmall' | 'xsmall' | 'small' | 'medium' | 'large' | 'xlarge' | 'xxlarge').
55
64
  * You can pass an object with 'top', 'bottom', 'left' and 'right' properties in order to specify different margin sizes.
56
65
  */
57
66
  margin?: Space$1 | Margin;
58
67
  /**
59
- * Value of the tabindex attribute.
68
+ * Contains one or more accordion items.
60
69
  */
61
- tabIndex?: number;
70
+ children: ReactElement<AccordionItemProps>[] | ReactElement<AccordionItemProps>;
62
71
  };
63
-
64
- declare const DxcAccordion: ({ label, defaultIsExpanded, isExpanded, icon, assistiveText, disabled, onChange, children, margin, tabIndex, }: Props$K) => JSX.Element;
65
-
66
- type AccordionPropsType = {
72
+ type IndependentProps = CommonProps$9 & {
67
73
  /**
68
- * The panel label.
74
+ * When true, limits the user to single-open section at a time. When false, multiple sections can be opened simultaneously.
69
75
  */
70
- label: string;
76
+ independent: true;
71
77
  /**
72
- * Material Symbol name or SVG element used as the icon that will be placed next to panel label.
78
+ * Initially active accordion, only when it is uncontrolled.If the accordion is not independent,
79
+ * several accordions can be activated by default.
73
80
  */
74
- icon?: string | SVG;
75
- /**
76
- * Assistive text to be placed on the right side of the panel.
77
- */
78
- assistiveText?: string;
81
+ defaultIndexActive?: number;
79
82
  /**
80
- * If true, the component will be disabled.
83
+ * The index of the active accordion. If undefined, the component will be uncontrolled and the active
84
+ * accordion will be managed internally by the component. If null, the component will be controlled and all
85
+ * accordions will be closed. If the accordion is not independent, several accordions can be activated.
81
86
  */
82
- disabled?: boolean;
87
+ indexActive?: number;
83
88
  /**
84
- * The expanded panel of the accordion. This area can be used to render
85
- * custom content.
89
+ * This function will be called when the user clicks on an accordion. The index of the clicked accordion will be passed as a parameter.
86
90
  */
87
- children: ReactNode;
91
+ onActiveChange?: (index: number) => void;
88
92
  };
89
- type Props$J = {
93
+ type NonIndependentProps = CommonProps$9 & {
90
94
  /**
91
- * Initially active accordion, only when it is uncontrolled.
95
+ * When true, limits the user to single-open section at a time. When false, multiple sections can be opened simultaneously.
92
96
  */
93
- defaultIndexActive?: number;
97
+ independent?: false;
94
98
  /**
95
- * The index of the active accordion. If undefined, the component will be uncontrolled and the active accordion will be managed internally by the component.
96
- * If null, the component will be controlled and all accordions will be closed.
99
+ * Initially active accordion, only when it is uncontrolled. If the accordion is not independent,
100
+ * several accordions can be activated by default.
97
101
  */
98
- indexActive?: number;
102
+ defaultIndexActive?: number[];
99
103
  /**
100
- * If true, the component will be disabled.
104
+ * The index of the active accordion. If undefined, the component will be uncontrolled and the active
105
+ * accordion will be managed internally by the component. If null, the component will be controlled and all
106
+ * accordions will be closed. If the accordion is not independent, several accordions can be activated.
101
107
  */
102
- disabled?: boolean;
108
+ indexActive?: number[];
103
109
  /**
104
110
  * This function will be called when the user clicks on an accordion. The index of the clicked accordion will be passed as a parameter.
105
111
  */
106
- onActiveChange?: (indexActive: number) => void;
107
- /**
108
- * Size of the margin to be applied to the component ('xxsmall' | 'xsmall' | 'small' | 'medium' | 'large' | 'xlarge' | 'xxlarge').
109
- * You can pass an object with 'top', 'bottom', 'left' and 'right' properties in order to specify different margin sizes.
110
- */
111
- margin?: Space$1 | Margin;
112
- /**
113
- * Customized accordion(s) that are allowed inside an Accordion Group.
114
- */
115
- children: ReactElement<AccordionPropsType>[] | ReactElement<AccordionPropsType>;
112
+ onActiveChange?: (index: number[]) => void;
116
113
  };
114
+ type Props$J = IndependentProps | NonIndependentProps;
117
115
 
118
- declare const DxcAccordionGroup: {
119
- ({ defaultIndexActive, indexActive, disabled, onActiveChange, margin, children, }: Props$J): JSX.Element;
120
- Accordion: ({ ...childProps }: AccordionPropsType) => JSX.Element;
116
+ declare const DxcAccordion: {
117
+ (props: Props$J): JSX.Element;
118
+ AccordionItem: ({ label, subLabel, badge, statusLight, icon, assistiveText, disabled, children, tabIndex, }: AccordionItemProps) => JSX.Element;
121
119
  };
122
120
 
123
121
  type Action$2 = {
@@ -278,7 +276,7 @@ type Props$H = {
278
276
  };
279
277
 
280
278
  type Size$4 = "small" | "medium" | "large" | "fillParent" | "fitContent";
281
- type Option$1 = {
279
+ type Option$2 = {
282
280
  /**
283
281
  * Option display value.
284
282
  */
@@ -296,7 +294,7 @@ type Props$G = {
296
294
  /**
297
295
  * An array of objects representing the options.
298
296
  */
299
- options: Option$1[];
297
+ options: Option$2[];
300
298
  /**
301
299
  * In case options include icons, whether the icon should appear
302
300
  * after or before the label.
@@ -479,7 +477,7 @@ declare const DxcApplicationLayout: {
479
477
  Footer: ({ socialLinks, bottomLinks, copyright, children, margin, tabIndex, mode, }: FooterPropsType) => JSX.Element;
480
478
  Header: {
481
479
  ({ underlined, content, responsiveContent, onClick, margin, tabIndex, }: Props$F): JSX.Element;
482
- Dropdown: (props: react.ComponentProps<({ options, optionsIconPosition, icon, iconPosition, label, caretHidden, disabled, expandOnHover, onSelectOption, margin, size, tabIndex, title, }: Props$G) => JSX.Element>) => react_jsx_runtime.JSX.Element;
480
+ Dropdown: (props: react.ComponentProps<({ options, optionsIconPosition, icon, iconPosition, label, caretHidden, disabled, expandOnHover, onSelectOption, margin, size, tabIndex, title, }: Props$G) => react_jsx_runtime.JSX.Element>) => react_jsx_runtime.JSX.Element;
483
481
  };
484
482
  Main: ({ children }: AppLayoutMainPropsType) => JSX.Element;
485
483
  SideNav: {
@@ -546,134 +544,42 @@ type Props$E = (ContextualProps | NotificationProps) & CommonProps$7;
546
544
 
547
545
  declare const DxcBadge: ({ label, title, mode, color, icon, notificationLimit, size, }: Props$E) => JSX.Element;
548
546
 
549
- /**
550
- * Halstack Color Palette
551
- * @link https://developer.dxc.com/halstack/next/principles/color/#color-tokens-core-color-tokens
552
- */
553
- declare const CoreColorTokens: {
554
- color_black: string;
555
- color_white: string;
556
- color_transparent: string;
557
- color_grey_50: string;
558
- color_grey_100: string;
559
- color_grey_200: string;
560
- color_grey_300: string;
561
- color_grey_400: string;
562
- color_grey_500: string;
563
- color_grey_600: string;
564
- color_grey_700: string;
565
- color_grey_800: string;
566
- color_grey_900: string;
567
- color_grey_50_a: string;
568
- color_grey_100_a: string;
569
- color_grey_200_a: string;
570
- color_grey_300_a: string;
571
- color_grey_400_a: string;
572
- color_grey_500_a: string;
573
- color_grey_600_a: string;
574
- color_grey_700_a: string;
575
- color_grey_800_a: string;
576
- color_grey_900_a: string;
577
- color_purple_50: string;
578
- color_purple_100: string;
579
- color_purple_200: string;
580
- color_purple_300: string;
581
- color_purple_400: string;
582
- color_purple_500: string;
583
- color_purple_600: string;
584
- color_purple_700: string;
585
- color_purple_800: string;
586
- color_purple_900: string;
587
- color_blue_50: string;
588
- color_blue_100: string;
589
- color_blue_200: string;
590
- color_blue_300: string;
591
- color_blue_400: string;
592
- color_blue_500: string;
593
- color_blue_600: string;
594
- color_blue_700: string;
595
- color_blue_800: string;
596
- color_blue_900: string;
597
- color_red_50: string;
598
- color_red_100: string;
599
- color_red_200: string;
600
- color_red_300: string;
601
- color_red_400: string;
602
- color_red_500: string;
603
- color_red_600: string;
604
- color_red_700: string;
605
- color_red_800: string;
606
- color_red_900: string;
607
- color_green_50: string;
608
- color_green_100: string;
609
- color_green_200: string;
610
- color_green_300: string;
611
- color_green_400: string;
612
- color_green_500: string;
613
- color_green_600: string;
614
- color_green_700: string;
615
- color_green_800: string;
616
- color_green_900: string;
617
- color_yellow_50: string;
618
- color_yellow_100: string;
619
- color_yellow_200: string;
620
- color_yellow_300: string;
621
- color_yellow_400: string;
622
- color_yellow_500: string;
623
- color_yellow_600: string;
624
- color_yellow_700: string;
625
- color_yellow_800: string;
626
- color_yellow_900: string;
627
- color_orange_50: string;
628
- color_orange_100: string;
629
- color_orange_200: string;
630
- color_orange_300: string;
631
- color_orange_400: string;
632
- color_orange_500: string;
633
- color_orange_600: string;
634
- color_orange_700: string;
635
- color_orange_800: string;
636
- color_orange_900: string;
637
- };
638
- type CoreColorTokensType = keyof typeof CoreColorTokens;
639
- type CoreSpacingTokensType = "0rem" | "0.125rem" | "0.25rem" | "0.5rem" | "0.75rem" | "1rem" | "1.5rem" | "2rem" | "2.5rem" | "3rem" | "3.5rem" | "4rem" | "5rem" | "6rem" | "7rem";
640
-
641
547
  type Props$D = {
642
548
  /**
643
549
  * Applies the spacing scale to all sides.
644
550
  */
645
- space?: CoreSpacingTokensType;
551
+ space?: string;
646
552
  /**
647
553
  * Applies the spacing scale to the left and right sides.
648
554
  */
649
- horizontal?: CoreSpacingTokensType;
555
+ horizontal?: string;
650
556
  /**
651
557
  * Applies the spacing scale to the top and bottom sides.
652
558
  */
653
- vertical?: CoreSpacingTokensType;
559
+ vertical?: string;
654
560
  /**
655
561
  * Applies the spacing scale to the top side.
656
562
  */
657
- top?: CoreSpacingTokensType;
563
+ top?: string;
658
564
  /**
659
565
  * Applies the spacing scale to the right side.
660
566
  */
661
- right?: CoreSpacingTokensType;
567
+ right?: string;
662
568
  /**
663
569
  * Applies the spacing scale to the bottom side.
664
570
  */
665
- bottom?: CoreSpacingTokensType;
571
+ bottom?: string;
666
572
  /**
667
573
  * Applies the spacing scale to the left side.
668
574
  */
669
- left?: CoreSpacingTokensType;
575
+ left?: string;
670
576
  /**
671
577
  * Custom content inside the bleed.
672
578
  */
673
579
  children: ReactNode;
674
580
  };
675
581
 
676
- declare const Bleed: ({ space, horizontal, vertical, top, right, bottom, left, children }: Props$D) => react_jsx_runtime.JSX.Element;
582
+ declare function DxcBleed({ space, horizontal, vertical, top, right, bottom, left, children }: Props$D): react_jsx_runtime.JSX.Element;
677
583
 
678
584
  type Item$1 = {
679
585
  href?: string;
@@ -755,9 +661,11 @@ declare const DxcBulletedList: {
755
661
  Item: ({ children }: BulletedListItemPropsType) => JSX.Element;
756
662
  };
757
663
 
664
+ type Semantic = "default" | "error" | "warning" | "success" | "info";
665
+ type Mode$1 = "primary" | "secondary" | "tertiary";
758
666
  type Size$3 = {
759
667
  /**
760
- * Height of the component.
668
+ * Height of the button.
761
669
  */
762
670
  height?: "small" | "medium" | "large";
763
671
  width?: "small" | "medium" | "large" | "fillParent" | "fitContent";
@@ -770,11 +678,11 @@ type Props$A = {
770
678
  /**
771
679
  * The available button modes.
772
680
  */
773
- mode?: "primary" | "secondary" | "tertiary";
681
+ mode?: Mode$1;
774
682
  /**
775
683
  * Specifies the semantic meaning of the buttons, which determines its color.
776
684
  */
777
- semantic?: "default" | "error" | "warning" | "success" | "info";
685
+ semantic?: Semantic;
778
686
  /**
779
687
  * If true, the component will be disabled.
780
688
  */
@@ -814,7 +722,7 @@ type Props$A = {
814
722
  tabIndex?: number;
815
723
  };
816
724
 
817
- declare const DxcButton: ({ label, mode, semantic, disabled, iconPosition, title, type, icon, onClick, margin, size, tabIndex, }: Props$A) => JSX.Element;
725
+ declare const DxcButton: ({ disabled, icon, iconPosition, label, margin, mode, onClick, semantic, size, tabIndex, title, type, }: Props$A) => JSX.Element;
818
726
 
819
727
  type Size$2 = {
820
728
  top?: Space$1;
@@ -880,19 +788,22 @@ declare const DxcCard: ({ imageSrc, imageBgColor, imagePadding, imagePosition, l
880
788
 
881
789
  type Props$y = {
882
790
  /**
883
- * Initial state of the checkbox, only when it is uncontrolled.
791
+ * Specifies a string to be used as the name for the checkbox element when no `label` is provided.
884
792
  */
885
- defaultChecked?: boolean;
793
+ ariaLabel?: string;
886
794
  /**
887
795
  * If true, the component is checked. If undefined the component will be
888
796
  * uncontrolled and the value will be managed internally by the component.
889
797
  */
890
798
  checked?: boolean;
891
799
  /**
892
- * Will be passed to the value attribute of the html input element.
893
- * When inside a form, this value will be only submitted if the checkbox is checked.
800
+ * Initial state of the checkbox, only when it is uncontrolled.
894
801
  */
895
- value?: string;
802
+ defaultChecked?: boolean;
803
+ /**
804
+ * If true, the component will be disabled.
805
+ */
806
+ disabled?: boolean;
896
807
  /**
897
808
  * Text to be placed next to the checkbox.
898
809
  */
@@ -901,14 +812,22 @@ type Props$y = {
901
812
  * Whether the label should appear after or before the checkbox.
902
813
  */
903
814
  labelPosition?: "before" | "after";
815
+ /**
816
+ * Size of the margin to be applied to the component
817
+ * ('xxsmall' | 'xsmall' | 'small' | 'medium' | 'large' | 'xlarge' | 'xxlarge').
818
+ * You can pass an object with 'top', 'bottom', 'left' and 'right' properties
819
+ * in order to specify different margin sizes.
820
+ */
821
+ margin?: Space$1 | Margin;
904
822
  /**
905
823
  * Name attribute of the input element.
906
824
  */
907
825
  name?: string;
908
826
  /**
909
- * If true, the component will be disabled.
827
+ * This function will be called when the user clicks the checkbox.
828
+ * The new value will be passed as a parameter.
910
829
  */
911
- disabled?: boolean;
830
+ onChange?: (value: boolean) => void;
912
831
  /**
913
832
  * If true, the component will display '(Optional)' next to the label.
914
833
  */
@@ -917,18 +836,6 @@ type Props$y = {
917
836
  * If true, the component will not be mutable, meaning the user can not edit the control.
918
837
  */
919
838
  readOnly?: boolean;
920
- /**
921
- * This function will be called when the user clicks the checkbox.
922
- * The new value will be passed as a parameter.
923
- */
924
- onChange?: (value: boolean) => void;
925
- /**
926
- * Size of the margin to be applied to the component
927
- * ('xxsmall' | 'xsmall' | 'small' | 'medium' | 'large' | 'xlarge' | 'xxlarge').
928
- * You can pass an object with 'top', 'bottom', 'left' and 'right' properties
929
- * in order to specify different margin sizes.
930
- */
931
- margin?: Space$1 | Margin;
932
839
  /**
933
840
  * Size of the component.
934
841
  */
@@ -938,9 +845,10 @@ type Props$y = {
938
845
  */
939
846
  tabIndex?: number;
940
847
  /**
941
- * Specifies a string to be used as the name for the checkbox element when no `label` is provided.
848
+ * Will be passed to the value attribute of the html input element.
849
+ * When inside a form, this value will be only submitted if the checkbox is checked.
942
850
  */
943
- ariaLabel?: string;
851
+ value?: string;
944
852
  };
945
853
 
946
854
  declare const DxcCheckbox: react.ForwardRefExoticComponent<Props$y & react.RefAttributes<HTMLDivElement>>;
@@ -981,15 +889,15 @@ type Props$x = {
981
889
  tabIndex?: number;
982
890
  };
983
891
 
984
- declare const DxcChip: ({ label, suffixIcon, prefixIcon, onClickSuffix, onClickPrefix, disabled, margin, tabIndex, }: Props$x) => JSX.Element;
892
+ declare const DxcChip: ({ label, suffixIcon, prefixIcon, onClickSuffix, onClickPrefix, disabled, margin, tabIndex, }: Props$x) => react_jsx_runtime.JSX.Element;
985
893
 
986
- type Space = Space$1 | {
987
- top?: Space$1;
988
- right?: Space$1;
989
- bottom?: Space$1;
990
- left?: Space$1;
894
+ type Space = {
895
+ top?: string;
896
+ right?: string;
897
+ bottom?: string;
898
+ left?: string;
991
899
  };
992
- type Inset$1 = {
900
+ type Inset = {
993
901
  top?: string;
994
902
  right?: string;
995
903
  bottom?: string;
@@ -998,7 +906,7 @@ type Inset$1 = {
998
906
  type Background = {
999
907
  attachment?: string;
1000
908
  clip?: string;
1001
- color?: CoreColorTokensType;
909
+ color?: string;
1002
910
  image?: string;
1003
911
  origin?: string;
1004
912
  position?: string;
@@ -1007,8 +915,8 @@ type Background = {
1007
915
  };
1008
916
  type BorderProperties = {
1009
917
  width?: string;
1010
- style?: "none" | "dotted" | "dashed" | "solid" | "double" | "groove" | "ridge" | "inset" | "outset";
1011
- color?: CoreColorTokensType;
918
+ style?: string;
919
+ color?: string;
1012
920
  };
1013
921
  type Border = BorderProperties | {
1014
922
  top?: BorderProperties;
@@ -1056,7 +964,7 @@ type Props$w = {
1056
964
  /**
1057
965
  * Custom content inside the container.
1058
966
  */
1059
- children: ReactNode;
967
+ children?: ReactNode;
1060
968
  /**
1061
969
  * Sets the display CSS property.
1062
970
  * The set of values is limited to the ones related to the outer display type.
@@ -1082,19 +990,11 @@ type Props$w = {
1082
990
  * Based on the CSS property inset this prop is a shorthand that corresponds
1083
991
  * to the top, right, bottom, and/or left properties.
1084
992
  */
1085
- inset?: Inset$1;
993
+ inset?: Inset;
1086
994
  /**
1087
- * Size of the margin to be applied to the component.
1088
- * You can pass an object with 'top', 'bottom', 'left' and 'right' properties
1089
- * in order to specify different margin sizes.
995
+ * Size of the margin to be applied to the container.
1090
996
  */
1091
- margin?: Space;
1092
- /**
1093
- * Sets the max-height CSS property.
1094
- *
1095
- * See MDN: https://developer.mozilla.org/en-US/docs/Web/CSS/max-height
1096
- */
1097
- maxWidth?: string;
997
+ margin?: string | Space;
1098
998
  /**
1099
999
  * Sets the max-width CSS property.
1100
1000
  *
@@ -1102,17 +1002,23 @@ type Props$w = {
1102
1002
  */
1103
1003
  maxHeight?: string;
1104
1004
  /**
1105
- * Sets the min-height CSS property.
1005
+ * Sets the max-height CSS property.
1106
1006
  *
1107
- * See MDN: https://developer.mozilla.org/en-US/docs/Web/CSS/min-height
1007
+ * See MDN: https://developer.mozilla.org/en-US/docs/Web/CSS/max-height
1108
1008
  */
1109
- minWidth?: string;
1009
+ maxWidth?: string;
1110
1010
  /**
1111
1011
  * Sets the min-width CSS property.
1112
1012
  *
1113
1013
  * See MDN: https://developer.mozilla.org/en-US/docs/Web/CSS/min-width
1114
1014
  */
1115
1015
  minHeight?: string;
1016
+ /**
1017
+ * Sets the min-height CSS property.
1018
+ *
1019
+ * See MDN: https://developer.mozilla.org/en-US/docs/Web/CSS/min-height
1020
+ */
1021
+ minWidth?: string;
1116
1022
  /**
1117
1023
  * Based on the CSS property outline allows configuring all properties related
1118
1024
  * to the outline of a container.
@@ -1125,11 +1031,9 @@ type Props$w = {
1125
1031
  */
1126
1032
  overflow?: Overflow;
1127
1033
  /**
1128
- * Size of the margin to be applied to the component.
1129
- * You can pass an object with 'top', 'bottom', 'left' and 'right' properties
1130
- * in order to specify different margin sizes.
1034
+ * Size of the padding to be applied to the container.
1131
1035
  */
1132
- padding?: Space;
1036
+ padding?: string | Space;
1133
1037
  /**
1134
1038
  * Sets the position CSS property.
1135
1039
  *
@@ -1194,7 +1098,7 @@ type ActionsPropsType = Array<{
1194
1098
  onClick: (value?: string) => void;
1195
1099
  disabled?: boolean;
1196
1100
  tabIndex?: number;
1197
- options: Option$1[];
1101
+ options: Option$2[];
1198
1102
  }>;
1199
1103
  type Props$u = {
1200
1104
  /**
@@ -1265,6 +1169,7 @@ type HierarchyGridRow = GridRow & {
1265
1169
  type ExpandableGridRow = GridRow & {
1266
1170
  expandedContent?: ReactNode;
1267
1171
  expandedContentHeight?: number;
1172
+ contentIsExpanded?: boolean;
1268
1173
  };
1269
1174
  type ExpandableRows = {
1270
1175
  rows: ExpandableGridRow[];
@@ -1341,6 +1246,10 @@ type PaginatedProps$1 = {
1341
1246
  * Function called whenever the current page is changed.
1342
1247
  */
1343
1248
  onPageChange?: (_page: number) => void;
1249
+ /**
1250
+ * Default page in which the datagrid is rendered
1251
+ */
1252
+ defaultPage?: number;
1344
1253
  };
1345
1254
  type NonPaginatedProps$1 = {
1346
1255
  /**
@@ -1372,6 +1281,10 @@ type NonPaginatedProps$1 = {
1372
1281
  * Function called whenever the current page is changed.
1373
1282
  */
1374
1283
  onPageChange?: never;
1284
+ /**
1285
+ * Default page in which the datagrid is rendered
1286
+ */
1287
+ defaultPage?: never;
1375
1288
  };
1376
1289
  type CommonProps$6 = {
1377
1290
  columns: GridColumn[];
@@ -1399,7 +1312,7 @@ type BasicGridProps = {
1399
1312
  type Props$t = CommonProps$6 & (PaginatedProps$1 | NonPaginatedProps$1) & ((BasicGridProps & SelectableGridProps) | (ExpandableRows & SelectableGridProps) | (HierarchyRows & SelectableGridProps));
1400
1313
 
1401
1314
  declare const DxcDataGrid: {
1402
- ({ columns, rows, selectable, expandable, onSelectRows, selectedRows, uniqueRowId, summaryRow, onGridRowsChange, showPaginator, showGoToPage, itemsPerPage, itemsPerPageOptions, itemsPerPageFunction, onSort, onPageChange, totalItems, }: Props$t): JSX.Element;
1315
+ ({ columns, rows, selectable, expandable, onSelectRows, selectedRows, uniqueRowId, summaryRow, onGridRowsChange, showPaginator, showGoToPage, itemsPerPage, itemsPerPageOptions, itemsPerPageFunction, onSort, onPageChange, totalItems, defaultPage, }: Props$t): JSX.Element;
1403
1316
  ActionsCell: ({ actions }: ActionCellsPropsType) => JSX.Element;
1404
1317
  };
1405
1318
 
@@ -1569,9 +1482,9 @@ type Props$q = {
1569
1482
  decorative?: boolean;
1570
1483
  };
1571
1484
 
1572
- declare const DxcDivider: ({ orientation, weight, color, decorative, }: Props$q) => JSX.Element;
1485
+ declare const DxcDivider: ({ orientation, weight, color, decorative, }: Props$q) => react_jsx_runtime.JSX.Element;
1573
1486
 
1574
- declare const DxcDropdown: ({ options, optionsIconPosition, icon, iconPosition, label, caretHidden, disabled, expandOnHover, onSelectOption, margin, size, tabIndex, title, }: Props$G) => JSX.Element;
1487
+ declare const DxcDropdown: ({ options, optionsIconPosition, icon, iconPosition, label, caretHidden, disabled, expandOnHover, onSelectOption, margin, size, tabIndex, title, }: Props$G) => react_jsx_runtime.JSX.Element;
1575
1488
 
1576
1489
  type FileData = {
1577
1490
  /**
@@ -1677,12 +1590,12 @@ type Props$p = DropModeProps | FileModeProps;
1677
1590
  declare const DxcFileInput: react.ForwardRefExoticComponent<Props$p & react.RefAttributes<HTMLDivElement>>;
1678
1591
 
1679
1592
  type Gap$1 = {
1680
- rowGap: CoreSpacingTokensType;
1681
- columnGap?: CoreSpacingTokensType;
1593
+ rowGap: string;
1594
+ columnGap?: string;
1682
1595
  } | {
1683
- rowGap?: CoreSpacingTokensType;
1684
- columnGap: CoreSpacingTokensType;
1685
- } | CoreSpacingTokensType;
1596
+ rowGap?: string;
1597
+ columnGap: string;
1598
+ } | string;
1686
1599
  type CommonProps$4 = {
1687
1600
  /**
1688
1601
  * Sets the justify-content CSS property.
@@ -1764,47 +1677,49 @@ type Props$o = CommonProps$4 & {
1764
1677
 
1765
1678
  declare const DxcFlex: ({ basis, direction, gap, grow, order, shrink, wrap, ...props }: Props$o) => react_jsx_runtime.JSX.Element;
1766
1679
 
1767
- type Gap = {
1768
- rowGap: CoreSpacingTokensType;
1769
- columnGap?: CoreSpacingTokensType;
1680
+ type Gap = string | {
1681
+ columnGap?: string;
1682
+ rowGap: string;
1770
1683
  } | {
1771
- rowGap?: CoreSpacingTokensType;
1772
- columnGap: CoreSpacingTokensType;
1773
- } | CoreSpacingTokensType;
1684
+ columnGap: string;
1685
+ rowGap?: string;
1686
+ };
1774
1687
  type GridCell = {
1775
- start: number | string;
1776
1688
  end: number | string;
1689
+ start: number | string;
1777
1690
  };
1778
- type PlaceSelfValues = "auto" | "start" | "end" | "center" | "stretch" | "baseline";
1779
- type PlaceContentValues = "normal" | "start" | "end" | "center" | "stretch" | "space-between" | "space-around" | "space-evenly" | "baseline";
1780
- type PlaceItemsValues = "normal" | "start" | "end" | "center" | "stretch" | "baseline";
1691
+ type PlaceSelfValues = "auto" | "baseline" | "center" | "end" | "start" | "stretch";
1692
+ type PlaceContentValues = "baseline" | "center" | "end" | "normal" | "space-around" | "space-between" | "space-evenly" | "start" | "stretch";
1693
+ type PlaceItemsValues = "baseline" | "center" | "end" | "normal" | "start" | "stretch";
1781
1694
  type PlaceObject<Type, Suffix extends string> = {
1782
1695
  [Property in keyof Type as `${string & Property}${Capitalize<string & Suffix>}`]: Type[Property];
1783
1696
  };
1784
1697
  type PlaceGeneric<PlaceValues, Element extends string> = PlaceObject<{
1785
- justify?: PlaceValues;
1786
1698
  align: PlaceValues;
1699
+ justify?: PlaceValues;
1787
1700
  }, Element> | PlaceObject<{
1788
- justify: PlaceValues;
1789
1701
  align?: PlaceValues;
1702
+ justify: PlaceValues;
1790
1703
  }, Element> | PlaceValues;
1791
1704
  type GridItemProps = {
1792
1705
  /**
1793
1706
  * Sets the name of an item so that it can be referenced by a template created with the grid-template-areas property.
1794
1707
  */
1795
1708
  areaName?: string;
1709
+ /**
1710
+ * Sets a custom HTML tag.
1711
+ */
1712
+ as?: keyof HTMLElementTagNameMap;
1713
+ /**
1714
+ * Custom content inside the grid container.
1715
+ */
1716
+ children: ReactNode;
1796
1717
  /**
1797
1718
  * Sets the grid-column CSS property.
1798
1719
  *
1799
1720
  * See MDN: https://developer.mozilla.org/en-US/docs/Web/CSS/grid-column
1800
1721
  */
1801
1722
  column?: number | string | GridCell;
1802
- /**
1803
- * Sets the grid-row CSS property.
1804
- *
1805
- * See MDN: https://developer.mozilla.org/en-US/docs/Web/CSS/grid-row
1806
- */
1807
- row?: number | string | GridCell;
1808
1723
  /**
1809
1724
  * Sets the place-self CSS property.
1810
1725
  *
@@ -1812,13 +1727,11 @@ type GridItemProps = {
1812
1727
  */
1813
1728
  placeSelf?: PlaceGeneric<PlaceSelfValues, "self">;
1814
1729
  /**
1815
- * Sets a custom HTML tag.
1816
- */
1817
- as?: keyof HTMLElementTagNameMap;
1818
- /**
1819
- * Custom content inside the grid container.
1730
+ * Sets the grid-row CSS property.
1731
+ *
1732
+ * See MDN: https://developer.mozilla.org/en-US/docs/Web/CSS/grid-row
1820
1733
  */
1821
- children: ReactNode;
1734
+ row?: number | string | GridCell;
1822
1735
  };
1823
1736
  type Props$n = GridItemProps & {
1824
1737
  /**
@@ -1844,7 +1757,7 @@ type Props$n = GridItemProps & {
1844
1757
  *
1845
1758
  * See MDN: https://developer.mozilla.org/en-US/docs/Web/CSS/gap
1846
1759
  */
1847
- gap?: CoreSpacingTokensType | Gap;
1760
+ gap?: Gap;
1848
1761
  /**
1849
1762
  * Sets the place-content CSS property.
1850
1763
  *
@@ -1980,40 +1893,40 @@ declare function DxcImage({ alt, caption, lazyLoading, src, srcSet, sizes, width
1980
1893
 
1981
1894
  type Props$k = {
1982
1895
  /**
1983
- * Applies the spacing scale to all sides.
1896
+ * Applies the spacing scale to the bottom side.
1984
1897
  */
1985
- space?: CoreSpacingTokensType;
1898
+ bottom?: string;
1986
1899
  /**
1987
- * Applies the spacing scale to the left and right sides.
1900
+ * Custom content inside the inset.
1988
1901
  */
1989
- horizontal?: CoreSpacingTokensType;
1902
+ children: ReactNode;
1990
1903
  /**
1991
- * Applies the spacing scale to the top and bottom sides.
1904
+ * Applies the spacing scale to the left and right sides.
1992
1905
  */
1993
- vertical?: CoreSpacingTokensType;
1906
+ horizontal?: string;
1994
1907
  /**
1995
- * Applies the spacing scale to the top side.
1908
+ * Applies the spacing scale to the left side.
1996
1909
  */
1997
- top?: CoreSpacingTokensType;
1910
+ left?: string;
1998
1911
  /**
1999
1912
  * Applies the spacing scale to the right side.
2000
1913
  */
2001
- right?: CoreSpacingTokensType;
1914
+ right?: string;
2002
1915
  /**
2003
- * Applies the spacing scale to the bottom side.
1916
+ * Applies the spacing scale to all sides.
2004
1917
  */
2005
- bottom?: CoreSpacingTokensType;
1918
+ space?: string;
2006
1919
  /**
2007
- * Applies the spacing scale to the left side.
1920
+ * Applies the spacing scale to the top side.
2008
1921
  */
2009
- left?: CoreSpacingTokensType;
1922
+ top?: string;
2010
1923
  /**
2011
- * Custom content inside the inset.
1924
+ * Applies the spacing scale to the top and bottom sides.
2012
1925
  */
2013
- children: ReactNode;
1926
+ vertical?: string;
2014
1927
  };
2015
1928
 
2016
- declare const Inset: ({ space, horizontal, vertical, top, right, bottom, left, children }: Props$k) => react_jsx_runtime.JSX.Element;
1929
+ declare function DxcInset({ bottom, children, horizontal, left, right, space, top, vertical }: Props$k): react_jsx_runtime.JSX.Element;
2017
1930
 
2018
1931
  type LinkProps = {
2019
1932
  /**
@@ -2233,6 +2146,10 @@ type Props$i = {
2233
2146
  * Specifies a string to be used as the name for the number input element when no `label` is provided.
2234
2147
  */
2235
2148
  ariaLabel?: string;
2149
+ /**
2150
+ * Decides whether the number input has actions to increase or decrease the value, following the defined step.
2151
+ */
2152
+ showControls?: boolean;
2236
2153
  };
2237
2154
 
2238
2155
  declare const DxcNumberInput: react.ForwardRefExoticComponent<Props$i & react.RefAttributes<HTMLDivElement>>;
@@ -2452,7 +2369,7 @@ type Props$e = {
2452
2369
 
2453
2370
  declare const DxcQuickNav: ({ title, links }: Props$e) => JSX.Element;
2454
2371
 
2455
- type RadioOption = {
2372
+ type Option$1 = {
2456
2373
  /**
2457
2374
  * Label of the option placed next to the radio input.
2458
2375
  */
@@ -2470,26 +2387,39 @@ type RadioOption = {
2470
2387
  };
2471
2388
  type RadioGroupProps = {
2472
2389
  /**
2473
- * Text to be placed above the radio group.
2390
+ * Specifies a string to be used as the name for the radio group when no `label` is provided.
2474
2391
  */
2475
- label?: string;
2392
+ ariaLabel?: string;
2476
2393
  /**
2477
- * Name attribute of the input element. This attribute will allow users
2478
- * to find the component's value during the submit event.
2394
+ * Initial value of the radio group, only when it is uncontrolled.
2479
2395
  */
2480
- name?: string;
2396
+ defaultValue?: string;
2397
+ /**
2398
+ * If true, the component will be disabled.
2399
+ */
2400
+ disabled?: boolean;
2401
+ /**
2402
+ * If it is a defined value and also a truthy string, the component will
2403
+ * change its appearance, showing the error below the radio group. If the
2404
+ * defined value is an empty string, it will reserve a space below the
2405
+ * component for a future error, but it would not change its look. In
2406
+ * case of being undefined or null, both the appearance and the space for
2407
+ * the error message would not be modified.
2408
+ */
2409
+ error?: string;
2481
2410
  /**
2482
2411
  * Helper text to be placed above the radio group.
2483
2412
  */
2484
2413
  helperText?: string;
2485
2414
  /**
2486
- * An array of objects representing the selectable options.
2415
+ * Text to be placed above the radio group.
2487
2416
  */
2488
- options: RadioOption[];
2417
+ label?: string;
2489
2418
  /**
2490
- * If true, the component will be disabled.
2419
+ * Name attribute of the input element. This attribute will allow users
2420
+ * to find the component's value during the submit event.
2491
2421
  */
2492
- disabled?: boolean;
2422
+ name?: string;
2493
2423
  /**
2494
2424
  * If true, the radio group will be optional, showing
2495
2425
  * (Optional) next to the label and adding a default last
@@ -2503,28 +2433,9 @@ type RadioGroupProps = {
2503
2433
  */
2504
2434
  optionalItemLabel?: string;
2505
2435
  /**
2506
- * If true, the component will not be mutable, meaning the user can not edit the control.
2507
- */
2508
- readOnly?: boolean;
2509
- /**
2510
- * Sets the orientation of the options within the radio group.
2511
- */
2512
- stacking?: "row" | "column";
2513
- /**
2514
- * Initial value of the radio group, only when it is uncontrolled.
2515
- */
2516
- defaultValue?: string;
2517
- /**
2518
- * Value of the radio group. If undefined, the component will be
2519
- * uncontrolled and the value will be managed internally by the
2520
- * component.
2521
- */
2522
- value?: string;
2523
- /**
2524
- * This function will be called when the user chooses an option. The new
2525
- * value will be passed to this function.
2436
+ * An array of objects representing the selectable options.
2526
2437
  */
2527
- onChange?: (value: string) => void;
2438
+ options: Option$1[];
2528
2439
  /**
2529
2440
  * This function will be called when the radio group loses the focus. An
2530
2441
  * object including the value and the error will be passed to this
@@ -2535,18 +2446,28 @@ type RadioGroupProps = {
2535
2446
  error?: string;
2536
2447
  }) => void;
2537
2448
  /**
2538
- * If it is a defined value and also a truthy string, the component will
2539
- * change its appearance, showing the error below the radio group. If the
2540
- * defined value is an empty string, it will reserve a space below the
2541
- * component for a future error, but it would not change its look. In
2542
- * case of being undefined or null, both the appearance and the space for
2543
- * the error message would not be modified.
2449
+ * This function will be called when the user chooses an option. The new
2450
+ * value will be passed to this function.
2544
2451
  */
2545
- error?: string;
2452
+ onChange?: (value: string) => void;
2453
+ /**
2454
+ * If true, the component will not be mutable, meaning the user can not edit the control.
2455
+ */
2456
+ readOnly?: boolean;
2457
+ /**
2458
+ * Sets the orientation of the options within the radio group.
2459
+ */
2460
+ stacking?: "row" | "column";
2546
2461
  /**
2547
2462
  * Value of the tabindex attribute.
2548
2463
  */
2549
2464
  tabIndex?: number;
2465
+ /**
2466
+ * Value of the radio group. If undefined, the component will be
2467
+ * uncontrolled and the value will be managed internally by the
2468
+ * component.
2469
+ */
2470
+ value?: string;
2550
2471
  };
2551
2472
 
2552
2473
  declare const DxcRadioGroup: react.ForwardRefExoticComponent<RadioGroupProps & react.RefAttributes<HTMLDivElement>>;
@@ -2824,53 +2745,51 @@ declare const DxcSelect: react.ForwardRefExoticComponent<Props$c & react.RefAttr
2824
2745
 
2825
2746
  type Props$b = {
2826
2747
  /**
2827
- * Text to be placed above the slider.
2828
- */
2829
- label?: string;
2830
- /**
2831
- * Name attribute of the input element.
2748
+ * Specifies a string to be used as the name for the slider element when no `label` is provided.
2832
2749
  */
2833
- name?: string;
2750
+ ariaLabel?: string;
2834
2751
  /**
2835
2752
  * Initial value of the slider, only when it is uncontrolled.
2836
2753
  */
2837
2754
  defaultValue?: number;
2838
2755
  /**
2839
- * The selected value. If undefined, the component will be uncontrolled and the value will be managed internally by the component.
2756
+ * If true, the component will be disabled.
2840
2757
  */
2841
- value?: number;
2758
+ disabled?: boolean;
2842
2759
  /**
2843
2760
  * Helper text to be placed above the slider.
2844
2761
  */
2845
2762
  helperText?: string;
2846
2763
  /**
2847
- * The minimum value available for selection.
2764
+ * Text to be placed above the slider.
2848
2765
  */
2849
- minValue?: number;
2766
+ label?: string;
2850
2767
  /**
2851
- * The maximum value available for selection.
2768
+ * This function will be used to format the labels displayed next to the slider.
2769
+ * The value will be passed as parameter and the function must return the formatted value.
2852
2770
  */
2853
- maxValue?: number;
2771
+ labelFormatCallback?: (value: number) => string;
2854
2772
  /**
2855
- * The step interval between values available for selection.
2773
+ * Size of the margin to be applied to the component ('xxsmall' | 'xsmall' | 'small' | 'medium' | 'large' | 'xlarge' | 'xxlarge').
2774
+ * You can pass an object with 'top', 'bottom', 'left' and 'right' properties in order to specify different margin sizes.
2856
2775
  */
2857
- step?: number;
2776
+ margin?: Space$1 | Margin;
2858
2777
  /**
2859
- * Whether the min/max value labels should be displayed next to the slider
2778
+ * Whether the marks between each step should be shown or not.
2860
2779
  */
2861
- showLimitsValues?: boolean;
2780
+ marks?: boolean;
2862
2781
  /**
2863
- * Whether the input element for displaying/controlling the slider value should be displayed next to the slider.
2782
+ * The maximum value available for selection.
2864
2783
  */
2865
- showInput?: boolean;
2784
+ maxValue?: number;
2866
2785
  /**
2867
- * If true, the component will be disabled.
2786
+ * The minimum value available for selection.
2868
2787
  */
2869
- disabled?: boolean;
2788
+ minValue?: number;
2870
2789
  /**
2871
- * Whether the marks between each step should be shown or not.
2790
+ * Name attribute of the input element.
2872
2791
  */
2873
- marks?: boolean;
2792
+ name?: string;
2874
2793
  /**
2875
2794
  * This function will be called when the slider changes its value, as it's being dragged.
2876
2795
  * The new value will be passed as a parameter when this function is executed.
@@ -2882,53 +2801,64 @@ type Props$b = {
2882
2801
  */
2883
2802
  onDragEnd?: (value: number) => void;
2884
2803
  /**
2885
- * This function will be used to format the labels displayed next to the slider.
2886
- * The value will be passed as parameter and the function must return the formatted value.
2804
+ * Whether the input element for displaying/controlling the slider value should be displayed next to the slider.
2887
2805
  */
2888
- labelFormatCallback?: (value: number) => string;
2806
+ showInput?: boolean;
2889
2807
  /**
2890
- * Size of the margin to be applied to the component ('xxsmall' | 'xsmall' | 'small' | 'medium' | 'large' | 'xlarge' | 'xxlarge').
2891
- * You can pass an object with 'top', 'bottom', 'left' and 'right' properties in order to specify different margin sizes.
2808
+ * Whether the min/max value labels should be displayed next to the slider
2892
2809
  */
2893
- margin?: Space$1 | Margin;
2810
+ showLimitsValues?: boolean;
2894
2811
  /**
2895
2812
  * Size of the component.
2896
2813
  */
2897
2814
  size?: "medium" | "large" | "fillParent";
2898
2815
  /**
2899
- * Specifies a string to be used as the name for the slider element when no `label` is provided.
2816
+ * The step interval between values available for selection.
2900
2817
  */
2901
- ariaLabel?: string;
2818
+ step?: number;
2819
+ /**
2820
+ * The selected value. If undefined, the component will be uncontrolled and the value will be managed internally by the component.
2821
+ */
2822
+ value?: number;
2902
2823
  };
2903
2824
 
2904
2825
  declare const DxcSlider: react.ForwardRefExoticComponent<Props$b & react.RefAttributes<HTMLDivElement>>;
2905
2826
 
2906
2827
  type Props$a = {
2907
2828
  /**
2908
- * Text to be placed inside the spinner.
2829
+ * Specifies a string to be used as the name for the spinner element when no `label` is provided or the `mode` is set to small.
2909
2830
  */
2910
- label?: string;
2831
+ ariaLabel?: string;
2911
2832
  /**
2912
- * The value of the progress indicator. If it's received the
2913
- * component is determinate, otherwise is indeterminate.
2833
+ * If true, the color is inherited from the closest parent with a defined color. This allows users to adapt the spinner
2834
+ * to the semantic color of the use case in which it is used.
2914
2835
  */
2915
- value?: number;
2836
+ inheritColor?: boolean;
2916
2837
  /**
2917
- * If true, the value is displayed inside the spinner..
2838
+ * Text to be placed inside the spinner.
2918
2839
  */
2919
- showValue?: boolean;
2840
+ label?: string;
2841
+ /**
2842
+ * Size of the margin to be applied to the component ('xxsmall' | 'xsmall' | 'small' | 'medium' | 'large' | 'xlarge' | 'xxlarge').
2843
+ * You can pass an object with 'top', 'bottom', 'left' and 'right' properties in order to specify different margin sizes.
2844
+ */
2845
+ margin?: Space$1 | Margin;
2920
2846
  /**
2921
2847
  * Available modes of the spinner.
2922
2848
  */
2923
2849
  mode?: "large" | "small" | "overlay";
2924
2850
  /**
2925
- * Size of the margin to be applied to the component ('xxsmall' | 'xsmall' | 'small' | 'medium' | 'large' | 'xlarge' | 'xxlarge').
2926
- * You can pass an object with 'top', 'bottom', 'left' and 'right' properties in order to specify different margin sizes.
2851
+ * If true, the value is displayed inside the spinner..
2927
2852
  */
2928
- margin?: Space$1 | Margin;
2853
+ showValue?: boolean;
2854
+ /**
2855
+ * The value of the progress indicator. If it's received the
2856
+ * component is determinate, otherwise is indeterminate.
2857
+ */
2858
+ value?: number;
2929
2859
  };
2930
2860
 
2931
- declare const DxcSpinner: ({ label, value, showValue, mode, margin }: Props$a) => JSX.Element;
2861
+ declare const DxcSpinner: ({ ariaLabel, inheritColor, label, margin, mode, showValue, value, }: Props$a) => react_jsx_runtime.JSX.Element;
2932
2862
 
2933
2863
  type Mode = "default" | "info" | "success" | "warning" | "error";
2934
2864
  type Size = "small" | "medium" | "large";
@@ -2947,23 +2877,26 @@ type Props$9 = {
2947
2877
  size?: Size;
2948
2878
  };
2949
2879
 
2950
- declare const DxcStatusLight: ({ mode, label, size }: Props$9) => JSX.Element;
2880
+ declare function DxcStatusLight({ label, mode, size }: Props$9): react_jsx_runtime.JSX.Element;
2951
2881
 
2952
2882
  type Props$8 = {
2953
2883
  /**
2954
- * Initial state of the switch, only when it is uncontrolled.
2884
+ * Specifies a string to be used as the name for the switch element when no `label` is provided.
2955
2885
  */
2956
- defaultChecked?: boolean;
2886
+ ariaLabel?: string;
2957
2887
  /**
2958
2888
  * If true, the component is checked. If undefined, the component will be uncontrolled
2959
2889
  * and the checked attribute will be managed internally by the component.
2960
2890
  */
2961
2891
  checked?: boolean;
2962
2892
  /**
2963
- * Will be passed to the value attribute of the html input element. When inside a form,
2964
- * this value will be only submitted if the switch is checked.
2893
+ * Initial state of the switch, only when it is uncontrolled.
2965
2894
  */
2966
- value?: string;
2895
+ defaultChecked?: boolean;
2896
+ /**
2897
+ * If true, the component will be disabled.
2898
+ */
2899
+ disabled?: boolean;
2967
2900
  /**
2968
2901
  * Text to be placed next to the switch.
2969
2902
  */
@@ -2973,13 +2906,14 @@ type Props$8 = {
2973
2906
  */
2974
2907
  labelPosition?: "before" | "after";
2975
2908
  /**
2976
- * Name attribute of the input element.
2909
+ * Size of the margin to be applied to the component ('xxsmall' | 'xsmall' | 'small' | 'medium' | 'large' | 'xlarge' | 'xxlarge').
2910
+ * You can pass an object with 'top', 'bottom', 'left' and 'right' properties in order to specify different margin sizes.
2977
2911
  */
2978
- name?: string;
2912
+ margin?: Space$1 | Margin;
2979
2913
  /**
2980
- * If true, the component will be disabled.
2914
+ * Name attribute of the input element.
2981
2915
  */
2982
- disabled?: boolean;
2916
+ name?: string;
2983
2917
  /**
2984
2918
  * This function will be called when the user changes the state of the switch.
2985
2919
  * The new value of the checked attribute will be passed as a parameter.
@@ -2989,11 +2923,6 @@ type Props$8 = {
2989
2923
  * If true, the component will display '(Optional)' next to the label.
2990
2924
  */
2991
2925
  optional?: boolean;
2992
- /**
2993
- * Size of the margin to be applied to the component ('xxsmall' | 'xsmall' | 'small' | 'medium' | 'large' | 'xlarge' | 'xxlarge').
2994
- * You can pass an object with 'top', 'bottom', 'left' and 'right' properties in order to specify different margin sizes.
2995
- */
2996
- margin?: Space$1 | Margin;
2997
2926
  /**
2998
2927
  * Size of the component.
2999
2928
  */
@@ -3003,9 +2932,10 @@ type Props$8 = {
3003
2932
  */
3004
2933
  tabIndex?: number;
3005
2934
  /**
3006
- * Specifies a string to be used as the name for the switch element when no `label` is provided.
2935
+ * Will be passed to the value attribute of the html input element. When inside a form,
2936
+ * this value will be only submitted if the switch is checked.
3007
2937
  */
3008
- ariaLabel?: string;
2938
+ value?: string;
3009
2939
  };
3010
2940
 
3011
2941
  declare const DxcSwitch: react.ForwardRefExoticComponent<Props$8 & react.RefAttributes<HTMLDivElement>>;
@@ -3063,41 +2993,46 @@ type TabProps = {
3063
2993
  };
3064
2994
  type LegacyProps = {
3065
2995
  /**
3066
- * Initially active tab, only when it is uncontrolled.
3067
- */
3068
- defaultActiveTabIndex?: number;
3069
- /**
2996
+ * @deprecated This prop is deprecated and will be removed in future versions. Use the children prop instead.
3070
2997
  * The index of the active tab. If undefined, the component will be
3071
2998
  * uncontrolled and the active tab will be managed internally by the component.
3072
2999
  */
3073
3000
  activeTabIndex?: number;
3074
3001
  /**
3075
- * An array of objects representing the tabs.
3002
+ * @deprecated This prop is deprecated and will be removed in future versions.
3003
+ * Initially active tab, only when it is uncontrolled.
3076
3004
  */
3077
- tabs?: (TabLabelProps | TabIconProps)[];
3005
+ defaultActiveTabIndex?: number;
3078
3006
  /**
3079
3007
  * Whether the icon should appear above or to the left of the label.
3080
3008
  */
3081
3009
  iconPosition?: "top" | "left";
3082
3010
  /**
3011
+ * Size of the margin to be applied to the component ('xxsmall' | 'xsmall' | 'small' | 'medium' | 'large' | 'xlarge' | 'xxlarge').
3012
+ * You can pass an object with 'top', 'bottom', 'left' and 'right' properties in order to specify different margin sizes.
3013
+ */
3014
+ margin?: Space$1 | Margin;
3015
+ /**
3016
+ * @deprecated This prop is deprecated and will be removed in future versions.
3083
3017
  * This function will be called when the user clicks on a tab. The index of the
3084
3018
  * clicked tab will be passed as a parameter.
3085
3019
  */
3086
3020
  onTabClick?: (index: number) => void;
3087
3021
  /**
3022
+ * @deprecated This prop is deprecated and will be removed in future versions.
3088
3023
  * This function will be called when the user hovers a tab.The index of the
3089
3024
  * hovered tab will be passed as a parameter.
3090
3025
  */
3091
3026
  onTabHover?: (index: number | null) => void;
3092
- /**
3093
- * Size of the margin to be applied to the component ('xxsmall' | 'xsmall' | 'small' | 'medium' | 'large' | 'xlarge' | 'xxlarge').
3094
- * You can pass an object with 'top', 'bottom', 'left' and 'right' properties in order to specify different margin sizes.
3095
- */
3096
- margin?: Space$1 | Margin;
3097
3027
  /**
3098
3028
  * Value of the tabindex attribute applied to each tab.
3099
3029
  */
3100
3030
  tabIndex?: number;
3031
+ /**
3032
+ * @deprecated This prop is deprecated and will be removed in future versions.
3033
+ * An array of objects representing the tabs.
3034
+ */
3035
+ tabs?: (TabLabelProps | TabIconProps)[];
3101
3036
  };
3102
3037
  type NewProps = {
3103
3038
  /**
@@ -3121,7 +3056,7 @@ type NewProps = {
3121
3056
  type Props$7 = LegacyProps & NewProps;
3122
3057
 
3123
3058
  declare const DxcTabs: {
3124
- ({ defaultActiveTabIndex, activeTabIndex, tabs, onTabClick, onTabHover, margin, iconPosition, tabIndex, children, }: Props$7): false | react_jsx_runtime.JSX.Element;
3059
+ ({ activeTabIndex, children, defaultActiveTabIndex, iconPosition, margin, onTabClick, onTabHover, tabIndex, tabs, }: Props$7): false | react_jsx_runtime.JSX.Element;
3125
3060
  Tab: react.ForwardRefExoticComponent<TabProps & react.RefAttributes<HTMLButtonElement>>;
3126
3061
  };
3127
3062
 
@@ -3535,28 +3470,28 @@ type SemanticToast = CommonProps$1 & {
3535
3470
  hideSemanticIcon?: boolean;
3536
3471
  };
3537
3472
  type ToastsQueuePropsType = {
3473
+ /**
3474
+ * Tree of components from which the useToast hook can be triggered.
3475
+ */
3476
+ children: ReactNode;
3538
3477
  /**
3539
3478
  * Duration in milliseconds before a toast automatically hides itself.
3540
3479
  * The range goes from 3000ms to 5000ms, any other value will not be taken into consideration.
3541
3480
  */
3542
3481
  duration?: number;
3543
- /**
3544
- * Tree of components from which the useToast hook can be triggered.
3545
- */
3546
- children: ReactNode;
3547
3482
  };
3548
3483
 
3549
- declare const DxcToastsQueue: ({ children, duration }: ToastsQueuePropsType) => react_jsx_runtime.JSX.Element;
3484
+ declare function DxcToastsQueue({ children, duration }: ToastsQueuePropsType): react_jsx_runtime.JSX.Element;
3550
3485
 
3551
3486
  type OptionIcon = {
3552
- /**
3553
- * String with the option display value.
3554
- */
3555
- label?: never;
3556
3487
  /**
3557
3488
  * Material Symbols icon or SVG element. Icon and label can't be used at same time.
3558
3489
  */
3559
3490
  icon: string | SVG;
3491
+ /**
3492
+ * String with the option display value.
3493
+ */
3494
+ label?: never;
3560
3495
  /**
3561
3496
  * Value for the HTML properties title and aria-label.
3562
3497
  * When a label is defined, this prop can not be use.
@@ -3564,14 +3499,14 @@ type OptionIcon = {
3564
3499
  title: string;
3565
3500
  };
3566
3501
  type OptionLabel = {
3567
- /**
3568
- * String with the option display value.
3569
- */
3570
- label: string;
3571
3502
  /**
3572
3503
  * Material Symbols icon or SVG element. Icon and label can't be used at same time.
3573
3504
  */
3574
3505
  icon?: string | SVG;
3506
+ /**
3507
+ * String with the option display value.
3508
+ */
3509
+ label: string;
3575
3510
  /**
3576
3511
  * Value for the HTML properties title and aria-label.
3577
3512
  * When a label is defined, this prop can not be use.
@@ -3579,6 +3514,10 @@ type OptionLabel = {
3579
3514
  title?: never;
3580
3515
  };
3581
3516
  type Option = {
3517
+ /**
3518
+ * If true, the option will be disabled.
3519
+ */
3520
+ disabled?: boolean;
3582
3521
  /**
3583
3522
  * Number with the option inner value.
3584
3523
  */
@@ -3586,88 +3525,80 @@ type Option = {
3586
3525
  } & (OptionIcon | OptionLabel);
3587
3526
  type CommonProps = {
3588
3527
  /**
3589
- * Text to be placed above the component.
3590
- */
3591
- label?: string;
3592
- /**
3593
- * Helper text to be placed above the component.
3594
- */
3595
- helperText?: string;
3596
- /**
3597
- * If true, the component will be disabled.
3528
+ * Size of the margin to be applied to the component ('xxsmall' | 'xsmall' | 'small' | 'medium' | 'large' | 'xlarge' | 'xxlarge').
3529
+ * You can pass an object with 'top', 'bottom', 'left' and 'right' properties in order to specify different margin sizes.
3598
3530
  */
3599
- disabled?: boolean;
3531
+ margin?: Space$1 | Margin;
3600
3532
  /**
3601
3533
  * An array of objects representing the selectable options.
3602
3534
  */
3603
3535
  options: Option[];
3604
3536
  /**
3605
- * Size of the margin to be applied to the component ('xxsmall' | 'xsmall' | 'small' | 'medium' | 'large' | 'xlarge' | 'xxlarge').
3606
- * You can pass an object with 'top', 'bottom', 'left' and 'right' properties in order to specify different margin sizes.
3537
+ * The orientation of the toggle group.
3607
3538
  */
3608
- margin?: Space$1 | Margin;
3539
+ orientation?: "horizontal" | "vertical";
3609
3540
  /**
3610
3541
  * Value of the tabindex.
3611
3542
  */
3612
3543
  tabIndex?: number;
3613
3544
  };
3614
- type SingleSelectionToggleGroup = CommonProps & {
3545
+ type MultipleSelectionToggleGroup = {
3546
+ /**
3547
+ * The array of keys with the initially selected values.
3548
+ */
3549
+ defaultValue?: number[];
3615
3550
  /**
3616
3551
  * If true, the toggle group will support multiple selection. In that case, value must be an array of numbers with the keys of the selected values.
3617
3552
  */
3618
- multiple?: false;
3553
+ multiple: true;
3619
3554
  /**
3620
- * The key of the initially selected value.
3555
+ * This function will be called every time the selection changes. An array with the key of
3556
+ * the selected values will be passed as a parameter to this function.
3621
3557
  */
3622
- defaultValue?: number;
3558
+ onChange?: (optionIndex: number[]) => void;
3623
3559
  /**
3624
- * The key of the selected value. If the component allows multiple selection, value must be an array.
3560
+ * An array with the keys of the selected values.
3625
3561
  * If undefined, the component will be uncontrolled and the value will be managed internally by the component.
3626
3562
  */
3627
- value?: number;
3563
+ value?: number[];
3564
+ };
3565
+ type SingleSelectionToggleGroup = {
3628
3566
  /**
3629
- * This function will be called every time the selection changes. The number with the key of the selected
3630
- * value will be passed as a parameter to this function.
3567
+ * The key of the initially selected value.
3631
3568
  */
3632
- onChange?: (optionIndex: number) => void;
3633
- };
3634
- type MultipleSelectionToggleGroup = CommonProps & {
3569
+ defaultValue?: number;
3635
3570
  /**
3636
3571
  * If true, the toggle group will support multiple selection. In that case, value must be an array of numbers with the keys of the selected values.
3637
3572
  */
3638
- multiple: true;
3573
+ multiple?: false;
3639
3574
  /**
3640
- * The array of keys with the initially selected values.
3575
+ * This function will be called every time the selection changes. The number with the key of the selected
3576
+ * value will be passed as a parameter to this function.
3641
3577
  */
3642
- defaultValue?: number[];
3578
+ onChange?: (optionIndex: number) => void;
3643
3579
  /**
3644
- * An array with the keys of the selected values.
3580
+ * The key of the selected value. If the component allows multiple selection, value must be an array.
3645
3581
  * If undefined, the component will be uncontrolled and the value will be managed internally by the component.
3646
3582
  */
3647
- value?: number[];
3648
- /**
3649
- * This function will be called every time the selection changes. An array with the key of
3650
- * the selected values will be passed as a parameter to this function.
3651
- */
3652
- onChange?: (optionIndex: number[]) => void;
3583
+ value?: number;
3653
3584
  };
3654
- type Props$3 = SingleSelectionToggleGroup | MultipleSelectionToggleGroup;
3585
+ type Props$3 = CommonProps & (MultipleSelectionToggleGroup | SingleSelectionToggleGroup);
3655
3586
 
3656
- declare const DxcToggleGroup: ({ label, helperText, defaultValue, value, onChange, disabled, options, margin, multiple, tabIndex, }: Props$3) => JSX.Element;
3587
+ declare function DxcToggleGroup({ defaultValue, margin, multiple, onChange, options, orientation, tabIndex, value, }: Props$3): react_jsx_runtime.JSX.Element;
3657
3588
 
3658
3589
  type Props$2 = {
3659
3590
  /**
3660
- * Preferred position for displaying the tooltip. It may adjust automatically based on available space.
3591
+ * Content in which the Tooltip will be displayed.
3661
3592
  */
3662
- position?: "bottom" | "top" | "left" | "right";
3593
+ children: ReactNode;
3663
3594
  /**
3664
3595
  * Text to be displayed inside the tooltip.
3665
3596
  */
3666
3597
  label?: string;
3667
3598
  /**
3668
- * Content in which the Tooltip will be displayed.
3599
+ * Preferred position for displaying the tooltip. It may adjust automatically based on available space.
3669
3600
  */
3670
- children: ReactNode;
3601
+ position?: "bottom" | "top" | "left" | "right";
3671
3602
  };
3672
3603
 
3673
3604
  declare function DxcTooltip(props: Props$2): react_jsx_runtime.JSX.Element;
@@ -3746,34 +3677,34 @@ type Props = {
3746
3677
  tabIndex?: number;
3747
3678
  };
3748
3679
 
3749
- declare const DxcWizard: ({ mode, defaultCurrentStep, currentStep, onStepClick, steps, margin, tabIndex, }: Props) => JSX.Element;
3680
+ declare function DxcWizard({ currentStep, defaultCurrentStep, margin, mode, onStepClick, steps, tabIndex, }: Props): react_jsx_runtime.JSX.Element;
3750
3681
 
3751
3682
  declare const componentTokens: {
3752
3683
  accordion: {
3753
3684
  backgroundColor: string;
3754
3685
  hoverBackgroundColor: string;
3686
+ focusBackgroundColor: string;
3687
+ activeBackgroundColor: string;
3755
3688
  arrowColor: string;
3756
3689
  disabledArrowColor: string;
3690
+ subLabelFontFamily: string;
3691
+ subLabelFontSize: string;
3692
+ subLabelFontWeight: string;
3693
+ subLabelFontStyle: string;
3694
+ subLabelFontColor: string;
3695
+ disabledSubLabelFontColor: string;
3757
3696
  assistiveTextFontFamily: string;
3758
3697
  assistiveTextFontSize: string;
3759
3698
  assistiveTextFontWeight: string;
3760
3699
  assistiveTextFontStyle: string;
3761
- assistiveTextLetterSpacing: string;
3762
3700
  assistiveTextFontColor: string;
3763
3701
  disabledAssistiveTextFontColor: string;
3764
- assistiveTextMinWidth: string;
3765
- assistiveTextPaddingRight: string;
3766
- assistiveTextPaddingLeft: string;
3767
3702
  titleLabelFontFamily: string;
3768
3703
  titleLabelFontSize: string;
3769
3704
  titleLabelFontWeight: string;
3770
3705
  titleLabelFontStyle: string;
3771
3706
  titleLabelFontColor: string;
3772
3707
  disabledTitleLabelFontColor: string;
3773
- titleLabelPaddingTop: string;
3774
- titleLabelPaddingBottom: string;
3775
- titleLabelPaddingLeft: string;
3776
- titleLabelPaddingRight: string;
3777
3708
  focusBorderColor: string;
3778
3709
  focusBorderStyle: string;
3779
3710
  focusBorderThickness: string;
@@ -3781,16 +3712,14 @@ declare const componentTokens: {
3781
3712
  boxShadowOffsetX: string;
3782
3713
  boxShadowOffsetY: string;
3783
3714
  boxShadowBlur: string;
3715
+ boxShadowSpread: string;
3784
3716
  boxShadowColor: string;
3785
3717
  iconColor: string;
3786
3718
  disabledIconColor: string;
3787
3719
  iconSize: string;
3788
- iconMarginLeft: string;
3789
- iconMarginRight: string;
3790
- accordionGroupSeparatorBorderColor: string;
3791
- accordionGroupSeparatorBorderThickness: string;
3792
- accordionGroupSeparatorBorderRadius: string;
3793
- accordionGroupSeparatorBorderStyle: string;
3720
+ accordionSeparatorBorderColor: string;
3721
+ accordionSeparatorBorderThickness: string;
3722
+ accordionSeparatorBorderStyle: string;
3794
3723
  };
3795
3724
  alert: {
3796
3725
  errorBackgroundColor: string;
@@ -5031,6 +4960,7 @@ type OpinionatedTheme = {
5031
4960
  accordion: {
5032
4961
  accentColor: string;
5033
4962
  titleFontColor: string;
4963
+ subLabelFontColor: string;
5034
4964
  assistiveTextFontColor: string;
5035
4965
  };
5036
4966
  alert: {
@@ -5281,28 +5211,28 @@ declare const HalstackContext: react.Context<{
5281
5211
  accordion: {
5282
5212
  backgroundColor: string;
5283
5213
  hoverBackgroundColor: string;
5214
+ focusBackgroundColor: string;
5215
+ activeBackgroundColor: string;
5284
5216
  arrowColor: string;
5285
5217
  disabledArrowColor: string;
5218
+ subLabelFontFamily: string;
5219
+ subLabelFontSize: string;
5220
+ subLabelFontWeight: string;
5221
+ subLabelFontStyle: string;
5222
+ subLabelFontColor: string;
5223
+ disabledSubLabelFontColor: string;
5286
5224
  assistiveTextFontFamily: string;
5287
5225
  assistiveTextFontSize: string;
5288
5226
  assistiveTextFontWeight: string;
5289
5227
  assistiveTextFontStyle: string;
5290
- assistiveTextLetterSpacing: string;
5291
5228
  assistiveTextFontColor: string;
5292
5229
  disabledAssistiveTextFontColor: string;
5293
- assistiveTextMinWidth: string;
5294
- assistiveTextPaddingRight: string;
5295
- assistiveTextPaddingLeft: string;
5296
5230
  titleLabelFontFamily: string;
5297
5231
  titleLabelFontSize: string;
5298
5232
  titleLabelFontWeight: string;
5299
5233
  titleLabelFontStyle: string;
5300
5234
  titleLabelFontColor: string;
5301
5235
  disabledTitleLabelFontColor: string;
5302
- titleLabelPaddingTop: string;
5303
- titleLabelPaddingBottom: string;
5304
- titleLabelPaddingLeft: string;
5305
- titleLabelPaddingRight: string;
5306
5236
  focusBorderColor: string;
5307
5237
  focusBorderStyle: string;
5308
5238
  focusBorderThickness: string;
@@ -5310,16 +5240,14 @@ declare const HalstackContext: react.Context<{
5310
5240
  boxShadowOffsetX: string;
5311
5241
  boxShadowOffsetY: string;
5312
5242
  boxShadowBlur: string;
5243
+ boxShadowSpread: string;
5313
5244
  boxShadowColor: string;
5314
5245
  iconColor: string;
5315
5246
  disabledIconColor: string;
5316
5247
  iconSize: string;
5317
- iconMarginLeft: string;
5318
- iconMarginRight: string;
5319
- accordionGroupSeparatorBorderColor: string;
5320
- accordionGroupSeparatorBorderThickness: string;
5321
- accordionGroupSeparatorBorderRadius: string;
5322
- accordionGroupSeparatorBorderStyle: string;
5248
+ accordionSeparatorBorderColor: string;
5249
+ accordionSeparatorBorderThickness: string;
5250
+ accordionSeparatorBorderStyle: string;
5323
5251
  };
5324
5252
  alert: {
5325
5253
  errorBackgroundColor: string;
@@ -6650,7 +6578,7 @@ type HalstackProviderPropsType = {
6650
6578
  };
6651
6579
  declare const HalstackProvider: ({ theme, advancedTheme, labels, children }: HalstackProviderPropsType) => JSX.Element;
6652
6580
 
6653
- declare const useToast: () => {
6581
+ declare function useToast(): {
6654
6582
  default: (toast: DefaultToast) => (() => void) | undefined;
6655
6583
  success: (toast: SemanticToast) => (() => void) | undefined;
6656
6584
  warning: (toast: SemanticToast) => (() => void) | undefined;
@@ -6658,4 +6586,4 @@ declare const useToast: () => {
6658
6586
  loading: (toast: Omit<LoadingToast, "loading">) => (() => void) | undefined;
6659
6587
  };
6660
6588
 
6661
- export { DxcAccordion, DxcAccordionGroup, DxcAlert, DxcApplicationLayout, DxcBadge, Bleed as DxcBleed, DxcBreadcrumbs, DxcBulletedList, DxcButton, DxcCard, DxcCheckbox, DxcChip, DxcContainer, DxcContextualMenu, DxcDataGrid, DxcDateInput, DxcDialog, DxcDivider, DxcDropdown, DxcFileInput, DxcFlex, DxcGrid, DxcHeading, DxcImage, Inset as DxcInset, DxcLink, DxcNavTabs, DxcNumberInput, DxcPaginator, DxcParagraph, DxcPasswordInput, DxcProgressBar, DxcQuickNav, DxcRadioGroup, DxcResultsetTable, DxcSelect, DxcSlider, DxcSpinner, DxcStatusLight, DxcSwitch, DxcTable, DxcTabs, DxcTag, DxcTextInput, DxcTextarea, DxcToastsQueue, DxcToggleGroup, DxcTooltip, DxcTypography, DxcWizard, HalstackContext, HalstackLanguageContext, HalstackProvider, useToast };
6589
+ export { DxcAccordion, DxcAlert, DxcApplicationLayout, DxcBadge, DxcBleed, DxcBreadcrumbs, DxcBulletedList, DxcButton, DxcCard, DxcCheckbox, DxcChip, DxcContainer, DxcContextualMenu, DxcDataGrid, DxcDateInput, DxcDialog, DxcDivider, DxcDropdown, DxcFileInput, DxcFlex, DxcGrid, DxcHeading, DxcImage, DxcInset, DxcLink, DxcNavTabs, DxcNumberInput, DxcPaginator, DxcParagraph, DxcPasswordInput, DxcProgressBar, DxcQuickNav, DxcRadioGroup, DxcResultsetTable, DxcSelect, DxcSlider, DxcSpinner, DxcStatusLight, DxcSwitch, DxcTable, DxcTabs, DxcTag, DxcTextInput, DxcTextarea, DxcToastsQueue, DxcToggleGroup, DxcTooltip, DxcTypography, DxcWizard, HalstackContext, HalstackLanguageContext, HalstackProvider, useToast };