@dotcms/uve 1.4.0-next.2 → 1.4.0-next.3

package/README.md

@@ -1,8 +1,8 @@
 # dotCMS UVE SDK
 
-The `@dotcms/uve` SDK adds live editing to your JavaScript app using the dotCMS Universal Visual Editor (UVE). It provides low-level tools that power our framework-specific SDKs, such as [`@dotcms/react`](https://github.com/dotCMS/core/blob/main/core-web/libs/sdk/react/README.md) and [`@dotcms/angular`](https://github.com/dotCMS/core/blob/main/core-web/libs/sdk/angular/README.md).
+The `@dotcms/uve` SDK adds live editing to your JavaScript app using the dotCMS Universal Visual Editor (UVE). It provides low-level tools that power our framework-specific SDKs, such as [@dotcms/react](https://github.com/dotCMS/core/blob/main/core-web/libs/sdk/react/README.md) and [@dotcms/angular](https://github.com/dotCMS/core/blob/main/core-web/libs/sdk/angular/README.md).
 
-> ⚠️ We **do not recommend using this SDK directly** for most use cases, you should use a [framework SDK that handles setup](#Getting Started: Recommended Examples), rendering, and event wiring for you.
+> ⚠️ We **do not recommend using this SDK directly** for most use cases, you should use a [framework SDK that handles setup](#getting-started-recommended-examples), rendering, and event wiring for you.
 
 With `@dotcms/uve`, framework SDKs are able to:
 - Make pages and contentlets editable

package/internal.cjs.js

@@ -76,6 +76,7 @@ const __TINYMCE_PATH_ON_DOTCMS__ = '/ext/tinymcev7/tinymce.min.js';
 
 exports.CUSTOM_NO_COMPONENT = _public.CUSTOM_NO_COMPONENT;
 exports.DEVELOPMENT_MODE = _public.DEVELOPMENT_MODE;
+exports.DOT_SECTION_ID_PREFIX = _public.DOT_SECTION_ID_PREFIX;
 exports.EMPTY_CONTAINER_STYLE_ANGULAR = _public.EMPTY_CONTAINER_STYLE_ANGULAR;
 exports.EMPTY_CONTAINER_STYLE_REACT = _public.EMPTY_CONTAINER_STYLE_REACT;
 exports.END_CLASS = _public.END_CLASS;
@@ -99,6 +100,7 @@ exports.getDotContainerAttributes = _public.getDotContainerAttributes;
 exports.getDotContentletAttributes = _public.getDotContentletAttributes;
 exports.getUVEState = _public.getUVEState;
 exports.isValidBlocks = _public.isValidBlocks;
+exports.observeDocumentHeight = _public.observeDocumentHeight;
 exports.setBounds = _public.setBounds;
 exports.__BASE_TINYMCE_CONFIG_WITH_NO_DEFAULT__ = __BASE_TINYMCE_CONFIG_WITH_NO_DEFAULT__;
 exports.__DEFAULT_TINYMCE_CONFIG__ = __DEFAULT_TINYMCE_CONFIG__;

package/internal.esm.js

@@ -1,4 +1,4 @@
-export { C as CUSTOM_NO_COMPONENT, D as DEVELOPMENT_MODE, E as EMPTY_CONTAINER_STYLE_ANGULAR, f as EMPTY_CONTAINER_STYLE_REACT, h as END_CLASS, P as PRODUCTION_MODE, S as START_CLASS, _ as __UVE_EVENTS__, j as __UVE_EVENT_ERROR_FALLBACK__, k as combineClasses, l as computeScrollIsInBottom, a as createUVESubscription, m as findDotCMSElement, n as findDotCMSVTLData, o as getClosestDotCMSContainerData, p as getColumnPositionClasses, q as getContainersData, t as getContentletsInContainer, v as getDotCMSContainerData, w as getDotCMSContentletsBound, x as getDotCMSPageBounds, y as getDotContainerAttributes, z as getDotContentletAttributes, g as getUVEState, A as isValidBlocks, B as setBounds } from './public.esm.js';
+export { C as CUSTOM_NO_COMPONENT, D as DEVELOPMENT_MODE, f as DOT_SECTION_ID_PREFIX, E as EMPTY_CONTAINER_STYLE_ANGULAR, h as EMPTY_CONTAINER_STYLE_REACT, j as END_CLASS, P as PRODUCTION_MODE, S as START_CLASS, _ as __UVE_EVENTS__, k as __UVE_EVENT_ERROR_FALLBACK__, l as combineClasses, m as computeScrollIsInBottom, a as createUVESubscription, n as findDotCMSElement, o as findDotCMSVTLData, p as getClosestDotCMSContainerData, q as getColumnPositionClasses, t as getContainersData, v as getContentletsInContainer, w as getDotCMSContainerData, x as getDotCMSContentletsBound, y as getDotCMSPageBounds, z as getDotContainerAttributes, A as getDotContentletAttributes, g as getUVEState, B as isValidBlocks, F as observeDocumentHeight, G as setBounds } from './public.esm.js';
 import '@dotcms/types';
 import '@dotcms/types/internal';
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dotcms/uve",
-  "version": "1.4.0-next.2",
+  "version": "1.4.0-next.3",
   "description": "Official JavaScript library for interacting with Universal Visual Editor (UVE)",
   "repository": {
     "type": "git",

package/public.cjs.js

@@ -438,6 +438,39 @@ function onIframeScroll(callback) {
     event: types.UVEEventType.IFRAME_SCROLL
   };
 }
+/**
+ * Listens for scroll-to-section requests from the UVE editor.
+ *
+ * Queries `#dot-section-{n}` first, then falls back to `#section-{n}`.
+ * If the element is found, calls the callback with `{ sectionIndex, offsetTop }`.
+ * If not found, the callback is not invoked.
+ *
+ * @param {UVEEventHandler} callback - Receives `{ sectionIndex: number; offsetTop: number }`.
+ * @internal
+ */
+function onScrollToSection(callback) {
+  const messageCallback = event => {
+    if (event.data.name !== internal.__DOTCMS_UVE_EVENT__.UVE_SCROLL_TO_SECTION) {
+      return;
+    }
+    const sectionIndex = event.data.sectionIndex;
+    const el = document.querySelector(`#${DOT_SECTION_ID_PREFIX}${sectionIndex}`) ?? document.querySelector(`#section-${sectionIndex}`);
+    if (!el) {
+      return;
+    }
+    callback({
+      sectionIndex,
+      offsetTop: el.offsetTop
+    });
+  };
+  window.addEventListener('message', messageCallback);
+  return {
+    unsubscribe: () => {
+      window.removeEventListener('message', messageCallback);
+    },
+    event: types.UVEEventType.SCROLL_TO_SECTION
+  };
+}
 /**
  * Subscribes to contentlet hover events in the UVE editor
  *
@@ -527,6 +560,9 @@ const __UVE_EVENTS__ = {
   },
   [types.UVEEventType.CONTENTLET_HOVERED]: callback => {
     return onContentletHovered(callback);
+  },
+  [types.UVEEventType.SCROLL_TO_SECTION]: callback => {
+    return onScrollToSection(callback);
   }
 };
 /**
@@ -601,6 +637,13 @@ const EMPTY_CONTAINER_STYLE_ANGULAR = {
  * @internal
  */
 const CUSTOM_NO_COMPONENT = 'CustomNoComponent';
+/**
+ * ID prefix applied to page section wrappers for editor scroll-to-section support.
+ * Used by SDK row components and the UVE scroll event handler.
+ *
+ * @internal
+ */
+const DOT_SECTION_ID_PREFIX = 'dot-section-';
 
 /**
  * Gets the current state of the Universal Visual Editor (UVE).
@@ -687,6 +730,97 @@ function createUVESubscription(eventType, callback) {
   return eventCallback(callback);
 }
 
+/**
+ * Observes rendered document height changes and notifies the caller after layout settles.
+ *
+ * Uses ResizeObserver on <html> for layout/viewport-driven changes and MutationObserver
+ * on <body> to catch DOM additions/removals that may shrink the page without a resize.
+ * Measurement reads `body.offsetHeight`, which tracks actual content height and
+ * decreases correctly after DOM removals, unaffected by CSS min-height on the html element.
+ */
+function observeDocumentHeight({
+  onHeightChange,
+  documentRef = document,
+  windowRef = window,
+  debounceMs = 50
+}) {
+  const html = documentRef.documentElement;
+  const body = documentRef.body;
+  let debounceTimer = null;
+  let rafOuter = null;
+  let rafInner = null;
+  let lastHeight = null;
+  let destroyed = false;
+  const measureAndNotify = () => {
+    const height = body.offsetHeight;
+    if (!height || height === lastHeight) {
+      return;
+    }
+    lastHeight = height;
+    onHeightChange(height);
+  };
+  const scheduleNotify = () => {
+    if (destroyed) {
+      return;
+    }
+    if (debounceTimer !== null) {
+      clearTimeout(debounceTimer);
+    }
+    debounceTimer = setTimeout(() => {
+      debounceTimer = null;
+      if (destroyed) {
+        return;
+      }
+      rafOuter = windowRef.requestAnimationFrame(() => {
+        rafOuter = null;
+        if (destroyed) {
+          return;
+        }
+        rafInner = windowRef.requestAnimationFrame(() => {
+          rafInner = null;
+          if (!destroyed) {
+            measureAndNotify();
+          }
+        });
+      });
+    }, debounceMs);
+  };
+  const onLoad = () => scheduleNotify();
+  if (documentRef.readyState === 'complete' || documentRef.readyState === 'interactive') {
+    scheduleNotify();
+  } else {
+    windowRef.addEventListener('load', onLoad);
+  }
+  const resizeObserver = new ResizeObserver(() => scheduleNotify());
+  resizeObserver.observe(html);
+  const mutationObserver = new MutationObserver(() => scheduleNotify());
+  mutationObserver.observe(documentRef.body ?? html, {
+    childList: true,
+    subtree: true
+  });
+  return {
+    destroy: () => {
+      destroyed = true;
+      if (debounceTimer !== null) {
+        clearTimeout(debounceTimer);
+        debounceTimer = null;
+      }
+      if (rafOuter !== null) {
+        windowRef.cancelAnimationFrame(rafOuter);
+        rafOuter = null;
+      }
+      if (rafInner !== null) {
+        windowRef.cancelAnimationFrame(rafInner);
+        rafInner = null;
+      }
+      lastHeight = null;
+      resizeObserver.disconnect();
+      mutationObserver.disconnect();
+      windowRef.removeEventListener('load', onLoad);
+    }
+  };
+}
+
 /**
  * Sets the bounds of the containers in the editor.
  * Retrieves the containers from the DOM and sends their position data to the editor.
@@ -873,8 +1007,14 @@ function registerUVEEvents() {
       payload: contentletHovered
     });
   });
+  const scrollToSectionSubscription = createUVESubscription(types.UVEEventType.SCROLL_TO_SECTION, payload => {
+    sendMessageToUVE({
+      action: types.DotCMSUVEAction.SECTION_OFFSET,
+      payload
+    });
+  });
   return {
-    subscriptions: [pageReloadSubscription, requestBoundsSubscription, iframeScrollSubscription, contentletHoveredSubscription]
+    subscriptions: [pageReloadSubscription, requestBoundsSubscription, iframeScrollSubscription, contentletHoveredSubscription, scrollToSectionSubscription]
   };
 }
 /**
@@ -917,6 +1057,60 @@ function listenBlockEditorInlineEvent() {
     }
   };
 }
+/**
+ * Returns whether iframe height must be synchronized via postMessage.
+ *
+ * Same-origin parents can measure iframe content directly, so they do not need
+ * child-driven height reporting. Cross-origin parents cannot access the iframe
+ * DOM, so they still need the reporter fallback.
+ */
+function shouldReportIframeHeightToParent() {
+  if (window.parent === window) {
+    return false;
+  }
+  try {
+    const parentDocument = window.parent.document;
+    return !parentDocument;
+  } catch {
+    return true;
+  }
+}
+/**
+ * Reports the iframe document height to the parent UVE shell via postMessage.
+ *
+ * Uses ResizeObserver on <html> for viewport/font/image-driven size changes, and
+ * MutationObserver on <body> to catch DOM removals (e.g. contentlets deleted by
+ * the editor) that shrink the page without triggering a resize event.
+ *
+ * Measurement reads `document.documentElement.offsetHeight` — the actual rendered
+ * height of the <html> element after layout. `scrollHeight` is intentionally avoided
+ * because it does not reliably decrease when content is removed from the DOM.
+ *
+ * Height sends are coalesced to at most one per double-requestAnimationFrame pair
+ * so they always run after layout and paint have settled.
+ *
+ * @returns {{ destroyHeightReporter: () => void }} Cleanup function that removes
+ * all listeners and disconnects the observers.
+ */
+function reportIframeHeight() {
+  const {
+    destroy
+  } = observeDocumentHeight({
+    onHeightChange: height => {
+      sendMessageToUVE({
+        action: types.DotCMSUVEAction.IFRAME_HEIGHT,
+        payload: {
+          height
+        }
+      });
+    }
+  });
+  return {
+    destroyHeightReporter: () => {
+      destroy();
+    }
+  };
+}
 const listenBlockEditorClick = () => {
   const editBlockEditorNodes = document.querySelectorAll('[data-block-editor-content]');
   if (!editBlockEditorNodes.length) {
@@ -1122,17 +1316,24 @@ function initUVE(config = {}) {
   const {
     destroyListenBlockEditorInlineEvent
   } = listenBlockEditorInlineEvent();
+  const {
+    destroyHeightReporter
+  } = shouldReportIframeHeightToParent() ? reportIframeHeight() : {
+    destroyHeightReporter: () => undefined
+  };
   return {
     destroyUVESubscriptions: () => {
       subscriptions.forEach(subscription => subscription.unsubscribe());
       destroyScrollHandler();
       destroyListenBlockEditorInlineEvent();
+      destroyHeightReporter();
     }
   };
 }
 
 exports.CUSTOM_NO_COMPONENT = CUSTOM_NO_COMPONENT;
 exports.DEVELOPMENT_MODE = DEVELOPMENT_MODE;
+exports.DOT_SECTION_ID_PREFIX = DOT_SECTION_ID_PREFIX;
 exports.EMPTY_CONTAINER_STYLE_ANGULAR = EMPTY_CONTAINER_STYLE_ANGULAR;
 exports.EMPTY_CONTAINER_STYLE_REACT = EMPTY_CONTAINER_STYLE_REACT;
 exports.END_CLASS = END_CLASS;
@@ -1161,6 +1362,7 @@ exports.getUVEState = getUVEState;
 exports.initInlineEditing = initInlineEditing;
 exports.initUVE = initUVE;
 exports.isValidBlocks = isValidBlocks;
+exports.observeDocumentHeight = observeDocumentHeight;
 exports.reorderMenu = reorderMenu;
 exports.sendMessageToUVE = sendMessageToUVE;
 exports.setBounds = setBounds;

package/public.esm.js

@@ -436,6 +436,39 @@ function onIframeScroll(callback) {
     event: UVEEventType.IFRAME_SCROLL
   };
 }
+/**
+ * Listens for scroll-to-section requests from the UVE editor.
+ *
+ * Queries `#dot-section-{n}` first, then falls back to `#section-{n}`.
+ * If the element is found, calls the callback with `{ sectionIndex, offsetTop }`.
+ * If not found, the callback is not invoked.
+ *
+ * @param {UVEEventHandler} callback - Receives `{ sectionIndex: number; offsetTop: number }`.
+ * @internal
+ */
+function onScrollToSection(callback) {
+  const messageCallback = event => {
+    if (event.data.name !== __DOTCMS_UVE_EVENT__.UVE_SCROLL_TO_SECTION) {
+      return;
+    }
+    const sectionIndex = event.data.sectionIndex;
+    const el = document.querySelector(`#${DOT_SECTION_ID_PREFIX}${sectionIndex}`) ?? document.querySelector(`#section-${sectionIndex}`);
+    if (!el) {
+      return;
+    }
+    callback({
+      sectionIndex,
+      offsetTop: el.offsetTop
+    });
+  };
+  window.addEventListener('message', messageCallback);
+  return {
+    unsubscribe: () => {
+      window.removeEventListener('message', messageCallback);
+    },
+    event: UVEEventType.SCROLL_TO_SECTION
+  };
+}
 /**
  * Subscribes to contentlet hover events in the UVE editor
  *
@@ -525,6 +558,9 @@ const __UVE_EVENTS__ = {
   },
   [UVEEventType.CONTENTLET_HOVERED]: callback => {
     return onContentletHovered(callback);
+  },
+  [UVEEventType.SCROLL_TO_SECTION]: callback => {
+    return onScrollToSection(callback);
   }
 };
 /**
@@ -599,6 +635,13 @@ const EMPTY_CONTAINER_STYLE_ANGULAR = {
  * @internal
  */
 const CUSTOM_NO_COMPONENT = 'CustomNoComponent';
+/**
+ * ID prefix applied to page section wrappers for editor scroll-to-section support.
+ * Used by SDK row components and the UVE scroll event handler.
+ *
+ * @internal
+ */
+const DOT_SECTION_ID_PREFIX = 'dot-section-';
 
 /**
  * Gets the current state of the Universal Visual Editor (UVE).
@@ -685,6 +728,97 @@ function createUVESubscription(eventType, callback) {
   return eventCallback(callback);
 }
 
+/**
+ * Observes rendered document height changes and notifies the caller after layout settles.
+ *
+ * Uses ResizeObserver on <html> for layout/viewport-driven changes and MutationObserver
+ * on <body> to catch DOM additions/removals that may shrink the page without a resize.
+ * Measurement reads `body.offsetHeight`, which tracks actual content height and
+ * decreases correctly after DOM removals, unaffected by CSS min-height on the html element.
+ */
+function observeDocumentHeight({
+  onHeightChange,
+  documentRef = document,
+  windowRef = window,
+  debounceMs = 50
+}) {
+  const html = documentRef.documentElement;
+  const body = documentRef.body;
+  let debounceTimer = null;
+  let rafOuter = null;
+  let rafInner = null;
+  let lastHeight = null;
+  let destroyed = false;
+  const measureAndNotify = () => {
+    const height = body.offsetHeight;
+    if (!height || height === lastHeight) {
+      return;
+    }
+    lastHeight = height;
+    onHeightChange(height);
+  };
+  const scheduleNotify = () => {
+    if (destroyed) {
+      return;
+    }
+    if (debounceTimer !== null) {
+      clearTimeout(debounceTimer);
+    }
+    debounceTimer = setTimeout(() => {
+      debounceTimer = null;
+      if (destroyed) {
+        return;
+      }
+      rafOuter = windowRef.requestAnimationFrame(() => {
+        rafOuter = null;
+        if (destroyed) {
+          return;
+        }
+        rafInner = windowRef.requestAnimationFrame(() => {
+          rafInner = null;
+          if (!destroyed) {
+            measureAndNotify();
+          }
+        });
+      });
+    }, debounceMs);
+  };
+  const onLoad = () => scheduleNotify();
+  if (documentRef.readyState === 'complete' || documentRef.readyState === 'interactive') {
+    scheduleNotify();
+  } else {
+    windowRef.addEventListener('load', onLoad);
+  }
+  const resizeObserver = new ResizeObserver(() => scheduleNotify());
+  resizeObserver.observe(html);
+  const mutationObserver = new MutationObserver(() => scheduleNotify());
+  mutationObserver.observe(documentRef.body ?? html, {
+    childList: true,
+    subtree: true
+  });
+  return {
+    destroy: () => {
+      destroyed = true;
+      if (debounceTimer !== null) {
+        clearTimeout(debounceTimer);
+        debounceTimer = null;
+      }
+      if (rafOuter !== null) {
+        windowRef.cancelAnimationFrame(rafOuter);
+        rafOuter = null;
+      }
+      if (rafInner !== null) {
+        windowRef.cancelAnimationFrame(rafInner);
+        rafInner = null;
+      }
+      lastHeight = null;
+      resizeObserver.disconnect();
+      mutationObserver.disconnect();
+      windowRef.removeEventListener('load', onLoad);
+    }
+  };
+}
+
 /**
  * Sets the bounds of the containers in the editor.
  * Retrieves the containers from the DOM and sends their position data to the editor.
@@ -871,8 +1005,14 @@ function registerUVEEvents() {
       payload: contentletHovered
     });
   });
+  const scrollToSectionSubscription = createUVESubscription(UVEEventType.SCROLL_TO_SECTION, payload => {
+    sendMessageToUVE({
+      action: DotCMSUVEAction.SECTION_OFFSET,
+      payload
+    });
+  });
   return {
-    subscriptions: [pageReloadSubscription, requestBoundsSubscription, iframeScrollSubscription, contentletHoveredSubscription]
+    subscriptions: [pageReloadSubscription, requestBoundsSubscription, iframeScrollSubscription, contentletHoveredSubscription, scrollToSectionSubscription]
   };
 }
 /**
@@ -915,6 +1055,60 @@ function listenBlockEditorInlineEvent() {
     }
   };
 }
+/**
+ * Returns whether iframe height must be synchronized via postMessage.
+ *
+ * Same-origin parents can measure iframe content directly, so they do not need
+ * child-driven height reporting. Cross-origin parents cannot access the iframe
+ * DOM, so they still need the reporter fallback.
+ */
+function shouldReportIframeHeightToParent() {
+  if (window.parent === window) {
+    return false;
+  }
+  try {
+    const parentDocument = window.parent.document;
+    return !parentDocument;
+  } catch {
+    return true;
+  }
+}
+/**
+ * Reports the iframe document height to the parent UVE shell via postMessage.
+ *
+ * Uses ResizeObserver on <html> for viewport/font/image-driven size changes, and
+ * MutationObserver on <body> to catch DOM removals (e.g. contentlets deleted by
+ * the editor) that shrink the page without triggering a resize event.
+ *
+ * Measurement reads `document.documentElement.offsetHeight` — the actual rendered
+ * height of the <html> element after layout. `scrollHeight` is intentionally avoided
+ * because it does not reliably decrease when content is removed from the DOM.
+ *
+ * Height sends are coalesced to at most one per double-requestAnimationFrame pair
+ * so they always run after layout and paint have settled.
+ *
+ * @returns {{ destroyHeightReporter: () => void }} Cleanup function that removes
+ * all listeners and disconnects the observers.
+ */
+function reportIframeHeight() {
+  const {
+    destroy
+  } = observeDocumentHeight({
+    onHeightChange: height => {
+      sendMessageToUVE({
+        action: DotCMSUVEAction.IFRAME_HEIGHT,
+        payload: {
+          height
+        }
+      });
+    }
+  });
+  return {
+    destroyHeightReporter: () => {
+      destroy();
+    }
+  };
+}
 const listenBlockEditorClick = () => {
   const editBlockEditorNodes = document.querySelectorAll('[data-block-editor-content]');
   if (!editBlockEditorNodes.length) {
@@ -1120,13 +1314,19 @@ function initUVE(config = {}) {
   const {
     destroyListenBlockEditorInlineEvent
   } = listenBlockEditorInlineEvent();
+  const {
+    destroyHeightReporter
+  } = shouldReportIframeHeightToParent() ? reportIframeHeight() : {
+    destroyHeightReporter: () => undefined
+  };
   return {
     destroyUVESubscriptions: () => {
       subscriptions.forEach(subscription => subscription.unsubscribe());
       destroyScrollHandler();
       destroyListenBlockEditorInlineEvent();
+      destroyHeightReporter();
     }
   };
 }
 
-export { isValidBlocks as A, setBounds as B, CUSTOM_NO_COMPONENT as C, DEVELOPMENT_MODE as D, EMPTY_CONTAINER_STYLE_ANGULAR as E, PRODUCTION_MODE as P, START_CLASS as S, __UVE_EVENTS__ as _, createUVESubscription as a, enableBlockEditorInline as b, createContentlet as c, initUVE as d, editContentlet as e, EMPTY_CONTAINER_STYLE_REACT as f, getUVEState as g, END_CLASS as h, initInlineEditing as i, __UVE_EVENT_ERROR_FALLBACK__ as j, combineClasses as k, computeScrollIsInBottom as l, findDotCMSElement as m, findDotCMSVTLData as n, getClosestDotCMSContainerData as o, getColumnPositionClasses as p, getContainersData as q, reorderMenu as r, sendMessageToUVE as s, getContentletsInContainer as t, updateNavigation as u, getDotCMSContainerData as v, getDotCMSContentletsBound as w, getDotCMSPageBounds as x, getDotContainerAttributes as y, getDotContentletAttributes as z };
+export { getDotContentletAttributes as A, isValidBlocks as B, CUSTOM_NO_COMPONENT as C, DEVELOPMENT_MODE as D, EMPTY_CONTAINER_STYLE_ANGULAR as E, observeDocumentHeight as F, setBounds as G, PRODUCTION_MODE as P, START_CLASS as S, __UVE_EVENTS__ as _, createUVESubscription as a, enableBlockEditorInline as b, createContentlet as c, initUVE as d, editContentlet as e, DOT_SECTION_ID_PREFIX as f, getUVEState as g, EMPTY_CONTAINER_STYLE_REACT as h, initInlineEditing as i, END_CLASS as j, __UVE_EVENT_ERROR_FALLBACK__ as k, combineClasses as l, computeScrollIsInBottom as m, findDotCMSElement as n, findDotCMSVTLData as o, getClosestDotCMSContainerData as p, getColumnPositionClasses as q, reorderMenu as r, sendMessageToUVE as s, getContainersData as t, updateNavigation as u, getContentletsInContainer as v, getDotCMSContainerData as w, getDotCMSContentletsBound as x, getDotCMSPageBounds as y, getDotContainerAttributes as z };

package/src/internal/constants.d.ts

@@ -74,3 +74,10 @@ export declare const EMPTY_CONTAINER_STYLE_ANGULAR: {
  * @internal
  */
 export declare const CUSTOM_NO_COMPONENT = "CustomNoComponent";
+/**
+ * ID prefix applied to page section wrappers for editor scroll-to-section support.
+ * Used by SDK row components and the UVE scroll event handler.
+ *
+ * @internal
+ */
+export declare const DOT_SECTION_ID_PREFIX = "dot-section-";

package/src/internal/events.d.ts

@@ -51,6 +51,20 @@ export declare function onIframeScroll(callback: UVEEventHandler): {
     unsubscribe: () => void;
     event: UVEEventType;
 };
+/**
+ * Listens for scroll-to-section requests from the UVE editor.
+ *
+ * Queries `#dot-section-{n}` first, then falls back to `#section-{n}`.
+ * If the element is found, calls the callback with `{ sectionIndex, offsetTop }`.
+ * If not found, the callback is not invoked.
+ *
+ * @param {UVEEventHandler} callback - Receives `{ sectionIndex: number; offsetTop: number }`.
+ * @internal
+ */
+export declare function onScrollToSection(callback: UVEEventHandler): {
+    unsubscribe: () => void;
+    event: UVEEventType;
+};
 /**
  * Subscribes to contentlet hover events in the UVE editor
  *

package/src/internal.d.ts

@@ -1,4 +1,5 @@
 export * from './internal/index';
 export * from './lib/core/core.utils';
+export * from './lib/dom/document-height-observer';
 export * from './lib/dom/dom.utils';
 export * from './lib/editor/internal';

package/src/lib/dom/document-height-observer.d.ts

@@ -0,0 +1,18 @@
+export interface ObserveDocumentHeightOptions {
+    onHeightChange: (height: number) => void;
+    documentRef?: Document;
+    windowRef?: Window;
+    debounceMs?: number;
+}
+export interface DocumentHeightObserverHandle {
+    destroy: () => void;
+}
+/**
+ * Observes rendered document height changes and notifies the caller after layout settles.
+ *
+ * Uses ResizeObserver on <html> for layout/viewport-driven changes and MutationObserver
+ * on <body> to catch DOM additions/removals that may shrink the page without a resize.
+ * Measurement reads `body.offsetHeight`, which tracks actual content height and
+ * decreases correctly after DOM removals, unaffected by CSS min-height on the html element.
+ */
+export declare function observeDocumentHeight({ onHeightChange, documentRef, windowRef, debounceMs }: ObserveDocumentHeightOptions): DocumentHeightObserverHandle;

package/src/script/utils.d.ts

@@ -51,3 +51,40 @@ export declare function setClientIsReady(config?: DotCMSPageResponse): void;
 export declare function listenBlockEditorInlineEvent(): {
     destroyListenBlockEditorInlineEvent: () => void;
 };
+/**
+ * Returns whether iframe height must be synchronized via postMessage.
+ *
+ * Same-origin parents can measure iframe content directly, so they do not need
+ * child-driven height reporting. Cross-origin parents cannot access the iframe
+ * DOM, so they still need the reporter fallback.
+ */
+export declare function shouldReportIframeHeightToParent(): boolean;
+/**
+ * Reports the iframe document height to the parent UVE shell via postMessage.
+ *
+ * Uses ResizeObserver on <html> for viewport/font/image-driven size changes, and
+ * MutationObserver on <body> to catch DOM removals (e.g. contentlets deleted by
+ * the editor) that shrink the page without triggering a resize event.
+ *
+ * Measurement reads `document.documentElement.offsetHeight` — the actual rendered
+ * height of the <html> element after layout. `scrollHeight` is intentionally avoided
+ * because it does not reliably decrease when content is removed from the DOM.
+ *
+ * Height sends are coalesced to at most one per double-requestAnimationFrame pair
+ * so they always run after layout and paint have settled.
+ *
+ * @returns {{ destroyHeightReporter: () => void }} Cleanup function that removes
+ * all listeners and disconnects the observers.
+ */
+export declare function reportIframeHeight(): {
+    destroyHeightReporter: () => void;
+};
+/**
+ * Injects UVE editor styles for empty containers and contentlets into the page.
+ * Provides visual placeholders so editors can identify and interact with empty areas.
+ *
+ * The empty-container label is read from the dotCMS i18n cache in localStorage
+ * (`dotMessagesKeys`). Falls back to 'Empty container' if the cache is unavailable
+ * (e.g. headless pages on a different origin).
+ */
+export declare function injectEmptyStateStyles(): void;