@elementor/editor-elements 4.3.0-999 → 4.4.0-1064

package/dist/index.d.mts

@@ -227,6 +227,7 @@ type V1ElementEditorSettingsProps = {
     initial_position?: number;
     component_uid?: string;
     grid_outline?: boolean;
+    empty_state_preview?: boolean;
 };
 type V1ElementSettingsProps = Record<string, PropValue>;
 type V1ElementConfig<T = object, TChild = unknown> = {
@@ -253,6 +254,8 @@ type V1ElementConfig<T = object, TChild = unknown> = {
     meta?: {
         [key: string]: string | number | boolean | null | NonNullable<V1ElementConfig['meta']>;
     };
+    default_html_tag?: string;
+    html_tag_follows_link?: boolean;
 } & T;
 type V1Model$1<T> = {
     get: <K extends keyof T>(key: K) => T[K];
@@ -292,7 +295,17 @@ type ElementModel = {
     editorSettings: V1ElementEditorSettingsProps;
 };
 type ElementChildren = Record<string, ElementModel[]>;
-declare function useElementChildren<T extends ElementChildren>(elementId: ElementID, childrenTypes: Record<string, string>): T;
+type UseElementChildrenOptions = {
+    /**
+     * Let the element itself match a requested parent type. Off by default, because
+     * `findChildRecursive` only inspects descendants and existing callers rely on that: an element
+     * whose repeater items are its own direct children (e.g. `e-accordion` -> `e-accordion-item`)
+     * has no intermediate wrapper to look for, while one that keeps them in a sub-container
+     * (e.g. `e-tabs` -> `e-tabs-menu` -> `e-tab`) must not match itself.
+     */
+    includeSelfAsParent?: boolean;
+};
+declare function useElementChildren<T extends ElementChildren>(elementId: ElementID, childrenTypes: Record<string, string>, { includeSelfAsParent }?: UseElementChildrenOptions): T;
 
 declare const useElementEditorSettings: (elementId: ElementID) => V1ElementEditorSettingsProps;
 
@@ -413,6 +426,8 @@ declare const generateElementId: () => string;
 declare function getContainer(id: string): V1Element | null;
 declare const selectElement: (elementId: string) => void;
 
+declare function getPreviewElementDOM(id: string): HTMLElement | null;
+
 declare function resolveContainer(container: V1Element, id: string): V1Element | null;
 declare function findModelInDocument(id: string): BackboneModel | null;
 declare function addModelToParent(parentId: string, childData: V1ElementModelProps, options?: {
@@ -588,10 +603,14 @@ declare function updateElementStyle(args: UpdateElementStyleArgs): void;
 
 declare function getElementInteractions(elementId: ElementID): ElementInteractions | undefined;
 
+declare const DEFAULT_STYLE_CLASS_PREFIX = "e-default-";
+declare function parseDefaultStyleTagFromClassList(classList: DOMTokenList): string | null;
+declare function getDefaultStyleTagFromPreviewElement(elementId: string): string | null;
+
 declare const updateElementInteractions: ({ elementId, interactions, }: {
     elementId: string;
     interactions: V1ElementModelProps["interactions"];
 }) => void;
 declare const playElementInteractions: (elementId: string, interactionId: string) => void;
 
-export { type AnimationPresetPropValue, type BackboneCollection, type BackboneModel, type BooleanPropValue, type ChildDependenciesConfig, type ChildDependencyRule, type ConfigPropValue, type Control, type ControlItem, type ControlLayout, type ControlsSection, type CreateElementParams, type CreateElementStyleArgs, type DropElementParams, type DuplicateElementParams, type DuplicateElementsParams, type DuplicatedElement, type DuplicatedElementsResult, ELEMENT_STYLE_CHANGE_EVENT, type Element, type ElementChildren, type ElementControl, type ElementID, type ElementInteractions, type ElementModel, type ElementPosition, type ElementPositionKind, type ElementType, type ExcludedBreakpointsPropValue, type ExtendedWindow, type InteractionBreakpointsPropValue, type InteractionItemPropValue, type LinkInLinkRestriction, type ModelResult, type MoveElementParams, type NumberPropValue, type PseudoState, type StringPropValue, type TimingConfigPropValue, type UpdateElementSettingsArgs, type UpdateElementStyleArgs, type V1Element, type V1ElementConfig, type V1ElementData, type V1ElementEditorSettingsProps, type V1ElementModelProps, type V1ElementSettingsProps, addModelToParent, bindSettingsReconcile, createElement, createElementStyle, createElements, deleteElement, deleteElementStyle, dropElement, duplicateElement, duplicateElements, evaluateWhen, findChildRecursive, findModelInDocument, generateElementId, getAllDescendants, getAnchoredAncestorId, getAnchoredDescendantId, getContainer, getCurrentDocumentContainer, getCurrentDocumentId, getElementChildren as getElementChildrenWithFallback, getElementEditorSettings, getElementIcon, getElementInteractions, getElementLabel, getElementSetting, getElementSettings, getElementStyles, getElementTitle, getElementType, getElements, getLinkInLinkRestriction, getSelectedElements, getWidgetsCache, isElementAnchored, moveElement, moveElements, playElementInteractions, reconcileInitialChildren, removeElements, removeModelFromParent, replaceElement, resolveContainer, resolveInsertIndex, selectElement, shouldCreateNewLocalStyle, styleRerenderEvents, updateElementEditorSettings, updateElementInteractions, updateElementSettings, updateElementStyle, useElementChildren, useElementEditorSettings, useParentElement, useSelectedElement, useSelectedElementSettings };
+export { type AnimationPresetPropValue, type BackboneCollection, type BackboneModel, type BooleanPropValue, type ChildDependenciesConfig, type ChildDependencyRule, type ConfigPropValue, type Control, type ControlItem, type ControlLayout, type ControlsSection, type CreateElementParams, type CreateElementStyleArgs, DEFAULT_STYLE_CLASS_PREFIX, type DropElementParams, type DuplicateElementParams, type DuplicateElementsParams, type DuplicatedElement, type DuplicatedElementsResult, ELEMENT_STYLE_CHANGE_EVENT, type Element, type ElementChildren, type ElementControl, type ElementID, type ElementInteractions, type ElementModel, type ElementPosition, type ElementPositionKind, type ElementType, type ExcludedBreakpointsPropValue, type ExtendedWindow, type InteractionBreakpointsPropValue, type InteractionItemPropValue, type LinkInLinkRestriction, type ModelResult, type MoveElementParams, type NumberPropValue, type PseudoState, type StringPropValue, type TimingConfigPropValue, type UpdateElementSettingsArgs, type UpdateElementStyleArgs, type UseElementChildrenOptions, type V1Element, type V1ElementConfig, type V1ElementData, type V1ElementEditorSettingsProps, type V1ElementModelProps, type V1ElementSettingsProps, addModelToParent, bindSettingsReconcile, createElement, createElementStyle, createElements, deleteElement, deleteElementStyle, dropElement, duplicateElement, duplicateElements, evaluateWhen, findChildRecursive, findModelInDocument, generateElementId, getAllDescendants, getAnchoredAncestorId, getAnchoredDescendantId, getContainer, getCurrentDocumentContainer, getCurrentDocumentId, getDefaultStyleTagFromPreviewElement, getElementChildren as getElementChildrenWithFallback, getElementEditorSettings, getElementIcon, getElementInteractions, getElementLabel, getElementSetting, getElementSettings, getElementStyles, getElementTitle, getElementType, getElements, getLinkInLinkRestriction, getPreviewElementDOM, getSelectedElements, getWidgetsCache, isElementAnchored, moveElement, moveElements, parseDefaultStyleTagFromClassList, playElementInteractions, reconcileInitialChildren, removeElements, removeModelFromParent, replaceElement, resolveContainer, resolveInsertIndex, selectElement, shouldCreateNewLocalStyle, styleRerenderEvents, updateElementEditorSettings, updateElementInteractions, updateElementSettings, updateElementStyle, useElementChildren, useElementEditorSettings, useParentElement, useSelectedElement, useSelectedElementSettings };

package/dist/index.d.ts

@@ -227,6 +227,7 @@ type V1ElementEditorSettingsProps = {
     initial_position?: number;
     component_uid?: string;
     grid_outline?: boolean;
+    empty_state_preview?: boolean;
 };
 type V1ElementSettingsProps = Record<string, PropValue>;
 type V1ElementConfig<T = object, TChild = unknown> = {
@@ -253,6 +254,8 @@ type V1ElementConfig<T = object, TChild = unknown> = {
     meta?: {
         [key: string]: string | number | boolean | null | NonNullable<V1ElementConfig['meta']>;
     };
+    default_html_tag?: string;
+    html_tag_follows_link?: boolean;
 } & T;
 type V1Model$1<T> = {
     get: <K extends keyof T>(key: K) => T[K];
@@ -292,7 +295,17 @@ type ElementModel = {
     editorSettings: V1ElementEditorSettingsProps;
 };
 type ElementChildren = Record<string, ElementModel[]>;
-declare function useElementChildren<T extends ElementChildren>(elementId: ElementID, childrenTypes: Record<string, string>): T;
+type UseElementChildrenOptions = {
+    /**
+     * Let the element itself match a requested parent type. Off by default, because
+     * `findChildRecursive` only inspects descendants and existing callers rely on that: an element
+     * whose repeater items are its own direct children (e.g. `e-accordion` -> `e-accordion-item`)
+     * has no intermediate wrapper to look for, while one that keeps them in a sub-container
+     * (e.g. `e-tabs` -> `e-tabs-menu` -> `e-tab`) must not match itself.
+     */
+    includeSelfAsParent?: boolean;
+};
+declare function useElementChildren<T extends ElementChildren>(elementId: ElementID, childrenTypes: Record<string, string>, { includeSelfAsParent }?: UseElementChildrenOptions): T;
 
 declare const useElementEditorSettings: (elementId: ElementID) => V1ElementEditorSettingsProps;
 
@@ -413,6 +426,8 @@ declare const generateElementId: () => string;
 declare function getContainer(id: string): V1Element | null;
 declare const selectElement: (elementId: string) => void;
 
+declare function getPreviewElementDOM(id: string): HTMLElement | null;
+
 declare function resolveContainer(container: V1Element, id: string): V1Element | null;
 declare function findModelInDocument(id: string): BackboneModel | null;
 declare function addModelToParent(parentId: string, childData: V1ElementModelProps, options?: {
@@ -588,10 +603,14 @@ declare function updateElementStyle(args: UpdateElementStyleArgs): void;
 
 declare function getElementInteractions(elementId: ElementID): ElementInteractions | undefined;
 
+declare const DEFAULT_STYLE_CLASS_PREFIX = "e-default-";
+declare function parseDefaultStyleTagFromClassList(classList: DOMTokenList): string | null;
+declare function getDefaultStyleTagFromPreviewElement(elementId: string): string | null;
+
 declare const updateElementInteractions: ({ elementId, interactions, }: {
     elementId: string;
     interactions: V1ElementModelProps["interactions"];
 }) => void;
 declare const playElementInteractions: (elementId: string, interactionId: string) => void;
 
-export { type AnimationPresetPropValue, type BackboneCollection, type BackboneModel, type BooleanPropValue, type ChildDependenciesConfig, type ChildDependencyRule, type ConfigPropValue, type Control, type ControlItem, type ControlLayout, type ControlsSection, type CreateElementParams, type CreateElementStyleArgs, type DropElementParams, type DuplicateElementParams, type DuplicateElementsParams, type DuplicatedElement, type DuplicatedElementsResult, ELEMENT_STYLE_CHANGE_EVENT, type Element, type ElementChildren, type ElementControl, type ElementID, type ElementInteractions, type ElementModel, type ElementPosition, type ElementPositionKind, type ElementType, type ExcludedBreakpointsPropValue, type ExtendedWindow, type InteractionBreakpointsPropValue, type InteractionItemPropValue, type LinkInLinkRestriction, type ModelResult, type MoveElementParams, type NumberPropValue, type PseudoState, type StringPropValue, type TimingConfigPropValue, type UpdateElementSettingsArgs, type UpdateElementStyleArgs, type V1Element, type V1ElementConfig, type V1ElementData, type V1ElementEditorSettingsProps, type V1ElementModelProps, type V1ElementSettingsProps, addModelToParent, bindSettingsReconcile, createElement, createElementStyle, createElements, deleteElement, deleteElementStyle, dropElement, duplicateElement, duplicateElements, evaluateWhen, findChildRecursive, findModelInDocument, generateElementId, getAllDescendants, getAnchoredAncestorId, getAnchoredDescendantId, getContainer, getCurrentDocumentContainer, getCurrentDocumentId, getElementChildren as getElementChildrenWithFallback, getElementEditorSettings, getElementIcon, getElementInteractions, getElementLabel, getElementSetting, getElementSettings, getElementStyles, getElementTitle, getElementType, getElements, getLinkInLinkRestriction, getSelectedElements, getWidgetsCache, isElementAnchored, moveElement, moveElements, playElementInteractions, reconcileInitialChildren, removeElements, removeModelFromParent, replaceElement, resolveContainer, resolveInsertIndex, selectElement, shouldCreateNewLocalStyle, styleRerenderEvents, updateElementEditorSettings, updateElementInteractions, updateElementSettings, updateElementStyle, useElementChildren, useElementEditorSettings, useParentElement, useSelectedElement, useSelectedElementSettings };
+export { type AnimationPresetPropValue, type BackboneCollection, type BackboneModel, type BooleanPropValue, type ChildDependenciesConfig, type ChildDependencyRule, type ConfigPropValue, type Control, type ControlItem, type ControlLayout, type ControlsSection, type CreateElementParams, type CreateElementStyleArgs, DEFAULT_STYLE_CLASS_PREFIX, type DropElementParams, type DuplicateElementParams, type DuplicateElementsParams, type DuplicatedElement, type DuplicatedElementsResult, ELEMENT_STYLE_CHANGE_EVENT, type Element, type ElementChildren, type ElementControl, type ElementID, type ElementInteractions, type ElementModel, type ElementPosition, type ElementPositionKind, type ElementType, type ExcludedBreakpointsPropValue, type ExtendedWindow, type InteractionBreakpointsPropValue, type InteractionItemPropValue, type LinkInLinkRestriction, type ModelResult, type MoveElementParams, type NumberPropValue, type PseudoState, type StringPropValue, type TimingConfigPropValue, type UpdateElementSettingsArgs, type UpdateElementStyleArgs, type UseElementChildrenOptions, type V1Element, type V1ElementConfig, type V1ElementData, type V1ElementEditorSettingsProps, type V1ElementModelProps, type V1ElementSettingsProps, addModelToParent, bindSettingsReconcile, createElement, createElementStyle, createElements, deleteElement, deleteElementStyle, dropElement, duplicateElement, duplicateElements, evaluateWhen, findChildRecursive, findModelInDocument, generateElementId, getAllDescendants, getAnchoredAncestorId, getAnchoredDescendantId, getContainer, getCurrentDocumentContainer, getCurrentDocumentId, getDefaultStyleTagFromPreviewElement, getElementChildren as getElementChildrenWithFallback, getElementEditorSettings, getElementIcon, getElementInteractions, getElementLabel, getElementSetting, getElementSettings, getElementStyles, getElementTitle, getElementType, getElements, getLinkInLinkRestriction, getPreviewElementDOM, getSelectedElements, getWidgetsCache, isElementAnchored, moveElement, moveElements, parseDefaultStyleTagFromClassList, playElementInteractions, reconcileInitialChildren, removeElements, removeModelFromParent, replaceElement, resolveContainer, resolveInsertIndex, selectElement, shouldCreateNewLocalStyle, styleRerenderEvents, updateElementEditorSettings, updateElementInteractions, updateElementSettings, updateElementStyle, useElementChildren, useElementEditorSettings, useParentElement, useSelectedElement, useSelectedElementSettings };

package/dist/index.js

@@ -20,6 +20,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  DEFAULT_STYLE_CLASS_PREFIX: () => DEFAULT_STYLE_CLASS_PREFIX,
   ELEMENT_STYLE_CHANGE_EVENT: () => ELEMENT_STYLE_CHANGE_EVENT,
   addModelToParent: () => addModelToParent,
   bindSettingsReconcile: () => bindSettingsReconcile,
@@ -41,6 +42,7 @@ __export(index_exports, {
   getContainer: () => getContainer,
   getCurrentDocumentContainer: () => getCurrentDocumentContainer,
   getCurrentDocumentId: () => getCurrentDocumentId,
+  getDefaultStyleTagFromPreviewElement: () => getDefaultStyleTagFromPreviewElement,
   getElementChildrenWithFallback: () => getElementChildren,
   getElementEditorSettings: () => getElementEditorSettings,
   getElementIcon: () => getElementIcon,
@@ -53,11 +55,13 @@ __export(index_exports, {
   getElementType: () => getElementType,
   getElements: () => getElements,
   getLinkInLinkRestriction: () => getLinkInLinkRestriction,
+  getPreviewElementDOM: () => getPreviewElementDOM,
   getSelectedElements: () => getSelectedElements,
   getWidgetsCache: () => getWidgetsCache,
   isElementAnchored: () => isElementAnchored,
   moveElement: () => moveElement,
   moveElements: () => moveElements,
+  parseDefaultStyleTagFromClassList: () => parseDefaultStyleTagFromClassList,
   playElementInteractions: () => playElementInteractions,
   reconcileInitialChildren: () => reconcileInitialChildren,
   removeElements: () => removeElements,
@@ -365,7 +369,7 @@ function toElementModel({ model }) {
     editorSettings: model.get("editor_settings") ?? {}
   };
 }
-function useElementChildren(elementId, childrenTypes) {
+function useElementChildren(elementId, childrenTypes, { includeSelfAsParent = false } = {}) {
   return (0, import_editor_v1_adapters2.__privateUseListenTo)(
     [
       (0, import_editor_v1_adapters2.v1ReadyEvent)(),
@@ -381,7 +385,7 @@ function useElementChildren(elementId, childrenTypes) {
         return {};
       }
       const elementChildren = Object.entries(childrenTypes).reduce((acc, [parentType, childType]) => {
-        const parent = findChildRecursive(model, (m) => m.get("elType") === parentType);
+        const parent = includeSelfAsParent && model.get("elType") === parentType ? { model } : findChildRecursive(model, (m) => m.get("elType") === parentType);
         if (!parent) {
           acc[childType] = [];
           return acc;
@@ -769,6 +773,26 @@ var duplicateElements = ({
   return undoableDuplicate({ elementIds });
 };
 
+// src/sync/get-preview-element-dom.ts
+function getPreviewElementDOM(id) {
+  try {
+    const fromContainer = getContainer(id)?.view?.el;
+    if (fromContainer) {
+      return fromContainer;
+    }
+    return queryPreviewDOMByElementId(id);
+  } catch {
+    return null;
+  }
+}
+function queryPreviewDOMByElementId(id) {
+  const previewDocument = window.elementor?.getPreviewContainer?.()?.view?.el?.ownerDocument;
+  if (!previewDocument) {
+    return null;
+  }
+  return previewDocument.querySelector(`[data-id="${id}"]`);
+}
+
 // src/sync/get-current-document-container.ts
 function getCurrentDocumentContainer() {
   const extendedWindow = window;
@@ -1290,22 +1314,7 @@ function checkForInlineLink(elementId, resolvedValue) {
   return element.querySelector(ANCHOR_SELECTOR) !== null;
 }
 function getElementDOM(id) {
-  try {
-    const fromContainer = getContainer(id)?.view?.el;
-    if (fromContainer) {
-      return fromContainer;
-    }
-    return queryPreviewDOMByElementId(id);
-  } catch {
-    return null;
-  }
-}
-function queryPreviewDOMByElementId(id) {
-  const previewDocument = window.elementor?.getPreviewContainer?.()?.view?.el?.ownerDocument;
-  if (!previewDocument) {
-    return null;
-  }
-  return previewDocument.querySelector(`[data-id="${id}"]`);
+  return getPreviewElementDOM(id);
 }
 function isElementorElement(element) {
   return element.hasAttribute("data-id");
@@ -1475,6 +1484,48 @@ function getElementInteractions(elementId) {
   return interactions;
 }
 
+// src/utils/get-default-style-tag-from-preview.ts
+var DEFAULT_STYLE_CLASS_PREFIX = "e-default-";
+function parseDefaultStyleTagFromClassList(classList) {
+  for (const className of classList) {
+    if (className.startsWith(DEFAULT_STYLE_CLASS_PREFIX)) {
+      return className.slice(DEFAULT_STYLE_CLASS_PREFIX.length);
+    }
+  }
+  return null;
+}
+function getDefaultStyleTagFromPreviewElement(elementId) {
+  const renderRoot = getAtomicElementRenderRoot(elementId);
+  if (!renderRoot) {
+    return null;
+  }
+  return parseDefaultStyleTagFromClassList(renderRoot.classList);
+}
+function getAtomicElementRenderRoot(elementId) {
+  const view = getContainerView(elementId);
+  if (view?.getDomElement) {
+    const domElement = view.getDomElement().get?.(0);
+    if (domElement) {
+      return domElement;
+    }
+  }
+  const wrapper = view?.el ?? getPreviewElementDOM(elementId);
+  if (!wrapper) {
+    return null;
+  }
+  if (wrapper.hasAttribute("data-id")) {
+    return wrapper;
+  }
+  const firstChild = wrapper.firstElementChild;
+  if (firstChild instanceof HTMLElement) {
+    return firstChild;
+  }
+  return wrapper;
+}
+function getContainerView(elementId) {
+  return getContainer(elementId)?.view ?? null;
+}
+
 // src/sync/update-element-interactions.ts
 var import_editor_v1_adapters19 = require("@elementor/editor-v1-adapters");
 var updateElementInteractions = ({
@@ -1496,6 +1547,7 @@ var playElementInteractions = (elementId, interactionId) => {
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  DEFAULT_STYLE_CLASS_PREFIX,
   ELEMENT_STYLE_CHANGE_EVENT,
   addModelToParent,
   bindSettingsReconcile,
@@ -1517,6 +1569,7 @@ var playElementInteractions = (elementId, interactionId) => {
   getContainer,
   getCurrentDocumentContainer,
   getCurrentDocumentId,
+  getDefaultStyleTagFromPreviewElement,
   getElementChildrenWithFallback,
   getElementEditorSettings,
   getElementIcon,
@@ -1529,11 +1582,13 @@ var playElementInteractions = (elementId, interactionId) => {
   getElementType,
   getElements,
   getLinkInLinkRestriction,
+  getPreviewElementDOM,
   getSelectedElements,
   getWidgetsCache,
   isElementAnchored,
   moveElement,
   moveElements,
+  parseDefaultStyleTagFromClassList,
   playElementInteractions,
   reconcileInitialChildren,
   removeElements,