@simoncomputing/mui-bueno-v2 0.14.7

package/CHANGELOG.md

@@ -0,0 +1,1206 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html)<sup>1</sup>.
+
+<sup>1</sup>Starting v0.2.40, we'll be following the following versioning practices to make it easier for devs to determine whether or not they are ready to upgrade to a newer verison of Mui Bueno:
+
+- Major increment --> large/many changes. SEVERAL breaking changes.
+- Minor increment --> singlular/minor changes. Minimal breaking changes.
+- Patch increment --> singlular/minor changes. Zero breaking changes.
+
+## [0.14.7] - 2025-07-01
+
+**Important: Starting v0.14.7, this library will be published under the `simoncomputing` org in NPM, so please update your `mui-bueno-v2` import in `package.json` to `@simoncomputing/mui-bueno-v2`.**
+
+### Changed
+
+- `CitationField`:
+    - Replaced `CitationCrossFieldSyncProvider` with `CitationFieldProvider`
+    - Replaced icon for "Insert Citation" button
+- `CitationField`/`CitationMenu`: updated error handling to call optional `onError` prop instead of logging to the console
+- `Tabs`/`Navbar`/`FloatingNavBar`/`Sidebar`: simplified `activeTabIdx` prop type definition (`activeTabIdx?: number | undefined` --> `activeTabIdx?: number`)
+
+### Fixed
+
+- `CitationFieldProvider` (formerly `CitationCrossFieldSyncProvider`): Fixed and issue where the provider, when wrapping multiple `CitationField` components, would cause the pop-up menus to open for other fields after updating the title of a citation
+- `Header`: added truthiness check for logo
+- `Table`/`PaginatedTable`: fixed issue causing sort field to switch from `uncontrolled` to `controlled` state
+
+## [0.14.6] - 2025-06-27
+
+### Added
+
+- `CitationCrossFieldSyncProvider`: Used to keep multiple `CitationField` components in sync by notifying all fields whenever a citation's title is updated, in case a refetch is needed.
+
+### Changed
+
+- `CitationField`/`CitationMenu` - error handling will all be handled internally now. Migration instructions: Make sure you're not catching errors for `fetchExistingCitations`, `onCreateCitation`, `onUpdateCitation`, `getCitationById`, and `onStoreAttachment`.
+
+### Removed
+
+- `CitationField`: Removed the `renderContentOnly` prop. This was meant to be removed in 0.14.0 but missed removing the actual prop definition.
+
+## [0.14.5] - 2025-06-26
+
+### Added
+
+- `CitationField`: Added `required` prop, which will display an asterisk next to the label (if provided)
+
+### Changed
+
+- `CitationField`: Label will auto-generate based on the `name`, to be consistent with other inputs. To remove this, use the `hideLabel` prop.
+
+### Removed
+
+- `CitationField`: Removed `labelProps` because the internal label was replaced with Mui's `InputLabel` component, to ensure it's consistent with other components.
+
+## [0.14.4] - 2025-06-26
+
+### Fixed
+
+- `CitationField`: Fixed "'flushSync' was called from inside a lifecycle method." error
+
+## [0.14.1] - 2025-06-25
+
+### Changed
+
+- `CitationField`: Optimized internal API fetching. Now the citation labels will only be fetched (1) when the formik value changes (2) when a unique citation is injected into the editor, or (3) the title of a citation in the editor was changed.
+
+## [0.14.0] - 2025-06-23
+
+### Added
+
+- `CitationField`: Added light gray background highlighting to the citation node when selected via arrow-keys, to improve accessibility for users interacting with the editor via keyboard.
+
+### Changed
+
+- `CitationField`:
+    - Major refactor of how citations were rendered in the internal text editor
+    - Citation titles will load in dynamically, to reduce issues where the user modifies a citation, then the title displayed is different
+
+### Removed
+
+- `CitationField`: Removed the `renderContentOnly` prop, as this was causing some errors in the console. May reintroduce it in the future, but will need to revisit the documentation first to ensure it's being used correctly.
+
+## [0.13.3] - 2025-06-19
+
+### Fixed
+
+- `CitationMenu`/`CitationField`: Fixed a bug where if the user clicks edit on an existing citation, then tries to create a citation, the fields would be prefilled with the previous citation's information.
+
+## [0.13.2] - 2025-06-19
+
+### Added
+
+- `CitationMenu`: Added `onContentUpdate` callback to allow for listening to changes to the content (ex. data in the citations table, user clicks "Add Citation", etc.). This is fairly simplistic, and is primarily intended to be used in cases like displaying `CitationMenu` inside of a Popper, which will need to be repositioned if the content within it changes dimensions (otherwise content may be cut off).
+
+## [0.13.1] - 2025-06-19
+
+### Added
+
+- `CitationMenu`: Added docs for all props
+
+### Changed
+
+- `CitationMenu`: Renamed prop `onClose` to `onCancel`
+
+## [0.13.0] - 2025-06-19
+
+### Added
+
+- `CitationMenu`: Exposed the internal menu from `CitationField` so that it can be used outside of `CitationField`. This component allows for the creating, editing, and selecting citations/attachments.
+
+### Changed
+
+- `CitationField`: Refactored internal components as part of exposing `CitationMenu`. There shouldn't be any noticable changes but there may be potential issues as a result.
+
+- `FileUpload`: changed data-testid of the file upload inputs to make them more specific for unit tests ("input" --> "file-input")
+
+### Fixed
+
+- `CitationField`
+    - Fixed a bug where if the user repeated clicks on an existing citation in the field/editor (superscript link) then closes the pop-up/bubble menu via Cancel button, the menu would not have the existing citations pre-selected in the pop-up/bubble menu every other time.
+    - Fixed an inconsistency in how the forms were validated between the Citation and Attachment forms -- the Attachment form was being validated immediately rather than waiting for the user to interact so that's been fixed to match the Citation Form
+
+## [0.12.8] - 2025-06-13
+
+### Fixed
+
+- `CitationField` _(WIP/early-access)_:
+    - Fixed citations navigating to '#' when in readonly mode
+    - Fixed citations inserting at the end of the field instead of where the cursor is
+
+## [0.12.7] - 2025-06-13
+
+### Fixed
+
+- `CitationField` _(WIP/early-access)_: Fixed the pop-up menu getting cut off after citation data finishes loading
+
+## [0.12.6] - 2025-06-12
+
+### Fixed
+
+- `CitationField` _(WIP/early-access)_:
+    - Fixed add/edit citation/attachment form enabling before save citation/attachment API call was completed
+    - Fixed errors being thrown unnecessarily. When the calling app throws an error during an API call, the library just needs to clean up any state but does not need to throw the same error.
+
+## [0.12.5] - 2025-06-11
+
+### Fixed
+
+- `CitationField` _(WIP/early-access)_:
+    - Simplify interface for uploading attachment
+    - File cannot be changed once uploaded (just title)
+
+## [0.12.4] - 2025-06-11
+
+### Fixed
+
+- `CitationField` _(WIP/early-access)_: Added missing validation for ensuring an attachment has a file selected.
+
+## [0.12.3] - 2025-06-11
+
+### Security
+
+- `CitationField` _(WIP/early-access)_: Removed hyperlinks in citation table to avoid users potentially opening malicious links
+
+## [0.12.2] - 2025-06-11
+
+### Fixed
+
+- `CitationField` _(WIP/early-access)_: Added prop for upload attachment via API call so that attachments can be stored.
+
+## [0.12.1] - 2025-06-11
+
+### Fixed
+
+- `CitationField` _(WIP/early-access)_: Clicking on a citation's title in the table (pop-up menu) will open the citation's url in a new tab.
+
+## [0.12.0] - 2025-06-11
+
+### Removed
+
+- `CitationField` _(WIP/early-access)_: Citations cannot be deleted.
+
+### Fixed
+
+- `CitationField` _(WIP/early-access)_: If the user backspaces on a citation, the whole citation will be deleted instead of previously allowing the user to change the citation superscript label outside of the pop-up menu, which can lead to mismatches between the superscript label and the actual citation's title.
+
+## [0.11.21] - 2025-06-10
+
+### Fixed
+
+- `CitationField` _(WIP/early-access)_: Citation table won't unnecessarily refresh if a citation could not be deleted.
+
+## [0.11.20] - 2025-06-10
+
+### Removed
+
+- `CitationField` _(WIP/early-access)_: Revert fix in 0.11.19 that prevents the user from deleting citations that are being referenced elsewhere, as this should be handled by the calling application via `onDelete`
+
+## [0.11.19] - 2025-06-09
+
+### Added
+
+- `CitationField` _(WIP/early-access)_: Show number of selected citation(s) on Select button
+
+### Fixed
+
+- `CitationField` _(WIP/early-access)_: Don't allow user to delete citations that are being referenced somewhere within the editor.
+
+## [0.11.18] - 2025-06-09
+
+### Fixed
+
+- `CitationField` _(WIP/early-access)_: Fetch data after delete
+
+## [0.11.16] - 2025-06-09
+
+### Fixed
+
+- `CitationField` _(WIP/early-access)_: Implemented deleting citations (added `onDeleteCitation` prop)
+
+## [0.11.15] - 2025-05-30
+
+### Fixed
+
+- `CitationField` _(WIP/early-access)_: Fixed Citation superscript not updating properly when user selects citations across different pages in the citations table.
+
+## [0.11.14] - 2025-05-30
+
+### Fixed
+
+- `CitationField` _(WIP/early-access)_: Fixed `fileName` not updating when file changed.
+
+## [0.11.13] - 2025-05-29
+
+### Fixed
+
+- `CitationField` _(WIP/early-access)_: Fixed hardcoded attachment file name when editing attachment.
+
+## [0.11.12] - 2025-05-29
+
+### Fixed
+
+- `CitationField` _(WIP/early-access)_: Fixed `onUpdateCitation` missing id.
+
+## [0.11.11] - 2025-05-28
+
+### Changed
+
+- `CitationField` _(WIP/early-access)_: Changed interface for `getCitationById` to only accept numeric id.
+
+## [0.11.10] - 2025-05-28
+
+### Fixed
+
+- `RadioGroup`, `CheckboxGroup`, `RangeSlider` - fixed auto-labeling (`label` will default to a readable/formatted version of `name`).
+
+## [0.11.9] - 2025-05-28
+
+### Added
+
+- All Modals: added `disableDismiss` prop, which when true, will disable the modal from being dismissed when the user clicks the backdrop or escape key. Recommended for modals with forms, to avoid users from losing their data by accidentally dismissing the modal.
+
+## [0.11.8] - 2025-05-27
+
+### Changed
+
+- `CitationField` _(WIP/early-access)_
+    - Minor tweaks to Citation object, renamed `filename` to `fileName`
+
+## [0.11.7] - 2025-05-27
+
+### Changed
+
+- `CitationField` _(WIP/early-access)_
+    - Minor tweaks to Citation object, renamed `type` to `classification`
+
+## [0.11.6] - 2025-05-27
+
+### Added
+
+- `Table`/`PaginatedTable`
+
+    - added `errorTableMsg` prop which, when defined, will show an error message in the table
+    - added `retryCallback` prop which, when defined AND `errorTableMsg` is defined, will display a "Retry?" button for the user to click to trigger a new API fetch.
+
+- `CitationField` _(WIP/early-access)_
+    - Updated Citation table to display an error message (with retry) when the fetch fails.
+
+## [0.11.5] - 2025-05-27
+
+### Changed
+
+- `CitationField` _(WIP/early-access)_
+    - Update `fetchExistingCitations` signature to `PageState` to account for different `PageRequest` definitions
+
+## [0.11.4] - 2025-05-27
+
+### Fixed
+
+- `CitationField` _(WIP/early-access)_
+    - Update `fetchExistingCitations` signature to include `PageRequest` so application can pass this to their API request
+
+## [0.11.3] - 2025-05-23
+
+### Fixed
+
+- `CitationField` _(WIP/early-access)_
+    - Page Size was displaying as 0 initially instead of 5
+    - Rows Per Page dropdown on Citations Table was appearing under the popup
+
+## [0.11.2] - 2025-05-23
+
+### Added
+
+- `CitationField` _(WIP/early-access)_
+    - Field will santitize itself when it does not contain content, so if the field only contains whitespace/newlines, it will update to `<p></p>`.
+
+## [0.11.1] - 2025-05-23
+
+### Added
+
+- `CitationField` _(WIP/early-access)_
+    - Added built-in error handling (Note: only error will show under field. Border will not turn red like other fields at the moment)
+    - Added `margin` prop that behaves like the other form fields
+
+## [0.11.0] - 2025-05-19
+
+IMPORTANT: I recommend removing `PageResponse` from your project's `index.d.ts` and using the one provided by this library instead.
+
+### Added
+
+- `CitationField` - _(WIP/early-access -- This is a complex field and will likely have some bugs -- use with caution)_ allows users to insert citations (links, web articles, attachments, etc)
+- `Checkbox` - added `onChange` listener
+- `Table`/`PaginatedTable` - added `x-small` value to `size` prop to reduce extra padding around the cells
+
+## [0.10.1] - 2025-05-15
+
+### Added
+
+- `Table`/`PaginatedTable` -- exposed MUI's table props
+
+## [0.10.0] - 2025-05-14
+
+### Changed
+
+- `DateField`/`DateRangeField`
+    - Updated field to always expect dates in UTC, instead of the user's timezone
+    - Updated the `onChange` so that the first parameter returns the Formik value (ISO date string, in UTC) instead of Dayjs obj
+
+### Removed
+
+- `DateField`/`DateRangeField` - removed `useIso` prop. **Migration: All DateField/DateRangeField components will be using ISO date strings by default, so this prop can be removed.** _(Rare: If any date fields weren't using the useIso prop before now, those fields will need to be converted to expect ISO date strings)_
+
+## [0.9.2] - 2025-05-06
+
+### Added
+
+- `Snackbar`
+    - added `autoHideDuration` prop so that the time before the snackbar disappears can be overridden. Default is still the original value: 8000ms.
+    - added `variant` prop to allow overriding style (same as `Alert`'s `variant`)
+    - added `elevation` prop to allow overriding elevation (Default is 6dp)
+
+### Changed
+
+- `Snackbar` **(Cosmetic)**
+    - Changed default styling to match the `Alert` component
+    - Changed `timeout` severity from `info` to `warning`
+- `DateField`/`DateRangeField` - (Internal) re-organized props to reduce duplicate code
+
+### Fixed
+
+- `DateField`/`DateRangeField` - Fixed issue where setting the `onChange` prop would cause Formik stop updating the field value.
+
+### Changed
+
+## [0.9.1] - 2025-05-05
+
+### Fixed
+
+- `Autocomplete`/`DynamicAutocomplete` - Fixed `disableClearable` displaying error `"Type 'true' is not assignable to type 'false'"`.
+
+## [0.9.0] - 2025-05-02
+
+### Changed
+
+- `PaginatedTable` - `alwaysShowPagination` was replaced with `hidePaginationControls`. **Migration:** if you have `alwaysShowPagination` on any of your tables, remove this prop. For all other paginated tables, consider setting `hidePaginationControls` but be very careful to ensure that the parent only sets this prop **on page load** to avoid the pagination controls disappearing when the user interacts with them (example, changing rows-per-page from 5 to 25 on a data set of 15). When in doubt, do not use `hidePaginationControls`.
+
+## [0.8.0] - 2025-05-02
+
+### Added
+
+- `Header`/`Footer`/`NavBar`/`Tabs`/`Drawer`/`MenuButton`/`ProfileMenu`: Added `externalLink` prop to `MenuOption` (formerly `NavigationItem`/`TabNavigationItem`) to allow navigation to external links. This prop cannot be defined at the same time as `path`. Similar to `path`, if `externalLink` is defined but NOT `onClick`, it will render as a link.
+
+### Changed
+
+- `Header`/`Footer`/`NavBar`/`Tabs`/`Drawer`/`MenuButton`/`ProfileMenu`: `NavigationItem` & `TabNavigationItem` have been replaced with `MenuOption`. Since `NavigationItem` does not necessarily always navigate (ex. changing a setting like toggling dark mode), it made more sense to rename it something more generic. All props of type `NavigationItem` have been renamed to match `MenuOption` to be consistent with the previous change. MIGRATION: Rename any varations of NavitationItem/navItem/etc to MenuOption.
+
+## [0.7.0] - 2025-05-01
+
+### Changed
+
+- `Header`/`NavBar`/`Tabs`: Internally updated MUI `TabIndicatorProps` to `slotProps.indicator` to resolve deprecation warning.
+- `Header`/`Footer`/`NavBar`/`Tabs`/`Drawer`/`MenuButton`/`ProfileMenu`: All `NavigationItem`/`TabNavigationItem`s that have `path` defined, but NOT `onClick` will be rendered as a link. Otherwise, if `onClick` is defined, it will behave as a button.
+
+### Removed
+
+- `Header`: Removed `useFloatingNavBar` prop
+- `Tabs`: Removed `onChange` as it wasn't being used
+- `Tabs`: Removed `TabNavigationItem.idx` as it wasn't being used
+- `Tabs`: Removed `TabNavigationItem.parentIdx` as it wasn't completely implemented
+
+## [0.6.4] - 2025-04-30
+
+### Fixed
+
+- `Select` - fixed field not spanning full width
+- `ConfirmationModal` - fixed unrecognized `testId` prop console error message
+
+## [0.6.3] - 2025-04-29
+
+### Fixed
+
+- `Table`/`PaginatedTable`: Overriding the background color or color of the Table row header via `theme.ts` should now work for the Table row header (use `MuiTableCell.styleOverrides.head`)
+
+## [0.6.2] - 2025-04-29
+
+### Added
+
+- All `Alert` components -- Added optional `title` prop that will add a stylized title, aligned with the alert icon.
+
+## [0.6.1] - 2025-04-28
+
+### Fixed
+
+- `PageHeader` -- Fixed console.warn
+
+### Changed
+
+- `PageHeader` -- added alert when `onAdd` is not implemented so that it's clear to users as well as developers
+
+## [0.6.0] - 2025-04-28
+
+### Removed
+
+- `PageHeader`: `onCreate` -- rename to `onAdd` instead
+
+## [0.5.14] - 2025-04-28
+
+### Changed
+
+- `PageHeader` -- `onCreate` is now optional
+
+### Fixed
+
+- `Table` -- `headerRowStyle` defaults to empty object instead of undefined
+
+## [0.5.13] - 2025-04-28
+
+### Fixed
+
+- `Autocomplete`, `MultiAutocomplete`, `DynamicAutocomplete`, `Location`: Updated these components to remove extra spacing below the field when in `readOnly` mode (placeholders for the `<Error />` components will not render when the fields are in `readOnly` mode)
+
+## [0.5.12] - 2025-04-28
+
+### Fixed
+
+- `Checkbox`, `CheckboxGroup`, `DateField`, `RadioGroup`, `RangeSlider`, `Select`, `Switch`, `TextField`: Updated these components to ignore spacing override by the parent (ex. `<Stack spacing={2} ...>` or `<Box display='flex' gap={2} ...>`) so that the spacing between the label/value/error always remains consistent. In other words, each field is treated as a single entity.
+
+## [0.5.11] - 2025-04-28
+
+### Added
+
+- `Footer`
+    - Added `sx` to allow more customization control, such as changing the background color
+    - Added `fontColor` to allow changing the color of the nav links & copyright (default is `'primary'`)
+
+### Changed
+
+- `Footer` - Made `featureNavLinks` optional
+
+## [0.5.10] - 2025-04-25
+
+### Changed
+
+- `Table`/`PaginatedTable`: Allow `data` to be undefined
+
+## [0.5.9] - 2025-04-24
+
+### Added
+
+- `Table`/`PaginatedTable`: Added `stickyHeader` prop to make the header row sticky
+
+## [0.5.8] - 2025-04-23
+
+### Added
+
+- `Autocomplete`/`DynamicAutocomplete`/`MultiAutocomplete`: Added elevation to the dropdown background (similar to `Select`)
+
+### Changed
+
+- `CheckboxGroup`/`RadioGroup`: Moved position of error message to under the checkboxes/radios
+- All text-based form fields (`Autocomplete`/`MultiAutocomplete`,`TextField`,`Select`,`Location`): Changed **default** margin to `dense` (reduced padding on top/bottom of the field)
+
+## [0.5.7] - 2025-04-23
+
+### Added
+
+- `Table`/`PaginatedTable`: added `headerRowStyle` to allow overriding of style of table header row
+
+## [0.5.6] - 2025-04-22
+
+### Fixed
+
+- All form fields: Error was not appearing under the field even though it existed in formik -- this can happen in niche situations where you are using an array object for a field, and want to show an error at the object-level (ex. `<Autocomplete name='phoneNumbers[0]' ...>` with formik error `phoneNumbers: [ 'A phone number is required']`).
+
+## [0.5.5] - 2025-04-18
+
+### Fixed
+
+- All form fields:
+    - [Cosmetic] Updated error message (for validation errors) to always take up space, even when not visible, to prevent the components from shifting up/down as validation error message appear/disappear
+    - [Cosmetic] Error icon for error message should be aligned more closely with the error message
+
+### Removed
+
+- All form fields:
+    - Removed Formik `status` from error message, so only the Formik error message will display.
+
+## [0.5.4] - 2025-04-15
+
+### Fixed
+
+- `DateField`: Removed a demo-only component from MUI that the component was using internally. This also fixes an alignment issue when the field is placed horizontally inline with other fields (previously, there was extra padding at the top).
+
+## [0.5.3] - 2025-04-15
+
+### Added
+
+- All Modals (`AlertModal`, `ConfirmationModal`, `DecisionModal`): All buttons now support additional customization options, like icons (`startIcon`/`endIcon`), states (`disabled`), etc.
+
+## [0.5.2] - 2025-04-15
+
+### Added
+
+- `ScrollToTop` -- FAB (Floating Action Button) that appears when the user scrolls down so that they can quickly scroll back to the top
+- `PageHeader`
+    - `title` can now be a ReactNode, in addition to string. When pass as a string, the default is to render as a h2 element. Otherwise if more control over style is needed, pass in a component instead.
+    - `sx` is now available to control the internal style. Classes have been added to internal elements to assist with this.
+
+### Fixed
+
+- `PageHeader` - spacing between title and button when children are present has been fixed
+
+## [0.5.1] - 2025-04-14
+
+### Added
+
+- Added props to `Switch`
+    - `activeValue`/`inactiveValue`: true/false by default, but alternatively you can specify strings here if you want Formik to use string values for the value of this field
+    - `onChange`: listen for changes to the user's selection
+    - `chipColor`: when defined, shows the switch as a chip with the specified color as the background
+    - `color`: text & switch color
+
+### Changed
+
+- `Switch`: now has a generic type for props. By default this is boolean, so no changes should be needed if migrating from older Mui Bueno versions.
+
+## [0.5.0] - 2025-04-14
+
+### Added
+
+- `DecisionModal`: New modal type for decisions (2 choices + cancel, like `ConfirmationModal` with an extra action button)
+- `AlertModal`/`ConfirmationModal`: Added `closeButtonPosition` prop that will define where the close button is located. `"bottom"` (default) renders on the bottom left, in-line with the action buttons. `"top"` will render as a close icon in the top-right, in-line with the title (`title` must be string). `"top-and-bottom"` is a combination of the two previous values.
+
+### Changed
+
+- `AlertModal`: Renamed `buttonProps` prop to `closeButtonProps`.
+- `AlertModal`/`ConfirmationModal`:
+    - Removed `label from `buttonProps`. Migration: use `closeBtnLabel`and/or`confirmBtnLabel` prop instead.
+- `ConfirmationModal`: Cancel button will now default to the bottom-left side. Actions will still appear on the bottom-right.
+
+### Removed
+
+- `AlertModal`/`ConfirmationModal`: Removed `content` prop. Migration: Use `children` instead.
+
+## [0.4.9] - 2025-04-11
+
+### Added
+
+- `RichTextField`: Added support for async-loaded content (listens for changes to the field's formik value and updates internal editor)
+
+## [0.4.7] - 2025-04-10
+
+### Added
+
+- `PaginatedTable`: Added optional property `rowsPerPageOptions` which is an array of numbers that will be the selections for page sizes.
+
+## [0.4.6] - 2025-04-07
+
+### Added
+
+- `Table` / `PaginatedTable`: Replaced `objKey` with a function called `getRowKey` to allow more fine-tuned changes.
+
+## [0.4.5] - 2025-04-07
+
+### Added
+
+- `Table` / `PaginatedTable`: Supports objects without an id: Must specifiy `objKey` prop with the name of the property that the table can use as the object's unique key. Default is `id`.
+
+## [0.4.4] - 2025-04-03
+
+### Added
+
+- `RichTextField`
+    - Added `Formik` integration. Currently just support for `value` but may add handling for validation in the future.
+
+### Fixed
+
+- `Table`: `TableColumn.fieldName` can now support nested properties.
+- Improved auto-labelling (components that automatically determine `label` based on `name` when `label` is not provided)
+
+## [0.4.3] - 2025-04-01
+
+### Added
+
+- `RichTextField`: added basic rich text field using [Mui Tip Tap](https://www.npmjs.com/package/mui-tiptap). _NOTE: Does not have Formik integration._
+
+## [0.4.2] - 2025-03-27
+
+### Added
+
+- `RepeatableFormGroup`: added `removePosition` prop to determine position of remove button. There are 2 built-in options "bottom" (default) and "right", but alternatively you can pass in `sx` (MUI style prop) to override the flexbox container settings.
+
+## [0.4.1] - 2025-03-26
+
+### Added
+
+- `RepeatableFormGroup`
+    - `label` provides a label for the whole group. Default will use `name` (internally converted from camel case to human-friendly)
+    - `labelProps` will allow you to override the default props (styling) of `label`
+    - `showDivider` when true, will display a simple horizontal divider between field groups
+
+### Changed
+
+- `RepeatableFormGroup` - when the field is empty and readonly, "None" will display as the value instead of nothing (this can be configured via `emptyListMsg` prop)
+
+## [0.4.0] - 2025-03-26
+
+### Changed
+
+- `MultiAutocomplete` - major refactor to resolve some issues, as well as update the interface to be similar to `Autocomplete` (for migrating, see `[0.3.0]` as the changes will be similar)
+
+## [0.3.5] - 2025-03-24
+
+### Added
+
+- `CheckboxGroup` - Added optional property `textField` to `CheckboxOption` that, when defined, will display a `TextField` next to the label.
+- `TextField` - Exposed MUI's `size` prop to allow overriding
+
+## [0.3.4] - 2025-03-21
+
+### Fixed
+
+- `Autocomplete` - Fixed readonly missing label when options is set dynamically
+
+## [0.3.3] - 2025-03-21
+
+### Fixed
+
+- `Autocomplete` - Fixed hidden initial value when both "readOnly" and "useFieldAsValue" are set
+
+## [0.3.2] - 2025-03-20
+
+### Fixed
+
+- `Autocomplete` - Fixed console log error "React does not recognize the `useFieldAsValue` prop"
+
+## [0.3.1] - 2025-03-20
+
+### Added
+
+- `Autocomplete` - Allow using property of a field (ex. id or code) for the formik value via `useFieldAsValue`
+
+## [0.3.0] - 2025-03-17
+
+### Added
+
+- `DynamicAutocomplete` - Fetches options as the user types. Useful if you don't want to load all of the options for the autocomplete at once.
+
+### Changed
+
+- `Autocomplete` - major refactor (recommend checking out Storybook for updated examples)
+
+    - No longer requires `AutocompleteOption` wrapper. To migrate, if you're using objects, make sure to override `getOptionLabel` and `isOptionEqualToValue`.
+    - `onChange` - added `event` param. To migrate, update your `onChange` signature: `(val: T | null)` --> `(event, val: T | null)`
+    - `inputValue` removed from available props since this will be handled by formik. To migrate, remove this prop and override `getOptionLabel` instead.
+    - Many `MUI` props are now overridable that weren't previously: `fullWidth`, `getLabelOption`, etc.
+    - Replaced `isEqual` with `isOptionEqualToValue` (MUI prop)
+
+- `AutocompleteOption` - moved to `@types` (may require import update, depending how you imported it)
+
+## [0.2.41] - 2025-03-13
+
+### Added
+
+- `RepeatableFormGroup` - Added `readOnly` prop to disable add/remove buttons
+
+## [0.2.40] - 2025-03-06
+
+### Added
+
+- `AlertModal`, `ConfirmationModal` - exposed MUI's dialog props (ex. `fullWidth`, `sx`, etc.) so that they can be passed to the internal `Dialog` component
+
+### Deprecated
+
+- `AlertModal`, `ConfirmationModal` - `content` is deprecated, use `children` instead
+
+## [0.2.39] - 2025-03-05
+
+### Fixed
+
+- `Autocomplete` - fixed an issue caused by 0.2.36 where having an initial value still wasn't being displayed once asynchronously fetched options were loaded in
+
+## [0.2.38] - 2025-03-05
+
+### Changed
+
+- `SingleActionCard`
+    - Added `sx` prop to allow overiddes to card styling
+    - Added classes to some of the components (`MBv2_SingleActionCard_Title`, `MBv2_SingleActionCard_Img`, `MBv2_SingleActionCard_ActionButton`) to assist with overriding style
+    - Tweaked default styling of the card
+
+## [0.2.37] - 2025-03-04
+
+### Fixed
+
+- `Table`/`PaginatedTable`
+
+    - fixed row/card not highlighting on hover (when `onRowClick` is defined)
+    - fixed mobile card not showing pointer-style cursor on hover (when `onRowClick` is defined)
+
+- `DateField`/`DateRangeField` - added `staticLabel`/`staticLabels` prop to match similar-styled fields
+- `Select` - fixed floating label getting blocked by field outline when `label` was not provided
+
+## [0.2.36] - 2025-02-28
+
+### Fixed
+
+- `Autocomplete`/`MultiAutocomplete` - fixed issue where async/dynamically-loaded options were preventing the user from changing the input after selecting an option from the dropdown
+
+## [0.2.35] - 2025-02-27
+
+### Fixed
+
+- `Autocomplete` - fixed `onInputChange` not being called when the prop is defined
+
+## [0.2.34] - 2025-02-27
+
+### Changed
+
+- `PageHeader` - changed the type of the button from type "submit" to "button"
+
+## [0.2.33] - 2025-02-20
+
+### Fixed
+
+- `Error`: All form components were previously not displaying error messages for nested objects.
+
+## [0.2.32] - 2025-02-20
+
+### Added
+
+- `Autocomplete`: Added `clearOnSelect` prop which, when true, will clear the field when the user selects an option from the dropdown
+
+## [0.2.31] - 2025-02-18
+
+### Added
+
+- `Tabs`: Navigation tabs. Previosuly only accessible via `NavBar`/`SideBar` but can be used separately now.
+- Added `staticLabelProps` to the following components to match other form components that already had this prop:
+    - `Checkbox`/`CheckboxGroup`
+    - `DateField`/`DateRangeField`
+    - `FileUpload`
+    - `RadioGroup`
+    - `RangeSlider`
+    - `Switch`
+
+### Changed
+
+- Modified the default style settings for the static label (`staticLabel` or `readOnly` is true) to make it easier for users to differentiate between the label and value for the following components:
+
+    - `Autocomplete`/`MultiAutocomplete`
+    - `Location`
+    - `Select`
+    - `TextField`
+
+### Deprecated
+
+- `FloatingNavBar` - Suggested migration: switch to `NavBar`
+
+## [0.2.30] - 2025-02-12
+
+### Added
+
+- `Drawer`: Mobile drawer. Renders as hamburger icon that, when clicked, toggles a side menu on the right side of the screen. Previously only accessibly via `Header` but now you can use it by itself for use with custom headers.
+- `Table`: Added optional `sortName` field to `TableColumn` to allow overriding the `fieldName` that gets passed to `onSortChange`
+
+### Changed
+
+- `PaginatedTable`
+    - Replaced `hideUnusedPagination` prop with `alwaysShowPagination`. To migrate:
+        - If you are currently using `hideUnusedPagination`, remove this prop.
+        - If you are NOT currently using `hideUnusedPagination`, add `alwaysShowPagination`.
+
+### Deprecated
+
+- `Header`: `useFloatingNavbar` prop. May refactor this or completely remove it, as it weighs down maintenance of the Header component.
+
+## [0.2.29] - 2025-02-07
+
+### Added
+
+- `Autocomplete`/`MultiAutocomplete`: Added `onInputChange` to track when user types and/or selects an option from the dropdown
+
+## [0.2.28] - 2025-02-06
+
+### Fixed
+
+- `Table`/`PaginatedTable`: Fixed `highlightSelectedRow` not unhighlighting when collapsing row (`renderExpand`)
+- `RadioGroup`: Add `onChange`
+
+### Changed
+
+- Alerts (`SuccessAlert`, `InfoAlert`, `WarningAlert`, `ErrorAlert`): Made `leftBorder` the default variant.
+
+## [0.2.27] - 2025-02-04
+
+### Fixed
+
+- `Autocomplete`/`MultiAutocomplete`: Fixed `onChange` throwing null exception when clearing field.
+
+## [0.2.26] - 2025-02-04
+
+### Fixed
+
+- `Autocomplete`/`MultiAutocomplete`: Fixed `onChange` called unnecessarily. Now it should only be called ONCE each time the user changes the value of the field.
+
+## [0.2.25] - 2025-02-03
+
+### Added
+
+- `RepeatableFormGroup` - Added a new component that handles arrays in forms using formik. Use to handle repeated sections of forms that need to be dynamically added/removed.
+- Alerts (`SuccessAlert`, `InfoAlert`, `WarningAlert`, `ErrorAlert`)
+- `AlertModal` - Informational modal intended for blocking the user to relay important information.
+
+### Changed
+
+- `ConfirmationModal`
+    - `ConfirmationModalButtonProps` replaced with `ModalButtonProps`
+    - `title` & `content` props - updated type to `ReactNode` to allow for custom title/content
+    - default styling changes - cancel button variant defaults to `text` instead of `contained`, & default color changed to primary
+    - swapped order of `confirm` & `cancel` buttons since neutral/cancel action should always be on the left and modifying actions should always be on the right
+
+## [0.2.24] - 2024-01-27
+
+### Added
+
+- `DarkModeToggle`: New component represeting a button for toggling between light and dark mode
+- `Table`/`PaginatedTable`
+    - Added `renderExpand` prop. When the user clicks on a row, the row will expand (like an accordion) with the component returned by `renderExpand` as content. When used with `stackOnMobile`, the card will expand when clicked.
+    - Added `highlightSelectedRow` prop. When true, the row clicked on the user will be highlighted using a light gray by default. Pass in a string (color) to this prop to override the default gray color.
+
+### Changed
+
+- `Table`/`PaginatedTable`
+    - Table will automatically render as a list of cards on mobile. `stackWhenMobile` has been replaced with `disableMobileCards`, which acts as the opposite, so you only need to add the `disableMobileCards` prop when you want `Table`/`PaginatedTable` to render as a table, instead of cards, on mobile/small screens.
+    - Renamed `onSelect` to `onRowClick` to be more precise
+- `Header`: Light/Dark Mode toggle will display differently depending on certain factors. On mobile/small screens, the toggle will appear in the hamburger drawer menu. Otherwise, it will appear directly on the header when the user is logged out (`displayName` is undefined), or in the user's profile menu when the user is logged in (`displayName` is defined).
+
+### Fixed
+
+- `Header`: Fixed dividers appearing in mobile drawer when they were not needed (quickLinks and/or userNavItems were empty)
+
+## [0.2.23] - 2025-01-22
+
+### Fixed
+
+- `Select`: `Option` is now being exported so that developers can import it in their projects. Also renamed it to `SelectOption` so it would not be confused with `AutocompleteOption`.
+
+## [0.2.22] - 2025-01-15
+
+### Added
+
+- `Header`
+    - `children`: This prop allows you to define child components. They will be rendered in between `quickLinks` and the user profile dropdown.
+    - `sx` & `navBarSx`: These props allow you to override styling for the `Header` & `NavBar` respectively.
+    - `useFloatingNavBar`: Set to `true` to use the alternative "floating" navbar style.
+- `MenuButton`: New dropdown button component. Generic version of `ProfileMenu`.
+- `NavBar`: Navigation component. Previously this component was only accessible via `Header` but now you can use it directly.
+- `FloatingNavBar`: Alternative style of navigation component. Same behavior as `NavBar`, just a different appearance.
+- `Tabs`: Added `sx` prop to allow you to override styling.
+
+### Changed
+
+- `PageHeader`
+    - Right-align add button when no children are present
+
+## [0.2.21] - 2025-01-11
+
+### Changed
+
+- `Sidebar`: Simplified interface.
+    - Removed `featureNavItems`, `primaryIdx` & `secondaryIdx` as there was too much logic that needed to be passed to this component. Instead, these have been replaced with the `navItems: NavigationItem[]` prop which will display the provided nav items and mark the active one automatically based on the current path.
+    - Replaced `padding` with `sx` to provide more customization power.
+
+## [0.2.20] - 2025-01-10
+
+### Added
+
+- `Header`/`Tabs`/`Sidebar`/`ProfileMenu`: Added optional icons to `NavigationItem` type so these components will display icons, when provided, with the navigation labels.
+
+### Fixed
+
+- `Header`: Fixed spacing of `quickLinks` in header.
+
+### Changed
+
+- `Header`:
+    - Rename `actionNavItems` to `userNavItems` to make it clear that these nav items only appear for logged in users.
+    - Mobile drawer menu layout has been updated to be a bit more organized: Feature nav items, quick links, and user nav items are displayed (in that order) as groups separated by a divider. Additionally, menu items will now change color when hovered, providing a clear visual indication of hover state.
+    - `featureNavItems` & `userNavItems` are now optional
+    - Replaced `QuickLink` type with `NavigationItem`. If you are using `quickLinks`, make sure to change the type of the array you are passing in to `NavigationItem[]`.
+- `SideBar`: changed type of `featureNavItems` from `NavigationItem[]` to `SidebarNavItem[]` since `subItems` was removed from `NavigationItem` (see `Removed` section for more on this change)
+
+### Removed
+
+- `Header`: Removed `primaryIdx`/`secondaryIdx` props in favor of having the Header component automatically marking the active tab
+- `Header`/`Footer`/`ProfileMenu`/`Tabs`: removed `subItems` from `NavigationItem` because they were not being used consistently. Most of these components were completely ignoring `subItems` or only diplaying them on specific screen sizes.
+
+## [0.2.19] - 2025-01-07
+
+### Security
+
+- Updated library dependencies to latest compatible versions
+
+### Fixed
+
+- `Autocomplete` / `MultiAutocomplete`
+    - Fixed bug where `useState` was getting called to many times unnecessarily, resulting in a "Maximum update depth exceeded." error.
+    - Removed `freeSolo` prop because Formik isn't set up to allow free text for the component currently
+
+## [0.2.18] - 2025-01-02
+
+### Changed
+
+- `Table` / `PaginatedTable` : Added built-in loading indicator
+- `Header`: Replaced `children` with `quickLinks` & `displayName`. Previously, content rendered via `children` was only visible on tablet-sized screens or larger. Now, `quickLinks` allow links to be displayed directly in the header on tablet-sized screens or larger, or in the hamburger menu drawer on mobile screens, and `ProfileMenu` is now built-in which will render the user profile button when `displayName` is defined on tablet-sized screens or larger, or in the hamburger menu drawer on mobile screens.
+
+## [0.2.17] - 2024-12-16
+
+### Added
+
+- `TextField`: Automatically trims leading & trailing whitespace on blur. To disable this, added optional `noTrimOnBlur` prop.
+
+### Fixed
+
+- `Breadcrumb`: Last breadcrumb should not display as a link.
+
+## [0.2.16] - 2024-12-12
+
+### Added
+
+- `PaginatedTable`: Added optional prop that will hide pagination if it's not needed (total # of items <= Rows per Page)
+- `PaginatedTable`/`Table`: Added support for table columns that use the same `fieldName` via optional `key` field in `TableColumn` to ensure the keys used internally in the table itself are always unique
+
+## [0.2.15] - 2024-12-11
+
+### Fixed
+
+- `Autocomplete`/`MultiAutocomplete`: Fixed setting initial value for Autocomplete that uses objects as the value
+
+## [0.2.14] - 2024-12-10
+
+### Added
+
+- `Table`/`PaginatedTable`: Added customizable message when table is empty. Default is "No items to display".
+
+### Fixed
+
+- `Autocomplete`: Fixed clear button not clearing the field
+
+## [0.2.13] - 2024-11-25
+
+### Added
+
+- `Table`/`PaginatedTable`: Added `allowSortCols` prop to designate which columns are sortable (default is all).
+
+## [0.2.11] - 2024-11-25
+
+### Fixed
+
+- Expose `MultiAutocomplete` to consuming app
+
+## [0.2.10] - 2024-11-22
+
+### Changed
+
+- Removed `multiple` prop from `AutoComplete` in lieu of a separate `MultiAutocomplete` component.
+
+### Added
+
+- `Autocomplete`: Added optional `onChange` handler prop.
+
+## [0.2.9] - 2024-11-21
+
+### Fixed
+
+- `DateField`: Fixed empty string initial value showing invalid date error (when `useIso` is true).
+
+## [0.2.8] - 2024-11-20
+
+### Added
+
+- `DateField`: Added `useIso` prop that will use ISO string for Formik value instead of Dayjs obj when true.
+
+## [0.2.7] - 2024-11-19
+
+### Added
+
+- `Header`
+    - Added ability to add custom banners (beyond the environment banner).
+    - Exposed `position` attribute for underlying Material AppBar
+
+### Fixed
+
+- `Header`: Environment banner was still displaying when the prop was undefined.
+
+## [0.2.6] - 2024-11-18
+
+### Added
+
+- `Table`: Added ability to access the whole (row) object from the render method. This is useful if styling a column depends on another value in the row.
+
+## [0.2.5] - 2024-11-15
+
+### Added
+
+- `Table`
+    - Added more classes to various internal elements to simplify overriding styles
+    - Added `className` prop which applies classes to top-level component
+
+### Changed
+
+- `Table`: Replaced `tableLayout` with `fixedLayout`. If not set, the table layout will be `auto`. If true, the columns will all be the same width. If set to an array of widths, the columns will be the widths defined by the array.
+
+### Fixed
+
+- `Table`
+    - `id` wasn't being set on the internal component. NOTE: the actual ID assigned to the table will be `table-{id}` (or `mobile-table-{id}` for the stack layout when `stackWhenMobile` is true)
+    - Resolved column labels breaking (changed word-break settings)
+
+## [0.2.4] - 2024-11-14
+
+### Added
+
+- `Table`/`PaginatedTable`
+    - `tableLayout` prop is available to override the layout of the table. Default is `'auto'`.
+    - Added `className` props to various internal elements to simplify overriding styles
+
+### Changed
+
+- `Table`/`PaginatedTable`: `onSelect` prop is now optional
+
+### Removed
+
+- `Table`/`PaginatedTable`: `canSort` prop has been removed due to redundancy. Instead, use the `onSortChange` prop to enable sorting for the component.
+
+### Fixed
+
+- `Table`
+    - Divider, which is used to separate the sorting functionality from the data, will only display if the table is sortable.
+    - Improved internal usage of keys to follow best practices (i.e. keys no longer use indexes)
+
+## [0.2.3] - 2014-11-12
+
+### Fixed
+
+- Missing type declarations (`TableColumn`, `SortOrder`, etc.)
+
+## [0.2.2] - 2014-11-08
+
+### Changed
+
+- `Footer`: Added `className` props to various elements (will do more components in the future if this change proves helpful with overriding styles)
+
+### Fixed
+
+- `Footer`: Removed built-in color adjustment for logo when switching between light/dark mode because it doesn't work with full-color logos
+- `Header`: Fixed horizontal alignment of children of Header with Dark mode toggle button
+- `PaginatedTable`: Fixed not being able to use `render` method (as with `Table`)
+
+## [0.2.1] - 2024-11-07
+
+### Added
+
+- `Table`: Added `render` method to `TableColumn` to provide more control over how data is displayed
+    - `TableColumn`: Made `label` optional. If not provided, it will be automatically generated from the `fieldName`
+
+### Changed
+
+- `Select`: `label` prop is now optional (automatically generated from `name`)
+- `Header`: Renamed `userProfile` prop to `children`
+- `Header` & `Footer`: `logo` prop updated to allow `ReactNode`, in addition to `string` (image)
+- `Footer`: `copyright` prop is now optional
+
+### Fixed
+
+- `TextField`: Removed hardcoded margin that was causing vertical misalignment with other components
+
+## [0.2.0] - 2024-11-04
+
+### Added
+
+- Components
+    - Forms
+        - Inputs
+            - DateField
+            - DateRangeField
+
+### Changed
+
+- Renamed Components
+    - BAutocomplete --> Autocomplete
+    - BCheckbox --> Checkbox
+    - BCheckboxGroup --> CheckboxGroup
+    - BLocation --> Location
+    - BFileUpload --> FileUpload
+        - BFileList --> FileList
+    - BRadioGroup --> RadioGroup
+    - BSelect --> Select
+        - BOption --> Option
+    - BSwitch --> Switch
+    - BTextField --> TextField
+    - BError --> Error
+    - BButton --> Button
+    - BSubmit --> Submit
+    - BStepper --> Stepper
+    - BFormDebugger --> FormDebugger
+
+## [0.1.1] - 2024-10-25
+
+### Added
+
+- Components:
+    - Breadcrumbs
+    - Forms
+        - Inputs
+            - SearchField
+    - LoadingIndicator
+    - Modals
+        - ConfirmationModal
+    - Navigation
+        - Header
+        - Footer
+        - Sidebar
+        - Tabs
+    - PageHeader
+    - SingleActionCard
+    - Table
+        - Table
+        - PaginatedTable
+    - Snackbar
+
+### Changed
+
+- Moved around some folders now that this library has been expanded to more than just form components
+    - Moved BFileList to Inputs/BFileUpload/BFileList since this is meant to be used with the Drag-and-drop File Upload component
+    - Moved BError, BStepper, BFormDebugger, and Inputs to Form so that all of the form components are grouped together in the same folder
+
+## [0.0.0] - 2024-09-20
+
+### Added
+
+- Components:
+    - Buttons
+        - BButton
+        - BSubmit
+    - Inputs
+        - BAutocomplete
+        - BCheckbox
+        - BCheckboxGroup
+        - BFileUPload
+        - BLocation
+        - BRadioGroup
+        - BRangeSlider
+        - BSelect
+        - BSwitch
+        - BTextField
+    - BError
+    - BFormDebugger
+    - BStepper