@agregio-solutions/design-system 1.102.5 → 2.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (51) hide show
  1. package/dist/design-system.cjs +544 -629
  2. package/dist/design-system.js +7772 -27711
  3. package/dist/packages/components/Button/doc.md +33 -2
  4. package/dist/packages/components/Combobox/Combobox.d.ts +2 -2
  5. package/dist/packages/components/Combobox/doc.md +0 -4
  6. package/dist/packages/components/DataTable/DataTable.d.ts +15 -6
  7. package/dist/packages/components/DataTable/DataTableRow/DataTableRow.d.ts +1 -6
  8. package/dist/packages/components/DataTable/doc.md +495 -389
  9. package/dist/packages/components/DatePicker/DatePicker.d.ts +2 -2
  10. package/dist/packages/components/DatePicker/doc.md +0 -1
  11. package/dist/packages/components/DateRangePicker/DateRangePicker.d.ts +2 -2
  12. package/dist/packages/components/DateRangePicker/doc.md +0 -1
  13. package/dist/packages/components/Drawer/Drawer.d.ts +7 -24
  14. package/dist/packages/components/Drawer/doc.md +136 -106
  15. package/dist/packages/components/Dropdown/Dropdown.d.ts +1 -7
  16. package/dist/packages/components/Dropdown/doc.md +2 -29
  17. package/dist/packages/components/FileUpload/doc.md +0 -2
  18. package/dist/packages/components/Filter/Filter.d.ts +24 -10
  19. package/dist/packages/components/Filter/doc.md +31 -1
  20. package/dist/packages/components/Modal/doc.md +1 -2
  21. package/dist/packages/components/Navigation/Navigation.d.ts +2 -1
  22. package/dist/packages/components/Navigation/doc.md +14 -9
  23. package/dist/packages/components/NavigationItem/NavigationItem.d.ts +4 -0
  24. package/dist/packages/components/NavigationItem/doc.md +15 -3
  25. package/dist/packages/components/PageLayout/doc.md +190 -149
  26. package/dist/packages/components/Select/Select.d.ts +1 -1
  27. package/dist/packages/components/Select/doc.md +0 -9
  28. package/dist/packages/components/Slider/Slider.d.ts +3 -9
  29. package/dist/packages/components/Slider/doc.md +1 -4
  30. package/dist/packages/components/Tabs/Tab/Tab.d.ts +0 -5
  31. package/dist/packages/components/TextInput/TextInput.d.ts +2 -2
  32. package/dist/packages/components/TextInput/doc.md +0 -22
  33. package/dist/packages/components/TimeField/TimeField.d.ts +2 -2
  34. package/dist/packages/components/TimeField/doc.md +0 -1
  35. package/dist/packages/components/TimePicker/TimePicker.d.ts +2 -2
  36. package/dist/packages/components/Timeline/Timeline.styled.d.ts +15 -20
  37. package/dist/packages/components/Timeline/components/BlockLineContainer/BlockLineContainer.styled.d.ts +23 -27
  38. package/dist/packages/components/Timeline/components/GroupLineContainer/GroupLineContainer.styled.d.ts +3 -4
  39. package/dist/packages/components/Timeline/components/TimelineRange/TimelineRange.styled.d.ts +12 -16
  40. package/dist/packages/components/Timeline/doc.md +38 -1
  41. package/dist/packages/components/YearMonthPicker/YearMonthPicker.d.ts +2 -2
  42. package/dist/packages/components/YearMonthPicker/doc.md +0 -1
  43. package/dist/packages/ds-design-tokens/index.d.ts +1 -2
  44. package/dist/packages/ds-design-tokens/src/tokens.style.d.ts +138 -135
  45. package/dist/packages/index.d.ts +3 -4
  46. package/dist/packages/internal-components/FormGroupWrapper/FormGroupWrapper.d.ts +0 -12
  47. package/dist/public_docs/index.md +4 -1
  48. package/dist/public_docs/migration-guide-v2.md +444 -0
  49. package/package.json +6 -8
  50. package/dist/packages/ds-design-tokens/src/fontSize.style.d.ts +0 -60
  51. package/dist/packages/mui/mui-theme.d.ts +0 -3
