🧩 refactor: Shared UI Design System Tokens

[danny-avila]

I added a conflict-safe shared design-system foundation on top of the merged #13879 migration, preparing LibreChat for the #14473 composer redesign without modifying the legacy composer input files.

• Add reusable IconButton and Chip primitives to @librechat/client.
• Add semantic overlay, strong-status, and status-text tokens across runtime themes, Tailwind, CSS defaults, and theme documentation.
• Refactor shared Tag, Toast, dialogs, search animation, and Button styling to semantic tokens.
• Fix the invalid nested-button structure in Badge and add an accessibility regression test.
• Add component tests, theme mapping tests, and a focused guardrail against direct palette utilities and hex colors in shared primitives.

Change Type

• New feature (non-breaking change which adds functionality)
• This change requires a documentation update

Testing

I ran the full @librechat/client Jest suite: 18 suites and 168 tests passed. TypeScript, Prettier, git diff --check, and Tailwind semantic-color loading also passed.

The normal package build is currently blocked before bundling by the existing local Node 24 rimraf/brace-expansion dependency mismatch.

Test Configuration:

• Node.js 24.16.0
• Jest 30.2.0
• TypeScript 5.9.3

Checklist

• My code adheres to this project's style guidelines
• I have performed a self-review of my own code
• I have commented in complex areas of my code where needed
• I have made pertinent documentation changes
• My changes do not introduce new warnings
• I have written tests demonstrating that my feature works
• Local unit tests pass with my changes
• Any changes dependent on mine have been merged and published in downstream modules.

[Copilot]

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

[danny-avila]

@codex review

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: ddcf77e477

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[danny-avila]

@codex review

[chatgpt-codex-connector]

Codex Review: Didn't find any major issues. What shall we delve into next?

Reviewed commit: 3598fa5b19

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".