📦 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>

packages/client/src/locales/Translation.spec.ts

@@ -0,0 +1,47 @@
+import i18n from './i18n';
+import English from './en/translation.json';
+import French from './fr/translation.json';
+import Spanish from './es/translation.json';
+
+describe('i18next translation tests', () => {
+  // Ensure i18next is initialized before any tests run
+  beforeAll(async () => {
+    if (!i18n.isInitialized) {
+      await i18n.init();
+    }
+  });
+
+  it('should return the correct translation for a valid key in English', () => {
+    i18n.changeLanguage('en');
+    expect(i18n.t('com_ui_examples')).toBe(English.com_ui_examples);
+  });
+
+  it('should return the correct translation for a valid key in French', () => {
+    i18n.changeLanguage('fr');
+    expect(i18n.t('com_ui_examples')).toBe(French.com_ui_examples);
+  });
+
+  it('should return the correct translation for a valid key in Spanish', () => {
+    i18n.changeLanguage('es');
+    expect(i18n.t('com_ui_examples')).toBe(Spanish.com_ui_examples);
+  });
+
+  it('should fallback to English for an invalid language code', () => {
+    // When an invalid language is provided, i18next should fallback to English
+    i18n.changeLanguage('invalid-code');
+    expect(i18n.t('com_ui_examples')).toBe(English.com_ui_examples);
+  });
+
+  it('should return the key itself for an invalid key', () => {
+    i18n.changeLanguage('en');
+    expect(i18n.t('invalid-key')).toBe('invalid-key'); // Returns the key itself
+  });
+
+  it('should correctly format placeholders in the translation', () => {
+    i18n.changeLanguage('en');
+    expect(i18n.t('com_endpoint_default_with_num', { 0: 'John' })).toBe('default: John');
+
+    i18n.changeLanguage('fr');
+    expect(i18n.t('com_endpoint_default_with_num', { 0: 'Marie' })).toBe('par défaut : Marie');
+  });
+});

packages/client/src/locales/ar/translation.json

@@ -0,0 +1,3 @@
+{
+  "com_ui_cancel": "إلغاء"
+}

packages/client/src/locales/ca/translation.json

@@ -0,0 +1,3 @@
+{
+  "com_ui_cancel": "Cancel·la"
+}

packages/client/src/locales/cs/translation.json

@@ -0,0 +1,3 @@
+{
+  "com_ui_cancel": "Zrušit"
+}

packages/client/src/locales/da/translation.json

@@ -0,0 +1,3 @@
+{
+  "com_ui_cancel": "Annuller"
+}

packages/client/src/locales/de/translation.json

@@ -0,0 +1,3 @@
+{
+  "com_ui_cancel": "Abbrechen"
+}

packages/client/src/locales/en/translation.json

@@ -0,0 +1,3 @@
+{
+  "com_ui_cancel": "Cancel"
+}

packages/client/src/locales/es/translation.json

@@ -0,0 +1,3 @@
+{
+  "com_ui_cancel": "Cancelar"
+}

packages/client/src/locales/et/translation.json

@@ -0,0 +1,3 @@
+{
+  "com_ui_cancel": "Tühista"
+}

packages/client/src/locales/fa/translation.json

@@ -0,0 +1,3 @@
+{
+  "com_ui_cancel": "لغو کنید"
+}

packages/client/src/locales/fi/translation.json

@@ -0,0 +1,3 @@
+{
+  "com_ui_cancel": "Peruuta"
+}

packages/client/src/locales/fr/translation.json

@@ -0,0 +1,3 @@
+{
+  "com_ui_cancel": "Annuler"
+}

packages/client/src/locales/he/translation.json

@@ -0,0 +1,3 @@
+{
+  "com_ui_cancel": "בטל"
+}

packages/client/src/locales/hu/translation.json

@@ -0,0 +1,3 @@
+{
+  "com_ui_cancel": "Mégse"
+}

packages/client/src/locales/i18n.ts

