@elementor/editor-canvas 3.35.0-356 → 3.35.0-358

package/dist/index.d.mts

@@ -5,6 +5,7 @@ import { Props, PropTypeKey, PropsSchema, AnyTransformable } from '@elementor/ed
 
 declare const BREAKPOINTS_SCHEMA_URI = "elementor://breakpoints/list";
 
+declare const WIDGET_SCHEMA_URI = "elementor://widgets/schema/{widgetType}";
 declare const STYLE_SCHEMA_URI = "elementor://styles/schema/{category}";
 
 declare function init(): void;
@@ -131,6 +132,17 @@ type ElementLegacyType = {
 };
 declare function registerElementType(type: string, elementTypeGenerator: ElementLegacyType[keyof ElementLegacyType]): void;
 
+declare class RenderContext<TContext extends Record<string, unknown>> {
+    private key;
+    private context;
+    constructor(key: string, initialContext: TContext);
+    get(): TContext;
+    set(context: TContext): void;
+    update(updates: TContext): void;
+    delete(): void;
+    clear(): void;
+}
+
 type UnbrandedTransformer<TValue> = (value: TValue, options: {
     key: string;
     signal?: AbortSignal;
@@ -190,6 +202,8 @@ declare const endDragElementFromPanel: () => void;
 
 declare function getCanvasIframeDocument(): Document | null | undefined;
 
+declare const DOCUMENT_STRUCTURE_URI = "elementor://document/structure";
+
 declare function createTransformer<TValue = never>(cb: TValue extends AnyTransformable ? 'Transformable values are invalid, use the actual value instead.' : UnbrandedTransformer<TValue>): Transformer<NoInfer<TValue>>;
 
-export { type AnyTransformer, BREAKPOINTS_SCHEMA_URI, type BackboneModel, type CreateTemplatedElementTypeOptions, type ElementModel, ElementType, ElementView, type LegacyWindow, type PropsResolver, STYLE_SCHEMA_URI, createPropsResolver, createTemplatedElementView, createTransformer, createTransformersRegistry, endDragElementFromPanel, getCanvasIframeDocument, init, registerElementType, settingsTransformersRegistry, startDragElementFromPanel, styleTransformersRegistry };
+export { type AnyTransformer, BREAKPOINTS_SCHEMA_URI, type BackboneModel, type CreateTemplatedElementTypeOptions, DOCUMENT_STRUCTURE_URI, type ElementModel, ElementType, ElementView, type LegacyWindow, type PropsResolver, RenderContext, STYLE_SCHEMA_URI, WIDGET_SCHEMA_URI, createPropsResolver, createTemplatedElementView, createTransformer, createTransformersRegistry, endDragElementFromPanel, getCanvasIframeDocument, init, registerElementType, settingsTransformersRegistry, startDragElementFromPanel, styleTransformersRegistry };

package/dist/index.d.ts

@@ -5,6 +5,7 @@ import { Props, PropTypeKey, PropsSchema, AnyTransformable } from '@elementor/ed
 
 declare const BREAKPOINTS_SCHEMA_URI = "elementor://breakpoints/list";
 
+declare const WIDGET_SCHEMA_URI = "elementor://widgets/schema/{widgetType}";
 declare const STYLE_SCHEMA_URI = "elementor://styles/schema/{category}";
 
 declare function init(): void;
@@ -131,6 +132,17 @@ type ElementLegacyType = {
 };
 declare function registerElementType(type: string, elementTypeGenerator: ElementLegacyType[keyof ElementLegacyType]): void;
 
+declare class RenderContext<TContext extends Record<string, unknown>> {
+    private key;
+    private context;
+    constructor(key: string, initialContext: TContext);
+    get(): TContext;
+    set(context: TContext): void;
+    update(updates: TContext): void;
+    delete(): void;
+    clear(): void;
+}
+
 type UnbrandedTransformer<TValue> = (value: TValue, options: {
     key: string;
     signal?: AbortSignal;
@@ -190,6 +202,8 @@ declare const endDragElementFromPanel: () => void;
 
 declare function getCanvasIframeDocument(): Document | null | undefined;
 
+declare const DOCUMENT_STRUCTURE_URI = "elementor://document/structure";
+
 declare function createTransformer<TValue = never>(cb: TValue extends AnyTransformable ? 'Transformable values are invalid, use the actual value instead.' : UnbrandedTransformer<TValue>): Transformer<NoInfer<TValue>>;
 
-export { type AnyTransformer, BREAKPOINTS_SCHEMA_URI, type BackboneModel, type CreateTemplatedElementTypeOptions, type ElementModel, ElementType, ElementView, type LegacyWindow, type PropsResolver, STYLE_SCHEMA_URI, createPropsResolver, createTemplatedElementView, createTransformer, createTransformersRegistry, endDragElementFromPanel, getCanvasIframeDocument, init, registerElementType, settingsTransformersRegistry, startDragElementFromPanel, styleTransformersRegistry };
+export { type AnyTransformer, BREAKPOINTS_SCHEMA_URI, type BackboneModel, type CreateTemplatedElementTypeOptions, DOCUMENT_STRUCTURE_URI, type ElementModel, ElementType, ElementView, type LegacyWindow, type PropsResolver, RenderContext, STYLE_SCHEMA_URI, WIDGET_SCHEMA_URI, createPropsResolver, createTemplatedElementView, createTransformer, createTransformersRegistry, endDragElementFromPanel, getCanvasIframeDocument, init, registerElementType, settingsTransformersRegistry, startDragElementFromPanel, styleTransformersRegistry };

package/dist/index.js

@@ -31,7 +31,10 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   BREAKPOINTS_SCHEMA_URI: () => BREAKPOINTS_SCHEMA_URI,
+  DOCUMENT_STRUCTURE_URI: () => DOCUMENT_STRUCTURE_URI,
+  RenderContext: () => RenderContext,
   STYLE_SCHEMA_URI: () => STYLE_SCHEMA_URI,
+  WIDGET_SCHEMA_URI: () => WIDGET_SCHEMA_URI,
   createPropsResolver: () => createPropsResolver,
   createTemplatedElementView: () => createTemplatedElementView,
   createTransformer: () => createTransformer,
@@ -1943,6 +1946,81 @@ function initLegacyViews() {
   });
 }
 
+// src/mcp/resources/document-structure-resource.ts
+var import_editor_v1_adapters10 = require("@elementor/editor-v1-adapters");
+var DOCUMENT_STRUCTURE_URI = "elementor://document/structure";
+var initDocumentStructureResource = (reg) => {
+  const { mcpServer, sendResourceUpdated } = reg;
+  let currentDocumentStructure = null;
+  const updateDocumentStructure = () => {
+    const structure = getDocumentStructure();
+    const newStructure = JSON.stringify(structure, null, 2);
+    if (newStructure !== currentDocumentStructure) {
+      currentDocumentStructure = newStructure;
+      sendResourceUpdated({ uri: DOCUMENT_STRUCTURE_URI });
+    }
+  };
+  (0, import_editor_v1_adapters10.__privateListenTo)(
+    [
+      (0, import_editor_v1_adapters10.commandEndEvent)("document/elements/create"),
+      (0, import_editor_v1_adapters10.commandEndEvent)("document/elements/delete"),
+      (0, import_editor_v1_adapters10.commandEndEvent)("document/elements/move"),
+      (0, import_editor_v1_adapters10.commandEndEvent)("document/elements/copy"),
+      (0, import_editor_v1_adapters10.commandEndEvent)("document/elements/paste"),
+      (0, import_editor_v1_adapters10.commandEndEvent)("editor/documents/attach-preview")
+    ],
+    updateDocumentStructure
+  );
+  updateDocumentStructure();
+  mcpServer.resource("document-structure", DOCUMENT_STRUCTURE_URI, async () => {
+    const structure = getDocumentStructure();
+    return {
+      contents: [
+        {
+          uri: DOCUMENT_STRUCTURE_URI,
+          text: JSON.stringify(structure, null, 2)
+        }
+      ]
+    };
+  });
+};
+function getDocumentStructure() {
+  const extendedWindow = window;
+  const document2 = extendedWindow.elementor?.documents?.getCurrent?.();
+  if (!document2) {
+    return { error: "No active document found" };
+  }
+  const containers = document2.container?.children || [];
+  const elements = containers.map(
+    (container) => extractElementData(container)
+  );
+  return {
+    documentId: document2.id,
+    documentType: document2.config.type,
+    title: document2.config.settings?.post_title || "Untitled",
+    elements: elements.filter((el) => el !== null)
+  };
+}
+function extractElementData(element) {
+  if (!element || !element.model) {
+    return null;
+  }
+  const model = element.model.attributes;
+  const result = {
+    id: model.id,
+    elType: model.elType,
+    widgetType: model.widgetType || void 0
+  };
+  const title = model.title || element.model?.editor_settings?.title;
+  if (title) {
+    result.title = title;
+  }
+  if (element.children && element.children.length > 0) {
+    result.children = element.children.map((child) => extractElementData(child)).filter((child) => child !== null);
+  }
+  return result;
+}
+
 // src/mcp/tools/build-composition/tool.ts
 var import_editor_elements8 = require("@elementor/editor-elements");
 
@@ -2950,6 +3028,7 @@ var initCanvasMcp = (reg) => {
     'Everything related to creative design, layout, styling and building the pages, specifically element of type "widget"'
   );
   initWidgetsSchemaResource(reg);
+  initDocumentStructureResource(reg);
   initBuildCompositionsTool(reg);
   initGetElementConfigTool(reg);
   initConfigureElementTool(reg);
@@ -3085,14 +3164,14 @@ An Example scenario of creating fully styled composition:
 // src/prevent-link-in-link-commands.ts
 var import_editor_elements10 = require("@elementor/editor-elements");
 var import_editor_notifications = require("@elementor/editor-notifications");
-var import_editor_v1_adapters10 = require("@elementor/editor-v1-adapters");
+var import_editor_v1_adapters11 = require("@elementor/editor-v1-adapters");
 var import_i18n = require("@wordpress/i18n");
 function initLinkInLinkPrevention() {
-  (0, import_editor_v1_adapters10.blockCommand)({
+  (0, import_editor_v1_adapters11.blockCommand)({
     command: "document/elements/paste",
     condition: blockLinkInLinkPaste
   });
-  (0, import_editor_v1_adapters10.blockCommand)({
+  (0, import_editor_v1_adapters11.blockCommand)({
     command: "document/elements/move",
     condition: blockLinkInLinkMove
   });
@@ -3166,12 +3245,12 @@ function shouldBlock(sourceElements, targetElements) {
 }
 
 // src/style-commands/paste-style.ts
-var import_editor_v1_adapters12 = require("@elementor/editor-v1-adapters");
+var import_editor_v1_adapters13 = require("@elementor/editor-v1-adapters");
 
 // src/style-commands/undoable-actions/paste-element-style.ts
 var import_editor_elements12 = require("@elementor/editor-elements");
 var import_editor_styles_repository4 = require("@elementor/editor-styles-repository");
-var import_editor_v1_adapters11 = require("@elementor/editor-v1-adapters");
+var import_editor_v1_adapters12 = require("@elementor/editor-v1-adapters");
 var import_i18n3 = require("@wordpress/i18n");
 
 // src/style-commands/utils.ts
@@ -3217,7 +3296,7 @@ function getTitleForContainers(containers) {
 }
 
 // src/style-commands/undoable-actions/paste-element-style.ts
-var undoablePasteElementStyle = () => (0, import_editor_v1_adapters11.undoable)(
+var undoablePasteElementStyle = () => (0, import_editor_v1_adapters12.undoable)(
   {
     do: ({ containers, newStyle }) => {
       return containers.map((container) => {
@@ -3293,12 +3372,12 @@ var undoablePasteElementStyle = () => (0, import_editor_v1_adapters11.undoable)(
 // src/style-commands/paste-style.ts
 function initPasteStyleCommand() {
   const pasteElementStyleCommand = undoablePasteElementStyle();
-  (0, import_editor_v1_adapters12.blockCommand)({
+  (0, import_editor_v1_adapters13.blockCommand)({
     command: "document/elements/paste-style",
     condition: hasAtomicWidgets
   });
-  (0, import_editor_v1_adapters12.__privateListenTo)(
-    (0, import_editor_v1_adapters12.commandStartEvent)("document/elements/paste-style"),
+  (0, import_editor_v1_adapters13.__privateListenTo)(
+    (0, import_editor_v1_adapters13.commandStartEvent)("document/elements/paste-style"),
     (e) => pasteStyles(e.args, pasteElementStyleCommand)
   );
 }
@@ -3322,14 +3401,14 @@ function pasteStyles(args, pasteCallback) {
 }
 
 // src/style-commands/reset-style.ts
-var import_editor_v1_adapters14 = require("@elementor/editor-v1-adapters");
+var import_editor_v1_adapters15 = require("@elementor/editor-v1-adapters");
 
 // src/style-commands/undoable-actions/reset-element-style.ts
 var import_editor_elements13 = require("@elementor/editor-elements");
 var import_editor_styles_repository5 = require("@elementor/editor-styles-repository");
-var import_editor_v1_adapters13 = require("@elementor/editor-v1-adapters");
+var import_editor_v1_adapters14 = require("@elementor/editor-v1-adapters");
 var import_i18n4 = require("@wordpress/i18n");
-var undoableResetElementStyle = () => (0, import_editor_v1_adapters13.undoable)(
+var undoableResetElementStyle = () => (0, import_editor_v1_adapters14.undoable)(
   {
     do: ({ containers }) => {
       return containers.map((container) => {
@@ -3373,12 +3452,12 @@ var undoableResetElementStyle = () => (0, import_editor_v1_adapters13.undoable)(
 // src/style-commands/reset-style.ts
 function initResetStyleCommand() {
   const resetElementStyles = undoableResetElementStyle();
-  (0, import_editor_v1_adapters14.blockCommand)({
+  (0, import_editor_v1_adapters15.blockCommand)({
     command: "document/elements/reset-style",
     condition: hasAtomicWidgets
   });
-  (0, import_editor_v1_adapters14.__privateListenTo)(
-    (0, import_editor_v1_adapters14.commandStartEvent)("document/elements/reset-style"),
+  (0, import_editor_v1_adapters15.__privateListenTo)(
+    (0, import_editor_v1_adapters15.commandStartEvent)("document/elements/reset-style"),
     (e) => resetStyles(e.args, resetElementStyles)
   );
 }
@@ -3428,6 +3507,35 @@ function init() {
   );
 }
 
+// src/renderers/render-context.ts
+var RenderContext = class {
+  key;
+  context = /* @__PURE__ */ new Map();
+  constructor(key, initialContext) {
+    this.key = key;
+    this.context.set(this.key, initialContext);
+  }
+  get() {
+    return this.context.get(this.key);
+  }
+  set(context) {
+    this.context.set(this.key, context);
+  }
+  update(updates) {
+    const currentContext = this.context.get(this.key);
+    if (!currentContext) {
+      return this.set(updates);
+    }
+    this.context.set(this.key, { ...currentContext, ...updates });
+  }
+  delete() {
+    this.context.delete(this.key);
+  }
+  clear() {
+    this.context.clear();
+  }
+};
+
 // src/sync/drag-element-from-panel.ts
 var startDragElementFromPanel = (props) => {
   const channels = getElementorChannels();
@@ -3465,7 +3573,10 @@ var getLegacyPanelElementView = ({ settings, ...rest }) => {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   BREAKPOINTS_SCHEMA_URI,
+  DOCUMENT_STRUCTURE_URI,
+  RenderContext,
   STYLE_SCHEMA_URI,
+  WIDGET_SCHEMA_URI,
   createPropsResolver,
   createTemplatedElementView,
   createTransformer,

package/dist/index.mjs

@@ -1911,6 +1911,81 @@ function initLegacyViews() {
   });
 }
 
+// src/mcp/resources/document-structure-resource.ts
+import { __privateListenTo as listenTo, commandEndEvent as commandEndEvent4 } from "@elementor/editor-v1-adapters";
+var DOCUMENT_STRUCTURE_URI = "elementor://document/structure";
+var initDocumentStructureResource = (reg) => {
+  const { mcpServer, sendResourceUpdated } = reg;
+  let currentDocumentStructure = null;
+  const updateDocumentStructure = () => {
+    const structure = getDocumentStructure();
+    const newStructure = JSON.stringify(structure, null, 2);
+    if (newStructure !== currentDocumentStructure) {
+      currentDocumentStructure = newStructure;
+      sendResourceUpdated({ uri: DOCUMENT_STRUCTURE_URI });
+    }
+  };
+  listenTo(
+    [
+      commandEndEvent4("document/elements/create"),
+      commandEndEvent4("document/elements/delete"),
+      commandEndEvent4("document/elements/move"),
+      commandEndEvent4("document/elements/copy"),
+      commandEndEvent4("document/elements/paste"),
+      commandEndEvent4("editor/documents/attach-preview")
+    ],
+    updateDocumentStructure
+  );
+  updateDocumentStructure();
+  mcpServer.resource("document-structure", DOCUMENT_STRUCTURE_URI, async () => {
+    const structure = getDocumentStructure();
+    return {
+      contents: [
+        {
+          uri: DOCUMENT_STRUCTURE_URI,
+          text: JSON.stringify(structure, null, 2)
+        }
+      ]
+    };
+  });
+};
+function getDocumentStructure() {
+  const extendedWindow = window;
+  const document2 = extendedWindow.elementor?.documents?.getCurrent?.();
+  if (!document2) {
+    return { error: "No active document found" };
+  }
+  const containers = document2.container?.children || [];
+  const elements = containers.map(
+    (container) => extractElementData(container)
+  );
+  return {
+    documentId: document2.id,
+    documentType: document2.config.type,
+    title: document2.config.settings?.post_title || "Untitled",
+    elements: elements.filter((el) => el !== null)
+  };
+}
+function extractElementData(element) {
+  if (!element || !element.model) {
+    return null;
+  }
+  const model = element.model.attributes;
+  const result = {
+    id: model.id,
+    elType: model.elType,
+    widgetType: model.widgetType || void 0
+  };
+  const title = model.title || element.model?.editor_settings?.title;
+  if (title) {
+    result.title = title;
+  }
+  if (element.children && element.children.length > 0) {
+    result.children = element.children.map((child) => extractElementData(child)).filter((child) => child !== null);
+  }
+  return result;
+}
+
 // src/mcp/tools/build-composition/tool.ts
 import {
   createElement as createElement6,
@@ -2930,6 +3005,7 @@ var initCanvasMcp = (reg) => {
     'Everything related to creative design, layout, styling and building the pages, specifically element of type "widget"'
   );
   initWidgetsSchemaResource(reg);
+  initDocumentStructureResource(reg);
   initBuildCompositionsTool(reg);
   initGetElementConfigTool(reg);
   initConfigureElementTool(reg);
@@ -3151,7 +3227,7 @@ function shouldBlock(sourceElements, targetElements) {
 
 // src/style-commands/paste-style.ts
 import {
-  __privateListenTo as listenTo,
+  __privateListenTo as listenTo2,
   blockCommand as blockCommand2,
   commandStartEvent
 } from "@elementor/editor-v1-adapters";
@@ -3290,7 +3366,7 @@ function initPasteStyleCommand() {
     command: "document/elements/paste-style",
     condition: hasAtomicWidgets
   });
-  listenTo(
+  listenTo2(
     commandStartEvent("document/elements/paste-style"),
     (e) => pasteStyles(e.args, pasteElementStyleCommand)
   );
@@ -3316,7 +3392,7 @@ function pasteStyles(args, pasteCallback) {
 
 // src/style-commands/reset-style.ts
 import {
-  __privateListenTo as listenTo2,
+  __privateListenTo as listenTo3,
   blockCommand as blockCommand3,
   commandStartEvent as commandStartEvent2
 } from "@elementor/editor-v1-adapters";
@@ -3374,7 +3450,7 @@ function initResetStyleCommand() {
     command: "document/elements/reset-style",
     condition: hasAtomicWidgets
   });
-  listenTo2(
+  listenTo3(
     commandStartEvent2("document/elements/reset-style"),
     (e) => resetStyles(e.args, resetElementStyles)
   );
@@ -3425,6 +3501,35 @@ function init() {
   );
 }
 
+// src/renderers/render-context.ts
+var RenderContext = class {
+  key;
+  context = /* @__PURE__ */ new Map();
+  constructor(key, initialContext) {
+    this.key = key;
+    this.context.set(this.key, initialContext);
+  }
+  get() {
+    return this.context.get(this.key);
+  }
+  set(context) {
+    this.context.set(this.key, context);
+  }
+  update(updates) {
+    const currentContext = this.context.get(this.key);
+    if (!currentContext) {
+      return this.set(updates);
+    }
+    this.context.set(this.key, { ...currentContext, ...updates });
+  }
+  delete() {
+    this.context.delete(this.key);
+  }
+  clear() {
+    this.context.clear();
+  }
+};
+
 // src/sync/drag-element-from-panel.ts
 var startDragElementFromPanel = (props) => {
   const channels = getElementorChannels();
@@ -3461,7 +3566,10 @@ var getLegacyPanelElementView = ({ settings, ...rest }) => {
 };
 export {
   BREAKPOINTS_SCHEMA_URI,
+  DOCUMENT_STRUCTURE_URI,
+  RenderContext,
   STYLE_SCHEMA_URI,
+  WIDGET_SCHEMA_URI,
   createPropsResolver,
   createTemplatedElementView,
   createTransformer,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@elementor/editor-canvas",
   "description": "Elementor Editor Canvas",
-  "version": "3.35.0-356",
+  "version": "3.35.0-358",
   "private": false,
   "author": "Elementor Team",
   "homepage": "https://elementor.com/",
@@ -37,24 +37,24 @@
     "react-dom": "^18.3.1"
   },
   "dependencies": {
-    "@elementor/editor": "3.35.0-356",
-    "@elementor/editor-controls": "3.35.0-356",
-    "@elementor/editor-documents": "3.35.0-356",
-    "@elementor/editor-elements": "3.35.0-356",
-    "@elementor/editor-interactions": "3.35.0-356",
-    "@elementor/editor-mcp": "3.35.0-356",
-    "@elementor/editor-notifications": "3.35.0-356",
-    "@elementor/editor-props": "3.35.0-356",
-    "@elementor/editor-responsive": "3.35.0-356",
-    "@elementor/editor-styles": "3.35.0-356",
-    "@elementor/editor-styles-repository": "3.35.0-356",
-    "@elementor/editor-ui": "3.35.0-356",
-    "@elementor/editor-v1-adapters": "3.35.0-356",
-    "@elementor/schema": "3.35.0-356",
-    "@elementor/twing": "3.35.0-356",
+    "@elementor/editor": "3.35.0-358",
+    "@elementor/editor-controls": "3.35.0-358",
+    "@elementor/editor-documents": "3.35.0-358",
+    "@elementor/editor-elements": "3.35.0-358",
+    "@elementor/editor-interactions": "3.35.0-358",
+    "@elementor/editor-mcp": "3.35.0-358",
+    "@elementor/editor-notifications": "3.35.0-358",
+    "@elementor/editor-props": "3.35.0-358",
+    "@elementor/editor-responsive": "3.35.0-358",
+    "@elementor/editor-styles": "3.35.0-358",
+    "@elementor/editor-styles-repository": "3.35.0-358",
+    "@elementor/editor-ui": "3.35.0-358",
+    "@elementor/editor-v1-adapters": "3.35.0-358",
+    "@elementor/schema": "3.35.0-358",
+    "@elementor/twing": "3.35.0-358",
     "@elementor/ui": "1.36.17",
-    "@elementor/utils": "3.35.0-356",
-    "@elementor/wp-media": "3.35.0-356",
+    "@elementor/utils": "3.35.0-358",
+    "@elementor/wp-media": "3.35.0-358",
     "@floating-ui/react": "^0.27.5",
     "@wordpress/i18n": "^5.13.0"
   },

package/src/index.ts

@@ -9,11 +9,15 @@ export {
 } from './legacy/create-templated-element-type';
 export { registerElementType } from './legacy/init-legacy-views';
 export * from './legacy/types';
+export { RenderContext } from './renderers/render-context';
 export { createPropsResolver, type PropsResolver } from './renderers/create-props-resolver';
 export { settingsTransformersRegistry } from './settings-transformers-registry';
 export { styleTransformersRegistry } from './style-transformers-registry';
 export { endDragElementFromPanel, startDragElementFromPanel } from './sync/drag-element-from-panel';
 export { getCanvasIframeDocument } from './sync/get-canvas-iframe-document';
+export { DOCUMENT_STRUCTURE_URI } from './mcp/resources/document-structure-resource';
+export { WIDGET_SCHEMA_URI } from './mcp/resources/widgets-schema-resource';
+export * from './legacy/types';
 export { createTransformer } from './transformers/create-transformer';
 export { createTransformersRegistry } from './transformers/create-transformers-registry';
 export { type AnyTransformer } from './transformers/types';

package/src/mcp/canvas-mcp.ts

@@ -1,6 +1,7 @@
 import { type MCPRegistryEntry } from '@elementor/editor-mcp';
 
 import { initBreakpointsResource } from './resources/breakpoints-resource';
+import { initDocumentStructureResource } from './resources/document-structure-resource';
 import { initWidgetsSchemaResource } from './resources/widgets-schema-resource';
 import { initBuildCompositionsTool } from './tools/build-composition/tool';
 import { initConfigureElementTool } from './tools/configure-element/tool';
@@ -12,6 +13,7 @@ export const initCanvasMcp = ( reg: MCPRegistryEntry ) => {
 		'Everything related to creative design, layout, styling and building the pages, specifically element of type "widget"'
 	);
 	initWidgetsSchemaResource( reg );
+	initDocumentStructureResource( reg );
 	initBuildCompositionsTool( reg );
 	initGetElementConfigTool( reg );
 	initConfigureElementTool( reg );

package/src/mcp/resources/document-structure-resource.ts

@@ -0,0 +1,132 @@
+import { type MCPRegistryEntry } from '@elementor/editor-mcp';
+import { __privateListenTo as listenTo, commandEndEvent } from '@elementor/editor-v1-adapters';
+
+type ExtendedWindow = Window & {
+	elementor?: {
+		documents?: {
+			getCurrent?: () => {
+				id: number;
+				config: {
+					type: string;
+					settings?: {
+						post_title?: string;
+					};
+				};
+				container: {
+					children?: ElementorContainer[];
+				};
+			};
+		};
+	};
+};
+
+type ElementorContainer = {
+	id: string;
+	model: {
+		attributes: {
+			id: string;
+			elType: string;
+			widgetType?: string;
+			title?: string;
+		};
+		editor_settings?: {
+			title?: string;
+		};
+	};
+	children?: ElementorContainer[];
+};
+
+export const DOCUMENT_STRUCTURE_URI = 'elementor://document/structure';
+
+export const initDocumentStructureResource = ( reg: MCPRegistryEntry ) => {
+	const { mcpServer, sendResourceUpdated } = reg;
+
+	let currentDocumentStructure: string | null = null;
+
+	const updateDocumentStructure = () => {
+		const structure = getDocumentStructure();
+		const newStructure = JSON.stringify( structure, null, 2 );
+
+		if ( newStructure !== currentDocumentStructure ) {
+			currentDocumentStructure = newStructure;
+			sendResourceUpdated( { uri: DOCUMENT_STRUCTURE_URI } );
+		}
+	};
+
+	// Listen to document changes
+	listenTo(
+		[
+			commandEndEvent( 'document/elements/create' ),
+			commandEndEvent( 'document/elements/delete' ),
+			commandEndEvent( 'document/elements/move' ),
+			commandEndEvent( 'document/elements/copy' ),
+			commandEndEvent( 'document/elements/paste' ),
+			commandEndEvent( 'editor/documents/attach-preview' ),
+		],
+		updateDocumentStructure
+	);
+
+	// Initialize on load
+	updateDocumentStructure();
+
+	mcpServer.resource( 'document-structure', DOCUMENT_STRUCTURE_URI, async () => {
+		const structure = getDocumentStructure();
+
+		return {
+			contents: [
+				{
+					uri: DOCUMENT_STRUCTURE_URI,
+					text: JSON.stringify( structure, null, 2 ),
+				},
+			],
+		};
+	} );
+};
+
+function getDocumentStructure() {
+	const extendedWindow = window as ExtendedWindow;
+	const document = extendedWindow.elementor?.documents?.getCurrent?.();
+
+	if ( ! document ) {
+		return { error: 'No active document found' };
+	}
+
+	const containers = document.container?.children || [];
+	const elements = ( containers as ElementorContainer[] ).map( ( container: ElementorContainer ) =>
+		extractElementData( container )
+	);
+
+	return {
+		documentId: document.id,
+		documentType: document.config.type,
+		title: document.config.settings?.post_title || 'Untitled',
+		elements: elements.filter( ( el: Record< string, unknown > | null ) => el !== null ),
+	};
+}
+
+function extractElementData( element: ElementorContainer ): Record< string, unknown > | null {
+	if ( ! element || ! element.model ) {
+		return null;
+	}
+
+	const model = element.model.attributes;
+	const result: Record< string, unknown > = {
+		id: model.id,
+		elType: model.elType,
+		widgetType: model.widgetType || undefined,
+	};
+
+	const title = model.title || element.model?.editor_settings?.title;
+
+	if ( title ) {
+		result.title = title;
+	}
+
+	if ( element.children && element.children.length > 0 ) {
+		result.children = element.children
+			.map( ( child: ElementorContainer ) => extractElementData( child ) )
+			.filter( ( child: Record< string, unknown > | null ) => child !== null );
+	}
+
+	return result;
+}

package/src/renderers/render-context.ts

@@ -0,0 +1,35 @@
+export class RenderContext< TContext extends Record< string, unknown > > {
+	private key: string;
+	private context = new Map< string, TContext >();
+
+	public constructor( key: string, initialContext: TContext ) {
+		this.key = key;
+		this.context.set( this.key, initialContext );
+	}
+
+	public get(): TContext {
+		return this.context.get( this.key ) as TContext;
+	}
+
+	public set( context: TContext ) {
+		this.context.set( this.key, context );
+	}
+
+	public update( updates: TContext ) {
+		const currentContext = this.context.get( this.key );
+
+		if ( ! currentContext ) {
+			return this.set( updates );
+		}
+
+		this.context.set( this.key, { ...currentContext, ...updates } );
+	}
+
+	public delete() {
+		this.context.delete( this.key );
+	}
+
+	public clear() {
+		this.context.clear();
+	}
+}