@persona/design-system 0.1.6 → 0.1.8

package/CHANGELOG.md

@@ -2,55 +2,98 @@
 
 Summary of changes to the @persona/design-system package.
 
+## [0.1.8] - 2026-08-05
+
+- **2026-08-05**: Added an opt-in `singleUseFields` prop to FiltersV2 `FilterBar` that drops already-filtered fields from the Add-filter picker and hides the picker trigger once every field is used
+- **2026-08-04**: Reworked FiltersV2 state so a pill picked but not yet valued is held out of the reported state instead of being inferred from `value == null`: `useFilterStateV2` now returns `committedState` and `setCompound`, `setState` is a true whole-state replacement again, rule ids are UUIDs so they survive URL/saved-view round-trips, and held pills keep their row position through hydration
+- **2026-08-04**: Bound Downshift's input and dropdown props to the in-dropdown search input of an embedded multi-select Combobox, which is the only input that mode renders, restoring keyboard selection there
+- **2026-08-04**: Widened the `react-router-dom` peer range to allow v7 alongside v6
+- **2026-07-30**: Renamed the in-place Breadcrumb callback from `onNavigate` to `onClick`
+- **2026-07-30**: Added in-place Breadcrumb navigation (callback instead of href) and a configurable heading level
+- **2026-07-29**: Added `portalContainer` to Select and `menuPortalContainer` to Pagination so the page-size menu can portal into a dialog container instead of `document.body`, fixing the menu being clipped or dismissing the dialog on click
+- **2026-07-29**: Made FiltersV2 honor a field's `allowedOperators` everywhere operators are resolved — picker, advanced rows, defaults, reconciliation, and hydration validation
+- **2026-07-29**: Added breadcrumbs support to PageHeader
+- **2026-07-28**: Drove the StatusIndicator pill height from padding alone instead of a fixed height
+- **2026-07-28**: Added `truncate` and `preserveCase` props to StatusIndicator
+- **2026-07-27**: Added a `status` prop to StatusIndicator for the standard status palette
+- **2026-07-24**: Updated SegmentedControl visual styling
+- **2026-07-24**: Nested hash subfields under their parent in the FiltersV2 field picker and added an optional `description` sublabel to nested Combobox option groups
+- **2026-07-23**: Moved the layout loading shimmer into the package as `layouts/LayoutLoadingShimmer`
+- **2026-07-22**: Moved FiltersV2 into the package — `FilterBar`, `FieldRegistry`/`buildFieldRegistry`, `useFilterStateV2`, the type-aware value controls, the operator helpers, and the state types are now exported from `components/DataTable/TableControls`
+- **2026-07-21**: Moved LogicRow into ListBox and exported it
+- **2026-07-20**: Added an optional action button at the end of the Combobox options list
+
+## [0.1.7] - 2026-07-22
+
+- **2026-07-21**: Applied Typography styling to Pagination text
+- **2026-07-21**: Hid the TableBox delete icon while an input in the last column has focus, preventing it from obscuring the field
+- **2026-07-21**: Fixed Combobox multi-select crashing on input blur by avoiding access to state before initialization
+- **2026-07-21**: Added grouped options support to Combobox single-selects
+- **2026-07-20**: Vertically centered Badge content in TabBar tabs
+- **2026-07-20**: Added grouped TableBox row actions, including FormField configuration and stories
+- **2026-07-18**: Replaced design-token imports with the published `@persona/design-tokens` package paths
+- **2026-07-18**: Corrected LoadingShimmer Storybook titles
+- **2026-07-17**: Made TableBox empty-state stories interactive
+- **2026-07-17**: Closed ListBox and TableBox action menus after selecting an action
+- **2026-07-17**: Enabled DateRangePicker popovers to render correctly inside modals
+- **2026-07-17**: Clarified TableBox empty-state stories
+- **2026-07-17**: Added the missing `onDisplayedRowIdsChange` callback to DataTable stories
+- **2026-07-17**: Removed locally emptied TableBox rows
+- **2026-07-16**: Added actionable TableBox empty states
+- **2026-07-16**: Added TableBox cell and row error states with delayed inline-edit validation
+- **2026-07-14**: Made Modal layouts align with share-token dialogs
+- **2026-07-13**: Bumped TypeScript to v7 in the package toolchain
+- **2026-07-06**: Added Breadcrumb and Breadcrumbs components with keyboard, overflow, and accessibility support
+
 ## [0.1.6] - 2026-07-16
 
