Enhanced ChatGPT Clone: Features Agents, MCP, Skills, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, o1, GPT-5, Mistral, OpenRouter, Vertex AI, Gemini, Artifacts, AI model switching, message search, Code Interpreter, langchain, DALL-E-3, OpenAPI Actions, Functions, Secure Multi-User Auth, Presets, open-source for self-hosting. Active
TypeScript aianthropicartifactsawsazurechatgptchatgpt-cloneclaudeclonedeepseekgeminigooglegpt-5librechatmcpo1openairesponses-apivisionwebui
⛶ feat: add fullscreen artifact previews (#14585)
Marco Beretta667d97d6688b
diff --git a/client/src/components/Artifacts/ArtifactVersion.tsx b/client/src/components/Artifacts/ArtifactVersion.tsxindex 7d17416cdf..a571fb406b 100644--- a/client/src/components/Artifacts/ArtifactVersion.tsx+++ b/client/src/components/Artifacts/ArtifactVersion.tsx@@ -7,12 +7,14 @@ import { useLocalize } from '~/hooks';interface ArtifactVersionProps {currentIndex: number;totalVersions: number;+ portalElement?: HTMLElement | null;onVersionChange: (index: number) => void;}export default function ArtifactVersion({currentIndex,totalVersions,+ portalElement,onVersionChange,}: ArtifactVersionProps) {const localize = useLocalize();@@ -51,6 +53,7 @@ export default function ArtifactVersion({<DropdownPopupmenuId={menuId}portal+ portalElement={portalElement}focusLoopunmountOnHideisOpen={isPopoverActive}@@ -58,6 +61,7 @@ export default function ArtifactVersion({trigger={<TooltipAnchordescription={localize('com_ui_change_version')}+ portalElement={portalElement}render={<Buttonsize="icon"diff --git a/client/src/components/Artifacts/Artifacts.tsx b/client/src/components/Artifacts/Artifacts.tsxindex 40e82eb082..f9bdbd888d 100644--- a/client/src/components/Artifacts/Artifacts.tsx+++ b/client/src/components/Artifacts/Artifacts.tsx@@ -1,20 +1,20 @@import { useRef, useState, useEffect, useCallback, useMemo } from 'react';import copy from 'copy-to-clipboard';import * as Tabs from '@radix-ui/react-tabs';-import { Code, Play, RefreshCw, X } from 'lucide-react';import { useSetRecoilState, useResetRecoilState } from 'recoil';import { Button, Spinner, useMediaQuery, Radio } from '@librechat/client';+import { Code, Maximize2, Minimize2, Play, RefreshCw, X } from 'lucide-react';import type { SandpackPreviewRef } from '@codesandbox/sandpack-react';+import { displayFilename } from '~/components/Chat/Messages/Content/Parts/attachmentTypes';+import { isCodeOnlyArtifact, isPreviewOnlyArtifact } from '~/utils/artifacts';import CopyButton from '~/components/Messages/Content/CopyButton';import { useShareContext, useMutationState } from '~/Providers';import useArtifacts from '~/hooks/Artifacts/useArtifacts';import DownloadArtifact from './DownloadArtifact';import ArtifactVersion from './ArtifactVersion';import ArtifactTabs from './ArtifactTabs';-import { isCodeOnlyArtifact, isPreviewOnlyArtifact } from '~/utils/artifacts';-import { displayFilename } from '~/components/Chat/Messages/Content/Parts/attachmentTypes';import { useLocalize } from '~/hooks';-import { cn } from '~/utils';+import { cn, logger } from '~/utils';import store from '~/store';const MAX_BLUR_AMOUNT = 32;@@ -26,9 +26,12 @@ export default function Artifacts() {const { isSharedConvo } = useShareContext();const isMobile = useMediaQuery('(max-width: 868px)');const previewRef = useRef<SandpackPreviewRef>();+ const artifactContainerRef = useRef<HTMLDivElement>(null);+ const fullscreenPortalRef = useRef<HTMLDivElement>(null);const [isVisible, setIsVisible] = useState(false);const [isClosing, setIsClosing] = useState(false);const [isRefreshing, setIsRefreshing] = useState(false);+ const [isFullscreen, setIsFullscreen] = useState(false);const [isMounted, setIsMounted] = useState(false);const [height, setHeight] = useState(90);const [isDragging, setIsDragging] = useState(false);@@ -65,6 +68,16 @@ export default function Artifacts() {};}, [isMobile]);+ useEffect(() => {+ const handleFullscreenChange = () => {+ const container = artifactContainerRef.current;+ setIsFullscreen(container !== null && document.fullscreenElement === container);+ };++ document.addEventListener('fullscreenchange', handleFullscreenChange);+ return () => document.removeEventListener('fullscreenchange', handleFullscreenChange);+ }, []);+useEffect(() => {if (!isMobile) {setBlurAmount(0);@@ -186,6 +199,23 @@ export default function Artifacts() {setTimeout(() => setIsRefreshing(false), 750);};+ const handleFullscreen = async () => {+ const container = artifactContainerRef.current;+ if (!container) {+ return;+ }++ try {+ if (document.fullscreenElement === container) {+ await document.exitFullscreen();+ return;+ }+ await container.requestFullscreen();+ } catch (error) {+ logger.error('Failed to toggle artifact fullscreen mode:', error);+ }+ };+const closeArtifacts = () => {if (isMobile) {setIsClosing(true);@@ -208,7 +238,7 @@ export default function Artifacts() {return (<Tabs.Root value={displayedTab} onValueChange={setActiveTab} asChild>- <div className="flex h-full w-full flex-col">+ <div ref={artifactContainerRef} className="flex h-full w-full flex-col bg-surface-primary">{/* Mobile backdrop with dynamic blur */}{isMobile && (<div@@ -233,7 +263,8 @@ export default function Artifacts() {'flex w-full flex-col bg-surface-primary text-xl text-text-primary',isMobile? cn(- 'fixed inset-x-0 bottom-0 z-[100] rounded-t-[20px] shadow-[0_-10px_60px_rgba(0,0,0,0.35)]',+ 'fixed z-[100] shadow-[0_-10px_60px_rgba(0,0,0,0.35)]',+ isFullscreen ? 'inset-0 rounded-none' : 'inset-x-0 bottom-0 rounded-t-[20px]',isVisible && !isClosing? 'translate-y-0 opacity-100': 'duration-250 translate-y-full opacity-0 transition-all',@@ -246,9 +277,11 @@ export default function Artifacts() {: 'translate-x-5 opacity-0 transition-all duration-300',),)}- style={isMobile ? { height: `${height}vh` } : { overflow: 'hidden' }}+ style={+ isMobile ? { height: isFullscreen ? '100%' : `${height}vh` } : { overflow: 'hidden' }+ }>- {isMobile && (+ {isMobile && !isFullscreen && (<divclassName="flex flex-shrink-0 cursor-grab items-center justify-center bg-surface-primary-alt pb-1.5 pt-2.5 active:cursor-grabbing"onPointerDown={handleDragStart}@@ -313,6 +346,23 @@ export default function Artifacts() {)}</Button>)}+ {(displayedTab === 'preview' || isFullscreen) && document.fullscreenEnabled && (+ <Button+ size="icon"+ variant="ghost"+ className="h-9 w-9"+ onClick={handleFullscreen}+ aria-label={localize(+ isFullscreen ? 'com_ui_exit_full_screen' : 'com_ui_enter_full_screen',+ )}+ >+ {isFullscreen ? (+ <Minimize2 size={16} aria-hidden="true" />+ ) : (+ <Maximize2 size={16} aria-hidden="true" />+ )}+ </Button>+ )}{displayedTab !== 'preview' && isMutating && (<RefreshCw size={16} className="animate-spin text-text-secondary" />)}@@ -320,6 +370,7 @@ export default function Artifacts() {<ArtifactVersioncurrentIndex={currentIndex}totalVersions={orderedArtifactIds.length}+ portalElement={isFullscreen ? fullscreenPortalRef.current : undefined}onVersionChange={(index) => {const target = orderedArtifactIds[index];if (target) {@@ -328,7 +379,12 @@ export default function Artifacts() {}}/>)}- <CopyButton isCopied={isCopied} iconOnly onClick={handleCopyArtifact} />+ <CopyButton+ isCopied={isCopied}+ iconOnly+ portalElement={isFullscreen ? fullscreenPortalRef.current : undefined}+ onClick={handleCopyArtifact}+ /><DownloadArtifact artifact={currentArtifact} /><Buttonsize="icon"@@ -382,6 +438,11 @@ export default function Artifacts() {</div>)}</div>+ <div+ ref={fullscreenPortalRef}+ className="z-[101]"+ data-testid="artifact-fullscreen-portal"+ /></div></Tabs.Root>);diff --git a/client/src/components/Artifacts/__tests__/Artifacts.test.tsx b/client/src/components/Artifacts/__tests__/Artifacts.test.tsxnew file mode 100644index 0000000000..999fc93b47--- /dev/null+++ b/client/src/components/Artifacts/__tests__/Artifacts.test.tsx@@ -0,0 +1,292 @@+import React from 'react';+import { RecoilRoot, useSetRecoilState } from 'recoil';+import type { MutableSnapshot } from 'recoil';+import type { Artifact } from '~/common';+import { act, fireEvent, render, screen } from 'test/layout-test-utils';+import { ArtifactsProvider, EditorProvider } from '~/Providers';+import Artifacts from '../Artifacts';+import store from '~/store';++const mockRequestFullscreen = jest.fn<Promise<void>, []>();+const mockExitFullscreen = jest.fn<Promise<void>, []>();+const clearArtifactsLabel = 'Clear artifacts';+const restoreArtifactsLabel = 'Restore artifacts';++const primaryArtifact: Artifact = {+ id: 'artifact-1',+ type: 'text/html',+ title: 'Preview',+ lastUpdateTime: 0,+};++const secondaryArtifact: Artifact = {+ ...primaryArtifact,+ id: 'artifact-2',+ title: 'Preview v2',+ lastUpdateTime: 1,+};++type BrowserPropertyDescriptors = {+ fullscreenElement?: PropertyDescriptor;+ fullscreenEnabled?: PropertyDescriptor;+ exitFullscreen?: PropertyDescriptor;+ requestFullscreen?: PropertyDescriptor;+ matchMedia?: PropertyDescriptor;+};++let originalDescriptors: BrowserPropertyDescriptors;++const restoreProperty = (+ target: object,+ property: PropertyKey,+ descriptor: PropertyDescriptor | undefined,+) => {+ if (descriptor) {+ Object.defineProperty(target, property, descriptor);+ return;+ }+ Reflect.deleteProperty(target, property);+};++const setFullscreenElement = (element: Element | null) => {+ Object.defineProperty(document, 'fullscreenElement', {+ configurable: true,+ value: element,+ });+};++const setMobileViewport = (isMobile: boolean) => {+ window.matchMedia = jest.fn().mockImplementation((query: string) => ({+ matches: isMobile && query.includes('max-width'),+ media: query,+ onchange: null,+ addListener: jest.fn(),+ removeListener: jest.fn(),+ addEventListener: jest.fn(),+ removeEventListener: jest.fn(),+ dispatchEvent: jest.fn(),+ }));+};++const initializeArtifacts =+ (artifacts: Artifact[]) =>+ ({ set }: MutableSnapshot) => {+ set(+ store.artifactsState,+ Object.fromEntries(artifacts.map((artifact) => [artifact.id, artifact])),+ );+ set(store.currentArtifactId, artifacts[0]?.id ?? null);+ set(store.queriesEnabled, false);+ };++function ArtifactStateControls() {+ const setArtifacts = useSetRecoilState(store.artifactsState);++ return (+ <>+ <button type="button" onClick={() => setArtifacts(null)}>+ {clearArtifactsLabel}+ </button>+ <button type="button" onClick={() => setArtifacts({ [primaryArtifact.id]: primaryArtifact })}>+ {restoreArtifactsLabel}+ </button>+ </>+ );+}++const renderArtifacts = async ({+ artifacts = [primaryArtifact],+ includeStateControls = false,+}: {+ artifacts?: Artifact[];+ includeStateControls?: boolean;+} = {}) => {+ render(+ <RecoilRoot initializeState={initializeArtifacts(artifacts)}>+ <EditorProvider>+ <ArtifactsProvider+ value={{+ isSubmitting: false,+ latestMessageId: null,+ latestMessageText: '',+ conversationId: 'conversation-1',+ }}+ >+ {includeStateControls && <ArtifactStateControls />}+ <Artifacts />+ </ArtifactsProvider>+ </EditorProvider>+ </RecoilRoot>,+ );++ await screen.findByRole('button', { name: 'Refresh' });+};++describe('Artifacts fullscreen preview', () => {+ beforeEach(() => {+ originalDescriptors = {+ fullscreenElement: Object.getOwnPropertyDescriptor(document, 'fullscreenElement'),+ fullscreenEnabled: Object.getOwnPropertyDescriptor(document, 'fullscreenEnabled'),+ exitFullscreen: Object.getOwnPropertyDescriptor(document, 'exitFullscreen'),+ requestFullscreen: Object.getOwnPropertyDescriptor(+ HTMLElement.prototype,+ 'requestFullscreen',+ ),+ matchMedia: Object.getOwnPropertyDescriptor(window, 'matchMedia'),+ };++ mockRequestFullscreen.mockReset();+ mockExitFullscreen.mockReset();+ setMobileViewport(false);+ setFullscreenElement(null);+ Object.defineProperty(document, 'fullscreenEnabled', {+ configurable: true,+ value: true,+ });+ Object.defineProperty(HTMLElement.prototype, 'requestFullscreen', {+ configurable: true,+ value: mockRequestFullscreen,+ });+ Object.defineProperty(document, 'exitFullscreen', {+ configurable: true,+ value: mockExitFullscreen,+ });+ mockRequestFullscreen.mockImplementation(function (this: HTMLElement) {+ setFullscreenElement(this);+ document.dispatchEvent(new Event('fullscreenchange'));+ return Promise.resolve();+ });+ mockExitFullscreen.mockImplementation(() => {+ setFullscreenElement(null);+ document.dispatchEvent(new Event('fullscreenchange'));+ return Promise.resolve();+ });+ });++ afterEach(() => {+ restoreProperty(document, 'fullscreenElement', originalDescriptors.fullscreenElement);+ restoreProperty(document, 'fullscreenEnabled', originalDescriptors.fullscreenEnabled);+ restoreProperty(document, 'exitFullscreen', originalDescriptors.exitFullscreen);+ restoreProperty(+ HTMLElement.prototype,+ 'requestFullscreen',+ originalDescriptors.requestFullscreen,+ );+ restoreProperty(window, 'matchMedia', originalDescriptors.matchMedia);+ });++ it('enters and exits fullscreen from the preview header', async () => {+ await renderArtifacts();++ await act(async () => {+ fireEvent.click(screen.getByRole('button', { name: 'Enter full screen' }));+ });++ expect(mockRequestFullscreen).toHaveBeenCalledTimes(1);+ expect(screen.getByRole('button', { name: 'Exit full screen' })).toBeInTheDocument();++ await act(async () => {+ fireEvent.click(screen.getByRole('button', { name: 'Exit full screen' }));+ });++ expect(mockExitFullscreen).toHaveBeenCalledTimes(1);+ expect(screen.getByRole('button', { name: 'Enter full screen' })).toBeInTheDocument();+ });++ it('ignores fullscreen changes while the artifact container is not rendered', async () => {+ await renderArtifacts({ includeStateControls: true });++ fireEvent.click(screen.getByRole('button', { name: clearArtifactsLabel }));+ expect(screen.queryByRole('button', { name: 'Refresh' })).not.toBeInTheDocument();++ act(() => {+ setFullscreenElement(null);+ document.dispatchEvent(new Event('fullscreenchange'));+ });++ fireEvent.click(screen.getByRole('button', { name: restoreArtifactsLabel }));++ expect(await screen.findByRole('button', { name: 'Enter full screen' })).toBeInTheDocument();+ expect(screen.queryByRole('button', { name: 'Exit full screen' })).not.toBeInTheDocument();+ });++ it('expands the mobile artifact panel to fill the fullscreen container', async () => {+ setMobileViewport(true);+ await renderArtifacts();++ const closeButton = screen.getByRole('button', { name: 'Close' });+ const panel = closeButton.parentElement?.parentElement?.parentElement;++ expect(panel).toHaveStyle({ height: '90vh' });++ await act(async () => {+ fireEvent.click(screen.getByRole('button', { name: 'Enter full screen' }));+ });++ expect(panel).toHaveStyle({ height: '100%' });+ expect(panel).toHaveClass('inset-0', 'rounded-none');++ await act(async () => {+ fireEvent.click(screen.getByRole('button', { name: 'Exit full screen' }));+ });++ expect(panel).toHaveStyle({ height: '90vh' });+ expect(panel).toHaveClass('inset-x-0', 'bottom-0', 'rounded-t-[20px]');+ });++ it('keeps the mobile version menu above the fullscreen panel', async () => {+ setMobileViewport(true);+ await renderArtifacts({ artifacts: [primaryArtifact, secondaryArtifact] });++ const closeButton = screen.getByRole('button', { name: 'Close' });+ const panel = closeButton.parentElement?.parentElement?.parentElement;++ await act(async () => {+ fireEvent.click(screen.getByRole('button', { name: 'Enter full screen' }));+ });++ fireEvent.click(screen.getByRole('button', { name: 'Change Version' }));+ const versionMenu = await screen.findByRole('menu');+ const fullscreenPortal = screen.getByTestId('artifact-fullscreen-portal');++ expect(panel).toHaveClass('z-[100]');+ expect(fullscreenPortal).toHaveClass('z-[101]');+ expect(document.fullscreenElement).toContainElement(versionMenu);+ expect(fullscreenPortal).toContainElement(versionMenu);+ });++ it.each([+ { label: 'Change Version', artifacts: [primaryArtifact, secondaryArtifact], screenX: 1 },+ { label: 'Copy', artifacts: [primaryArtifact], screenX: 2 },+ ])(+ 'keeps the $label tooltip inside the fullscreen container',+ async ({ label, artifacts, screenX }) => {+ await renderArtifacts({ artifacts });++ await act(async () => {+ fireEvent.click(screen.getByRole('button', { name: 'Enter full screen' }));+ });++ const control = screen.getByRole('button', { name: label });+ fireEvent.mouseEnter(control);+ fireEvent.mouseMove(control, { screenX });+ const tooltip = await screen.findByRole('tooltip');+ const fullscreenPortal = screen.getByTestId('artifact-fullscreen-portal');++ expect(tooltip).toHaveTextContent(label);+ expect(document.fullscreenElement).toContainElement(tooltip);+ expect(fullscreenPortal).toContainElement(tooltip);+ },+ );++ it('hides the fullscreen control when the browser does not support it', async () => {+ Object.defineProperty(document, 'fullscreenEnabled', {+ configurable: true,+ value: false,+ });++ await renderArtifacts();++ expect(screen.queryByRole('button', { name: 'Enter full screen' })).not.toBeInTheDocument();+ });+});diff --git a/client/src/components/Messages/Content/CopyButton.tsx b/client/src/components/Messages/Content/CopyButton.tsxindex dedaa9c79e..96be2d0be3 100644--- a/client/src/components/Messages/Content/CopyButton.tsx+++ b/client/src/components/Messages/Content/CopyButton.tsx@@ -12,10 +12,14 @@ interface CopyButtonProps {className?: string;label?: string;copiedLabel?: string;+ portalElement?: HTMLElement | null;}const CopyButton = React.forwardRef<HTMLButtonElement, CopyButtonProps>(- ({ isCopied, iconOnly = false, onClick, tabIndex, className, label, copiedLabel }, ref) => {+ (+ { isCopied, iconOnly = false, onClick, tabIndex, className, label, copiedLabel, portalElement },+ ref,+ ) => {const localize = useLocalize();const defaultLabel = label ?? localize('com_ui_copy');const defaultCopiedLabel = copiedLabel ?? localize('com_ui_copied');@@ -77,7 +81,9 @@ const CopyButton = React.forwardRef<HTMLButtonElement, CopyButtonProps>();if (iconOnly) {- return <TooltipAnchor description={currentLabel} render={button} />;+ return (+ <TooltipAnchor description={currentLabel} portalElement={portalElement} render={button} />+ );}return button;diff --git a/client/src/locales/en/translation.json b/client/src/locales/en/translation.jsonindex 61986241e9..0f64bf1776 100644--- a/client/src/locales/en/translation.json+++ b/client/src/locales/en/translation.json@@ -1172,6 +1172,7 @@"com_ui_enter": "Enter","com_ui_enter_api_key": "Enter API Key","com_ui_enter_description": "Enter description (optional)",+ "com_ui_enter_full_screen": "Enter full screen","com_ui_enter_key": "Enter key","com_ui_enter_name": "Enter name","com_ui_enter_openapi_schema": "Enter your OpenAPI schema here",@@ -1187,6 +1188,7 @@"com_ui_estimated": "Estimated from message history","com_ui_everyone_permission_level": "Everyone's permission level","com_ui_examples": "Examples",+ "com_ui_exit_full_screen": "Exit full screen","com_ui_expand": "Expand","com_ui_expand_chat": "Expand Chat","com_ui_expand_editor": "Expand editor",diff --git a/packages/client/src/components/DropdownPopup.tsx b/packages/client/src/components/DropdownPopup.tsxindex 5c3f5969ee..a1319fcfa5 100644--- a/packages/client/src/components/DropdownPopup.tsx+++ b/packages/client/src/components/DropdownPopup.tsx@@ -19,6 +19,7 @@ interface DropdownProps {gutter?: number;modal?: boolean;portal?: boolean;+ portalElement?: HTMLElement | null;preserveTabOrder?: boolean;focusLoop?: boolean;menuId: string;diff --git a/packages/client/src/components/Tooltip.tsx b/packages/client/src/components/Tooltip.tsxindex 7b98fb8c1c..1193e4a07e 100644--- a/packages/client/src/components/Tooltip.tsx+++ b/packages/client/src/components/Tooltip.tsx@@ -18,6 +18,7 @@ interface TooltipAnchorProps extends Ariakit.TooltipAnchorProps {className?: string;description: string;enableHTML?: boolean;+ portalElement?: Ariakit.TooltipProps['portalElement'];side?: 'top' | 'bottom' | 'left' | 'right';}@@ -29,10 +30,12 @@ const TooltipPopup = memo(function TooltipPopup({store,description,enableHTML,+ portalElement,}: {store: Ariakit.TooltipStore;description: string;enableHTML: boolean;+ portalElement?: Ariakit.TooltipProps['portalElement'];}) {const mounted = Ariakit.useStoreState(store, (state) => state.mounted);const placement = Ariakit.useStoreState(store, (state) => state.placement);@@ -92,6 +95,7 @@ const TooltipPopup = memo(function TooltipPopup({<Ariakit.Tooltipgutter={4}alwaysVisible+ portalElement={portalElement}className="tooltip"render={<motion.div@@ -121,7 +125,17 @@ const TooltipPopup = memo(function TooltipPopup({export const TooltipAnchor: ForwardRefExoticComponent<Omit<TooltipAnchorProps, 'ref'> & RefAttributes<HTMLDivElement>> = forwardRef<HTMLDivElement, TooltipAnchorProps>(function TooltipAnchor(- { description, side = 'top', className, role, enableHTML = false, onKeyDown, tabIndex, ...props },+ {+ description,+ side = 'top',+ className,+ role,+ enableHTML = false,+ portalElement,+ onKeyDown,+ tabIndex,+ ...props+ },ref,) {const tooltip = Ariakit.useTooltipStore({ placement: side });@@ -165,7 +179,12 @@ export const TooltipAnchor: ForwardRefExoticComponent<onKeyDown={handleKeyDown}className={cn('cursor-pointer', className)}/>- <TooltipPopup store={tooltip} description={description} enableHTML={enableHTML} />+ <TooltipPopup+ store={tooltip}+ description={description}+ enableHTML={enableHTML}+ portalElement={portalElement}+ /></Ariakit.TooltipProvider>);});