@dxc-technology/halstack-react 0.0.0-d1d02c1 → 0.0.0-d1e7610

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 (366) hide show
  1. package/BackgroundColorContext.js +50 -0
  2. package/ThemeContext.js +246 -0
  3. package/V3Select/V3Select.js +455 -0
  4. package/V3Select/index.d.ts +27 -0
  5. package/V3Textarea/V3Textarea.js +260 -0
  6. package/V3Textarea/index.d.ts +27 -0
  7. package/accordion/Accordion.d.ts +4 -0
  8. package/accordion/Accordion.js +258 -0
  9. package/accordion/types.d.ts +68 -0
  10. package/accordion/types.js +5 -0
  11. package/accordion-group/AccordionGroup.d.ts +7 -0
  12. package/accordion-group/AccordionGroup.js +170 -0
  13. package/accordion-group/types.d.ts +72 -0
  14. package/accordion-group/types.js +5 -0
  15. package/alert/Alert.d.ts +4 -0
  16. package/alert/Alert.js +290 -0
  17. package/alert/Alert.stories.tsx +170 -0
  18. package/alert/types.d.ts +49 -0
  19. package/alert/types.js +5 -0
  20. package/badge/Badge.js +59 -0
  21. package/box/Box.d.ts +4 -0
  22. package/box/Box.js +129 -0
  23. package/box/Box.stories.tsx +132 -0
  24. package/box/types.d.ts +47 -0
  25. package/box/types.js +5 -0
  26. package/button/Button.d.ts +4 -0
  27. package/button/Button.js +177 -0
  28. package/button/Button.stories.tsx +276 -0
  29. package/button/types.d.ts +57 -0
  30. package/button/types.js +5 -0
  31. package/card/Card.d.ts +4 -0
  32. package/card/Card.js +165 -0
  33. package/card/types.d.ts +69 -0
  34. package/card/types.js +5 -0
  35. package/checkbox/Checkbox.d.ts +4 -0
  36. package/checkbox/Checkbox.js +253 -0
  37. package/checkbox/Checkbox.stories.tsx +192 -0
  38. package/checkbox/types.d.ts +60 -0
  39. package/checkbox/types.js +5 -0
  40. package/chip/Chip.js +221 -0
  41. package/chip/Chip.stories.tsx +121 -0
  42. package/chip/index.d.ts +22 -0
  43. package/{dist/common → common}/OpenSans.css +0 -0
  44. package/{dist/common → common}/RequiredComponent.js +5 -19
  45. package/{dist/common → common}/fonts/OpenSans-Bold.ttf +0 -0
  46. package/{dist/common → common}/fonts/OpenSans-BoldItalic.ttf +0 -0
  47. package/{dist/common → common}/fonts/OpenSans-ExtraBold.ttf +0 -0
  48. package/{dist/common → common}/fonts/OpenSans-ExtraBoldItalic.ttf +0 -0
  49. package/{dist/common → common}/fonts/OpenSans-Italic.ttf +0 -0
  50. package/{dist/common → common}/fonts/OpenSans-Light.ttf +0 -0
  51. package/{dist/common → common}/fonts/OpenSans-LightItalic.ttf +0 -0
  52. package/{dist/common → common}/fonts/OpenSans-Regular.ttf +0 -0
  53. package/{dist/common → common}/fonts/OpenSans-SemiBold.ttf +0 -0
  54. package/{dist/common → common}/fonts/OpenSans-SemiBoldItalic.ttf +0 -0
  55. package/common/utils.js +22 -0
  56. package/common/variables.js +1577 -0
  57. package/{dist/date → date}/Date.js +87 -70
  58. package/date/index.d.ts +27 -0
  59. package/date-input/DateInput.d.ts +4 -0
  60. package/date-input/DateInput.js +361 -0
  61. package/date-input/DateInput.stories.tsx +138 -0
  62. package/date-input/types.d.ts +100 -0
  63. package/date-input/types.js +5 -0
  64. package/dialog/Dialog.d.ts +4 -0
  65. package/dialog/Dialog.js +165 -0
  66. package/dialog/Dialog.stories.tsx +212 -0
  67. package/dialog/types.d.ts +43 -0
  68. package/dialog/types.js +5 -0
  69. package/dropdown/Dropdown.d.ts +4 -0
  70. package/dropdown/Dropdown.js +417 -0
  71. package/dropdown/types.d.ts +89 -0
  72. package/dropdown/types.js +5 -0
  73. package/file-input/FileInput.js +532 -0
  74. package/file-input/FileItem.js +193 -0
  75. package/file-input/index.d.ts +81 -0
  76. package/footer/Footer.d.ts +4 -0
  77. package/footer/Footer.js +266 -0
  78. package/footer/Footer.stories.jsx +151 -0
  79. package/footer/Icons.js +77 -0
  80. package/footer/types.d.ts +61 -0
  81. package/footer/types.js +5 -0
  82. package/header/Header.d.ts +7 -0
  83. package/header/Header.js +324 -0
  84. package/header/Icons.js +34 -0
  85. package/header/types.d.ts +45 -0
  86. package/header/types.js +5 -0
  87. package/heading/Heading.d.ts +4 -0
  88. package/heading/Heading.js +159 -0
  89. package/heading/types.d.ts +33 -0
  90. package/heading/types.js +5 -0
  91. package/input-text/Icons.js +22 -0
  92. package/input-text/InputText.js +611 -0
  93. package/input-text/index.d.ts +36 -0
  94. package/{dist/layout → layout}/ApplicationLayout.js +43 -142
  95. package/layout/Icons.js +55 -0
  96. package/link/Link.d.ts +3 -0
  97. package/link/Link.js +161 -0
  98. package/link/Link.stories.tsx +70 -0
  99. package/link/types.d.ts +74 -0
  100. package/link/types.js +5 -0
  101. package/main.d.ts +44 -0
  102. package/{dist/main.js → main.js} +137 -53
  103. package/number-input/NumberInput.d.ts +4 -0
  104. package/number-input/NumberInput.js +86 -0
  105. package/number-input/NumberInput.stories.tsx +115 -0
  106. package/{dist/ThemeContext.js → number-input/NumberInputContext.js} +3 -2
  107. package/number-input/types.d.ts +117 -0
  108. package/number-input/types.js +5 -0
  109. package/package.json +37 -23
  110. package/paginator/Icons.js +66 -0
  111. package/paginator/Paginator.d.ts +4 -0
  112. package/paginator/Paginator.js +198 -0
  113. package/paginator/Paginator.stories.tsx +63 -0
  114. package/paginator/types.d.ts +38 -0
  115. package/paginator/types.js +5 -0
  116. package/password-input/PasswordInput.d.ts +4 -0
  117. package/password-input/PasswordInput.js +162 -0
  118. package/password-input/PasswordInput.stories.tsx +131 -0
  119. package/password-input/types.d.ts +100 -0
  120. package/password-input/types.js +5 -0
  121. package/progress-bar/ProgressBar.d.ts +4 -0
  122. package/progress-bar/ProgressBar.js +170 -0
  123. package/progress-bar/ProgressBar.stories.jsx +58 -0
  124. package/progress-bar/types.d.ts +37 -0
  125. package/progress-bar/types.js +5 -0
  126. package/radio/Radio.d.ts +4 -0
  127. package/radio/Radio.js +174 -0
  128. package/radio/Radio.stories.tsx +192 -0
  129. package/radio/types.d.ts +54 -0
  130. package/radio/types.js +5 -0
  131. package/resultsetTable/ResultsetTable.js +274 -0
  132. package/resultsetTable/index.d.ts +19 -0
  133. package/select/Select.js +865 -0
  134. package/select/Select.stories.tsx +572 -0
  135. package/select/index.d.ts +131 -0
  136. package/sidenav/Sidenav.d.ts +9 -0
  137. package/sidenav/Sidenav.js +136 -0
  138. package/sidenav/types.d.ts +50 -0
  139. package/sidenav/types.js +5 -0
  140. package/slider/Slider.d.ts +4 -0
  141. package/slider/Slider.js +317 -0
  142. package/slider/Slider.stories.tsx +177 -0
  143. package/slider/types.d.ts +78 -0
  144. package/slider/types.js +5 -0
  145. package/spinner/Spinner.d.ts +4 -0
  146. package/spinner/Spinner.js +250 -0
  147. package/spinner/Spinner.stories.jsx +102 -0
  148. package/spinner/types.d.ts +32 -0
  149. package/spinner/types.js +5 -0
  150. package/switch/Switch.d.ts +4 -0
  151. package/switch/Switch.js +179 -0
  152. package/switch/Switch.stories.tsx +160 -0
  153. package/switch/types.d.ts +58 -0
  154. package/switch/types.js +5 -0
  155. package/table/Table.d.ts +4 -0
  156. package/table/Table.js +118 -0
  157. package/table/Table.stories.jsx +276 -0
  158. package/table/types.d.ts +21 -0
  159. package/table/types.js +5 -0
  160. package/tabs/Tabs.d.ts +4 -0
  161. package/tabs/Tabs.js +211 -0
  162. package/tabs/types.d.ts +71 -0
  163. package/tabs/types.js +5 -0
  164. package/tag/Tag.d.ts +4 -0
  165. package/tag/Tag.js +193 -0
  166. package/tag/Tag.stories.tsx +145 -0
  167. package/tag/types.d.ts +60 -0
  168. package/tag/types.js +5 -0
  169. package/text-input/TextInput.js +825 -0
  170. package/text-input/index.d.ts +135 -0
  171. package/textarea/Textarea.js +317 -0
  172. package/textarea/Textarea.stories.jsx +135 -0
  173. package/textarea/index.d.ts +117 -0
  174. package/{dist/toggle → toggle}/Toggle.js +30 -67
  175. package/toggle/index.d.ts +21 -0
  176. package/toggle-group/ToggleGroup.js +243 -0
  177. package/toggle-group/ToggleGroup.stories.tsx +178 -0
  178. package/toggle-group/index.d.ts +21 -0
  179. package/{dist/upload → upload}/Upload.js +23 -22
  180. package/upload/buttons-upload/ButtonsUpload.js +111 -0
  181. package/upload/buttons-upload/Icons.js +40 -0
  182. package/upload/dragAndDropArea/DragAndDropArea.js +225 -0
  183. package/upload/dragAndDropArea/Icons.js +39 -0
  184. package/upload/file-upload/FileToUpload.js +115 -0
  185. package/upload/file-upload/Icons.js +66 -0
  186. package/upload/files-upload/FilesToUpload.js +109 -0
  187. package/upload/index.d.ts +15 -0
  188. package/upload/transaction/Icons.js +160 -0
  189. package/upload/transaction/Transaction.js +104 -0
  190. package/upload/transactions/Transactions.js +94 -0
  191. package/useTheme.js +22 -0
  192. package/wizard/Icons.js +65 -0
  193. package/wizard/Wizard.d.ts +4 -0
  194. package/wizard/Wizard.js +231 -0
  195. package/wizard/Wizard.stories.jsx +224 -0
  196. package/wizard/types.d.ts +64 -0
  197. package/wizard/types.js +5 -0
  198. package/README.md +0 -66
  199. package/babel.config.js +0 -4
  200. package/dist/accordion/Accordion.js +0 -248
  201. package/dist/accordion/Accordion.stories.js +0 -207
  202. package/dist/accordion/readme.md +0 -96
  203. package/dist/alert/Alert.js +0 -304
  204. package/dist/alert/Alert.stories.js +0 -158
  205. package/dist/alert/close.svg +0 -4
  206. package/dist/alert/error.svg +0 -4
  207. package/dist/alert/info.svg +0 -4
  208. package/dist/alert/readme.md +0 -43
  209. package/dist/alert/success.svg +0 -4
  210. package/dist/alert/warning.svg +0 -4
  211. package/dist/box/Box.js +0 -148
  212. package/dist/button/Button.js +0 -181
  213. package/dist/button/Button.stories.js +0 -224
  214. package/dist/button/readme.md +0 -93
  215. package/dist/card/Card.js +0 -217
  216. package/dist/checkbox/Checkbox.js +0 -240
  217. package/dist/checkbox/Checkbox.stories.js +0 -144
  218. package/dist/checkbox/readme.md +0 -116
  219. package/dist/chip/Chip.js +0 -173
  220. package/dist/common/services/example-service.js +0 -10
  221. package/dist/common/services/example-service.test.js +0 -12
  222. package/dist/common/utils.js +0 -42
  223. package/dist/common/variables.js +0 -434
  224. package/dist/date/Date.stories.js +0 -205
  225. package/dist/date/calendar.svg +0 -1
  226. package/dist/date/calendar_dark.svg +0 -1
  227. package/dist/date/readme.md +0 -73
  228. package/dist/dialog/Dialog.js +0 -197
  229. package/dist/dialog/Dialog.stories.js +0 -217
  230. package/dist/dialog/readme.md +0 -32
  231. package/dist/dropdown/Dropdown.js +0 -416
  232. package/dist/dropdown/Dropdown.stories.js +0 -249
  233. package/dist/dropdown/baseline-arrow_drop_down.svg +0 -1
  234. package/dist/dropdown/baseline-arrow_drop_down_wh.svg +0 -4
  235. package/dist/dropdown/baseline-arrow_drop_up.svg +0 -1
  236. package/dist/dropdown/baseline-arrow_drop_up_wh.svg +0 -4
  237. package/dist/dropdown/readme.md +0 -69
  238. package/dist/footer/Footer.js +0 -346
  239. package/dist/footer/Footer.stories.js +0 -94
  240. package/dist/footer/dxc_logo_wht.png +0 -0
  241. package/dist/footer/readme.md +0 -41
  242. package/dist/header/Header.js +0 -373
  243. package/dist/header/Header.stories.js +0 -176
  244. package/dist/header/close_icon.svg +0 -1
  245. package/dist/header/dxc_logo_black.png +0 -0
  246. package/dist/header/dxc_logo_blk_rgb.svg +0 -6
  247. package/dist/header/dxc_logo_white.png +0 -0
  248. package/dist/header/hamb_menu_black.svg +0 -1
  249. package/dist/header/hamb_menu_white.svg +0 -1
  250. package/dist/header/readme.md +0 -33
  251. package/dist/heading/Heading.js +0 -153
  252. package/dist/input-text/InputText.js +0 -519
  253. package/dist/input-text/InputText.stories.js +0 -209
  254. package/dist/input-text/error.svg +0 -1
  255. package/dist/input-text/readme.md +0 -91
  256. package/dist/layout/facebook.svg +0 -45
  257. package/dist/layout/linkedin.svg +0 -50
  258. package/dist/layout/twitter.svg +0 -53
  259. package/dist/link/Link.js +0 -171
  260. package/dist/link/readme.md +0 -51
  261. package/dist/paginator/Paginator.js +0 -196
  262. package/dist/paginator/images/next.svg +0 -3
  263. package/dist/paginator/images/nextPage.svg +0 -3
  264. package/dist/paginator/images/previous.svg +0 -3
  265. package/dist/paginator/images/previousPage.svg +0 -3
  266. package/dist/paginator/readme.md +0 -50
  267. package/dist/progress-bar/ProgressBar.js +0 -185
  268. package/dist/progress-bar/ProgressBar.stories.js +0 -280
  269. package/dist/progress-bar/readme.md +0 -63
  270. package/dist/radio/Radio.js +0 -195
  271. package/dist/radio/Radio.stories.js +0 -166
  272. package/dist/radio/readme.md +0 -70
  273. package/dist/resultsetTable/ResultsetTable.js +0 -333
  274. package/dist/resultsetTable/arrow_downward-24px_wht.svg +0 -1
  275. package/dist/resultsetTable/arrow_upward-24px_wht.svg +0 -1
  276. package/dist/resultsetTable/unfold_more-24px_wht.svg +0 -1
  277. package/dist/select/Select.js +0 -453
  278. package/dist/select/Select.stories.js +0 -235
  279. package/dist/select/readme.md +0 -72
  280. package/dist/sidenav/Sidenav.js +0 -69
  281. package/dist/slider/Slider.js +0 -266
  282. package/dist/slider/Slider.stories.js +0 -241
  283. package/dist/slider/readme.md +0 -64
  284. package/dist/spinner/Spinner.js +0 -193
  285. package/dist/spinner/Spinner.stories.js +0 -183
  286. package/dist/spinner/readme.md +0 -65
  287. package/dist/switch/Switch.js +0 -199
  288. package/dist/switch/Switch.stories.js +0 -134
  289. package/dist/switch/readme.md +0 -133
  290. package/dist/table/Table.js +0 -105
  291. package/dist/tabs/Tabs.js +0 -172
  292. package/dist/tabs/Tabs.stories.js +0 -130
  293. package/dist/tabs/readme.md +0 -78
  294. package/dist/tabs-for-sections/TabsForSections.js +0 -92
  295. package/dist/tabs-for-sections/readme.md +0 -78
  296. package/dist/tag/Tag.js +0 -234
  297. package/dist/textarea/Textarea.js +0 -227
  298. package/dist/toggle/Toggle.stories.js +0 -297
  299. package/dist/toggle/readme.md +0 -80
  300. package/dist/toggle-group/ToggleGroup.js +0 -214
  301. package/dist/toggle-group/readme.md +0 -82
  302. package/dist/upload/Upload.stories.js +0 -72
  303. package/dist/upload/buttons-upload/ButtonsUpload.js +0 -122
  304. package/dist/upload/buttons-upload/drag-drop-icon.svg +0 -4
  305. package/dist/upload/buttons-upload/upload-button.svg +0 -1
  306. package/dist/upload/dragAndDropArea/DragAndDropArea.js +0 -279
  307. package/dist/upload/dragAndDropArea/upload_drop.svg +0 -4
  308. package/dist/upload/dragAndDropArea/upload_file.svg +0 -4
  309. package/dist/upload/file-upload/FileToUpload.js +0 -158
  310. package/dist/upload/file-upload/audio-icon.svg +0 -4
  311. package/dist/upload/file-upload/close.svg +0 -4
  312. package/dist/upload/file-upload/file-icon.svg +0 -4
  313. package/dist/upload/file-upload/video-icon.svg +0 -4
  314. package/dist/upload/files-upload/FilesToUpload.js +0 -123
  315. package/dist/upload/readme.md +0 -37
  316. package/dist/upload/transaction/Transaction.js +0 -155
  317. package/dist/upload/transaction/audio-icon-err.svg +0 -4
  318. package/dist/upload/transaction/audio-icon.svg +0 -4
  319. package/dist/upload/transaction/error-icon.svg +0 -4
  320. package/dist/upload/transaction/file-icon-err.svg +0 -4
  321. package/dist/upload/transaction/file-icon.svg +0 -4
  322. package/dist/upload/transaction/image-icon-err.svg +0 -4
  323. package/dist/upload/transaction/image-icon.svg +0 -4
  324. package/dist/upload/transaction/success-icon.svg +0 -4
  325. package/dist/upload/transaction/video-icon-err.svg +0 -4
  326. package/dist/upload/transaction/video-icon.svg +0 -4
  327. package/dist/upload/transactions/Transactions.js +0 -120
  328. package/dist/wizard/Wizard.js +0 -327
  329. package/dist/wizard/invalid_icon.svg +0 -6
  330. package/dist/wizard/valid_icon.svg +0 -6
  331. package/dist/wizard/validation-wrong.svg +0 -6
  332. package/test/Accordion.test.js +0 -33
  333. package/test/Alert.test.js +0 -53
  334. package/test/Box.test.js +0 -10
  335. package/test/Button.test.js +0 -18
  336. package/test/Card.test.js +0 -30
  337. package/test/Checkbox.test.js +0 -45
  338. package/test/Chip.test.js +0 -25
  339. package/test/Date.test.js +0 -393
  340. package/test/Dialog.test.js +0 -23
  341. package/test/Dropdown.test.js +0 -130
  342. package/test/Footer.test.js +0 -99
  343. package/test/Header.test.js +0 -39
  344. package/test/Heading.test.js +0 -35
  345. package/test/InputText.test.js +0 -236
  346. package/test/Link.test.js +0 -33
  347. package/test/Paginator.test.js +0 -165
  348. package/test/ProgressBar.test.js +0 -35
  349. package/test/Radio.test.js +0 -37
  350. package/test/ResultsetTable.test.js +0 -282
  351. package/test/Select.test.js +0 -191
  352. package/test/Sidenav.test.js +0 -19
  353. package/test/Slider.test.js +0 -82
  354. package/test/Spinner.test.js +0 -27
  355. package/test/Switch.test.js +0 -45
  356. package/test/Table.test.js +0 -36
  357. package/test/Tabs.test.js +0 -88
  358. package/test/TabsForSections.test.js +0 -34
  359. package/test/Tag.test.js +0 -32
  360. package/test/TextArea.test.js +0 -52
  361. package/test/Toggle.test.js +0 -43
  362. package/test/ToggleGroup.test.js +0 -81
  363. package/test/Upload.test.js +0 -60
  364. package/test/Wizard.test.js +0 -130
  365. package/test/mocks/pngMock.js +0 -1
  366. package/test/mocks/svgMock.js +0 -1
