@elementor/editor-elements 4.3.3 → 4.3.5

package/dist/index.d.mts

@@ -75,6 +75,7 @@ type ExtendedWindow = Window & {
                     findModelById?: (id: string, collection?: unknown) => BackboneModel | null;
                     addModelToParent?: (parentId: string, childData: unknown, options?: {
                         at?: number;
+                        clone?: boolean;
                     }) => boolean;
                     removeModelFromParent?: (parentId: string, childId: string) => boolean;
                 };
@@ -91,6 +92,10 @@ type ExtendedWindow = Window & {
                 container: V1Element;
             } | undefined;
             getCurrentId?: () => number;
+            getInitialId?: () => number;
+            get?: (id: number) => {
+                container: V1Element;
+            } | undefined;
         };
         getContainer?: (id: string) => V1Element | undefined;
         getPreviewContainer?: () => V1Element | undefined;
@@ -228,6 +233,7 @@ type V1ElementEditorSettingsProps = {
     component_uid?: string;
     grid_outline?: boolean;
     empty_state_preview?: boolean;
+    decorative?: boolean;
 };
 type V1ElementSettingsProps = Record<string, PropValue>;
 type V1ElementConfig<T = object, TChild = unknown> = {
@@ -242,6 +248,7 @@ type V1ElementConfig<T = object, TChild = unknown> = {
     dependencies_per_target_mapping?: Record<string, string[]>;
     twig_templates?: Record<string, string>;
     twig_main_template?: string;
+    template_context?: Record<string, unknown>;
     base_styles?: Record<string, StyleDefinition>;
     base_styles_dictionary?: Record<string, string>;
     base_settings?: Record<string, PropValue>;
@@ -421,6 +428,9 @@ type DuplicatedElementsResult = {
 
 declare const duplicateElements: ({ elementIds, title, subtitle, onDuplicateElements, onRestoreElements, }: DuplicateElementsParams) => DuplicatedElementsResult;
 
+type CloneableElement = Partial<V1ElementModelProps> | BackboneModel;
+declare function cloneElementTree(item: CloneableElement): V1ElementModelProps;
+
 declare const generateElementId: () => string;
 
 declare function getContainer(id: string): V1Element | null;
@@ -432,6 +442,7 @@ declare function resolveContainer(container: V1Element, id: string): V1Element |
 declare function findModelInDocument(id: string): BackboneModel | null;
 declare function addModelToParent(parentId: string, childData: V1ElementModelProps, options?: {
     at?: number;
+    clone?: boolean;
 }): boolean;
 declare function removeModelFromParent(parentId: string, childId: string): boolean;
 
@@ -464,6 +475,9 @@ declare function findChildRecursive(model: V1Model, predicate: (model: V1Model)
 declare function getElementChildren(model: V1Model, predicate?: (model: V1Model) => boolean): ModelResult[];
 
 declare function getElements(root?: ElementID): V1Element[];
+declare function getHostDocumentElements(): V1Element[];
+
+declare function getHostDocumentId(): number | null;
 
 declare function getSelectedElements(): Element[];
 
@@ -613,4 +627,4 @@ declare const updateElementInteractions: ({ elementId, 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, 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 };
+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, cloneElementTree, 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, getHostDocumentElements, getHostDocumentId, 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

@@ -75,6 +75,7 @@ type ExtendedWindow = Window & {
                     findModelById?: (id: string, collection?: unknown) => BackboneModel | null;
                     addModelToParent?: (parentId: string, childData: unknown, options?: {
                         at?: number;
+                        clone?: boolean;
                     }) => boolean;
                     removeModelFromParent?: (parentId: string, childId: string) => boolean;
                 };
@@ -91,6 +92,10 @@ type ExtendedWindow = Window & {
                 container: V1Element;
             } | undefined;
             getCurrentId?: () => number;
+            getInitialId?: () => number;
+            get?: (id: number) => {
+                container: V1Element;
+            } | undefined;
         };
         getContainer?: (id: string) => V1Element | undefined;
         getPreviewContainer?: () => V1Element | undefined;
@@ -228,6 +233,7 @@ type V1ElementEditorSettingsProps = {
     component_uid?: string;
     grid_outline?: boolean;
     empty_state_preview?: boolean;
+    decorative?: boolean;
 };
 type V1ElementSettingsProps = Record<string, PropValue>;
 type V1ElementConfig<T = object, TChild = unknown> = {
@@ -242,6 +248,7 @@ type V1ElementConfig<T = object, TChild = unknown> = {
     dependencies_per_target_mapping?: Record<string, string[]>;
     twig_templates?: Record<string, string>;
     twig_main_template?: string;
+    template_context?: Record<string, unknown>;
     base_styles?: Record<string, StyleDefinition>;
     base_styles_dictionary?: Record<string, string>;
     base_settings?: Record<string, PropValue>;
@@ -421,6 +428,9 @@ type DuplicatedElementsResult = {
 
 declare const duplicateElements: ({ elementIds, title, subtitle, onDuplicateElements, onRestoreElements, }: DuplicateElementsParams) => DuplicatedElementsResult;
 
+type CloneableElement = Partial<V1ElementModelProps> | BackboneModel;
+declare function cloneElementTree(item: CloneableElement): V1ElementModelProps;
+
 declare const generateElementId: () => string;
 
 declare function getContainer(id: string): V1Element | null;
@@ -432,6 +442,7 @@ declare function resolveContainer(container: V1Element, id: string): V1Element |
 declare function findModelInDocument(id: string): BackboneModel | null;
 declare function addModelToParent(parentId: string, childData: V1ElementModelProps, options?: {
     at?: number;
+    clone?: boolean;
 }): boolean;
 declare function removeModelFromParent(parentId: string, childId: string): boolean;
 
@@ -464,6 +475,9 @@ declare function findChildRecursive(model: V1Model, predicate: (model: V1Model)
 declare function getElementChildren(model: V1Model, predicate?: (model: V1Model) => boolean): ModelResult[];
 
 declare function getElements(root?: ElementID): V1Element[];
+declare function getHostDocumentElements(): V1Element[];
+
+declare function getHostDocumentId(): number | null;
 
 declare function getSelectedElements(): Element[];
 
@@ -613,4 +627,4 @@ declare const updateElementInteractions: ({ elementId, 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, 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 };
+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, cloneElementTree, 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, getHostDocumentElements, getHostDocumentId, 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

@@ -24,6 +24,7 @@ __export(index_exports, {
   ELEMENT_STYLE_CHANGE_EVENT: () => ELEMENT_STYLE_CHANGE_EVENT,
   addModelToParent: () => addModelToParent,
   bindSettingsReconcile: () => bindSettingsReconcile,
+  cloneElementTree: () => cloneElementTree,
   createElement: () => createElement,
   createElementStyle: () => createElementStyle,
   createElements: () => createElements,
@@ -54,6 +55,8 @@ __export(index_exports, {
   getElementTitle: () => getElementTitle,
   getElementType: () => getElementType,
   getElements: () => getElements,
+  getHostDocumentElements: () => getHostDocumentElements,
+  getHostDocumentId: () => getHostDocumentId,
   getLinkInLinkRestriction: () => getLinkInLinkRestriction,
   getPreviewElementDOM: () => getPreviewElementDOM,
   getSelectedElements: () => getSelectedElements,
@@ -261,6 +264,7 @@ function attachChildFromRule(parentId, rule, stash) {
   const currentChildren = getDirectChildData(parent);
   const alreadyPresent = currentChildren.some((child) => child.elType === rule.child_type);
   if (alreadyPresent) {
+    placeAnchoredChild(parentId, rule);
     return;
   }
   const { modelData, wasStashed } = resolveChildModelData(parentId, rule, stash);
@@ -290,6 +294,36 @@ function detachChildFromRule(parentId, rule, stash) {
   }
   requestNavigatorRefresh(parentId);
 }
+function placeAnchoredChild(parentId, rule) {
+  if (rule.position.kind !== "after_type" && rule.position.kind !== "before_type") {
+    return;
+  }
+  let parent;
+  try {
+    parent = getContainer(parentId) ?? void 0;
+  } catch {
+    return;
+  }
+  const collection = parent?.model?.get?.("elements");
+  const models = collection?.models;
+  if (!models || !collection?.remove || !collection?.add) {
+    return;
+  }
+  const existingIndex = models.findIndex((model2) => model2.get("elType") === rule.child_type);
+  if (existingIndex < 0) {
+    return;
+  }
+  const siblings = models.map((model2) => ({ elType: model2.get("elType") }));
+  const remaining = siblings.filter((_, index) => index !== existingIndex);
+  const insertAt = resolveInsertIndex(rule.position, remaining);
+  if (insertAt === existingIndex) {
+    return;
+  }
+  const model = models[existingIndex];
+  collection.remove(model, { silent: true });
+  collection.add(model, { at: insertAt, silent: true });
+  requestNavigatorRefresh(parentId);
+}
 function requestNavigatorRefresh(parentId) {
   if (typeof window === "undefined" || typeof window.dispatchEvent !== "function") {
     return;
@@ -321,6 +355,15 @@ function reconcileInitialChildren({
     const isMet = evaluateWhen(rule.when, settings);
     const existingIndex = elements.findIndex((element) => element.elType === rule.child_type);
     const isPresent = existingIndex >= 0;
+    if (isMet && isPresent && isAnchoredPosition(rule.position.kind)) {
+      const remaining = elements.filter((_, index) => index !== existingIndex);
+      const insertAt = resolveInsertIndex(rule.position, remaining);
+      if (insertAt !== existingIndex) {
+        const [moved] = elements.splice(existingIndex, 1);
+        elements.splice(insertAt, 0, moved);
+      }
+      return;
+    }
     if (isMet && !isPresent) {
       const { modelData, wasStashed } = resolveChildModelData(elementId, rule, stash);
       const insertAt = resolveInsertIndex(rule.position, elements);
@@ -339,6 +382,9 @@ function reconcileInitialChildren({
   });
   attributes.elements = elements;
 }
+function isAnchoredPosition(kind) {
+  return kind === "after_type" || kind === "before_type";
+}
 
 // src/hooks/use-element-children.ts
 var import_editor_v1_adapters2 = require("@elementor/editor-v1-adapters");
@@ -773,6 +819,25 @@ var duplicateElements = ({
   return undoableDuplicate({ elementIds });
 };
 
+// src/sync/clone-element-tree.ts
+function isBackboneModel(item) {
+  return "toJSON" in item && "get" in item;
+}
+function cloneElementTree(item) {
+  const source = isBackboneModel(item) ? item.toJSON() : item;
+  return {
+    ...source,
+    id: generateElementId(),
+    settings: {
+      ...source.settings ?? {},
+      _element_id: ""
+    },
+    elements: (source.elements ?? []).map(
+      (child) => cloneElementTree(child)
+    )
+  };
+}
+
 // src/sync/get-preview-element-dom.ts
 function getPreviewElementDOM(id) {
   try {
@@ -906,9 +971,28 @@ function getAllDescendants(container) {
   return [container, ...children];
 }
 
+// src/sync/get-host-document-id.ts
+function getHostDocumentId() {
+  const extendedWindow = window;
+  try {
+    return extendedWindow.elementor?.documents?.getInitialId?.() ?? null;
+  } catch {
+    return null;
+  }
+}
+
+// src/sync/get-host-document-container.ts
+function getHostDocumentContainer() {
+  const extendedWindow = window;
+  const hostId = getHostDocumentId();
+  if (!hostId) {
+    return null;
+  }
+  return extendedWindow.elementor?.documents?.get?.(hostId)?.container ?? null;
+}
+
 // src/sync/get-elements.ts
-function getElements(root) {
-  const container = root ? getContainer(root) : getCurrentDocumentContainer();
+function collectElements(container) {
   if (!container) {
     return [];
   }
@@ -917,6 +1001,13 @@ function getElements(root) {
   );
   return [container, ...children];
 }
+function getElements(root) {
+  const container = root ? getContainer(root) : getCurrentDocumentContainer();
+  return collectElements(container);
+}
+function getHostDocumentElements() {
+  return collectElements(getHostDocumentContainer());
+}
 
 // src/sync/move-element.ts
 function moveElement({ element, targetContainer, options = {} }) {
@@ -1554,6 +1645,7 @@ var playElementInteractions = (elementId, interactionId) => {
   ELEMENT_STYLE_CHANGE_EVENT,
   addModelToParent,
   bindSettingsReconcile,
+  cloneElementTree,
   createElement,
   createElementStyle,
   createElements,
@@ -1584,6 +1676,8 @@ var playElementInteractions = (elementId, interactionId) => {
   getElementTitle,
   getElementType,
   getElements,
+  getHostDocumentElements,
+  getHostDocumentId,
   getLinkInLinkRestriction,
   getPreviewElementDOM,
   getSelectedElements,