@persona/design-system 0.1.5-pre.4

package/CHANGELOG.md

@@ -0,0 +1,461 @@
+# Changelog
+
+Summary of changes to the @persona/design-system package.
+
+## [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))
+
+## [0.1.4] - 2026-06-30
+
+- **2026-06-30**: Moved `react-router-dom` from `dependencies` to `peerDependencies` (`^6.30.1`)
+  so external consumers bring a single compatible router copy instead of receiving a transitive
+  install that can diverge from their own `react-router-dom` version. Two router copies in a bundle
+  produce separate router contexts, causing design-system `<Link>` and `<Button to=…>` to render
+  outside the consumer's `<RouterProvider>`. Mirrors the v0.1.3 `react-dom` peer-dep treatment.
+
+## [0.1.3] - 2026-06-26
+
+- **2026-06-26**: Made the published bundle work in external Vite/browser consumers without shims:
+  externalized `react-dom` (moved to `peerDependencies`) so it is no longer inlined as a CJS factory
+  that `require("react")` at runtime, and internalized the `useModalInsetRight` hook into the package
+  (`lib/useModalInsetRight.ts`) so `Modal` no longer emits a dangling `lib/hooks/useModalInsetRight`
+  import. Consumers can now drop the design-system `optimizeDeps` and `resolve.alias` workarounds.
+
+## [0.1.2] - 2026-06-25
+
+- **2026-06-25**: Package tidy up and v0.1.2 release
+- **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
+  ([5dec664](https://github.com/persona-id/persona-web/commit/5dec664f9786ddc1bd34f4a38ec86a86dab55bc4))
+- **2026-06-22**: Removed final dashboard dependencies from design-system (`useToggle`,
+  `intersperse`)
+  ([cf0f9d5](https://github.com/persona-id/persona-web/commit/cf0f9d50562b19188ccb6ea8955f4459e98ec3b1))
+- **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
+  ([a999a36](https://github.com/persona-id/persona-web/commit/a999a36af0bcc583b98f62ec0433b34797e6de8a))
+- **2026-06-03**: Added multiselect Combobox trigger support
+  ([bc54602](https://github.com/persona-id/persona-web/commit/bc54602e48826def2136b39265bfeb77a8553498))
+- **2026-06-02**: Added `splitOutFormFieldProps` helper for FormField definition
+  ([cb75bf5](https://github.com/persona-id/persona-web/commit/cb75bf5e18029dd21d3747db03c15f78bf78c541))
+- **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
+  ([77c40ec](https://github.com/persona-id/persona-web/commit/77c40ecb8aefe4a40211c6a74ba7c96647f4dfad))
+- **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
+  ([90a9126](https://github.com/persona-id/persona-web/commit/90a9126bc8e68a86d33be50694e64cc1c4afb219))
+- **2026-05-20**: Added SmartTextInputField FormField wrapper
+  ([3be55d1](https://github.com/persona-id/persona-web/commit/3be55d11462fd6a2d5b90e3d575593ed7194582b))
+- **2026-04-22**: Upgraded TypeScript to v6.0.3
+  ([215ed53](https://github.com/persona-id/persona-web/commit/215ed53ebb59937a2957988d376344444f577c6f))
+- **2026-04-20**: Added drag-and-drop row reordering to TableBox
+  ([ff96b87](https://github.com/persona-id/persona-web/commit/ff96b87fb333f5ae8cdf66a4eaf009284c41c4c1))
+- **2026-04-17**: Added PDSProvider composing ThemeProvider and ComponentRegisterProvider
+  ([43350be](https://github.com/persona-id/persona-web/commit/43350be69f60001a81528349a535a009a1bfa570))
+- **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
+  ([ffbb137](https://github.com/persona-id/persona-web/commit/ffbb137c22b733416c643303f49798685be5b6c9))
+- **2026-03-17**: Added text truncation with ellipses to ListBox items
+  ([c304a1f](https://github.com/persona-id/persona-web/commit/c304a1fbcd1cff6b4c16d5049e3c7b6e28fca686))
+- **2026-03-04**: Added FileIcon and FileAttachment components
+  ([dc3f9fb](https://github.com/persona-id/persona-web/commit/dc3f9fbb759f475699abb208472dbed587d12e6a))
+- **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
+  ([1507b16](https://github.com/persona-id/persona-web/commit/1507b16fecb7b2bdb983fac66c2c44f2c8030901))
+- **2026-01-22**: Added ComboboxField and removed ReactSelectField
+  ([bd1d345](https://github.com/persona-id/persona-web/commit/bd1d3454501f2f68b211ecd10f6733721e12d70f))
+- **2026-01-20**: Renamed ToggleGroup to ButtonGroup
+  ([42eb328](https://github.com/persona-id/persona-web/commit/42eb328ca8d361e99b0305be59d1855bff03c92d))
+- **2026-01-14**: Renamed ToggleSlider component to Toggle
+  ([38170af](https://github.com/persona-id/persona-web/commit/38170af22750b7dc55ffd74ef2dc3b762f32f78d))
+
+## [0.1.1] - 2026-01-13
+
+- **2026-01-13**: Package tidy up and v0.1.1 release
+  ([1f75c78](https://github.com/persona-id/persona-web/commit/1f75c784524967c78debfdbb7390282d8a151d04))
+- **2026-01-12**: Made DatePicker accessible using keyboard navigation
+  ([235e6f3](https://github.com/persona-id/persona-web/commit/235e6f397c3b4198169d6e16e0632fbee0370c7c))
+- **2026-01-09**: Corrected semantic button usage in Card section headings
+  ([ec88857](https://github.com/persona-id/persona-web/commit/ec88857cf50bdc97ebc88dff02f4bd62673aeeee))
+- **2026-01-08**: Added CommonJS (CJS) output to build configuration
+  ([b520887](https://github.com/persona-id/persona-web/commit/b520887e13e1336ea82b0716c81cf9f31f356683))
+- **2026-01-08**: Added hideLabel support to FormField component
+  ([8a4e311](https://github.com/persona-id/persona-web/commit/8a4e3117c30630f04a208a9c6bf579c5d95678b9))
+- **2026-01-08**: Removed react-outside-click-handler dependency in favor of internal implementation
+  ([3d141eb](https://github.com/persona-id/persona-web/commit/3d141eb6643aac176b788da07993ff421ee47c3f))
+- **2026-01-08**: Added drag and drop reordering functionality to ListBox
+  ([33c2e11](https://github.com/persona-id/persona-web/commit/33c2e11bff0b32f4e92bc593d4746f006092f0b8))
+- **2026-01-07**: Updated package configuration for npm release
+  ([e757a04](https://github.com/persona-id/persona-web/commit/e757a04f54f6e8f8529bbb8ef82bf408bd50ecee))
+- **2026-01-07**: Fixed security issue by using unguessable ID attributes for ToggleSlider
+  ([b0e02c4](https://github.com/persona-id/persona-web/commit/b0e02c43f09c6fc99118ed41973f30975331a747))
+
+### 2025-12
+
+- **2025-12-19**: Added ARIA attributes to DateFilter for improved accessibility
+  ([fb34826](https://github.com/persona-id/persona-web/commit/fb348268771da29f0e9940ac40d795a64424c914))
+- **2025-12-19**: Refactored DateRange component definition out of render function
+  ([96f1597](https://github.com/persona-id/persona-web/commit/96f1597d3fa159cb851d14d6fdadf2c970f209b3))
+- **2025-12-19**: Labeled DateRange preset buttons for accessibility
+  ([806825c](https://github.com/persona-id/persona-web/commit/806825c0bbe71d9d165f43d5a18d0483da80911b))
+- **2025-12-18**: Migrated Modal to react-aria implementation
+  ([e1039be](https://github.com/persona-id/persona-web/commit/e1039be97414a2f9738d035bc2707e372310d4ed))
+- **2025-12-18**: Removed unused import from ListBox component
+  ([269e407](https://github.com/persona-id/persona-web/commit/269e40703acf462b4e8d23179d4cc01092988946))
+- **2025-12-17**: Cleaned up CardV2 feature flag references in Section and LoadingShimmer
+  ([5e04ddc](https://github.com/persona-id/persona-web/commit/5e04ddc8f99a626a91e66292709e6094b581d4c8))
+- **2025-12-17**: Updated DatePicker focus styles to match design specifications
+  ([160f12c](https://github.com/persona-id/persona-web/commit/160f12ccd4760bcfb1f39c6e4876aa70691828f9))
+- **2025-12-16**: Updated @persona-id/design-tokens to v0.3.9
+  ([14afab1](https://github.com/persona-id/persona-web/commit/14afab17b3d6f35735f4c8434f433778f12de760))
+- **2025-12-15**: Added overflow handling to Modal content
+  ([da2dab3](https://github.com/persona-id/persona-web/commit/da2dab30caec6e899bcf111454d66605a750b6cd))
+- **2025-12-15**: Made Toast component more accessible
+  ([d78adfb](https://github.com/persona-id/persona-web/commit/d78adfbfb8a0c4e064970b069c39176b396c52c2))
+- **2025-12-15**: Added tab component support in Modal
+  ([066dfd3](https://github.com/persona-id/persona-web/commit/066dfd34cad55a1fc47e10a9601af43671844695))
+- **2025-12-12**: Fixed ListBox to prevent delete button from triggering item selection
+  ([4f8c4e3](https://github.com/persona-id/persona-web/commit/4f8c4e3869e6ee6250998b55076a23d53f19887e))
+- **2025-12-11**: Added containerProps support to CardV2 Card component for passing props to
+  CardContainer
+  ([136551d](https://github.com/persona-id/persona-web/commit/136551d9c51f82522e637f96f5a3bc2611e3737e))
+- **2025-12-10**: Fixed Sticker spacing issue for SimulatedData component
+  ([217ffd1](https://github.com/persona-id/persona-web/commit/217ffd1cdb5c003f7ff720c43beeaf9c901c56a4))
+- **2025-12-09**: Updated @persona-id/design-tokens to v0.3.8
+  ([63d055e](https://github.com/persona-id/persona-web/commit/63d055eaafe71b55f211563a2ba1df8d7dd08874))
+- **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
+  ([5e46239](https://github.com/persona-id/persona-web/commit/5e4623999aeb0f115d61f1b37ed14481557ddb56))
+- **2025-12-09**: Enhanced StatusIndicator with label-only variant (showIcon prop) and migrated to
+  semantic design tokens
+  ([20fe7e3](https://github.com/persona-id/persona-web/commit/20fe7e3f1b69e3fa5eb12f9e89c9c9a979f0cc2d))
+- **2025-12-05**: Added support for passing container ref to Combobox when portalling dropdown
+  ([c1d60a8](https://github.com/persona-id/persona-web/commit/c1d60a8171d15a322d087d063f6d2f67e68d7c1a))
+
+### 2025-11
+
+- **2025-11-26**: Added maxHeight prop to Popover component with overflow handling
+  ([885efa6](https://github.com/persona-id/persona-web/commit/885efa66879494d5d042b40d7660ecaf2c63366e))
+- **2025-11-21**: Updated @persona-id/design-tokens to v0.3.5
+  ([164914e](https://github.com/persona-id/persona-web/commit/164914e61a980cd8eb6402899492c3914408531b))
+- **2025-11-20**: Fixed ListBox dropdown bugs: added outside click handling, refactored heading
+  component, fixed form field overflow
+  ([b32f7e0](https://github.com/persona-id/persona-web/commit/b32f7e0e47c792357b66fc80fe56c7e451ca159a))
+- **2025-11-20**: Updated CardV2 link buttons to behave like links
+  ([842ccbc](https://github.com/persona-id/persona-web/commit/842ccbcb1972b5966f8fd04c12be76be19bfee75))
+- **2025-11-20**: Changed default Banner variant from 'basic' to 'informational'
+  ([116c6ff](https://github.com/persona-id/persona-web/commit/116c6ffcdb828f376601d52e8af489b91f7addc1))
+- **2025-11-18**: Added StatusIndicator component to design system
+  ([ddbfe66](https://github.com/persona-id/persona-web/commit/ddbfe66abdcd8f56a521e5037bd218da7eb69f52))
+- **2025-11-18**: Added Figma design links to component stories (RangeCalendar, Link, Modal,
+  Popover, Select, Slider, SwatchPicker, DropdownButton, DropdownMenu)
+  ([9cb7056](https://github.com/persona-id/persona-web/commit/9cb705621ca06b16e0279edbf2bc58b907b3520f))
+- **2025-11-14**: Refactored AttributeGrid horizontal layout
+  ([58fac96](https://github.com/persona-id/persona-web/commit/58fac968098929a05c70f642085a73d5bf9db1a6))
+- **2025-11-13**: Fixed DatePicker calendar selection not appearing
+  ([97d9030](https://github.com/persona-id/persona-web/commit/97d903057dd18bb6d62226d52510b94b653557f4))
+- **2025-11-12**: Updated CheckBoxField and SegmentedControlField to respect labelProps
+  ([8d4696b](https://github.com/persona-id/persona-web/commit/8d4696bdc358bc656ca93e112f4a9d27f704de90))
+- **2025-11-06**: Removed form HTML from Button documentation
+  ([a85da55](https://github.com/persona-id/persona-web/commit/a85da555582622b35417f2b2d1ef7efeb0ed900a))
+- **2025-11-05**: Added row dropdown rendering support to ListBox with inline editing capabilities
+  ([a669a01](https://github.com/persona-id/persona-web/commit/a669a01821f14781355722f8c11d160f4e1f4cb3))
+- **2025-11-04**: Fixed Combobox to prevent search from re-ordering options
+  ([53b1354](https://github.com/persona-id/persona-web/commit/53b1354b66d14368501536795a8582b52be23dee))
+- **2025-11-04**: Updated Tooltip size variant to small for FLE components
+  ([2932cac](https://github.com/persona-id/persona-web/commit/2932cac06a4f30490fd1885b8e83063fdd74f2be))
+- **2025-11-03**: Fixed CardV2 heading layout to use flex instead of fixed width
+  ([7d6e8af](https://github.com/persona-id/persona-web/commit/7d6e8af4b6916d7334d7c72918573dbf56857b1f))
+
+### 2025-10
+
+- **2025-10-29**: Updated ListBox stories to make Playground a functional add/delete example
+  ([5d6819c](https://github.com/persona-id/persona-web/commit/5d6819cea841405475e4c68696852ac7aea72400))
+- **2025-10-28**: Fixed CardV2 header accordion icon positioning to prevent overflow
+  ([571015](https://github.com/persona-id/persona-web/commit/571015302e2902fb8efc81058d86bdf71196a35b))
+- **2025-10-26**: Added Toast component to design system with info, success, and error variants
+  ([57b9881](https://github.com/persona-id/persona-web/commit/57b988161b2ad2a3f52fec26b02efb6c0165de26))
+- **2025-10-24**: Fixed CardV2 to collapse correctly on Safari
+  ([b5a9450](https://github.com/persona-id/persona-web/commit/b5a94505cdb0d701a317690bff452007c59b652b))
+- **2025-10-24**: Adjusted CardV2 container padding when collapsed
+  ([9d57f04](https://github.com/persona-id/persona-web/commit/9d57f043600a23d53c581ba9dd2167d5d8434ff7))
+- **2025-10-23**: Migrated dashboard to react-router v6 API
+  ([fea315c](https://github.com/persona-id/persona-web/commit/fea315ce25d3e23791001809f612947658968baf))
+- **2025-10-23**: Updated Menu text style and padding based on size prop
+  ([b4cf258](https://github.com/persona-id/persona-web/commit/b4cf25865384762021a6f0e673f1a06300ec9884))
+- **2025-10-23**: Updated TableBox to use small text styles
+  ([af562a6](https://github.com/persona-id/persona-web/commit/af562a65748c11a82830650f22f6babd17431aaa))
+- **2025-10-23**: Implemented size context inheritance for ListBox with small variant for config
+  fields
+  ([24e381e](https://github.com/persona-id/persona-web/commit/24e381eee59ec6d4a6e021b5ab80dbe8858d823c))
+- **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
+  ([769c8e4](https://github.com/persona-id/persona-web/commit/769c8e4bd982a532e0b098ca4c5753e9bd768156))
+- **2025-10-22**: Added usePortal functionality for Combobox dropdown rendering
+  ([0344432](https://github.com/persona-id/persona-web/commit/0344432bcf865a2b2dcec35bb548e16783fb720c))
+- **2025-10-21**: Fixed dashboard nav links accessibility support
+  ([a96854d](https://github.com/persona-id/persona-web/commit/a96854d9f3009bf1dd620ebc508a241b06da50d0))
+- **2025-10-21**: Added ability to customize font in Combobox option labels
+  ([62c88bb](https://github.com/persona-id/persona-web/commit/62c88bb5bd308f39fee89a1ad7c3c9701d28a8b2))
+- **2025-10-20**: Enabled using stickers for Combobox option labels
+  ([f743448](https://github.com/persona-id/persona-web/commit/f743448222fb00d171476393772027e5f9d957d6))
+- **2025-10-20**: Prevented horizontal scroll from truncate in Combobox
+  ([ee6fc38](https://github.com/persona-id/persona-web/commit/ee6fc3865c731c68f8a332f468cf707e40485559))
+- **2025-10-18**: Fixed ESLint and Prettier issues in TabBar
+  ([0570674](https://github.com/persona-id/persona-web/commit/0570674ef910fe845036510453a764a89d8e6d5f))
+- **2025-10-16**: Rebuilt CardV2 padding for height behavior
+  ([d467c8d](https://github.com/persona-id/persona-web/commit/d467c8d6690605c89ff39b1401d29e1622542f09))
+- **2025-10-16**: Fixed CardV2 SectionHeading spacing and layout issues
+  ([ca14436](https://github.com/persona-id/persona-web/commit/ca14436a3e2e906d7600588ad4d4a1f2a3bfbadb))
+- **2025-10-16**: Added export to RangeCalendar for props parsing
+  ([9ca83fa](https://github.com/persona-id/persona-web/commit/9ca83faa6e2d407b4bb92294d433635ec0023d08))
+- **2025-10-16**: Added support for array of footer items in CardV2 for correct styling
+  ([5911e1a](https://github.com/persona-id/persona-web/commit/5911e1ae7d4dd41b69f3f2315d580f9f432bf8dc))
+- **2025-10-16**: Added sticky heading/footer support to CardV2
+  ([195e0c3](https://github.com/persona-id/persona-web/commit/195e0c3d1fd40d6a19b0f80836e2b2b9dcb6fa42))
+- **2025-10-14**: Updated design-tokens to include new icons
+  ([b8bfa5d](https://github.com/persona-id/persona-web/commit/b8bfa5d0d6367b4a8d4ca92871950e39477b6758))
+- **2025-10-14**: Removed double role="menu" from DropdownMenu
+  ([916b8a9](https://github.com/persona-id/persona-web/commit/916b8a9aa7c8e1632f2b0a1a98c70318a53f3eee))
+- **2025-10-14**: Added Combobox inline editing support to TableBox cells
+  ([12a5d76](https://github.com/persona-id/persona-web/commit/12a5d76921beddab0fb6970355671ef6d33f43e9))
+- **2025-10-10**: Added size prop to TabBar component with small variant
+  ([b05f879](https://github.com/persona-id/persona-web/commit/b05f87946b768e81e5203ee1e673f4e4b0c01cd6))
+- **2025-10-10**: Added heading truncation to CardV2
+  ([769c5d5](https://github.com/persona-id/persona-web/commit/769c5d5787184ddb75e6503e7fa2145c726018c0))
+- **2025-10-10**: Added grouped options support to Combobox
+  ([515050e](https://github.com/persona-id/persona-web/commit/515050ed81d0bc1d419ef379c45c27b5dfaf3635))
+- **2025-10-08**: Added small loader to design system
+  ([a9c72ac](https://github.com/persona-id/persona-web/commit/a9c72ac2b5f2c285ffb967290c125aa576a86314))
+- **2025-10-08**: Promoted LoadingShimmer component to PDS
+  ([6ec2373](https://github.com/persona-id/persona-web/commit/6ec2373636c6e5172eebf20636259c330a7d0d85))
+- **2025-10-08**: Added maxTabChars option to truncate long tab names
+  ([04084ef](https://github.com/persona-id/persona-web/commit/04084efd7bcc2ad71419a98ce7ab64db734eb6cd))
+- **2025-10-08**: Fixed CardV2 heading margin when collapsed and removed footer divider when no body
+  present
+  ([4b67f4e](https://github.com/persona-id/persona-web/commit/4b67f4e5584339a9679bfa8dcb798cd4f12c27ab))
+- **2025-10-07**: Added empty state support to CardV2
+  ([cebc0ae](https://github.com/persona-id/persona-web/commit/cebc0ae62c5b29035127b2159713da698f0eff32))
+- **2025-10-07**: Improved CardV2 caret animation speed
+  ([bc8124b](https://github.com/persona-id/persona-web/commit/bc8124be5d28db5860347f26cc4f956b929cf1e2))
+- **2025-10-07**: Added compact font size support for DataTable headers
+  ([451861](https://github.com/persona-id/persona-web/commit/451861350d7b7dd7634a895917f7850c095b3ce4))
+- **2025-10-07**: Added error state and error boundary to CardV2
+  ([03b9ef2](https://github.com/persona-id/persona-web/commit/03b9ef28a52361db82b68d229092c8ab1151b066))
+- **2025-10-06**: Added smBold size option for paragraph text mixins
+  ([e35e3ce](https://github.com/persona-id/persona-web/commit/e35e3ce1b2bd95887b73913ecee1a72ea0c7cfce))
+- **2025-10-06**: Corrected default button color in Storybook
+  ([b0bd2e8](https://github.com/persona-id/persona-web/commit/b0bd2e8961d0c5aacbab06f086123f5ca2aae7e8))
+- **2025-10-06**: Updated non-accessible text to use text/secondary color
+  ([af1f9ed](https://github.com/persona-id/persona-web/commit/af1f9ed71864b312d6da04cd658505b2387b2304))
+- **2025-10-03**: Updated @persona-id/design-tokens to v0.2.41
+  ([b1f4a77](https://github.com/persona-id/persona-web/commit/b1f4a7736ffad46a7a94388bc32a7677ed20f4a7))
+- **2025-10-03**: Unset isDisabled on CardV2 disclosure button
+  ([89970fc](https://github.com/persona-id/persona-web/commit/89970fc998496e470a3d01588860b40a91ac660b))
+- **2025-10-03**: Bumped react-aria-components from 1.6.0 to 1.13.0
+  ([6394bf4](https://github.com/persona-id/persona-web/commit/6394bf4c6303f5ca806670965cc9cc54fed85aa4))
+- **2025-10-03**: Updated design-token package
+  ([52c66c8](https://github.com/persona-id/persona-web/commit/52c66c8e2aa5ba567d24ee13b63a48ed984d542a))
+- **2025-10-03**: Upgraded radix-ui packages
+  ([3aa6e4c](https://github.com/persona-id/persona-web/commit/3aa6e4c12eccaaaa2d613b16371e9f6e8eab5e1b))
+- **2025-10-02**: Renamed Combobox compact prop to truncate
+  ([c313fd9](https://github.com/persona-id/persona-web/commit/c313fd9955a8e1170f49e5273b0b8e186a65116b))
+- **2025-10-02**: Fixed compact single select Combobox display in DataTable
+  ([85db3a7](https://github.com/persona-id/persona-web/commit/85db3a78736408baf6ca0ab64d938903761965f7))
+- **2025-10-02**: Reworked ESLint rules around Combobox importing
+  ([520966](https://github.com/persona-id/persona-web/commit/520966056a6af53517b0ba240b2edc393003aacf))
+- **2025-10-02**: Updated SegmentedControl border color
+  ([3ae144f](https://github.com/persona-id/persona-web/commit/3ae144ff6cb2b1e55ad8ff105ed430a46d00938e))
+- **2025-10-02**: Prevented CardV2 container from flex shrinking
+  ([026786e](https://github.com/persona-id/persona-web/commit/026786e187878a99e9a6e2b665b78f00fc2e1d05))
+- **2025-10-01**: Corrected small Button left/right padding
+  ([dd39d9e](https://github.com/persona-id/persona-web/commit/dd39d9ebeed989a8ff51f6d9f6692b567eb8620d))
+- **2025-10-01**: Marked Spacer component as deprecated
+  ([db6a5b4](https://github.com/persona-id/persona-web/commit/db6a5b435da1c598447ca248e9e235101947bb25))
+- **2025-10-01**: Added hover state to TabBar
+  ([bf90c00](https://github.com/persona-id/persona-web/commit/bf90c0002ff2caba3b87dffba8ecabe36a45986e))
+
+### 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-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-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-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-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-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))

package/LICENSE

@@ -0,0 +1,77 @@
+Persona UI Libraries License Agreement
+
+Last Updated: June 22, 2026
+
+This License Agreement (“Agreement”) governs your use of any Persona UI libraries, including all vector files, Figma components, JavaScript components, UI elements, and related design assets or JavaScript code (which may be referred to as the “Components” and “Primitives”), made available by Persona Identities, Inc. (“Persona,” “we,” “us,” or “our”).
+
+By downloading, accessing, copying, or using any Persona UI libraries, you agree to this Agreement. If you do not agree, do not use any Persona UI libraries.
+
+If you are using the Persona UI libraries on behalf of a company or organization, you represent that you have authority to bind that entity to this Agreement.
+
+1. License Grant (Free, Proprietary License)
+
+Persona grants you a limited, non-exclusive, non-transferable, non-sublicensable, revocable, royalty-free license to:
+Use the Components or Primitives in applications that integrate with or use Persona products.
+Use the Components or Primitives in mockups, demos, prototypes, or internal tools.
+Use the Components or Primitives for educational purposes (e.g., school projects, hackathons).
+Use the Components or Primitives in personal or side projects that do not compete with Persona.
+Modify, resize, and adapt the Components or Primitives for the above purposes.
+
+You may incorporate the Components or Primitives into compiled applications, rendered user interfaces, or static exports (e.g., PNG, PDF, design prototypes), provided the Components or Primitives are not distributed in extractable source format.
+
+All rights not expressly granted are reserved by Persona.
+
+2. Ownership
+
+The Components or Primitives are licensed, not sold. Persona and its licensors retain all right, title, and interest in and to the Components or Primitives, including all intellectual property rights.
+
+This Agreement does not grant you any ownership rights in the Components or Primitives.
+
+3. Restrictions
+
+You may not:
+
+(a) Redistribute the Components or Primitives as Assets
+Sell, sublicense, publish, share, or otherwise redistribute the Components or Primitives in source, editable, or extractable format, including:
+Uploading to public repositories (including GitHub) as standalone assets
+Distributing via design systems or shared Figma libraries accessible outside your organization
+Posting to asset marketplaces
+Making them available as downloadable files
+
+(b) Use in Competitive Products
+Use the Components or Primitives in connection with the development, marketing, or sale of any product or service that competes with Persona’s identity verification, onboarding, fraud prevention, or related services.
+
+(c) Open Source Distribution
+Include the Components or Primitives in any open source project or distribute them under any open source or similar license.
+
+(d) Standalone Commercialization
+Use the Components or Primitives as a standalone product or as the primary value of a product or service.
+
+(e) Illegal or Harmful Use
+Use the Components or Primitives for any unlawful, fraudulent, deceptive, infringing, or harmful purpose.
+
+(f) Remove Notices
+Remove or alter any proprietary rights notices included with the Components or Primitives.
+
+(g) Imply Endorsement
+Use the Components or Primitives in a way that suggests Persona sponsors, endorses, or is affiliated with your project beyond your legitimate use of Persona products.
+
+4. Termination
+
+This Agreement is effective upon your first download or use of the Components or Primitives and continues until terminated.
+
+Persona may terminate this Agreement if you violate its terms. Upon termination, you must stop using the Components or Primitives and delete all copies in your possession or control, except as embedded in applications distributed in compliance with this Agreement prior to termination.
+
+5. Disclaimer
+
+The Components or Primitives are provided “AS IS” without warranties of any kind, whether express, implied, or statutory. Persona disclaims all implied warranties, including merchantability, fitness for a particular purpose, title, and non-infringement.
+
+6. Limitation of Liability
+
+To the maximum extent permitted by law, Persona will not be liable for any indirect, incidental, special, consequential, or punitive damages arising out of or related to your use of the Components or Primitives.
+
+Persona’s total cumulative liability under this Agreement will not exceed USD $100.
+
+7. Governing Law
+
+This Agreement is governed by the laws of the State of Delaware, without regard to conflict of law principles.

package/README.md

@@ -0,0 +1,9 @@
+# Persona Design System
+
+This project contains everything related to the Persona Design System.
+
+## Installation
+
+```
+yarn add @persona/design-system @persona/design-tokens @persona/icons
+```