@@ -0,0 +1,63 @@
1
+ import React from "react";
2
+ import DxcPaginator from "./Paginator";
3
+ import Title from "../../.storybook/components/Title";
4
+ import ExampleContainer from "../../.storybook/components/ExampleContainer";
5
+
6
+ export default {
7
+ title: "Paginator",
8
+ component: DxcPaginator,
9
+ };
10
+
11
+ export const Chromatic = () => (
12
+ <>
13
+ <ExampleContainer>
14
+ <Title title="Default" theme="light" level={4} />
15
+ <DxcPaginator />
16
+ </ExampleContainer>
17
+ <ExampleContainer>
18
+ <Title title="Default with items per page options" theme="light" level={4} />
19
+ <DxcPaginator itemsPerPageOptions={[5, 10, 15]} />
20
+ </ExampleContainer>
21
+ <ExampleContainer>
22
+ <Title title="Default with show go to page selector" theme="light" level={4} />
23
+ <DxcPaginator showGoToPage />
24
+ </ExampleContainer>
25
+ <ExampleContainer>
26
+ <Title title="Page change in first page" theme="light" level={4} />
27
+ <DxcPaginator currentPage={1} itemsPerPage={10} totalItems={27} onPageChange={() => {}} />
28
+ </ExampleContainer>
29
+ <ExampleContainer>
30
+ <Title title="Page change in middle page" theme="light" level={4} />
31
+ <DxcPaginator currentPage={2} itemsPerPage={10} totalItems={27} onPageChange={() => {}} />
32
+ </ExampleContainer>
33
+ <ExampleContainer>
34
+ <Title title="Page change in last page" theme="light" level={4} />
35
+ <DxcPaginator currentPage={3} itemsPerPage={10} totalItems={27} onPageChange={() => {}} />
36
+ </ExampleContainer>
37
+ <ExampleContainer>
38
+ <Title title="Page change and items per page options" theme="light" level={4} />
39
+ <DxcPaginator
40
+ currentPage={1}
41
+ itemsPerPage={10}
42
+ totalItems={27}
43
+ onPageChange={() => {}}
44
+ itemsPerPageOptions={[5, 10, 15]}
45
+ />
46
+ </ExampleContainer>
47
+ <ExampleContainer>
48
+ <Title title="Page change and show go to page selector" theme="light" level={4} />
49
+ <DxcPaginator currentPage={1} itemsPerPage={10} totalItems={27} onPageChange={() => {}} showGoToPage />
50
+ </ExampleContainer>
51
+ <ExampleContainer>
52
+ <Title title="Page change, show go to page and items per page selectors" theme="light" level={4} />
53
+ <DxcPaginator
54
+ currentPage={1}
55
+ itemsPerPage={10}
56
+ totalItems={27}
57
+ onPageChange={() => {}}
58
+ itemsPerPageOptions={[5, 10, 15]}
59
+ showGoToPage
60
+ />
61
+ </ExampleContainer>
62
+ </>
63
+ );
@@ -0,0 +1,38 @@
1
+ declare type Props = {
2
+ /**
3
+ * Number of the current selected page.
4
+ */
5
+ currentPage?: number;
6
+ /**
7
+ * Number of items per page.
8
+ */
9
+ itemsPerPage?: number;
10
+ /**
11
+ * Array of numbers representing the items per page options.
12
+ * If undefined, the select with items per page options will not be displayed.
13
+ */
14
+ itemsPerPageOptions?: number[];
15
+ /**
16
+ * This function will be called when the user selects an item per page option.
17
+ * The number will be passed as a parameter to this function.
18
+ */
19
+ itemsPerPageFunction?: (val: number) => void;
20
+ /**
21
+ * Total number of items in the pages.
22
+ */
23
+ totalItems?: number;
24
+ /**
25
+ * If true, a select will be displayed with the page numbers to move through them.
26
+ */
27
+ showGoToPage?: boolean;
28
+ /**
29
+ * This function will be called when the user clicks on any of the button to change pages.
30
+ * The page number will be passed as a parameter to this function.
31
+ */
32
+ onPageChange?: (val: number) => void;
33
+ /**
34
+ * Value of the tabindex attribute.
35
+ */
36
+ tabIndex?: number;
37
+ };
38
+ export default Props;
@@ -0,0 +1,5 @@
1
+ "use strict";
2
+
3
+ Object.defineProperty(exports, "__esModule", {
4
+ value: true
5
+ });
@@ -0,0 +1,4 @@
1
+ import React from "react";
2
+ import PasswordInputPropsType from "./types";
3
+ declare const DxcPasswordInput: React.ForwardRefExoticComponent<PasswordInputPropsType & React.RefAttributes<HTMLDivElement>>;
4
+ export default DxcPasswordInput;
@@ -0,0 +1,162 @@
1
+ "use strict";
2
+
3
+ var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
4
+
5
+ var _typeof = require("@babel/runtime/helpers/typeof");
6
+
7
+ Object.defineProperty(exports, "__esModule", {
8
+ value: true
9
+ });
10
+ exports["default"] = void 0;
11
+
12
+ var _taggedTemplateLiteral2 = _interopRequireDefault(require("@babel/runtime/helpers/taggedTemplateLiteral"));
13
+
14
+ var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
15
+
16
+ var _react = _interopRequireWildcard(require("react"));
17
+
18
+ var _styledComponents = _interopRequireDefault(require("styled-components"));
19
+
20
+ var _TextInput = _interopRequireDefault(require("../text-input/TextInput"));
21
+
22
+ var _templateObject;
23
+
24
+ function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
25
+
26
+ function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || _typeof(obj) !== "object" && typeof obj !== "function") { return { "default": obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj["default"] = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
27
+
28
+ var DxcPasswordInput = /*#__PURE__*/_react["default"].forwardRef(function (_ref, ref) {
29
+ var _ref$label = _ref.label,
30
+ label = _ref$label === void 0 ? "" : _ref$label,
31
+ _ref$name = _ref.name,
32
+ name = _ref$name === void 0 ? "" : _ref$name,
33
+ value = _ref.value,
34
+ _ref$helperText = _ref.helperText,
35
+ helperText = _ref$helperText === void 0 ? "" : _ref$helperText,
36
+ _ref$clearable = _ref.clearable,
37
+ clearable = _ref$clearable === void 0 ? false : _ref$clearable,
38
+ onChange = _ref.onChange,
39
+ onBlur = _ref.onBlur,
40
+ _ref$error = _ref.error,
41
+ error = _ref$error === void 0 ? "" : _ref$error,
42
+ pattern = _ref.pattern,
43
+ length = _ref.length,
44
+ _ref$autocomplete = _ref.autocomplete,
45
+ autocomplete = _ref$autocomplete === void 0 ? "off" : _ref$autocomplete,
46
+ margin = _ref.margin,
47
+ _ref$size = _ref.size,
48
+ size = _ref$size === void 0 ? "medium" : _ref$size,
49
+ _ref$tabIndex = _ref.tabIndex,
50
+ tabIndex = _ref$tabIndex === void 0 ? 0 : _ref$tabIndex;
51
+
52
+ var _useState = (0, _react.useState)(false),
53
+ _useState2 = (0, _slicedToArray2["default"])(_useState, 2),
54
+ isPasswordVisible = _useState2[0],
55
+ setIsPasswordVisible = _useState2[1];
56
+
57
+ var inputRef = (0, _react.useRef)(null);
58
+
59
+ var setInputType = function setInputType(type) {
60
+ var _inputRef$current, _inputRef$current$chi;
61
+
62
+ inputRef === null || inputRef === void 0 ? void 0 : (_inputRef$current = inputRef.current) === null || _inputRef$current === void 0 ? void 0 : (_inputRef$current$chi = _inputRef$current.children[2]) === null || _inputRef$current$chi === void 0 ? void 0 : _inputRef$current$chi.children[0].setAttribute("type", type);
63
+ };
64
+
65
+ var setAriaAttributes = function setAriaAttributes(ariaExpanded, ariaLabel) {
66
+ if (error && clearable && value) {
67
+ var _inputRef$current2, _inputRef$current2$ch, _inputRef$current2$ch2, _inputRef$current3, _inputRef$current3$ch, _inputRef$current3$ch2;
68
+
69
+ inputRef === null || inputRef === void 0 ? void 0 : (_inputRef$current2 = inputRef.current) === null || _inputRef$current2 === void 0 ? void 0 : (_inputRef$current2$ch = _inputRef$current2.children[2]) === null || _inputRef$current2$ch === void 0 ? void 0 : (_inputRef$current2$ch2 = _inputRef$current2$ch.children[3]) === null || _inputRef$current2$ch2 === void 0 ? void 0 : _inputRef$current2$ch2.setAttribute("aria-expanded", ariaExpanded);
70
+ inputRef === null || inputRef === void 0 ? void 0 : (_inputRef$current3 = inputRef.current) === null || _inputRef$current3 === void 0 ? void 0 : (_inputRef$current3$ch = _inputRef$current3.children[2]) === null || _inputRef$current3$ch === void 0 ? void 0 : (_inputRef$current3$ch2 = _inputRef$current3$ch.children[3]) === null || _inputRef$current3$ch2 === void 0 ? void 0 : _inputRef$current3$ch2.setAttribute("aria-label", ariaLabel);
71
+ } else if (error || clearable && !value) {
72
+ var _inputRef$current4, _inputRef$current4$ch, _inputRef$current4$ch2, _inputRef$current5, _inputRef$current5$ch, _inputRef$current5$ch2;
73
+
74
+ inputRef === null || inputRef === void 0 ? void 0 : (_inputRef$current4 = inputRef.current) === null || _inputRef$current4 === void 0 ? void 0 : (_inputRef$current4$ch = _inputRef$current4.children[2]) === null || _inputRef$current4$ch === void 0 ? void 0 : (_inputRef$current4$ch2 = _inputRef$current4$ch.children[2]) === null || _inputRef$current4$ch2 === void 0 ? void 0 : _inputRef$current4$ch2.setAttribute("aria-expanded", ariaExpanded);
75
+ inputRef === null || inputRef === void 0 ? void 0 : (_inputRef$current5 = inputRef.current) === null || _inputRef$current5 === void 0 ? void 0 : (_inputRef$current5$ch = _inputRef$current5.children[2]) === null || _inputRef$current5$ch === void 0 ? void 0 : (_inputRef$current5$ch2 = _inputRef$current5$ch.children[2]) === null || _inputRef$current5$ch2 === void 0 ? void 0 : _inputRef$current5$ch2.setAttribute("aria-label", ariaLabel);
76
+ } else {
77
+ var _inputRef$current6, _inputRef$current6$ch, _inputRef$current6$ch2, _inputRef$current7, _inputRef$current7$ch, _inputRef$current7$ch2;
78
+
79
+ inputRef === null || inputRef === void 0 ? void 0 : (_inputRef$current6 = inputRef.current) === null || _inputRef$current6 === void 0 ? void 0 : (_inputRef$current6$ch = _inputRef$current6.children[2]) === null || _inputRef$current6$ch === void 0 ? void 0 : (_inputRef$current6$ch2 = _inputRef$current6$ch.children[1]) === null || _inputRef$current6$ch2 === void 0 ? void 0 : _inputRef$current6$ch2.setAttribute("aria-expanded", ariaExpanded);
80
+ inputRef === null || inputRef === void 0 ? void 0 : (_inputRef$current7 = inputRef.current) === null || _inputRef$current7 === void 0 ? void 0 : (_inputRef$current7$ch = _inputRef$current7.children[2]) === null || _inputRef$current7$ch === void 0 ? void 0 : (_inputRef$current7$ch2 = _inputRef$current7$ch.children[1]) === null || _inputRef$current7$ch2 === void 0 ? void 0 : _inputRef$current7$ch2.setAttribute("aria-label", ariaLabel);
81
+ }
82
+ };
83
+
84
+ var getIconTitle = function getIconTitle() {
85
+ return isPasswordVisible ? "Hide password" : "Show password";
86
+ };
87
+
88
+ (0, _react.useEffect)(function () {
89
+ setAriaAttributes(false, "Show");
90
+
91
+ if (isPasswordVisible) {
92
+ setInputType("text");
93
+ setAriaAttributes(true, "Hide");
94
+ } else {
95
+ setInputType("password");
96
+ setAriaAttributes(false, "Show");
97
+ }
98
+ }, [isPasswordVisible]);
99
+
100
+ var viewPassword = function viewPassword() {
101
+ setInputType("text");
102
+ setIsPasswordVisible(true);
103
+ };
104
+
105
+ var hidePassword = function hidePassword() {
106
+ setInputType("password");
107
+ setIsPasswordVisible(false);
108
+ };
109
+
110
+ var action = {
111
+ onClick: isPasswordVisible ? hidePassword : viewPassword,
112
+ icon: isPasswordVisible ? /*#__PURE__*/_react["default"].createElement("svg", {
113
+ xmlns: "http://www.w3.org/2000/svg",
114
+ height: "24px",
115
+ viewBox: "0 0 24 24",
116
+ width: "24px",
117
+ fill: "currentColor"
118
+ }, /*#__PURE__*/_react["default"].createElement("path", {
119
+ d: "M0 0h24v24H0V0zm0 0h24v24H0V0zm0 0h24v24H0V0zm0 0h24v24H0V0z",
120
+ fill: "none"
121
+ }), /*#__PURE__*/_react["default"].createElement("path", {
122
+ d: "M12 6c3.79 0 7.17 2.13 8.82 5.5-.59 1.22-1.42 2.27-2.41 3.12l1.41 1.41c1.39-1.23 2.49-2.77 3.18-4.53C21.27 7.11 17 4 12 4c-1.27 0-2.49.2-3.64.57l1.65 1.65C10.66 6.09 11.32 6 12 6zm-1.07 1.14L13 9.21c.57.25 1.03.71 1.28 1.28l2.07 2.07c.08-.34.14-.7.14-1.07C16.5 9.01 14.48 7 12 7c-.37 0-.72.05-1.07.14zM2.01 3.87l2.68 2.68C3.06 7.83 1.77 9.53 1 11.5 2.73 15.89 7 19 12 19c1.52 0 2.98-.29 4.32-.82l3.42 3.42 1.41-1.41L3.42 2.45 2.01 3.87zm7.5 7.5l2.61 2.61c-.04.01-.08.02-.12.02-1.38 0-2.5-1.12-2.5-2.5 0-.05.01-.08.01-.13zm-3.4-3.4l1.75 1.75c-.23.55-.36 1.15-.36 1.78 0 2.48 2.02 4.5 4.5 4.5.63 0 1.23-.13 1.77-.36l.98.98c-.88.24-1.8.38-2.75.38-3.79 0-7.17-2.13-8.82-5.5.7-1.43 1.72-2.61 2.93-3.53z"
123
+ })) : /*#__PURE__*/_react["default"].createElement("svg", {
124
+ xmlns: "http://www.w3.org/2000/svg",
125
+ height: "24px",
126
+ viewBox: "0 0 24 24",
127
+ width: "24px",
128
+ fill: "currentColor"
129
+ }, /*#__PURE__*/_react["default"].createElement("path", {
130
+ d: "M0 0h24v24H0V0z",
131
+ fill: "none"
132
+ }), /*#__PURE__*/_react["default"].createElement("path", {
133
+ d: "M12 6c3.79 0 7.17 2.13 8.82 5.5C19.17 14.87 15.79 17 12 17s-7.17-2.13-8.82-5.5C4.83 8.13 8.21 6 12 6m0-2C7 4 2.73 7.11 1 11.5 2.73 15.89 7 19 12 19s9.27-3.11 11-7.5C21.27 7.11 17 4 12 4zm0 5c1.38 0 2.5 1.12 2.5 2.5S13.38 14 12 14s-2.5-1.12-2.5-2.5S10.62 9 12 9m0-2c-2.48 0-4.5 2.02-4.5 4.5S9.52 16 12 16s4.5-2.02 4.5-4.5S14.48 7 12 7z"
134
+ })),
135
+ title: getIconTitle()
136
+ };
137
+ return /*#__PURE__*/_react["default"].createElement(PasswordInput, {
138
+ ref: ref
139
+ }, /*#__PURE__*/_react["default"].createElement(_TextInput["default"], {
140
+ ref: inputRef,
141
+ label: label,
142
+ name: name,
143
+ value: value,
144
+ helperText: helperText,
145
+ action: action,
146
+ error: error,
147
+ clearable: clearable,
148
+ onChange: onChange,
149
+ onBlur: onBlur,
150
+ margin: margin,
151
+ size: size,
152
+ pattern: pattern,
153
+ length: length,
154
+ autocomplete: autocomplete,
155
+ tabIndex: tabIndex
156
+ }));
157
+ });
158
+
159
+ var PasswordInput = _styledComponents["default"].div(_templateObject || (_templateObject = (0, _taggedTemplateLiteral2["default"])(["\n & ::-ms-reveal {\n display: none;\n }\n"])));
160
+
161
+ var _default = DxcPasswordInput;
162
+ exports["default"] = _default;
@@ -0,0 +1,131 @@
1
+ import React from "react";
2
+ import { userEvent, within } from "@storybook/testing-library";
3
+ import DxcPasswordInput from "./PasswordInput";
4
+ import { BackgroundColorProvider } from "../BackgroundColorContext";
5
+ import Title from "../../.storybook/components/Title";
6
+ import ExampleContainer from "../../.storybook/components/ExampleContainer";
7
+ import DarkContainer from "../../.storybook/components/DarkSection";
8
+
9
+ export default {
10
+ title: "Password input",
11
+ component: DxcPasswordInput,
12
+ };
13
+
14
+ export const Chromatic = () => (
15
+ <>
16
+ <ExampleContainer>
17
+ <Title title="Without label" theme="light" level={4} />
18
+ <DxcPasswordInput />
19
+ </ExampleContainer>
20
+ <ExampleContainer>
21
+ <Title title="With label" theme="light" level={4} />
22
+ <DxcPasswordInput label="Password input" clearable />
23
+ </ExampleContainer>
24
+ <ExampleContainer>
25
+ <Title title="Clearable" theme="light" level={4} />
26
+ <DxcPasswordInput label="Password input" clearable value="password" />
27
+ </ExampleContainer>
28
+ <ExampleContainer>
29
+ <Title title="Non clearable" theme="light" level={4} />
30
+ <DxcPasswordInput label="Non clearable password input" value="password" />
31
+ </ExampleContainer>
32
+ <ExampleContainer>
33
+ <Title title="Helper text" theme="light" level={4} />
34
+ <DxcPasswordInput label="Help password input" helperText="Help message" />
35
+ </ExampleContainer>
36
+ <ExampleContainer>
37
+ <Title title="Invalid" theme="light" level={4} />
38
+ <DxcPasswordInput label="Error password input" error="Error message." />
39
+ </ExampleContainer>
40
+ <BackgroundColorProvider color="#333333">
41
+ <DarkContainer>
42
+ <Title title="Dark" theme="dark" level={2} />
43
+ <ExampleContainer>
44
+ <Title title="With label, helper text and value" theme="dark" level={4} />
45
+ <DxcPasswordInput label="Password input" helperText="Help message" value="Password" />
46
+ </ExampleContainer>
47
+ <ExampleContainer>
48
+ <Title title="With label, helper text, value and error" theme="dark" level={4} />
49
+ <DxcPasswordInput label="Password input" helperText="Help message" error="Error message." value="Password" />
50
+ </ExampleContainer>
51
+ </DarkContainer>
52
+ </BackgroundColorProvider>
53
+ <Title title="Margins" theme="light" level={2} />
54
+ <ExampleContainer>
55
+ <Title title="Xxsmall margin" theme="light" level={4} />
56
+ <DxcPasswordInput label="Xxsmmall" margin="xxsmall" />
57
+ </ExampleContainer>
58
+ <ExampleContainer>
59
+ <Title title="Xsmall margin" theme="light" level={4} />
60
+ <DxcPasswordInput label="Xsmall" margin="xsmall" />
61
+ </ExampleContainer>
62
+ <ExampleContainer>
63
+ <Title title="Small margin" theme="light" level={4} />
64
+ <DxcPasswordInput label="Small" margin="small" />
65
+ </ExampleContainer>
66
+ <ExampleContainer>
67
+ <Title title="Medium margin" theme="light" level={4} />
68
+ <DxcPasswordInput label="Medium" margin="medium" />
69
+ </ExampleContainer>
70
+ <ExampleContainer>
71
+ <Title title="Large margin" theme="light" level={4} />
72
+ <DxcPasswordInput label="Large" margin="large" />
73
+ </ExampleContainer>
74
+ <ExampleContainer>
75
+ <Title title="Xlarge margin" theme="light" level={4} />
76
+ <DxcPasswordInput label="Xlarge" margin="xlarge" />
77
+ </ExampleContainer>
78
+ <ExampleContainer>
79
+ <Title title="Xxlarge margin" theme="light" level={4} />
80
+ <DxcPasswordInput label="Xxlarge" margin="xxlarge" />
81
+ </ExampleContainer>
82
+ <Title title="Sizes" theme="light" level={2} />
83
+ <ExampleContainer>
84
+ <Title title="Small size" theme="light" level={4} />
85
+ <DxcPasswordInput label="Small" size="small" />
86
+ </ExampleContainer>
87
+ <ExampleContainer>
88
+ <Title title="Medium size" theme="light" level={4} />
89
+ <DxcPasswordInput label="Medium" size="medium" />
90
+ </ExampleContainer>
91
+ <ExampleContainer>
92
+ <Title title="Large size" theme="light" level={4} />
93
+ <DxcPasswordInput label="Large" size="large" />
94
+ </ExampleContainer>
95
+ <ExampleContainer>
96
+ <Title title="FillParent size" theme="light" level={4} />
97
+ <DxcPasswordInput label="FillParent" size="fillParent" />
98
+ </ExampleContainer>
99
+ </>
100
+ );
101
+
102
+ const Password = () => (
103
+ <ExampleContainer>
104
+ <Title title="Show password" theme="light" level={4} />
105
+ <DxcPasswordInput label="Password input" value="Password" />
106
+ </ExampleContainer>
107
+ );
108
+ const PasswordDark = () => (
109
+ <BackgroundColorProvider color="#333333">
110
+ <DarkContainer>
111
+ <ExampleContainer>
112
+ <Title title="Show password" theme="dark" level={4} />
113
+ <DxcPasswordInput label="Password input" value="Password" />
114
+ </ExampleContainer>
115
+ </DarkContainer>
116
+ </BackgroundColorProvider>
117
+ );
118
+
119
+ export const ShowPassword = Password.bind({});
120
+ ShowPassword.play = async ({ canvasElement }) => {
121
+ const canvas = within(canvasElement);
122
+ const passwordBtn = canvas.getByRole("button");
123
+ await userEvent.click(passwordBtn);
124
+ };
125
+
126
+ export const ShowPasswordDark = PasswordDark.bind({});
127
+ ShowPasswordDark.play = async ({ canvasElement }) => {
128
+ const canvas = within(canvasElement);
129
+ const passwordBtn = canvas.getByRole("button");
130
+ await userEvent.click(passwordBtn);
131
+ };
@@ -0,0 +1,100 @@
1
+ declare type Space = "xxsmall" | "xsmall" | "small" | "medium" | "large" | "xlarge" | "xxlarge";
2
+ declare type Margin = {
3
+ top?: Space;
4
+ bottom?: Space;
5
+ left?: Space;
6
+ right?: Space;
7
+ };
8
+ declare type Props = {
9
+ /**
10
+ * Text to be placed above the password.
11
+ */
12
+ label?: string;
13
+ /**
14
+ * Name attribute of the input element.
15
+ */
16
+ name?: string;
17
+ /**
18
+ * Value of the input element. If undefined, the component will be uncontrolled and the value will be managed internally by the component.
19
+ */
20
+ value?: string;
21
+ /**
22
+ * Helper text to be placed above the password.
23
+ */
24
+ helperText?: string;
25
+ /**
26
+ * If true, the password input will have an action to clear the entered value.
27
+ */
28
+ clearable?: boolean;
29
+ /**
30
+ * This function will be called when the user types within the input
31
+ * element of the component. An object including the current value and
32
+ * the error (if the value entered is not valid) will be passed to this
33
+ * function. If there is no error, error will be null.
34
+ * */
35
+ onChange?: (val: {
36
+ value: string;
37
+ error: string | null;
38
+ }) => void;
39
+ /**
40
+ * This function will be called when the input element loses the focus.
41
+ * An object including the input value and the error (if the value entered is
42
+ * not valid) will be passed to this function. If there is no error, error will be null.
43
+ */
44
+ onBlur?: (val: {
45
+ value: string;
46
+ error: string | null;
47
+ }) => void;
48
+ /**
49
+ * If it is defined, the component will change its appearance, showing
50
+ * the error below the password input component. If it is not defined, the
51
+ * error messages will be managed internally, but never displayed on its own.
52
+ */
53
+ error?: string;
54
+ /**
55
+ * Regular expression that defines the valid format allowed by the
56
+ * password input. This will be checked both when the input element loses the
57
+ * focus and while typing within it. If the string entered does not match
58
+ * the pattern, the onBlur and onChange functions will be called with the
59
+ * current value and an internal error informing that this value does not
60
+ * match the pattern. If the pattern is met, the error parameter of both
61
+ * events will be null.
62
+ */
63
+ pattern?: string;
64
+ /**
65
+ * Specifies the minimun and maximum length allowed by the password input.
66
+ * This will be checked both when the input element loses the
67
+ * focus and while typing within it. If the string entered does not
68
+ * comply the length, the onBlur and onChange functions will be called
69
+ * with the current value and an internal error informing that the value
70
+ * length does not comply the specified range. If a valid length is
71
+ * reached, the error parameter of both events will be null.
72
+ */
73
+ length?: {
74
+ min?: number;
75
+ max?: number;
76
+ };
77
+ /**
78
+ * HTML autocomplete attribute. Lets the user specify if any permission the user agent has to provide automated assistance in filling out the input value.
79
+ * Its value must be one of all the possible values of the HTML autocomplete attribute: 'on', 'off', 'email', 'username', 'new-password', ...
80
+ */
81
+ autocomplete?: string;
82
+ /**
83
+ * Size of the margin to be applied to the component ('xxsmall' | 'xsmall' | 'small' | 'medium' | 'large' | 'xlarge' | 'xxlarge').
84
+ * You can pass an object with 'top', 'bottom', 'left' and 'right' properties in order to specify different margin sizes.
85
+ */
86
+ margin?: Space | Margin;
87
+ /**
88
+ * Size of the component ('small' | 'medium' | 'large' | 'fillParent').
89
+ */
90
+ size?: "small" | "medium" | "large" | "fillParent";
91
+ /**
92
+ * Value of the tabindex attribute.
93
+ */
94
+ tabIndex?: number;
95
+ };
96
+ /**
97
+ * Reference to the component.
98
+ */
99
+ export declare type RefType = HTMLDivElement;
100
+ export default Props;
@@ -0,0 +1,5 @@
1
+ "use strict";
2
+
3
+ Object.defineProperty(exports, "__esModule", {
4
+ value: true
5
+ });
@@ -0,0 +1,4 @@
1
+ /// <reference types="react" />
2
+ import ProgressBarPropsType from "./types";
3
+ declare const DxcProgressBar: ({ label, helperText, overlay, value, showValue, margin, }: ProgressBarPropsType) => JSX.Element;
4
+ export default DxcProgressBar;