@arbor-education/design-system.components 0.25.8 → 1.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 (432) hide show
  1. package/.gather/instructions/project-overview.md +1 -1
  2. package/.github/CODEOWNERS +1 -0
  3. package/.snyk +3 -0
  4. package/CHANGELOG.md +20 -0
  5. package/CODEOWNERS +2 -1
  6. package/CONTRIBUTING.md +7 -5
  7. package/component-library.md +97 -3
  8. package/dist/components/datePicker/DatePicker.d.ts.map +1 -1
  9. package/dist/components/datePicker/DatePicker.js +8 -6
  10. package/dist/components/datePicker/DatePicker.js.map +1 -1
  11. package/dist/components/datePicker/DatePickerCalendar.d.ts +10 -0
  12. package/dist/components/datePicker/DatePickerCalendar.d.ts.map +1 -0
  13. package/dist/components/datePicker/DatePickerCalendar.js +9 -0
  14. package/dist/components/datePicker/DatePickerCalendar.js.map +1 -0
  15. package/dist/components/dateTimePicker/DateTimePicker.d.ts.map +1 -1
  16. package/dist/components/dateTimePicker/DateTimePicker.js +11 -8
  17. package/dist/components/dateTimePicker/DateTimePicker.js.map +1 -1
  18. package/dist/components/emptyState/EmptyState.d.ts +22 -0
  19. package/dist/components/emptyState/EmptyState.d.ts.map +1 -0
  20. package/dist/components/emptyState/EmptyState.js +11 -0
  21. package/dist/components/emptyState/EmptyState.js.map +1 -0
  22. package/dist/components/emptyState/EmptyState.stories.d.ts +117 -0
  23. package/dist/components/emptyState/EmptyState.stories.d.ts.map +1 -0
  24. package/dist/components/emptyState/EmptyState.stories.js +332 -0
  25. package/dist/components/emptyState/EmptyState.stories.js.map +1 -0
  26. package/dist/components/emptyState/EmptyState.test.d.ts +2 -0
  27. package/dist/components/emptyState/EmptyState.test.d.ts.map +1 -0
  28. package/dist/components/emptyState/EmptyState.test.js +80 -0
  29. package/dist/components/emptyState/EmptyState.test.js.map +1 -0
  30. package/dist/components/favourite/FavouriteButton.d.ts +18 -0
  31. package/dist/components/favourite/FavouriteButton.d.ts.map +1 -0
  32. package/dist/components/favourite/FavouriteButton.js +16 -0
  33. package/dist/components/favourite/FavouriteButton.js.map +1 -0
  34. package/dist/components/favourite/FavouriteButton.test.d.ts +2 -0
  35. package/dist/components/favourite/FavouriteButton.test.d.ts.map +1 -0
  36. package/dist/components/favourite/FavouriteButton.test.js +37 -0
  37. package/dist/components/favourite/FavouriteButton.test.js.map +1 -0
  38. package/dist/components/filterBar/FilterBar.d.ts +1 -1
  39. package/dist/components/filterBar/FilterBar.stories.d.ts +1 -1
  40. package/dist/components/icon/Icon.d.ts +1 -1
  41. package/dist/components/icon/Icon.d.ts.map +1 -1
  42. package/dist/components/icon/Icon.js +1 -1
  43. package/dist/components/icon/Icon.js.map +1 -1
  44. package/dist/components/pill/Pill.d.ts +3 -2
  45. package/dist/components/pill/Pill.d.ts.map +1 -1
  46. package/dist/components/pill/Pill.js +15 -9
  47. package/dist/components/pill/Pill.js.map +1 -1
  48. package/dist/components/pill/Pill.stories.d.ts +21 -3
  49. package/dist/components/pill/Pill.stories.d.ts.map +1 -1
  50. package/dist/components/pill/Pill.stories.js +275 -40
  51. package/dist/components/pill/Pill.stories.js.map +1 -1
  52. package/dist/components/pill/Pill.test.js +64 -3
  53. package/dist/components/pill/Pill.test.js.map +1 -1
  54. package/dist/components/sideNavigation/SideNavigation.d.ts +34 -0
  55. package/dist/components/sideNavigation/SideNavigation.d.ts.map +1 -0
  56. package/dist/components/sideNavigation/SideNavigation.js +30 -0
  57. package/dist/components/sideNavigation/SideNavigation.js.map +1 -0
  58. package/dist/components/sideNavigation/SideNavigation.stories.d.ts +72 -0
  59. package/dist/components/sideNavigation/SideNavigation.stories.d.ts.map +1 -0
  60. package/dist/components/sideNavigation/SideNavigation.stories.js +298 -0
  61. package/dist/components/sideNavigation/SideNavigation.stories.js.map +1 -0
  62. package/dist/components/sideNavigation/SideNavigation.test.d.ts +2 -0
  63. package/dist/components/sideNavigation/SideNavigation.test.d.ts.map +1 -0
  64. package/dist/components/sideNavigation/SideNavigation.test.js +74 -0
  65. package/dist/components/sideNavigation/SideNavigation.test.js.map +1 -0
  66. package/dist/components/sideNavigation/SideNavigationContext.d.ts +10 -0
  67. package/dist/components/sideNavigation/SideNavigationContext.d.ts.map +1 -0
  68. package/dist/components/sideNavigation/SideNavigationContext.js +15 -0
  69. package/dist/components/sideNavigation/SideNavigationContext.js.map +1 -0
  70. package/dist/components/{sidebarNav/SidebarNavGroup.d.ts → sideNavigation/SideNavigationGroup.d.ts} +3 -3
  71. package/dist/components/sideNavigation/SideNavigationGroup.d.ts.map +1 -0
  72. package/dist/components/sideNavigation/SideNavigationGroup.js +16 -0
  73. package/dist/components/sideNavigation/SideNavigationGroup.js.map +1 -0
  74. package/dist/components/sideNavigation/SideNavigationGroup.test.d.ts +2 -0
  75. package/dist/components/sideNavigation/SideNavigationGroup.test.d.ts.map +1 -0
  76. package/dist/components/sideNavigation/SideNavigationGroup.test.js +58 -0
  77. package/dist/components/sideNavigation/SideNavigationGroup.test.js.map +1 -0
  78. package/dist/components/{sidebarNav/SidebarNavItem.d.ts → sideNavigation/SideNavigationItem.d.ts} +11 -12
  79. package/dist/components/sideNavigation/SideNavigationItem.d.ts.map +1 -0
  80. package/dist/components/sideNavigation/SideNavigationItem.js +28 -0
  81. package/dist/components/sideNavigation/SideNavigationItem.js.map +1 -0
  82. package/dist/components/sideNavigation/SideNavigationItem.test.d.ts +2 -0
  83. package/dist/components/sideNavigation/SideNavigationItem.test.d.ts.map +1 -0
  84. package/dist/components/sideNavigation/SideNavigationItem.test.js +65 -0
  85. package/dist/components/sideNavigation/SideNavigationItem.test.js.map +1 -0
  86. package/dist/components/sideNavigation/SideNavigationItemFavourite.d.ts +8 -0
  87. package/dist/components/sideNavigation/SideNavigationItemFavourite.d.ts.map +1 -0
  88. package/dist/components/{sidebarNav/SidebarNavItemFavourite.js → sideNavigation/SideNavigationItemFavourite.js} +5 -5
  89. package/dist/components/sideNavigation/SideNavigationItemFavourite.js.map +1 -0
  90. package/dist/components/sideNavigation/SideNavigationItemFavourite.test.d.ts +2 -0
  91. package/dist/components/sideNavigation/SideNavigationItemFavourite.test.d.ts.map +1 -0
  92. package/dist/components/sideNavigation/SideNavigationItemFavourite.test.js +31 -0
  93. package/dist/components/sideNavigation/SideNavigationItemFavourite.test.js.map +1 -0
  94. package/dist/components/sideNavigation/SideNavigationTitle.d.ts +4 -0
  95. package/dist/components/sideNavigation/SideNavigationTitle.d.ts.map +1 -0
  96. package/dist/components/sideNavigation/SideNavigationTitle.js +7 -0
  97. package/dist/components/sideNavigation/SideNavigationTitle.js.map +1 -0
  98. package/dist/components/sideNavigation/SideNavigationTitle.test.d.ts +2 -0
  99. package/dist/components/sideNavigation/SideNavigationTitle.test.d.ts.map +1 -0
  100. package/dist/components/sideNavigation/SideNavigationTitle.test.js +22 -0
  101. package/dist/components/sideNavigation/SideNavigationTitle.test.js.map +1 -0
  102. package/dist/components/sideNavigation/SideNavigationTooltip.d.ts +7 -0
  103. package/dist/components/sideNavigation/SideNavigationTooltip.d.ts.map +1 -0
  104. package/dist/components/{sidebarNav/SidebarNavTooltip.js → sideNavigation/SideNavigationTooltip.js} +2 -2
  105. package/dist/components/sideNavigation/SideNavigationTooltip.js.map +1 -0
  106. package/dist/components/sideNavigation/SideNavigationTooltip.test.d.ts +2 -0
  107. package/dist/components/sideNavigation/SideNavigationTooltip.test.d.ts.map +1 -0
  108. package/dist/components/sideNavigation/SideNavigationTooltip.test.js +26 -0
  109. package/dist/components/sideNavigation/SideNavigationTooltip.test.js.map +1 -0
  110. package/dist/components/sideNavigation/resolvePanelItemProps.d.ts +4 -0
  111. package/dist/components/sideNavigation/resolvePanelItemProps.d.ts.map +1 -0
  112. package/dist/components/{sidebarNav → sideNavigation}/resolvePanelItemProps.js +5 -4
  113. package/dist/components/sideNavigation/resolvePanelItemProps.js.map +1 -0
  114. package/dist/components/sideNavigation/resolvePanelItemProps.test.d.ts.map +1 -0
  115. package/dist/components/{sidebarNav → sideNavigation}/resolvePanelItemProps.test.js +18 -4
  116. package/dist/components/sideNavigation/resolvePanelItemProps.test.js.map +1 -0
  117. package/dist/components/sideNavigation/types.d.ts +47 -0
  118. package/dist/components/sideNavigation/types.d.ts.map +1 -0
  119. package/dist/components/sideNavigation/types.js +2 -0
  120. package/dist/components/sideNavigation/types.js.map +1 -0
  121. package/dist/components/sidebar/Sidebar.d.ts +13 -0
  122. package/dist/components/sidebar/Sidebar.d.ts.map +1 -0
  123. package/dist/components/sidebar/Sidebar.js +9 -0
  124. package/dist/components/sidebar/Sidebar.js.map +1 -0
  125. package/dist/components/sidebar/Sidebar.stories.d.ts +48 -0
  126. package/dist/components/sidebar/Sidebar.stories.d.ts.map +1 -0
  127. package/dist/components/sidebar/Sidebar.stories.js +444 -0
  128. package/dist/components/sidebar/Sidebar.stories.js.map +1 -0
  129. package/dist/components/sidebar/Sidebar.test.d.ts +2 -0
  130. package/dist/components/sidebar/Sidebar.test.d.ts.map +1 -0
  131. package/dist/components/sidebar/Sidebar.test.js +81 -0
  132. package/dist/components/sidebar/Sidebar.test.js.map +1 -0
  133. package/dist/components/sidebar/SidebarItem.d.ts +7 -0
  134. package/dist/components/sidebar/SidebarItem.d.ts.map +1 -0
  135. package/dist/components/sidebar/SidebarItem.js +11 -0
  136. package/dist/components/sidebar/SidebarItem.js.map +1 -0
  137. package/dist/components/singleUser/SingleUser.d.ts +1 -1
  138. package/dist/components/tabs/TabsItem.stories.d.ts +2 -2
  139. package/dist/components/toast/Toast.d.ts +11 -2
  140. package/dist/components/toast/Toast.d.ts.map +1 -1
  141. package/dist/components/toast/Toast.js +5 -3
  142. package/dist/components/toast/Toast.js.map +1 -1
  143. package/dist/components/toast/Toast.stories.d.ts +15 -3
  144. package/dist/components/toast/Toast.stories.d.ts.map +1 -1
  145. package/dist/components/toast/Toast.stories.js +43 -41
  146. package/dist/components/toast/Toast.stories.js.map +1 -1
  147. package/dist/components/toast/Toast.test.js +19 -4
  148. package/dist/components/toast/Toast.test.js.map +1 -1
  149. package/dist/components/toast/ToastAction.d.ts +7 -0
  150. package/dist/components/toast/ToastAction.d.ts.map +1 -0
  151. package/dist/components/toast/ToastAction.js +9 -0
  152. package/dist/components/toast/ToastAction.js.map +1 -0
  153. package/dist/components/tooltip/TooltipWrapper.d.ts +1 -0
  154. package/dist/components/tooltip/TooltipWrapper.d.ts.map +1 -1
  155. package/dist/components/tooltip/TooltipWrapper.js +2 -2
  156. package/dist/components/tooltip/TooltipWrapper.js.map +1 -1
  157. package/dist/components/widget/Widget.d.ts +18 -0
  158. package/dist/components/widget/Widget.d.ts.map +1 -0
  159. package/dist/components/widget/Widget.js +51 -0
  160. package/dist/components/widget/Widget.js.map +1 -0
  161. package/dist/components/widget/Widget.stories.d.ts +128 -0
  162. package/dist/components/widget/Widget.stories.d.ts.map +1 -0
  163. package/dist/components/widget/Widget.stories.js +417 -0
  164. package/dist/components/widget/Widget.stories.js.map +1 -0
  165. package/dist/components/widget/Widget.test.d.ts +2 -0
  166. package/dist/components/widget/Widget.test.d.ts.map +1 -0
  167. package/dist/components/widget/Widget.test.js +110 -0
  168. package/dist/components/widget/Widget.test.js.map +1 -0
  169. package/dist/components/widget/WidgetBody.d.ts +6 -0
  170. package/dist/components/widget/WidgetBody.d.ts.map +1 -0
  171. package/dist/components/widget/WidgetBody.js +20 -0
  172. package/dist/components/widget/WidgetBody.js.map +1 -0
  173. package/dist/components/widget/WidgetContext.d.ts +20 -0
  174. package/dist/components/widget/WidgetContext.d.ts.map +1 -0
  175. package/dist/components/widget/WidgetContext.js +10 -0
  176. package/dist/components/widget/WidgetContext.js.map +1 -0
  177. package/dist/components/widget/WidgetHeader.d.ts +8 -0
  178. package/dist/components/widget/WidgetHeader.d.ts.map +1 -0
  179. package/dist/components/widget/WidgetHeader.js +56 -0
  180. package/dist/components/widget/WidgetHeader.js.map +1 -0
  181. package/dist/components/widget/types.d.ts +43 -0
  182. package/dist/components/widget/types.d.ts.map +1 -0
  183. package/dist/components/widget/types.js +2 -0
  184. package/dist/components/widget/types.js.map +1 -0
  185. package/dist/components/widgetCalendar/WidgetCalendar.d.ts +35 -0
  186. package/dist/components/widgetCalendar/WidgetCalendar.d.ts.map +1 -0
  187. package/dist/components/widgetCalendar/WidgetCalendar.js +22 -0
  188. package/dist/components/widgetCalendar/WidgetCalendar.js.map +1 -0
  189. package/dist/components/widgetCalendar/WidgetCalendar.stories.d.ts +60 -0
  190. package/dist/components/widgetCalendar/WidgetCalendar.stories.d.ts.map +1 -0
  191. package/dist/components/widgetCalendar/WidgetCalendar.stories.js +140 -0
  192. package/dist/components/widgetCalendar/WidgetCalendar.stories.js.map +1 -0
  193. package/dist/components/widgetCalendar/WidgetCalendar.test.d.ts +2 -0
  194. package/dist/components/widgetCalendar/WidgetCalendar.test.d.ts.map +1 -0
  195. package/dist/components/widgetCalendar/WidgetCalendar.test.js +88 -0
  196. package/dist/components/widgetCalendar/WidgetCalendar.test.js.map +1 -0
  197. package/dist/components/widgetCalendar/WidgetCalendarItem.d.ts +17 -0
  198. package/dist/components/widgetCalendar/WidgetCalendarItem.d.ts.map +1 -0
  199. package/dist/components/widgetCalendar/WidgetCalendarItem.js +25 -0
  200. package/dist/components/widgetCalendar/WidgetCalendarItem.js.map +1 -0
  201. package/dist/components/widgetFavourites/WidgetFavourites.d.ts +12 -0
  202. package/dist/components/widgetFavourites/WidgetFavourites.d.ts.map +1 -0
  203. package/dist/components/widgetFavourites/WidgetFavourites.js +23 -0
  204. package/dist/components/widgetFavourites/WidgetFavourites.js.map +1 -0
  205. package/dist/components/widgetFavourites/WidgetFavourites.stories.d.ts +84 -0
  206. package/dist/components/widgetFavourites/WidgetFavourites.stories.d.ts.map +1 -0
  207. package/dist/components/widgetFavourites/WidgetFavourites.stories.js +210 -0
  208. package/dist/components/widgetFavourites/WidgetFavourites.stories.js.map +1 -0
  209. package/dist/components/widgetFavourites/WidgetFavourites.test.d.ts +2 -0
  210. package/dist/components/widgetFavourites/WidgetFavourites.test.d.ts.map +1 -0
  211. package/dist/components/widgetFavourites/WidgetFavourites.test.js +67 -0
  212. package/dist/components/widgetFavourites/WidgetFavourites.test.js.map +1 -0
  213. package/dist/components/widgetFavourites/WidgetFavouritesItem.d.ts +3 -0
  214. package/dist/components/widgetFavourites/WidgetFavouritesItem.d.ts.map +1 -0
  215. package/dist/components/widgetFavourites/WidgetFavouritesItem.js +10 -0
  216. package/dist/components/widgetFavourites/WidgetFavouritesItem.js.map +1 -0
  217. package/dist/components/widgetFavourites/types.d.ts +25 -0
  218. package/dist/components/widgetFavourites/types.d.ts.map +1 -0
  219. package/dist/components/widgetFavourites/types.js +2 -0
  220. package/dist/components/widgetFavourites/types.js.map +1 -0
  221. package/dist/components/widgetNotifications/WidgetNotifications.d.ts +33 -0
  222. package/dist/components/widgetNotifications/WidgetNotifications.d.ts.map +1 -0
  223. package/dist/components/widgetNotifications/WidgetNotifications.js +18 -0
  224. package/dist/components/widgetNotifications/WidgetNotifications.js.map +1 -0
  225. package/dist/components/widgetNotifications/WidgetNotifications.stories.d.ts +60 -0
  226. package/dist/components/widgetNotifications/WidgetNotifications.stories.d.ts.map +1 -0
  227. package/dist/components/widgetNotifications/WidgetNotifications.stories.js +269 -0
  228. package/dist/components/widgetNotifications/WidgetNotifications.stories.js.map +1 -0
  229. package/dist/components/widgetNotifications/WidgetNotifications.test.d.ts +2 -0
  230. package/dist/components/widgetNotifications/WidgetNotifications.test.d.ts.map +1 -0
  231. package/dist/components/widgetNotifications/WidgetNotifications.test.js +79 -0
  232. package/dist/components/widgetNotifications/WidgetNotifications.test.js.map +1 -0
  233. package/dist/components/widgetNotifications/WidgetNotificationsItem.d.ts +14 -0
  234. package/dist/components/widgetNotifications/WidgetNotificationsItem.d.ts.map +1 -0
  235. package/dist/components/widgetNotifications/WidgetNotificationsItem.js +14 -0
  236. package/dist/components/widgetNotifications/WidgetNotificationsItem.js.map +1 -0
  237. package/dist/index.css +850 -205
  238. package/dist/index.css.map +1 -1
  239. package/dist/index.d.ts +15 -9
  240. package/dist/index.d.ts.map +1 -1
  241. package/dist/index.js +15 -8
  242. package/dist/index.js.map +1 -1
  243. package/dist/utils/favourites/favouriteConstants.d.ts +12 -0
  244. package/dist/utils/favourites/favouriteConstants.d.ts.map +1 -0
  245. package/dist/utils/favourites/favouriteConstants.js +16 -0
  246. package/dist/utils/favourites/favouriteConstants.js.map +1 -0
  247. package/dist/utils/favourites/favouriteConstants.test.d.ts +2 -0
  248. package/dist/utils/favourites/favouriteConstants.test.d.ts.map +1 -0
  249. package/dist/utils/favourites/favouriteConstants.test.js +12 -0
  250. package/dist/utils/favourites/favouriteConstants.test.js.map +1 -0
  251. package/dist/utils/hooks/useControllableBoolean.d.ts.map +1 -0
  252. package/dist/utils/hooks/useControllableBoolean.js.map +1 -0
  253. package/dist/utils/hooks/useControllableBoolean.test.d.ts +2 -0
  254. package/dist/utils/hooks/useControllableBoolean.test.d.ts.map +1 -0
  255. package/dist/utils/hooks/useControllableBoolean.test.js +34 -0
  256. package/dist/utils/hooks/useControllableBoolean.test.js.map +1 -0
  257. package/package.json +1 -1
  258. package/src/components/datePicker/DatePicker.tsx +30 -35
  259. package/src/components/datePicker/DatePickerCalendar.tsx +46 -0
  260. package/src/components/dateTimePicker/DateTimePicker.tsx +66 -38
  261. package/src/components/dateTimePicker/dateTimePicker.scss +0 -2
  262. package/src/components/emptyState/EmptyState.stories.tsx +487 -0
  263. package/src/components/emptyState/EmptyState.test.tsx +140 -0
  264. package/src/components/emptyState/EmptyState.tsx +84 -0
  265. package/src/components/emptyState/emptyState.scss +63 -0
  266. package/src/components/favourite/FavouriteButton.test.tsx +83 -0
  267. package/src/components/favourite/FavouriteButton.tsx +70 -0
  268. package/src/components/favourite/favouriteButton.scss +37 -0
  269. package/src/components/icon/Icon.tsx +2 -2
  270. package/src/components/link/link.scss +26 -0
  271. package/src/components/pill/Pill.stories.tsx +432 -41
  272. package/src/components/pill/Pill.test.tsx +74 -3
  273. package/src/components/pill/Pill.tsx +26 -11
  274. package/src/components/sideNavigation/SideNavigation.stories.tsx +578 -0
  275. package/src/components/sideNavigation/SideNavigation.test.tsx +109 -0
  276. package/src/components/sideNavigation/SideNavigation.tsx +98 -0
  277. package/src/components/sideNavigation/SideNavigationContext.tsx +25 -0
  278. package/src/components/sideNavigation/SideNavigationGroup.test.tsx +103 -0
  279. package/src/components/{sidebarNav/SidebarNavGroup.tsx → sideNavigation/SideNavigationGroup.tsx} +8 -8
  280. package/src/components/sideNavigation/SideNavigationItem.test.tsx +137 -0
  281. package/src/components/sideNavigation/SideNavigationItem.tsx +125 -0
  282. package/src/components/sideNavigation/SideNavigationItemFavourite.test.tsx +54 -0
  283. package/src/components/{sidebarNav/SidebarNavItemFavourite.tsx → sideNavigation/SideNavigationItemFavourite.tsx} +7 -7
  284. package/src/components/sideNavigation/SideNavigationTitle.test.tsx +23 -0
  285. package/src/components/sideNavigation/SideNavigationTitle.tsx +13 -0
  286. package/src/components/sideNavigation/SideNavigationTooltip.test.tsx +44 -0
  287. package/src/components/{sidebarNav/SidebarNavTooltip.tsx → sideNavigation/SideNavigationTooltip.tsx} +2 -2
  288. package/src/components/{sidebarNav → sideNavigation}/resolvePanelItemProps.test.ts +20 -4
  289. package/src/components/{sidebarNav → sideNavigation}/resolvePanelItemProps.ts +8 -7
  290. package/src/components/{sidebarNav/sidebarNav.scss → sideNavigation/sideNavigation.scss} +37 -136
  291. package/src/components/sideNavigation/types.ts +56 -0
  292. package/src/components/sidebar/Sidebar.stories.tsx +670 -0
  293. package/src/components/sidebar/Sidebar.test.tsx +155 -0
  294. package/src/components/sidebar/Sidebar.tsx +27 -0
  295. package/src/components/sidebar/SidebarItem.tsx +64 -0
  296. package/src/components/sidebar/sidebar.scss +65 -0
  297. package/src/components/toast/Toast.stories.tsx +75 -67
  298. package/src/components/toast/Toast.test.tsx +40 -10
  299. package/src/components/toast/Toast.tsx +19 -5
  300. package/src/components/toast/ToastAction.tsx +17 -0
  301. package/src/components/toast/toast.scss +37 -0
  302. package/src/components/tooltip/TooltipWrapper.tsx +3 -1
  303. package/src/components/widget/Widget.stories.tsx +600 -0
  304. package/src/components/widget/Widget.test.tsx +263 -0
  305. package/src/components/widget/Widget.tsx +102 -0
  306. package/src/components/widget/WidgetBody.tsx +66 -0
  307. package/src/components/widget/WidgetContext.tsx +31 -0
  308. package/src/components/widget/WidgetHeader.tsx +155 -0
  309. package/src/components/widget/types.ts +47 -0
  310. package/src/components/widget/widget.scss +218 -0
  311. package/src/components/widgetCalendar/WidgetCalendar.stories.tsx +241 -0
  312. package/src/components/widgetCalendar/WidgetCalendar.test.tsx +137 -0
  313. package/src/components/widgetCalendar/WidgetCalendar.tsx +105 -0
  314. package/src/components/widgetCalendar/WidgetCalendarItem.tsx +105 -0
  315. package/src/components/widgetCalendar/widgetCalendar.scss +124 -0
  316. package/src/components/widgetFavourites/WidgetFavourites.stories.tsx +341 -0
  317. package/src/components/widgetFavourites/WidgetFavourites.test.tsx +127 -0
  318. package/src/components/widgetFavourites/WidgetFavourites.tsx +83 -0
  319. package/src/components/widgetFavourites/WidgetFavouritesItem.tsx +37 -0
  320. package/src/components/widgetFavourites/types.ts +26 -0
  321. package/src/components/widgetFavourites/widgetFavourites.scss +84 -0
  322. package/src/components/widgetNotifications/WidgetNotifications.stories.tsx +417 -0
  323. package/src/components/widgetNotifications/WidgetNotifications.test.tsx +152 -0
  324. package/src/components/widgetNotifications/WidgetNotifications.tsx +112 -0
  325. package/src/components/widgetNotifications/WidgetNotificationsItem.tsx +88 -0
  326. package/src/components/widgetNotifications/widgetNotifications.scss +186 -0
  327. package/src/docs/Contributing.mdx +1 -1
  328. package/src/index.scss +9 -1
  329. package/src/index.ts +22 -18
  330. package/src/tokens.scss +12 -2
  331. package/src/utils/favourites/favouriteConstants.test.ts +19 -0
  332. package/src/utils/favourites/favouriteConstants.ts +21 -0
  333. package/src/utils/hooks/useControllableBoolean.test.ts +48 -0
  334. package/dist/components/sidebarNav/SidebarNav.d.ts +0 -46
  335. package/dist/components/sidebarNav/SidebarNav.d.ts.map +0 -1
  336. package/dist/components/sidebarNav/SidebarNav.js +0 -102
  337. package/dist/components/sidebarNav/SidebarNav.js.map +0 -1
  338. package/dist/components/sidebarNav/SidebarNav.stories.d.ts +0 -61
  339. package/dist/components/sidebarNav/SidebarNav.stories.d.ts.map +0 -1
  340. package/dist/components/sidebarNav/SidebarNav.stories.js +0 -253
  341. package/dist/components/sidebarNav/SidebarNav.stories.js.map +0 -1
  342. package/dist/components/sidebarNav/SidebarNav.test.d.ts +0 -2
  343. package/dist/components/sidebarNav/SidebarNav.test.d.ts.map +0 -1
  344. package/dist/components/sidebarNav/SidebarNav.test.js +0 -240
  345. package/dist/components/sidebarNav/SidebarNav.test.js.map +0 -1
  346. package/dist/components/sidebarNav/SidebarNavContext.d.ts +0 -13
  347. package/dist/components/sidebarNav/SidebarNavContext.d.ts.map +0 -1
  348. package/dist/components/sidebarNav/SidebarNavContext.js +0 -15
  349. package/dist/components/sidebarNav/SidebarNavContext.js.map +0 -1
  350. package/dist/components/sidebarNav/SidebarNavGroup.d.ts.map +0 -1
  351. package/dist/components/sidebarNav/SidebarNavGroup.js +0 -16
  352. package/dist/components/sidebarNav/SidebarNavGroup.js.map +0 -1
  353. package/dist/components/sidebarNav/SidebarNavItem.d.ts.map +0 -1
  354. package/dist/components/sidebarNav/SidebarNavItem.js +0 -44
  355. package/dist/components/sidebarNav/SidebarNavItem.js.map +0 -1
  356. package/dist/components/sidebarNav/SidebarNavItemFavourite.d.ts +0 -8
  357. package/dist/components/sidebarNav/SidebarNavItemFavourite.d.ts.map +0 -1
  358. package/dist/components/sidebarNav/SidebarNavItemFavourite.js.map +0 -1
  359. package/dist/components/sidebarNav/SidebarNavPanel.d.ts +0 -4
  360. package/dist/components/sidebarNav/SidebarNavPanel.d.ts.map +0 -1
  361. package/dist/components/sidebarNav/SidebarNavPanel.js +0 -9
  362. package/dist/components/sidebarNav/SidebarNavPanel.js.map +0 -1
  363. package/dist/components/sidebarNav/SidebarNavPanelNav.d.ts +0 -10
  364. package/dist/components/sidebarNav/SidebarNavPanelNav.d.ts.map +0 -1
  365. package/dist/components/sidebarNav/SidebarNavPanelNav.js +0 -21
  366. package/dist/components/sidebarNav/SidebarNavPanelNav.js.map +0 -1
  367. package/dist/components/sidebarNav/SidebarNavRail.d.ts +0 -6
  368. package/dist/components/sidebarNav/SidebarNavRail.d.ts.map +0 -1
  369. package/dist/components/sidebarNav/SidebarNavRail.js +0 -7
  370. package/dist/components/sidebarNav/SidebarNavRail.js.map +0 -1
  371. package/dist/components/sidebarNav/SidebarNavRailItem.d.ts +0 -10
  372. package/dist/components/sidebarNav/SidebarNavRailItem.d.ts.map +0 -1
  373. package/dist/components/sidebarNav/SidebarNavRailItem.js +0 -25
  374. package/dist/components/sidebarNav/SidebarNavRailItem.js.map +0 -1
  375. package/dist/components/sidebarNav/SidebarNavRailList.d.ts +0 -4
  376. package/dist/components/sidebarNav/SidebarNavRailList.d.ts.map +0 -1
  377. package/dist/components/sidebarNav/SidebarNavRailList.js +0 -7
  378. package/dist/components/sidebarNav/SidebarNavRailList.js.map +0 -1
  379. package/dist/components/sidebarNav/SidebarNavRailSlot.d.ts +0 -6
  380. package/dist/components/sidebarNav/SidebarNavRailSlot.d.ts.map +0 -1
  381. package/dist/components/sidebarNav/SidebarNavRailSlot.js +0 -7
  382. package/dist/components/sidebarNav/SidebarNavRailSlot.js.map +0 -1
  383. package/dist/components/sidebarNav/SidebarNavSeparator.d.ts +0 -6
  384. package/dist/components/sidebarNav/SidebarNavSeparator.d.ts.map +0 -1
  385. package/dist/components/sidebarNav/SidebarNavSeparator.js +0 -8
  386. package/dist/components/sidebarNav/SidebarNavSeparator.js.map +0 -1
  387. package/dist/components/sidebarNav/SidebarNavTitle.d.ts +0 -4
  388. package/dist/components/sidebarNav/SidebarNavTitle.d.ts.map +0 -1
  389. package/dist/components/sidebarNav/SidebarNavTitle.js +0 -7
  390. package/dist/components/sidebarNav/SidebarNavTitle.js.map +0 -1
  391. package/dist/components/sidebarNav/SidebarNavTooltip.d.ts +0 -7
  392. package/dist/components/sidebarNav/SidebarNavTooltip.d.ts.map +0 -1
  393. package/dist/components/sidebarNav/SidebarNavTooltip.js.map +0 -1
  394. package/dist/components/sidebarNav/SidebarNavTrigger.d.ts +0 -8
  395. package/dist/components/sidebarNav/SidebarNavTrigger.d.ts.map +0 -1
  396. package/dist/components/sidebarNav/SidebarNavTrigger.js +0 -15
  397. package/dist/components/sidebarNav/SidebarNavTrigger.js.map +0 -1
  398. package/dist/components/sidebarNav/index.d.ts +0 -4
  399. package/dist/components/sidebarNav/index.d.ts.map +0 -1
  400. package/dist/components/sidebarNav/index.js +0 -3
  401. package/dist/components/sidebarNav/index.js.map +0 -1
  402. package/dist/components/sidebarNav/resolvePanelItemProps.d.ts +0 -4
  403. package/dist/components/sidebarNav/resolvePanelItemProps.d.ts.map +0 -1
  404. package/dist/components/sidebarNav/resolvePanelItemProps.js.map +0 -1
  405. package/dist/components/sidebarNav/resolvePanelItemProps.test.d.ts.map +0 -1
  406. package/dist/components/sidebarNav/resolvePanelItemProps.test.js.map +0 -1
  407. package/dist/components/sidebarNav/types.d.ts +0 -100
  408. package/dist/components/sidebarNav/types.d.ts.map +0 -1
  409. package/dist/components/sidebarNav/types.js +0 -4
  410. package/dist/components/sidebarNav/types.js.map +0 -1
  411. package/dist/components/sidebarNav/useControllableBoolean.d.ts.map +0 -1
  412. package/dist/components/sidebarNav/useControllableBoolean.js.map +0 -1
  413. package/src/components/sidebarNav/SidebarNav.stories.tsx +0 -484
  414. package/src/components/sidebarNav/SidebarNav.test.tsx +0 -611
  415. package/src/components/sidebarNav/SidebarNav.tsx +0 -230
  416. package/src/components/sidebarNav/SidebarNavContext.tsx +0 -28
  417. package/src/components/sidebarNav/SidebarNavItem.tsx +0 -162
  418. package/src/components/sidebarNav/SidebarNavPanel.tsx +0 -20
  419. package/src/components/sidebarNav/SidebarNavPanelNav.tsx +0 -55
  420. package/src/components/sidebarNav/SidebarNavRail.tsx +0 -20
  421. package/src/components/sidebarNav/SidebarNavRailItem.tsx +0 -83
  422. package/src/components/sidebarNav/SidebarNavRailList.tsx +0 -11
  423. package/src/components/sidebarNav/SidebarNavRailSlot.tsx +0 -15
  424. package/src/components/sidebarNav/SidebarNavSeparator.tsx +0 -19
  425. package/src/components/sidebarNav/SidebarNavTitle.tsx +0 -13
  426. package/src/components/sidebarNav/SidebarNavTrigger.tsx +0 -52
  427. package/src/components/sidebarNav/index.ts +0 -6
  428. package/src/components/sidebarNav/types.ts +0 -126
  429. /package/dist/components/{sidebarNav → sideNavigation}/resolvePanelItemProps.test.d.ts +0 -0
  430. /package/dist/{components/sidebarNav → utils/hooks}/useControllableBoolean.d.ts +0 -0
  431. /package/dist/{components/sidebarNav → utils/hooks}/useControllableBoolean.js +0 -0
  432. /package/src/{components/sidebarNav → utils/hooks}/useControllableBoolean.ts +0 -0
