📦 feat: Move Shared Components to @librechat/client (#8685)

* feat: init @librechat/client

* feat: Add common types and interfaces for accessibility, agents, artifacts, assistants, and tools

* feat: Add jotai as a peer dependency

* fix build client package

* feat: cleanup unused types from common/index.ts

- Remove 104 unused type exports from packages/client/src/common/index.ts
- Keep only 7 actually used exports (93% reduction)
- Add cleanup script with enhanced import pattern detection
- Support both named imports and namespace imports (* as t)
- Create automatic backups and comprehensive documentation
- Maintain type safety with build verification
- No breaking changes to existing code

Kept exports:
- TShowToast, Option, OptionWithIcon, DropdownValueSetter
- MentionOption, NotificationSeverity, MenuItemProps

Scripts: cleanup-common-types-safe.js, README-CLEANUP.md

* fix: cleanup

* fix: package; refactor: tsconfig

* feat: add back `recoil`

* fix: move dependencies to peerDependencies in client package

* feat: add @librechat/client as a dependency in package.json and package-lock.json

* feat: update client package configuration and dependencies

- Added new dependencies for Rollup plugins and updated existing ones in package.json and package-lock.json.
- Introduced a new Rollup configuration file for building the client package.
- Refactored build scripts to include a dedicated build command for the client.
- Updated TypeScript configuration for improved module resolution and type declaration output.
- Integrated a Toast component from the client package into the main App component.

* feat: enhance Rollup configuration for client package

- Updated terser plugin settings to preserve directives like 'use client'.
- Added custom warning handler to ignore "use client" directive warnings during the build process.

* chore: rename package/client build script command

* feat: update client package dependencies and Rollup configuration

- Added rollup-plugin-postcss to package.json and updated package-lock.json.
- Enhanced Rollup configuration to include postcss plugin for CSS handling.
- Updated index.ts to export all components from the components directory for better modularity.

* feat: add client package directory to update configuration

- Included the 'client' package directory in the update.js configuration to ensure it is recognized during updates.

* feat: export Toast component in client package

- Added export for the Toast component in index.ts to enhance modularity and accessibility of components.

* feat: /client transition to @librechat/client

* chore: fixed formatting issues

* fix: update peer dependencies in @librechat/client to prevent bundling them

* fix: correct useSprings implementation in SplitText component

* fix: circular dependencies in DataTable

* fix: add remaining peer dependencies and match actual versions previously used in `client/package.json`

* fix: correct frontend:ci script to include client package build

* chore: enhance unused package detection for @librechat/client and improve dependency extraction

* fix: add missing peer dependency for @radix-ui/react-collapsible

* chore: include "packages/client" in unused i18next keys detection

* test: update AgentFooter tests to use document.querySelector for spinner checks
test: mock window.matchMedia in setupTests.js for consistent test environment

* feat: add react-hook-form dependency and update FormInput component to use its types

* chore: linting

* refactor: remove unused defaultSelectedValues prop from MCPSelect and MultiSelect components

* chore: linting

* feat: update GitHub Actions workflow to publish @librechat/client

* chore: update GitHub Actions workflow to install and build data-provider and client dependencies

* chore: add missing @testing-library/react dependency to client package

* chore: update tsconfig.json to exclude additional test files

* chore: fix build issues, resolve latest LC changes

* chore: move MCP components outside of `~/components/ui`

* feat: implement dynamic theme system with environment variable support and Tailwind CSS integration

* chore: remove unnecessary logging of sttExternal and ttsExternal in Speech component

* chore: squashed cleanup commits

chore: move @tanstack/react-virtual to dependencies and remove recoil from package.json

chore: move dependencies to peerDependencies in package.json

feat: update package.json and rollup.config.js to include jotai and enhance bundling configuration

feat: update package.json and rollup.config.js to include jotai and enhance bundling configuration

refactor: reorganize exports in index.ts for improved clarity

refactor: remove unused types and interfaces from common files

refactor: update peer dependencies and improve component typings

- Removed duplicate peer dependencies from package.json and organized them.
- Updated rollup.config.js to disable TypeScript checking during the build process.
- Modified AnimatedTabs component to use React.ReactNode for label and content types, and added TypeScript workarounds for compatibility.
- Enhanced Label and Separator components to accept an optional className prop and improved prop spreading.
- Updated Slider component to include an optional className prop and refined prop handling for better type safety.

refactor: clean up client workflow and update package dependencies

refactor: update package dependencies and improve PostCSS and Rollup configurations

chore: bump version to 0.1.2 in package.json

chore: bump client version to 0.1.2 in package-lock.json

chore: bump client version to 0.1.3 and update dependencies

chore: bump client version to 0.1.4 and update @react-spring dependencies

chore: update package version to 0.1.5 and adjust peer dependencies

- Bump version in package.json from 0.1.4 to 0.1.5.
- Update peer dependency for @tanstack/react-query to allow version 5.0.0.
- Add @tanstack/react-table and @tanstack/react-virtual as dependencies.
- Update various dependencies to their latest compatible versions.
- Simplify postcss.config.js by removing unnecessary options.
- Clean up rollup.config.js by removing ignored PostCSS warnings.
- Update CheckboxButton component to cast icon as React JSX element.
- Adjust Combobox component's class names for better styling.
- Change DropdownPopup component to use React's namespace import.
- Modify InputOTP component to use 'any' type for OTPInputContext.
- Ensure displayLabel and value in ModelParameters are converted to strings.
- Update MultiSearch component's placeholder to ensure it's a string.
- Cast selectIcon in MultiSelect as React JSX element for consistency.
- Update OGDialogTemplate to cast selectText as React JSX element.
- Initialize animationRef in PixelCard with undefined for clarity.
- Add TypeScript ignore comments in Select and SelectDropDown components for Radix UI type conflicts.
- Ensure title in SelectDropDown is a string and adjust rendering of options.
- Update useLocalize hook to cast options as any for compatibility.

refactor: code structure; chore: translations cleanup

chore: remove unused imports and clean up code in NewChat component

refactor: enhance Menu component to support custom render functions for menu items

style: update itemClassName in ToolsDropdown for improved UI consistency

fix: merge conflicts

chore: update @radix-ui/react-accordion to version 1.2.11

* refactor: remove unnecessary TypeScript type assertions in AnimatedTabs, Label, Separator, and Slider components

* feat: enhance theme system with localStorage persistence and new theme atoms

* chore: bump version of @librechat/client to 0.1.7

* chore: fix ci/cd warnings/errors related to linting and unused localization keys

* chore: update dependencies for class-variance-authority, clsx, and match-sorter

* chore: bump @librechat/client to v0.1.8

* feat: add utility colors for theme customization and remove unused tailwindConfig

* v0.1.9

---------

Co-authored-by: Marco Beretta <81851188+berry-13@users.noreply.github.com>
This commit is contained in:
Danny Avila 2025-07-27 12:19:01 -04:00 committed by GitHub
parent 97e1cdd224
commit 79197454f8
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
569 changed files with 7010 additions and 1848 deletions

View file

@ -0,0 +1,115 @@
import { IThemeRGB, IThemeVariables } from '../types';
/**
* Validates RGB string format (e.g., "255 255 255")
*/
function validateRGB(rgb: string): boolean {
if (!rgb) return true;
const rgbRegex = /^(\d{1,3})\s+(\d{1,3})\s+(\d{1,3})$/;
const match = rgb.match(rgbRegex);
if (!match) return false;
// Check that each value is between 0-255
const [, r, g, b] = match;
return [r, g, b].every((val) => {
const num = parseInt(val, 10);
return num >= 0 && num <= 255;
});
}
/**
* Maps theme RGB values to CSS variables
*/
function mapTheme(rgb: IThemeRGB): Partial<IThemeVariables> {
const variables: Partial<IThemeVariables> = {};
// Map each RGB value to its corresponding CSS variable
const mappings: Record<keyof IThemeRGB, keyof IThemeVariables> = {
'rgb-text-primary': '--text-primary',
'rgb-text-secondary': '--text-secondary',
'rgb-text-secondary-alt': '--text-secondary-alt',
'rgb-text-tertiary': '--text-tertiary',
'rgb-text-warning': '--text-warning',
'rgb-ring-primary': '--ring-primary',
'rgb-header-primary': '--header-primary',
'rgb-header-hover': '--header-hover',
'rgb-header-button-hover': '--header-button-hover',
'rgb-surface-active': '--surface-active',
'rgb-surface-active-alt': '--surface-active-alt',
'rgb-surface-hover': '--surface-hover',
'rgb-surface-hover-alt': '--surface-hover-alt',
'rgb-surface-primary': '--surface-primary',
'rgb-surface-primary-alt': '--surface-primary-alt',
'rgb-surface-primary-contrast': '--surface-primary-contrast',
'rgb-surface-secondary': '--surface-secondary',
'rgb-surface-secondary-alt': '--surface-secondary-alt',
'rgb-surface-tertiary': '--surface-tertiary',
'rgb-surface-tertiary-alt': '--surface-tertiary-alt',
'rgb-surface-dialog': '--surface-dialog',
'rgb-surface-submit': '--surface-submit',
'rgb-surface-submit-hover': '--surface-submit-hover',
'rgb-surface-destructive': '--surface-destructive',
'rgb-surface-destructive-hover': '--surface-destructive-hover',
'rgb-surface-chat': '--surface-chat',
'rgb-border-light': '--border-light',
'rgb-border-medium': '--border-medium',
'rgb-border-medium-alt': '--border-medium-alt',
'rgb-border-heavy': '--border-heavy',
'rgb-border-xheavy': '--border-xheavy',
'rgb-brand-purple': '--brand-purple',
'rgb-presentation': '--presentation',
// Utility colors
'rgb-background': '--background',
'rgb-foreground': '--foreground',
'rgb-primary': '--primary',
'rgb-primary-foreground': '--primary-foreground',
'rgb-secondary': '--secondary',
'rgb-secondary-foreground': '--secondary-foreground',
'rgb-muted': '--muted',
'rgb-muted-foreground': '--muted-foreground',
'rgb-accent': '--accent',
'rgb-accent-foreground': '--accent-foreground',
'rgb-destructive-foreground': '--destructive-foreground',
'rgb-border': '--border',
'rgb-input': '--input',
'rgb-ring': '--ring',
'rgb-card': '--card',
'rgb-card-foreground': '--card-foreground',
};
Object.entries(mappings).forEach(([rgbKey, cssVar]) => {
const value = rgb[rgbKey as keyof IThemeRGB];
if (value) {
variables[cssVar] = value;
}
});
return variables;
}
/**
* Applies theme to the document root
* Sets CSS variables as rgb() values for compatibility with existing CSS
*/
export default function applyTheme(themeRGB?: IThemeRGB) {
if (!themeRGB) return;
const themeObject = mapTheme(themeRGB);
const root = document.documentElement;
Object.entries(themeObject).forEach(([cssVar, value]) => {
if (!value) return;
const validation = validateRGB(value);
if (!validation) {
console.error(`Invalid RGB value for ${cssVar}: ${value}`);
return;
}
// Set the CSS variable as rgb() value for compatibility
// This ensures existing CSS that expects color values (not space-separated RGB) continues to work
root.style.setProperty(cssVar, `rgb(${value})`);
});
}

View file

@ -0,0 +1,86 @@
/**
* Helper function to create a color value that uses CSS variables with alpha support
* This is a CommonJS version for use in tailwind.config.js
*/
function withOpacity(variableName) {
return ({ opacityValue }) => {
if (opacityValue !== undefined) {
// The CSS variable already contains rgb() so we need to extract the values
return `rgba(var(${variableName}), ${opacityValue})`.replace('rgb(', '').replace(')', '');
}
return `var(${variableName})`;
};
}
/**
* Creates Tailwind color configuration that uses CSS variables
* This allows dynamic theme switching by changing CSS variable values
*/
function createTailwindColors() {
return {
'text-primary': withOpacity('--text-primary'),
'text-secondary': withOpacity('--text-secondary'),
'text-secondary-alt': withOpacity('--text-secondary-alt'),
'text-tertiary': withOpacity('--text-tertiary'),
'text-warning': withOpacity('--text-warning'),
'ring-primary': withOpacity('--ring-primary'),
'header-primary': withOpacity('--header-primary'),
'header-hover': withOpacity('--header-hover'),
'header-button-hover': withOpacity('--header-button-hover'),
'surface-active': withOpacity('--surface-active'),
'surface-active-alt': withOpacity('--surface-active-alt'),
'surface-hover': withOpacity('--surface-hover'),
'surface-hover-alt': withOpacity('--surface-hover-alt'),
'surface-primary': withOpacity('--surface-primary'),
'surface-primary-alt': withOpacity('--surface-primary-alt'),
'surface-primary-contrast': withOpacity('--surface-primary-contrast'),
'surface-secondary': withOpacity('--surface-secondary'),
'surface-secondary-alt': withOpacity('--surface-secondary-alt'),
'surface-tertiary': withOpacity('--surface-tertiary'),
'surface-tertiary-alt': withOpacity('--surface-tertiary-alt'),
'surface-dialog': withOpacity('--surface-dialog'),
'surface-submit': withOpacity('--surface-submit'),
'surface-submit-hover': withOpacity('--surface-submit-hover'),
'surface-destructive': withOpacity('--surface-destructive'),
'surface-destructive-hover': withOpacity('--surface-destructive-hover'),
'surface-chat': withOpacity('--surface-chat'),
'border-light': withOpacity('--border-light'),
'border-medium': withOpacity('--border-medium'),
'border-medium-alt': withOpacity('--border-medium-alt'),
'border-heavy': withOpacity('--border-heavy'),
'border-xheavy': withOpacity('--border-xheavy'),
'brand-purple': withOpacity('--brand-purple'),
presentation: withOpacity('--presentation'),
background: withOpacity('--background'),
foreground: withOpacity('--foreground'),
primary: {
DEFAULT: withOpacity('--primary'),
foreground: withOpacity('--primary-foreground'),
},
secondary: {
DEFAULT: withOpacity('--secondary'),
foreground: withOpacity('--secondary-foreground'),
},
muted: {
DEFAULT: withOpacity('--muted'),
foreground: withOpacity('--muted-foreground'),
},
accent: {
DEFAULT: withOpacity('--accent'),
foreground: withOpacity('--accent-foreground'),
},
destructive: {
DEFAULT: withOpacity('--surface-destructive'),
foreground: withOpacity('--destructive-foreground'),
},
border: withOpacity('--border'),
input: withOpacity('--input'),
ring: withOpacity('--ring'),
card: {
DEFAULT: withOpacity('--card'),
foreground: withOpacity('--card-foreground'),
},
};
}
module.exports = { createTailwindColors };