@dotcms/uve 1.5.2 → 1.5.4

package/src/internal/events.d.ts

@@ -26,15 +26,22 @@ export declare function onPageReload(callback: UVEEventHandler): {
     event: UVEEventType;
 };
 /**
- * Subscribes to request bounds events in the UVE editor
+ * The single bounds-sync channel. Observes the iframe document and
+ * every `[data-dot-object="container"]` with a single ResizeObserver,
+ * debounces the trailing edge by {@link AUTO_BOUNDS_DEBOUNCE_MS}ms, and
+ * emits the full `getDotCMSPageBounds(...)` payload whenever the layout
+ * settles. Also listens on `scroll` (since scrolling moves contentlets
+ * without changing layout) and on `UVE_FLUSH_BOUNDS` (the editor's
+ * "give me bounds NOW, skip the debounce" message used during drag).
+ *
+ * Re-runs `querySelectorAll` and the observer wiring whenever a
+ * MutationObserver detects child changes that touch container nodes,
+ * so containers that mount/unmount after page-load are picked up
+ * automatically.
  *
- * @param {UVEEventHandler} callback - Function to be called when bounds are requested
- * @returns {Object} Object containing unsubscribe function and event type
- * @returns {Function} .unsubscribe - Function to remove the event listener
- * @returns {UVEEventType} .event - The event type being subscribed to
  * @internal
  */
-export declare function onRequestBounds(callback: UVEEventHandler): {
+export declare function onAutoBounds(callback: UVEEventHandler): {
     unsubscribe: () => void;
     event: UVEEventType;
 };
@@ -66,9 +73,15 @@ export declare function onScrollToSection(callback: UVEEventHandler): {
     event: UVEEventType;
 };
 /**
- * Subscribes to contentlet hover events in the UVE editor
+ * Subscribes to contentlet hover events in the UVE editor.
  *
- * @param {UVEEventHandler} callback - Function to be called when a contentlet is hovered
+ * The callback is invoked with a payload while the pointer is over a
+ * DotCMS element, and once with `null` when the pointer leaves the last
+ * reported element (transitions onto dead space). The editor uses the
+ * `null` signal to clear the hover overlay so it doesn't linger over
+ * areas that no longer have a contentlet under the pointer.
+ *
+ * @param {UVEEventHandler} callback - Function to be called when hover state changes
  * @returns {Object} Object containing unsubscribe function and event type
  * @returns {Function} .unsubscribe - Function to remove the event listener
  * @returns {UVEEventType} .event - The event type being subscribed to
@@ -78,3 +91,18 @@ export declare function onContentletHovered(callback: UVEEventHandler): {
     unsubscribe: () => void;
     event: UVEEventType;
 };
+/**
+ * Subscribes to contentlet click events in the UVE editor.
+ *
+ * The editor's hover overlay is `pointer-events: none` so wheel events pass
+ * through to the iframe. We detect the user's selection click here instead and
+ * post it back to the editor.
+ *
+ * @param {UVEEventHandler} callback - Function to be called when a contentlet is clicked
+ * @returns {Object} Object containing unsubscribe function and event type
+ * @internal
+ */
+export declare function onContentletClicked(callback: UVEEventHandler): {
+    unsubscribe: () => void;
+    event: UVEEventType;
+};

package/src/internal/index.d.ts

@@ -1,2 +1,3 @@
 export * from './constants';
+export * from './contentlet-sentinel.constants';
 export * from './tinymce.config';

package/src/internal.d.ts

@@ -1,6 +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';
 export { defineStyleEditorSchema, normalizeForm, registerStyleEditorSchemas } from './lib/style-editor/internal';

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

@@ -203,3 +203,19 @@ export declare const getContentletsInContainer: (dotCMSPageAsset: DotCMSPageAsse
  * // Returns: { 'data-dot-object': 'container', 'data-dot-identifier': 'cont1', ... }
  */
 export declare function getDotContainerAttributes({ uuid, identifier, acceptTypes, maxContentlets }: EditableContainerData): DotContainerAttributes;
+/**
+ * Read a contentlet's dataset attributes off a DOM element and return a
+ * normalized contentlet object. Mirrors the shape consumed by the editor's
+ * SET_BOUNDS and CONTENTLET_CLICKED events. Optionally parses the
+ * `dotStyleProperties` JSON when present.
+ */
+export declare function readContentletDataset(element: HTMLElement): {
+    dotStyleProperties?: any;
+    identifier: string | undefined;
+    title: string | undefined;
+    inode: string | undefined;
+    contentType: string | undefined;
+    baseType: string | undefined;
+    widgetTitle: string | undefined;
+    onNumberOfPages: string | undefined;
+};

package/src/script/utils.d.ts

@@ -51,34 +51,6 @@ 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.

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

@@ -1,18 +0,0 @@
-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;