@elementor/editor-editing-panel 1.31.0 → 1.32.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elementor/editor-editing-panel",
-  "version": "1.31.0",
+  "version": "1.32.0",
   "private": false,
   "author": "Elementor Team",
   "homepage": "https://elementor.com/",
@@ -40,9 +40,9 @@
   },
   "dependencies": {
     "@elementor/editor": "0.19.1",
-    "@elementor/editor-canvas": "0.19.1",
-    "@elementor/editor-controls": "0.28.0",
-    "@elementor/editor-current-user": "0.3.0",
+    "@elementor/editor-canvas": "0.20.0",
+    "@elementor/editor-controls": "0.28.1",
+    "@elementor/editor-current-user": "0.3.1",
     "@elementor/editor-elements": "0.8.1",
     "@elementor/editor-panels": "0.15.1",
     "@elementor/editor-props": "0.12.0",

package/src/hooks/use-normalized-inheritance-chain-items.tsx

@@ -0,0 +1,68 @@
+import { useEffect, useState } from 'react';
+import { type PropsResolver } from '@elementor/editor-canvas';
+import { type PropKey } from '@elementor/editor-props';
+
+import { type NormalizedItem } from '../styles-inheritance/styles-inheritance-infotip';
+import { type SnapshotPropValue } from '../styles-inheritance/types';
+
+const MAXIMUM_ITEMS = 2;
+
+export const useNormalizedInheritanceChainItems = (
+	inheritanceChain: SnapshotPropValue[],
+	bind: PropKey,
+	resolve: PropsResolver
+) => {
+	const [ items, setItems ] = useState< NormalizedItem[] >( [] );
+
+	useEffect( () => {
+		( async () => {
+			const normalizedItems = await Promise.all(
+				inheritanceChain
+					.filter( ( item ) => item.style?.label )
+					.map( ( item, index ) => normalizeInheritanceItem( item, index, bind, resolve ) )
+			);
+
+			const validItems = normalizedItems.filter( ( item ) => item.value !== '' ).slice( 0, MAXIMUM_ITEMS );
+
+			setItems( validItems );
+		} )();
+	}, [ inheritanceChain, bind, resolve ] );
+
+	return items;
+};
+
+export const normalizeInheritanceItem = async (
+	item: SnapshotPropValue,
+	index: number,
+	bind: PropKey,
+	resolve: PropsResolver
+): Promise< NormalizedItem > => {
+	const state = item.variant?.meta?.state || '';
+	const label = item.style?.label || '';
+	const displayLabel = state ? `${ label }:${ state }` : label;
+
+	return {
+		id: item.style?.id ? item.style?.id + state : index,
+		breakpoint: item.variant?.meta?.breakpoint,
+		displayLabel,
+		value: await getTransformedValue( item, bind, resolve ),
+	};
+};
+
+export const getTransformedValue = async (
+	item: SnapshotPropValue,
+	bind: PropKey,
+	resolve: PropsResolver
+): Promise< string > => {
+	try {
+		const result = await resolve( {
+			props: {
+				[ bind ]: item.value,
+			},
+		} );
+
+		return Object.values( result ).join( ' ' );
+	} catch {
+		return '';
+	}
+};

package/src/styles-inheritance/styles-inheritance-indicator.tsx

@@ -1,13 +1,19 @@
 import * as React from 'react';
+import { useState } from 'react';
 import { useBoundProp } from '@elementor/editor-controls';
 import { ELEMENTS_BASE_STYLES_PROVIDER_KEY, isElementsStylesProvider } from '@elementor/editor-styles-repository';
+import { IconButton, Infotip } from '@elementor/ui';
 import { __ } from '@wordpress/i18n';
 
 import { StyleIndicator } from '../components/style-indicator';
 import { useStyle } from '../contexts/style-context';
 import { useStylesInheritanceField } from '../contexts/styles-inheritance-context';
+import { getExperimentsConfig } from '../sync/get-experiments-config';
+import { StyleIndicatorInfotip } from './styles-inheritance-infotip';
 
 export const StylesInheritanceIndicator = () => {
+	const [ open, setOpen ] = useState( false );
+
 	const { value, path } = useBoundProp();
 	const { id: currentStyleId, provider: currentStyleProvider, meta: currentStyleMeta } = useStyle();
 
@@ -27,27 +33,67 @@ export const StylesInheritanceIndicator = () => {
 
 	const { breakpoint, state } = variant.meta;
 
-	if (
-		style.id === currentStyleId &&
-		breakpoint === currentStyleMeta.breakpoint &&
-		state === currentStyleMeta.state
-	) {
-		return (
-			<StyleIndicator
-				aria-label={ __( 'This is the final value', 'elementor' ) }
-				variant={ isElementsStylesProvider( currentStyleProvider?.getKey() ) ? 'local' : 'global' }
-			/>
-		);
+	const isFinalValue: boolean =
+		style.id === currentStyleId && breakpoint === currentStyleMeta.breakpoint && state === currentStyleMeta.state;
+
+	const hasValue: boolean = value !== null && value !== undefined;
+
+	const label: string = getLabel( { isFinalValue, hasValue } );
+	const variantType = getVariant( { isFinalValue, hasValue, currentStyleProvider } );
+
+	const { e_indications_popover: eIndicationsPopover } = getExperimentsConfig();
+
+	if ( ! eIndicationsPopover ) {
+		return <StyleIndicator variant={ variantType } aria-label={ label } />;
+	}
+
+	const toggleOpen = () => setOpen( ( prev ) => ! prev );
+
+	return (
+		<Infotip
+			placement="top"
+			content={ <StyleIndicatorInfotip inheritanceChain={ inheritanceChain } bind={ bind } /> }
+			open={ open }
+			onClose={ () => setOpen( false ) }
+			trigger="manual"
+		>
+			<IconButton onClick={ toggleOpen } aria-label={ label }>
+				<StyleIndicator variant={ variantType } />
+			</IconButton>
+		</Infotip>
+	);
+};
+
+const getLabel = ( { isFinalValue, hasValue }: { isFinalValue: boolean; hasValue: boolean } ) => {
+	if ( isFinalValue ) {
+		return __( 'This is the final value', 'elementor' );
+	}
+
+	if ( hasValue ) {
+		return __( 'This value is overridden by another style', 'elementor' );
+	}
+
+	return __( 'This has value from another style', 'elementor' );
+};
+
+const getVariant = ( {
+	isFinalValue,
+	hasValue,
+	currentStyleProvider,
+}: {
+	isFinalValue: boolean;
+	hasValue: boolean;
+	currentStyleProvider: object | null;
+} ): 'local' | 'global' | 'overridden' | undefined => {
+	if ( isFinalValue ) {
+		return isElementsStylesProvider( ( currentStyleProvider as { getKey: () => string } )?.getKey?.() )
+			? 'local'
+			: 'global';
 	}
 
-	if ( value !== null && value !== undefined ) {
-		return (
-			<StyleIndicator
-				aria-label={ __( 'This value is overridden by another style', 'elementor' ) }
-				variant="overridden"
-			/>
-		);
+	if ( hasValue ) {
+		return 'overridden';
 	}
 
-	return <StyleIndicator aria-label={ __( 'This has value from another style', 'elementor' ) } />;
+	return undefined;
 };

package/src/styles-inheritance/styles-inheritance-infotip.tsx

@@ -0,0 +1,50 @@
+import * as React from 'react';
+import { useMemo } from 'react';
+import { createPropsResolver, type PropsResolver, styleTransformersRegistry } from '@elementor/editor-canvas';
+import { type PropKey } from '@elementor/editor-props';
+import { getStylesSchema, type StyleDefinitionVariant } from '@elementor/editor-styles';
+import { Card, CardContent, List, ListItem, ListItemText } from '@elementor/ui';
+
+import { useNormalizedInheritanceChainItems } from '../hooks/use-normalized-inheritance-chain-items';
+import { type SnapshotPropValue } from './types';
+
+type StyleIndicatorInfotipProps = {
+	inheritanceChain: SnapshotPropValue[];
+	bind: PropKey;
+};
+
+export type NormalizedItem = {
+	id: string | number;
+	breakpoint?: StyleDefinitionVariant[ 'meta' ][ 'breakpoint' ];
+	displayLabel: string;
+	value: string;
+};
+
+export const StyleIndicatorInfotip = ( { inheritanceChain, bind }: StyleIndicatorInfotipProps ) => {
+	const resolve = useMemo< PropsResolver >( () => {
+		const stylesSchema = getStylesSchema();
+
+		return createPropsResolver( {
+			transformers: styleTransformersRegistry,
+			schema: { [ bind ]: stylesSchema[ bind ] },
+		} );
+	}, [ bind ] );
+
+	const items = useNormalizedInheritanceChainItems( inheritanceChain, bind, resolve );
+
+	return (
+		<Card elevation={ 0 } sx={ { maxWidth: 320 } }>
+			<CardContent sx={ { p: 1.5, pb: 2.5 } }>
+				<List>
+					{ items.map( ( item ) => (
+						<ListItem key={ item.id }>
+							<ListItemText
+								primary={ `${ item.breakpoint } | ${ item.displayLabel }. ${ item.value }` }
+							/>
+						</ListItem>
+					) ) }
+				</List>
+			</CardContent>
+		</Card>
+	);
+};

package/src/sync/get-experiments-config.ts

@@ -0,0 +1,7 @@
+import { type ExtendedWindow } from './types';
+
+export const getExperimentsConfig = () => {
+	const extendedWindow = window as unknown as ExtendedWindow;
+
+	return extendedWindow.elementorCommon?.config?.experimentalFeatures ?? {};
+};

package/src/sync/types.ts

@@ -31,6 +31,13 @@ export type ExtendedWindow = Window & {
 			};
 		};
 	};
+	elementorCommon?: {
+		config?: {
+			experimentalFeatures?: {
+				e_indications_popover?: boolean;
+			};
+		};
+	};
 	elementorFrontend?: {
 		config?: {
 			is_rtl?: boolean;