@@ -1,157 +1,160 @@
1
1
  /**
2
- * @deprecated Please use the CSS variables instead
2
+ * Raw token values, for advanced use cases only (not documented).
3
+ * Prefer the CSS variables of `tokens.css`, which hold the same values.
3
4
  */
4
5
  export declare const tokens: {
5
- color: {
6
- content: {
7
- action: {
8
- action: string;
9
- actionDarker: string;
10
- actionLighter: string;
6
+ readonly color: {
7
+ readonly content: {
8
+ readonly action: {
9
+ readonly action: "#1844ff";
10
+ readonly actionDarker: "#0626ac";
11
+ readonly actionLighter: "#f1f7ff";
11
12
  };
12
- neutral: {
13
- primary: string;
14
- primaryReversed: string;
15
- secondary: string;
16
- secondaryLight: string;
17
- tertiary: string;
18
- stroke: string;
13
+ readonly neutral: {
14
+ readonly primary: "#001a70";
15
+ readonly primaryReversed: "#ffffff";
16
+ readonly secondary: "#454545";
17
+ readonly secondaryLight: "#666666";
18
+ readonly tertiary: "#b0b0b0";
19
+ readonly stroke: "#e7e7e7";
19
20
  };
20
- brand: {
21
- brand1: string;
22
- brand2: string;
23
- brand3: string;
24
- brand4: string;
25
- brand5: string;
26
- brand6: string;
27
- brand7: string;
28
- brand8: string;
29
- brand9: string;
21
+ readonly brand: {
22
+ readonly brand1: "#001a70";
23
+ readonly brand2: "#3f6eff";
24
+ readonly brand3: "#769fff";
25
+ readonly brand4: "#326a21";
26
+ readonly brand5: "#4f9e30";
27
+ readonly brand6: "#76c853";
28
+ readonly brand7: "#c62608";
29
+ readonly brand8: "#fe5716";
30
+ readonly brand9: "#ff7838";
30
31
  };
31
- message: {
32
- informative: string;
33
- informativeDarker: string;
34
- informativeDarkest: string;
35
- informativeLighter: string;
36
- negative: string;
37
- negativeDarker: string;
38
- negativeDarkest: string;
39
- negativeLighter: string;
40
- positive: string;
41
- positiveDarker: string;
42
- positiveDarkest: string;
43
- positiveLighter: string;
44
- warning: string;
45
- warningDarker: string;
46
- warningDarkest: string;
47
- warningLighter: string;
32
+ readonly message: {
33
+ readonly informative: "#009fd4";
34
+ readonly informativeDarker: "#007fab";
35
+ readonly informativeDarkest: "#065874";
36
+ readonly informativeLighter: "#effbff";
37
+ readonly negative: "#ed1515";
38
+ readonly negativeDarker: "#c80d0d";
39
+ readonly negativeDarkest: "#881414";
40
+ readonly negativeLighter: "#fff1f1";
41
+ readonly positive: "#11ab51";
42
+ readonly positiveDarker: "#0c6f2d";
43
+ readonly positiveDarkest: "#0d2e17";
44
+ readonly positiveLighter: "#e3ffed";
45
+ readonly warning: "#e27500";
46
+ readonly warningDarker: "#bb5002";
47
+ readonly warningDarkest: "#7c330b";
48
+ readonly warningLighter: "#fffcea";
48
49
  };
49
- dataviz: {
50
- orange1: string;
51
- orange2: string;
52
- orange3: string;
53
- orange4: string;
54
- brown1: string;
55
- brown2: string;
56
- brown3: string;
57
- brown4: string;
58
- azure1: string;
59
- azure2: string;
60
- azure3: string;
61
- azure4: string;
62
- ocean1: string;
63
- ocean2: string;
64
- ocean3: string;
65
- ocean4: string;
66
- purple1: string;
67
- purple2: string;
68
- purple3: string;
69
- purple4: string;
70
- pink1: string;
71
- pink2: string;
72
- pink3: string;
73
- pink4: string;
74
- negative1: string;
75
- negative2: string;
76
- negative3: string;
77
- negative4: string;
78
- positive1: string;
79
- positive2: string;
80
- positive3: string;
81
- positive4: string;
82
- neutral1: string;
83
- neutral2: string;
84
- neutral3: string;
85
- neutral4: string;
50
+ readonly dataviz: {
51
+ readonly orange1: "#fff5ed";
52
+ readonly orange2: "#ffcca8";
53
+ readonly orange3: "#fe5716";
54
+ readonly orange4: "#9d210f";
55
+ readonly brown1: "#fffcea";
56
+ readonly brown2: "#ffe785";
57
+ readonly brown3: "#ff9d00";
58
+ readonly brown4: "#983d08";
59
+ readonly azure1: "#f1f7ff";
60
+ readonly azure2: "#cee1ff";
61
+ readonly azure3: "#3f6eff";
62
+ readonly azure4: "#052dd2";
63
+ readonly ocean1: "#effbff";
64
+ readonly ocean2: "#b6efff";
65
+ readonly ocean3: "#009fd4";
66
+ readonly ocean4: "#006b8d";
67
+ readonly purple1: "#f9f5ff";
68
+ readonly purple2: "#e4d4ff";
69
+ readonly purple3: "#9351fb";
70
+ readonly purple4: "#5a1eab";
71
+ readonly pink1: "#ffedf8";
72
+ readonly pink2: "#ffc2e8";
73
+ readonly pink3: "#ee53b5";
74
+ readonly pink4: "#a11672";
75
+ readonly negative1: "#fff1f1";
76
+ readonly negative2: "#ffc5c5";
77
+ readonly negative3: "#ed1515";
78
+ readonly negative4: "#a50f0f";
79
+ readonly positive1: "#e3ffed";
80
+ readonly positive2: "#a4f2c2";
81
+ readonly positive3: "#11ab51";
82
+ readonly positive4: "#0c6f2d";
83
+ readonly neutral1: "#f6f6f6";
84
+ readonly neutral2: "#d1d1d1";
85
+ readonly neutral3: "#888888";
86
+ readonly neutral4: "#454545";
86
87
  };
87
88
  };
88
- background: {
89
- neutral: {
90
- overground: string;
91
- ground: string;
92
- groundReversed: string;
93
- underground1: string;
94
- underground2: string;
89
+ readonly background: {
90
+ readonly neutral: {
91
+ readonly overground: "#ffffff";
92
+ readonly ground: "#ffffff";
93
+ readonly groundReversed: "#0e275d";
94
+ readonly underground1: "#f6f6f6";
95
+ readonly underground2: "#e7e7e7";
95
96
  };
96
- highlight: {
97
- focus: string;
98
- focusReversed: string;
97
+ readonly highlight: {
98
+ readonly focus: "#009fd4";
99
+ readonly focusReversed: "#ffffff";
99
100
  };
100
101
  };
101
102
  };
102
- spacing: {
103
- xxs: string;
104
- xs: string;
105
- sm: string;
106
- md: string;
107
- lg: string;
108
- xl: string;
109
- xxl: string;
103
+ readonly spacing: {
104
+ readonly xxs: "4px";
105
+ readonly xs: "8px";
106
+ readonly sm: "16px";
107
+ readonly md: "24px";
108
+ readonly lg: "32px";
109
+ readonly xl: "48px";
110
+ readonly xxl: "80px";
110
111
  };
111
- radius: {
112
- minimal: string;
113
- rounded: string;
114
- full: string;
112
+ readonly radius: {
113
+ readonly minimal: "2px";
114
+ readonly rounded: "4px";
115
+ readonly full: "8px";
115
116
  };
116
- stroke: {
117
- default: string;
118
- doubled: string;
117
+ readonly stroke: {
118
+ readonly default: "1px";
119
+ readonly doubled: "2px";
119
120
  };
120
- "z-index": {
121
- base: string;
122
- dropdown: string;
123
- sticky: string;
124
- fixed: string;
125
- modalBackdrop: string;
126
- offCanvas: string;
127
- modal: string;
128
- popover: string;
129
- tooltip: string;
121
+ readonly "z-index": {
122
+ readonly base: "1";
123
+ readonly dropdown: "10";
124
+ readonly sticky: "20";
125
+ readonly fixed: "30";
126
+ readonly modalBackdrop: "40";
127
+ readonly offCanvas: "50";
128
+ readonly modal: "60";
129
+ readonly popover: "70";
130
+ readonly tooltip: "80";
130
131
  };
131
- text: {
132
- fontSize: {
133
- "3xl": string;
134
- "2xl": string;
135
- xl: string;
136
- lg: string;
137
- md: string;
138
- sm: string;
132
+ readonly text: {
133
+ readonly fontSize: {
134
+ readonly "3xl": "40px";
135
+ readonly "2xl": "32px";
136
+ readonly xl: "24px";
137
+ readonly lg: "20px";
138
+ readonly md: "16px";
139
+ readonly sm: "14px";
140
+ readonly xs: "12px";
139
141
  };
140
- lineHeight: {
141
- "3xl": string;
142
- "2xl": string;
143
- xl: string;
144
- lg: string;
145
- md: string;
146
- sm: string;
142
+ readonly lineHeight: {
143
+ readonly "3xl": "56px";
144
+ readonly "2xl": "40px";
145
+ readonly xl: "32px";
146
+ readonly lg: "28px";
147
+ readonly md: "24px";
148
+ readonly sm: "20px";
149
+ readonly xs: "16px";
147
150
  };
148
151
  };
149
- shadow: {
150
- light: string;
151
- "light-inverted": string;
152
- medium: string;
153
- "medium-inverted": string;
154
- strong: string;
155
- "strong-inverted": string;
152
+ readonly shadow: {
153
+ readonly light: "0 1px 4px 0 rgba(38, 38, 38, 0.12)";
154
+ readonly "light-inverted": "0 -1px 4px 0 rgba(38, 38, 38, 0.12)";
155
+ readonly medium: "0 2px 6px 0 rgba(38, 38, 38, 0.16)";
156
+ readonly "medium-inverted": "0 -2px 6px 0 rgba(38, 38, 38, 0.16)";
157
+ readonly strong: "0 4px 12px 0 rgba(38, 38, 38, 0.16)";
158
+ readonly "strong-inverted": "0 -4px 12px 0 rgba(38, 38, 38, 0.16)";
156
159
  };
157
160
  };
@@ -17,7 +17,7 @@ import { default as DataTableRoot } from './components/DataTable/DataTableRoot/D
17
17
  import { default as DataTableRow } from './components/DataTable/DataTableRow/DataTableRow';
18
18
  import { default as DatePicker } from './components/DatePicker/DatePicker';
19
19
  import { default as DateRangePicker } from './components/DateRangePicker/DateRangePicker';
20
- import { default as Drawer } from './components/Drawer/Drawer';
20
+ import { default as Drawer, DrawerContent, DrawerActions, DrawerForm } from './components/Drawer/Drawer';
21
21
  import { default as Dropdown } from './components/Dropdown/Dropdown';
22
22
  import { default as DropdownListItem } from './components/Dropdown/components/DropdownListItem/DropdownListItem';
23
23
  import { default as EmptyState } from './components/EmptyState/EmptyState';
@@ -70,9 +70,8 @@ import { default as ToggleButtonGroup } from './components/ToggleButtonGroup/Tog
70
70
  import { default as Tooltip, TooltipTrigger } from './components/Tooltip/Tooltip';
71
71
  import { default as YearMonthPicker } from './components/YearMonthPicker/YearMonthPicker';
72
72
  import { default as RouterProvider } from './components/RouterProvider/RouterProvider';
73
- import { default as createMuiTheme } from './mui/mui-theme.ts';
74
- import { tokens, fontSize, lineHeight } from './ds-design-tokens/index';
73
+ import { tokens } from './ds-design-tokens/index';
75
74
  import { I18nProvider } from 'react-aria-components';
76
75
  import { toast } from 'sonner';
77
- export { Accordion, Badge, Breadcrumbs, Button, Calendar, CalendarCell, Card, ChartLegend, ChartTooltip, Checkbox, CheckboxGroup, Chip, Combobox, createMuiTheme, DataTable, DataTableCell, DataTableHeader, DataTableRoot, DataTableRow, DatePicker, DateRangePicker, Drawer, Dropdown, DropdownListItem, EmptyState, FileUpload, Filter, fontSize, Header, I18nProvider, Icon, Label, LinearProgressBar, lineHeight, Link, List, Loader, Menu, MenuItem, Message, Modal, ModalContent, ModalActions, ModalForm, Navigation, NavigationItem, Notifications, NotificationCard, NumberField, PageLayout, Pagination, Popover, PopoverTrigger, Radio, RouterProvider, SearchBar, SegmentedControl, SegmentedControlButton, SegmentedControlList, SegmentedControlPanel, Select, SelectItem, Skeleton, Slider, Stepper, Step, Switch, Tab, TabList, TabPanel, Tabs, Tag, TextInput, TimeField, TimePicker, Timeline, toast, Toaster, ToggleButton, ToggleButtonGroup, Tooltip, TooltipTrigger, tokens, YearMonthPicker, };
76
+ export { Accordion, Badge, Breadcrumbs, Button, Calendar, CalendarCell, Card, ChartLegend, ChartTooltip, Checkbox, CheckboxGroup, Chip, Combobox, DataTable, DataTableCell, DataTableHeader, DataTableRoot, DataTableRow, DatePicker, DateRangePicker, Drawer, DrawerContent, DrawerActions, DrawerForm, Dropdown, DropdownListItem, EmptyState, FileUpload, Filter, Header, I18nProvider, Icon, Label, LinearProgressBar, Link, List, Loader, Menu, MenuItem, Message, Modal, ModalContent, ModalActions, ModalForm, Navigation, NavigationItem, Notifications, NotificationCard, NumberField, PageLayout, Pagination, Popover, PopoverTrigger, Radio, RouterProvider, SearchBar, SegmentedControl, SegmentedControlButton, SegmentedControlList, SegmentedControlPanel, Select, SelectItem, Skeleton, Slider, Stepper, Step, Switch, Tab, TabList, TabPanel, Tabs, Tag, TextInput, TimeField, TimePicker, Timeline, toast, Toaster, ToggleButton, ToggleButtonGroup, Tooltip, TooltipTrigger, tokens, YearMonthPicker, };
78
77
  export type { TypeTableColumnWithFilter };
@@ -11,12 +11,6 @@ export type Props = LabelProps & {
11
11
  * @default "vertical"
12
12
  */
13
13
  orientation?: "vertical" | "horizontal";
14
- /**
15
- * Optional description to display under the field.
16
- * Please do NOT provide a description if you are on "horizontal" orientation.
17
- * @deprecated Use `helperText` instead
18
- */
19
- description?: string | React.ReactNode;
20
14
  /**
21
15
  * Helper text displayed below the input field, like additional instructions.
22
16
  */
@@ -64,12 +58,6 @@ declare const FormGroupWrapper: React.ForwardRefExoticComponent<LabelProps & {
64
58
  * @default "vertical"
65
59
  */
66
60
  orientation?: "vertical" | "horizontal";
67
- /**
68
- * Optional description to display under the field.
69
- * Please do NOT provide a description if you are on "horizontal" orientation.
70
- * @deprecated Use `helperText` instead
71
- */
72
- description?: string | React.ReactNode;
73
61
  /**
74
62
  * Helper text displayed below the input field, like additional instructions.
75
63
  */
@@ -11,10 +11,11 @@ The Agregio Solutions Design System is a collection of reusable components and p
11
11
 
12
12
  ## How to use the docs
13
13
 
14
- The docs are organized into 2 sections:
14
+ The docs are organized into 3 sections:
15
15
 
16
16
  - [Components](./components.md): list of all the components available in the design system, + their props, example usage and how to test them.
17
17
  - [Tokens](./tokens.md): list of all the tokens available in the design system and examples of how to use them.
18
+ - [V2 migration guide](./migration-guide-v2.md): breaking changes shipped in the V2 release and how to adapt your codebase.
18
19
 
19
20
  ## Important rules to follow
20
21
 
@@ -26,5 +27,7 @@ Check the [Components](./components.md) each time you:
26
27
  - need to write of update tests for a Design System Component
27
28
  - need to check the available props or developer notes for a Design System Component
28
29
 
30
+ Check the [V2 migration guide](./migration-guide-v2.md) each time you upgrade the design system across a major version, to know which breaking changes apply and how to adapt the code.
31
+
29
32
  Check the [Tokens](./tokens.md) each time you want to use CSS values like spacing, colors, typography, etc.
30
33
  It contains the complete list of all the tokens available in the design system and examples of how to use them as well as the rules to follow to use them correctly.