@@ -0,0 +1,87 @@
+import i18n from 'i18next';
+import { initReactI18next } from 'react-i18next';
+import LanguageDetector from 'i18next-browser-languagedetector';
+
+import translationEn from './en/translation.json';
+import translationAr from './ar/translation.json';
+import translationCa from './ca/translation.json';
+import translationCs from './cs/translation.json';
+import translationDa from './da/translation.json';
+import translationDe from './de/translation.json';
+import translationEs from './es/translation.json';
+import translationEt from './et/translation.json';
+import translationFa from './fa/translation.json';
+import translationFr from './fr/translation.json';
+import translationIt from './it/translation.json';
+import translationPl from './pl/translation.json';
+import translationPt_BR from './pt-BR/translation.json';
+import translationPt_PT from './pt-PT/translation.json';
+import translationRu from './ru/translation.json';
+import translationJa from './ja/translation.json';
+import translationKa from './ka/translation.json';
+import translationSv from './sv/translation.json';
+import translationKo from './ko/translation.json';
+import translationTh from './th/translation.json';
+import translationTr from './tr/translation.json';
+import translationVi from './vi/translation.json';
+import translationNl from './nl/translation.json';
+import translationId from './id/translation.json';
+import translationHe from './he/translation.json';
+import translationHu from './hu/translation.json';
+import translationFi from './fi/translation.json';
+import translationZh_Hans from './zh-Hans/translation.json';
+import translationZh_Hant from './zh-Hant/translation.json';
+
+export const defaultNS = 'translation';
+
+export const resources = {
+  en: { translation: translationEn },
+  ar: { translation: translationAr },
+  ca: { translation: translationCa },
+  cs: { translation: translationCs },
+  'zh-Hans': { translation: translationZh_Hans },
+  'zh-Hant': { translation: translationZh_Hant },
+  da: { translation: translationDa },
+  de: { translation: translationDe },
+  es: { translation: translationEs },
+  et: { translation: translationEt },
+  fa: { translation: translationFa },
+  fr: { translation: translationFr },
+  it: { translation: translationIt },
+  pl: { translation: translationPl },
+  'pt-BR': { translation: translationPt_BR },
+  'pt-PT': { translation: translationPt_PT },
+  ru: { translation: translationRu },
+  ja: { translation: translationJa },
+  ka: { translation: translationKa },
+  sv: { translation: translationSv },
+  ko: { translation: translationKo },
+  th: { translation: translationTh },
+  tr: { translation: translationTr },
+  vi: { translation: translationVi },
+  nl: { translation: translationNl },
+  id: { translation: translationId },
+  he: { translation: translationHe },
+  hu: { translation: translationHu },
+  fi: { translation: translationFi },
+} as const;
+
+i18n
+  .use(LanguageDetector)
+  .use(initReactI18next)
+  .init({
+    fallbackLng: {
+      'zh-TW': ['zh-Hant', 'en'],
+      'zh-HK': ['zh-Hant', 'en'],
+      zh: ['zh-Hans', 'en'],
+      default: ['en'],
+    },
+    fallbackNS: 'translation',
+    ns: ['translation'],
+    debug: false,
+    defaultNS,
+    resources,
+    interpolation: { escapeValue: false },
+  });
+
+export default i18n;

packages/client/src/locales/id/translation.json

@@ -0,0 +1,3 @@
+{
+  "com_ui_cancel": "Batal"
+}

packages/client/src/locales/it/translation.json

@@ -0,0 +1,3 @@
+{
+  "com_ui_cancel": "Annulla"
+}

packages/client/src/locales/ja/translation.json

@@ -0,0 +1,3 @@
+{
+  "com_ui_cancel": "キャンセル"
+}

packages/client/src/locales/ka/translation.json

@@ -0,0 +1,3 @@
+{
+  "com_ui_cancel": "გაუქმება"
+}

packages/client/src/locales/ko/translation.json

@@ -0,0 +1,3 @@
+{
+  "com_ui_cancel": "취소"
+}

packages/client/src/locales/nl/translation.json

@@ -0,0 +1,3 @@
+{
+  "com_ui_cancel": "Annuleren"
+}

packages/client/src/locales/pl/translation.json

@@ -0,0 +1,3 @@
+{
+  "com_ui_cancel": "Anuluj"
+}

packages/client/src/locales/pt-BR/translation.json

@@ -0,0 +1,3 @@
+{
+  "com_ui_cancel": "Cancelar"
+}

packages/client/src/locales/pt-PT/translation.json

@@ -0,0 +1,3 @@
+{
+  "com_ui_cancel": "Cancelar"
+}

packages/client/src/locales/ru/translation.json

@@ -0,0 +1,3 @@
+{
+  "com_ui_cancel": "Отмена"
+}

packages/client/src/locales/sv/translation.json

@@ -0,0 +1,3 @@
+{
+  "com_ui_cancel": "Avbryt"
+}

packages/client/src/locales/th/translation.json

@@ -0,0 +1,3 @@
+{
+  "com_ui_cancel": "ยกเลิก"
+}

packages/client/src/locales/tr/translation.json

@@ -0,0 +1,3 @@
+{
+  "com_ui_cancel": "İptal"
+}

packages/client/src/locales/vi/translation.json

@@ -0,0 +1,3 @@
+{
+  "com_ui_cancel": "Hủy"
+}

packages/client/src/locales/zh-Hans/translation.json

@@ -0,0 +1,3 @@
+{
+  "com_ui_cancel": "取消"
+}

packages/client/src/locales/zh-Hant/translation.json

@@ -0,0 +1,3 @@
+{
+  "com_ui_cancel": "取消"
+}