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

client/src/components/SidePanel/Builder/Action.tsx

@@ -1,6 +1,6 @@
 import { useState } from 'react';
+import { GearIcon } from '@librechat/client';
 import type { Action } from 'librechat-data-provider';
-import GearIcon from '~/components/svg/GearIcon';
 import { cn } from '~/utils';
 
 export default function Action({ action, onClick }: { action: Action; onClick: () => void }) {

client/src/components/SidePanel/Builder/ActionCallback.tsx

@@ -2,9 +2,8 @@ import { useState } from 'react';
 import { Copy, CopyCheck } from 'lucide-react';
 import { useFormContext } from 'react-hook-form';
 import { AuthTypeEnum } from 'librechat-data-provider';
+import { Button, useToastContext } from '@librechat/client';
 import { useLocalize, useCopyToClipboard } from '~/hooks';
-import { useToastContext } from '~/Providers';
-import { Button } from '~/components/ui';
 import { cn } from '~/utils';
 
 export default function ActionCallback({ action_id }: { action_id?: string }) {

client/src/components/SidePanel/Builder/ActionsAuth.tsx

@@ -13,7 +13,7 @@ import {
   OGDialogHeader,
   OGDialogContent,
   OGDialogTrigger,
-} from '~/components/ui';
+} from '@librechat/client';
 import { TranslationKeys, useLocalize } from '~/hooks';
 import { cn } from '~/utils';
 

client/src/components/SidePanel/Builder/ActionsInput.tsx

@@ -1,6 +1,7 @@
 import debounce from 'lodash/debounce';
 import { useState, useEffect } from 'react';
 import { useFormContext } from 'react-hook-form';
+import { Spinner, useToastContext } from '@librechat/client';
 import {
   validateAndParseOpenAPISpec,
   openapiToFunction,
@@ -16,11 +17,10 @@ import type {
 import type { ActionAuthForm, ActionWithNullableMetadata } from '~/common';
 import type { Spec } from './ActionsTable';
 import ActionCallback from '~/components/SidePanel/Builder/ActionCallback';
-import { useAssistantsMapContext, useToastContext } from '~/Providers';
+import { useAssistantsMapContext } from '~/Providers';
 import { ActionsTable, columns } from './ActionsTable';
 import { useUpdateAction } from '~/data-provider';
-import useLocalize from '~/hooks/useLocalize';
-import { Spinner } from '~/components/svg';
+import { useLocalize } from '~/hooks';
 
 const debouncedValidation = debounce(
   (input: string, callback: (result: ValidationResult) => void) => {

client/src/components/SidePanel/Builder/ActionsPanel.tsx

@@ -1,20 +1,25 @@
 import { useEffect } from 'react';
+import { ChevronLeft } from 'lucide-react';
 import { useForm, FormProvider } from 'react-hook-form';
 import {
   AuthTypeEnum,
   AuthorizationTypeEnum,
   TokenExchangeMethodEnum,
 } from 'librechat-data-provider';
-import { ChevronLeft } from 'lucide-react';
+import {
+  OGDialog,
+  OGDialogTrigger,
+  Label,
+  OGDialogTemplate,
+  useToastContext,
+  TrashIcon,
+} from '@librechat/client';
 import type { AssistantPanelProps, ActionAuthForm } from '~/common';
-import { useAssistantsMapContext, useToastContext } from '~/Providers';
-import { OGDialog, OGDialogTrigger, Label } from '~/components/ui';
-import OGDialogTemplate from '~/components/ui/OGDialogTemplate';
+import { useAssistantsMapContext } from '~/Providers';
 import { useDeleteAction } from '~/data-provider';
-import { TrashIcon } from '~/components/svg';
-import useLocalize from '~/hooks/useLocalize';
 import ActionsInput from './ActionsInput';
 import ActionsAuth from './ActionsAuth';
+import { useLocalize } from '~/hooks';
 import { Panel } from '~/common';
 
 export default function ActionsPanel({

client/src/components/SidePanel/Builder/AppendDateCheckbox.tsx

@@ -1,15 +1,15 @@
 import { Control, Controller, UseFormSetValue, UseFormGetValues } from 'react-hook-form';
-import { CircleHelpIcon } from '~/components/svg';
-import { useLocalize } from '~/hooks';
 import {
+  CircleHelpIcon,
   HoverCard,
   HoverCardContent,
   HoverCardPortal,
   HoverCardTrigger,
   Checkbox,
-} from '~/components/ui';
-import { ESide } from '~/common';
+} from '@librechat/client';
 import type { AssistantForm } from '~/common';
+import { useLocalize } from '~/hooks';
+import { ESide } from '~/common';
 
 interface AppendDateCheckboxProps {
   control: Control<AssistantForm>;

client/src/components/SidePanel/Builder/AssistantAvatar.tsx

@@ -1,5 +1,6 @@
-import * as Popover from '@radix-ui/react-popover';
 import { useState, useEffect, useRef, useMemo } from 'react';
+import * as Popover from '@radix-ui/react-popover';
+import { useToastContext } from '@librechat/client';
 import { useQueryClient } from '@tanstack/react-query';
 import {
   fileConfig as defaultFileConfig,
@@ -7,7 +8,6 @@ import {
   defaultOrderQuery,
   mergeFileConfig,
 } from 'librechat-data-provider';
-import type { UseMutationResult } from '@tanstack/react-query';
 import type {
   Metadata,
   Assistant,
@@ -15,10 +15,11 @@ import type {
   AssistantCreateParams,
   AssistantListResponse,
 } from 'librechat-data-provider';
+import type { UseMutationResult } from '@tanstack/react-query';
 import { useUploadAssistantAvatarMutation, useGetFileConfig } from '~/data-provider';
-import { useToastContext, useAssistantsMapContext } from '~/Providers';
 import { AssistantAvatar, NoImage, AvatarMenu } from './Images';
-// import { Spinner } from '~/components/svg';
+import { useAssistantsMapContext } from '~/Providers';
+// import { Spinner } from '@librechat/client';
 import { useLocalize } from '~/hooks';
 import { formatBytes } from '~/utils';
 

client/src/components/SidePanel/Builder/AssistantConversationStarters.tsx

@@ -1,8 +1,8 @@
 import React, { useRef, useState } from 'react';
 import { Plus, X } from 'lucide-react';
+import { TooltipAnchor } from '@librechat/client';
 import { Transition } from 'react-transition-group';
 import { Constants } from 'librechat-data-provider';
-import { TooltipAnchor } from '~/components/ui';
 import { useLocalize } from '~/hooks';
 
 interface AssistantConversationStartersProps {

client/src/components/SidePanel/Builder/AssistantPanel.tsx

@@ -1,6 +1,7 @@
 import { useState, useMemo } from 'react';
-import { useForm, FormProvider, Controller, useWatch } from 'react-hook-form';
 import { useGetModelsQuery } from 'librechat-data-provider/react-query';
+import { Spinner, useToastContext, SelectDropDown } from '@librechat/client';
+import { useForm, FormProvider, Controller, useWatch } from 'react-hook-form';
 import {
   Tools,
   Capabilities,
@@ -18,16 +19,14 @@ import {
 import { cn, cardStyle, defaultTextProps, removeFocusOutlines } from '~/utils';
 import AssistantConversationStarters from './AssistantConversationStarters';
 import AssistantToolsDialog from '~/components/Tools/AssistantToolsDialog';
-import { useAssistantsMapContext, useToastContext } from '~/Providers';
 import { useSelectAssistant, useLocalize } from '~/hooks';
+import { useAssistantsMapContext } from '~/Providers';
 import AppendDateCheckbox from './AppendDateCheckbox';
 import CapabilitiesForm from './CapabilitiesForm';
-import { SelectDropDown } from '~/components/ui';
 import AssistantAvatar from './AssistantAvatar';
 import AssistantSelect from './AssistantSelect';
 import ContextButton from './ContextButton';
 import AssistantTool from './AssistantTool';
-import { Spinner } from '~/components/svg';
 import Knowledge from './Knowledge';
 import { Panel } from '~/common';
 import Action from './Action';

client/src/components/SidePanel/Builder/AssistantSelect.tsx

@@ -1,5 +1,6 @@
-import { Plus } from 'lucide-react';
 import { useMemo, useCallback, useEffect, useRef } from 'react';
+import { Plus } from 'lucide-react';
+import { SelectDropDown } from '@librechat/client';
 import {
   Tools,
   FileSources,
@@ -9,8 +10,6 @@ import {
   isImageVisionTool,
   defaultAssistantFormValues,
 } from 'librechat-data-provider';
-import type { UseFormReset } from 'react-hook-form';
-import type { UseMutationResult } from '@tanstack/react-query';
 import type {
   TPlugin,
   Assistant,
@@ -25,7 +24,8 @@ import type {
   TAssistantOption,
   LastSelectedModels,
 } from '~/common';
-import SelectDropDown from '~/components/ui/SelectDropDown';
+import type { UseMutationResult } from '@tanstack/react-query';
+import type { UseFormReset } from 'react-hook-form';
 import { useListAssistantsQuery } from '~/data-provider';
 import { useLocalize, useLocalStorage } from '~/hooks';
 import { cn, createDropdownSetter } from '~/utils';

client/src/components/SidePanel/Builder/AssistantTool.tsx

@@ -1,11 +1,15 @@
 import React, { useState } from 'react';
 import { useFormContext } from 'react-hook-form';
-import type { TPlugin } from 'librechat-data-provider';
 import { useUpdateUserPluginsMutation } from 'librechat-data-provider/react-query';
-import { OGDialog, OGDialogTrigger, Label } from '~/components/ui';
-import OGDialogTemplate from '~/components/ui/OGDialogTemplate';
-import { useToastContext } from '~/Providers';
-import { TrashIcon } from '~/components/svg';
+import {
+  OGDialog,
+  OGDialogTrigger,
+  Label,
+  OGDialogTemplate,
+  TrashIcon,
+  useToastContext,
+} from '@librechat/client';
+import type { TPlugin } from 'librechat-data-provider';
 import { useLocalize } from '~/hooks';
 import { cn } from '~/utils';
 

client/src/components/SidePanel/Builder/Code.tsx

@@ -1,14 +1,14 @@
 import { Capabilities } from 'librechat-data-provider';
 import { useFormContext, Controller } from 'react-hook-form';
-import type { AssistantForm } from '~/common';
 import {
   Checkbox,
   HoverCard,
   HoverCardContent,
   HoverCardPortal,
   HoverCardTrigger,
-} from '~/components/ui';
-import { CircleHelpIcon } from '~/components/svg';
+  CircleHelpIcon,
+} from '@librechat/client';
+import type { AssistantForm } from '~/common';
 import { useLocalize } from '~/hooks';
 import { ESide } from '~/common';
 
@@ -29,7 +29,7 @@ export default function Code({ version }: { version: number | string }) {
                 {...field}
                 checked={field.value}
                 onCheckedChange={field.onChange}
-                className="relative float-left  mr-2 inline-flex h-4 w-4 cursor-pointer"
+                className="relative float-left mr-2 inline-flex h-4 w-4 cursor-pointer"
                 value={field.value.toString()}
               />
             )}

client/src/components/SidePanel/Builder/CodeFiles.tsx

@@ -9,8 +9,8 @@ import type { ExtendedFile } from '~/common';
 import FileRow from '~/components/Chat/Input/Files/FileRow';
 import { useGetFileConfig } from '~/data-provider';
 import { useFileHandling } from '~/hooks/Files';
-import useLocalize from '~/hooks/useLocalize';
 import { useChatContext } from '~/Providers';
+import { useLocalize } from '~/hooks';
 
 const tool_resource = EToolResources.code_interpreter;
 

client/src/components/SidePanel/Builder/ContextButton.tsx

@@ -1,12 +1,17 @@
+import {
+  Dialog,
+  DialogTrigger,
+  Label,
+  DialogTemplate,
+  useToastContext,
+  TrashIcon,
+} from '@librechat/client';
 import type { Assistant, AssistantCreateParams, AssistantsEndpoint } from 'librechat-data-provider';
 import type { UseMutationResult } from '@tanstack/react-query';
-import { Dialog, DialogTrigger, Label } from '~/components/ui';
-import { useChatContext, useToastContext } from '~/Providers';
 import { useDeleteAssistantMutation } from '~/data-provider';
-import DialogTemplate from '~/components/ui/DialogTemplate';
 import { useLocalize, useSetIndexOptions } from '~/hooks';
-import { cn, removeFocusOutlines } from '~/utils/';
-import { TrashIcon } from '~/components/svg';
+import { cn, removeFocusOutlines } from '~/utils';
+import { useChatContext } from '~/Providers';
 
 export default function ContextButton({
   activeModel,

client/src/components/SidePanel/Builder/ImageVision.tsx

@@ -1,7 +1,7 @@
-import { useFormContext, Controller } from 'react-hook-form';
+import { Checkbox } from '@librechat/client';
 import { Capabilities } from 'librechat-data-provider';
+import { useFormContext, Controller } from 'react-hook-form';
 import type { AssistantForm } from '~/common';
-import { Checkbox, QuestionMark } from '~/components/ui';
 import { useLocalize } from '~/hooks';
 
 export default function ImageVision() {
@@ -19,7 +19,7 @@ export default function ImageVision() {
             {...field}
             checked={field.value}
             onCheckedChange={field.onChange}
-            className="relative float-left  mr-2 inline-flex h-4 w-4 cursor-pointer"
+            className="relative float-left mr-2 inline-flex h-4 w-4 cursor-pointer"
             value={field.value.toString()}
           />
         )}

client/src/components/SidePanel/Builder/Knowledge.tsx

@@ -9,8 +9,8 @@ import type { ExtendedFile } from '~/common';
 import FileRow from '~/components/Chat/Input/Files/FileRow';
 import { useGetFileConfig } from '~/data-provider';
 import { useFileHandling } from '~/hooks/Files';
-import useLocalize from '~/hooks/useLocalize';
 import { useChatContext } from '~/Providers';
+import { useLocalize } from '~/hooks';
 
 const CodeInterpreterFiles = ({ children }: { children: React.ReactNode }) => {
   const localize = useLocalize();

client/src/components/SidePanel/Builder/MCP.tsx

@@ -1,7 +1,6 @@
 import { useState } from 'react';
+import { GearIcon, MCPIcon } from '@librechat/client';
 import type { MCP } from 'librechat-data-provider';
-import GearIcon from '~/components/svg/GearIcon';
-import MCPIcon from '~/components/svg/MCPIcon';
 import { cn } from '~/utils';
 
 type MCPProps = {

client/src/components/SidePanel/Builder/MCPAuth.tsx

@@ -1,11 +1,11 @@
 import { useEffect } from 'react';
 import { FormProvider, useForm } from 'react-hook-form';
-import ActionsAuth from '~/components/SidePanel/Builder/ActionsAuth';
 import {
   AuthorizationTypeEnum,
   TokenExchangeMethodEnum,
   AuthTypeEnum,
 } from 'librechat-data-provider';
+import ActionsAuth from '~/components/SidePanel/Builder/ActionsAuth';
 
 export default function MCPAuth() {
   // Create a separate form for auth

client/src/components/SidePanel/Builder/Retrieval.tsx

@@ -8,13 +8,13 @@ import {
   HoverCardContent,
   HoverCardPortal,
   HoverCardTrigger,
-} from '~/components/ui';
+  CircleHelpIcon,
+} from '@librechat/client';
 import OptionHover from '~/components/SidePanel/Parameters/OptionHover';
-import { CircleHelpIcon } from '~/components/svg';
 import type { AssistantForm } from '~/common';
 import { useLocalize } from '~/hooks';
 import { ESide } from '~/common';
-import { cn } from '~/utils/';
+import { cn } from '~/utils';
 
 export default function Retrieval({
   version,