@@ -0,0 +1,152 @@
1
+ import '@testing-library/jest-dom/vitest';
2
+ import { fireEvent, render, screen } from '@testing-library/react';
3
+ import userEvent from '@testing-library/user-event';
4
+ import { describe, expect, test, vi } from 'vitest';
5
+ import { WidgetNotifications } from './WidgetNotifications.js';
6
+
7
+ const mockItems = [
8
+ {
9
+ id: 'email-complete',
10
+ title: 'Sending email message is complete',
11
+ description: 'Click here to see the message and check delivery status.',
12
+ dateTime: '2026-06-08T10:54:00Z',
13
+ timeLabel: '6 minutes ago',
14
+ isRead: false,
15
+ },
16
+ {
17
+ id: 'sms-failed',
18
+ title: 'SMS failed to be sent',
19
+ description: 'The SMS to Tim Jones failed to be sent',
20
+ dateTime: '2026-06-08T09:30:00Z',
21
+ timeLabel: '1 hour ago',
22
+ isRead: true,
23
+ },
24
+ ];
25
+
26
+ describe('WidgetNotifications', () => {
27
+ test('renders notification items with title, description, and time', () => {
28
+ render(
29
+ <WidgetNotifications heading="Notifications" items={mockItems} />,
30
+ );
31
+
32
+ expect(screen.getByRole('heading', { name: 'Notifications' })).toBeInTheDocument();
33
+ expect(screen.getByText('Sending email message is complete')).toBeInTheDocument();
34
+ expect(screen.getByText('Click here to see the message and check delivery status.')).toBeInTheDocument();
35
+ expect(screen.getByText('6 minutes ago')).toBeInTheDocument();
36
+ expect(screen.getByText('6 minutes ago').closest('time')).toHaveAttribute('datetime', '2026-06-08T10:54:00Z');
37
+ });
38
+
39
+ test('applies unread and read modifier classes', () => {
40
+ const { container } = render(
41
+ <WidgetNotifications heading="Notifications" items={mockItems} />,
42
+ );
43
+
44
+ expect(container.querySelector('.ds-widget-notifications__item--unread')).toBeInTheDocument();
45
+ expect(container.querySelector('.ds-widget-notifications__item--read')).toBeInTheDocument();
46
+ });
47
+
48
+ test('calls onItemClick with item id', async () => {
49
+ const user = userEvent.setup();
50
+ const onItemClick = vi.fn();
51
+
52
+ render(
53
+ <WidgetNotifications
54
+ heading="Notifications"
55
+ items={mockItems}
56
+ onItemClick={onItemClick}
57
+ />,
58
+ );
59
+
60
+ await user.click(screen.getByRole('button', { name: /Sending email message is complete/ }));
61
+
62
+ expect(onItemClick).toHaveBeenCalledWith('email-complete');
63
+ });
64
+
65
+ test('clear button has accessible name', () => {
66
+ render(
67
+ <WidgetNotifications
68
+ heading="Notifications"
69
+ items={mockItems}
70
+ onClearItem={vi.fn()}
71
+ />,
72
+ );
73
+
74
+ expect(screen.getByTestId('widget-notifications-clear-email-complete')).toHaveAttribute(
75
+ 'aria-label',
76
+ 'Clear notification',
77
+ );
78
+ });
79
+
80
+ test('calls onClearItem without triggering onItemClick', () => {
81
+ const onItemClick = vi.fn();
82
+ const onClearItem = vi.fn();
83
+
84
+ render(
85
+ <WidgetNotifications
86
+ heading="Notifications"
87
+ items={mockItems}
88
+ onItemClick={onItemClick}
89
+ onClearItem={onClearItem}
90
+ />,
91
+ );
92
+
93
+ fireEvent.click(screen.getByTestId('widget-notifications-clear-email-complete'));
94
+
95
+ expect(onClearItem).toHaveBeenCalledWith('email-complete');
96
+ expect(onItemClick).not.toHaveBeenCalled();
97
+ });
98
+
99
+ test('calls onMarkAllAsRead from header action when unread items exist', async () => {
100
+ const user = userEvent.setup();
101
+ const onMarkAllAsRead = vi.fn();
102
+
103
+ render(
104
+ <WidgetNotifications
105
+ heading="Notifications"
106
+ items={mockItems}
107
+ onMarkAllAsRead={onMarkAllAsRead}
108
+ />,
109
+ );
110
+
111
+ await user.click(screen.getByRole('button', { name: 'Mark all as read' }));
112
+
113
+ expect(onMarkAllAsRead).toHaveBeenCalledTimes(1);
114
+ });
115
+
116
+ test('hides mark all as read when all items are read', () => {
117
+ render(
118
+ <WidgetNotifications
119
+ heading="Notifications"
120
+ items={mockItems.map(item => ({ ...item, isRead: true }))}
121
+ onMarkAllAsRead={vi.fn()}
122
+ />,
123
+ );
124
+
125
+ expect(screen.queryByRole('button', { name: 'Mark all as read' })).not.toBeInTheDocument();
126
+ });
127
+
128
+ test('hides mark all as read when items is empty', () => {
129
+ render(
130
+ <WidgetNotifications
131
+ heading="Notifications"
132
+ items={[]}
133
+ onMarkAllAsRead={vi.fn()}
134
+ />,
135
+ );
136
+
137
+ expect(screen.queryByRole('button', { name: 'Mark all as read' })).not.toBeInTheDocument();
138
+ expect(screen.getByRole('heading', { name: 'No notifications' })).toBeInTheDocument();
139
+ });
140
+
141
+ test('renders custom empty state', () => {
142
+ render(
143
+ <WidgetNotifications
144
+ heading="Notifications"
145
+ items={[]}
146
+ emptyState={<p>Custom empty</p>}
147
+ />,
148
+ );
149
+
150
+ expect(screen.getByText('Custom empty')).toBeInTheDocument();
151
+ });
152
+ });
@@ -0,0 +1,112 @@
1
+ import { Button } from 'Components/button/Button';
2
+ import { EmptyState } from 'Components/emptyState/EmptyState';
3
+ import { Icon } from 'Components/icon/Icon';
4
+ import { Widget } from 'Components/widget/Widget';
5
+ import type { WidgetNotificationsItemProps } from './WidgetNotificationsItem.js';
6
+ import { WidgetNotificationsItem } from './WidgetNotificationsItem.js';
7
+
8
+ type WidgetNotificationsItemData = {
9
+ id: string;
10
+ title: string;
11
+ description?: string;
12
+ dateTime: string;
13
+ timeLabel: string;
14
+ isRead?: boolean;
15
+ clearLabel?: string;
16
+ };
17
+
18
+ type WidgetNotificationsProps = {
19
+ heading: React.ReactNode;
20
+ tooltip?: string;
21
+ items: WidgetNotificationsItemData[];
22
+ isFloating?: boolean;
23
+ onItemClick?: (id: string) => void;
24
+ onClearItem?: (id: string) => void;
25
+ onMarkAllAsRead?: () => void;
26
+ markAllAsReadLabel?: string;
27
+ emptyState?: React.ReactNode;
28
+ className?: string;
29
+ };
30
+
31
+ const defaultEmptyState = (
32
+ <EmptyState
33
+ padding="md"
34
+ illustration={<Icon name="message-square-more" size={24} />}
35
+ heading="No notifications"
36
+ subHeading="You're all caught up."
37
+ />
38
+ );
39
+
40
+ export const WidgetNotifications = (props: WidgetNotificationsProps): React.JSX.Element => {
41
+ const {
42
+ heading,
43
+ tooltip,
44
+ items,
45
+ isFloating = false,
46
+ onItemClick,
47
+ onClearItem,
48
+ onMarkAllAsRead,
49
+ markAllAsReadLabel = 'Mark all as read',
50
+ emptyState = defaultEmptyState,
51
+ className,
52
+ } = props;
53
+
54
+ const isEmpty = items.length === 0;
55
+ const hasUnread = items.some(item => !item.isRead);
56
+ const showMarkAllAsRead = Boolean(onMarkAllAsRead) && !isEmpty && hasUnread;
57
+
58
+ return (
59
+ <Widget
60
+ tooltip={tooltip}
61
+ isFloating={isFloating}
62
+ isEmpty={isEmpty}
63
+ emptyState={emptyState}
64
+ className={className}
65
+ >
66
+ <Widget.Header
67
+ slotEnd={showMarkAllAsRead
68
+ ? (
69
+ <Button
70
+ variant="text-link"
71
+ type="button"
72
+ hasHorizontalPadding={false}
73
+ onClick={onMarkAllAsRead}
74
+ >
75
+ {markAllAsReadLabel}
76
+ </Button>
77
+ )
78
+ : undefined}
79
+ >
80
+ {heading}
81
+ </Widget.Header>
82
+ <Widget.Body>
83
+ {!isEmpty && (
84
+ <ol className="ds-widget-notifications__list">
85
+ {items.map(item => (
86
+ <WidgetNotificationsItem
87
+ key={item.id}
88
+ id={item.id}
89
+ title={item.title}
90
+ description={item.description}
91
+ dateTime={item.dateTime}
92
+ timeLabel={item.timeLabel}
93
+ isRead={item.isRead}
94
+ clearLabel={item.clearLabel}
95
+ onItemClick={onItemClick ? () => onItemClick(item.id) : undefined}
96
+ onClear={onClearItem ? () => onClearItem(item.id) : undefined}
97
+ />
98
+ ))}
99
+ </ol>
100
+ )}
101
+ </Widget.Body>
102
+ </Widget>
103
+ );
104
+ };
105
+
106
+ WidgetNotifications.Item = WidgetNotificationsItem;
107
+
108
+ export namespace WidgetNotifications {
109
+ export type Props = WidgetNotificationsProps;
110
+ export type ItemProps = WidgetNotificationsItemProps;
111
+ export type ItemData = WidgetNotificationsItemData;
112
+ }
@@ -0,0 +1,88 @@
1
+ import classNames from 'classnames';
2
+ import { Icon } from 'Components/icon/Icon';
3
+
4
+ export type WidgetNotificationsItemProps = {
5
+ id: string;
6
+ title: string;
7
+ description?: string;
8
+ dateTime: string;
9
+ timeLabel: string;
10
+ isRead?: boolean;
11
+ clearLabel?: string;
12
+ onItemClick?: () => void;
13
+ onClear?: () => void;
14
+ className?: string;
15
+ };
16
+
17
+ const DEFAULT_CLEAR_LABEL = 'Clear notification';
18
+
19
+ export const WidgetNotificationsItem = (props: WidgetNotificationsItemProps): React.JSX.Element => {
20
+ const {
21
+ id,
22
+ title,
23
+ description,
24
+ dateTime,
25
+ timeLabel,
26
+ isRead = false,
27
+ clearLabel = DEFAULT_CLEAR_LABEL,
28
+ onItemClick,
29
+ onClear,
30
+ className,
31
+ } = props;
32
+
33
+ const primaryContent = (
34
+ <>
35
+ <p className="ds-widget-notifications__title">{title}</p>
36
+ {description && (
37
+ <p className="ds-widget-notifications__description">{description}</p>
38
+ )}
39
+ </>
40
+ );
41
+
42
+ return (
43
+ <li
44
+ className={classNames(
45
+ 'ds-widget-notifications__item',
46
+ isRead
47
+ ? 'ds-widget-notifications__item--read'
48
+ : 'ds-widget-notifications__item--unread',
49
+ className,
50
+ )}
51
+ data-testid={`widget-notifications-item-${id}`}
52
+ >
53
+ <div className="ds-widget-notifications__primary">
54
+ {onItemClick
55
+ ? (
56
+ <button
57
+ type="button"
58
+ className="ds-widget-notifications__primary-button remove-default-button-styles"
59
+ onClick={onItemClick}
60
+ >
61
+ {primaryContent}
62
+ </button>
63
+ )
64
+ : (
65
+ <div className="ds-widget-notifications__primary-content">
66
+ {primaryContent}
67
+ </div>
68
+ )}
69
+ </div>
70
+ <div className="ds-widget-notifications__secondary">
71
+ {onClear && (
72
+ <button
73
+ type="button"
74
+ className="ds-widget-notifications__clear remove-default-button-styles"
75
+ aria-label={clearLabel}
76
+ data-testid={`widget-notifications-clear-${id}`}
77
+ onClick={onClear}
78
+ >
79
+ <Icon name="x" size={16} />
80
+ </button>
81
+ )}
82
+ <time dateTime={dateTime} className="ds-widget-notifications__time">
83
+ {timeLabel}
84
+ </time>
85
+ </div>
86
+ </li>
87
+ );
88
+ };
@@ -0,0 +1,186 @@
1
+ .ds-widget-notifications__list {
2
+ margin: 0;
3
+ padding: 0;
4
+ list-style: none;
5
+ display: flex;
6
+ flex-direction: column;
7
+ gap: var(--spacing-xsmall);
8
+ }
9
+
10
+ .ds-widget-notifications__title {
11
+ margin: 0;
12
+ font-family: var(--type-body-p-family);
13
+ font-size: var(--type-body-p-size);
14
+ font-weight: var(--type-body-bold-weight);
15
+ line-height: var(--type-body-line-height);
16
+ }
17
+
18
+ .ds-widget-notifications__description {
19
+ margin: 0;
20
+ font-family: var(--type-body-p-family);
21
+ font-size: var(--type-body-p-size);
22
+ font-weight: var(--type-body-p-weight);
23
+ line-height: var(--type-body-line-height);
24
+ overflow: hidden;
25
+ text-overflow: ellipsis;
26
+ white-space: nowrap;
27
+ }
28
+
29
+ .ds-widget-notifications__time {
30
+ font-family: var(--type-body-p-family);
31
+ font-size: var(--widget-notifications-timestamp-font-size);
32
+ font-weight: var(--type-body-p-weight);
33
+ line-height: var(--type-body-line-height);
34
+ white-space: nowrap;
35
+ }
36
+
37
+ .ds-widget-notifications__item {
38
+ display: flex;
39
+ align-items: stretch;
40
+ gap: var(--spacing-small);
41
+ padding: var(--widget-notifications-spacing-vertical) var(--widget-notifications-spacing-horizontal);
42
+ border-radius: var(--widget-notifications-radius);
43
+
44
+ &--unread {
45
+ background-color: var(--widget-notifications-unread-default-color-background);
46
+
47
+ --notification-clear-bg: var(--widget-notifications-unread-default-icon-default-color-background);
48
+ --notification-clear-bg-hover: var(--widget-notifications-unread-default-icon-hover-color-background);
49
+ --notification-clear-bg-active: var(--widget-notifications-unread-default-icon-active-color-background);
50
+
51
+ &:hover {
52
+ background-color: var(--widget-notifications-unread-hover-color-background);
53
+
54
+ --notification-clear-bg: var(--widget-notifications-unread-hover-icon-default-color-background);
55
+ --notification-clear-bg-hover: var(--widget-notifications-unread-hover-icon-hover-color-background);
56
+ --notification-clear-bg-active: var(--widget-notifications-unread-hover-icon-active-color-background);
57
+ }
58
+
59
+ &:has(.ds-widget-notifications__primary-button:focus-visible),
60
+ &:has(.ds-widget-notifications__clear:focus-visible) {
61
+ background-color: var(--widget-notifications-unread-focus-color-background);
62
+
63
+ --notification-clear-bg: var(--widget-notifications-unread-focus-icon-default-color-background);
64
+ --notification-clear-bg-hover: var(--widget-notifications-unread-focus-icon-hover-color-background);
65
+ --notification-clear-bg-active: var(--widget-notifications-unread-focus-icon-active-color-background);
66
+ }
67
+
68
+ &:has(.ds-widget-notifications__primary-button:focus-visible) {
69
+ outline: var(--focus-border) solid var(--focus-color-focus);
70
+ }
71
+
72
+ .ds-widget-notifications__title {
73
+ color: var(--widget-notifications-unread-color-title);
74
+ }
75
+
76
+ .ds-widget-notifications__description,
77
+ .ds-widget-notifications__time {
78
+ color: var(--widget-notifications-unread-color-text);
79
+ }
80
+ }
81
+
82
+ &--read {
83
+ background-color: var(--widget-notifications-read-default-color-background);
84
+
85
+ --notification-clear-bg: var(--widget-notifications-read-default-icon-default-color-background);
86
+ --notification-clear-bg-hover: var(--widget-notifications-read-default-icon-hover-color-background);
87
+ --notification-clear-bg-active: var(--widget-notifications-read-default-icon-active-color-background);
88
+
89
+ &:hover {
90
+ background-color: var(--widget-notifications-read-hover-color-background);
91
+
92
+ --notification-clear-bg: var(--widget-notifications-read-hover-icon-default-color-background);
93
+ --notification-clear-bg-hover: var(--widget-notifications-read-hover-icon-hover-color-background);
94
+ --notification-clear-bg-active: var(--widget-notifications-read-hover-icon-active-color-background);
95
+ }
96
+
97
+ &:has(.ds-widget-notifications__primary-button:focus-visible),
98
+ &:has(.ds-widget-notifications__clear:focus-visible) {
99
+ background-color: var(--widget-notifications-read-focus-color-background);
100
+
101
+ --notification-clear-bg: var(--widget-notifications-read-focus-icon-default-color-background);
102
+ --notification-clear-bg-hover: var(--widget-notifications-read-focus-icon-hover-color-background);
103
+ --notification-clear-bg-active: var(--widget-notifications-read-focus-icon-active-color-background);
104
+ }
105
+
106
+ &:has(.ds-widget-notifications__primary-button:focus-visible) {
107
+ outline: var(--focus-border) solid var(--focus-color-focus);
108
+ }
109
+
110
+ .ds-widget-notifications__title {
111
+ color: var(--widget-notifications-read-color-title);
112
+ }
113
+
114
+ .ds-widget-notifications__description,
115
+ .ds-widget-notifications__time {
116
+ color: var(--widget-notifications-read-color-text);
117
+ }
118
+ }
119
+ }
120
+
121
+ .ds-widget-notifications__primary {
122
+ flex: 1;
123
+ min-width: 0;
124
+ display: flex;
125
+ align-items: stretch;
126
+ }
127
+
128
+ .ds-widget-notifications__primary-button,
129
+ .ds-widget-notifications__primary-content {
130
+ display: block;
131
+ width: 100%;
132
+ min-width: 0;
133
+ text-align: left;
134
+ }
135
+
136
+ .ds-widget-notifications__primary-button {
137
+ cursor: pointer;
138
+ color: inherit;
139
+
140
+ &:focus {
141
+ outline: none;
142
+ }
143
+
144
+ &:focus-visible {
145
+ outline: none;
146
+ }
147
+ }
148
+
149
+ .ds-widget-notifications__secondary {
150
+ display: flex;
151
+ flex-direction: column;
152
+ align-items: flex-end;
153
+ justify-content: space-between;
154
+ flex-shrink: 0;
155
+ gap: var(--widget-notifications-secondary-spacing-vertical-gap);
156
+ }
157
+
158
+ .ds-widget-notifications__clear {
159
+ display: inline-flex;
160
+ align-items: center;
161
+ justify-content: center;
162
+ flex-shrink: 0;
163
+ width: var(--icon-size-medium);
164
+ height: var(--icon-size-medium);
165
+ border-radius: var(--border-radius-round);
166
+ cursor: pointer;
167
+ color: inherit;
168
+ background-color: var(--notification-clear-bg);
169
+
170
+ &:hover {
171
+ background-color: var(--notification-clear-bg-hover);
172
+ }
173
+
174
+ &:active {
175
+ background-color: var(--notification-clear-bg-active);
176
+ }
177
+
178
+ &:focus {
179
+ outline: none;
180
+ }
181
+
182
+ &:focus-visible {
183
+ outline: var(--focus-border) solid var(--focus-color-focus);
184
+ outline-offset: calc(1 * var(--focus-border));
185
+ }
186
+ }
@@ -226,7 +226,7 @@ Never push directly to `main` — all work goes through a branch and PR.
226
226
  - **Every PR requires a changeset.** These should be generated by running `yarn changeset`, which takes you through a prompt to specify the change level and to give a brief description of your change