-- **2026-07-16**: Promoted the DataTable component into the design system — the full table renderer (`DataTable`, `DataTableContainer`, `DataTableControls`, `FloatingActionBarContainer` exports) — and added a `HoverCopyableField` component that reveals a copy-to-clipboard affordance on hover ([787bd8d](https://github.com/persona-id/persona-web/commit/787bd8d330a13206b3dccb66c8372782894c02aa))
-- **2026-07-15**: Fixed MiddleTruncatedText to tolerate a 1px sub-pixel width mismatch in `findMiddleTruncatedTextForWidth`, so canvas-measured widths a fraction over the integer clientWidth no longer spuriously middle-truncate shrink-wrapped stickers ([8ff98bc](https://github.com/persona-id/persona-web/commit/8ff98bcfd15370b6cf54695ddb82df31d562ea71))
-- **2026-07-15**: Removed the design-system component registration layer (lib/register: RegisterComponent API, ids, types) and its PDSProvider wiring ([8be10bc](https://github.com/persona-id/persona-web/commit/8be10bc928616bfdfaa0ae535bfaf50ac04a9cc7))
-- **2026-07-15**: Added TableControls component (accepts a filterPanel ReactNode) to DataTable, extracting the filter-agnostic layout into PDS ([5c38c3c](https://github.com/persona-id/persona-web/commit/5c38c3c00f7def46b75d305b5cea395d8a1ddaf9))
-- **2026-07-15**: Added filterPanel prop to ControlBar/CompactBar so filters render below the controls row instead of inline ([f52ab85](https://github.com/persona-id/persona-web/commit/f52ab8512c10337ccfcbe80ce06e23ad171eb2f5))
-- **2026-07-15**: Replaced compile-time JSX css props with styled-components/standard style props across published components (Modal, DatePicker, SwatchPicker, CardV2 SectionHeading, Table, TableControls) and added a build assert + eslint rule so published output works without consumer Babel config ([e66793f](https://github.com/persona-id/persona-web/commit/e66793f452f71f26e0cdac0b683226e6650fba53))
-- **2026-07-15**: Fixed TechnicalSticker copy-timer ref type by calling the global setTimeout to keep ref/return types consistent under the repo tsconfig ([6066525](https://github.com/persona-id/persona-web/commit/60665252b463ae11c59b47fa0901d06a24de2771))
-- **2026-07-15**: Changed CardV2 SectionHeading to default to semantic h* heading tags ([808ca90](https://github.com/persona-id/persona-web/commit/808ca902d6b0f582f201230f5f09f1d06f3867ca))
-- **2026-07-15**: Added copyValue prop to TechnicalSticker to copy a different value than the displayed children ([223f37c](https://github.com/persona-id/persona-web/commit/223f37cf8806ee21091a35804c510a40c2d3261d))
-- **2026-07-15**: Marked package as side-effect-free (sideEffects: false) for tree-shaking and added an import/no-unassigned-import lint guard on published source ([a7193b0](https://github.com/persona-id/persona-web/commit/a7193b009be7f03ec4902b1c0ee28aeca582d222))
-- **2026-07-14**: Moved TableBox (with subcomponents, hooks, specs) and TableBoxField into PDS as new components/TableBox and FormField exports, added useScrollOverflow/zindex lib exports, and declared @dnd-kit deps ([aa94149](https://github.com/persona-id/persona-web/commit/aa941492a469bfbabc01570932c2d42b8f09888a))
-- **2026-07-14**: Switched DataTable internal imports from the @persona-id/design-system alias to relative design-system paths to fix package resolution ([8944a55](https://github.com/persona-id/persona-web/commit/8944a55716a4e987afbfc2e7c1058f31026904b3))
-- **2026-07-14**: Extracted MessageType enum into a standalone lib/message module (re-exported from Toast) so it can be imported without Toast's dependencies ([68af837](https://github.com/persona-id/persona-web/commit/68af837b849804d16e9a2d3e1e195b3188365aeb))
-- **2026-07-14**: Added GlobalStyles export to PDS lib for external consumers ([4958bf3](https://github.com/persona-id/persona-web/commit/4958bf3145f74f6a6777af980ad4a075719bb7c6))
-- **2026-07-14**: Refined TechnicalSticker interactions: overlaid copy action, centered technical text, non-selectable truncated labels, exact width prop, webfont-aware truncation remeasurement, and synchronized retained copy-action backgrounds ([02857d2](https://github.com/persona-id/persona-web/commit/02857d2f49aa1ea87ea679e930aa6070b5475dc0))
-- **2026-07-14**: Fixed MiddleTruncatedText to merge caller inline styles without overriding the max-width used for truncation measurement ([20bdb9e](https://github.com/persona-id/persona-web/commit/20bdb9ef00fa71ded6da64ee411b0d948137fdf1))
-- **2026-07-14**: Set box-sizing: border-box on Table TableCell/TableHeaderCell so cell heights stay correct in reset-free contexts (no-op where a global reset exists) ([48d81be](https://github.com/persona-id/persona-web/commit/48d81be524117fef3c2c758961517390c4e8f6a3))
-- **2026-07-14**: Added spreadsheet-style keyboard navigation to TableBoxField inline editors: cell-to-cell arrow movement, Enter-to-create, and guarded deletion of blank rows ([d26624b](https://github.com/persona-id/persona-web/commit/d26624b3579d24421812f0c61c81f08464dd623f))
-- **2026-07-14**: Added TechnicalSticker component with middle truncation, copy-to-clipboard affordance, token-aligned width measurement, and accessible full-text preservation (plus MiddleTruncatedText and copyTextToClipboard lib helpers) ([653f442](https://github.com/persona-id/persona-web/commit/653f442d47288478c324ae895cde5a34018efc7b))
-- **2026-07-13**: Moved useTableColumns and checkbox render helpers into DataTable with a RenderFormatFn injection point to remove the dashboard-format dependency ([342c8a1](https://github.com/persona-id/persona-web/commit/342c8a19d63256cb0089ab005f741e16a4e1cb05))
-- **2026-07-13**: Moved TableControlsContext into DataTable with generalized generic types (BaseFilterConfig, BaseActiveFilter) and converted internal imports to relative paths ([4c21d8b](https://github.com/persona-id/persona-web/commit/4c21d8ba96040c08036785bca15ec40b6e0c0432))
-- **2026-07-13**: Added generic DataTable types (RowAction, SortProps, column format base types, DataTableVariables, ColumnConfig) to PDS and declared @tanstack/react-table as a peer dependency ([3d64b70](https://github.com/persona-id/persona-web/commit/3d64b7071cb02445e708ba19ee7d17e520e63592))
-- **2026-07-13**: Co-located PaginationParams type and MIN_PAGE_SIZE constant in the Pagination component so it is self-contained (no dashboard imports) ([69c9740](https://github.com/persona-id/persona-web/commit/69c97408a0227fc21bd3d53265eee64979a7907e))
-- **2026-07-13**: Fixed embedded single-select Combobox to keep the search input empty on open instead of prefilling the selected label ([78c25ef](https://github.com/persona-id/persona-web/commit/78c25efd0c33c48e3c35a358832ff935bf3785c1))
-- **2026-07-13**: Fixed portaled multi-select Combobox to retain focus while searching by marking the portal data-react-aria-top-layer and keying blur/outside-click to the portal id ([5de9fa0](https://github.com/persona-id/persona-web/commit/5de9fa0041b30b7ab991e16ba50bd22fafcb0839))
-- **2026-07-10**: Moved Inserter component (with spec/stories) into DataTable, using PDSProvider test utilities ([f529ae7](https://github.com/persona-id/persona-web/commit/f529ae7a94f925e12c8dfa7d18657264ad861043))
-- **2026-07-10**: Moved FloatingActionBar component into DataTable ([5c29695](https://github.com/persona-id/persona-web/commit/5c29695965c0c706609b4a9774b2b7059aa052a3))
-- **2026-07-10**: Moved DataTable constants into PDS ([02ddd6e](https://github.com/persona-id/persona-web/commit/02ddd6ebb256cd6139349da2bbf430061d6b85dd))
-- **2026-07-09**: Moved TableViewConfigurationDropdown into DataTable, added @hello-pangea/dnd dependency, and introduced a local AttributeColumn type ([8beceb7](https://github.com/persona-id/persona-web/commit/8beceb7a28ffe36b1e23c99377c7a3c6c13d7fff))
-- **2026-07-09**: Added SearchInput (debounced state, clear icon, disabled tooltip, flattened display variants) and its FormControlLabel dependency to DataTable ([6d14b07](https://github.com/persona-id/persona-web/commit/6d14b077da6c272bce50c8be9144b1c836f84a57))
-- **2026-07-09**: Added drag-and-drop utilities to DataTable (StyledIconDrag component and reorder utility) ([30935fa](https://github.com/persona-id/persona-web/commit/30935fa9020c6a351e1b34cdd135cb81f75afdb1))
-- **2026-07-09**: Added ControlBar and CompactBar table-control components to DataTable, supporting saved views with tab overflow, bulk actions, search, filters, and a compact variant ([3496db9](https://github.com/persona-id/persona-web/commit/3496db901a3d2133cb4950fc12598eaf48a9d1b6))
-- **2026-07-09**: Corrected inlined vs external dependencies in package.json and tsdown config ([15e4b14](https://github.com/persona-id/persona-web/commit/15e4b14e4b907931befea5d54e22f8aee20309b8))
-- **2026-07-09**: Added public NPM publishing support (release scripts, prepare.mjs, publish-files README) ([a86f4ee](https://github.com/persona-id/persona-web/commit/a86f4ee7c789bd2461752f8b66f385520c50e2a5))
-- **2026-07-07**: Moved TableLayout component and table primitives (TableCell, TableRow, TableTH) into the Table component directory ([8758805](https://github.com/persona-id/persona-web/commit/87588050de7b1fbfb151540a0eb2d91f1d809b42))
-- **2026-07-07**: Moved Pii component into the design system ([14132ca](https://github.com/persona-id/persona-web/commit/14132caf7b20379517cb13ee03d47dcb471ed05e))
-- **2026-07-06**: Moved Pagination, PageSelector, PageSizeSelector, and pagination constants into PDS and replaced a SPACINGS.base usage with the design-tokens Spacing[1] equivalent ([964631f](https://github.com/persona-id/persona-web/commit/964631f7c314f412cd661c7df4382808494cc104))
-- **2026-07-06**: Changed Tooltip default delayDuration from 0ms to 300ms ([0d95f68](https://github.com/persona-id/persona-web/commit/0d95f680858d18780bb90c2dbf6af2efecefecb5))
-- **2026-07-02**: Fixed multi-select Combobox to keep option order stable while toggling selections ([632a5804](https://github.com/persona-id/persona-web/commit/632a5804be46ad2327e4b69da9408a846d06cd1e))
+- **2026-07-16**: Promoted the DataTable component into the design system — the full table renderer (`DataTable`, `DataTableContainer`, `DataTableControls`, `FloatingActionBarContainer` exports) — and added a `HoverCopyableField` component that reveals a copy-to-clipboard affordance on hover
+- **2026-07-15**: Fixed MiddleTruncatedText to tolerate a 1px sub-pixel width mismatch in `findMiddleTruncatedTextForWidth`, so canvas-measured widths a fraction over the integer clientWidth no longer spuriously middle-truncate shrink-wrapped stickers
+- **2026-07-15**: Removed the design-system component registration layer (lib/register: RegisterComponent API, ids, types) and its PDSProvider wiring
+- **2026-07-15**: Added TableControls component (accepts a filterPanel ReactNode) to DataTable, extracting the filter-agnostic layout into PDS
+- **2026-07-15**: Added filterPanel prop to ControlBar/CompactBar so filters render below the controls row instead of inline
+- **2026-07-15**: Replaced compile-time JSX css props with styled-components/standard style props across published components (Modal, DatePicker, SwatchPicker, CardV2 SectionHeading, Table, TableControls) and added a build assert + eslint rule so published output works without consumer Babel config
+- **2026-07-15**: Fixed TechnicalSticker copy-timer ref type by calling the global setTimeout to keep ref/return types consistent under the repo tsconfig
+- **2026-07-15**: Changed CardV2 SectionHeading to default to semantic h\* heading tags
+- **2026-07-15**: Added copyValue prop to TechnicalSticker to copy a different value than the displayed children
+- **2026-07-15**: Marked package as side-effect-free (sideEffects: false) for tree-shaking and added an import/no-unassigned-import lint guard on published source
+- **2026-07-14**: Moved TableBox (with subcomponents, hooks, specs) and TableBoxField into PDS as new components/TableBox and FormField exports, added useScrollOverflow/zindex lib exports, and declared @dnd-kit deps
+- **2026-07-14**: Switched DataTable internal imports from the @persona-id/design-system alias to relative design-system paths to fix package resolution
+- **2026-07-14**: Extracted MessageType enum into a standalone lib/message module (re-exported from Toast) so it can be imported without Toast's dependencies
+- **2026-07-14**: Added GlobalStyles export to PDS lib for external consumers
+- **2026-07-14**: Refined TechnicalSticker interactions: overlaid copy action, centered technical text, non-selectable truncated labels, exact width prop, webfont-aware truncation remeasurement, and synchronized retained copy-action backgrounds
+- **2026-07-14**: Fixed MiddleTruncatedText to merge caller inline styles without overriding the max-width used for truncation measurement
+- **2026-07-14**: Set box-sizing: border-box on Table TableCell/TableHeaderCell so cell heights stay correct in reset-free contexts (no-op where a global reset exists)
+- **2026-07-14**: Added spreadsheet-style keyboard navigation to TableBoxField inline editors: cell-to-cell arrow movement, Enter-to-create, and guarded deletion of blank rows
+- **2026-07-14**: Added TechnicalSticker component with middle truncation, copy-to-clipboard affordance, token-aligned width measurement, and accessible full-text preservation (plus MiddleTruncatedText and copyTextToClipboard lib helpers)
+- **2026-07-13**: Moved useTableColumns and checkbox render helpers into DataTable with a RenderFormatFn injection point to remove the dashboard-format dependency
+- **2026-07-13**: Moved TableControlsContext into DataTable with generalized generic types (BaseFilterConfig, BaseActiveFilter) and converted internal imports to relative paths
+- **2026-07-13**: Added generic DataTable types (RowAction, SortProps, column format base types, DataTableVariables, ColumnConfig) to PDS and declared @tanstack/react-table as a peer dependency
+- **2026-07-13**: Co-located PaginationParams type and MIN_PAGE_SIZE constant in the Pagination component so it is self-contained (no dashboard imports)
+- **2026-07-13**: Fixed embedded single-select Combobox to keep the search input empty on open instead of prefilling the selected label
+- **2026-07-13**: Fixed portaled multi-select Combobox to retain focus while searching by marking the portal data-react-aria-top-layer and keying blur/outside-click to the portal id
+- **2026-07-10**: Moved Inserter component (with spec/stories) into DataTable, using PDSProvider test utilities
+- **2026-07-10**: Moved FloatingActionBar component into DataTable
+- **2026-07-10**: Moved DataTable constants into PDS
+- **2026-07-09**: Moved TableViewConfigurationDropdown into DataTable, added @hello-pangea/dnd dependency, and introduced a local AttributeColumn type
+- **2026-07-09**: Added SearchInput (debounced state, clear icon, disabled tooltip, flattened display variants) and its FormControlLabel dependency to DataTable
+- **2026-07-09**: Added drag-and-drop utilities to DataTable (StyledIconDrag component and reorder utility)
+- **2026-07-09**: Added ControlBar and CompactBar table-control components to DataTable, supporting saved views with tab overflow, bulk actions, search, filters, and a compact variant
+- **2026-07-09**: Corrected inlined vs external dependencies in package.json and tsdown config
+- **2026-07-09**: Added public NPM publishing support (release scripts, prepare.mjs, publish-files README)
+- **2026-07-07**: Moved TableLayout component and table primitives (TableCell, TableRow, TableTH) into the Table component directory
+- **2026-07-07**: Moved Pii component into the design system
+- **2026-07-06**: Moved Pagination, PageSelector, PageSizeSelector, and pagination constants into PDS and replaced a SPACINGS.base usage with the design-tokens Spacing[1] equivalent
+- **2026-07-06**: Changed Tooltip default delayDuration from 0ms to 300ms
+- **2026-07-02**: Fixed multi-select Combobox to keep option order stable while toggling selections
 
 ## [0.1.5] - 2026-07-02
 
-- **2026-07-02**: Migrated NPM publishing pipeline to Buildkite automated CI; release scripts now use `tag.sh` + `release.sh` instead of manual `npm publish`; updated README with new release workflow ([bc83596](https://github.com/persona-id/persona-web/commit/bc8359641b2b42c678840e521d65b0ba7924c9dc))
-- **2026-07-02**: Updated icon imports in 59 design-system components from `@persona-id/design-tokens/icons` to `@persona-id/icons` ([4bf34b4](https://github.com/persona-id/persona-web/commit/4bf34b4f16d152c5c38da3a2af8f90e541452d7c))
-- **2026-07-02**: Added `@persona-id/icons` as a package dependency ([053ff69](https://github.com/persona-id/persona-web/commit/053ff69641594f3e96304aa096958c138899b43e))
-- **2026-06-24**: Added ProgressIndicator component with sequential step navigation (completed/error steps clickable, active/upcoming not clickable), horizontal and vertical layouts, and full a11y support (`aria-current`, `aria-disabled`) ([f5a8689](https://github.com/persona-id/persona-web/commit/f5a8689dfed53cbb0e494a2fa331a1f805b1fedf))
-- **2026-06-18**: Added ProgressBar component with determinate and indeterminate types, multi-segment fills (`successPercent`), status variants (default/exception/success), `sm`/`md` sizes, and optional info slot showing percentage or status icon ([e01a03d](https://github.com/persona-id/persona-web/commit/e01a03dd76b0fdcc4a34e257c0fe3683aaa554b7))
+- **2026-07-02**: Migrated NPM publishing pipeline to Buildkite automated CI; release scripts now use `tag.sh` + `release.sh` instead of manual `npm publish`; updated README with new release workflow
+- **2026-07-02**: Updated icon imports in 59 design-system components from `@persona-id/design-tokens/icons` to `@persona-id/icons`
+- **2026-07-02**: Added `@persona-id/icons` as a package dependency
+- **2026-06-24**: Added ProgressIndicator component with sequential step navigation (completed/error steps clickable, active/upcoming not clickable), horizontal and vertical layouts, and full a11y support (`aria-current`, `aria-disabled`)
+- **2026-06-18**: Added ProgressBar component with determinate and indeterminate types, multi-segment fills (`successPercent`), status variants (default/exception/success), `sm`/`md` sizes, and optional info slot showing percentage or status icon
 
 ## [0.1.4] - 2026-06-30
 
@@ -74,319 +117,420 @@ Summary of changes to the @persona/design-system package.
 - **2026-06-23**: Fixed published ESM bundle shipping `node:module` imports that break browser
   consumers: set tsdown `platform: 'neutral'`, pinned `fixedExtension`, declared inlined phantom
   deps, and added a post-build guard
+ 
 - **2026-06-22**: Removed final dashboard dependencies from design-system (`useToggle`,
   `intersperse`)
+ 
 - **2026-06-11**: Constrained ImageTile `metadata` prop shape and hid decorative CheckboxBox from
   the accessibility tree
-  ([45ae863](https://github.com/persona-id/persona-web/commit/45ae863be71e52cd9adba30220bb6966b42c7d6e),
-  [83249b6](https://github.com/persona-id/persona-web/commit/83249b6b7530aa0e9fc54d77b92303a93c429798))
 - **2026-06-05**: Fixed Combobox menus embedded in filter popovers
+ 
 - **2026-06-03**: Added multiselect Combobox trigger support
+ 
 - **2026-06-02**: Added `splitOutFormFieldProps` helper for FormField definition
+ 
 - **2026-06-01**: Added `configFieldInputWidth` prop to FormField and FormControl; removed
   `useComponentRegister` from core components
-  ([16074a5](https://github.com/persona-id/persona-web/commit/16074a5d05e6442c874f0a450b1b94152d2b1b9a),
-  [097bb0d](https://github.com/persona-id/persona-web/commit/097bb0de7d2a2c339dfa242de02656df11ebeed0))
 - **2026-05-29**: Added ImageTile component
+ 
 - **2026-05-22**: Added nested submenu navigation and external trigger prop to single-select Combobox
-  ([6ead02b](https://github.com/persona-id/persona-web/commit/6ead02be723c7dde9aa1bdf6889221ed74615ae7),
-  [addb2b5](https://github.com/persona-id/persona-web/commit/addb2b55a22f2172570c99f5abefdfc4928075a0))
 - **2026-05-20**: Added Tile component
+ 
 - **2026-05-20**: Added SmartTextInputField FormField wrapper
+ 
 - **2026-04-22**: Upgraded TypeScript to v6.0.3
+ 
 - **2026-04-20**: Added drag-and-drop row reordering to TableBox
+ 
 - **2026-04-17**: Added PDSProvider composing ThemeProvider and ComponentRegisterProvider
+ 
 - **2026-04-15**: Added component register primitives and wired them into design-system components
-  ([d4c91a9](https://github.com/persona-id/persona-web/commit/d4c91a971a96e8179113df124ee5eb3028e6b335),
-  [530afe7](https://github.com/persona-id/persona-web/commit/530afe7d47caa75265a4fe99879f80d697362d0e))
 - **2026-03-24**: Added auto-color StatusIndicator `leadingIcon` via CSS inheritance
+ 
 - **2026-03-17**: Added text truncation with ellipses to ListBox items
+ 
 - **2026-03-04**: Added FileIcon and FileAttachment components
+ 
 - **2026-02-20**: Added full-bleed Modal body support and `full` size variant
-  ([b3c44b5](https://github.com/persona-id/persona-web/commit/b3c44b5f8e67628cc5eab6f321f52f453a6008ad),
-  [2e8a1bf](https://github.com/persona-id/persona-web/commit/2e8a1bf97a71d990778fb31d4b88f0b95240baa6))
 - **2026-02-06**: Added `size` prop to DateField, DatePicker, and DateRangePicker
+ 
 - **2026-01-22**: Added ComboboxField and removed ReactSelectField
+ 
 - **2026-01-20**: Renamed ToggleGroup to ButtonGroup
+ 
 - **2026-01-14**: Renamed ToggleSlider component to Toggle
+ 
 
 ## [0.1.1] - 2026-01-13
 
 - **2026-01-13**: Package tidy up and v0.1.1 release
+ 
 - **2026-01-12**: Made DatePicker accessible using keyboard navigation
+ 
 - **2026-01-09**: Corrected semantic button usage in Card section headings
+ 
 - **2026-01-08**: Added CommonJS (CJS) output to build configuration
+ 
 - **2026-01-08**: Added hideLabel support to FormField component
+ 
 - **2026-01-08**: Removed react-outside-click-handler dependency in favor of internal implementation
+ 
 - **2026-01-08**: Added drag and drop reordering functionality to ListBox
+ 
 - **2026-01-07**: Updated package configuration for npm release
+ 
 - **2026-01-07**: Fixed security issue by using unguessable ID attributes for ToggleSlider
+ 
 
 ### 2025-12
 
 - **2025-12-19**: Added ARIA attributes to DateFilter for improved accessibility
+ 
 - **2025-12-19**: Refactored DateRange component definition out of render function
+ 
 - **2025-12-19**: Labeled DateRange preset buttons for accessibility
+ 
 - **2025-12-18**: Migrated Modal to react-aria implementation
+ 
 - **2025-12-18**: Removed unused import from ListBox component
+ 
 - **2025-12-17**: Cleaned up CardV2 feature flag references in Section and LoadingShimmer
+ 
 - **2025-12-17**: Updated DatePicker focus styles to match design specifications
+ 
 - **2025-12-16**: Updated @persona-id/design-tokens to v0.3.9
+ 
 - **2025-12-15**: Added overflow handling to Modal content
+ 
 - **2025-12-15**: Made Toast component more accessible
+ 
 - **2025-12-15**: Added tab component support in Modal
+ 
 - **2025-12-12**: Fixed ListBox to prevent delete button from triggering item selection
+ 
 - **2025-12-11**: Added containerProps support to CardV2 Card component for passing props to
   CardContainer
+ 
 - **2025-12-10**: Fixed Sticker spacing issue for SimulatedData component
+ 
 - **2025-12-09**: Updated @persona-id/design-tokens to v0.3.8
+ 
 - **2025-12-09**: Updated focus styling across multiple components (Button, CardV2, Checkbox,
   Combobox, DatePicker, Link, Radio, Slider, Sticker, TabBar, Table, ToggleSlider) and added focus
   mixins
+ 
 - **2025-12-09**: Enhanced StatusIndicator with label-only variant (showIcon prop) and migrated to
   semantic design tokens
+ 
 - **2025-12-05**: Added support for passing container ref to Combobox when portalling dropdown
+ 
 
 ### 2025-11
 
 - **2025-11-26**: Added maxHeight prop to Popover component with overflow handling
+ 
 - **2025-11-21**: Updated @persona-id/design-tokens to v0.3.5
+ 
 - **2025-11-20**: Fixed ListBox dropdown bugs: added outside click handling, refactored heading
   component, fixed form field overflow
+ 
 - **2025-11-20**: Updated CardV2 link buttons to behave like links
+ 
 - **2025-11-20**: Changed default Banner variant from 'basic' to 'informational'
+ 
 - **2025-11-18**: Added StatusIndicator component to design system
+ 
 - **2025-11-18**: Added Figma design links to component stories (RangeCalendar, Link, Modal,
   Popover, Select, Slider, SwatchPicker, DropdownButton, DropdownMenu)
+ 
 - **2025-11-14**: Refactored AttributeGrid horizontal layout
+ 
 - **2025-11-13**: Fixed DatePicker calendar selection not appearing
+ 
 - **2025-11-12**: Updated CheckBoxField and SegmentedControlField to respect labelProps
+ 
 - **2025-11-06**: Removed form HTML from Button documentation
+ 
 - **2025-11-05**: Added row dropdown rendering support to ListBox with inline editing capabilities
+ 
 - **2025-11-04**: Fixed Combobox to prevent search from re-ordering options
+ 
 - **2025-11-04**: Updated Tooltip size variant to small for FLE components
+ 
 - **2025-11-03**: Fixed CardV2 heading layout to use flex instead of fixed width
+ 
 
 ### 2025-10
 
 - **2025-10-29**: Updated ListBox stories to make Playground a functional add/delete example
+ 
 - **2025-10-28**: Fixed CardV2 header accordion icon positioning to prevent overflow
+ 
 - **2025-10-26**: Added Toast component to design system with info, success, and error variants
+ 
 - **2025-10-24**: Fixed CardV2 to collapse correctly on Safari
+ 
 - **2025-10-24**: Adjusted CardV2 container padding when collapsed
+ 
 - **2025-10-23**: Migrated dashboard to react-router v6 API
+ 
 - **2025-10-23**: Updated Menu text style and padding based on size prop
+ 
 - **2025-10-23**: Updated TableBox to use small text styles
+ 
 - **2025-10-23**: Implemented size context inheritance for ListBox with small variant for config
   fields
+ 
 - **2025-10-22**: Fixed CardV2 stacked/height behavior: resolved divider visual bug, fixed flexbox
   behavior, added scroll padding, fixed Card.Stacked double wrapping, portalled heading menu to
   prevent cutoff
+ 
 - **2025-10-22**: Added usePortal functionality for Combobox dropdown rendering
+ 
 - **2025-10-21**: Fixed dashboard nav links accessibility support
+ 
 - **2025-10-21**: Added ability to customize font in Combobox option labels
+ 
 - **2025-10-20**: Enabled using stickers for Combobox option labels
+ 
 - **2025-10-20**: Prevented horizontal scroll from truncate in Combobox
+ 
 - **2025-10-18**: Fixed ESLint and Prettier issues in TabBar
+ 
 - **2025-10-16**: Rebuilt CardV2 padding for height behavior
+ 
 - **2025-10-16**: Fixed CardV2 SectionHeading spacing and layout issues
+ 
 - **2025-10-16**: Added export to RangeCalendar for props parsing
+ 
 - **2025-10-16**: Added support for array of footer items in CardV2 for correct styling
+ 
 - **2025-10-16**: Added sticky heading/footer support to CardV2
+ 
 - **2025-10-14**: Updated design-tokens to include new icons
+ 
 - **2025-10-14**: Removed double role="menu" from DropdownMenu
+ 
 - **2025-10-14**: Added Combobox inline editing support to TableBox cells
+ 
 - **2025-10-10**: Added size prop to TabBar component with small variant
+ 
 - **2025-10-10**: Added heading truncation to CardV2
+ 
 - **2025-10-10**: Added grouped options support to Combobox
+ 
 - **2025-10-08**: Added small loader to design system
+ 
 - **2025-10-08**: Promoted LoadingShimmer component to PDS
+ 
 - **2025-10-08**: Added maxTabChars option to truncate long tab names
+ 
 - **2025-10-08**: Fixed CardV2 heading margin when collapsed and removed footer divider when no body
   present
+ 
 - **2025-10-07**: Added empty state support to CardV2
+ 
 - **2025-10-07**: Improved CardV2 caret animation speed
+ 
 - **2025-10-07**: Added compact font size support for DataTable headers
+ 
 - **2025-10-07**: Added error state and error boundary to CardV2
+ 
 - **2025-10-06**: Added smBold size option for paragraph text mixins
+ 
 - **2025-10-06**: Corrected default button color in Storybook
+ 
 - **2025-10-06**: Updated non-accessible text to use text/secondary color
+ 
 - **2025-10-03**: Updated @persona-id/design-tokens to v0.2.41
+ 
 - **2025-10-03**: Unset isDisabled on CardV2 disclosure button
+ 
 - **2025-10-03**: Bumped react-aria-components from 1.6.0 to 1.13.0
+ 
 - **2025-10-03**: Updated design-token package
+ 
 - **2025-10-03**: Upgraded radix-ui packages
+ 
 - **2025-10-02**: Renamed Combobox compact prop to truncate
+ 
 - **2025-10-02**: Fixed compact single select Combobox display in DataTable
+ 
 - **2025-10-02**: Reworked ESLint rules around Combobox importing
+ 
 - **2025-10-02**: Updated SegmentedControl border color
+ 
 - **2025-10-02**: Prevented CardV2 container from flex shrinking
+ 
 - **2025-10-01**: Corrected small Button left/right padding
+ 
 - **2025-10-01**: Marked Spacer component as deprecated
+ 
 - **2025-10-01**: Added hover state to TabBar
+ 
 
 ### 2025-09
 
-- **2025-09-30**: Bumped `@persona-id/design-tokens` package version in design-system `package.json` ([4152eac](https://github.com/persona-id/persona-web/commit/4152eacc65f2dfa12f0ecdcd11124c1f6d913882))
-- **2025-09-29**: Fixed CardV2 `Card.Section` to remove large inter-item gap from section content — large gaps now apply only between top-level sections under `<Card>` ([3effd78](https://github.com/persona-id/persona-web/commit/3effd787fafa920a7099dc3b4ea19649ffee65b9))
-- **2025-09-25**: Added `overflow-y: auto` to CardV2 `CardContainer` for better height/scroll handling ([a3f4fba](https://github.com/persona-id/persona-web/commit/a3f4fba0e16831f5f00152ba8b6db6ca9903dc09))
-- **2025-09-25**: Fixed `ComboboxMultiSelect` to prevent resetting the highlighted index when selecting an option ([7e8e2f2](https://github.com/persona-id/persona-web/commit/7e8e2f28a31b61d0bb143d27d0fda6cc5207d7d5))
-- **2025-09-23**: Added CardV2 SectionHeading features: custom `headingProps` passthrough, a custom slot in the header button row, tooltip support on `IconAction` and `TextAction`, `disabled`/`hidden` action support, content-less card header support; exported `IconAction`, `TextAction`, and `MenuAction` types ([5cdbc7e](https://github.com/persona-id/persona-web/commit/5cdbc7e2437f6511a243c6b4fa77ab8c5bd29357))
-- **2025-09-23**: Added `loading` shimmer state and `leftDecorativeIcon` prop to CardV2; fixed CardV2 header font style ([a110f59](https://github.com/persona-id/persona-web/commit/a110f59fbd3c1bf32246a4dc0f3a24d29c29b6ac))
-- **2025-09-23**: Added `$matchCardV2` prop to legacy Card `Body` and `Title` components to visually match CardV2 header styling during incremental migration ([bddc860](https://github.com/persona-id/persona-web/commit/bddc860e932673259e0777bf241068fc545f7ce2))
-- **2025-09-23**: Added `ReactCreatableSelectField` and `ReactSelectField` FormField wrapper components to `inputFields.tsx` ([fa4399c](https://github.com/persona-id/persona-web/commit/fa4399c546f117789ab28bacdf3b64f782bae1e6))
-- **2025-09-23**: Enforced stricter TypeScript typing on CardV2 `actions` prop in `SectionHeading` ([5648c83](https://github.com/persona-id/persona-web/commit/5648c839df07f0f21d366ff5800ff292900ff258))
-- **2025-09-19**: Bumped `@persona-id/design-tokens` to `^0.2.37` in design-system `package.json` ([faf55e3](https://github.com/persona-id/persona-web/commit/faf55e36b3b13dbc78ef0f2358a824d5fdf11ea6))
-- **2025-09-19**: Updated ListBox border-radius to match TableBox styling ([a9039da](https://github.com/persona-id/persona-web/commit/a9039da2874024fbcced27859f6c13debeb82800))
-- **2025-09-19**: Fixed ListBoxField spacing to be consistent with other fields by refactoring `FormControl` container layout to handle right-actions column separately from the standard inline layout ([4e679ca](https://github.com/persona-id/persona-web/commit/4e679ca1a51f92700ceff1cec46004657364313f))
-- **2025-09-18**: Fixed `ComboboxSingleSelect` to prevent overwriting the input value with the selected option's label while the dropdown is open ([5a8441e](https://github.com/persona-id/persona-web/commit/5a8441e4c5c115ea38954fbd9a49dc5c09f16804))
-- **2025-09-18**: Changed CardV2 `collapsible` prop default from `true` to `false` ([0bfb9fe](https://github.com/persona-id/persona-web/commit/0bfb9fee21cc084b19bec3a235dac292d640ae71))
-- **2025-09-16**: Added `sm` size variant to Tooltip component ([913cd2b](https://github.com/persona-id/persona-web/commit/913cd2b8663c284d81607063bc4b303cca1fa59a))
-- **2025-09-16**: Fixed TabBar title to apply correct `font-style` from design tokens ([8230eed](https://github.com/persona-id/persona-web/commit/8230eed209b9664d590ee43e0c74245d58693895))
-- **2025-09-12**: Added optional `description` field support to Combobox dropdown items in `ComboboxMultiSelect` and `ComboboxSingleSelect` ([a073b1a](https://github.com/persona-id/persona-web/commit/a073b1ac867b540e3b939e7a62e69feac2596884))
-- **2025-09-11**: Set `InputGroup` width to 100% so that the inner `Input` takes full available width ([2a62d64](https://github.com/persona-id/persona-web/commit/2a62d64a1692159aa13602807fe9bbaafed07c3c))
-- **2025-09-09**: Upgraded Storybook to v9, updating story and MDX file syntax across all design-system components ([b698f31](https://github.com/persona-id/persona-web/commit/b698f3197d4f20e2b76812d7510f78b1fdde0809))
-- **2025-09-09**: Fixed `ComboboxSingleSelect` to use `aria-selected` more correctly; updated Combobox specs ([44893c4](https://github.com/persona-id/persona-web/commit/44893c4113897e08132493dabfeb1322b9015d27))
-- **2025-09-09**: Updated Combobox Storybook stories to correctly represent selected state ([3f60551](https://github.com/persona-id/persona-web/commit/3f6055122eac75cc4832f023b8cd315cc37a5ffa))
-- **2025-09-08**: Fixed RadioGroup to apply uniform `Spacing[2]` bottom margin for all sizes, removing the zero-margin for `sm` size ([becdc1f](https://github.com/persona-id/persona-web/commit/becdc1f8a4afe90ddc5fa0ffa33847b8a21a8924))
-- **2025-09-08**: Enabled Chromatic visual snapshots for Combobox stories; restructured `Combobox.stories.tsx` and `ComboboxMultiSelect.stories.tsx` ([76f761d](https://github.com/persona-id/persona-web/commit/76f761d884748f06c23402d8dc3a394a55dc27cf))
-- **2025-09-08**: Fixed Input suffix text from overlapping input content by adjusting right padding and flex layout when suffix is present ([3d4bc5d](https://github.com/persona-id/persona-web/commit/3d4bc5dd39aeb57a4447a9322548f05cb9b0a5d5))
-- **2025-09-08**: Applied secondary text color to ListBox empty state ([0acb739](https://github.com/persona-id/persona-web/commit/0acb73997fb979863af613f1490d0d87b798113c))
-- **2025-09-04**: Removed z-index from `ComboboxBase` and cleaned up unused z-index prop in `ComboboxMultiSelect` ([e4f906d](https://github.com/persona-id/persona-web/commit/e4f906d2d443b952c2451bb961ec8e082786bdab))
-- **2025-09-04**: Added tooltip support to Checkbox component ([a24f945](https://github.com/persona-id/persona-web/commit/a24f9458ea197ebc7082a61a54d87f4e0b5a6f40))
-- **2025-09-04**: Added Enter key handler to open the Combobox dropdown when the input is focused ([68a39e4](https://github.com/persona-id/persona-web/commit/68a39e4998afc54fc9059c152ceaa5f6252f868c))
-- **2025-09-03**: Updated Input warning state styling in `mixins/input.ts` and added warning state Storybook story ([8a05049](https://github.com/persona-id/persona-web/commit/8a05049ea8a2b6f2080fe626860487180f27c65f))
-- **2025-09-03**: Fixed Combobox Tab key to no longer select the highlighted item; moved tab-handling out of `ComboboxMultiSelect` into `ComboboxSingleSelect` ([75b04da](https://github.com/persona-id/persona-web/commit/75b04daa2a6c5352411e3f74b284df6c8976e8ad))
-- **2025-09-03**: Fixed `ComboboxMultiSelect` search input blur handling to correctly close the dropdown ([440d177](https://github.com/persona-id/persona-web/commit/440d177c5cb1039c7d5e35dcc76e2b6b0f66f1d2))
-- **2025-09-02**: Added `size` prop (`md` | `sm`) to RadioGroup with size-responsive bottom margin between radio items ([cd6a698](https://github.com/persona-id/persona-web/commit/cd6a698c31acd70832933368b0f62fa0bcd63643))
-- **2025-09-02**: Removed pointer-events from Input prefix and suffix icon elements ([6a366c2](https://github.com/persona-id/persona-web/commit/6a366c2db2809d69fc5412ceac24fd1f00000000))
+- **2025-09-30**: Bumped `@persona-id/design-tokens` package version in design-system `package.json`
+- **2025-09-29**: Fixed CardV2 `Card.Section` to remove large inter-item gap from section content — large gaps now apply only between top-level sections under `<Card>`
+- **2025-09-25**: Added `overflow-y: auto` to CardV2 `CardContainer` for better height/scroll handling
+- **2025-09-25**: Fixed `ComboboxMultiSelect` to prevent resetting the highlighted index when selecting an option
+- **2025-09-23**: Added CardV2 SectionHeading features: custom `headingProps` passthrough, a custom slot in the header button row, tooltip support on `IconAction` and `TextAction`, `disabled`/`hidden` action support, content-less card header support; exported `IconAction`, `TextAction`, and `MenuAction` types
+- **2025-09-23**: Added `loading` shimmer state and `leftDecorativeIcon` prop to CardV2; fixed CardV2 header font style
+- **2025-09-23**: Added `$matchCardV2` prop to legacy Card `Body` and `Title` components to visually match CardV2 header styling during incremental migration
+- **2025-09-23**: Added `ReactCreatableSelectField` and `ReactSelectField` FormField wrapper components to `inputFields.tsx`
+- **2025-09-23**: Enforced stricter TypeScript typing on CardV2 `actions` prop in `SectionHeading`
+- **2025-09-19**: Bumped `@persona-id/design-tokens` to `^0.2.37` in design-system `package.json`
+- **2025-09-19**: Updated ListBox border-radius to match TableBox styling
+- **2025-09-19**: Fixed ListBoxField spacing to be consistent with other fields by refactoring `FormControl` container layout to handle right-actions column separately from the standard inline layout
+- **2025-09-18**: Fixed `ComboboxSingleSelect` to prevent overwriting the input value with the selected option's label while the dropdown is open
+- **2025-09-18**: Changed CardV2 `collapsible` prop default from `true` to `false`
+- **2025-09-16**: Added `sm` size variant to Tooltip component
+- **2025-09-16**: Fixed TabBar title to apply correct `font-style` from design tokens
+- **2025-09-12**: Added optional `description` field support to Combobox dropdown items in `ComboboxMultiSelect` and `ComboboxSingleSelect`
+- **2025-09-11**: Set `InputGroup` width to 100% so that the inner `Input` takes full available width
+- **2025-09-09**: Upgraded Storybook to v9, updating story and MDX file syntax across all design-system components
+- **2025-09-09**: Fixed `ComboboxSingleSelect` to use `aria-selected` more correctly; updated Combobox specs
+- **2025-09-09**: Updated Combobox Storybook stories to correctly represent selected state
+- **2025-09-08**: Fixed RadioGroup to apply uniform `Spacing[2]` bottom margin for all sizes, removing the zero-margin for `sm` size
+- **2025-09-08**: Enabled Chromatic visual snapshots for Combobox stories; restructured `Combobox.stories.tsx` and `ComboboxMultiSelect.stories.tsx`
+- **2025-09-08**: Fixed Input suffix text from overlapping input content by adjusting right padding and flex layout when suffix is present
+- **2025-09-08**: Applied secondary text color to ListBox empty state
+- **2025-09-04**: Removed z-index from `ComboboxBase` and cleaned up unused z-index prop in `ComboboxMultiSelect`
+- **2025-09-04**: Added tooltip support to Checkbox component
+- **2025-09-04**: Added Enter key handler to open the Combobox dropdown when the input is focused
+- **2025-09-03**: Updated Input warning state styling in `mixins/input.ts` and added warning state Storybook story
+- **2025-09-03**: Fixed Combobox Tab key to no longer select the highlighted item; moved tab-handling out of `ComboboxMultiSelect` into `ComboboxSingleSelect`
+- **2025-09-03**: Fixed `ComboboxMultiSelect` search input blur handling to correctly close the dropdown
+- **2025-09-02**: Added `size` prop (`md` | `sm`) to RadioGroup with size-responsive bottom margin between radio items
+- **2025-09-02**: Removed pointer-events from Input prefix and suffix icon elements
 
 ### 2025-08
 
-- **2025-08-29**: Restored RadioGroup documentation and updated `RadioGroup.tsx` to fix doc rendering issues ([b9988af](https://github.com/persona-id/persona-web/commit/b9988afcfc8915e3b31d02aa2872342ff134a01a))
-- **2025-08-29**: Added `small` size variant to Radio and RadioGroup components with updated stories and docs ([4721eb3](https://github.com/persona-id/persona-web/commit/4721eb3c5ae824c003847d82f069f51d85a29ca5))
-- **2025-08-29**: Fixed ToggleField label to match toggle size by adding `size` prop propagation in `inputFields.tsx` ([03b89df](https://github.com/persona-id/persona-web/commit/03b89df9ea9cdcd2bc9bba8b419f7c433be3d680))
-- **2025-08-28**: Improved Combobox multi-select open/close UX with refactored `ComboboxMultiSelect` and added expanded test coverage ([a9fb38d](https://github.com/persona-id/persona-web/commit/a9fb38d5626ad126a04c0ada8402625d683ff05f))
-- **2025-08-28**: Updated Radio, TabBar, and ToggleSlider to use new semantic input background/border design tokens (e.g. `BackgroundInputActive`, `BorderFocus`) in place of checkbox-specific tokens ([3d2e6dd](https://github.com/persona-id/persona-web/commit/3d2e6dd1939c57c8cea191a029bad4799a17e0ac))
-- **2025-08-28**: Updated CardV2 `Section` and `SectionHeading` to use react-aria Disclosure for accessibility support ([3309a31](https://github.com/persona-id/persona-web/commit/3309a31d3d19d7c6b165b3cbf9ea25cb757cbea3))
-- **2025-08-28**: Upgraded lock icon design tokens in Sticker and CardV2 stories, bumped package version ([15e4608](https://github.com/persona-id/persona-web/commit/15e4608ffaf5b13855a913e73ea36798c8401eb1))
-- **2025-08-27**: Added `small` and `large` size variants to ToggleSlider component with updated stories and docs ([b848a22](https://github.com/persona-id/persona-web/commit/b848a292b0086c79cdc4f8ce0de4632f814f464))
-- **2025-08-27**: Renamed Checkbox `size` prop values for consistency — updated component, stories, specs, and docs ([6625951](https://github.com/persona-id/persona-web/commit/662595196c51b9eb8f2ba7bc7f7f6ddf42852b03))
-- **2025-08-26**: ListBox empty state now reflects the `size` prop, rendering a smaller empty state button when `size="sm"` ([d753935](https://github.com/persona-id/persona-web/commit/d7539350af98af0d3dc6ee3c0b26f5da77e5a031))
-- **2025-08-26**: Added `compact` size variant to Checkbox component with updated stories, specs, and docs ([a1c935a](https://github.com/persona-id/persona-web/commit/a1c935ad3b54a459dcbc86ea82fe00cba7c500e7))
-- **2025-08-26**: Disabled portals by default in DropdownMenu and Select to fix z-index/overlay issues ([9ecf47d](https://github.com/persona-id/persona-web/commit/9ecf47d2e1f5f6dec4abee5a2ef45ead4866b803))
-- **2025-08-25**: Fixed ListBox with both item actions and delete button — corrected styling conflict and prevented empty state button from triggering form submission; added per-item delete action support with expanded stories and specs ([5e08879](https://github.com/persona-id/persona-web/commit/5e088798f27e5ba79edd3c8d4f02e238c8e99d34))
-- **2025-08-22**: Improved TabBar overflow styling to prevent content clipping ([39f6585](https://github.com/persona-id/persona-web/commit/39f65854c4c46807822561ea6ee682a46e102e3a))
-- **2025-08-22**: Renamed IconButton size values: `sm`→`xs`, `md`→`sm`, `lg`→`md` to align with updated button sizing naming scheme ([0d38c7a](https://github.com/persona-id/persona-web/commit/0d38c7a5c970a8d4c34bab31c9bd0aedb296e67a))
-- **2025-08-21**: Removed `dashboard:pds-use-updated-button-palette` feature flag from Button and Sticker, baking in the updated palette; updated design tokens ([e2a2bf4](https://github.com/persona-id/persona-web/commit/e2a2bf4dcd5c14f3e32867d2b8431aca38ccffa5))
-- **2025-08-21**: Fixed ComboboxMultiSelect padding for sticker sizes after sticker height/border-radius update ([958cacd](https://github.com/persona-id/persona-web/commit/958cacd1ac74a69c2c3b6a6de727e0f8e984115a))
-- **2025-08-21**: Added ability to remove disabled options from ComboboxMultiSelect and ComboboxSingleSelect ([5371b26](https://github.com/persona-id/persona-web/commit/5371b26b23cb8b2deeb3b5d618681dc6b2b06d24))
-- **2025-08-20**: Fixed `FormControl` to allow `configField` variant to expand with its parent container ([b9c0300](https://github.com/persona-id/persona-web/commit/b9c0300f8cad1f74b7368e7fbd7599048acc8b31))
-- **2025-08-20**: Fixed ListBox empty state button to use `type="button"` to prevent triggering form submission ([b330299](https://github.com/persona-id/persona-web/commit/b33029939a3a43d5ff9ced86609b4eba2533ae45))
-- **2025-08-20**: Added per-item delete actions to ListBox items via new `onDelete` prop on `ListBox.Item` ([71f8435](https://github.com/persona-id/persona-web/commit/71f84358615a98913638541c1dfbdf600504116a))
-- **2025-08-20**: Removed unused `jsx-click-tracking-ids` ESLint rule from SwatchPicker ([65b8bd0](https://github.com/persona-id/persona-web/commit/65b8bd0cfced4727129658a6a8346fa2fc280e03))
-- **2025-08-20**: Added new CardV2 component (`Section`, `SectionHeading`) with collapsible sections, theme tokens, and text mixin updates ([435821b](https://github.com/persona-id/persona-web/commit/435821baabde31826afe092bd2253aab8a4d8b1d))
-- **2025-08-20**: Fixed ListBox styling when both item actions and a delete button are present simultaneously ([2e0cce2](https://github.com/persona-id/persona-web/commit/2e0cce2bf644f549632a0e2baf60ce41f8033966))
-- **2025-08-20**: Fixed table filter buttons to be consistently clickable and visible across all browsers by correcting Select and DropdownMenu z-index/pointer-events ([2d72279](https://github.com/persona-id/persona-web/commit/2d72279bd634d4e99299ca33291c1bdd7336dad7))
-- **2025-08-20**: Updated Sticker height, border-radius, and padding; refactored UI element styling ([12185d3](https://github.com/persona-id/persona-web/commit/12185d374f518535c8ba0556737274d237f00a04))
-- **2025-08-19**: Fixed IconButton to reflect correct intended usage, added comprehensive IconButton stories, and updated docs ([ab95147](https://github.com/persona-id/persona-web/commit/ab95147135a753c8927f5f7f1db23e23975e2d52))
-- **2025-08-18**: Added secondary background color handling to Button and Sticker so they render correctly on `$secondary` background surfaces; added Badge secondary background support ([e45a454](https://github.com/persona-id/persona-web/commit/e45a454107038777a30e780fe5cef3a46e95abe6))
-- **2025-08-18**: Kept Combobox error and warning border colors on hover (previously reverted to default on hover) ([c314b8e](https://github.com/persona-id/persona-web/commit/c314b8ec09b8d567d7372c5a1d0402ae9c31660a))
-- **2025-08-18**: Fixed grey Sticker to use correct grey color tokens instead of wrong palette colors ([2f65145](https://github.com/persona-id/persona-web/commit/2f6514525f0f15b5a8ab6533ace487e98fa94e68))
-- **2025-08-15**: Added `outline` button variant to PDS Button with new `buttonOutline*` theme tokens ([fec3c73](https://github.com/persona-id/persona-web/commit/fec3c73e4f203faf88198d08e3bf49a4250e9999))
-- **2025-08-15**: Updated Sticker height and border-radius; refactored Sticker component internals ([e73308c](https://github.com/persona-id/persona-web/commit/e73308c21ba045d78fa3f05a91ea0ecfb285ca48))
-- **2025-08-15**: Prevented stickers in Combobox multi-select from receiving focus ([0cc256f](https://github.com/persona-id/persona-web/commit/0cc256fb8fdfdff0df24a378ccf5843fde6e9c13))
-- **2025-08-15**: Changed default Storybook background to white for all design-system stories ([092523e](https://github.com/persona-id/persona-web/commit/092523efde9aef167b32d132558ebe659c4f43da))
-- **2025-08-15**: Fixed ComboboxSingleSelect to deselect current option when the search input is cleared ([04552c5](https://github.com/persona-id/persona-web/commit/04552c50bf1d070eecbf2c66e70fd6de0bde6355))
-- **2025-08-14**: Fixed small Button vertical alignment regression ([eabd26e](https://github.com/persona-id/persona-web/commit/eabd26ed24c29e039169d30d2e3dfe4bf91555d2))
-- **2025-08-14**: Added dropdown option support to `ListBoxField` via a new `DropdownOption` type ([dc2234c](https://github.com/persona-id/persona-web/commit/dc2234c02103ff97d85300e00dc7cd1c5c9db4c2))
-- **2025-08-14**: Fixed Button color tokens — corrected palette usage for basic Button variants ([d4a1c55](https://github.com/persona-id/persona-web/commit/d4a1c5562a82c4ddd7c5a500bcc1593e85c0c427))
-- **2025-08-14**: Fixed IconButton to reflect correct intended usage, added comprehensive stories, and updated docs ([6fce480](https://github.com/persona-id/persona-web/commit/6fce480f3cde58045b15a31f6c5464991fe3a0f4))
-- **2025-08-14**: Fixed Combobox tab key handling to properly close dropdown and move focus ([3c6005b](https://github.com/persona-id/persona-web/commit/3c6005b59c6447cf6b9e63e9f67ebf7bf85beffe))
-- **2025-08-13**: Lightened Modal backdrop opacity ([967fabd](https://github.com/persona-id/persona-web/commit/967fabdb651db1f6d4f262e37e062e03dd6d3747))
-- **2025-08-13**: Fixed cursor style inconsistency in Combobox — aligned pointer/default cursors across interactive states ([4dc2dfc](https://github.com/persona-id/persona-web/commit/4dc2dfc9a5640484204bb00bee6691e62bdae91a))
-- **2025-08-11**: Prevented disabled Combobox options from being selectable or keyboard-highlightable ([c4b3bbd](https://github.com/persona-id/persona-web/commit/c4b3bbd95c3303a00b8d1847cd063efa3917fba3))
-- **2025-08-08**: Added `monoMedium` and `semiMonoMedium` font aliases to `theme.ts` and updated references across the codebase to use the correct font tokens ([fff8fbd](https://github.com/persona-id/persona-web/commit/fff8fbdcff3efae0181aac662c590bba5457efec))
-- **2025-08-08**: Fixed small Input to use small left icon instead of default-size icon ([36f885a](https://github.com/persona-id/persona-web/commit/36f885ab60f37affb08cdac4d061316b0da5ef6c))
-- **2025-08-08**: Fixed Button text alignment and Modal focus ring by correcting `text-align` and `outline` CSS ([27ce534](https://github.com/persona-id/persona-web/commit/27ce534792b4337f4da42080cabc677516048f44))
-- **2025-08-07**: Updated small Input button styles (height, padding, icon size) to match design spec ([359e6b0](https://github.com/persona-id/persona-web/commit/359e6b08e3693ee0475bd42ba263be9d893cd498))
-- **2025-08-05**: Added sizeable label support to PDS input fields via a new `labelSize` prop on `FormControl` and `inputFields` ([f51532b](https://github.com/persona-id/persona-web/commit/f51532b4cc570843e497c20de67333ead5f6f8c1))
-- **2025-08-05**: Added static Banner story examples and extended `buildSnapshotStory` utility to support decorators; fixed Banner text-wrapping styles ([84468fc](https://github.com/persona-id/persona-web/commit/84468fc4f63d8a6f6306e82a0e79228030eef842))
-- **2025-08-01**: Updated `buildSnapshotStory` helper in `SnapshotTestGrid.tsx` to support story decorators ([cf6eaf3](https://github.com/persona-id/persona-web/commit/cf6eaf3070cff77e0bf7806f2925a2cf00e7f201))
-- **2025-08-01**: Added static (non-interactive) examples to Banner stories for snapshot testing ([aec922e](https://github.com/persona-id/persona-web/commit/aec922ef9bbb82e04ccc84305b2a206a1ae16d45))
+- **2025-08-29**: Restored RadioGroup documentation and updated `RadioGroup.tsx` to fix doc rendering issues
+- **2025-08-29**: Added `small` size variant to Radio and RadioGroup components with updated stories and docs
+- **2025-08-29**: Fixed ToggleField label to match toggle size by adding `size` prop propagation in `inputFields.tsx`
+- **2025-08-28**: Improved Combobox multi-select open/close UX with refactored `ComboboxMultiSelect` and added expanded test coverage
+- **2025-08-28**: Updated Radio, TabBar, and ToggleSlider to use new semantic input background/border design tokens (e.g. `BackgroundInputActive`, `BorderFocus`) in place of checkbox-specific tokens
+- **2025-08-28**: Updated CardV2 `Section` and `SectionHeading` to use react-aria Disclosure for accessibility support
+- **2025-08-28**: Upgraded lock icon design tokens in Sticker and CardV2 stories, bumped package version
+- **2025-08-27**: Added `small` and `large` size variants to ToggleSlider component with updated stories and docs
+- **2025-08-27**: Renamed Checkbox `size` prop values for consistency — updated component, stories, specs, and docs
+- **2025-08-26**: ListBox empty state now reflects the `size` prop, rendering a smaller empty state button when `size="sm"`
+- **2025-08-26**: Added `compact` size variant to Checkbox component with updated stories, specs, and docs
+- **2025-08-26**: Disabled portals by default in DropdownMenu and Select to fix z-index/overlay issues
+- **2025-08-25**: Fixed ListBox with both item actions and delete button — corrected styling conflict and prevented empty state button from triggering form submission; added per-item delete action support with expanded stories and specs
+- **2025-08-22**: Improved TabBar overflow styling to prevent content clipping
+- **2025-08-22**: Renamed IconButton size values: `sm`→`xs`, `md`→`sm`, `lg`→`md` to align with updated button sizing naming scheme
+- **2025-08-21**: Removed `dashboard:pds-use-updated-button-palette` feature flag from Button and Sticker, baking in the updated palette; updated design tokens
+- **2025-08-21**: Fixed ComboboxMultiSelect padding for sticker sizes after sticker height/border-radius update
+- **2025-08-21**: Added ability to remove disabled options from ComboboxMultiSelect and ComboboxSingleSelect
+- **2025-08-20**: Fixed `FormControl` to allow `configField` variant to expand with its parent container
+- **2025-08-20**: Fixed ListBox empty state button to use `type="button"` to prevent triggering form submission
+- **2025-08-20**: Added per-item delete actions to ListBox items via new `onDelete` prop on `ListBox.Item`
+- **2025-08-20**: Removed unused `jsx-click-tracking-ids` ESLint rule from SwatchPicker
+- **2025-08-20**: Added new CardV2 component (`Section`, `SectionHeading`) with collapsible sections, theme tokens, and text mixin updates
+- **2025-08-20**: Fixed ListBox styling when both item actions and a delete button are present simultaneously
+- **2025-08-20**: Fixed table filter buttons to be consistently clickable and visible across all browsers by correcting Select and DropdownMenu z-index/pointer-events
+- **2025-08-20**: Updated Sticker height, border-radius, and padding; refactored UI element styling
+- **2025-08-19**: Fixed IconButton to reflect correct intended usage, added comprehensive IconButton stories, and updated docs
+- **2025-08-18**: Added secondary background color handling to Button and Sticker so they render correctly on `$secondary` background surfaces; added Badge secondary background support
+- **2025-08-18**: Kept Combobox error and warning border colors on hover (previously reverted to default on hover)
+- **2025-08-18**: Fixed grey Sticker to use correct grey color tokens instead of wrong palette colors
+- **2025-08-15**: Added `outline` button variant to PDS Button with new `buttonOutline*` theme tokens
+- **2025-08-15**: Updated Sticker height and border-radius; refactored Sticker component internals
+- **2025-08-15**: Prevented stickers in Combobox multi-select from receiving focus
+- **2025-08-15**: Changed default Storybook background to white for all design-system stories
+- **2025-08-15**: Fixed ComboboxSingleSelect to deselect current option when the search input is cleared
+- **2025-08-14**: Fixed small Button vertical alignment regression
+- **2025-08-14**: Added dropdown option support to `ListBoxField` via a new `DropdownOption` type
+- **2025-08-14**: Fixed Button color tokens — corrected palette usage for basic Button variants
+- **2025-08-14**: Fixed IconButton to reflect correct intended usage, added comprehensive stories, and updated docs
+- **2025-08-14**: Fixed Combobox tab key handling to properly close dropdown and move focus
+- **2025-08-13**: Lightened Modal backdrop opacity
+- **2025-08-13**: Fixed cursor style inconsistency in Combobox — aligned pointer/default cursors across interactive states
+- **2025-08-11**: Prevented disabled Combobox options from being selectable or keyboard-highlightable
+- **2025-08-08**: Added `monoMedium` and `semiMonoMedium` font aliases to `theme.ts` and updated references across the codebase to use the correct font tokens
+- **2025-08-08**: Fixed small Input to use small left icon instead of default-size icon
+- **2025-08-08**: Fixed Button text alignment and Modal focus ring by correcting `text-align` and `outline` CSS
+- **2025-08-07**: Updated small Input button styles (height, padding, icon size) to match design spec
+- **2025-08-05**: Added sizeable label support to PDS input fields via a new `labelSize` prop on `FormControl` and `inputFields`
+- **2025-08-05**: Added static Banner story examples and extended `buildSnapshotStory` utility to support decorators; fixed Banner text-wrapping styles
+- **2025-08-01**: Updated `buildSnapshotStory` helper in `SnapshotTestGrid.tsx` to support story decorators
+- **2025-08-01**: Added static (non-interactive) examples to Banner stories for snapshot testing
 
 ### 2025-07
 
-- **2025-07-30**: Added optional `target` prop to Button to allow overriding the default `_blank` target for external links ([aafadf6](https://github.com/persona-id/persona-web/commit/aafadf622fb87cf219aac6f0b09c4b5cd59fe774))
-- **2025-07-28**: Added `isRequired` prop to Sticker to show a required asterisk that remains visible when text is truncated ([eb3499b](https://github.com/persona-id/persona-web/commit/eb3499bf467c9831b241964048db240662c8e694))
-- **2025-07-25**: Added optional `aria-label` prop to ToggleSlider to allow customizing its accessibility label ([8cc35c6](https://github.com/persona-id/persona-web/commit/8cc35c6d93657c46e097efa39209e113ce4d0018))
-- **2025-07-25**: Added text truncation with overflow indicator to ComboboxMultiSelect compact mode ([140c739](https://github.com/persona-id/persona-web/commit/140c739354829830ad843e0735836ef6d319c5fb))
-- **2025-07-24**: Added `actions` prop support to ListBox items and ListBoxField for rendering per-item action menus ([a01b874](https://github.com/persona-id/persona-web/commit/a01b874b00eda11d31b700148b2e3b6b2f385d04))
-- **2025-07-23**: Fixed Combobox padding, heights, and sm size support to match Figma designs; extracted inline callbacks to improve performance ([ea514f6](https://github.com/persona-id/persona-web/commit/ea514f6a3846af327ccff1222f2fca219d9f8c63))
-- **2025-07-23**: Removed hover styles from Sticker dismiss buttons ([753bb06](https://github.com/persona-id/persona-web/commit/753bb06832c44fec1f1fb994bdaaa6c7d48eb2d4))
-- **2025-07-22**: Added compact mode to ComboboxMultiSelect that prevents vertical expansion by compressing selected-item stickers ([e0635fc](https://github.com/persona-id/persona-web/commit/e0635fc578757a40248341f52c3b8330649085d4))
-- **2025-07-22**: Refactored Combobox into ComboboxBase, ComboboxSingleSelect, and ComboboxMultiSelect; added multi-select mode with checkbox highlighting, in-dropdown search, sticker-based selected items, and manual `aria-multiselectable`/`aria-selected` attributes ([b90e339](https://github.com/persona-id/persona-web/commit/b90e339b9d0112aaaee760389ec193677c04d371))
-- **2025-07-21**: Fixed Menu items without icons rendering at 31px height instead of 32px by removing incorrect height override ([5255ccd](https://github.com/persona-id/persona-web/commit/5255ccdd4702c658c275d981061e321b8c8fa4ee))
-- **2025-07-16**: Added `actions` prop to ListBox and ListBoxField to support per-item action menus ([e97e9af](https://github.com/persona-id/persona-web/commit/e97e9afff955743e9e3f67c7df2489dd071d8fb0))
-- **2025-07-14**: Migrated ListBox from `role=listbox`/`role=option` to React Aria's GridList (`role=grid`/`role=row`) as a more appropriate base for planned features ([f7b1873](https://github.com/persona-id/persona-web/commit/f7b18730836bc58d17bef86bd0d8ecc64b739004))
-- **2025-07-11**: Added SegmentedControl component with input and FormField integration ([b67a838](https://github.com/persona-id/persona-web/commit/b67a838d9b33b46bd4616ec419ba976a91568b6b))
-- **2025-07-10**: Added Figma Code Connect files for Attribute, Badge, Banner, Button, IconButton, Card, Checkbox, Calendar, DatePicker, DateRangePicker, Modal, Popover, Radio, Select, Slider, Sticker, SwatchPicker, TabBar, Table, TableCellTitle, TextArea, ToggleGroup, ToggleSlider, and Tooltip components ([865220c](https://github.com/persona-id/persona-web/commit/865220c5a14776aed68eab86e73bf538e657444c))
-- **2025-07-10**: Added compact ListBox variant (small size) and ListBoxField form field wrapper ([04c33c7](https://github.com/persona-id/persona-web/commit/04c33c7631c8a2c270c83895b2b13965530911c5))
-- **2025-07-10**: Replaced `jest.fn` with `vi.fn` across 15 design-system spec files as part of Vitest migration ([82e7b78](https://github.com/persona-id/persona-web/commit/82e7b781f27236c0dc3824763cbd615db9cd9905))
-- **2025-07-10**: Replaced remaining `jest.` calls with `vi.` in DateRangePicker and ListBoxField specs ([f3b94c3](https://github.com/persona-id/persona-web/commit/f3b94c3815d2d48ca35cd654908a453775271e77))
-- **2025-07-10**: Replaced `jest.` calls with `vi.` in Link spec as part of Vitest migration ([407e489](https://github.com/persona-id/persona-web/commit/407e4896288dba224b1001815854813f64c40093))
-- **2025-07-10**: Fixed DateRangePicker spec for Vitest compatibility ([76436b9](https://github.com/persona-id/persona-web/commit/76436b9692748bb3a1a09680a9b2f9fc32123b1b))
-- **2025-07-09**: Updated imports in AttributeGrid, IconButton, CheckboxGroupField, inputFields, Table stories, and FilesOverTime to use absolute paths per new ESLint rule ([5fee6e3](https://github.com/persona-id/persona-web/commit/5fee6e3c0bb27172e86a6770e3539263b6d24b0e))
-- **2025-07-08**: Added tooltip support for helper text in config FormField via FormControl ([7e3bf23](https://github.com/persona-id/persona-web/commit/7e3bf2384d0c652bc77e1709c0670f230917e93d))
-- **2025-07-07**: Added ToggleField to FormField inputFields, implementing ToggleSlider as a form field input ([3ca53e7](https://github.com/persona-id/persona-web/commit/3ca53e789f4a67dc27bc063e5f158b7cb5e6cd72))
-- **2025-07-07**: Added ConfigFormGroup component for wrapping config-variant FormFields with shared context ([8707934](https://github.com/persona-id/persona-web/commit/8707934ad17daab9cf6f0844f28f6d717d19659f))
-- **2025-07-07**: Added config variant to FormField that displays label to the left of input for use in dashboard panels ([83cea97](https://github.com/persona-id/persona-web/commit/83cea9724cc3eac40e8cc024ac6968ed3c457a3d))
-- **2025-07-07**: Updated Checkbox to use `inputId` from FormControl context when available, fixing label association in config form fields ([57e48c7](https://github.com/persona-id/persona-web/commit/57e48c7c865e9d43bc172f1959684fbbf5c6b289))
-- **2025-07-07**: Upgraded `@persona-id/design-tokens` dependency from 0.2.22 to 0.2.23 ([9bd4cca](https://github.com/persona-id/persona-web/commit/9bd4cca077732fdfc0ab3117d8cc0b9564226eae))
-- **2025-07-03**: Fixed Select.Header nested dropdown menu rendering by disabling portal and adding unique explicit `id` to prevent id collisions after `@radix-ui/react-dropdown-menu` upgrade ([64d1804](https://github.com/persona-id/persona-web/commit/64d18046bc7734fd7de2d2f502482c1b548e0f4c))
-- **2025-07-02**: Added Link component with animation support, accessibility docs, stories, and specs ([3246bd0](https://github.com/persona-id/persona-web/commit/3246bd0d057828879a9745a2b6804e3c0fb47a8b))
+- **2025-07-30**: Added optional `target` prop to Button to allow overriding the default `_blank` target for external links
+- **2025-07-28**: Added `isRequired` prop to Sticker to show a required asterisk that remains visible when text is truncated
+- **2025-07-25**: Added optional `aria-label` prop to ToggleSlider to allow customizing its accessibility label
+- **2025-07-25**: Added text truncation with overflow indicator to ComboboxMultiSelect compact mode
+- **2025-07-24**: Added `actions` prop support to ListBox items and ListBoxField for rendering per-item action menus
+- **2025-07-23**: Fixed Combobox padding, heights, and sm size support to match Figma designs; extracted inline callbacks to improve performance
+- **2025-07-23**: Removed hover styles from Sticker dismiss buttons
+- **2025-07-22**: Added compact mode to ComboboxMultiSelect that prevents vertical expansion by compressing selected-item stickers
+- **2025-07-22**: Refactored Combobox into ComboboxBase, ComboboxSingleSelect, and ComboboxMultiSelect; added multi-select mode with checkbox highlighting, in-dropdown search, sticker-based selected items, and manual `aria-multiselectable`/`aria-selected` attributes
+- **2025-07-21**: Fixed Menu items without icons rendering at 31px height instead of 32px by removing incorrect height override
+- **2025-07-16**: Added `actions` prop to ListBox and ListBoxField to support per-item action menus
+- **2025-07-14**: Migrated ListBox from `role=listbox`/`role=option` to React Aria's GridList (`role=grid`/`role=row`) as a more appropriate base for planned features
+- **2025-07-11**: Added SegmentedControl component with input and FormField integration
+- **2025-07-10**: Added Figma Code Connect files for Attribute, Badge, Banner, Button, IconButton, Card, Checkbox, Calendar, DatePicker, DateRangePicker, Modal, Popover, Radio, Select, Slider, Sticker, SwatchPicker, TabBar, Table, TableCellTitle, TextArea, ToggleGroup, ToggleSlider, and Tooltip components
+- **2025-07-10**: Added compact ListBox variant (small size) and ListBoxField form field wrapper
+- **2025-07-10**: Replaced `jest.fn` with `vi.fn` across 15 design-system spec files as part of Vitest migration
+- **2025-07-10**: Replaced remaining `jest.` calls with `vi.` in DateRangePicker and ListBoxField specs
+- **2025-07-10**: Replaced `jest.` calls with `vi.` in Link spec as part of Vitest migration
+- **2025-07-10**: Fixed DateRangePicker spec for Vitest compatibility
+- **2025-07-09**: Updated imports in AttributeGrid, IconButton, CheckboxGroupField, inputFields, Table stories, and FilesOverTime to use absolute paths per new ESLint rule
+- **2025-07-08**: Added tooltip support for helper text in config FormField via FormControl
+- **2025-07-07**: Added ToggleField to FormField inputFields, implementing ToggleSlider as a form field input
+- **2025-07-07**: Added ConfigFormGroup component for wrapping config-variant FormFields with shared context
+- **2025-07-07**: Added config variant to FormField that displays label to the left of input for use in dashboard panels
+- **2025-07-07**: Updated Checkbox to use `inputId` from FormControl context when available, fixing label association in config form fields
+- **2025-07-07**: Upgraded `@persona-id/design-tokens` dependency from 0.2.22 to 0.2.23
+- **2025-07-03**: Fixed Select.Header nested dropdown menu rendering by disabling portal and adding unique explicit `id` to prevent id collisions after `@radix-ui/react-dropdown-menu` upgrade
+- **2025-07-02**: Added Link component with animation support, accessibility docs, stories, and specs
 
 ### 2025-06
 
-- **2025-06-27**: Added `textAlign` column alignment option to `TableHeaderCell` component in `DataTable` ([bbd7944](https://github.com/persona-id/persona-web/commit/bbd7944265cc5609e49bcc92e5387601355ff5b5))
-- **2025-06-16**: Added optional `footer` slot to `Modal` component ([68342da](https://github.com/persona-id/persona-web/commit/68342da8dc6b499928f193dfb62eb1106e4e9fd4))
-- **2025-06-16**: Enabled `a11y: { test: 'error' }` parameter in all 44 Storybook story files to fail on accessibility violations during testing ([085d819](https://github.com/persona-id/persona-web/commit/085d819552f8e9b7992ee539246c2881cb2d228a))
-- **2025-06-13**: Updated `high`, `mid`, and `low` box shadow values in `effect.ts` elevation styles to align with updated Figma design tokens ([c0ff522](https://github.com/persona-id/persona-web/commit/c0ff522585f35bf9844b529bc1cdb2087be306c6))
-- **2025-06-11**: Added CSS `transition` to `TextArea` component (using `TransitionDuration.Fast` for all properties except `height` and `width`, which are set to `0s`) ([87d780d](https://github.com/persona-id/persona-web/commit/87d780df33c28c6f0a6f9ed9d728f1f03bec71a0))
-- **2025-06-11**: Fixed `Modal` close button not firing `onOpenChange` callback when clicked; added Jest spec covering the fix ([7b01987](https://github.com/persona-id/persona-web/commit/7b019876b83873456a8ce33f897016de624b1eb2))
-- **2025-06-11**: Removed excessive padding from `Modal` content area, reducing default inner padding set in `Modal.tsx` ([8571362](https://github.com/persona-id/persona-web/commit/8571362411b7c4645a6332733f6dced8af2da5da))
-- **2025-06-11**: Exported `PageHeaderProps` interface from `PageHeader.tsx` (previously unexported) ([1f17af1](https://github.com/persona-id/persona-web/commit/1f17af1814dc951454d0c9cf51ae74a64deff044))
-- **2025-06-09**: Redesigned `Modal` layout to match updated design specs: adjusted header structure, padding, and border styling ([6dabc28](https://github.com/persona-id/persona-web/commit/6dabc28b9ff29e73f4468647813018416e6bdb94))
-- **2025-06-06**: Removed unused `list` prop from `Input` component interface and implementation ([89be90d](https://github.com/persona-id/persona-web/commit/89be90dd6e58f3a59d157bcffa3cb40b42d42aac))
-- **2025-06-05**: Added `list` prop to `Input` component to support HTML datalist associations for RJSF object title display ([533e1e1](https://github.com/persona-id/persona-web/commit/533e1e11475762f8b7c34bd70aedc3ccc30d7dbf))
-- **2025-06-04**: Added `font-weight: light` styling to `Attribute` value when `isPlaceholder` is true, using the `FontWeight` design token ([577c640](https://github.com/persona-id/persona-web/commit/577c6409e817a456575647a00da60a4f1483af20))
-- **2025-06-03**: Removed hover background color from `Tab` buttons and replaced `:focus` with `:focus-visible` for keyboard-only focus ring display ([43cdcd7](https://github.com/persona-id/persona-web/commit/43cdcd7704a7e6f99c37e68d31b85cf5931b4b5d))
+- **2025-06-27**: Added `textAlign` column alignment option to `TableHeaderCell` component in `DataTable`
+- **2025-06-16**: Added optional `footer` slot to `Modal` component
+- **2025-06-16**: Enabled `a11y: { test: 'error' }` parameter in all 44 Storybook story files to fail on accessibility violations during testing
+- **2025-06-13**: Updated `high`, `mid`, and `low` box shadow values in `effect.ts` elevation styles to align with updated Figma design tokens
+- **2025-06-11**: Added CSS `transition` to `TextArea` component (using `TransitionDuration.Fast` for all properties except `height` and `width`, which are set to `0s`)
+- **2025-06-11**: Fixed `Modal` close button not firing `onOpenChange` callback when clicked; added Jest spec covering the fix
+- **2025-06-11**: Removed excessive padding from `Modal` content area, reducing default inner padding set in `Modal.tsx`
+- **2025-06-11**: Exported `PageHeaderProps` interface from `PageHeader.tsx` (previously unexported)
+- **2025-06-09**: Redesigned `Modal` layout to match updated design specs: adjusted header structure, padding, and border styling
+- **2025-06-06**: Removed unused `list` prop from `Input` component interface and implementation
+- **2025-06-05**: Added `list` prop to `Input` component to support HTML datalist associations for RJSF object title display
+- **2025-06-04**: Added `font-weight: light` styling to `Attribute` value when `isPlaceholder` is true, using the `FontWeight` design token
+- **2025-06-03**: Removed hover background color from `Tab` buttons and replaced `:focus` with `:focus-visible` for keyboard-only focus ring display
 
 ### 2025-05
 
-- **2025-05-30**: Bumped `@persona-id/design-tokens` to 0.2.17 to fix secondary button border colors that diverged from Figma parity ([b5f5401](https://github.com/persona-id/persona-web/commit/b5f54017cac49d6e7b7b11ec5256a1c5e97ad7c6))
-- **2025-05-29**: Re-added `data-tour-target` prop support to TabBar component's TitleTab that was accidentally removed ([7118bee](https://github.com/persona-id/persona-web/commit/7118bee46be46b91e691e014032a1cac13035858))
-- **2025-05-28**: Bumped `@persona-id/design-tokens` minimum version to `^0.2.14` to ensure newly-used icons are available without clearing node_modules ([6cacef9](https://github.com/persona-id/persona-web/commit/6cacef9979f46509535bc982892c33a508291a6d))
-- **2025-05-23**: Fixed DatePicker overflow by wrapping the inner group div with `position: relative` ([3c1ca1b](https://github.com/persona-id/persona-web/commit/3c1ca1b1a842947f053eb25413e620a95aea62a0))
-- **2025-05-21**: Added new DropdownButton component that composes Button and DropdownMenu with a CaretDown icon trigger, supporting `menuItems`, `menuProps`, and `side` props ([22622e2](https://github.com/persona-id/persona-web/commit/22622e24776507e2f1cab901841b4025c164d337))
-- **2025-05-13**: Refactored Checkbox container to use Stack component for layout, changed label color from `TextSecondary` to `TextPrimary`, and removed explicit padding from label ([83967cd](https://github.com/persona-id/persona-web/commit/83967cdffd4483453cd22e5cda6bbb993ab676c8))
-- **2025-05-05**: Fixed Sticker padding for visual centering and bumped `@persona-id/design-tokens` to 0.2.9 for corrected Sticker colors ([a4423ea](https://github.com/persona-id/persona-web/commit/a4423ea212f58018784c0da23a93ace4a931bfc4))
-- **2025-05-05**: Marked Card story image as ignored in Chromatic to prevent snapshot flakes ([8f1fc1d](https://github.com/persona-id/persona-web/commit/8f1fc1db65bfc2f3a2485ebb1ac0f5cd021f20e4))
-- **2025-05-02**: Upgraded tsup to 8.4.0, removing the outdated bundled esbuild version ([7217d7d](https://github.com/persona-id/persona-web/commit/7217d7d138beed331dc4c16d7876cbc0f40a1c6e))
-- **2025-05-01**: Exposed `Menu.Heading`, `Menu.Divider`, and `Menu.Item` as static properties on the Menu component ([0babcdc](https://github.com/persona-id/persona-web/commit/0babcdcfbc68c0cde5c4594d0e8cf68cbe565935))
-- **2025-05-01**: Added `id` and `disabled` props to DatePicker component, forwarding them to the inner DateField ([7db73e8](https://github.com/persona-id/persona-web/commit/7db73e89a9885beed2cfd9e9fba6e8035d8d8b18))
+- **2025-05-30**: Bumped `@persona-id/design-tokens` to 0.2.17 to fix secondary button border colors that diverged from Figma parity
+- **2025-05-29**: Re-added `data-tour-target` prop support to TabBar component's TitleTab that was accidentally removed
+- **2025-05-28**: Bumped `@persona-id/design-tokens` minimum version to `^0.2.14` to ensure newly-used icons are available without clearing node_modules
+- **2025-05-23**: Fixed DatePicker overflow by wrapping the inner group div with `position: relative`
+- **2025-05-21**: Added new DropdownButton component that composes Button and DropdownMenu with a CaretDown icon trigger, supporting `menuItems`, `menuProps`, and `side` props
+- **2025-05-13**: Refactored Checkbox container to use Stack component for layout, changed label color from `TextSecondary` to `TextPrimary`, and removed explicit padding from label
+- **2025-05-05**: Fixed Sticker padding for visual centering and bumped `@persona-id/design-tokens` to 0.2.9 for corrected Sticker colors
+- **2025-05-05**: Marked Card story image as ignored in Chromatic to prevent snapshot flakes
+- **2025-05-02**: Upgraded tsup to 8.4.0, removing the outdated bundled esbuild version
+- **2025-05-01**: Exposed `Menu.Heading`, `Menu.Divider`, and `Menu.Item` as static properties on the Menu component
+- **2025-05-01**: Added `id` and `disabled` props to DatePicker component, forwarding them to the inner DateField
 
 ### 2025-04
 
-- **2025-04-28**: Fixed Checkbox by removing invalid `aria-checked` from the visual box element, and moved `aria-readonly` to the correct switch role element in ToggleSlider for improved accessibility ([6c8ac6c](https://github.com/persona-id/persona-web/commit/6c8ac6c6f610dabd5542a5cfada4f1b1fd570d2e))
-- **2025-04-23**: Added `hasError` prop to DateField component to support form validation error state ([bd3f39b](https://github.com/persona-id/persona-web/commit/bd3f39bb1b69e85019325e5f6c981caea8091213))
-- **2025-04-23**: Replaced `fieldStyle` prop on DatePicker/DateField with a generic `dateFieldProps` hash to allow passing arbitrary props to the inner InputBox ([2e83c39](https://github.com/persona-id/persona-web/commit/2e83c392e695bf481434905d55c42d72ca925c95))
-- **2025-04-23**: Added `width: fit-content` to `TextWithDashedUnderline` styled component in TextUnderlineTooltip ([2206e3e](https://github.com/persona-id/persona-web/commit/2206e3e427b18b26d830e12fa570554d71b683e6))
-- **2025-04-22**: Added `style` prop to DateField and `fieldStyle` prop to DatePicker to allow custom styling of the date input container ([7a1ff6d](https://github.com/persona-id/persona-web/commit/7a1ff6d8166563fdc6f8002e484eb937182e678b))
-- **2025-04-14**: Changed TabBar `TitleTab` font weight from Bold to Medium ([f65b79b](https://github.com/persona-id/persona-web/commit/f65b79bcdbd153335e92b2e1f5e0cc66b8231a21))
-- **2025-04-14**: Added theme-aware `color` prop support to the `TabularNumber` Text variant using the `theme.color.text` palette ([5c3b54b](https://github.com/persona-id/persona-web/commit/5c3b54bc8e6d87546ba9ea1658dfb2b8a32f94d5))
-- **2025-04-11**: Added `TransitionDuration.ExtraFast` (100ms) value to the transitions enum ([fb12e48](https://github.com/persona-id/persona-web/commit/fb12e48a5fd7a9502a32eb318921937772e72b8c))
-- **2025-04-10**: Bumped `@persona-id/design-tokens` dependency from `^0.2.4` to `^0.2.6` ([8247eb3](https://github.com/persona-id/persona-web/commit/8247eb3f192c3d248ec94be25eea4c36457315a0))
-- **2025-04-09**: Added new `TextUnderlineTooltip` component (with `TextWithDashedUnderline` styled span) to the Tooltip module, exported from index, with Storybook story and MDX docs; exported `TooltipStandardProps` interface ([f14f920](https://github.com/persona-id/persona-web/commit/f14f920d0d1f9be76f8a706dc1414077774d8c52))
-- **2025-04-09**: Added saved view overflow support to TabBar: introduced `ConfigContext` with `isTabBarOverflowEnabled` flag, converted `TabContainer` and `TabBar` to `forwardRef`, added `overflow: hidden` gating on `StyledTabContainer`, and fixed bottom-border clipping with negative margin/padding offset ([5b591d8](https://github.com/persona-id/persona-web/commit/5b591d82cb871b1c81f9d469cc6b9559383a73f2))
-- **2025-04-04**: Updated TabBar design: changed bottom border from 2px to 1px on both `TabBarContainer` and `Tab` active indicator, added `TitleTab` styled component with bold font weight, and added `title` prop to `TabBar` ([203695e](https://github.com/persona-id/persona-web/commit/203695e25a45f5e8197dc02aeeb8f7a821129b0a))
+- **2025-04-28**: Fixed Checkbox by removing invalid `aria-checked` from the visual box element, and moved `aria-readonly` to the correct switch role element in ToggleSlider for improved accessibility
+- **2025-04-23**: Added `hasError` prop to DateField component to support form validation error state
+- **2025-04-23**: Replaced `fieldStyle` prop on DatePicker/DateField with a generic `dateFieldProps` hash to allow passing arbitrary props to the inner InputBox
+- **2025-04-23**: Added `width: fit-content` to `TextWithDashedUnderline` styled component in TextUnderlineTooltip
+- **2025-04-22**: Added `style` prop to DateField and `fieldStyle` prop to DatePicker to allow custom styling of the date input container
+- **2025-04-14**: Changed TabBar `TitleTab` font weight from Bold to Medium
+- **2025-04-14**: Added theme-aware `color` prop support to the `TabularNumber` Text variant using the `theme.color.text` palette
+- **2025-04-11**: Added `TransitionDuration.ExtraFast` (100ms) value to the transitions enum
+- **2025-04-10**: Bumped `@persona-id/design-tokens` dependency from `^0.2.4` to `^0.2.6`
+- **2025-04-09**: Added new `TextUnderlineTooltip` component (with `TextWithDashedUnderline` styled span) to the Tooltip module, exported from index, with Storybook story and MDX docs; exported `TooltipStandardProps` interface
+- **2025-04-09**: Added saved view overflow support to TabBar: introduced `ConfigContext` with `isTabBarOverflowEnabled` flag, converted `TabContainer` and `TabBar` to `forwardRef`, added `overflow: hidden` gating on `StyledTabContainer`, and fixed bottom-border clipping with negative margin/padding offset
+- **2025-04-04**: Updated TabBar design: changed bottom border from 2px to 1px on both `TabBarContainer` and `Tab` active indicator, added `TitleTab` styled component with bold font weight, and added `title` prop to `TabBar`