@dotcms/uve 1.5.6 → 1.6.0-next.36

package/README.md

@@ -2,7 +2,7 @@
 
 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
@@ -17,11 +17,11 @@ With `@dotcms/uve`, framework SDKs are able to:
     -   [🚩 Custom Setup: Manual Rendering (Not Recommended)](#-custom-setup-manual-rendering-not-recommended)
 -   [Prerequisites & Setup](#prerequisites--setup)
     -   [Get a dotCMS Environment](#get-a-dotcms-environment)
-    -   [Create a dotCMS API Key](#create-a-dotcms-api-key)
+    -   [Configure The Universal Visual Editor App](#configure-the-universal-visual-editor-app)
     -   [Installation](#installation)
     -   [Using the SDK with TypeScript](#using-the-sdk-with-typescript)
 -   [SDK Reference](#sdk-reference)
-    -   [`initUVE()`](#inituveconfig-dotcmsuveconfig)
+    -   [`initUVE()`](#inituveconfig-dotcmspageresponse)
     -   [`getUVEState()`](#getuvestate)
     -   [`createUVESubscription()`](#createuvesubscriptioneventtype-callback)
     -   [`editContentlet()`](#editcontentletcontentlet)
@@ -49,7 +49,7 @@ With `@dotcms/uve`, framework SDKs are able to:
 We strongly recommend using one of our official framework SDKs, which are designed to handle UVE integration, routing, rendering, and more—out of the box. These examples are the best way to get started:
 
 -   [dotCMS Angular SDK: Angular Example](https://github.com/dotCMS/core/tree/main/examples/angular) – Ideal for Angular apps 🅰️
--   [dotCMS React SDK: NextJS Example](https://github.com/dotCMS/core/tree/main/examples/react) – Ideal for NextJS projects ⚛️
+-   [dotCMS React SDK: NextJS Example](https://github.com/dotCMS/core/tree/main/examples/nextjs) – Ideal for NextJS projects ⚛️
 -   [dotCMS React SDK: Astro Example](https://github.com/dotCMS/core/tree/main/examples/astro) – Ideal for Astro projects 🌌
 
 These examples handle UVE integration, routing, rendering, and more—out of the box. **If you're building a headless dotCMS front-end, start there.**
@@ -66,7 +66,7 @@ You can use `@dotcms/uve` directly, but **it’s not recommended or supported**
 
 Here's a minimal setup using `@dotcms/client` and `@dotcms/uve`:
 
-1. Initializa the Client and get the page response:
+1. Initialize the Client and get the page response:
 
 ```ts
 // getPage.ts
@@ -94,12 +94,13 @@ const getPage = async () => {
 
 ```ts
 import { initUVE, createUVESubscription } from '@dotcms/uve';
+import { UVEEventType } from '@dotcms/types';
 import { getPage } from './getPage';
 
 const pageResponse = await getPage();
 
 initUVE(pageResponse);
-createUVESubscription('changes', (newPageResponse) => {
+createUVESubscription(UVEEventType.CONTENT_CHANGES, (newPageResponse) => {
     // Handle page updates (e.g. re-render)
 });
 ```
@@ -118,7 +119,7 @@ createUVESubscription('changes', (newPageResponse) => {
 #### 🔄 How to Render a dotCMS Page
 
 > 📚 For a complete guide, here is a full tutorial:
-> 👉 [dotCMS Page Rendering Architecture]( https://dev.dotcms.com/docs/dotcms-page-rendering-architecture)
+> 👉 [dotCMS Page Rendering Architecture](https://dev.dotcms.com/docs/dotcms-page-rendering-architecture)
 
 dotCMS pages are structured as nested layout objects:
 
@@ -218,7 +219,6 @@ The SDK uses several key types from `@dotcms/types`:
 import {
     DotCMSBasicContentlet,
     DotCMSPageResponse,
-    DotCMSUVEConfig,
     DotCMSInlineEditingType,
     UVEEventType,
     UVEState
@@ -229,7 +229,7 @@ For a complete reference of all available types and interfaces, please refer to
 
 ## SDK Reference
 
-### `initUVE(config?: DotCMSUVEConfig)`
+### `initUVE(config?: DotCMSPageResponse)`
 
 `initUVE` is a function that initializes the Universal Visual Editor (UVE). It sets up the necessary communication between your app and the editor, enabling seamless integration and interaction.
 
@@ -243,7 +243,7 @@ For a complete reference of all available types and interfaces, please refer to
 const { destroyUVESubscriptions } = initUVE(pageResponse);
 ```
 
-> ⚠️ If you don't provide a `pageResponse`, we can't assure that the UVE will be initialized correctly.
+> ⚠️ If you don't provide a `pageResponse`, we cannot guarantee that the UVE will be initialized correctly.
 
 ### `getUVEState()`
 
@@ -303,14 +303,16 @@ sub.unsubscribe();
 
 -   `UVEEventType.CONTENT_CHANGES`: Triggered when the content of the page changes.
 -   `UVEEventType.PAGE_RELOAD`: Triggered when the page is reloaded.
--   `UVEEventType.REQUEST_BOUNDS`: Triggered when the editor requests the bounds of the page.
--   `UVEEventType.IFRAME_SCROLL`: Triggered when the iframe is scrolled.
--   `UVEEventType.IFRAME_SCROLL_END`: Triggered when the iframe has stopped scrolling.
+-   `UVEEventType.IFRAME_SCROLL`: Triggered when scroll action is needed inside the iframe (`'up'` or `'down'`).
 -   `UVEEventType.CONTENTLET_HOVERED`: Triggered when a contentlet is hovered.
+-   `UVEEventType.CONTENTLET_CLICKED`: Triggered when a contentlet is clicked.
+-   `UVEEventType.AUTO_BOUNDS`: Triggered when the SDK syncs page bounds after layout changes (internal SDK use).
+-   `UVEEventType.SCROLL_TO_SECTION`: Triggered when the editor requests a scroll to a specific page section (internal).
+-   `UVEEventType.SELECTION_CLEARED`: Triggered when the editor clears its selection (internal).
 
 ### `editContentlet(contentlet)`
 
-`editContentlet` is a function that opens the dotCMS modal editor for any contentlet in or out of page area.
+`editContentlet` is a function that opens the dotCMS modal editor for any contentlet in or out of the page area.
 
 | Input        | Type               | Required | Description                      |
 | ------------ | ------------------ | -------- | -------------------------------- |
@@ -340,7 +342,7 @@ const myEditButton = ({ contentlet }) => {
 | Input       | Type                         | Required | Description                                                                    |
 | ----------- | ---------------------------- | -------- | ------------------------------------------------------------------------------ |
 | `type`      | `DotCMSInlineEditingType`    | ✅       | `'BLOCK_EDITOR'` or `'WYSIWYG'`                                                |
-| `fieldData` | `DotCMSInlineEditingPayload` | ✅       | [Field content required to enable inline editing](#dotcmsinlineeditingpayload) |
+| `data`      | `DotCMSInlineEditingPayload` | ✅       | [Field content required to enable inline editing](#dotcmsinlineeditingpayload) |
 
 #### Usage
 
@@ -449,7 +451,7 @@ reorderMenu({ startLevel: 2, depth: 3 });
 
 | Input     | Type                                       | Required | Description                  |
 | --------- | ------------------------------------------ | -------- | ---------------------------- |
-| `message` | [`DotCMSUVEMessage<T>`](#dotcmsuvemessage) | ✅       | Object with action + payload |
+| `message` | [`DotCMSUVEMessage<T>`](#dotcmsuvemessaget) | ✅       | Object with action + payload |
 
 #### Usage
 
@@ -488,7 +490,7 @@ Style editor schemas are configured in the DotCMS admin UI under **Content Types
 **Key Benefits:**
 
 -   **Real-Time Visual Editing**: Modify component styles and see changes instantly in the editor
--   **Content-Specific Customization**: Different content types can have unique style schemas, and the same contentlet could have different styles depending on if it is located in a different container or page
+-   **Content-Specific Customization**: Different content types can have unique style schemas, and the same contentlet could have different styles depending on whether it is located in a different container or page
 -   **Admin-Managed**: Style schemas are defined in the DotCMS admin UI under Content Types and fetched automatically by the SDK
 
 **Use Cases:**
@@ -627,7 +629,7 @@ When **defining styles** for a contentlet within a page using **Style Editor**,
 
 > **NOTE:** (🎨 Styles are different) means the capability to define distinct styles, even when utilizing the identical Contentlet.
 
-The only known limitation is that moving a contentlet with defined styles between different container types (5th scenario), results in the loss of those styles. See the [technical details document](https://docs.google.com/document/d/1UiuJlIn8ZjybIB-0oHeoTLXZo1k-YExITEqEMfyvVlU/edit?tab=t.0) for our planned solution.
+The only known limitation is that moving a contentlet with defined styles between different container types (5th scenario) results in the loss of those styles. A fix for this scenario is on our roadmap.
 
 ## Troubleshooting
 
@@ -713,7 +715,7 @@ We offer multiple channels to get help with the dotCMS UVE SDK:
 -   **GitHub Issues**: For bug reports and feature requests, please [open an issue](https://github.com/dotCMS/core/issues/new/choose) in the GitHub repository
 -   **Community Forum**: Join our [community discussions](https://community.dotcms.com/) to ask questions and share solutions
 -   **Stack Overflow**: Use the tag `dotcms-uve` when posting questions
--   **Enterprise Support**: Enterprise customers can access premium support through the [dotCMS Support Portal](https://helpdesk.dotcms.com/support/)
+-   **Enterprise Support**: Enterprise customers can access premium support through the [dotCMS Support Portal](https://www.dotcms.com/support)
 
 When reporting issues, please include:
 

package/index.esm.js

@@ -1,3 +1,3 @@
-export { c as createContentlet, a as createUVESubscription, e as editContentlet, b as enableBlockEditorInline, g as getUVEState, i as initInlineEditing, d as initUVE, r as reorderMenu, s as sendMessageToUVE, u as updateNavigation } from './public.esm.js';
+export { b as createContentlet, c as createUVESubscription, e as editContentlet, a as enableBlockEditorInline, g as getUVEState, i as initInlineEditing, d as initUVE, r as reorderMenu, s as sendMessageToUVE, u as updateNavigation } from './public.esm.js';
 import '@dotcms/types';
 import '@dotcms/types/internal';

package/internal.cjs.js

@@ -370,6 +370,8 @@ const styleEditorField = {
   })
 };
 
+exports.ANALYTICS_ACTIVE_WINDOW_KEY = _public.ANALYTICS_ACTIVE_WINDOW_KEY;
+exports.ANALYTICS_READY_EVENT = _public.ANALYTICS_READY_EVENT;
 exports.CUSTOM_NO_COMPONENT = _public.CUSTOM_NO_COMPONENT;
 exports.DEVELOPMENT_MODE = _public.DEVELOPMENT_MODE;
 exports.DOT_SECTION_ID_PREFIX = _public.DOT_SECTION_ID_PREFIX;
@@ -387,6 +389,7 @@ exports.computeScrollIsInBottom = _public.computeScrollIsInBottom;
 exports.createUVESubscription = _public.createUVESubscription;
 exports.findDotCMSElement = _public.findDotCMSElement;
 exports.findDotCMSVTLData = _public.findDotCMSVTLData;
+exports.getAnalyticsContentletAttributes = _public.getAnalyticsContentletAttributes;
 exports.getClosestDotCMSContainerData = _public.getClosestDotCMSContainerData;
 exports.getColumnPositionClasses = _public.getColumnPositionClasses;
 exports.getContainersData = _public.getContainersData;
@@ -396,7 +399,9 @@ exports.getDotCMSContentletsBound = _public.getDotCMSContentletsBound;
 exports.getDotCMSPageBounds = _public.getDotCMSPageBounds;
 exports.getDotContainerAttributes = _public.getDotContainerAttributes;
 exports.getDotContentletAttributes = _public.getDotContentletAttributes;
+exports.getNativeEventBinder = _public.getNativeEventBinder;
 exports.getUVEState = _public.getUVEState;
+exports.isDotAnalyticsActive = _public.isDotAnalyticsActive;
 exports.isValidBlocks = _public.isValidBlocks;
 exports.readContentletDataset = _public.readContentletDataset;
 exports.setBounds = _public.setBounds;

package/internal.esm.js

@@ -1,5 +1,5 @@
 import { g as getUVEState, s as sendMessageToUVE } 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, T as TEMP_EMPTY_CONTENTLET, k as TEMP_EMPTY_CONTENTLET_TYPE, _ as __UVE_EVENTS__, l as __UVE_EVENT_ERROR_FALLBACK__, m as combineClasses, n as computeScrollIsInBottom, a as createUVESubscription, o as findDotCMSElement, p as findDotCMSVTLData, q as getClosestDotCMSContainerData, t as getColumnPositionClasses, v as getContainersData, w as getContentletsInContainer, x as getDotCMSContainerData, y as getDotCMSContentletsBound, z as getDotCMSPageBounds, A as getDotContainerAttributes, B as getDotContentletAttributes, F as isValidBlocks, G as readContentletDataset, H as setBounds } from './public.esm.js';
+export { A as ANALYTICS_ACTIVE_WINDOW_KEY, l as ANALYTICS_READY_EVENT, C as CUSTOM_NO_COMPONENT, D as DEVELOPMENT_MODE, k as DOT_SECTION_ID_PREFIX, j as EMPTY_CONTAINER_STYLE_ANGULAR, h as EMPTY_CONTAINER_STYLE_REACT, E as END_CLASS, P as PRODUCTION_MODE, S as START_CLASS, T as TEMP_EMPTY_CONTENTLET, m as TEMP_EMPTY_CONTENTLET_TYPE, _ as __UVE_EVENTS__, f as __UVE_EVENT_ERROR_FALLBACK__, x as combineClasses, w as computeScrollIsInBottom, c as createUVESubscription, t as findDotCMSElement, v as findDotCMSVTLData, B as getAnalyticsContentletAttributes, q as getClosestDotCMSContainerData, y as getColumnPositionClasses, G as getContainersData, H as getContentletsInContainer, p as getDotCMSContainerData, o as getDotCMSContentletsBound, n as getDotCMSPageBounds, I as getDotContainerAttributes, z as getDotContentletAttributes, K as getNativeEventBinder, F as isDotAnalyticsActive, M as isValidBlocks, J as readContentletDataset, L as setBounds } from './public.esm.js';
 import { UVE_MODE, DotCMSUVEAction } from '@dotcms/types';
 import '@dotcms/types/internal';
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dotcms/uve",
-  "version": "1.5.6",
+  "version": "1.6.0-next.36",
   "description": "Official JavaScript library for interacting with Universal Visual Editor (UVE)",
   "repository": {
     "type": "git",
@@ -50,4 +50,4 @@
   "module": "./index.esm.js",
   "main": "./index.cjs.js",
   "types": "./index.d.ts"
-}
+}

package/public.cjs.js

@@ -257,6 +257,38 @@ function getDotContentletAttributes(contentlet, container) {
     })
   };
 }
+/**
+ *
+ * Returns the minimal set of contentlet data attributes required by DotCMS
+ * Analytics (impression & click tracking) to identify a contentlet.
+ *
+ * Used in live mode where the full editor metadata is stripped but Analytics
+ * still needs to resolve the contentlet behind an impression/click.
+ *
+ * @param {DotCMSBasicContentlet} contentlet - The contentlet to get the attributes for
+ * @returns {DotAnalyticsContentletAttributes} The Analytics-required data attributes
+ */
+function getAnalyticsContentletAttributes(contentlet) {
+  return {
+    'data-dot-identifier': contentlet?.identifier,
+    'data-dot-inode': contentlet?.inode,
+    'data-dot-title': contentlet?.['widgetTitle'] || contentlet?.title,
+    'data-dot-type': contentlet?.contentType,
+    'data-dot-basetype': contentlet?.baseType
+  };
+}
+/**
+ *
+ * Checks whether DotCMS Analytics is initialized and active on the page.
+ *
+ * The SDKs use this in live mode to decide whether to keep the minimal
+ * contentlet attributes Analytics depends on.
+ *
+ * @returns {boolean} `true` when analytics is active, otherwise `false`
+ */
+function isDotAnalyticsActive() {
+  return typeof window !== 'undefined' && window[ANALYTICS_ACTIVE_WINDOW_KEY] === true;
+}
 /**
  *
  *
@@ -377,6 +409,38 @@ function readContentletDataset(element) {
     })
   };
 }
+/**
+ * Returns Zone.js's *unpatched* native `addEventListener` / `removeEventListener`
+ * bound to `target`, falling back to the standard methods when Zone.js is absent.
+ *
+ * UVE reuses a single iframe and rewrites it with `document.open()/write()/close()`
+ * on every in-editor navigation. When Zone.js is loaded inside that iframe it runs
+ * in global-events mode: one native "gateway" listener per (target, eventType)
+ * plus a JS-level task list stored on the target node. `document.open()` tears down
+ * the native gateway on the persistent `window`/`document` nodes, but the task list
+ * survives on them, so Zone sees "already registered" on re-init and skips
+ * re-installing the native gateway — the listener silently goes dead after the
+ * first navigation.
+ *
+ * Hover/click dodge this by binding to `document.documentElement`, a node that
+ * `write()` recreates fresh. `scroll`/`message` (on `window`) and
+ * `DOMContentLoaded` (on `document`) can't: none of them fire on `<html>`, so
+ * there is no fresh node to rebind to. Going through Zone's native (untracked)
+ * methods sidesteps the dedup entirely, so the listener rebinds cleanly after
+ * every rewrite.
+ */
+function getNativeEventBinder(target) {
+  const zone = globalThis.Zone;
+  const symbolFor = name => typeof zone?.__symbol__ === 'function' ? zone.__symbol__(name) : `__zone_symbol__${name}`;
+  const source = target;
+  const base = target;
+  const nativeAdd = source[symbolFor('addEventListener')];
+  const nativeRemove = source[symbolFor('removeEventListener')];
+  return {
+    addEventListener: (nativeAdd ?? base.addEventListener).bind(base),
+    removeEventListener: (nativeRemove ?? base.removeEventListener).bind(base)
+  };
+}
 
 /**
  * Subscribes to content changes in the UVE editor
@@ -393,10 +457,12 @@ function onContentChanges(callback) {
       callback(event.data.payload);
     }
   };
-  window.addEventListener('message', messageCallback);
+  // Native binder: survives the iframe rewrite under Zone.js. See getNativeEventBinder.
+  const nativeWindow = getNativeEventBinder(window);
+  nativeWindow.addEventListener('message', messageCallback);
   return {
     unsubscribe: () => {
-      window.removeEventListener('message', messageCallback);
+      nativeWindow.removeEventListener('message', messageCallback);
     },
     event: types.UVEEventType.CONTENT_CHANGES
   };
@@ -416,10 +482,12 @@ function onPageReload(callback) {
       callback();
     }
   };
-  window.addEventListener('message', messageCallback);
+  // Native binder: survives the iframe rewrite under Zone.js. See getNativeEventBinder.
+  const nativeWindow = getNativeEventBinder(window);
+  nativeWindow.addEventListener('message', messageCallback);
   return {
     unsubscribe: () => {
-      window.removeEventListener('message', messageCallback);
+      nativeWindow.removeEventListener('message', messageCallback);
     },
     event: types.UVEEventType.PAGE_RELOAD
   };
@@ -507,13 +575,13 @@ function onAutoBounds(callback) {
     childList: true,
     subtree: true
   });
-  // Scrolling inside the iframe doesn't change layout, so ResizeObserver
-  // doesn't fire, but every contentlet's viewport-relative position
-  // (getBoundingClientRect) does change. Re-emit bounds after each
-  // scroll burst settles so the editor's pinned selected overlay
-  // re-anchors to the on-screen position.
+  // Scrolling doesn't change layout (ResizeObserver won't fire) but moves
+  // every contentlet, so re-emit bounds after the scroll settles to re-anchor
+  // the selected overlay. Native binder so it survives the iframe rewrite
+  // under Zone.js. See getNativeEventBinder.
+  const nativeWindow = getNativeEventBinder(window);
   const onScroll = () => scheduleEmit();
-  window.addEventListener('scroll', onScroll, {
+  nativeWindow.addEventListener('scroll', onScroll, {
     passive: true
   });
   // Flush channel: the editor occasionally needs an immediate snapshot
@@ -528,7 +596,8 @@ function onAutoBounds(callback) {
     }
     emit();
   };
-  window.addEventListener('message', onFlush);
+  // Native binder (reused from `scroll` above): survives the iframe rewrite too.
+  nativeWindow.addEventListener('message', onFlush);
   return {
     unsubscribe: () => {
       if (debounceTimer !== null) {
@@ -537,8 +606,8 @@ function onAutoBounds(callback) {
       }
       resizeObserver.disconnect();
       mutationObserver.disconnect();
-      window.removeEventListener('scroll', onScroll);
-      window.removeEventListener('message', onFlush);
+      nativeWindow.removeEventListener('scroll', onScroll);
+      nativeWindow.removeEventListener('message', onFlush);
       observed = [];
     },
     event: types.UVEEventType.AUTO_BOUNDS
@@ -560,10 +629,12 @@ function onIframeScroll(callback) {
       callback(direction);
     }
   };
-  window.addEventListener('message', messageCallback);
+  // Native binder: survives the iframe rewrite under Zone.js. See getNativeEventBinder.
+  const nativeWindow = getNativeEventBinder(window);
+  nativeWindow.addEventListener('message', messageCallback);
   return {
     unsubscribe: () => {
-      window.removeEventListener('message', messageCallback);
+      nativeWindow.removeEventListener('message', messageCallback);
     },
     event: types.UVEEventType.IFRAME_SCROLL
   };
@@ -593,10 +664,12 @@ function onScrollToSection(callback) {
       offsetTop: el.offsetTop
     });
   };
-  window.addEventListener('message', messageCallback);
+  // Native binder: survives the iframe rewrite under Zone.js. See getNativeEventBinder.
+  const nativeWindow = getNativeEventBinder(window);
+  nativeWindow.addEventListener('message', messageCallback);
   return {
     unsubscribe: () => {
-      window.removeEventListener('message', messageCallback);
+      nativeWindow.removeEventListener('message', messageCallback);
     },
     event: types.UVEEventType.SCROLL_TO_SECTION
   };
@@ -666,16 +739,18 @@ function onContentletHovered(callback) {
     hasHover = true;
     callback(contentletHoveredPayload);
   };
-  // We intentionally do not fire null on document `pointerleave`: the
-  // editor's hover toolbar lives in the parent window (outside the
-  // iframe), so leaving the iframe usually means the user is heading
-  // for the toolbar. Killing the overlay there would yank the toolbar
-  // away just as the user reaches for it. Dead-space-inside-iframe
-  // is already covered by the `pointermove` null branch above.
-  document.addEventListener('pointermove', pointerMoveCallback);
+  // We intentionally do not fire null on `pointerleave`: the editor's hover
+  // toolbar lives in the parent window, so leaving the iframe usually means
+  // the user is reaching for it — killing the overlay would yank it away.
+  //
+  // Bind to `document.documentElement` (a fresh node on each iframe rewrite)
+  // rather than `document`, which goes dead under Zone.js after a rewrite.
+  // `pointermove` bubbles to <html>, so no-Zone behavior is identical. See
+  // getNativeEventBinder for the full rationale.
+  document.documentElement.addEventListener('pointermove', pointerMoveCallback);
   return {
     unsubscribe: () => {
-      document.removeEventListener('pointermove', pointerMoveCallback);
+      document.documentElement.removeEventListener('pointermove', pointerMoveCallback);
     },
     event: types.UVEEventType.CONTENTLET_HOVERED
   };
@@ -749,18 +824,22 @@ function onContentletClicked(callback) {
       lastSelectedInode = undefined;
     }
   };
-  // Capture phase so we run BEFORE the page's own click handlers and can
-  // preventDefault/stopPropagation effectively.
-  document.addEventListener('click', clickCallback, {
+  // Capture phase so we run BEFORE the page's own click handlers. Bound to
+  // `document.documentElement` (a fresh node on each iframe rewrite) rather
+  // than `document`, which goes dead under Zone.js after a rewrite; capture on
+  // <html> still runs first. See getNativeEventBinder for the full rationale.
+  document.documentElement.addEventListener('click', clickCallback, {
     capture: true
   });
-  window.addEventListener('message', selectionClearedCallback);
+  // Native binder: survives the iframe rewrite under Zone.js. See getNativeEventBinder.
+  const nativeWindow = getNativeEventBinder(window);
+  nativeWindow.addEventListener('message', selectionClearedCallback);
   return {
     unsubscribe: () => {
-      document.removeEventListener('click', clickCallback, {
+      document.documentElement.removeEventListener('click', clickCallback, {
         capture: true
       });
-      window.removeEventListener('message', selectionClearedCallback);
+      nativeWindow.removeEventListener('message', selectionClearedCallback);
     },
     event: types.UVEEventType.CONTENTLET_CLICKED
   };
@@ -885,6 +964,29 @@ const CUSTOM_NO_COMPONENT = 'CustomNoComponent';
  * @internal
  */
 const DOT_SECTION_ID_PREFIX = 'dot-section-';
+/**
+ * Window flag set by `@dotcms/analytics` when content analytics is initialized
+ * and active on the page.
+ *
+ * @important This value is intentionally duplicated from `@dotcms/analytics`
+ * (`ANALYTICS_WINDOWS_ACTIVE_KEY` in dot-analytics.constants.ts). The SDKs read
+ * it in live mode to decide whether to keep the minimal contentlet attributes
+ * Analytics depends on. Both constants MUST stay in sync.
+ *
+ * @internal
+ */
+const ANALYTICS_ACTIVE_WINDOW_KEY = '__dotAnalyticsActive__';
+/**
+ * Event dispatched by `@dotcms/analytics` once analytics is ready. The SDKs
+ * listen for it so live-mode contentlets can re-render with the attributes
+ * Analytics needs, regardless of initialization order.
+ *
+ * @important Kept in sync with the `dotcms:analytics:ready` event dispatched by
+ * `@dotcms/analytics` (initializeContentAnalytics).
+ *
+ * @internal
+ */
+const ANALYTICS_READY_EVENT = 'dotcms:analytics:ready';
 
 /**
  * Gets the current state of the Universal Visual Editor (UVE).
@@ -1073,7 +1175,6 @@ const isValidBlocks = blocks => {
   };
 };
 
-/* eslint-disable @typescript-eslint/no-explicit-any */
 /**
  * Sets up scroll event handlers for the window to notify the editor about scroll events.
  * Adds listeners for both 'scroll' and 'scrollend' events, sending appropriate messages
@@ -1090,12 +1191,19 @@ function scrollHandler() {
       action: types.DotCMSUVEAction.IFRAME_SCROLL_END
     });
   };
-  window.addEventListener('scroll', scrollCallback);
-  window.addEventListener('scrollend', scrollEndCallback);
+  // Native binder: scroll survives the iframe rewrite under Zone.js. It can't
+  // move to a fresh `documentElement` like hover/click (viewport scroll only
+  // fires on `window`). See getNativeEventBinder.
+  const {
+    addEventListener,
+    removeEventListener
+  } = getNativeEventBinder(window);
+  addEventListener('scroll', scrollCallback);
+  addEventListener('scrollend', scrollEndCallback);
   return {
     destroyScrollHandler: () => {
-      window.removeEventListener('scroll', scrollCallback);
-      window.removeEventListener('scrollend', scrollEndCallback);
+      removeEventListener('scroll', scrollCallback);
+      removeEventListener('scrollend', scrollEndCallback);
     }
   };
 }
@@ -1209,14 +1317,19 @@ function listenBlockEditorInlineEvent() {
       }
     };
   }
-  // If the page is not fully loaded, listen for the DOMContentLoaded event
+  // Native binder: `DOMContentLoaded` fires on `document` (not `<html>`), so
+  // it survives the iframe rewrite under Zone.js. See getNativeEventBinder.
   const handleDOMContentLoaded = () => {
     listenBlockEditorClick();
   };
-  document.addEventListener('DOMContentLoaded', handleDOMContentLoaded);
+  const {
+    addEventListener,
+    removeEventListener
+  } = getNativeEventBinder(document);
+  addEventListener('DOMContentLoaded', handleDOMContentLoaded);
   return {
     destroyListenBlockEditorInlineEvent: () => {
-      document.removeEventListener('DOMContentLoaded', handleDOMContentLoaded);
+      removeEventListener('DOMContentLoaded', handleDOMContentLoaded);
     }
   };
 }
@@ -1434,6 +1547,8 @@ function initUVE(config = {}) {
   };
 }
 
+exports.ANALYTICS_ACTIVE_WINDOW_KEY = ANALYTICS_ACTIVE_WINDOW_KEY;
+exports.ANALYTICS_READY_EVENT = ANALYTICS_READY_EVENT;
 exports.CUSTOM_NO_COMPONENT = CUSTOM_NO_COMPONENT;
 exports.DEVELOPMENT_MODE = DEVELOPMENT_MODE;
 exports.DOT_SECTION_ID_PREFIX = DOT_SECTION_ID_PREFIX;
@@ -1454,6 +1569,7 @@ exports.editContentlet = editContentlet;
 exports.enableBlockEditorInline = enableBlockEditorInline;
 exports.findDotCMSElement = findDotCMSElement;
 exports.findDotCMSVTLData = findDotCMSVTLData;
+exports.getAnalyticsContentletAttributes = getAnalyticsContentletAttributes;
 exports.getClosestDotCMSContainerData = getClosestDotCMSContainerData;
 exports.getColumnPositionClasses = getColumnPositionClasses;
 exports.getContainersData = getContainersData;
@@ -1463,9 +1579,11 @@ exports.getDotCMSContentletsBound = getDotCMSContentletsBound;
 exports.getDotCMSPageBounds = getDotCMSPageBounds;
 exports.getDotContainerAttributes = getDotContainerAttributes;
 exports.getDotContentletAttributes = getDotContentletAttributes;
+exports.getNativeEventBinder = getNativeEventBinder;
 exports.getUVEState = getUVEState;
 exports.initInlineEditing = initInlineEditing;
 exports.initUVE = initUVE;
+exports.isDotAnalyticsActive = isDotAnalyticsActive;
 exports.isValidBlocks = isValidBlocks;
 exports.readContentletDataset = readContentletDataset;
 exports.reorderMenu = reorderMenu;

package/public.esm.js

@@ -255,6 +255,38 @@ function getDotContentletAttributes(contentlet, container) {
     })
   };
 }
+/**
+ *
+ * Returns the minimal set of contentlet data attributes required by DotCMS
+ * Analytics (impression & click tracking) to identify a contentlet.
+ *
+ * Used in live mode where the full editor metadata is stripped but Analytics
+ * still needs to resolve the contentlet behind an impression/click.
+ *
+ * @param {DotCMSBasicContentlet} contentlet - The contentlet to get the attributes for
+ * @returns {DotAnalyticsContentletAttributes} The Analytics-required data attributes
+ */
+function getAnalyticsContentletAttributes(contentlet) {
+  return {
+    'data-dot-identifier': contentlet?.identifier,
+    'data-dot-inode': contentlet?.inode,
+    'data-dot-title': contentlet?.['widgetTitle'] || contentlet?.title,
+    'data-dot-type': contentlet?.contentType,
+    'data-dot-basetype': contentlet?.baseType
+  };
+}
+/**
+ *
+ * Checks whether DotCMS Analytics is initialized and active on the page.
+ *
+ * The SDKs use this in live mode to decide whether to keep the minimal
+ * contentlet attributes Analytics depends on.
+ *
+ * @returns {boolean} `true` when analytics is active, otherwise `false`
+ */
+function isDotAnalyticsActive() {
+  return typeof window !== 'undefined' && window[ANALYTICS_ACTIVE_WINDOW_KEY] === true;
+}
 /**
  *
  *
@@ -375,6 +407,38 @@ function readContentletDataset(element) {
     })
   };
 }
+/**
+ * Returns Zone.js's *unpatched* native `addEventListener` / `removeEventListener`
+ * bound to `target`, falling back to the standard methods when Zone.js is absent.
+ *
+ * UVE reuses a single iframe and rewrites it with `document.open()/write()/close()`
+ * on every in-editor navigation. When Zone.js is loaded inside that iframe it runs
+ * in global-events mode: one native "gateway" listener per (target, eventType)
+ * plus a JS-level task list stored on the target node. `document.open()` tears down
+ * the native gateway on the persistent `window`/`document` nodes, but the task list
+ * survives on them, so Zone sees "already registered" on re-init and skips
+ * re-installing the native gateway — the listener silently goes dead after the
+ * first navigation.
+ *
+ * Hover/click dodge this by binding to `document.documentElement`, a node that
+ * `write()` recreates fresh. `scroll`/`message` (on `window`) and
+ * `DOMContentLoaded` (on `document`) can't: none of them fire on `<html>`, so
+ * there is no fresh node to rebind to. Going through Zone's native (untracked)
+ * methods sidesteps the dedup entirely, so the listener rebinds cleanly after
+ * every rewrite.
+ */
+function getNativeEventBinder(target) {
+  const zone = globalThis.Zone;
+  const symbolFor = name => typeof zone?.__symbol__ === 'function' ? zone.__symbol__(name) : `__zone_symbol__${name}`;
+  const source = target;
+  const base = target;
+  const nativeAdd = source[symbolFor('addEventListener')];
+  const nativeRemove = source[symbolFor('removeEventListener')];
+  return {
+    addEventListener: (nativeAdd ?? base.addEventListener).bind(base),
+    removeEventListener: (nativeRemove ?? base.removeEventListener).bind(base)
+  };
+}
 
 /**
  * Subscribes to content changes in the UVE editor
@@ -391,10 +455,12 @@ function onContentChanges(callback) {
       callback(event.data.payload);
     }
   };
-  window.addEventListener('message', messageCallback);
+  // Native binder: survives the iframe rewrite under Zone.js. See getNativeEventBinder.
+  const nativeWindow = getNativeEventBinder(window);
+  nativeWindow.addEventListener('message', messageCallback);
   return {
     unsubscribe: () => {
-      window.removeEventListener('message', messageCallback);
+      nativeWindow.removeEventListener('message', messageCallback);
     },
     event: UVEEventType.CONTENT_CHANGES
   };
@@ -414,10 +480,12 @@ function onPageReload(callback) {
       callback();
     }
   };
-  window.addEventListener('message', messageCallback);
+  // Native binder: survives the iframe rewrite under Zone.js. See getNativeEventBinder.
+  const nativeWindow = getNativeEventBinder(window);
+  nativeWindow.addEventListener('message', messageCallback);
   return {
     unsubscribe: () => {
-      window.removeEventListener('message', messageCallback);
+      nativeWindow.removeEventListener('message', messageCallback);
     },
     event: UVEEventType.PAGE_RELOAD
   };
@@ -505,13 +573,13 @@ function onAutoBounds(callback) {
     childList: true,
     subtree: true
   });
-  // Scrolling inside the iframe doesn't change layout, so ResizeObserver
-  // doesn't fire, but every contentlet's viewport-relative position
-  // (getBoundingClientRect) does change. Re-emit bounds after each
-  // scroll burst settles so the editor's pinned selected overlay
-  // re-anchors to the on-screen position.
+  // Scrolling doesn't change layout (ResizeObserver won't fire) but moves
+  // every contentlet, so re-emit bounds after the scroll settles to re-anchor
+  // the selected overlay. Native binder so it survives the iframe rewrite
+  // under Zone.js. See getNativeEventBinder.
+  const nativeWindow = getNativeEventBinder(window);
   const onScroll = () => scheduleEmit();
-  window.addEventListener('scroll', onScroll, {
+  nativeWindow.addEventListener('scroll', onScroll, {
     passive: true
   });
   // Flush channel: the editor occasionally needs an immediate snapshot
@@ -526,7 +594,8 @@ function onAutoBounds(callback) {
     }
     emit();
   };
-  window.addEventListener('message', onFlush);
+  // Native binder (reused from `scroll` above): survives the iframe rewrite too.
+  nativeWindow.addEventListener('message', onFlush);
   return {
     unsubscribe: () => {
       if (debounceTimer !== null) {
@@ -535,8 +604,8 @@ function onAutoBounds(callback) {
       }
       resizeObserver.disconnect();
       mutationObserver.disconnect();
-      window.removeEventListener('scroll', onScroll);
-      window.removeEventListener('message', onFlush);
+      nativeWindow.removeEventListener('scroll', onScroll);
+      nativeWindow.removeEventListener('message', onFlush);
       observed = [];
     },
     event: UVEEventType.AUTO_BOUNDS
@@ -558,10 +627,12 @@ function onIframeScroll(callback) {
       callback(direction);
     }
   };
-  window.addEventListener('message', messageCallback);
+  // Native binder: survives the iframe rewrite under Zone.js. See getNativeEventBinder.
+  const nativeWindow = getNativeEventBinder(window);
+  nativeWindow.addEventListener('message', messageCallback);
   return {
     unsubscribe: () => {
-      window.removeEventListener('message', messageCallback);
+      nativeWindow.removeEventListener('message', messageCallback);
     },
     event: UVEEventType.IFRAME_SCROLL
   };
@@ -591,10 +662,12 @@ function onScrollToSection(callback) {
       offsetTop: el.offsetTop
     });
   };
-  window.addEventListener('message', messageCallback);
+  // Native binder: survives the iframe rewrite under Zone.js. See getNativeEventBinder.
+  const nativeWindow = getNativeEventBinder(window);
+  nativeWindow.addEventListener('message', messageCallback);
   return {
     unsubscribe: () => {
-      window.removeEventListener('message', messageCallback);
+      nativeWindow.removeEventListener('message', messageCallback);
     },
     event: UVEEventType.SCROLL_TO_SECTION
   };
@@ -664,16 +737,18 @@ function onContentletHovered(callback) {
     hasHover = true;
     callback(contentletHoveredPayload);
   };
-  // We intentionally do not fire null on document `pointerleave`: the
-  // editor's hover toolbar lives in the parent window (outside the
-  // iframe), so leaving the iframe usually means the user is heading
-  // for the toolbar. Killing the overlay there would yank the toolbar
-  // away just as the user reaches for it. Dead-space-inside-iframe
-  // is already covered by the `pointermove` null branch above.
-  document.addEventListener('pointermove', pointerMoveCallback);
+  // We intentionally do not fire null on `pointerleave`: the editor's hover
+  // toolbar lives in the parent window, so leaving the iframe usually means
+  // the user is reaching for it — killing the overlay would yank it away.
+  //
+  // Bind to `document.documentElement` (a fresh node on each iframe rewrite)
+  // rather than `document`, which goes dead under Zone.js after a rewrite.
+  // `pointermove` bubbles to <html>, so no-Zone behavior is identical. See
+  // getNativeEventBinder for the full rationale.
+  document.documentElement.addEventListener('pointermove', pointerMoveCallback);
   return {
     unsubscribe: () => {
-      document.removeEventListener('pointermove', pointerMoveCallback);
+      document.documentElement.removeEventListener('pointermove', pointerMoveCallback);
     },
     event: UVEEventType.CONTENTLET_HOVERED
   };
@@ -747,18 +822,22 @@ function onContentletClicked(callback) {
       lastSelectedInode = undefined;
     }
   };
-  // Capture phase so we run BEFORE the page's own click handlers and can
-  // preventDefault/stopPropagation effectively.
-  document.addEventListener('click', clickCallback, {
+  // Capture phase so we run BEFORE the page's own click handlers. Bound to
+  // `document.documentElement` (a fresh node on each iframe rewrite) rather
+  // than `document`, which goes dead under Zone.js after a rewrite; capture on
+  // <html> still runs first. See getNativeEventBinder for the full rationale.
+  document.documentElement.addEventListener('click', clickCallback, {
     capture: true
   });
-  window.addEventListener('message', selectionClearedCallback);
+  // Native binder: survives the iframe rewrite under Zone.js. See getNativeEventBinder.
+  const nativeWindow = getNativeEventBinder(window);
+  nativeWindow.addEventListener('message', selectionClearedCallback);
   return {
     unsubscribe: () => {
-      document.removeEventListener('click', clickCallback, {
+      document.documentElement.removeEventListener('click', clickCallback, {
         capture: true
       });
-      window.removeEventListener('message', selectionClearedCallback);
+      nativeWindow.removeEventListener('message', selectionClearedCallback);
     },
     event: UVEEventType.CONTENTLET_CLICKED
   };
@@ -883,6 +962,29 @@ const CUSTOM_NO_COMPONENT = 'CustomNoComponent';
  * @internal
  */
 const DOT_SECTION_ID_PREFIX = 'dot-section-';
+/**
+ * Window flag set by `@dotcms/analytics` when content analytics is initialized
+ * and active on the page.
+ *
+ * @important This value is intentionally duplicated from `@dotcms/analytics`
+ * (`ANALYTICS_WINDOWS_ACTIVE_KEY` in dot-analytics.constants.ts). The SDKs read
+ * it in live mode to decide whether to keep the minimal contentlet attributes
+ * Analytics depends on. Both constants MUST stay in sync.
+ *
+ * @internal
+ */
+const ANALYTICS_ACTIVE_WINDOW_KEY = '__dotAnalyticsActive__';
+/**
+ * Event dispatched by `@dotcms/analytics` once analytics is ready. The SDKs
+ * listen for it so live-mode contentlets can re-render with the attributes
+ * Analytics needs, regardless of initialization order.
+ *
+ * @important Kept in sync with the `dotcms:analytics:ready` event dispatched by
+ * `@dotcms/analytics` (initializeContentAnalytics).
+ *
+ * @internal
+ */
+const ANALYTICS_READY_EVENT = 'dotcms:analytics:ready';
 
 /**
  * Gets the current state of the Universal Visual Editor (UVE).
@@ -1071,7 +1173,6 @@ const isValidBlocks = blocks => {
   };
 };
 
-/* eslint-disable @typescript-eslint/no-explicit-any */
 /**
  * Sets up scroll event handlers for the window to notify the editor about scroll events.
  * Adds listeners for both 'scroll' and 'scrollend' events, sending appropriate messages
@@ -1088,12 +1189,19 @@ function scrollHandler() {
       action: DotCMSUVEAction.IFRAME_SCROLL_END
     });
   };
-  window.addEventListener('scroll', scrollCallback);
-  window.addEventListener('scrollend', scrollEndCallback);
+  // Native binder: scroll survives the iframe rewrite under Zone.js. It can't
+  // move to a fresh `documentElement` like hover/click (viewport scroll only
+  // fires on `window`). See getNativeEventBinder.
+  const {
+    addEventListener,
+    removeEventListener
+  } = getNativeEventBinder(window);
+  addEventListener('scroll', scrollCallback);
+  addEventListener('scrollend', scrollEndCallback);
   return {
     destroyScrollHandler: () => {
-      window.removeEventListener('scroll', scrollCallback);
-      window.removeEventListener('scrollend', scrollEndCallback);
+      removeEventListener('scroll', scrollCallback);
+      removeEventListener('scrollend', scrollEndCallback);
     }
   };
 }
@@ -1207,14 +1315,19 @@ function listenBlockEditorInlineEvent() {
       }
     };
   }
-  // If the page is not fully loaded, listen for the DOMContentLoaded event
+  // Native binder: `DOMContentLoaded` fires on `document` (not `<html>`), so
+  // it survives the iframe rewrite under Zone.js. See getNativeEventBinder.
   const handleDOMContentLoaded = () => {
     listenBlockEditorClick();
   };
-  document.addEventListener('DOMContentLoaded', handleDOMContentLoaded);
+  const {
+    addEventListener,
+    removeEventListener
+  } = getNativeEventBinder(document);
+  addEventListener('DOMContentLoaded', handleDOMContentLoaded);
   return {
     destroyListenBlockEditorInlineEvent: () => {
-      document.removeEventListener('DOMContentLoaded', handleDOMContentLoaded);
+      removeEventListener('DOMContentLoaded', handleDOMContentLoaded);
     }
   };
 }
@@ -1432,4 +1545,4 @@ function initUVE(config = {}) {
   };
 }
 
-export { getDotContainerAttributes as A, getDotContentletAttributes as B, CUSTOM_NO_COMPONENT as C, DEVELOPMENT_MODE as D, EMPTY_CONTAINER_STYLE_ANGULAR as E, isValidBlocks as F, readContentletDataset as G, setBounds as H, PRODUCTION_MODE as P, START_CLASS as S, TEMP_EMPTY_CONTENTLET as T, __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, TEMP_EMPTY_CONTENTLET_TYPE as k, __UVE_EVENT_ERROR_FALLBACK__ as l, combineClasses as m, computeScrollIsInBottom as n, findDotCMSElement as o, findDotCMSVTLData as p, getClosestDotCMSContainerData as q, reorderMenu as r, sendMessageToUVE as s, getColumnPositionClasses as t, updateNavigation as u, getContainersData as v, getContentletsInContainer as w, getDotCMSContainerData as x, getDotCMSContentletsBound as y, getDotCMSPageBounds as z };
+export { ANALYTICS_ACTIVE_WINDOW_KEY as A, getAnalyticsContentletAttributes as B, CUSTOM_NO_COMPONENT as C, DEVELOPMENT_MODE as D, END_CLASS as E, isDotAnalyticsActive as F, getContainersData as G, getContentletsInContainer as H, getDotContainerAttributes as I, readContentletDataset as J, getNativeEventBinder as K, setBounds as L, isValidBlocks as M, PRODUCTION_MODE as P, START_CLASS as S, TEMP_EMPTY_CONTENTLET as T, __UVE_EVENTS__ as _, enableBlockEditorInline as a, createContentlet as b, createUVESubscription as c, initUVE as d, editContentlet as e, __UVE_EVENT_ERROR_FALLBACK__ as f, getUVEState as g, EMPTY_CONTAINER_STYLE_REACT as h, initInlineEditing as i, EMPTY_CONTAINER_STYLE_ANGULAR as j, DOT_SECTION_ID_PREFIX as k, ANALYTICS_READY_EVENT as l, TEMP_EMPTY_CONTENTLET_TYPE as m, getDotCMSPageBounds as n, getDotCMSContentletsBound as o, getDotCMSContainerData as p, getClosestDotCMSContainerData as q, reorderMenu as r, sendMessageToUVE as s, findDotCMSElement as t, updateNavigation as u, findDotCMSVTLData as v, computeScrollIsInBottom as w, combineClasses as x, getColumnPositionClasses as y, getDotContentletAttributes as z };

package/src/internal/constants.d.ts

@@ -81,3 +81,26 @@ export declare const CUSTOM_NO_COMPONENT = "CustomNoComponent";
  * @internal
  */
 export declare const DOT_SECTION_ID_PREFIX = "dot-section-";
+/**
+ * Window flag set by `@dotcms/analytics` when content analytics is initialized
+ * and active on the page.
+ *
+ * @important This value is intentionally duplicated from `@dotcms/analytics`
+ * (`ANALYTICS_WINDOWS_ACTIVE_KEY` in dot-analytics.constants.ts). The SDKs read
+ * it in live mode to decide whether to keep the minimal contentlet attributes
+ * Analytics depends on. Both constants MUST stay in sync.
+ *
+ * @internal
+ */
+export declare const ANALYTICS_ACTIVE_WINDOW_KEY = "__dotAnalyticsActive__";
+/**
+ * Event dispatched by `@dotcms/analytics` once analytics is ready. The SDKs
+ * listen for it so live-mode contentlets can re-render with the attributes
+ * Analytics needs, regardless of initialization order.
+ *
+ * @important Kept in sync with the `dotcms:analytics:ready` event dispatched by
+ * `@dotcms/analytics` (initializeContentAnalytics).
+ *
+ * @internal
+ */
+export declare const ANALYTICS_READY_EVENT = "dotcms:analytics:ready";

package/src/lib/dom/dom.utils.d.ts

@@ -1,5 +1,5 @@
 import { DotCMSBasicContentlet, DotCMSColumnContainer, DotCMSPageAsset, DotPageAssetLayoutColumn, EditableContainerData } from '@dotcms/types';
-import { DotCMSContainerBound, DotCMSContentletBound, DotContainerAttributes, DotContentletAttributes } from '@dotcms/types/internal';
+import { DotAnalyticsContentletAttributes, DotCMSContainerBound, DotCMSContentletBound, DotContainerAttributes, DotContentletAttributes } from '@dotcms/types/internal';
 /**
  * Calculates the bounding information for each page element within the given containers.
  *
@@ -152,6 +152,28 @@ export declare const getColumnPositionClasses: (column: DotPageAssetLayoutColumn
  * @returns {DotContentletAttributes} The dotCMS data attributes
  */
 export declare function getDotContentletAttributes(contentlet: DotCMSBasicContentlet, container: string): DotContentletAttributes;
+/**
+ *
+ * Returns the minimal set of contentlet data attributes required by DotCMS
+ * Analytics (impression & click tracking) to identify a contentlet.
+ *
+ * Used in live mode where the full editor metadata is stripped but Analytics
+ * still needs to resolve the contentlet behind an impression/click.
+ *
+ * @param {DotCMSBasicContentlet} contentlet - The contentlet to get the attributes for
+ * @returns {DotAnalyticsContentletAttributes} The Analytics-required data attributes
+ */
+export declare function getAnalyticsContentletAttributes(contentlet: DotCMSBasicContentlet): DotAnalyticsContentletAttributes;
+/**
+ *
+ * Checks whether DotCMS Analytics is initialized and active on the page.
+ *
+ * The SDKs use this in live mode to decide whether to keep the minimal
+ * contentlet attributes Analytics depends on.
+ *
+ * @returns {boolean} `true` when analytics is active, otherwise `false`
+ */
+export declare function isDotAnalyticsActive(): boolean;
 /**
  *
  *
@@ -219,3 +241,24 @@ export declare function readContentletDataset(element: HTMLElement): {
     widgetTitle: string | undefined;
     onNumberOfPages: string | undefined;
 };
+/**
+ * Returns Zone.js's *unpatched* native `addEventListener` / `removeEventListener`
+ * bound to `target`, falling back to the standard methods when Zone.js is absent.
+ *
+ * UVE reuses a single iframe and rewrites it with `document.open()/write()/close()`
+ * on every in-editor navigation. When Zone.js is loaded inside that iframe it runs
+ * in global-events mode: one native "gateway" listener per (target, eventType)
+ * plus a JS-level task list stored on the target node. `document.open()` tears down
+ * the native gateway on the persistent `window`/`document` nodes, but the task list
+ * survives on them, so Zone sees "already registered" on re-init and skips
+ * re-installing the native gateway — the listener silently goes dead after the
+ * first navigation.
+ *
+ * Hover/click dodge this by binding to `document.documentElement`, a node that
+ * `write()` recreates fresh. `scroll`/`message` (on `window`) and
+ * `DOMContentLoaded` (on `document`) can't: none of them fire on `<html>`, so
+ * there is no fresh node to rebind to. Going through Zone's native (untracked)
+ * methods sidesteps the dedup entirely, so the listener rebinds cleanly after
+ * every rewrite.
+ */
+export declare function getNativeEventBinder<T extends Window | Document>(target: T): Pick<T, 'addEventListener' | 'removeEventListener'>;