227
227
  - **Do not let an AI create a changeset file for you.** AI Agents have a propensity to directly write their own changeset files, which often hallucinate the structure of the files, or the name of the changeset project, which can result in stray changeset files not being added to the changelog on releases. Generate **all** changeset files via `yarn changeset`.
228
228
  - **Do not use backticks or quotes in your changeset description** - these break the release automation
229
- - Until we are on v1.0.0 as our first wide release, we are not using proper semver. For the time being, use minor version bumps for breaking changes and patch for all other changes, including new functionality.
229
+ - We follow [semantic versioning](https://semver.org/): **major** for breaking changes, **minor** for new backwards-compatible functionality, **patch** for backwards-compatible fixes and other non-breaking changes.
230
230
 
231
231
  For the full details and the reasoning behind these rules, see [CONTRIBUTING.md](https://github.com/arbor-education/design-system.components/blob/main/CONTRIBUTING.md) on GitHub.
232
232
 
package/src/index.scss CHANGED
@@ -7,6 +7,7 @@
7
7
  @use "components/icon/icon.scss";
8
8
  @use "components/iconText/iconText.scss";
9
9
  @use "components/heading/heading.scss";
10
+ @use "components/link/link.scss";
10
11
  @use "components/card/card.scss";
11
12
  @use "components/articleCard/articleCard.scss";
12
13
  @use "components/dropdown/dropdown.scss";
@@ -58,7 +59,14 @@
58
59
  @use "components/toggleGroup/toggleGroup.scss";
59
60
  @use "components/dataViewCard/dataViewCard.scss";
60
61
  @use "components/treeRow/treeRow.scss";
61
- @use "components/sidebarNav/sidebarNav.scss";
62
+ @use "components/favourite/favouriteButton.scss";
63
+ @use "components/emptyState/emptyState.scss";
64
+ @use "components/widget/widget.scss";
65
+ @use "components/widgetNotifications/widgetNotifications.scss";
66
+ @use "components/widgetCalendar/widgetCalendar.scss";
67
+ @use "components/widgetFavourites/widgetFavourites.scss";
68
+ @use "components/sidebar/sidebar.scss";
69
+ @use "components/sideNavigation/sideNavigation.scss";
62
70
  @use "components/fileUpload/fileUpload.scss";
63
71
  @use "components/skeleton/skeleton.scss";
64
72
 
package/src/index.ts CHANGED
@@ -1,3 +1,4 @@
1
+ export { ArborLogo, type ArborLogoProps } from 'Components/arborLogo/ArborLogo';
1
2
  export { ArticleCard, type ArticleCardProps } from 'Components/articleCard/ArticleCard';
2
3
  export { Avatar } from 'Components/avatar/Avatar';
3
4
  export { AvatarGroup } from 'Components/avatarGroup/AvatarGroup';
@@ -7,11 +8,14 @@ export { Breadcrumbs } from 'Components/breadcrumbs/Breadcrumbs';
7
8
  export { Button } from 'Components/button/Button';
8
9
  export { Card, type CardProps } from 'Components/card/Card';
9
10
  export { Combobox } from 'Components/combobox/Combobox';
11
+ export { DataViewCard, type DataViewCardProps } from 'Components/dataViewCard/DataViewCard';
10
12
  export { DatePicker } from 'Components/datePicker/DatePicker';
11
13
  export { DateTimePicker } from 'Components/dateTimePicker/DateTimePicker';
12
14
  export { Dot } from 'Components/dot/Dot';
13
15
  export { Dropdown } from 'Components/dropdown/Dropdown';
14
16
  export { EditableText } from 'Components/editableText/EditableText';
17
+ export { EmptyState, type EmptyStateHeadingLevel, type EmptyStatePadding, type EmptyStateProps } from 'Components/emptyState/EmptyState';
18
+ export { FileUpload, type FileUploadProps } from 'Components/fileUpload/FileUpload';
15
19
  export {
16
20
  FilterBar,
17
21
  type FilterBarActiveListProps,
@@ -48,28 +52,19 @@ export { Row } from 'Components/row/Row';
48
52
  export { SearchBar } from 'Components/searchBar/SearchBar';
49
53
  export { Section } from 'Components/section/Section';
50
54
  export { Separator } from 'Components/separator/Separator';
51
- export { SidebarNav } from 'Components/sidebarNav/SidebarNav';
52
- export type {
53
- SidebarNavProps,
54
- SidebarNavNode,
55
- SidebarNavGroupNode,
56
- SidebarNavItemNode,
57
- SidebarNavRailItemConfig,
58
- SidebarNavRailEntry,
59
- SidebarNavRailSeparatorConfig,
60
- SidebarNavRenderLinkArgs,
61
- } from 'Components/sidebarNav/types';
62
- export { isSidebarNavRailSeparator } from 'Components/sidebarNav/types';
55
+ export { Sidebar } from 'Components/sidebar/Sidebar';
56
+ export { SidebarItem } from 'Components/sidebar/SidebarItem';
57
+ export { SideNavigation } from 'Components/sideNavigation/SideNavigation';
63
58
  export { SingleUser } from 'Components/singleUser/SingleUser';
64
59
  export { Slideover } from 'Components/slideover/Slideover';
65
60
  export { SlideoverManager } from 'Components/slideoverManager/SlideoverManager';
66
- export { DefaultCellRenderer } from 'Components/table/cellRenderers/DefaultCellRenderer';
67
61
  export { BooleanCellRenderer } from 'Components/table/cellRenderers/BooleanCellRenderer';
62
+ export { DefaultCellRenderer } from 'Components/table/cellRenderers/DefaultCellRenderer';
63
+ export { NumberInputCellRenderer } from 'Components/table/cellRenderers/NumberInputCellRenderer';
68
64
  export { DSDefaultColDef } from 'Components/table/DSDefaultColDef';
69
65
  export { GridApiContext } from 'Components/table/GridApiContext';
70
66
  export { NumberCellEditor } from 'Components/table/cellEditors/NumberCellEditor';
71
67
  export { CheckboxCellRenderer } from 'Components/table/cellRenderers/CheckboxCellRenderer';
72
- export { NumberInputCellRenderer } from 'Components/table/cellRenderers/NumberInputCellRenderer';
73
68
  export { Table } from 'Components/table/Table';
74
69
  export { Tabs } from 'Components/tabs/Tabs';
75
70
  export { Tag } from 'Components/tag/Tag';
@@ -80,14 +75,23 @@ export { Toggle } from 'Components/toggle/Toggle';
80
75
  export { ToggleGroup } from 'Components/toggleGroup/ToggleGroup';
81
76
  export { Tooltip } from 'Components/tooltip/Tooltip';
82
77
  export { TooltipWrapper } from 'Components/tooltip/TooltipWrapper';
83
- export { GovhubLogo, KeyLogo, RobinLogo, SampeopleLogo, TimetablerLogo } from 'Components/userDropdown/assets/logos';
84
78
  export { TreeRow, type TreeRowItem, type TreeRowProps, type TreeRowSectionProps } from 'Components/treeRow/TreeRow';
79
+ export { GovhubLogo, KeyLogo, RobinLogo, SampeopleLogo, TimetablerLogo } from 'Components/userDropdown/assets/logos';
85
80
  export { UserDropdown } from 'Components/userDropdown/UserDropdown';
81
+ export { Widget } from 'Components/widget/Widget';
82
+ export { WidgetCalendar } from 'Components/widgetCalendar/WidgetCalendar';
83
+ export {
84
+ WidgetFavourites,
85
+ type WidgetFavouritesItemData,
86
+ type WidgetFavouritesItemProps,
87
+ type WidgetFavouritesProps,
88
+ } from 'Components/widgetFavourites/WidgetFavourites';
89
+ export { WidgetNotifications } from 'Components/widgetNotifications/WidgetNotifications';
90
+ export {
91
+ FAVOURITE_FILLED_ICON_COLOR, FAVOURITE_ICON, FAVOURITE_TOOLTIP, getFavouriteRemovedToastMessage, getFavouriteTooltip,
92
+ } from 'Utils/favourites/favouriteConstants';
86
93
  export { isClient } from 'Utils/isClient';
87
94
  export { ModalUtils } from 'Utils/ModalUtils';
88
95
  export { PopupParentContext } from 'Utils/popupParent/PopupParentContext';
89
96
  export { SlideoverUtils } from 'Utils/SlideoverUtils';
90
- export { ArborLogo, type ArborLogoProps } from 'Components/arborLogo/ArborLogo';
91
- export { DataViewCard, type DataViewCardProps } from 'Components/dataViewCard/DataViewCard';
92
- export { FileUpload, type FileUploadProps } from 'Components/fileUpload/FileUpload';
93
97
  export { Grid, type GridProps } from 'Components/grid/Grid';