@elementor/editor-global-classes 4.1.0-825 → 4.1.0-826

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elementor/editor-global-classes",
-  "version": "4.1.0-825",
+  "version": "4.1.0-826",
   "private": false,
   "author": "Elementor Team",
   "homepage": "https://elementor.com/",
@@ -39,29 +39,29 @@
     "dev": "tsup --config=../../tsup.dev.ts"
   },
   "dependencies": {
-    "@elementor/editor": "4.1.0-825",
-    "@elementor/editor-current-user": "4.1.0-825",
-    "@elementor/editor-documents": "4.1.0-825",
-    "@elementor/editor-editing-panel": "4.1.0-825",
-    "@elementor/editor-mcp": "4.1.0-825",
-    "@elementor/editor-panels": "4.1.0-825",
-    "@elementor/editor-props": "4.1.0-825",
-    "@elementor/editor-variables": "4.1.0-825",
-    "@elementor/editor-styles": "4.1.0-825",
-    "@elementor/editor-canvas": "4.1.0-825",
-    "@elementor/editor-styles-repository": "4.1.0-825",
-    "@elementor/editor-ui": "4.1.0-825",
-    "@elementor/editor-v1-adapters": "4.1.0-825",
-    "@elementor/http-client": "4.1.0-825",
+    "@elementor/editor": "4.1.0-826",
+    "@elementor/editor-current-user": "4.1.0-826",
+    "@elementor/editor-documents": "4.1.0-826",
+    "@elementor/editor-editing-panel": "4.1.0-826",
+    "@elementor/editor-mcp": "4.1.0-826",
+    "@elementor/editor-panels": "4.1.0-826",
+    "@elementor/editor-props": "4.1.0-826",
+    "@elementor/editor-variables": "4.1.0-826",
+    "@elementor/editor-styles": "4.1.0-826",
+    "@elementor/editor-canvas": "4.1.0-826",
+    "@elementor/editor-styles-repository": "4.1.0-826",
+    "@elementor/editor-ui": "4.1.0-826",
+    "@elementor/editor-v1-adapters": "4.1.0-826",
+    "@elementor/http-client": "4.1.0-826",
     "@elementor/icons": "^1.68.0",
-    "@elementor/query": "4.1.0-825",
-    "@elementor/schema": "4.1.0-825",
-    "@elementor/store": "4.1.0-825",
+    "@elementor/query": "4.1.0-826",
+    "@elementor/schema": "4.1.0-826",
+    "@elementor/store": "4.1.0-826",
     "@elementor/ui": "1.37.5",
-    "@elementor/utils": "4.1.0-825",
+    "@elementor/utils": "4.1.0-826",
     "@tanstack/react-virtual": "^3.13.24",
     "@wordpress/i18n": "^5.13.0",
-    "@elementor/events": "4.1.0-825"
+    "@elementor/events": "4.1.0-826"
   },
   "peerDependencies": {
     "react": "^18.3.1",

package/src/components/class-manager/class-manager-button.tsx

@@ -5,6 +5,7 @@ import {
 } from '@elementor/editor-documents';
 import { useUserStylesCapability } from '@elementor/editor-styles-repository';
 import { SaveChangesDialog, useDialog } from '@elementor/editor-ui';
+import { isExperimentActive } from '@elementor/editor-v1-adapters';
 import { IconButton, Tooltip } from '@elementor/ui';
 import { __ } from '@wordpress/i18n';
 
@@ -36,18 +37,27 @@ export const ClassManagerButton = () => {
 		return null;
 	}
 
+	const toggleClassesManagerPanel = () => {
+		if ( isExperimentActive( 'e_editor_design_system_panel' ) ) {
+			window.dispatchEvent(
+				new CustomEvent( 'elementor/toggle-design-system', {
+					detail: { tab: 'classes' as const },
+				} )
+			);
+		} else {
+			openPanel();
+		}
+	};
+
 	const handleOpenPanel = () => {
 		if ( document?.isDirty ) {
 			openSaveChangesDialog();
 			return;
 		}
 
-		openPanel();
+		toggleClassesManagerPanel();
+
 		trackGlobalClassesButton();
-		trackGlobalClasses( {
-			event: 'classManagerOpened',
-			source: 'style-panel',
-		} );
 		prefetchClassesUsage();
 	};
 
@@ -80,7 +90,7 @@ export const ClassManagerButton = () => {
 								action: async () => {
 									await saveDocument();
 									closeSaveChangesDialog();
-									openPanel();
+									toggleClassesManagerPanel();
 									trackGlobalClassesButton();
 									prefetchClassesUsage();
 								},

package/src/components/class-manager/class-manager-panel.tsx

@@ -1,5 +1,5 @@
 import * as React from 'react';
-import { useCallback, useEffect, useState } from 'react';
+import { useCallback, useEffect, useMemo, useState } from 'react';
 import { useSuppressedMessage } from '@elementor/editor-current-user';
 import { reloadCurrentDocument, setDocumentModifiedStatus } from '@elementor/editor-documents';
 import {
@@ -56,10 +56,25 @@ type StopSyncConfirmationDialogProps = {
 
 const id = 'global-classes-manager';
 
-// We need to disable the app-bar buttons, and the elements overlays when opening the classes manager panel.
-// The buttons and overlays are enabled only in edit mode, so we're creating a custom new edit mode that
-// will force them to be disabled. We can't use the `preview` edit mode in this case since it'll force
-// the panel to be closed.
+export type ClassManagerPanelEmbeddedProps = {
+	onRequestClose: () => void | Promise< void >;
+	onExposeCloseAttempt?: ( attemptClose: ( () => void ) | null ) => void;
+};
+
+export function ClassManagerPanelEmbedded( { onRequestClose, onExposeCloseAttempt }: ClassManagerPanelEmbeddedProps ) {
+	return (
+		<ClassManagerPanelRoot
+			embedded
+			onRequestClose={ onRequestClose }
+			onExposeCloseAttempt={ onExposeCloseAttempt }
+		/>
+	);
+}
+
+export function ClassManagerPanel() {
+	return <ClassManagerPanelRoot />;
+}
+
 export const { panel, usePanelActions } = createPanel( {
 	id,
 	component: ClassManagerPanel,
@@ -77,9 +92,24 @@ export const { panel, usePanelActions } = createPanel( {
 	isOpenPreviousElement: true,
 } );
 
-export function ClassManagerPanel() {
+type ClassManagerPanelRootProps = {
+	embedded?: boolean;
+	onRequestClose?: () => void | Promise< void >;
+	onExposeCloseAttempt?: ( attemptClose: ( () => void ) | null ) => void;
+};
+
+function ClassManagerPanelRoot( {
+	embedded = false,
+	onRequestClose,
+	onExposeCloseAttempt,
+}: ClassManagerPanelRootProps = {} ) {
 	const isDirty = useDirtyState();
-	const { close: closePanel } = usePanelActions();
+	const { close: closeStandalonePanel } = usePanelActions();
+	const closePanel = useMemo(
+		() => ( embedded ? onRequestClose ?? ( async () => {} ) : closeStandalonePanel ),
+		[ embedded, onRequestClose, closeStandalonePanel ]
+	);
+
 	const { open: openSaveChangesDialog, close: closeSaveChangesDialog, isOpen: isSaveChangesDialogOpen } = useDialog();
 	const [ stopSyncConfirmation, setStopSyncConfirmation ] = useState< string | null >( null );
 	const [ startSyncConfirmation, setStartSyncConfirmation ] = useState< string | null >( null );
@@ -93,6 +123,37 @@ export function ClassManagerPanel() {
 		closeSaveChangesDialog();
 	};
 
+	const handleClosePanel = useCallback( () => {
+		if ( isDirty ) {
+			openSaveChangesDialog();
+			return;
+		}
+
+		void closePanel();
+	}, [ isDirty, openSaveChangesDialog, closePanel ] );
+
+	useEffect( () => {
+		if ( ! embedded || ! onExposeCloseAttempt ) {
+			return;
+		}
+
+		onExposeCloseAttempt( () => handleClosePanel() );
+
+		return () => onExposeCloseAttempt( null );
+	}, [ embedded, onExposeCloseAttempt, handleClosePanel ] );
+
+	useEffect( () => {
+		if ( ! embedded ) {
+			return;
+		}
+
+		blockPanelInteractions();
+
+		return () => {
+			unblockPanelInteractions();
+		};
+	}, [ embedded ] );
+
 	const handleStopSync = useCallback( ( classId: string ) => {
 		dispatch(
 			slice.actions.update( {
@@ -132,85 +193,56 @@ export function ClassManagerPanel() {
 
 	usePreventUnload();
 
-	return (
-		<ThemeProvider>
-			<ErrorBoundary fallback={ <ErrorBoundaryFallback /> }>
-				<Panel>
-					<SearchAndFilterProvider>
-						<PanelHeader>
-							<Stack p={ 1 } pl={ 2 } width="100%" direction="row" alignItems="center">
-								<Stack width="100%" direction="row" gap={ 1 }>
-									<PanelHeaderTitle sx={ { display: 'flex', alignItems: 'center', gap: 0.5 } }>
-										<FlippedColorSwatchIcon fontSize="inherit" />
-										{ __( 'Class Manager', 'elementor' ) }
-									</PanelHeaderTitle>
-									<TotalCssClassCounter />
-								</Stack>
-								<CloseButton
-									sx={ { marginLeft: 'auto' } }
-									disabled={ isPublishing }
-									onClose={ () => {
-										if ( isDirty ) {
-											openSaveChangesDialog();
-											return;
-										}
-
-										closePanel();
-									} }
-								/>
-							</Stack>
-						</PanelHeader>
-						<PanelBody
-							sx={ {
-								display: 'flex',
-								flexDirection: 'column',
-								height: '100%',
-							} }
-						>
-							<Box px={ 2 } pb={ 1 }>
-								<Stack direction="row" justifyContent="spaceBetween" gap={ 0.5 } sx={ { pb: 0.5 } }>
-									<Box sx={ { flexGrow: 1 } }>
-										<ClassManagerSearch />
-									</Box>
-									<CssClassFilter />
-								</Stack>
-								<ActiveFilters />
-							</Box>
-							<Divider />
-							<Box
-								ref={ setScrollElement }
-								px={ 2 }
-								sx={ {
-									flexGrow: 1,
-									overflowY: 'auto',
-								} }
-							>
-								<GlobalClassesList
-									disabled={ isPublishing }
-									scrollElement={ scrollElement }
-									onStopSyncRequest={ handleStopSyncRequest }
-									onStartSyncRequest={ ( classId ) => setStartSyncConfirmation( classId ) }
-								/>
-							</Box>
-						</PanelBody>
-
-						<PanelFooter>
-							<Button
-								fullWidth
-								size="small"
-								color="global"
-								variant="contained"
-								onClick={ publish }
-								disabled={ ! isDirty }
-								loading={ isPublishing }
-							>
-								{ __( 'Save changes', 'elementor' ) }
-							</Button>
-						</PanelFooter>
-					</SearchAndFilterProvider>
-				</Panel>
-			</ErrorBoundary>
-			<ClassManagerIntroduction />
+	const searchFiltersBlock = (
+		<Box px={ 2 } pb={ 1 }>
+			<Stack direction="row" alignItems="center" justifyContent="space-between" gap={ 0.5 } sx={ { pb: 0.5 } }>
+				<Box sx={ embedded ? { flexGrow: 1, minWidth: 0 } : { flexGrow: 1 } }>
+					<ClassManagerSearch />
+				</Box>
+				<CssClassFilter />
+				{ embedded && <TotalCssClassCounter /> }
+			</Stack>
+			<ActiveFilters />
+		</Box>
+	);
+
+	const listArea = (
+		<Box
+			ref={ setScrollElement }
+			px={ 2 }
+			sx={ {
+				flexGrow: 1,
+				overflowY: 'auto',
+				...( embedded ? { minHeight: 0 } : {} ),
+			} }
+		>
+			<GlobalClassesList
+				disabled={ isPublishing }
+				scrollElement={ scrollElement }
+				onStopSyncRequest={ handleStopSyncRequest }
+				onStartSyncRequest={ ( classId ) => setStartSyncConfirmation( classId ) }
+			/>
+		</Box>
+	);
+
+	const saveFooter = (
+		<PanelFooter>
+			<Button
+				fullWidth
+				size="small"
+				color="global"
+				variant="contained"
+				onClick={ publish }
+				disabled={ ! isDirty }
+				loading={ isPublishing }
+			>
+				{ __( 'Save changes', 'elementor' ) }
+			</Button>
+		</PanelFooter>
+	);
+
+	const dialogs = (
+		<>
 			{ startSyncConfirmation && (
 				<StartSyncToV3Modal
 					externalOpen
@@ -254,19 +286,93 @@ export function ClassManagerPanel() {
 								action: async () => {
 									await publish();
 									closeSaveChangesDialog();
-									closePanel();
+									void closePanel();
 								},
 							},
 						} }
 					/>
 				</SaveChangesDialog>
 			) }
-		</ThemeProvider>
+		</>
+	);
+
+	const classManagerLayout = embedded ? (
+		<Stack
+			direction="column"
+			sx={ {
+				height: '100%',
+				width: '100%',
+				flex: 1,
+				minHeight: 0,
+				overflow: 'hidden',
+			} }
+		>
+			{ searchFiltersBlock }
+			<Divider />
+			{ listArea }
+			{ saveFooter }
+		</Stack>
+	) : (
+		<Panel>
+			<PanelHeader>
+				<Stack p={ 1 } pl={ 2 } width="100%" direction="row" alignItems="center">
+					<Stack width="100%" direction="row" gap={ 1 }>
+						<PanelHeaderTitle sx={ { display: 'flex', alignItems: 'center', gap: 0.5 } }>
+							<FlippedColorSwatchIcon fontSize="inherit" />
+							{ __( 'Class Manager', 'elementor' ) }
+						</PanelHeaderTitle>
+						<TotalCssClassCounter />
+					</Stack>
+					<ClassPanelCloseButton
+						disabled={ isPublishing }
+						onClose={ () => {
+							if ( isDirty ) {
+								openSaveChangesDialog();
+								return;
+							}
+
+							void closeStandalonePanel();
+						} }
+					/>
+				</Stack>
+			</PanelHeader>
+			<PanelBody
+				sx={ {
+					display: 'flex',
+					flexDirection: 'column',
+					height: '100%',
+				} }
+			>
+				{ searchFiltersBlock }
+				<Divider />
+				{ listArea }
+			</PanelBody>
+			{ saveFooter }
+		</Panel>
 	);
+
+	const core = (
+		<>
+			<ErrorBoundary fallback={ <ErrorBoundaryFallback /> }>
+				<SearchAndFilterProvider>{ classManagerLayout }</SearchAndFilterProvider>
+			</ErrorBoundary>
+			<ClassManagerIntroduction />
+			{ dialogs }
+		</>
+	);
+
+	return embedded ? core : <ThemeProvider>{ core }</ThemeProvider>;
 }
 
-const CloseButton = ( { onClose, ...props }: IconButtonProps & { onClose: () => void } ) => (
-	<IconButton size="small" color="secondary" onClick={ onClose } aria-label="Close" { ...props }>
+const ClassPanelCloseButton = ( { onClose, sx, ...props }: IconButtonProps & { onClose: () => void } ) => (
+	<IconButton
+		size="small"
+		color="secondary"
+		onClick={ onClose }
+		aria-label="Close"
+		sx={ { marginLeft: 'auto', ...sx } }
+		{ ...props }
+	>
 		<XIcon fontSize="small" />
 	</IconButton>
 );

package/src/index.ts

@@ -1,3 +1,7 @@
+export {
+	ClassManagerPanelEmbedded,
+	type ClassManagerPanelEmbeddedProps,
+} from './components/class-manager/class-manager-panel';
 export { GLOBAL_CLASSES_URI } from './mcp-integration/classes-resource';
 
 export { init } from './init';

package/src/init.ts

@@ -7,6 +7,7 @@ import {
 import { getMCPByDomain } from '@elementor/editor-mcp';
 import { __registerPanel as registerPanel } from '@elementor/editor-panels';
 import { stylesRepository } from '@elementor/editor-styles-repository';
+import { isExperimentActive } from '@elementor/editor-v1-adapters';
 import { __registerSlice as registerSlice } from '@elementor/store';
 
 import { ClassManagerButton } from './components/class-manager/class-manager-button';
@@ -23,7 +24,10 @@ import { SyncWithDocumentSave } from './sync-with-document';
 
 export function init() {
 	registerSlice( slice );
-	registerPanel( panel );
+
+	if ( ! isExperimentActive( 'e_editor_design_system_panel' ) ) {
+		registerPanel( panel );
+	}
 
 	stylesRepository.register( globalClassesStylesProvider );
 
@@ -47,10 +51,12 @@ export function init() {
 		component: PrefetchCssClassUsage,
 	} );
 
-	injectIntoLogic( {
-		id: 'global-classes-open-panel-from-url',
-		component: OpenPanelFromUrl,
-	} );
+	if ( ! isExperimentActive( 'e_editor_design_system_panel' ) ) {
+		injectIntoLogic( {
+			id: 'global-classes-open-panel-from-url',
+			component: OpenPanelFromUrl,
+		} );
+	}
 
 	injectIntoCssClassConvert( {
 		id: 'global-classes-convert-from-local-class',

package/src/sync-with-document.tsx

@@ -1,18 +1,26 @@
 import { useEffect } from 'react';
-import { __privateListenTo as listenTo, v1ReadyEvent } from '@elementor/editor-v1-adapters';
+import { __privateListenTo as listenTo, isExperimentActive, v1ReadyEvent } from '@elementor/editor-v1-adapters';
 
 import { usePanelActions } from './components/class-manager/class-manager-panel';
 import { syncWithDocumentSave } from './sync-with-document-save';
 
 export function SyncWithDocumentSave() {
-	const panelActions = usePanelActions();
+	const { open: openClassPanel } = usePanelActions();
 
 	useEffect( () => {
-		listenTo( v1ReadyEvent(), () => {
-			syncWithDocumentSave( panelActions );
+		const unsubscribe = listenTo( v1ReadyEvent(), () => {
+			const open = isExperimentActive( 'e_editor_design_system_panel' )
+				? () => {
+						window.dispatchEvent( new CustomEvent( 'elementor/open-global-classes-manager' ) );
+				  }
+				: openClassPanel;
+
+			syncWithDocumentSave( { open } );
 		} );
 
-		// eslint-disable-next-line react-hooks/exhaustive-deps
+		return unsubscribe;
+
+		// eslint-disable-next-line react-hooks/exhaustive-deps -- bind once at v1 ready; openClassPanel from createPanel is stable
 	}, [] );
 
 	return null;