@elementor/editor-controls 4.4.0-1145 → 4.4.0-1147

package/dist/index.d.mts

@@ -359,10 +359,9 @@ declare const AspectRatioControl: ControlComponent$1<({ label }: {
 }) => React$1.JSX.Element>;
 
 type SvgMediaControlProps = {
-    showIconLibrary?: boolean;
     label?: string;
 };
-declare const SvgMediaControl: ControlComponent$1<({ showIconLibrary, label }: SvgMediaControlProps) => React$1.JSX.Element>;
+declare const SvgMediaControl: ControlComponent$1<({ label }: SvgMediaControlProps) => React$1.JSX.Element>;
 
 type VideoMediaControlProps = {
     label?: string;
@@ -463,6 +462,8 @@ type FontAwesome7Icon = FontAwesome7IconDefinition & {
     value: string;
     glyphClass?: string;
     svgMarkup?: string;
+    /** Markup is resolved on demand by the icon library providers, once the icon is displayed. */
+    lazySvg?: boolean;
 };
 
 type IconLibraryProviderState = {
@@ -473,6 +474,11 @@ type IconLibraryProvider = {
     id: string;
     useIcons: (enabled: boolean) => IconLibraryProviderState;
     resolveSvg?: (library: string, iconValue: string, signal?: AbortSignal) => Promise<string | null>;
+    /**
+     * Resolves markup for picker tiles and the control preview. Falls back to `resolveSvg` when omitted.
+     * Use it when `resolveSvg` has side effects that should only happen for icons that are actually rendered.
+     */
+    resolvePreviewSvg?: (library: string, iconValue: string, signal?: AbortSignal) => Promise<string | null>;
 };
 /**
  * Register before the icon picker mounts. Each picker instance snapshots the providers on mount,
@@ -482,6 +488,7 @@ type IconLibraryProvider = {
 declare function registerIconLibraryProvider(provider: IconLibraryProvider): void;
 declare function unregisterIconLibraryProvider(id: string): void;
 declare function resolveProviderIconSvg(library: string, iconValue: string, signal?: AbortSignal): Promise<string | null>;
+declare function resolveProviderIconPreviewSvg(library: string, iconValue: string, signal?: AbortSignal): Promise<string | null>;
 
 declare function enqueueIconFonts(library: string): void;
 
@@ -966,4 +973,4 @@ declare function useTypingBuffer(options?: UseTypingBufferOptions): {
     startsWith: (haystack: string, needle: string) => boolean;
 };
 
-export { type AdornmentComponent, type AngleUnit, AspectRatioControl, AttachmentTypeControl, AttributesControl, BackgroundControl, BoxShadowRepeaterControl, ChipsControl, ClearIconButton, ColorControl, ControlActions, type ControlActionsItems, ControlActionsProvider, ControlAdornments, ControlAdornmentsProvider, type ControlComponent$1 as ControlComponent, ControlFormLabel, type ControlReplacement, ControlReplacementsProvider, ControlToggleButtonGroup, DateRangeControl, DateTimeControl, DisplayConditionsControl, EmailFormActionControl, type EqualUnequalItems, EqualUnequalSizesControl, type ExtendedOption, FilterRepeaterControl, type FontAwesome7Icon, type FontAwesome7IconDefinition, type FontCategory, FontFamilyControl, GapControl, GridSpanControl, HtmlTagControl, type IconLibraryProvider, IconLibraryUploadButton, IconLibraryUploadPromotion, ImageControl, InlineEditingControl, InlineEditor, InlineEditorToolbar, type InlineEditorToolbarProps, ItemSelector, type ItemsActionPayload, KeyValueControl, type LengthUnit, LinkControl, LinkedDimensionsControl, MentionTextAreaControl, NoticeControl, NumberControl, NumberInput, PopoverContent, PopoverGridContainer, PositionControl, type PromotionTrackingData, PromotionTrigger, type PromotionTriggerRef, PropKeyProvider, PropProvider, type PropProviderProps, QueryChipsControl, QueryControl, QueryFilterRepeaterControl, RepeatableControl, Repeater, type RepeaterItem, SelectControl, SelectControlWrapper, type SetRepeaterValuesMeta, type SetValue, type SetValueMeta, SizeComponent, SizeControl, StrokeControl, StyledToggleButton, StyledToggleButtonGroup, SvgMediaControl, SwitchControl, TextAreaControl, TextControl, TimeRangeControl, TimeStringControl, type TimeUnit, type ToggleButtonGroupItem, ToggleButtonGroupUi, ToggleControl, type ToggleControlProps, TransformRepeaterControl, TransformSettingsControl, TransitionRepeaterControl, type Unit, UnstableSizeControl, UnstableSizeField, UrlControl, type UseTypingBufferOptions, type V4PromotionData, type V4PromotionKey, VideoMediaControl, createControl, createControlReplacementsRegistry, enqueueFont, enqueueIconFonts, getControlReplacements, getFontAwesome7IconName, injectIntoIconLibraryUploadAction, injectIntoRepeaterItemActions, injectIntoRepeaterItemIcon, injectIntoRepeaterItemLabel, isUnitExtendedOption, registerControlReplacement, registerIconLibraryProvider, resetFontAwesome7IconsCache, resolveFontAwesome7Icon, resolveProviderIconSvg, trackUpgradePromotionClick, trackViewPromotion, transitionProperties, transitionsItemsList, unregisterIconLibraryProvider, useBoundProp, useControlActions, useControlReplacement, useFontFamilies, useSyncExternalState, useTypingBuffer };
+export { type AdornmentComponent, type AngleUnit, AspectRatioControl, AttachmentTypeControl, AttributesControl, BackgroundControl, BoxShadowRepeaterControl, ChipsControl, ClearIconButton, ColorControl, ControlActions, type ControlActionsItems, ControlActionsProvider, ControlAdornments, ControlAdornmentsProvider, type ControlComponent$1 as ControlComponent, ControlFormLabel, type ControlReplacement, ControlReplacementsProvider, ControlToggleButtonGroup, DateRangeControl, DateTimeControl, DisplayConditionsControl, EmailFormActionControl, type EqualUnequalItems, EqualUnequalSizesControl, type ExtendedOption, FilterRepeaterControl, type FontAwesome7Icon, type FontAwesome7IconDefinition, type FontCategory, FontFamilyControl, GapControl, GridSpanControl, HtmlTagControl, type IconLibraryProvider, IconLibraryUploadButton, IconLibraryUploadPromotion, ImageControl, InlineEditingControl, InlineEditor, InlineEditorToolbar, type InlineEditorToolbarProps, ItemSelector, type ItemsActionPayload, KeyValueControl, type LengthUnit, LinkControl, LinkedDimensionsControl, MentionTextAreaControl, NoticeControl, NumberControl, NumberInput, PopoverContent, PopoverGridContainer, PositionControl, type PromotionTrackingData, PromotionTrigger, type PromotionTriggerRef, PropKeyProvider, PropProvider, type PropProviderProps, QueryChipsControl, QueryControl, QueryFilterRepeaterControl, RepeatableControl, Repeater, type RepeaterItem, SelectControl, SelectControlWrapper, type SetRepeaterValuesMeta, type SetValue, type SetValueMeta, SizeComponent, SizeControl, StrokeControl, StyledToggleButton, StyledToggleButtonGroup, SvgMediaControl, SwitchControl, TextAreaControl, TextControl, TimeRangeControl, TimeStringControl, type TimeUnit, type ToggleButtonGroupItem, ToggleButtonGroupUi, ToggleControl, type ToggleControlProps, TransformRepeaterControl, TransformSettingsControl, TransitionRepeaterControl, type Unit, UnstableSizeControl, UnstableSizeField, UrlControl, type UseTypingBufferOptions, type V4PromotionData, type V4PromotionKey, VideoMediaControl, createControl, createControlReplacementsRegistry, enqueueFont, enqueueIconFonts, getControlReplacements, getFontAwesome7IconName, injectIntoIconLibraryUploadAction, injectIntoRepeaterItemActions, injectIntoRepeaterItemIcon, injectIntoRepeaterItemLabel, isUnitExtendedOption, registerControlReplacement, registerIconLibraryProvider, resetFontAwesome7IconsCache, resolveFontAwesome7Icon, resolveProviderIconPreviewSvg, resolveProviderIconSvg, trackUpgradePromotionClick, trackViewPromotion, transitionProperties, transitionsItemsList, unregisterIconLibraryProvider, useBoundProp, useControlActions, useControlReplacement, useFontFamilies, useSyncExternalState, useTypingBuffer };

package/dist/index.d.ts

@@ -359,10 +359,9 @@ declare const AspectRatioControl: ControlComponent$1<({ label }: {
 }) => React$1.JSX.Element>;
 
 type SvgMediaControlProps = {
-    showIconLibrary?: boolean;
     label?: string;
 };
-declare const SvgMediaControl: ControlComponent$1<({ showIconLibrary, label }: SvgMediaControlProps) => React$1.JSX.Element>;
+declare const SvgMediaControl: ControlComponent$1<({ label }: SvgMediaControlProps) => React$1.JSX.Element>;
 
 type VideoMediaControlProps = {
     label?: string;
@@ -463,6 +462,8 @@ type FontAwesome7Icon = FontAwesome7IconDefinition & {
     value: string;
     glyphClass?: string;
     svgMarkup?: string;
+    /** Markup is resolved on demand by the icon library providers, once the icon is displayed. */
+    lazySvg?: boolean;
 };
 
 type IconLibraryProviderState = {
@@ -473,6 +474,11 @@ type IconLibraryProvider = {
     id: string;
     useIcons: (enabled: boolean) => IconLibraryProviderState;
     resolveSvg?: (library: string, iconValue: string, signal?: AbortSignal) => Promise<string | null>;
+    /**
+     * Resolves markup for picker tiles and the control preview. Falls back to `resolveSvg` when omitted.
+     * Use it when `resolveSvg` has side effects that should only happen for icons that are actually rendered.
+     */
+    resolvePreviewSvg?: (library: string, iconValue: string, signal?: AbortSignal) => Promise<string | null>;
 };
 /**
  * Register before the icon picker mounts. Each picker instance snapshots the providers on mount,
@@ -482,6 +488,7 @@ type IconLibraryProvider = {
 declare function registerIconLibraryProvider(provider: IconLibraryProvider): void;
 declare function unregisterIconLibraryProvider(id: string): void;
 declare function resolveProviderIconSvg(library: string, iconValue: string, signal?: AbortSignal): Promise<string | null>;
+declare function resolveProviderIconPreviewSvg(library: string, iconValue: string, signal?: AbortSignal): Promise<string | null>;
 
 declare function enqueueIconFonts(library: string): void;
 
@@ -966,4 +973,4 @@ declare function useTypingBuffer(options?: UseTypingBufferOptions): {
     startsWith: (haystack: string, needle: string) => boolean;
 };
 
-export { type AdornmentComponent, type AngleUnit, AspectRatioControl, AttachmentTypeControl, AttributesControl, BackgroundControl, BoxShadowRepeaterControl, ChipsControl, ClearIconButton, ColorControl, ControlActions, type ControlActionsItems, ControlActionsProvider, ControlAdornments, ControlAdornmentsProvider, type ControlComponent$1 as ControlComponent, ControlFormLabel, type ControlReplacement, ControlReplacementsProvider, ControlToggleButtonGroup, DateRangeControl, DateTimeControl, DisplayConditionsControl, EmailFormActionControl, type EqualUnequalItems, EqualUnequalSizesControl, type ExtendedOption, FilterRepeaterControl, type FontAwesome7Icon, type FontAwesome7IconDefinition, type FontCategory, FontFamilyControl, GapControl, GridSpanControl, HtmlTagControl, type IconLibraryProvider, IconLibraryUploadButton, IconLibraryUploadPromotion, ImageControl, InlineEditingControl, InlineEditor, InlineEditorToolbar, type InlineEditorToolbarProps, ItemSelector, type ItemsActionPayload, KeyValueControl, type LengthUnit, LinkControl, LinkedDimensionsControl, MentionTextAreaControl, NoticeControl, NumberControl, NumberInput, PopoverContent, PopoverGridContainer, PositionControl, type PromotionTrackingData, PromotionTrigger, type PromotionTriggerRef, PropKeyProvider, PropProvider, type PropProviderProps, QueryChipsControl, QueryControl, QueryFilterRepeaterControl, RepeatableControl, Repeater, type RepeaterItem, SelectControl, SelectControlWrapper, type SetRepeaterValuesMeta, type SetValue, type SetValueMeta, SizeComponent, SizeControl, StrokeControl, StyledToggleButton, StyledToggleButtonGroup, SvgMediaControl, SwitchControl, TextAreaControl, TextControl, TimeRangeControl, TimeStringControl, type TimeUnit, type ToggleButtonGroupItem, ToggleButtonGroupUi, ToggleControl, type ToggleControlProps, TransformRepeaterControl, TransformSettingsControl, TransitionRepeaterControl, type Unit, UnstableSizeControl, UnstableSizeField, UrlControl, type UseTypingBufferOptions, type V4PromotionData, type V4PromotionKey, VideoMediaControl, createControl, createControlReplacementsRegistry, enqueueFont, enqueueIconFonts, getControlReplacements, getFontAwesome7IconName, injectIntoIconLibraryUploadAction, injectIntoRepeaterItemActions, injectIntoRepeaterItemIcon, injectIntoRepeaterItemLabel, isUnitExtendedOption, registerControlReplacement, registerIconLibraryProvider, resetFontAwesome7IconsCache, resolveFontAwesome7Icon, resolveProviderIconSvg, trackUpgradePromotionClick, trackViewPromotion, transitionProperties, transitionsItemsList, unregisterIconLibraryProvider, useBoundProp, useControlActions, useControlReplacement, useFontFamilies, useSyncExternalState, useTypingBuffer };
+export { type AdornmentComponent, type AngleUnit, AspectRatioControl, AttachmentTypeControl, AttributesControl, BackgroundControl, BoxShadowRepeaterControl, ChipsControl, ClearIconButton, ColorControl, ControlActions, type ControlActionsItems, ControlActionsProvider, ControlAdornments, ControlAdornmentsProvider, type ControlComponent$1 as ControlComponent, ControlFormLabel, type ControlReplacement, ControlReplacementsProvider, ControlToggleButtonGroup, DateRangeControl, DateTimeControl, DisplayConditionsControl, EmailFormActionControl, type EqualUnequalItems, EqualUnequalSizesControl, type ExtendedOption, FilterRepeaterControl, type FontAwesome7Icon, type FontAwesome7IconDefinition, type FontCategory, FontFamilyControl, GapControl, GridSpanControl, HtmlTagControl, type IconLibraryProvider, IconLibraryUploadButton, IconLibraryUploadPromotion, ImageControl, InlineEditingControl, InlineEditor, InlineEditorToolbar, type InlineEditorToolbarProps, ItemSelector, type ItemsActionPayload, KeyValueControl, type LengthUnit, LinkControl, LinkedDimensionsControl, MentionTextAreaControl, NoticeControl, NumberControl, NumberInput, PopoverContent, PopoverGridContainer, PositionControl, type PromotionTrackingData, PromotionTrigger, type PromotionTriggerRef, PropKeyProvider, PropProvider, type PropProviderProps, QueryChipsControl, QueryControl, QueryFilterRepeaterControl, RepeatableControl, Repeater, type RepeaterItem, SelectControl, SelectControlWrapper, type SetRepeaterValuesMeta, type SetValue, type SetValueMeta, SizeComponent, SizeControl, StrokeControl, StyledToggleButton, StyledToggleButtonGroup, SvgMediaControl, SwitchControl, TextAreaControl, TextControl, TimeRangeControl, TimeStringControl, type TimeUnit, type ToggleButtonGroupItem, ToggleButtonGroupUi, ToggleControl, type ToggleControlProps, TransformRepeaterControl, TransformSettingsControl, TransitionRepeaterControl, type Unit, UnstableSizeControl, UnstableSizeField, UrlControl, type UseTypingBufferOptions, type V4PromotionData, type V4PromotionKey, VideoMediaControl, createControl, createControlReplacementsRegistry, enqueueFont, enqueueIconFonts, getControlReplacements, getFontAwesome7IconName, injectIntoIconLibraryUploadAction, injectIntoRepeaterItemActions, injectIntoRepeaterItemIcon, injectIntoRepeaterItemLabel, isUnitExtendedOption, registerControlReplacement, registerIconLibraryProvider, resetFontAwesome7IconsCache, resolveFontAwesome7Icon, resolveProviderIconPreviewSvg, resolveProviderIconSvg, trackUpgradePromotionClick, trackViewPromotion, transitionProperties, transitionsItemsList, unregisterIconLibraryProvider, useBoundProp, useControlActions, useControlReplacement, useFontFamilies, useSyncExternalState, useTypingBuffer };