@actinc/dls
Version:
Design Language System (DLS) for ACT & Encoura front-end projects.
758 lines (465 loc) • 28.2 kB
Markdown
# [7.7.0](https://github.com/act-org/dls/compare/v7.6.3...v7.7.0) (2024-02-22)
### Bug Fixes
* Remove unnecessary vscode/settings.json change ([5918d43](https://github.com/act-org/dls/commit/5918d43adb61a4a57d8c5091f18c4bf37baecc3e))
* Update Readme with instructions on how to implement museo sans downstream ([4b1f3d0](https://github.com/act-org/dls/commit/4b1f3d045f1bc81f92fb7d61c0038bcfbe8d723e))
* Update Readme with Museo Sans font information ([2a55682](https://github.com/act-org/dls/commit/2a55682edfeace4fe0575252dcd5d84b8028109b))
* Update snapshot tests ([3be8179](https://github.com/act-org/dls/commit/3be8179e0fe833f505e45f9b6416f41388a646e9))
* Update snapshot tests ([2c70631](https://github.com/act-org/dls/commit/2c70631b62e34b2829f2b1f22e5470b9401d8285))
* Update themeEncouraClassics font family reference to Museo Sans to match the documentation ([39de919](https://github.com/act-org/dls/commit/39de919b5008e0f4954e3ae92fbdbb837eeef3d9))
### Features
* Delete fonts folder ([c04dcd5](https://github.com/act-org/dls/commit/c04dcd5544d3931a51a4942205259a04bebc4543))
* Upload Museo Sans fonts ([7d22ca4](https://github.com/act-org/dls/commit/7d22ca4d603631c4f3c088c6db60f81aec499eee))
## [7.6.3](https://github.com/act-org/dls/compare/v7.6.2...v7.6.3) (2024-02-06)
### Bug Fixes
* Fix duplicate import ([7ac17bd](https://github.com/act-org/dls/commit/7ac17bd153e38b141cda898851a82aef388a8220))
* Minor config fixes ([d869537](https://github.com/act-org/dls/commit/d869537b398c98705366876eb9b05403f9ab130a))
* Update the build process to allow for local installs ([c78baa9](https://github.com/act-org/dls/commit/c78baa9053d36d0e69f8d72ddbe86fe91e1815af))
## [7.6.2](https://github.com/act-org/dls/compare/v7.6.1...v7.6.2) (2024-02-06)
### Bug Fixes
* Change H5 font size for small screen sizes ([95586f0](https://github.com/act-org/dls/commit/95586f0ba5ba1843ed42f9af3ebe0f170d655411))
# [7.6.0](https://github.com/act-org/dls/compare/v7.5.1...v7.6.0) (2024-01-26)
### Features
* Adds theme custom shadows ([12a9be1](https://github.com/act-org/dls/commit/12a9be19a3a4efc2f222d49ccf735464008d35fe))
## [7.5.1](https://github.com/act-org/dls/compare/v7.5.0...v7.5.1) (2024-01-09)
### Bug Fixes
* Adds back fontWeight to some breakpoints ([ffea563](https://github.com/act-org/dls/commit/ffea563c96cfbb6d601d33d6cc981fe50a879eb2))
* Fixes font weight overriding preexisting font weights ([06b9146](https://github.com/act-org/dls/commit/06b91460443e718656257ea136da6c3a84b36cc9))
# [7.5.0](https://github.com/act-org/dls/compare/v7.4.0...v7.5.0) (2023-11-30)
### Bug Fixes
* ENCS-4466 Fixed breakpoints and addressed comments ([c48a197](https://github.com/act-org/dls/commit/c48a197d4a8105a14c1370755550cea37fe65a99))
### Features
* Encourage response font sizes ([cb84f03](https://github.com/act-org/dls/commit/cb84f03aa597b0ee593bff4ad94b2d8856af61f9))
# [7.4.0](https://github.com/act-org/dls/compare/v7.3.0...v7.4.0) (2023-10-11)
### Features
* Add colors to Encourage for more flexability ([293597d](https://github.com/act-org/dls/commit/293597d47b24b6bb41afe487fc889704ff7ffd80))
# [7.3.0](https://github.com/act-org/dls/compare/v7.2.3...v7.3.0) (2023-07-28)
### Features
* Added support for HTML content in snackbar alerts ([f7af0fa](https://github.com/act-org/dls/commit/f7af0fa21f6ca6925cfc37d4ba0870f0d0acb6b9))
## [7.2.3](https://github.com/act-org/dls/compare/v7.2.2...v7.2.3) (2023-07-24)
### Bug Fixes
* Adjust MUI peer deps to proper versions ([a2eca17](https://github.com/act-org/dls/commit/a2eca174f7ff32f91293d3223320604b5494fb02))
## [7.2.2](https://github.com/act-org/dls/compare/v7.2.1...v7.2.2) (2023-07-20)
### Bug Fixes
* Trigger a new build ([1f825a8](https://github.com/act-org/dls/commit/1f825a8fc53f65c6ea406496bbcac9f9169db116))
## [7.2.1](https://github.com/act-org/dls/compare/v7.2.0...v7.2.1) (2023-05-02)
### Bug Fixes
* Upgraded npm deps to their latest compatible releases ([233df06](https://github.com/act-org/dls/commit/233df06eb476694bcee8dfad4cc7867933fe029b))
# [7.2.0](https://github.com/act-org/dls/compare/v7.1.1...v7.2.0) (2023-04-20)
### Features
* Adding more Autocomplete stories ([32180bc](https://github.com/act-org/dls/commit/32180bce3aa46f543efe20130df608ad12a90287))
## [7.1.1](https://github.com/act-org/dls/compare/v7.1.0...v7.1.1) (2023-04-18)
### Bug Fixes
* Fix type issue with SvgIcon on EmptyState component ([8a9004a](https://github.com/act-org/dls/commit/8a9004a974c4126f5bb1c0540468a9060a4e13b2))
* Migrate Storybook 6 code to Storybook 7 ([326f34b](https://github.com/act-org/dls/commit/326f34ba28ed8d2a4fb1a4778130bf64e6d77966))
# [7.1.0](https://github.com/act-org/dls/compare/v7.0.1...v7.1.0) (2023-04-14)
### Bug Fixes
* Fix storybook exception on startup ([b69c24e](https://github.com/act-org/dls/commit/b69c24e552cdae69a2311e3c05e6c6ba19b28ee7))
* Revert TS to 4.9.5 per https://github.com/styleguidist/react-docgen-typescript/issues/474 ([814f007](https://github.com/act-org/dls/commit/814f0078ec0fc488b56148d21e4871e31cfffb9c))
* Storybook typescript fixes ([ec0b470](https://github.com/act-org/dls/commit/ec0b470c3c01cde9697350f25da1bdb953a68351))
### Features
* Added palette visualizer ([7c040e8](https://github.com/act-org/dls/commit/7c040e8dedd5f92e16f8182eb80fcacd9d2683f8))
* Added shadows visualizer ([9ca13bb](https://github.com/act-org/dls/commit/9ca13bb28380651a1ef2e78a808a6d60cb858d55))
* Added shape visualizer ([891588b](https://github.com/act-org/dls/commit/891588b326c4faf9bf9b1e1911f9898a952dc083))
* Added spacing visualizer ([97a34b9](https://github.com/act-org/dls/commit/97a34b950b08247767d6e5b745b37ae33181a410))
* Added typography visualizer ([39d870f](https://github.com/act-org/dls/commit/39d870f11e3e5893b201a42e861f36f45f9a141a))
* Render palette options in smaller groups for improved readability ([4039d0b](https://github.com/act-org/dls/commit/4039d0b9a4f87585fcd4c493fc371400f92821c8))
## [7.0.1](https://github.com/act-org/dls/compare/v7.0.0...v7.0.1) (2023-03-16)
### Bug Fixes
* Remove helpers/tests from exports to remove deps ([75468d0](https://github.com/act-org/dls/commit/75468d0f3b4f90e4aa131738199231696c4ed2d9))
# [7.0.0](https://github.com/act-org/dls/compare/v6.3.0...v7.0.0) (2023-03-16)
### Bug Fixes
* Export ThemeCustomizations type from each theme file ([285c9ca](https://github.com/act-org/dls/commit/285c9ca34b9401cb147e993a371e348c2d39daf4))
* Fix missing exports ([1338315](https://github.com/act-org/dls/commit/1338315697c6a4a51e92c9cc29484fb6cd5510b4))
* Update to current MDX extension ([d127977](https://github.com/act-org/dls/commit/d1279776437ab14fd1396b4913ab1746cf30d54d))
### Features
* Add Encourage E4S theme (work in progress) ([1a57c41](https://github.com/act-org/dls/commit/1a57c41d2c0444c59a351b3726b10323eafd6760))
* Add spacingPx to all themes ([0039309](https://github.com/act-org/dls/commit/003930931dddaefba7d335070a112960fe5d4353))
* Better tree shaking support ([0697936](https://github.com/act-org/dls/commit/06979363f4d29e6a23230c8c82b7274673692bd5))
* Enable github actions and standard-release ([81238fb](https://github.com/act-org/dls/commit/81238fbf6b0124eab164146d9fd6a19d1e13a6c1))
* Encourage theme tweaks based on latest E4S ([96a5346](https://github.com/act-org/dls/commit/96a53465404ebf02cccdd3c97f190b59a7f034b9))
* Migrate from babel build to es6 build for better tree shaking ([6660657](https://github.com/act-org/dls/commit/6660657ac9bf85460370f89a2c3997ea7dc59e83))
* Migrate MUI stories to CSF V3 format ([257c9d6](https://github.com/act-org/dls/commit/257c9d61fe8d07aa99383a46605e5fbb2eea1194))
* Remove custom colors from themes and move into palette on existing themes ([f5a2d55](https://github.com/act-org/dls/commit/f5a2d559d0665333234a7c03133c60c1c3c097af))
### BREAKING CHANGES
* Breaking changes to the theme creation format and the module output
# [7.0.0-next.4](https://github.com/act-org/dls/compare/v7.0.0-next.3...v7.0.0-next.4) (2023-03-16)
### Bug Fixes
* Export ThemeCustomizations type from each theme file ([285c9ca](https://github.com/act-org/dls/commit/285c9ca34b9401cb147e993a371e348c2d39daf4))
* Fix missing exports ([1338315](https://github.com/act-org/dls/commit/1338315697c6a4a51e92c9cc29484fb6cd5510b4))
# [7.0.0-next.3](https://github.com/act-org/dls/compare/v7.0.0-next.2...v7.0.0-next.3) (2023-03-13)
### Features
* Encourage theme tweaks based on latest E4S ([96a5346](https://github.com/act-org/dls/commit/96a53465404ebf02cccdd3c97f190b59a7f034b9))
# [7.0.0-next.2](https://github.com/act-org/dls/compare/v7.0.0-next.1...v7.0.0-next.2) (2023-03-13)
### Features
* Add spacingPx to all themes ([0039309](https://github.com/act-org/dls/commit/003930931dddaefba7d335070a112960fe5d4353))
# [7.0.0-next.1](https://github.com/act-org/dls/compare/v6.3.0...v7.0.0-next.1) (2023-02-17)
### Bug Fixes
* Update to current MDX extension ([d127977](https://github.com/act-org/dls/commit/d1279776437ab14fd1396b4913ab1746cf30d54d))
### Features
* Add Encourage E4S theme (work in progress) ([1a57c41](https://github.com/act-org/dls/commit/1a57c41d2c0444c59a351b3726b10323eafd6760))
* Better tree shaking support ([0697936](https://github.com/act-org/dls/commit/06979363f4d29e6a23230c8c82b7274673692bd5))
* Enable github actions and standard-release ([81238fb](https://github.com/act-org/dls/commit/81238fbf6b0124eab164146d9fd6a19d1e13a6c1))
* Migrate from babel build to es6 build for better tree shaking ([6660657](https://github.com/act-org/dls/commit/6660657ac9bf85460370f89a2c3997ea7dc59e83))
* Migrate MUI stories to CSF V3 format ([257c9d6](https://github.com/act-org/dls/commit/257c9d61fe8d07aa99383a46605e5fbb2eea1194))
* Remove custom colors from themes and move into palette on existing themes ([f5a2d55](https://github.com/act-org/dls/commit/f5a2d559d0665333234a7c03133c60c1c3c097af))
### BREAKING CHANGES
* Breaking changes to the theme creation format and the module output
## [6.3.0](https://github.com/act-org/dls/compare/v6.2.0...v6.3.0) (2022-12-02)
### Features
* Bump npm packages to their latest compatible releases ([12321f7](https://github.com/act-org/dls/commit/12321f734bdb11d5f05c6e42b7859b2540555011))
## [6.2.0](https://github.com/act-org/dls/compare/v6.1.2...v6.2.0) (2022-11-01)
### Features
* Upgrade NPM deps to their latest compatible releases ([00e7861](https://github.com/act-org/dls/commit/00e7861ac503cfea486e9d05830a273ede802e12))
### [6.1.2](https://github.com/act-org/dls/compare/v6.1.1...v6.1.2) (2022-08-31)
### Bug Fixes
* Fix 'Select' component playground not interacting well with 'multiple' control ([9f0e9ae](https://github.com/act-org/dls/commit/9f0e9aef74d576dd0931203d0ba47f7528aa47ea))
### [6.1.1](https://github.com/act-org/dls/compare/v6.1.0...v6.1.1) (2022-07-14)
### Bug Fixes
* React runtime build ([4a9fa81](https://github.com/act-org/dls/commit/4a9fa8149708377c9e09ee28a1b73fc26d17eb44))
* Update Confirm Story imports and storybook warnings ([08e9859](https://github.com/act-org/dls/commit/08e98593c6dd7bb2849fc61c96acbe442dad504c))
### [6.0.5](https://github.com/act-org/dls/compare/v6.0.4...v6.0.5) (2022-07-14)
## [6.1.0](https://github.com/act-org/dls/compare/v6.0.4...v6.1.0) (2022-07-14)
### Features
* Add Confirmation Dialog component ([7c43699](https://github.com/act-org/dls/commit/7c436991432637a9218e15d39e84fccc9e856da1))
### Bug Fixes
* Confirmation hook multiple fires and API organization ([9531207](https://github.com/act-org/dls/commit/953120790e00561f914625d0ad544c9fa86f1aa1))
* Remove story types from build ([3d1b80b](https://github.com/act-org/dls/commit/3d1b80bf0c0601ebd50527747202593f4dc458f4))
### [6.0.4](https://github.com/act-org/dls/compare/v6.0.3...v6.0.4) (2022-07-05)
### [6.0.3](https://github.com/act-org/dls/compare/v6.0.2...v6.0.3) (2022-06-29)
### [6.0.2](https://github.com/act-org/dls/compare/v6.0.1...v6.0.2) (2022-06-29)
## 6.0.1 (2022-05-31)
### ⚠ BREAKING CHANGES
* mui 5 and mui 4 are incompatible
* mui 5 no longer uses JSS but emotion
* chore(release): 6.0.0-alpha.0
* chore: Add release scripts
* chore: Fix labs peer dep
* chore(release): 6.0.0-alpha.1
* chore: Cleanup typography settings after migration
* chore(release): 6.0.0-alpha.2
* chore: Clean up babel build overrides
* chore(release): 6.0.0-alpha.3
* chore: Clean up act theme fix babel remaps and config inheritance
* chore(release): 6.0.0-alpha.4
* chore: Refactor styled engine provider location
* chore: Fix styled-engine peerDep
* chore(release): 6.0.0-alpha.5
* chore: Use rem for typography spacing
* chore(release): 6.0.0-alpha.6
* chore: Update snap
* chore: Clean ui mui stories and update tests
* chore(release): 6.0.0-alpha.7
* chore: Update lock file
* chore(release): 6.0.0-alpha.8
* chore: NPM package upgrades
* test: Update tests
* test: Fix all tests
* fix: Rename story names
* feat: Remove deprecated components
* refactor: Rename FormInputGroups to GridGenerator
* feat: Added status badges, documentation cleanup
* chore: Documentation cleanup
* refactor: Migrate styling from JSS to emotion
* fix: Remove @mui/styles dep
* chore: Updated packages
* test: Fix tests
* fix: Fix issues with React 18 upgrade
* docs: Remove versions from install command since we are compatible with latest
* docs: Fix versions
* docs: Fix dev guide for mui5
* chore(release): 6.0.0-alpha.9
* fix: Import classes directly to fix downstream module issues
* chore(release): 6.0.0-alpha.10
* fix: Import StyledEngineProvider from main package
* chore(release): 6.0.0-alpha.11
* fix: Fix import of StyledEngineProvider
* chore(release): 6.0.0-alpha.12
* docs: Minor doc improvements
* chore: Fix storybook publish command
* fix: Do not import colors on private path
* chore(release): 6.0.0-alpha.13
* build: Prep for release
* chore(release): 6.0.0
* build: Prep for release
* chore(release): 6.0.0
* build: Prep for release
* chore(release): 6.0.0
Co-authored-by: Justin Watkins <justin.watkins@act.org>
### Features
* Replace ACT logo with ACT|Encoura lockup logo ([#40](https://github.com/act-org/dls/issues/40)) ([4e18c14](https://github.com/act-org/dls/commit/4e18c1418606cc6a56740256e9bc4596cba63d1f))
* Migrate to MUI5, Add Support for React 18 (#75) ([13528a5](https://github.com/act-org/dls/commit/13528a523e3003e37e4c04290cd7389c05ed3114)), closes [#75](https://github.com/act-org/dls/issues/75)
## [6.0.0-alpha.13](https://github.com/act-org/dls/compare/v6.0.0-alpha.12...v6.0.0-alpha.13) (2022-05-31)
### Bug Fixes
* Do not import colors on private path ([d21b426](https://github.com/act-org/dls/commit/d21b4263ee43f4734ffdd45000cd0401e09dde51))
## [6.0.0-alpha.12](https://github.com/act-org/dls/compare/v6.0.0-alpha.11...v6.0.0-alpha.12) (2022-05-26)
### Bug Fixes
* Fix import of StyledEngineProvider ([77cd478](https://github.com/act-org/dls/commit/77cd478d6d20e37d0b700620595e60f2726f2432))
## [6.0.0-alpha.11](https://github.com/act-org/dls/compare/v6.0.0-alpha.10...v6.0.0-alpha.11) (2022-05-26)
### Bug Fixes
* Import StyledEngineProvider from main package ([a2e489f](https://github.com/act-org/dls/commit/a2e489f5d7bfa65ecb88590c12416b4612cb1f29))
## [6.0.0-alpha.9](https://github.com/act-org/dls/compare/v6.0.0-alpha.8...v6.0.0-alpha.9) (2022-05-24)
### Features
* Added status badges, documentation cleanup ([19a6207](https://github.com/act-org/dls/commit/19a6207714c4b7ff408b07e19433226db1db26ff))
* Remove deprecated components ([232d221](https://github.com/act-org/dls/commit/232d2215815d79433df51c6a2cfe9f27446e655a))
### Bug Fixes
* Fix issues with React 18 upgrade ([795c361](https://github.com/act-org/dls/commit/795c361829269158b168660fed43c6252a605ade))
* Remove @mui/styles dep ([eab73de](https://github.com/act-org/dls/commit/eab73de5b8a9ff3bf582581e85a18a7150f345d2))
* Rename story names ([913d10c](https://github.com/act-org/dls/commit/913d10c4dd9c7f17561a420e93190fc0f980a83f))
## [6.0.0-alpha.8](https://github.com/act-org/dls/compare/v6.0.0-alpha.7...v6.0.0-alpha.8) (2022-05-20)
### Features
* Replace ACT logo with ACT|Encoura lockup logo ([#40](https://github.com/act-org/dls/issues/40)) ([4e18c14](https://github.com/act-org/dls/commit/4e18c1418606cc6a56740256e9bc4596cba63d1f))
## [6.0.0-alpha.7](https://github.com/act-org/dls/compare/v6.0.0-alpha.6...v6.0.0-alpha.7) (2022-04-05)
## [6.0.0-alpha.6](https://github.com/act-org/dls/compare/v6.0.0-alpha.5...v6.0.0-alpha.6) (2022-04-04)
## [6.0.0-alpha.5](https://github.com/act-org/dls/compare/v6.0.0-alpha.4...v6.0.0-alpha.5) (2022-04-01)
## [6.0.0-alpha.4](https://github.com/act-org/dls/compare/v6.0.0-alpha.3...v6.0.0-alpha.4) (2022-04-01)
## [6.0.0-alpha.3](https://github.com/act-org/dls/compare/v6.0.0-alpha.2...v6.0.0-alpha.3) (2022-03-31)
## [6.0.0-alpha.2](https://github.com/act-org/dls/compare/v6.0.0-alpha.1...v6.0.0-alpha.2) (2022-03-09)
## [6.0.0-alpha.1](https://github.com/act-org/dls/compare/v6.0.0-alpha.0...v6.0.0-alpha.1) (2022-03-04)
## [6.0.0-alpha.0](https://github.com/act-org/dls/compare/v5.11.1...v6.0.0-alpha.0) (2022-03-02)
### ⚠ BREAKING CHANGES
* mui 5 and mui 4 are incompatible
* mui 5 no longer uses JSS but emotion
### Features
* Documentation and Working build for mui-5 upgrade ([be6662e](https://github.com/act-org/dls/commit/be6662eb006e35c526d6752d8f7af4dd022edf3b))
* Material UI 5 support ([36c942e](https://github.com/act-org/dls/commit/36c942e828ba558e13a20624a9aa18e0396ff009))
* Mui 5 functional themes, cleaned up Mui storybook examples ([2ae784b](https://github.com/act-org/dls/commit/2ae784bddd0ca32af48bc8b545df60a1a2115acb))
## [v5.12.3] - May 19, 2022
* Moved `@material-ui/core`, `@material-ui/data-grid`, and `@material-ui/lab`
to the `devDependencies` section of `package.json`, since they are peer
dependencies. This allows the downstream project to choose the exact versions
of these packages that they would like to use. Any `4.x` version should suffice!
## [v5.12.3] - May 19, 2022
* Moved `@material-ui/core`, `@material-ui/data-grid`, and `@material-ui/lab`\
to the `devDependencies` section of `package.json`, since they are peer
dependencies. This allows the downstream project to choose the exact versions of
these packages that they would like to use. Any `4.x` version should suffice!
## [v5.12.1] - Mar 09, 2022
* Improved the TypeScript definition of the `titleTypographyProps` prop on
the `<EmptyState />` component.
## [v5.12.0] - Mar 09, 2022
* Added new optional props to the `EmptyState` component
* `descriptionTypographyProps`
* `iconProps`
* `titleTypographyProps`
* Improved the styling of the `EmptyState` title so that this component
looks good across all themes.
## [v5.11.1] - Feb 28, 2022
* Upgraded most of the NPM dependencies and dev-dependencies to their latest
compatible releases.
## [v5.11.0] - Jan 20, 2022
* Added a new color option, `customColors.tertiary.main`, to all themes.
* Material UI v4 does not support the "tertiary" keyword on the `palette`, so
this was implemented through `customColors` instead.
* Updated the `palette.secondary.dark` color on the `ENCOURA_DATALAB` theme to
`#003359`.
## [v5.10.1] - Jan 20, 2022
* Enable more flexibility on the react version used by downstream projects by
moving `react` and `react-dom` to dev dependencies.
## [v5.10.0] - Jan 13, 2022
* Added a new theme, `ENCOURA_DATALAB`, to the DLS. This theme is representative
of one of [Encoura](https://encoura.org/)'s product lines.
* Minor improvements and bug fixes for the `ACT_ET` theme.
* Added more stories to the Storybook.
## [v5.9.0] - Dec 06, 2021
* New component: `<TablePaginationActions />`
* Useful for paginating large lists and tables
* Enhanced `<DataTable />` component with `<TablePaginationActions />` and
optional props to support server-side pagination:
```ts
limit?: number;
offset?: number;
onChangeLimit?: (limit: number) => void;
onChangeOffset?: (offset: number) => void;
rowsPerPageOptions?: number[];
totalCount?: number;
```
## [v5.8.1] - Nov 03, 2021
* Bind `this` to `addError` in `AlertContext`.
## [v5.8.0] - Nov 03, 2021
* Added a new helper: `getErrorMessage`
* Added new action for `AlertContext`: `addError`.
## [v5.7.0] - Nov 01, 2021
* Updated the `ACT_ET` theme to produce cleaner text inputs and dropdowns
when using Material UI's
[`<TextField />`](https://v4.mui.com/api/text-field/#textfield-api) component.
* Updated the documentation for `<FormInputGroups />` to use `<TextField />`
under the hood, since this is now the preferred way to add inputs to your app.
## [v5.6.0] - Nov 01, 2021
* Added a new helper: `oxfordCommaJoin`
## [v5.5.2] - Aug 06, 2021
* Added `useLocalStorage` hook, which replaces the NPM package
`react-use-localstorage`.
## [v5.5.1] - July 29, 2021
* Fixes the `ReferenceError: regeneratorRuntime is not defined` exception in
`AlertContext`.
## [v5.5.0] - July 28, 2021
* Added `<SnackbarAlert />` component, which is an enhanced `<Alert />`
component that can transition on and off of the screen.
* Added `AlertContext` (React Context) to queue and manage the display of
multiple `SnackbarAlert`s at the same time. Downstream apps should use the
provided `AlertContext` to programmatically trigger alerts, rather than
using `SnackbarAlert` directly. Example below!
* Powered by [notistack](https://github.com/iamhosseindhv/notistack).
```jsx
// APP SETUP:
import AlertContextProvider from '@actinc/dls/context/AlertContext/provider';
const Root: React.FC = (): React.ReactElement<any> => (
<AlertContextProvider
anchorOriginHorizontal="right" // optional
anchorOriginVertical="bottom" // optional
maxSnack={5} // optional
>
<MyApp />
</AlertContextProvider>
);
```
```jsx
// COMPONENT USAGE:
import { AlertContext } from '@actinc/dls/context';
const MyComponent: React.FC = (): React.ReactElement<any> => {
const { actions } = React.useContext(AlertContext);
return (
<span
onClick={async (): Promise<void> => {
await actions.addAlert({
message: 'Some error message',
options: {
variant: 'error',
},
});
}}
>
Click Me
</span>
);
};
```
## [v5.4.0] - July 27, 2021
* Lots of CSS improvements for the `<DataGrid />` component on the `ACT_ET`
theme
* Revamped the `<DataTable />` component as a simpler alternative to
`<DataGrid />`
* All styles are now pulled from the Material UI theme
* Introduced a new `color: 'default' | 'primary' | 'secondary'` prop
* BREAKING STYLE CHANGE: Previously, the default color treatment was
`primary` (blue header row). The new default color treatment is `default`
(grey header row).
* Fixed some style issues with the `<Switch />` and `<Badge />` components in
the `ACT_ET` theme
* Fixed some minor style issues with the `<AppBarNavigation />` component
* We are no longer exporting the some components that were previously marked
as V3 / Deprecated:
* `<TableCellHead />`
* `<TableCellBody />`
* `<TableContainer />`
## [v5.3.0] - July 23, 2021
* Added `<IdleTimer />` utility
* Monitors keyboard and mouse activity to determine when the user
has gone idle.
* Added `<DialogContinueSession />` molecule
* Used to prompt the user to continue their current session. If the user does
not choose to continue their session by the provided date, the user's
session will expire.
* Added `<SessionTimer />` organism
* Combines two `IdleTimer`s with the `DialogContinueSession` component
in order to fully and effectively manage the user's session.
## [v5.2.0] - July 22, 2021
* NPM package updates (`@material-ui/core` -> `^4.12.1`)
* Added `<SessionStorageKeySharer />` utility component which allows a
newly-opened tab to obtain a key:value pair from the Session Storage of another
tab.
* This is useful if you are storing your application's auth token in Session
Storage and want to allow your users to open your app in another tab without
having to re-authenticate.
* The implementation was inspired by
[this blog post](https://medium.com/@marciomariani/sharing-sessionstorage-between-tabs-5b6f42c6348c).
* Note: Since this component makes use of Session Storage and Local Storage,
this component is only meant to be rendered in the browser context. SSR apps
should not use Session Storage for key/value pairs that are critical to the
render (such as the user's auth token).
## [v5.1.0] - June 15, 2021
* Updated `<FormSelect />` component to allow options to be disabled.
([Pull Request](https://github.com/act-org/dls/pull/9))
## [v5.0.0] - June 07, 2021
* With this release, the DLS will no longer export components that you can
import directly from Material UI, such as `<Button />` and `<Link />`.
* In almost all cases, there is no functional/stylistic difference between
importing a MUI component from the DLS vs. MUI. The only exception is with the
`<Link />` component, as the MUI `Link` component does not accept a `to` prop.
* Removed `COLORS` and `DIMS` constants. All DLS components are now powered
by the theme engine.
* Renamed the following components:
* Renamed `<DataTablePrimary />` to `<DataTable />`
* Renamed `<LoadingPrimary />` to `<Loading />`
* Renamed `<TableContainerPrimary />` to `<TableContainer />`
* Re-instated, and marked as deprecated, the following v3 components to help
with reverse compatibility / application migration. These components should
be removed when they have suitable alternatives that are powered by the MUI
themeing engine:
* `<FormInputPrimary />`
* `<FormSelectPrimary />`
* `<InputLabelPrimary />`
* `<InputPrimary />`
* `<SelectPrimary />`
* `<SelectSecondary />`
## [v4.1.0] - May 25, 2021
* This release includes a new
[`<AppBarNavigation />`](https://act-org.github.io/dls/?path=/docs/organisms-appbarnavigation--default-navigation)
component, courtesy of @stefansolyom.
## [v4.0.0] - April 01, 2021
* The DLS has been completely rebuilt on top of the Material UI
[theme engine](https://material-ui.com/customization/theming/).
* There are two UI themes that are provided out of the box:
`ACT` and `ACT_ET`.
* Refer to the README for usage instructions and more details.
## [v3.1.0] - March 05, 2021
* This package is now open source! Available on NPM at `@actinc/dls`
* Check the `README.md` file for slightly modified installation and usage
instructions
## [v3.0.0] - January 06, 2021
This release improves the ability for developers to extend / override DLS
components within their downstream applications.
Previously, the DLS styles were defined in a rigid manner, such that when you
would send in a custom `classes` prop with some custom styles, these styles
would _replace_ the default styling of the component, rather than
_extend / compliment_ it.
To that end, v3 components will now _extend_ their default styling when a
custom `classes` prop is supplied.
Furthermore, we have introduced a new `mergeClasses` helper function -- the
brains behind the new style merging behavior -- since this is a useful utility
for downstream apps as well.
Here's an example of how you can use `mergeClasses` to help create your own
component variants that are based on Material UI:
```tsx
/**
* @prettier
*/
import * as React from 'react';
import { Button, ButtonProps } from '@material-ui/core';
import { mergeClasses } from 'act-dls/lib/helpers';
import useStyles from './styles';
type Props = ButtonProps & {
subject: Subject;
};
const CustomButtonForTestPrep: React.FC<Props> = ({
classes: classesProp, // allow custom classes/styling to be supplied
subject,
...otherButtonProps
}: Props): React.ReactElement<any> => {
const classes = useStyles({ subject });
return (
<Button
classes={mergeClasses( // merge the default and custom styles together
{
outlined: classes.buttonOutlined,
root: classes.buttonRoot,
},
classesProp, // the custom styles take preference
)}
{...otherButtonProps}
/>
);
};
export default CustomButtonForTestPrep;
```
<!-- markdownlint-disable-file -->