@trinityui/design-system 2.1.4 → 2.2.3

package/CHANGELOG.md

@@ -1,3 +1,303 @@
+## [2.2.3](https://github.com/Trinity-UI-Components/trinity-design-system/compare/v1.0.0...v2.2.3) (2026-04-28)
+
+### Features
+
+* **a11y:** brand-color Option A — text.link/success/warning now WCAG AA ([812241b](https://github.com/Trinity-UI-Components/trinity-design-system/commit/812241b2013010a834511dbd75968fba62517fd7)), closes [#27AAE1](https://github.com/Trinity-UI-Components/trinity-design-system/issues/27AAE1) [#0E62CA](https://github.com/Trinity-UI-Components/trinity-design-system/issues/0E62CA) [#16A34A](https://github.com/Trinity-UI-Components/trinity-design-system/issues/16A34A) [#15803D](https://github.com/Trinity-UI-Components/trinity-design-system/issues/15803D) [#D97706](https://github.com/Trinity-UI-Components/trinity-design-system/issues/D97706) [#B45309](https://github.com/Trinity-UI-Components/trinity-design-system/issues/B45309)
+* **a11y:** track A+B fixes — contrast tokens, addon-vitest, deprecation milestones ([296ae23](https://github.com/Trinity-UI-Components/trinity-design-system/commit/296ae23360132cd0f9f6e792e45f62404f177931))
+* add AI agent guide story, custom CSF indexer, and split agent docs ([5545d77](https://github.com/Trinity-UI-Components/trinity-design-system/commit/5545d7708d6e9482506eb05ef02eb61dd9d1a96b))
+* add copy-paste UI pattern examples and component API details to agent prompts ([a647c9a](https://github.com/Trinity-UI-Components/trinity-design-system/commit/a647c9a8633f3164f9065743719e74376705c9fd))
+* add DocumentCard component with configurable features ([41e3370](https://github.com/Trinity-UI-Components/trinity-design-system/commit/41e3370f8cf460d82b3c53159887ad04cb60f764))
+* **ai:** add AIChainOfThought component and Storybook docs for all AI components\n\n- Add AIChainOfThought component with 5 phase types: Understanding, Plan,\n  Execution, Output, and Insight. Features collapsible thought process toggle,\n  auto-collapse, typing indicators, error/retry flows, artifact cards, and\n  reuses AIMessage, AISourcesPanel, AIRelatedQuestions, AISuggestedAction.\n- Add 10 stories for AIChainOfThought (PipelineAnalysis, ErrorAndRetry,\n  LiveSimulation, etc.)\n- Add Storybook stories for 12 previously undocumented AI components:\n  AILabel, AIAvatar, AIActions, AIContainer, AIExplainability, AIVisuals,\n  AIChat, UserMessage, ChatThread, InsightEngine\n- Export AIChainOfThought and all related types from public API\n- Fix Storybook theme: purple buttons, darker text, a11y context parameter\n- Add white-on-purple button text CSS in manager-head.html" ([27032ab](https://github.com/Trinity-UI-Components/trinity-design-system/commit/27032abb4403838de1d1cecbe7202e66492da928))
+* **Combobox:** add visible checkboxes and Select All option ([435e01a](https://github.com/Trinity-UI-Components/trinity-design-system/commit/435e01a71f0c6ba7fab9decb7d0d9b5cd760bbb1))
+* **components:** ship 70-fix roadmap across 10 phases ([544febc](https://github.com/Trinity-UI-Components/trinity-design-system/commit/544febce403ca60a511d30c490a513e28534b0dd))
+* **css-package:** generate trinity.css from tokens.ts (v2.5.0) ([640fd75](https://github.com/Trinity-UI-Components/trinity-design-system/commit/640fd75ee52bb020866606851704c6d9e8dd65de))
+* **css:** expand trinity.css with comprehensive design tokens ([e1a9f22](https://github.com/Trinity-UI-Components/trinity-design-system/commit/e1a9f22c97d58959afcbf0d4c1aa76a76db52126))
+* **docs:** add AI Agent Guide (CSS edition) for non-React stacks ([3eeb7af](https://github.com/Trinity-UI-Components/trinity-design-system/commit/3eeb7afecdf9b5487ba9d9691493b47f9a4020e1))
+* fix button styling, add TopNav features, and add MuiAppBar override ([2354390](https://github.com/Trinity-UI-Components/trinity-design-system/commit/235439022d372696e5904f47ac03f9b44091f6ef))
+* simplify dependencies - remove date-pickers, add SimpleTable ([ee02f3e](https://github.com/Trinity-UI-Components/trinity-design-system/commit/ee02f3e299e13173e77355925dca513f3becf8a4))
+* simplify developer experience with essentials entry point ([a7e4a2f](https://github.com/Trinity-UI-Components/trinity-design-system/commit/a7e4a2fb1b221da9c2ee01f1b8c1a851f4e45697))
+* **storybook:** add interactive Component Picker page ([2642326](https://github.com/Trinity-UI-Components/trinity-design-system/commit/2642326fbb68d30c865ea008cdb283fff96562a1))
+* **storybook:** add Trinity branding with custom logo and theme ([8859283](https://github.com/Trinity-UI-Components/trinity-design-system/commit/8859283b58ad77f22b303f0e31f915c0f4f9aecd)), closes [#050742](https://github.com/Trinity-UI-Components/trinity-design-system/issues/050742) [#7841C9](https://github.com/Trinity-UI-Components/trinity-design-system/issues/7841C9)
+* **theme:** add theme presets system for app variations ([ec21481](https://github.com/Trinity-UI-Components/trinity-design-system/commit/ec2148114bfb33b508755675abcd00a0abf3662c))
+* **TopNav:** add white-label logo support with invert option ([0d0a337](https://github.com/Trinity-UI-Components/trinity-design-system/commit/0d0a337de5500ac75919b4ccead9c6b159775600))
+
+### Bug Fixes
+
+* add non-null assertion for darkMode status tokens to fix TS18048 ([dac98bb](https://github.com/Trinity-UI-Components/trinity-design-system/commit/dac98bb46fab6ca9e61f7e3a053a55e90aa339bd))
+* add visual identity requirements to AI agent prompts ([3eba2d8](https://github.com/Trinity-UI-Components/trinity-design-system/commit/3eba2d8243907cac70fbcc6d50c1d38e3cd94d2c))
+* **DataCard:** use theme-aware status backgrounds for dark mode ([621a039](https://github.com/Trinity-UI-Components/trinity-design-system/commit/621a039446736238cabb7ed5919333c97145f009)), closes [#F0FDF4](https://github.com/Trinity-UI-Components/trinity-design-system/issues/F0FDF4) [#FFFBEB](https://github.com/Trinity-UI-Components/trinity-design-system/issues/FFFBEB)
+* footer dark/light theme, token compliance, and component overhaul ([31c0dd4](https://github.com/Trinity-UI-Components/trinity-design-system/commit/31c0dd450c1725eb1992eab665de3fe491609837))
+* **form:** eliminate register/validate render loop and stale validation state ([65c9f79](https://github.com/Trinity-UI-Components/trinity-design-system/commit/65c9f79012cb13d84e7df4ff3f17ef8ec05be30d))
+* improve AI agent migration prompts and fix download button ([654c7eb](https://github.com/Trinity-UI-Components/trinity-design-system/commit/654c7ebe871c5e1e9167704324e7fc3dacc3bcc1))
+* improve Storybook configurability and documentation ([912194f](https://github.com/Trinity-UI-Components/trinity-design-system/commit/912194f35d20903d9252f25cb87ae7b7fc266db5))
+* preserve Storybook deep links through Azure AD authentication ([4467667](https://github.com/Trinity-UI-Components/trinity-design-system/commit/4467667a2d9c81c8b36d4c60c3d81f17c0d91042))
+* replace hardcoded colors with token references across stories ([c962ab7](https://github.com/Trinity-UI-Components/trinity-design-system/commit/c962ab78cbc1b648f91157c200cba401944574f2)), closes [#fff](https://github.com/Trinity-UI-Components/trinity-design-system/issues/fff) [eee/#444](https://github.com/eee/trinity-design-system/issues/444) [FFFFFF/#E5E7EB](https://github.com/FFFFFF/trinity-design-system/issues/E5E7EB) [#e0e0e0](https://github.com/Trinity-UI-Components/trinity-design-system/issues/e0e0e0) [e0e0e0/#30363d](https://github.com/e0e0e0/trinity-design-system/issues/30363d)
+* replace light-mode-only overlays with theme-aware action palette ([00ff8ad](https://github.com/Trinity-UI-Components/trinity-design-system/commit/00ff8adb5a5b345e6a8c239da792276d2e38aa94))
+* sync theme.ts with token system and spec ([78ae04c](https://github.com/Trinity-UI-Components/trinity-design-system/commit/78ae04c7e8e0e50a70b66e6dbcdf6a8154af4f4c)), closes [#fff](https://github.com/Trinity-UI-Components/trinity-design-system/issues/fff) [#1DC286](https://github.com/Trinity-UI-Components/trinity-design-system/issues/1DC286) [#FFB400](https://github.com/Trinity-UI-Components/trinity-design-system/issues/FFB400)
+* sync trinity.css with theme.ts and tokens.ts ([ac3209e](https://github.com/Trinity-UI-Components/trinity-design-system/commit/ac3209e2f26c8b71c7b990f7192bc03d2c2c467c))
+* update CSS theme to match brandColors from theme.ts ([481e0ca](https://github.com/Trinity-UI-Components/trinity-design-system/commit/481e0cafb55eed6c6d426115f25c3cfaef918b1e))
+## [2.2.3](https://github.com/Trinity-UI-Components/trinity-design-system/compare/v1.0.0...v2.2.3) (2026-04-27)
+
+### Features
+
+* **a11y:** brand-color Option A — text.link/success/warning now WCAG AA ([812241b](https://github.com/Trinity-UI-Components/trinity-design-system/commit/812241b2013010a834511dbd75968fba62517fd7)), closes [#27AAE1](https://github.com/Trinity-UI-Components/trinity-design-system/issues/27AAE1) [#0E62CA](https://github.com/Trinity-UI-Components/trinity-design-system/issues/0E62CA) [#16A34A](https://github.com/Trinity-UI-Components/trinity-design-system/issues/16A34A) [#15803D](https://github.com/Trinity-UI-Components/trinity-design-system/issues/15803D) [#D97706](https://github.com/Trinity-UI-Components/trinity-design-system/issues/D97706) [#B45309](https://github.com/Trinity-UI-Components/trinity-design-system/issues/B45309)
+* **a11y:** track A+B fixes — contrast tokens, addon-vitest, deprecation milestones ([296ae23](https://github.com/Trinity-UI-Components/trinity-design-system/commit/296ae23360132cd0f9f6e792e45f62404f177931))
+* add AI agent guide story, custom CSF indexer, and split agent docs ([5545d77](https://github.com/Trinity-UI-Components/trinity-design-system/commit/5545d7708d6e9482506eb05ef02eb61dd9d1a96b))
+* add copy-paste UI pattern examples and component API details to agent prompts ([a647c9a](https://github.com/Trinity-UI-Components/trinity-design-system/commit/a647c9a8633f3164f9065743719e74376705c9fd))
+* add DocumentCard component with configurable features ([41e3370](https://github.com/Trinity-UI-Components/trinity-design-system/commit/41e3370f8cf460d82b3c53159887ad04cb60f764))
+* **ai:** add AIChainOfThought component and Storybook docs for all AI components\n\n- Add AIChainOfThought component with 5 phase types: Understanding, Plan,\n  Execution, Output, and Insight. Features collapsible thought process toggle,\n  auto-collapse, typing indicators, error/retry flows, artifact cards, and\n  reuses AIMessage, AISourcesPanel, AIRelatedQuestions, AISuggestedAction.\n- Add 10 stories for AIChainOfThought (PipelineAnalysis, ErrorAndRetry,\n  LiveSimulation, etc.)\n- Add Storybook stories for 12 previously undocumented AI components:\n  AILabel, AIAvatar, AIActions, AIContainer, AIExplainability, AIVisuals,\n  AIChat, UserMessage, ChatThread, InsightEngine\n- Export AIChainOfThought and all related types from public API\n- Fix Storybook theme: purple buttons, darker text, a11y context parameter\n- Add white-on-purple button text CSS in manager-head.html" ([27032ab](https://github.com/Trinity-UI-Components/trinity-design-system/commit/27032abb4403838de1d1cecbe7202e66492da928))
+* **Combobox:** add visible checkboxes and Select All option ([435e01a](https://github.com/Trinity-UI-Components/trinity-design-system/commit/435e01a71f0c6ba7fab9decb7d0d9b5cd760bbb1))
+* **components:** ship 70-fix roadmap across 10 phases ([544febc](https://github.com/Trinity-UI-Components/trinity-design-system/commit/544febce403ca60a511d30c490a513e28534b0dd))
+* **css-package:** generate trinity.css from tokens.ts (v2.5.0) ([640fd75](https://github.com/Trinity-UI-Components/trinity-design-system/commit/640fd75ee52bb020866606851704c6d9e8dd65de))
+* **css:** expand trinity.css with comprehensive design tokens ([e1a9f22](https://github.com/Trinity-UI-Components/trinity-design-system/commit/e1a9f22c97d58959afcbf0d4c1aa76a76db52126))
+* **docs:** add AI Agent Guide (CSS edition) for non-React stacks ([3eeb7af](https://github.com/Trinity-UI-Components/trinity-design-system/commit/3eeb7afecdf9b5487ba9d9691493b47f9a4020e1))
+* fix button styling, add TopNav features, and add MuiAppBar override ([2354390](https://github.com/Trinity-UI-Components/trinity-design-system/commit/235439022d372696e5904f47ac03f9b44091f6ef))
+* simplify dependencies - remove date-pickers, add SimpleTable ([ee02f3e](https://github.com/Trinity-UI-Components/trinity-design-system/commit/ee02f3e299e13173e77355925dca513f3becf8a4))
+* simplify developer experience with essentials entry point ([a7e4a2f](https://github.com/Trinity-UI-Components/trinity-design-system/commit/a7e4a2fb1b221da9c2ee01f1b8c1a851f4e45697))
+* **storybook:** add interactive Component Picker page ([2642326](https://github.com/Trinity-UI-Components/trinity-design-system/commit/2642326fbb68d30c865ea008cdb283fff96562a1))
+* **storybook:** add Trinity branding with custom logo and theme ([8859283](https://github.com/Trinity-UI-Components/trinity-design-system/commit/8859283b58ad77f22b303f0e31f915c0f4f9aecd)), closes [#050742](https://github.com/Trinity-UI-Components/trinity-design-system/issues/050742) [#7841C9](https://github.com/Trinity-UI-Components/trinity-design-system/issues/7841C9)
+* **theme:** add theme presets system for app variations ([ec21481](https://github.com/Trinity-UI-Components/trinity-design-system/commit/ec2148114bfb33b508755675abcd00a0abf3662c))
+* **TopNav:** add white-label logo support with invert option ([0d0a337](https://github.com/Trinity-UI-Components/trinity-design-system/commit/0d0a337de5500ac75919b4ccead9c6b159775600))
+
+### Bug Fixes
+
+* add non-null assertion for darkMode status tokens to fix TS18048 ([dac98bb](https://github.com/Trinity-UI-Components/trinity-design-system/commit/dac98bb46fab6ca9e61f7e3a053a55e90aa339bd))
+* add visual identity requirements to AI agent prompts ([3eba2d8](https://github.com/Trinity-UI-Components/trinity-design-system/commit/3eba2d8243907cac70fbcc6d50c1d38e3cd94d2c))
+* **DataCard:** use theme-aware status backgrounds for dark mode ([621a039](https://github.com/Trinity-UI-Components/trinity-design-system/commit/621a039446736238cabb7ed5919333c97145f009)), closes [#F0FDF4](https://github.com/Trinity-UI-Components/trinity-design-system/issues/F0FDF4) [#FFFBEB](https://github.com/Trinity-UI-Components/trinity-design-system/issues/FFFBEB)
+* footer dark/light theme, token compliance, and component overhaul ([31c0dd4](https://github.com/Trinity-UI-Components/trinity-design-system/commit/31c0dd450c1725eb1992eab665de3fe491609837))
+* **form:** eliminate register/validate render loop and stale validation state ([65c9f79](https://github.com/Trinity-UI-Components/trinity-design-system/commit/65c9f79012cb13d84e7df4ff3f17ef8ec05be30d))
+* improve AI agent migration prompts and fix download button ([654c7eb](https://github.com/Trinity-UI-Components/trinity-design-system/commit/654c7ebe871c5e1e9167704324e7fc3dacc3bcc1))
+* improve Storybook configurability and documentation ([912194f](https://github.com/Trinity-UI-Components/trinity-design-system/commit/912194f35d20903d9252f25cb87ae7b7fc266db5))
+* preserve Storybook deep links through Azure AD authentication ([4467667](https://github.com/Trinity-UI-Components/trinity-design-system/commit/4467667a2d9c81c8b36d4c60c3d81f17c0d91042))
+* replace hardcoded colors with token references across stories ([c962ab7](https://github.com/Trinity-UI-Components/trinity-design-system/commit/c962ab78cbc1b648f91157c200cba401944574f2)), closes [#fff](https://github.com/Trinity-UI-Components/trinity-design-system/issues/fff) [eee/#444](https://github.com/eee/trinity-design-system/issues/444) [FFFFFF/#E5E7EB](https://github.com/FFFFFF/trinity-design-system/issues/E5E7EB) [#e0e0e0](https://github.com/Trinity-UI-Components/trinity-design-system/issues/e0e0e0) [e0e0e0/#30363d](https://github.com/e0e0e0/trinity-design-system/issues/30363d)
+* replace light-mode-only overlays with theme-aware action palette ([00ff8ad](https://github.com/Trinity-UI-Components/trinity-design-system/commit/00ff8adb5a5b345e6a8c239da792276d2e38aa94))
+* sync theme.ts with token system and spec ([78ae04c](https://github.com/Trinity-UI-Components/trinity-design-system/commit/78ae04c7e8e0e50a70b66e6dbcdf6a8154af4f4c)), closes [#fff](https://github.com/Trinity-UI-Components/trinity-design-system/issues/fff) [#1DC286](https://github.com/Trinity-UI-Components/trinity-design-system/issues/1DC286) [#FFB400](https://github.com/Trinity-UI-Components/trinity-design-system/issues/FFB400)
+* sync trinity.css with theme.ts and tokens.ts ([ac3209e](https://github.com/Trinity-UI-Components/trinity-design-system/commit/ac3209e2f26c8b71c7b990f7192bc03d2c2c467c))
+* update CSS theme to match brandColors from theme.ts ([481e0ca](https://github.com/Trinity-UI-Components/trinity-design-system/commit/481e0cafb55eed6c6d426115f25c3cfaef918b1e))
+## [2.2.2](https://github.com/Trinity-UI-Components/trinity-design-system/compare/v1.0.0...v2.2.2) (2026-04-27)
+
+### Features
+
+* **a11y:** brand-color Option A — text.link/success/warning now WCAG AA ([812241b](https://github.com/Trinity-UI-Components/trinity-design-system/commit/812241b2013010a834511dbd75968fba62517fd7)), closes [#27AAE1](https://github.com/Trinity-UI-Components/trinity-design-system/issues/27AAE1) [#0E62CA](https://github.com/Trinity-UI-Components/trinity-design-system/issues/0E62CA) [#16A34A](https://github.com/Trinity-UI-Components/trinity-design-system/issues/16A34A) [#15803D](https://github.com/Trinity-UI-Components/trinity-design-system/issues/15803D) [#D97706](https://github.com/Trinity-UI-Components/trinity-design-system/issues/D97706) [#B45309](https://github.com/Trinity-UI-Components/trinity-design-system/issues/B45309)
+* **a11y:** track A+B fixes — contrast tokens, addon-vitest, deprecation milestones ([296ae23](https://github.com/Trinity-UI-Components/trinity-design-system/commit/296ae23360132cd0f9f6e792e45f62404f177931))
+* add AI agent guide story, custom CSF indexer, and split agent docs ([5545d77](https://github.com/Trinity-UI-Components/trinity-design-system/commit/5545d7708d6e9482506eb05ef02eb61dd9d1a96b))
+* add copy-paste UI pattern examples and component API details to agent prompts ([a647c9a](https://github.com/Trinity-UI-Components/trinity-design-system/commit/a647c9a8633f3164f9065743719e74376705c9fd))
+* add DocumentCard component with configurable features ([41e3370](https://github.com/Trinity-UI-Components/trinity-design-system/commit/41e3370f8cf460d82b3c53159887ad04cb60f764))
+* **ai:** add AIChainOfThought component and Storybook docs for all AI components\n\n- Add AIChainOfThought component with 5 phase types: Understanding, Plan,\n  Execution, Output, and Insight. Features collapsible thought process toggle,\n  auto-collapse, typing indicators, error/retry flows, artifact cards, and\n  reuses AIMessage, AISourcesPanel, AIRelatedQuestions, AISuggestedAction.\n- Add 10 stories for AIChainOfThought (PipelineAnalysis, ErrorAndRetry,\n  LiveSimulation, etc.)\n- Add Storybook stories for 12 previously undocumented AI components:\n  AILabel, AIAvatar, AIActions, AIContainer, AIExplainability, AIVisuals,\n  AIChat, UserMessage, ChatThread, InsightEngine\n- Export AIChainOfThought and all related types from public API\n- Fix Storybook theme: purple buttons, darker text, a11y context parameter\n- Add white-on-purple button text CSS in manager-head.html" ([27032ab](https://github.com/Trinity-UI-Components/trinity-design-system/commit/27032abb4403838de1d1cecbe7202e66492da928))
+* **Combobox:** add visible checkboxes and Select All option ([435e01a](https://github.com/Trinity-UI-Components/trinity-design-system/commit/435e01a71f0c6ba7fab9decb7d0d9b5cd760bbb1))
+* **components:** ship 70-fix roadmap across 10 phases ([544febc](https://github.com/Trinity-UI-Components/trinity-design-system/commit/544febce403ca60a511d30c490a513e28534b0dd))
+* **css-package:** generate trinity.css from tokens.ts (v2.5.0) ([640fd75](https://github.com/Trinity-UI-Components/trinity-design-system/commit/640fd75ee52bb020866606851704c6d9e8dd65de))
+* **css:** expand trinity.css with comprehensive design tokens ([e1a9f22](https://github.com/Trinity-UI-Components/trinity-design-system/commit/e1a9f22c97d58959afcbf0d4c1aa76a76db52126))
+* **docs:** add AI Agent Guide (CSS edition) for non-React stacks ([3eeb7af](https://github.com/Trinity-UI-Components/trinity-design-system/commit/3eeb7afecdf9b5487ba9d9691493b47f9a4020e1))
+* fix button styling, add TopNav features, and add MuiAppBar override ([2354390](https://github.com/Trinity-UI-Components/trinity-design-system/commit/235439022d372696e5904f47ac03f9b44091f6ef))
+* simplify dependencies - remove date-pickers, add SimpleTable ([ee02f3e](https://github.com/Trinity-UI-Components/trinity-design-system/commit/ee02f3e299e13173e77355925dca513f3becf8a4))
+* simplify developer experience with essentials entry point ([a7e4a2f](https://github.com/Trinity-UI-Components/trinity-design-system/commit/a7e4a2fb1b221da9c2ee01f1b8c1a851f4e45697))
+* **storybook:** add interactive Component Picker page ([2642326](https://github.com/Trinity-UI-Components/trinity-design-system/commit/2642326fbb68d30c865ea008cdb283fff96562a1))
+* **storybook:** add Trinity branding with custom logo and theme ([8859283](https://github.com/Trinity-UI-Components/trinity-design-system/commit/8859283b58ad77f22b303f0e31f915c0f4f9aecd)), closes [#050742](https://github.com/Trinity-UI-Components/trinity-design-system/issues/050742) [#7841C9](https://github.com/Trinity-UI-Components/trinity-design-system/issues/7841C9)
+* **theme:** add theme presets system for app variations ([ec21481](https://github.com/Trinity-UI-Components/trinity-design-system/commit/ec2148114bfb33b508755675abcd00a0abf3662c))
+* **TopNav:** add white-label logo support with invert option ([0d0a337](https://github.com/Trinity-UI-Components/trinity-design-system/commit/0d0a337de5500ac75919b4ccead9c6b159775600))
+
+### Bug Fixes
+
+* add non-null assertion for darkMode status tokens to fix TS18048 ([dac98bb](https://github.com/Trinity-UI-Components/trinity-design-system/commit/dac98bb46fab6ca9e61f7e3a053a55e90aa339bd))
+* add visual identity requirements to AI agent prompts ([3eba2d8](https://github.com/Trinity-UI-Components/trinity-design-system/commit/3eba2d8243907cac70fbcc6d50c1d38e3cd94d2c))
+* **DataCard:** use theme-aware status backgrounds for dark mode ([621a039](https://github.com/Trinity-UI-Components/trinity-design-system/commit/621a039446736238cabb7ed5919333c97145f009)), closes [#F0FDF4](https://github.com/Trinity-UI-Components/trinity-design-system/issues/F0FDF4) [#FFFBEB](https://github.com/Trinity-UI-Components/trinity-design-system/issues/FFFBEB)
+* footer dark/light theme, token compliance, and component overhaul ([31c0dd4](https://github.com/Trinity-UI-Components/trinity-design-system/commit/31c0dd450c1725eb1992eab665de3fe491609837))
+* **form:** eliminate register/validate render loop and stale validation state ([65c9f79](https://github.com/Trinity-UI-Components/trinity-design-system/commit/65c9f79012cb13d84e7df4ff3f17ef8ec05be30d))
+* improve AI agent migration prompts and fix download button ([654c7eb](https://github.com/Trinity-UI-Components/trinity-design-system/commit/654c7ebe871c5e1e9167704324e7fc3dacc3bcc1))
+* improve Storybook configurability and documentation ([912194f](https://github.com/Trinity-UI-Components/trinity-design-system/commit/912194f35d20903d9252f25cb87ae7b7fc266db5))
+* preserve Storybook deep links through Azure AD authentication ([4467667](https://github.com/Trinity-UI-Components/trinity-design-system/commit/4467667a2d9c81c8b36d4c60c3d81f17c0d91042))
+* replace hardcoded colors with token references across stories ([c962ab7](https://github.com/Trinity-UI-Components/trinity-design-system/commit/c962ab78cbc1b648f91157c200cba401944574f2)), closes [#fff](https://github.com/Trinity-UI-Components/trinity-design-system/issues/fff) [eee/#444](https://github.com/eee/trinity-design-system/issues/444) [FFFFFF/#E5E7EB](https://github.com/FFFFFF/trinity-design-system/issues/E5E7EB) [#e0e0e0](https://github.com/Trinity-UI-Components/trinity-design-system/issues/e0e0e0) [e0e0e0/#30363d](https://github.com/e0e0e0/trinity-design-system/issues/30363d)
+* replace light-mode-only overlays with theme-aware action palette ([00ff8ad](https://github.com/Trinity-UI-Components/trinity-design-system/commit/00ff8adb5a5b345e6a8c239da792276d2e38aa94))
+* sync theme.ts with token system and spec ([78ae04c](https://github.com/Trinity-UI-Components/trinity-design-system/commit/78ae04c7e8e0e50a70b66e6dbcdf6a8154af4f4c)), closes [#fff](https://github.com/Trinity-UI-Components/trinity-design-system/issues/fff) [#1DC286](https://github.com/Trinity-UI-Components/trinity-design-system/issues/1DC286) [#FFB400](https://github.com/Trinity-UI-Components/trinity-design-system/issues/FFB400)
+* sync trinity.css with theme.ts and tokens.ts ([ac3209e](https://github.com/Trinity-UI-Components/trinity-design-system/commit/ac3209e2f26c8b71c7b990f7192bc03d2c2c467c))
+* update CSS theme to match brandColors from theme.ts ([481e0ca](https://github.com/Trinity-UI-Components/trinity-design-system/commit/481e0cafb55eed6c6d426115f25c3cfaef918b1e))
+## [2.2.1](https://github.com/Trinity-UI-Components/trinity-design-system/compare/v1.0.0...v2.2.1) (2026-04-27)
+
+### Features
+
+* **a11y:** brand-color Option A — text.link/success/warning now WCAG AA ([812241b](https://github.com/Trinity-UI-Components/trinity-design-system/commit/812241b2013010a834511dbd75968fba62517fd7)), closes [#27AAE1](https://github.com/Trinity-UI-Components/trinity-design-system/issues/27AAE1) [#0E62CA](https://github.com/Trinity-UI-Components/trinity-design-system/issues/0E62CA) [#16A34A](https://github.com/Trinity-UI-Components/trinity-design-system/issues/16A34A) [#15803D](https://github.com/Trinity-UI-Components/trinity-design-system/issues/15803D) [#D97706](https://github.com/Trinity-UI-Components/trinity-design-system/issues/D97706) [#B45309](https://github.com/Trinity-UI-Components/trinity-design-system/issues/B45309)
+* **a11y:** track A+B fixes — contrast tokens, addon-vitest, deprecation milestones ([296ae23](https://github.com/Trinity-UI-Components/trinity-design-system/commit/296ae23360132cd0f9f6e792e45f62404f177931))
+* add AI agent guide story, custom CSF indexer, and split agent docs ([5545d77](https://github.com/Trinity-UI-Components/trinity-design-system/commit/5545d7708d6e9482506eb05ef02eb61dd9d1a96b))
+* add copy-paste UI pattern examples and component API details to agent prompts ([a647c9a](https://github.com/Trinity-UI-Components/trinity-design-system/commit/a647c9a8633f3164f9065743719e74376705c9fd))
+* add DocumentCard component with configurable features ([41e3370](https://github.com/Trinity-UI-Components/trinity-design-system/commit/41e3370f8cf460d82b3c53159887ad04cb60f764))
+* **ai:** add AIChainOfThought component and Storybook docs for all AI components\n\n- Add AIChainOfThought component with 5 phase types: Understanding, Plan,\n  Execution, Output, and Insight. Features collapsible thought process toggle,\n  auto-collapse, typing indicators, error/retry flows, artifact cards, and\n  reuses AIMessage, AISourcesPanel, AIRelatedQuestions, AISuggestedAction.\n- Add 10 stories for AIChainOfThought (PipelineAnalysis, ErrorAndRetry,\n  LiveSimulation, etc.)\n- Add Storybook stories for 12 previously undocumented AI components:\n  AILabel, AIAvatar, AIActions, AIContainer, AIExplainability, AIVisuals,\n  AIChat, UserMessage, ChatThread, InsightEngine\n- Export AIChainOfThought and all related types from public API\n- Fix Storybook theme: purple buttons, darker text, a11y context parameter\n- Add white-on-purple button text CSS in manager-head.html" ([27032ab](https://github.com/Trinity-UI-Components/trinity-design-system/commit/27032abb4403838de1d1cecbe7202e66492da928))
+* **Combobox:** add visible checkboxes and Select All option ([435e01a](https://github.com/Trinity-UI-Components/trinity-design-system/commit/435e01a71f0c6ba7fab9decb7d0d9b5cd760bbb1))
+* **components:** ship 70-fix roadmap across 10 phases ([544febc](https://github.com/Trinity-UI-Components/trinity-design-system/commit/544febce403ca60a511d30c490a513e28534b0dd))
+* **css-package:** generate trinity.css from tokens.ts (v2.5.0) ([640fd75](https://github.com/Trinity-UI-Components/trinity-design-system/commit/640fd75ee52bb020866606851704c6d9e8dd65de))
+* **css:** expand trinity.css with comprehensive design tokens ([e1a9f22](https://github.com/Trinity-UI-Components/trinity-design-system/commit/e1a9f22c97d58959afcbf0d4c1aa76a76db52126))
+* **docs:** add AI Agent Guide (CSS edition) for non-React stacks ([3eeb7af](https://github.com/Trinity-UI-Components/trinity-design-system/commit/3eeb7afecdf9b5487ba9d9691493b47f9a4020e1))
+* fix button styling, add TopNav features, and add MuiAppBar override ([2354390](https://github.com/Trinity-UI-Components/trinity-design-system/commit/235439022d372696e5904f47ac03f9b44091f6ef))
+* simplify dependencies - remove date-pickers, add SimpleTable ([ee02f3e](https://github.com/Trinity-UI-Components/trinity-design-system/commit/ee02f3e299e13173e77355925dca513f3becf8a4))
+* simplify developer experience with essentials entry point ([a7e4a2f](https://github.com/Trinity-UI-Components/trinity-design-system/commit/a7e4a2fb1b221da9c2ee01f1b8c1a851f4e45697))
+* **storybook:** add interactive Component Picker page ([2642326](https://github.com/Trinity-UI-Components/trinity-design-system/commit/2642326fbb68d30c865ea008cdb283fff96562a1))
+* **storybook:** add Trinity branding with custom logo and theme ([8859283](https://github.com/Trinity-UI-Components/trinity-design-system/commit/8859283b58ad77f22b303f0e31f915c0f4f9aecd)), closes [#050742](https://github.com/Trinity-UI-Components/trinity-design-system/issues/050742) [#7841C9](https://github.com/Trinity-UI-Components/trinity-design-system/issues/7841C9)
+* **theme:** add theme presets system for app variations ([ec21481](https://github.com/Trinity-UI-Components/trinity-design-system/commit/ec2148114bfb33b508755675abcd00a0abf3662c))
+* **TopNav:** add white-label logo support with invert option ([0d0a337](https://github.com/Trinity-UI-Components/trinity-design-system/commit/0d0a337de5500ac75919b4ccead9c6b159775600))
+
+### Bug Fixes
+
+* add non-null assertion for darkMode status tokens to fix TS18048 ([dac98bb](https://github.com/Trinity-UI-Components/trinity-design-system/commit/dac98bb46fab6ca9e61f7e3a053a55e90aa339bd))
+* add visual identity requirements to AI agent prompts ([3eba2d8](https://github.com/Trinity-UI-Components/trinity-design-system/commit/3eba2d8243907cac70fbcc6d50c1d38e3cd94d2c))
+* **DataCard:** use theme-aware status backgrounds for dark mode ([621a039](https://github.com/Trinity-UI-Components/trinity-design-system/commit/621a039446736238cabb7ed5919333c97145f009)), closes [#F0FDF4](https://github.com/Trinity-UI-Components/trinity-design-system/issues/F0FDF4) [#FFFBEB](https://github.com/Trinity-UI-Components/trinity-design-system/issues/FFFBEB)
+* footer dark/light theme, token compliance, and component overhaul ([31c0dd4](https://github.com/Trinity-UI-Components/trinity-design-system/commit/31c0dd450c1725eb1992eab665de3fe491609837))
+* **form:** eliminate register/validate render loop and stale validation state ([65c9f79](https://github.com/Trinity-UI-Components/trinity-design-system/commit/65c9f79012cb13d84e7df4ff3f17ef8ec05be30d))
+* improve AI agent migration prompts and fix download button ([654c7eb](https://github.com/Trinity-UI-Components/trinity-design-system/commit/654c7ebe871c5e1e9167704324e7fc3dacc3bcc1))
+* improve Storybook configurability and documentation ([912194f](https://github.com/Trinity-UI-Components/trinity-design-system/commit/912194f35d20903d9252f25cb87ae7b7fc266db5))
+* preserve Storybook deep links through Azure AD authentication ([4467667](https://github.com/Trinity-UI-Components/trinity-design-system/commit/4467667a2d9c81c8b36d4c60c3d81f17c0d91042))
+* replace hardcoded colors with token references across stories ([c962ab7](https://github.com/Trinity-UI-Components/trinity-design-system/commit/c962ab78cbc1b648f91157c200cba401944574f2)), closes [#fff](https://github.com/Trinity-UI-Components/trinity-design-system/issues/fff) [eee/#444](https://github.com/eee/trinity-design-system/issues/444) [FFFFFF/#E5E7EB](https://github.com/FFFFFF/trinity-design-system/issues/E5E7EB) [#e0e0e0](https://github.com/Trinity-UI-Components/trinity-design-system/issues/e0e0e0) [e0e0e0/#30363d](https://github.com/e0e0e0/trinity-design-system/issues/30363d)
+* replace light-mode-only overlays with theme-aware action palette ([00ff8ad](https://github.com/Trinity-UI-Components/trinity-design-system/commit/00ff8adb5a5b345e6a8c239da792276d2e38aa94))
+* sync theme.ts with token system and spec ([78ae04c](https://github.com/Trinity-UI-Components/trinity-design-system/commit/78ae04c7e8e0e50a70b66e6dbcdf6a8154af4f4c)), closes [#fff](https://github.com/Trinity-UI-Components/trinity-design-system/issues/fff) [#1DC286](https://github.com/Trinity-UI-Components/trinity-design-system/issues/1DC286) [#FFB400](https://github.com/Trinity-UI-Components/trinity-design-system/issues/FFB400)
+* sync trinity.css with theme.ts and tokens.ts ([ac3209e](https://github.com/Trinity-UI-Components/trinity-design-system/commit/ac3209e2f26c8b71c7b990f7192bc03d2c2c467c))
+* update CSS theme to match brandColors from theme.ts ([481e0ca](https://github.com/Trinity-UI-Components/trinity-design-system/commit/481e0cafb55eed6c6d426115f25c3cfaef918b1e))
+## [2.2.0](https://github.com/Trinity-UI-Components/trinity-design-system/compare/v1.0.0...v2.2.0) (2026-04-20)
+
+### Features
+
+* **a11y:** brand-color Option A — text.link/success/warning now WCAG AA ([812241b](https://github.com/Trinity-UI-Components/trinity-design-system/commit/812241b2013010a834511dbd75968fba62517fd7)), closes [#27AAE1](https://github.com/Trinity-UI-Components/trinity-design-system/issues/27AAE1) [#0E62CA](https://github.com/Trinity-UI-Components/trinity-design-system/issues/0E62CA) [#16A34A](https://github.com/Trinity-UI-Components/trinity-design-system/issues/16A34A) [#15803D](https://github.com/Trinity-UI-Components/trinity-design-system/issues/15803D) [#D97706](https://github.com/Trinity-UI-Components/trinity-design-system/issues/D97706) [#B45309](https://github.com/Trinity-UI-Components/trinity-design-system/issues/B45309)
+* **a11y:** track A+B fixes — contrast tokens, addon-vitest, deprecation milestones ([296ae23](https://github.com/Trinity-UI-Components/trinity-design-system/commit/296ae23360132cd0f9f6e792e45f62404f177931))
+* add AI agent guide story, custom CSF indexer, and split agent docs ([5545d77](https://github.com/Trinity-UI-Components/trinity-design-system/commit/5545d7708d6e9482506eb05ef02eb61dd9d1a96b))
+* add copy-paste UI pattern examples and component API details to agent prompts ([a647c9a](https://github.com/Trinity-UI-Components/trinity-design-system/commit/a647c9a8633f3164f9065743719e74376705c9fd))
+* add DocumentCard component with configurable features ([41e3370](https://github.com/Trinity-UI-Components/trinity-design-system/commit/41e3370f8cf460d82b3c53159887ad04cb60f764))
+* **ai:** add AIChainOfThought component and Storybook docs for all AI components\n\n- Add AIChainOfThought component with 5 phase types: Understanding, Plan,\n  Execution, Output, and Insight. Features collapsible thought process toggle,\n  auto-collapse, typing indicators, error/retry flows, artifact cards, and\n  reuses AIMessage, AISourcesPanel, AIRelatedQuestions, AISuggestedAction.\n- Add 10 stories for AIChainOfThought (PipelineAnalysis, ErrorAndRetry,\n  LiveSimulation, etc.)\n- Add Storybook stories for 12 previously undocumented AI components:\n  AILabel, AIAvatar, AIActions, AIContainer, AIExplainability, AIVisuals,\n  AIChat, UserMessage, ChatThread, InsightEngine\n- Export AIChainOfThought and all related types from public API\n- Fix Storybook theme: purple buttons, darker text, a11y context parameter\n- Add white-on-purple button text CSS in manager-head.html" ([27032ab](https://github.com/Trinity-UI-Components/trinity-design-system/commit/27032abb4403838de1d1cecbe7202e66492da928))
+* **Combobox:** add visible checkboxes and Select All option ([435e01a](https://github.com/Trinity-UI-Components/trinity-design-system/commit/435e01a71f0c6ba7fab9decb7d0d9b5cd760bbb1))
+* **components:** ship 70-fix roadmap across 10 phases ([544febc](https://github.com/Trinity-UI-Components/trinity-design-system/commit/544febce403ca60a511d30c490a513e28534b0dd))
+* **css-package:** generate trinity.css from tokens.ts (v2.5.0) ([640fd75](https://github.com/Trinity-UI-Components/trinity-design-system/commit/640fd75ee52bb020866606851704c6d9e8dd65de))
+* **css:** expand trinity.css with comprehensive design tokens ([e1a9f22](https://github.com/Trinity-UI-Components/trinity-design-system/commit/e1a9f22c97d58959afcbf0d4c1aa76a76db52126))
+* **docs:** add AI Agent Guide (CSS edition) for non-React stacks ([3eeb7af](https://github.com/Trinity-UI-Components/trinity-design-system/commit/3eeb7afecdf9b5487ba9d9691493b47f9a4020e1))
+* fix button styling, add TopNav features, and add MuiAppBar override ([2354390](https://github.com/Trinity-UI-Components/trinity-design-system/commit/235439022d372696e5904f47ac03f9b44091f6ef))
+* simplify dependencies - remove date-pickers, add SimpleTable ([ee02f3e](https://github.com/Trinity-UI-Components/trinity-design-system/commit/ee02f3e299e13173e77355925dca513f3becf8a4))
+* simplify developer experience with essentials entry point ([a7e4a2f](https://github.com/Trinity-UI-Components/trinity-design-system/commit/a7e4a2fb1b221da9c2ee01f1b8c1a851f4e45697))
+* **storybook:** add interactive Component Picker page ([2642326](https://github.com/Trinity-UI-Components/trinity-design-system/commit/2642326fbb68d30c865ea008cdb283fff96562a1))
+* **storybook:** add Trinity branding with custom logo and theme ([8859283](https://github.com/Trinity-UI-Components/trinity-design-system/commit/8859283b58ad77f22b303f0e31f915c0f4f9aecd)), closes [#050742](https://github.com/Trinity-UI-Components/trinity-design-system/issues/050742) [#7841C9](https://github.com/Trinity-UI-Components/trinity-design-system/issues/7841C9)
+* **theme:** add theme presets system for app variations ([ec21481](https://github.com/Trinity-UI-Components/trinity-design-system/commit/ec2148114bfb33b508755675abcd00a0abf3662c))
+* **TopNav:** add white-label logo support with invert option ([0d0a337](https://github.com/Trinity-UI-Components/trinity-design-system/commit/0d0a337de5500ac75919b4ccead9c6b159775600))
+
+### Bug Fixes
+
+* add non-null assertion for darkMode status tokens to fix TS18048 ([dac98bb](https://github.com/Trinity-UI-Components/trinity-design-system/commit/dac98bb46fab6ca9e61f7e3a053a55e90aa339bd))
+* add visual identity requirements to AI agent prompts ([3eba2d8](https://github.com/Trinity-UI-Components/trinity-design-system/commit/3eba2d8243907cac70fbcc6d50c1d38e3cd94d2c))
+* **DataCard:** use theme-aware status backgrounds for dark mode ([621a039](https://github.com/Trinity-UI-Components/trinity-design-system/commit/621a039446736238cabb7ed5919333c97145f009)), closes [#F0FDF4](https://github.com/Trinity-UI-Components/trinity-design-system/issues/F0FDF4) [#FFFBEB](https://github.com/Trinity-UI-Components/trinity-design-system/issues/FFFBEB)
+* footer dark/light theme, token compliance, and component overhaul ([31c0dd4](https://github.com/Trinity-UI-Components/trinity-design-system/commit/31c0dd450c1725eb1992eab665de3fe491609837))
+* **form:** eliminate register/validate render loop and stale validation state ([65c9f79](https://github.com/Trinity-UI-Components/trinity-design-system/commit/65c9f79012cb13d84e7df4ff3f17ef8ec05be30d))
+* improve AI agent migration prompts and fix download button ([654c7eb](https://github.com/Trinity-UI-Components/trinity-design-system/commit/654c7ebe871c5e1e9167704324e7fc3dacc3bcc1))
+* improve Storybook configurability and documentation ([912194f](https://github.com/Trinity-UI-Components/trinity-design-system/commit/912194f35d20903d9252f25cb87ae7b7fc266db5))
+* preserve Storybook deep links through Azure AD authentication ([4467667](https://github.com/Trinity-UI-Components/trinity-design-system/commit/4467667a2d9c81c8b36d4c60c3d81f17c0d91042))
+* replace hardcoded colors with token references across stories ([c962ab7](https://github.com/Trinity-UI-Components/trinity-design-system/commit/c962ab78cbc1b648f91157c200cba401944574f2)), closes [#fff](https://github.com/Trinity-UI-Components/trinity-design-system/issues/fff) [eee/#444](https://github.com/eee/trinity-design-system/issues/444) [FFFFFF/#E5E7EB](https://github.com/FFFFFF/trinity-design-system/issues/E5E7EB) [#e0e0e0](https://github.com/Trinity-UI-Components/trinity-design-system/issues/e0e0e0) [e0e0e0/#30363d](https://github.com/e0e0e0/trinity-design-system/issues/30363d)
+* replace light-mode-only overlays with theme-aware action palette ([00ff8ad](https://github.com/Trinity-UI-Components/trinity-design-system/commit/00ff8adb5a5b345e6a8c239da792276d2e38aa94))
+* sync theme.ts with token system and spec ([78ae04c](https://github.com/Trinity-UI-Components/trinity-design-system/commit/78ae04c7e8e0e50a70b66e6dbcdf6a8154af4f4c)), closes [#fff](https://github.com/Trinity-UI-Components/trinity-design-system/issues/fff) [#1DC286](https://github.com/Trinity-UI-Components/trinity-design-system/issues/1DC286) [#FFB400](https://github.com/Trinity-UI-Components/trinity-design-system/issues/FFB400)
+* sync trinity.css with theme.ts and tokens.ts ([ac3209e](https://github.com/Trinity-UI-Components/trinity-design-system/commit/ac3209e2f26c8b71c7b990f7192bc03d2c2c467c))
+* update CSS theme to match brandColors from theme.ts ([481e0ca](https://github.com/Trinity-UI-Components/trinity-design-system/commit/481e0cafb55eed6c6d426115f25c3cfaef918b1e))
+## [2.2.0](https://github.com/Trinity-UI-Components/trinity-design-system/compare/v1.0.0...v2.2.0) (2026-04-20)
+
+### Features
+
+* **a11y:** brand-color Option A — text.link/success/warning now WCAG AA ([812241b](https://github.com/Trinity-UI-Components/trinity-design-system/commit/812241b2013010a834511dbd75968fba62517fd7)), closes [#27AAE1](https://github.com/Trinity-UI-Components/trinity-design-system/issues/27AAE1) [#0E62CA](https://github.com/Trinity-UI-Components/trinity-design-system/issues/0E62CA) [#16A34A](https://github.com/Trinity-UI-Components/trinity-design-system/issues/16A34A) [#15803D](https://github.com/Trinity-UI-Components/trinity-design-system/issues/15803D) [#D97706](https://github.com/Trinity-UI-Components/trinity-design-system/issues/D97706) [#B45309](https://github.com/Trinity-UI-Components/trinity-design-system/issues/B45309)
+* **a11y:** track A+B fixes — contrast tokens, addon-vitest, deprecation milestones ([296ae23](https://github.com/Trinity-UI-Components/trinity-design-system/commit/296ae23360132cd0f9f6e792e45f62404f177931))
+* add AI agent guide story, custom CSF indexer, and split agent docs ([5545d77](https://github.com/Trinity-UI-Components/trinity-design-system/commit/5545d7708d6e9482506eb05ef02eb61dd9d1a96b))
+* add copy-paste UI pattern examples and component API details to agent prompts ([a647c9a](https://github.com/Trinity-UI-Components/trinity-design-system/commit/a647c9a8633f3164f9065743719e74376705c9fd))
+* add DocumentCard component with configurable features ([41e3370](https://github.com/Trinity-UI-Components/trinity-design-system/commit/41e3370f8cf460d82b3c53159887ad04cb60f764))
+* **ai:** add AIChainOfThought component and Storybook docs for all AI components\n\n- Add AIChainOfThought component with 5 phase types: Understanding, Plan,\n  Execution, Output, and Insight. Features collapsible thought process toggle,\n  auto-collapse, typing indicators, error/retry flows, artifact cards, and\n  reuses AIMessage, AISourcesPanel, AIRelatedQuestions, AISuggestedAction.\n- Add 10 stories for AIChainOfThought (PipelineAnalysis, ErrorAndRetry,\n  LiveSimulation, etc.)\n- Add Storybook stories for 12 previously undocumented AI components:\n  AILabel, AIAvatar, AIActions, AIContainer, AIExplainability, AIVisuals,\n  AIChat, UserMessage, ChatThread, InsightEngine\n- Export AIChainOfThought and all related types from public API\n- Fix Storybook theme: purple buttons, darker text, a11y context parameter\n- Add white-on-purple button text CSS in manager-head.html" ([27032ab](https://github.com/Trinity-UI-Components/trinity-design-system/commit/27032abb4403838de1d1cecbe7202e66492da928))
+* **Combobox:** add visible checkboxes and Select All option ([435e01a](https://github.com/Trinity-UI-Components/trinity-design-system/commit/435e01a71f0c6ba7fab9decb7d0d9b5cd760bbb1))
+* **components:** ship 70-fix roadmap across 10 phases ([544febc](https://github.com/Trinity-UI-Components/trinity-design-system/commit/544febce403ca60a511d30c490a513e28534b0dd))
+* **css-package:** generate trinity.css from tokens.ts (v2.5.0) ([640fd75](https://github.com/Trinity-UI-Components/trinity-design-system/commit/640fd75ee52bb020866606851704c6d9e8dd65de))
+* **css:** expand trinity.css with comprehensive design tokens ([e1a9f22](https://github.com/Trinity-UI-Components/trinity-design-system/commit/e1a9f22c97d58959afcbf0d4c1aa76a76db52126))
+* fix button styling, add TopNav features, and add MuiAppBar override ([2354390](https://github.com/Trinity-UI-Components/trinity-design-system/commit/235439022d372696e5904f47ac03f9b44091f6ef))
+* simplify dependencies - remove date-pickers, add SimpleTable ([ee02f3e](https://github.com/Trinity-UI-Components/trinity-design-system/commit/ee02f3e299e13173e77355925dca513f3becf8a4))
+* simplify developer experience with essentials entry point ([a7e4a2f](https://github.com/Trinity-UI-Components/trinity-design-system/commit/a7e4a2fb1b221da9c2ee01f1b8c1a851f4e45697))
+* **storybook:** add interactive Component Picker page ([2642326](https://github.com/Trinity-UI-Components/trinity-design-system/commit/2642326fbb68d30c865ea008cdb283fff96562a1))
+* **storybook:** add Trinity branding with custom logo and theme ([8859283](https://github.com/Trinity-UI-Components/trinity-design-system/commit/8859283b58ad77f22b303f0e31f915c0f4f9aecd)), closes [#050742](https://github.com/Trinity-UI-Components/trinity-design-system/issues/050742) [#7841C9](https://github.com/Trinity-UI-Components/trinity-design-system/issues/7841C9)
+* **theme:** add theme presets system for app variations ([ec21481](https://github.com/Trinity-UI-Components/trinity-design-system/commit/ec2148114bfb33b508755675abcd00a0abf3662c))
+* **TopNav:** add white-label logo support with invert option ([0d0a337](https://github.com/Trinity-UI-Components/trinity-design-system/commit/0d0a337de5500ac75919b4ccead9c6b159775600))
+
+### Bug Fixes
+
+* add non-null assertion for darkMode status tokens to fix TS18048 ([dac98bb](https://github.com/Trinity-UI-Components/trinity-design-system/commit/dac98bb46fab6ca9e61f7e3a053a55e90aa339bd))
+* add visual identity requirements to AI agent prompts ([3eba2d8](https://github.com/Trinity-UI-Components/trinity-design-system/commit/3eba2d8243907cac70fbcc6d50c1d38e3cd94d2c))
+* **DataCard:** use theme-aware status backgrounds for dark mode ([621a039](https://github.com/Trinity-UI-Components/trinity-design-system/commit/621a039446736238cabb7ed5919333c97145f009)), closes [#F0FDF4](https://github.com/Trinity-UI-Components/trinity-design-system/issues/F0FDF4) [#FFFBEB](https://github.com/Trinity-UI-Components/trinity-design-system/issues/FFFBEB)
+* footer dark/light theme, token compliance, and component overhaul ([31c0dd4](https://github.com/Trinity-UI-Components/trinity-design-system/commit/31c0dd450c1725eb1992eab665de3fe491609837))
+* **form:** eliminate register/validate render loop and stale validation state ([65c9f79](https://github.com/Trinity-UI-Components/trinity-design-system/commit/65c9f79012cb13d84e7df4ff3f17ef8ec05be30d))
+* improve AI agent migration prompts and fix download button ([654c7eb](https://github.com/Trinity-UI-Components/trinity-design-system/commit/654c7ebe871c5e1e9167704324e7fc3dacc3bcc1))
+* improve Storybook configurability and documentation ([912194f](https://github.com/Trinity-UI-Components/trinity-design-system/commit/912194f35d20903d9252f25cb87ae7b7fc266db5))
+* preserve Storybook deep links through Azure AD authentication ([4467667](https://github.com/Trinity-UI-Components/trinity-design-system/commit/4467667a2d9c81c8b36d4c60c3d81f17c0d91042))
+* replace hardcoded colors with token references across stories ([c962ab7](https://github.com/Trinity-UI-Components/trinity-design-system/commit/c962ab78cbc1b648f91157c200cba401944574f2)), closes [#fff](https://github.com/Trinity-UI-Components/trinity-design-system/issues/fff) [eee/#444](https://github.com/eee/trinity-design-system/issues/444) [FFFFFF/#E5E7EB](https://github.com/FFFFFF/trinity-design-system/issues/E5E7EB) [#e0e0e0](https://github.com/Trinity-UI-Components/trinity-design-system/issues/e0e0e0) [e0e0e0/#30363d](https://github.com/e0e0e0/trinity-design-system/issues/30363d)
+* replace light-mode-only overlays with theme-aware action palette ([00ff8ad](https://github.com/Trinity-UI-Components/trinity-design-system/commit/00ff8adb5a5b345e6a8c239da792276d2e38aa94))
+* sync theme.ts with token system and spec ([78ae04c](https://github.com/Trinity-UI-Components/trinity-design-system/commit/78ae04c7e8e0e50a70b66e6dbcdf6a8154af4f4c)), closes [#fff](https://github.com/Trinity-UI-Components/trinity-design-system/issues/fff) [#1DC286](https://github.com/Trinity-UI-Components/trinity-design-system/issues/1DC286) [#FFB400](https://github.com/Trinity-UI-Components/trinity-design-system/issues/FFB400)
+* sync trinity.css with theme.ts and tokens.ts ([ac3209e](https://github.com/Trinity-UI-Components/trinity-design-system/commit/ac3209e2f26c8b71c7b990f7192bc03d2c2c467c))
+* update CSS theme to match brandColors from theme.ts ([481e0ca](https://github.com/Trinity-UI-Components/trinity-design-system/commit/481e0cafb55eed6c6d426115f25c3cfaef918b1e))
+## [2.2.0](https://github.com/Trinity-UI-Components/trinity-design-system/compare/v1.0.0...v2.2.0) (2026-04-20)
+
+### Features
+
+* **a11y:** brand-color Option A — text.link/success/warning now WCAG AA ([812241b](https://github.com/Trinity-UI-Components/trinity-design-system/commit/812241b2013010a834511dbd75968fba62517fd7)), closes [#27AAE1](https://github.com/Trinity-UI-Components/trinity-design-system/issues/27AAE1) [#0E62CA](https://github.com/Trinity-UI-Components/trinity-design-system/issues/0E62CA) [#16A34A](https://github.com/Trinity-UI-Components/trinity-design-system/issues/16A34A) [#15803D](https://github.com/Trinity-UI-Components/trinity-design-system/issues/15803D) [#D97706](https://github.com/Trinity-UI-Components/trinity-design-system/issues/D97706) [#B45309](https://github.com/Trinity-UI-Components/trinity-design-system/issues/B45309)
+* **a11y:** track A+B fixes — contrast tokens, addon-vitest, deprecation milestones ([296ae23](https://github.com/Trinity-UI-Components/trinity-design-system/commit/296ae23360132cd0f9f6e792e45f62404f177931))
+* add AI agent guide story, custom CSF indexer, and split agent docs ([5545d77](https://github.com/Trinity-UI-Components/trinity-design-system/commit/5545d7708d6e9482506eb05ef02eb61dd9d1a96b))
+* add copy-paste UI pattern examples and component API details to agent prompts ([a647c9a](https://github.com/Trinity-UI-Components/trinity-design-system/commit/a647c9a8633f3164f9065743719e74376705c9fd))
+* add DocumentCard component with configurable features ([41e3370](https://github.com/Trinity-UI-Components/trinity-design-system/commit/41e3370f8cf460d82b3c53159887ad04cb60f764))
+* **ai:** add AIChainOfThought component and Storybook docs for all AI components\n\n- Add AIChainOfThought component with 5 phase types: Understanding, Plan,\n  Execution, Output, and Insight. Features collapsible thought process toggle,\n  auto-collapse, typing indicators, error/retry flows, artifact cards, and\n  reuses AIMessage, AISourcesPanel, AIRelatedQuestions, AISuggestedAction.\n- Add 10 stories for AIChainOfThought (PipelineAnalysis, ErrorAndRetry,\n  LiveSimulation, etc.)\n- Add Storybook stories for 12 previously undocumented AI components:\n  AILabel, AIAvatar, AIActions, AIContainer, AIExplainability, AIVisuals,\n  AIChat, UserMessage, ChatThread, InsightEngine\n- Export AIChainOfThought and all related types from public API\n- Fix Storybook theme: purple buttons, darker text, a11y context parameter\n- Add white-on-purple button text CSS in manager-head.html" ([27032ab](https://github.com/Trinity-UI-Components/trinity-design-system/commit/27032abb4403838de1d1cecbe7202e66492da928))
+* **Combobox:** add visible checkboxes and Select All option ([435e01a](https://github.com/Trinity-UI-Components/trinity-design-system/commit/435e01a71f0c6ba7fab9decb7d0d9b5cd760bbb1))
+* **components:** ship 70-fix roadmap across 10 phases ([544febc](https://github.com/Trinity-UI-Components/trinity-design-system/commit/544febce403ca60a511d30c490a513e28534b0dd))
+* **css-package:** generate trinity.css from tokens.ts (v2.5.0) ([640fd75](https://github.com/Trinity-UI-Components/trinity-design-system/commit/640fd75ee52bb020866606851704c6d9e8dd65de))
+* **css:** expand trinity.css with comprehensive design tokens ([e1a9f22](https://github.com/Trinity-UI-Components/trinity-design-system/commit/e1a9f22c97d58959afcbf0d4c1aa76a76db52126))
+* fix button styling, add TopNav features, and add MuiAppBar override ([2354390](https://github.com/Trinity-UI-Components/trinity-design-system/commit/235439022d372696e5904f47ac03f9b44091f6ef))
+* simplify dependencies - remove date-pickers, add SimpleTable ([ee02f3e](https://github.com/Trinity-UI-Components/trinity-design-system/commit/ee02f3e299e13173e77355925dca513f3becf8a4))
+* simplify developer experience with essentials entry point ([a7e4a2f](https://github.com/Trinity-UI-Components/trinity-design-system/commit/a7e4a2fb1b221da9c2ee01f1b8c1a851f4e45697))
+* **storybook:** add interactive Component Picker page ([2642326](https://github.com/Trinity-UI-Components/trinity-design-system/commit/2642326fbb68d30c865ea008cdb283fff96562a1))
+* **storybook:** add Trinity branding with custom logo and theme ([8859283](https://github.com/Trinity-UI-Components/trinity-design-system/commit/8859283b58ad77f22b303f0e31f915c0f4f9aecd)), closes [#050742](https://github.com/Trinity-UI-Components/trinity-design-system/issues/050742) [#7841C9](https://github.com/Trinity-UI-Components/trinity-design-system/issues/7841C9)
+* **theme:** add theme presets system for app variations ([ec21481](https://github.com/Trinity-UI-Components/trinity-design-system/commit/ec2148114bfb33b508755675abcd00a0abf3662c))
+* **TopNav:** add white-label logo support with invert option ([0d0a337](https://github.com/Trinity-UI-Components/trinity-design-system/commit/0d0a337de5500ac75919b4ccead9c6b159775600))
+
+### Bug Fixes
+
+* add non-null assertion for darkMode status tokens to fix TS18048 ([dac98bb](https://github.com/Trinity-UI-Components/trinity-design-system/commit/dac98bb46fab6ca9e61f7e3a053a55e90aa339bd))
+* add visual identity requirements to AI agent prompts ([3eba2d8](https://github.com/Trinity-UI-Components/trinity-design-system/commit/3eba2d8243907cac70fbcc6d50c1d38e3cd94d2c))
+* **DataCard:** use theme-aware status backgrounds for dark mode ([621a039](https://github.com/Trinity-UI-Components/trinity-design-system/commit/621a039446736238cabb7ed5919333c97145f009)), closes [#F0FDF4](https://github.com/Trinity-UI-Components/trinity-design-system/issues/F0FDF4) [#FFFBEB](https://github.com/Trinity-UI-Components/trinity-design-system/issues/FFFBEB)
+* footer dark/light theme, token compliance, and component overhaul ([31c0dd4](https://github.com/Trinity-UI-Components/trinity-design-system/commit/31c0dd450c1725eb1992eab665de3fe491609837))
+* **form:** eliminate register/validate render loop and stale validation state ([65c9f79](https://github.com/Trinity-UI-Components/trinity-design-system/commit/65c9f79012cb13d84e7df4ff3f17ef8ec05be30d))
+* improve AI agent migration prompts and fix download button ([654c7eb](https://github.com/Trinity-UI-Components/trinity-design-system/commit/654c7ebe871c5e1e9167704324e7fc3dacc3bcc1))
+* improve Storybook configurability and documentation ([912194f](https://github.com/Trinity-UI-Components/trinity-design-system/commit/912194f35d20903d9252f25cb87ae7b7fc266db5))
+* preserve Storybook deep links through Azure AD authentication ([4467667](https://github.com/Trinity-UI-Components/trinity-design-system/commit/4467667a2d9c81c8b36d4c60c3d81f17c0d91042))
+* replace hardcoded colors with token references across stories ([c962ab7](https://github.com/Trinity-UI-Components/trinity-design-system/commit/c962ab78cbc1b648f91157c200cba401944574f2)), closes [#fff](https://github.com/Trinity-UI-Components/trinity-design-system/issues/fff) [eee/#444](https://github.com/eee/trinity-design-system/issues/444) [FFFFFF/#E5E7EB](https://github.com/FFFFFF/trinity-design-system/issues/E5E7EB) [#e0e0e0](https://github.com/Trinity-UI-Components/trinity-design-system/issues/e0e0e0) [e0e0e0/#30363d](https://github.com/e0e0e0/trinity-design-system/issues/30363d)
+* replace light-mode-only overlays with theme-aware action palette ([00ff8ad](https://github.com/Trinity-UI-Components/trinity-design-system/commit/00ff8adb5a5b345e6a8c239da792276d2e38aa94))
+* sync theme.ts with token system and spec ([78ae04c](https://github.com/Trinity-UI-Components/trinity-design-system/commit/78ae04c7e8e0e50a70b66e6dbcdf6a8154af4f4c)), closes [#fff](https://github.com/Trinity-UI-Components/trinity-design-system/issues/fff) [#1DC286](https://github.com/Trinity-UI-Components/trinity-design-system/issues/1DC286) [#FFB400](https://github.com/Trinity-UI-Components/trinity-design-system/issues/FFB400)
+* sync trinity.css with theme.ts and tokens.ts ([ac3209e](https://github.com/Trinity-UI-Components/trinity-design-system/commit/ac3209e2f26c8b71c7b990f7192bc03d2c2c467c))
+* update CSS theme to match brandColors from theme.ts ([481e0ca](https://github.com/Trinity-UI-Components/trinity-design-system/commit/481e0cafb55eed6c6d426115f25c3cfaef918b1e))
+## [2.2.0](https://github.com/Trinity-UI-Components/trinity-design-system/compare/v1.0.0...v2.2.0) (2026-04-20)
+
+### Features
+
+* **a11y:** brand-color Option A — text.link/success/warning now WCAG AA ([812241b](https://github.com/Trinity-UI-Components/trinity-design-system/commit/812241b2013010a834511dbd75968fba62517fd7)), closes [#27AAE1](https://github.com/Trinity-UI-Components/trinity-design-system/issues/27AAE1) [#0E62CA](https://github.com/Trinity-UI-Components/trinity-design-system/issues/0E62CA) [#16A34A](https://github.com/Trinity-UI-Components/trinity-design-system/issues/16A34A) [#15803D](https://github.com/Trinity-UI-Components/trinity-design-system/issues/15803D) [#D97706](https://github.com/Trinity-UI-Components/trinity-design-system/issues/D97706) [#B45309](https://github.com/Trinity-UI-Components/trinity-design-system/issues/B45309)
+* **a11y:** track A+B fixes — contrast tokens, addon-vitest, deprecation milestones ([296ae23](https://github.com/Trinity-UI-Components/trinity-design-system/commit/296ae23360132cd0f9f6e792e45f62404f177931))
+* add AI agent guide story, custom CSF indexer, and split agent docs ([5545d77](https://github.com/Trinity-UI-Components/trinity-design-system/commit/5545d7708d6e9482506eb05ef02eb61dd9d1a96b))
+* add copy-paste UI pattern examples and component API details to agent prompts ([a647c9a](https://github.com/Trinity-UI-Components/trinity-design-system/commit/a647c9a8633f3164f9065743719e74376705c9fd))
+* add DocumentCard component with configurable features ([41e3370](https://github.com/Trinity-UI-Components/trinity-design-system/commit/41e3370f8cf460d82b3c53159887ad04cb60f764))
+* **ai:** add AIChainOfThought component and Storybook docs for all AI components\n\n- Add AIChainOfThought component with 5 phase types: Understanding, Plan,\n  Execution, Output, and Insight. Features collapsible thought process toggle,\n  auto-collapse, typing indicators, error/retry flows, artifact cards, and\n  reuses AIMessage, AISourcesPanel, AIRelatedQuestions, AISuggestedAction.\n- Add 10 stories for AIChainOfThought (PipelineAnalysis, ErrorAndRetry,\n  LiveSimulation, etc.)\n- Add Storybook stories for 12 previously undocumented AI components:\n  AILabel, AIAvatar, AIActions, AIContainer, AIExplainability, AIVisuals,\n  AIChat, UserMessage, ChatThread, InsightEngine\n- Export AIChainOfThought and all related types from public API\n- Fix Storybook theme: purple buttons, darker text, a11y context parameter\n- Add white-on-purple button text CSS in manager-head.html" ([27032ab](https://github.com/Trinity-UI-Components/trinity-design-system/commit/27032abb4403838de1d1cecbe7202e66492da928))
+* **Combobox:** add visible checkboxes and Select All option ([435e01a](https://github.com/Trinity-UI-Components/trinity-design-system/commit/435e01a71f0c6ba7fab9decb7d0d9b5cd760bbb1))
+* **components:** ship 70-fix roadmap across 10 phases ([544febc](https://github.com/Trinity-UI-Components/trinity-design-system/commit/544febce403ca60a511d30c490a513e28534b0dd))
+* **css:** expand trinity.css with comprehensive design tokens ([e1a9f22](https://github.com/Trinity-UI-Components/trinity-design-system/commit/e1a9f22c97d58959afcbf0d4c1aa76a76db52126))
+* fix button styling, add TopNav features, and add MuiAppBar override ([2354390](https://github.com/Trinity-UI-Components/trinity-design-system/commit/235439022d372696e5904f47ac03f9b44091f6ef))
+* simplify dependencies - remove date-pickers, add SimpleTable ([ee02f3e](https://github.com/Trinity-UI-Components/trinity-design-system/commit/ee02f3e299e13173e77355925dca513f3becf8a4))
+* simplify developer experience with essentials entry point ([a7e4a2f](https://github.com/Trinity-UI-Components/trinity-design-system/commit/a7e4a2fb1b221da9c2ee01f1b8c1a851f4e45697))
+* **storybook:** add interactive Component Picker page ([2642326](https://github.com/Trinity-UI-Components/trinity-design-system/commit/2642326fbb68d30c865ea008cdb283fff96562a1))
+* **storybook:** add Trinity branding with custom logo and theme ([8859283](https://github.com/Trinity-UI-Components/trinity-design-system/commit/8859283b58ad77f22b303f0e31f915c0f4f9aecd)), closes [#050742](https://github.com/Trinity-UI-Components/trinity-design-system/issues/050742) [#7841C9](https://github.com/Trinity-UI-Components/trinity-design-system/issues/7841C9)
+* **theme:** add theme presets system for app variations ([ec21481](https://github.com/Trinity-UI-Components/trinity-design-system/commit/ec2148114bfb33b508755675abcd00a0abf3662c))
+* **TopNav:** add white-label logo support with invert option ([0d0a337](https://github.com/Trinity-UI-Components/trinity-design-system/commit/0d0a337de5500ac75919b4ccead9c6b159775600))
+
+### Bug Fixes
+
+* add non-null assertion for darkMode status tokens to fix TS18048 ([dac98bb](https://github.com/Trinity-UI-Components/trinity-design-system/commit/dac98bb46fab6ca9e61f7e3a053a55e90aa339bd))
+* add visual identity requirements to AI agent prompts ([3eba2d8](https://github.com/Trinity-UI-Components/trinity-design-system/commit/3eba2d8243907cac70fbcc6d50c1d38e3cd94d2c))
+* **DataCard:** use theme-aware status backgrounds for dark mode ([621a039](https://github.com/Trinity-UI-Components/trinity-design-system/commit/621a039446736238cabb7ed5919333c97145f009)), closes [#F0FDF4](https://github.com/Trinity-UI-Components/trinity-design-system/issues/F0FDF4) [#FFFBEB](https://github.com/Trinity-UI-Components/trinity-design-system/issues/FFFBEB)
+* footer dark/light theme, token compliance, and component overhaul ([31c0dd4](https://github.com/Trinity-UI-Components/trinity-design-system/commit/31c0dd450c1725eb1992eab665de3fe491609837))
+* **form:** eliminate register/validate render loop and stale validation state ([65c9f79](https://github.com/Trinity-UI-Components/trinity-design-system/commit/65c9f79012cb13d84e7df4ff3f17ef8ec05be30d))
+* improve AI agent migration prompts and fix download button ([654c7eb](https://github.com/Trinity-UI-Components/trinity-design-system/commit/654c7ebe871c5e1e9167704324e7fc3dacc3bcc1))
+* improve Storybook configurability and documentation ([912194f](https://github.com/Trinity-UI-Components/trinity-design-system/commit/912194f35d20903d9252f25cb87ae7b7fc266db5))
+* preserve Storybook deep links through Azure AD authentication ([4467667](https://github.com/Trinity-UI-Components/trinity-design-system/commit/4467667a2d9c81c8b36d4c60c3d81f17c0d91042))
+* replace hardcoded colors with token references across stories ([c962ab7](https://github.com/Trinity-UI-Components/trinity-design-system/commit/c962ab78cbc1b648f91157c200cba401944574f2)), closes [#fff](https://github.com/Trinity-UI-Components/trinity-design-system/issues/fff) [eee/#444](https://github.com/eee/trinity-design-system/issues/444) [FFFFFF/#E5E7EB](https://github.com/FFFFFF/trinity-design-system/issues/E5E7EB) [#e0e0e0](https://github.com/Trinity-UI-Components/trinity-design-system/issues/e0e0e0) [e0e0e0/#30363d](https://github.com/e0e0e0/trinity-design-system/issues/30363d)
+* replace light-mode-only overlays with theme-aware action palette ([00ff8ad](https://github.com/Trinity-UI-Components/trinity-design-system/commit/00ff8adb5a5b345e6a8c239da792276d2e38aa94))
+* sync theme.ts with token system and spec ([78ae04c](https://github.com/Trinity-UI-Components/trinity-design-system/commit/78ae04c7e8e0e50a70b66e6dbcdf6a8154af4f4c)), closes [#fff](https://github.com/Trinity-UI-Components/trinity-design-system/issues/fff) [#1DC286](https://github.com/Trinity-UI-Components/trinity-design-system/issues/1DC286) [#FFB400](https://github.com/Trinity-UI-Components/trinity-design-system/issues/FFB400)
+* sync trinity.css with theme.ts and tokens.ts ([ac3209e](https://github.com/Trinity-UI-Components/trinity-design-system/commit/ac3209e2f26c8b71c7b990f7192bc03d2c2c467c))
+* update CSS theme to match brandColors from theme.ts ([481e0ca](https://github.com/Trinity-UI-Components/trinity-design-system/commit/481e0cafb55eed6c6d426115f25c3cfaef918b1e))
 ## [2.1.4](https://github.com/Trinity-UI-Components/trinity-design-system/compare/v1.0.0...v2.1.4) (2026-04-17)
 
 ### Features
@@ -850,7 +1150,7 @@ All notable changes to the Trinity Design System will be documented in this file
 ### Added
 
 - Complete Trinity Design System component library
-- MUI v6/v7 compatible themes (light and dark mode)
+- MUI v9 compatible themes (light and dark mode)
 - CSS-only theme entry point (`@trinityui/design-system/css`)
 - Design tokens system (baseTokens, semanticTokens, componentTokens)
 - Extended MUI palette with Trinity semantic colors

package/MIGRATION.md

@@ -4,6 +4,124 @@ This document outlines breaking changes and migration paths for the Trinity Desi
 
 ---
 
+## `@trinityui/design-system-css` v2.5.0 — CSS is now token-generated
+
+**Non-breaking for the 602 variable names shipped in v2.4.x.** Every CSS variable that existed in the hand-maintained `trinity.css` is still present, at the same name, with the same or WCAG-improved value.
+
+### What changed
+
+The `dist/trinity.css` shipped in `@trinityui/design-system-css` is now **generated from `src/tokens.ts`** via `scripts/generate-css-from-tokens.ts`. The previous hand-maintained `src/styles/trinity.css` is retired (kept as `trinity.css.legacy` in the repo for one release as a reference).
+
+### What you get as a consumer
+
+1. **Brand / semantic colors** are always current. Token changes in `tokens.ts` (including the v2.2 WCAG contrast updates — see the v3.0 section below) now reach CSS-only consumers automatically.
+2. **New tokens added in TS land in CSS on next release**. For example, v2.2 added `--trinity-on-dark-hover` (rgba 15% white) and `--trinity-on-dark-strong-emphasis` (rgba 90% white) — both now available via the CSS package.
+3. **CI-gated drift check** (`scripts/check-token-drift.ts`) prevents future drift between `tokens.ts` and the generated CSS.
+
+### Updated values (applied automatically on upgrade)
+
+| Variable | v2.4.x | v2.5.0 | Why |
+|---|---|---|---|
+| `--trinity-text-disabled` (light) | `#D4D4D8` | `#6B7280` | WCAG AA (1.9:1 → 4.83:1) |
+| `--trinity-text-link` | `#27AAE1` | `#0E62CA` | WCAG AA (~2.5:1 → ~5.9:1) |
+| `--trinity-status-success-text` | `#16A34A` | `#15803D` | WCAG AA (3.3:1 → 4.6:1) |
+| `--trinity-status-warning-text` | `#D97706` | `#B45309` | WCAG AA (2.6:1 → 4.8:1) |
+| `--trinity-status-info-text` | `#27AAE1` | `#0E62CA` | Consistency with text-link |
+| `--trinity-border-default` | `#E5E7EB` | `#D4D4D8` | Token system update |
+| `--trinity-border-subtle` | `#F4F4F5` | `#E5E7EB` | Token system update |
+| `--trinity-border-strong` | `#9CA3AF` | `#6B7280` | WCAG 1.4.11 (3:1 for UI) |
+
+### New variables in v2.5.0
+
+- `--trinity-on-dark-hover: rgba(255, 255, 255, 0.15)` — interactive hover on dark surfaces
+- `--trinity-on-dark-strong-emphasis: rgba(255, 255, 255, 0.9)` — pressed/active state on dark
+
+### Rollback
+
+If a consumer hits unexpected visual regressions:
+- Pin to `@trinityui/design-system-css@2.4.1` in `package.json`
+- Or override the specific variable locally, e.g. `--trinity-text-link: #27AAE1` in your app CSS
+
+### For contributors
+
+Edit tokens in `src/tokens.ts`, then regenerate:
+
+```bash
+pnpm build:css:sync    # regenerates src/styles/trinity-generated.css
+npx tsx scripts/check-token-drift.ts  # CI gate
+```
+
+The hand-maintained `src/styles/trinity.css.legacy` is kept one release as a reference but is not built or shipped. It will be removed in v2.6.
+
+---
+
+## v3.0.0 — Planned removals (deprecations sunset)
+
+The following already-deprecated exports will be removed in **v3.0.0 (target: Q4 2026)**. All have drop-in replacements today, and each emits a dev-mode console warning on first render so accidental usage surfaces immediately.
+
+### Deprecation summary
+
+| Removed in v3.0 | Replace with | Why |
+|---|---|---|
+| `OverflowToolTip` (capital T) | `OverflowTooltip` | Casing aligned with component filename; the alias is a runtime wrapper emitting a dev warning. |
+| `QueryInput`, `QueryInputProps` | `InsightEngineInput`, `InsightEngineInputProps` | `InsightEngineInput` is the canonical AI entry surface. |
+| `AIChatMessage`, `AIChatInput`, `AITypingIndicator`, `AIQuickReply` | `AIMessage`, `ChatThread`, `AIShimmer`, `AISuggestedAction` | Consolidated AI chat primitives; richer block rendering, `aria-live` streaming support, better accessibility. |
+| `AIChatMessageProps`, `AIChatInputProps`, `AITypingIndicatorProps`, `AIQuickReplyProps`, `MessageRole` | Prop types from `AIMessage` / `ChatThread` / `AIResponseRenderer` | — |
+| `AIFabLayout` | `AppLayout` with `navStyle="topnav"` + `aiTrigger="fab"` | Single unified layout API; removes duplicate FAB-wrapper component. |
+| `VirtualizedAutocomplete`, `VirtualizedAutocompleteProps`, `VirtualizedAutocompleteHandle` | `Autocomplete`, `AutocompleteProps`, `AutocompleteHandle` | MUI's built-in virtualization covers both paths; dedicated export is redundant. |
+
+### Migration snippets
+
+```tsx
+// Before (deprecated)
+import {
+  OverflowToolTip, QueryInput, AIChatMessage, AIChatInput,
+  AITypingIndicator, AIQuickReply, AIFabLayout, VirtualizedAutocomplete,
+} from '@trinityui/design-system';
+
+// After
+import {
+  OverflowTooltip, InsightEngineInput, AIMessage, ChatThread,
+  AIShimmer, AISuggestedAction, AppLayout, Autocomplete,
+} from '@trinityui/design-system';
+
+// AIFabLayout → AppLayout
+<AppLayout navStyle="topnav" aiTrigger="fab">{children}</AppLayout>
+
+// AIChatMessage → AIMessage (richer API)
+<AIMessage response={response} streaming={isStreaming} />
+```
+
+### Deprecation signals
+
+Three overlapping warning channels so accidental usage can't slip through:
+
+1. **IDE hint** — every deprecated export has a `@deprecated` JSDoc tag. Your IDE strikes through the name on hover and in autocomplete.
+2. **TypeScript warning** — the same JSDoc tag triggers `ts(6385)` "'X' is deprecated" in tsc output.
+3. **Runtime console warning** — in development builds only, each deprecated component emits one `console.warn` per session on first render. Production builds strip the warning.
+
+If you're an end-user consuming Trinity via a framework that hides deprecation warnings, check your console in `NODE_ENV=development` mode before upgrading to v3.0.
+
+### Accessibility token updates (non-breaking default, visual change)
+
+Neutral tokens:
+- `semanticTokens.colors.text.disabled` moved from `gray[300]` (1.9:1 on white — failed WCAG AA) to `gray[500]` (4.83:1). Disabled text will render darker.
+- `semanticTokens.colors.border.default` moved from `gray[200]` to `gray[300]` for improved perceptibility.
+- `semanticTokens.colors.border.subtle` moved from `gray[100]` to `gray[200]`. Still decorative; see `docs/TOKEN_USAGE_RULES.md`.
+- `semanticTokens.colors.border.strong` moved from `gray[400]` to `gray[500]` so it meets WCAG 1.4.11 (3:1) for interactive component boundaries.
+
+Brand-color tokens (Option A from `docs/BRAND_COLOR_CONTRAST_PROPOSAL.md`):
+- `semanticTokens.colors.text.link` moved from `azure[500]` `#27AAE1` (~2.5:1) to `azure[900]` `#0E62CA` (~5.9:1).
+- `semanticTokens.colors.text.success` and `semanticTokens.colors.status.success.text` moved from `#16A34A` (3.3:1) to `#15803D` (~4.6:1).
+- `semanticTokens.colors.text.warning` and `semanticTokens.colors.status.warning.text` moved from `#D97706` (2.6:1) to `#B45309` (~4.8:1).
+- `semanticTokens.colors.status.info.text` moved from `azure[500]` to `azure[900]` for consistency with `text.link`.
+
+Expect deeper saturation on inline links, success/warning messages, alert text, and toast body copy. If consumer code relied on the brighter brand values, pin them via explicit hex or `baseTokens.colors.azure[500]` at the call site.
+
+If consumer code relied on the exact prior colors, pin them via `baseTokens.colors.gray[N]` at the call site.
+
+---
+
 ## v1.2.0 - Build Optimization (Breaking Change)
 
 ### Overview

package/README.md

@@ -1,6 +1,6 @@
 # Trinity Design System
 
-Enterprise component platform built on **MUI v7** for [Trinity LifeSciences](https://trinitylifesciences.com). Provides 100+ accessible React components, a 3-tier design token system, 35+ AI-specific components, 17 chart types, 18 custom hooks, and a CSS-only package for non-React consumers.
+Enterprise component platform built on **MUI v9** for [Trinity LifeSciences](https://trinitylifesciences.com). Provides 100+ accessible React components, a 3-tier design token system, 35+ AI-specific components, 17 chart types, 18 custom hooks, and a CSS-only package for non-React consumers.
 
 [![npm version](https://img.shields.io/npm/v/@trinityui/design-system.svg)](https://www.npmjs.com/package/@trinityui/design-system)
 [![npm css package](https://img.shields.io/npm/v/@trinityui/design-system-css.svg)](https://www.npmjs.com/package/@trinityui/design-system-css)
@@ -281,6 +281,61 @@ import { DataTable, setAgGridEnterpriseLicenseKey } from '@trinityui/design-syst
 setAgGridEnterpriseLicenseKey('<YOUR_KEY>');
 ```
 
+### App Layout
+
+`AppLayout` is the recommended shell for React applications that need Trinity branding, sidebar navigation, user context, and optional AI panel integration.
+
+```tsx
+import * as React from 'react';
+import HomeOutlinedIcon from '@mui/icons-material/HomeOutlined';
+import BarChartIcon from '@mui/icons-material/BarChart';
+import SettingsOutlinedIcon from '@mui/icons-material/SettingsOutlined';
+import { AppLayout, type NavItem } from '@trinityui/design-system';
+
+const navItems: NavItem[] = [
+  { id: 'home', label: 'Home', icon: <HomeOutlinedIcon /> },
+  { id: 'analytics', label: 'Analytics', icon: <BarChartIcon /> },
+  { id: 'settings', label: 'Settings', icon: <SettingsOutlinedIcon /> },
+];
+
+export default function AppShell() {
+  const [selectedNavItem, setSelectedNavItem] = React.useState('home');
+
+  return (
+    <AppLayout
+      navStyle="sidebar"
+      aiTrigger="none"
+      companyName="Portfolio Console"
+      navItems={navItems}
+      selectedNavItem={selectedNavItem}
+      onSelectedNavItemChange={setSelectedNavItem}
+      user={{ name: 'Jane Doe', email: 'jane@example.com', initials: 'JD' }}
+    >
+      <main>Page content</main>
+    </AppLayout>
+  );
+}
+```
+
+Optional header regions can be disabled when the consuming app owns those controls elsewhere:
+
+```tsx
+<AppLayout
+  navStyle="sidebar"
+  showSearch={false}
+  showClientSelector={false}
+  showSidebarToggle={false}
+>
+  <main>Page content</main>
+</AppLayout>
+```
+
+| Prop | Default | Description |
+|---|---:|---|
+| `showSearch` | `true` | Shows the desktop search field and mobile search action. |
+| `showClientSelector` | `true` | Shows the client selector dropdown in the header. |
+| `showSidebarToggle` | `true` | Shows the sidebar hamburger/collapse button in sidebar mode. |
+
 ---
 
 ### Input & Forms (18+ components)
@@ -295,7 +350,6 @@ setAgGridEnterpriseLicenseKey('<YOUR_KEY>');
 | `ChipsInput` | `@trinityui/design-system` | Tag/chip entry input with validation |
 | `MentionsInput` | `@trinityui/design-system` | @mention-enabled text input |
 | `FileUpload` / `UploadDropZone` | `@trinityui/design-system` | Drag-and-drop file upload with progress |
-| `RichTextEditor` | `@trinityui/design-system` | WYSIWYG rich text editor (Syncfusion) |
 | `CommandPalette` | `@trinityui/design-system` | Cmd+K style command palette with fuzzy search |
 | `FilterBar` | `@trinityui/design-system` | Multi-filter toolbar with presets and saved filters |
 | `NestedMenu` | `@trinityui/design-system` | Multi-level nested menu |