@xapp/chat-widget 1.103.0 → 1.104.1

package/dist/index.es.js

@@ -2,6 +2,7 @@ import React, { useCallback, useState, useEffect, useRef, useLayoutEffect, creat
 export { default as React } from 'react';
 import require$$0, { jsx, jsxs, Fragment } from 'react/jsx-runtime';
 import { useSelector, useDispatch, Provider } from 'react-redux';
+import { createPortal } from 'react-dom';
 
 var commonjsGlobal = typeof globalThis !== 'undefined' ? globalThis : typeof window !== 'undefined' ? window : typeof global !== 'undefined' ? global : typeof self !== 'undefined' ? self : {};
 
@@ -327,7 +328,7 @@ function buildChatWidgetChannel(props) {
     // and the text on it are always a matched pair rather than one scraped
     // value and one guess.
     const primaryColor = (0, color_1.usableColorOr)(props.primaryColor, DEFAULT_PRIMARY);
-    return Object.assign({ type: "chat-widget", 
+    return Object.assign(Object.assign({ type: "chat-widget", 
         // MCP by default. The widget runs on a public page, so homeowner mode
         // — which is unauthenticated and carries the appId in the url — is the
         // only one that can work there; business_owner needs a token, and a
@@ -338,7 +339,7 @@ function buildChatWidgetChannel(props) {
             mcp: {
                 mode: "homeowner"
             }
-        }, theme: buildChatTheme(primaryColor, props.secondaryColor), actionBar: buildActionBar({ apiUrl, formWidgetKey, phoneNumber }) }, (businessName ? { botName: businessName } : {}));
+        }, theme: buildChatTheme(primaryColor, props.secondaryColor), actionBar: buildActionBar({ apiUrl, formWidgetKey, phoneNumber }) }, (formWidgetKey ? { formWidgetKey } : {})), (businessName ? { botName: businessName } : {}));
 }
 /**
  * The dock of buttons that replaces the plain chat bubble.
@@ -2398,6 +2399,16 @@ function stripChatContinueParam(win) {
 function hasConversation(chats) {
     return !!(chats === null || chats === void 0 ? void 0 : chats.some(function (chat) { return chat.type === "chat.msg"; }));
 }
+/**
+ * True once the visitor has said something themselves.
+ *
+ * Stricter than `hasConversation`, which counts the greeting the assistant posts before anyone
+ * has engaged. Visitor messages carry a `visitor:` nick, the same marker MessageList uses to
+ * decide which side of the thread a message belongs on.
+ */
+function hasVisitorMessage(chats) {
+    return !!(chats === null || chats === void 0 ? void 0 : chats.some(function (chat) { var _a, _b; return chat.type === "chat.msg" && !!((_b = (_a = chat.user) === null || _a === void 0 ? void 0 : _a.nick) === null || _b === void 0 ? void 0 : _b.startsWith("visitor:")); }));
+}
 /**
  * The CTA to show, given whether there is a conversation to go back to.
  *
@@ -37099,6 +37110,22 @@ var StaticMessagesChatWidgetContainer = function (props) {
  * After this delay of inactivity, the "stop typing" event will be sent.
  */
 var TYPING_INDICATOR_DEBOUNCE_MS = 2000;
+/**
+ * Reparenting has to happen before the browser paints, or the chat is missing for a frame on
+ * every crossing. useLayoutEffect warns when a component is rendered on a server, where there is
+ * nothing to paint and nothing to move, so fall back there.
+ */
+var useBeforePaintEffect = typeof window === "undefined" ? useEffect : useLayoutEffect;
+/**
+ * Narrowest viewport a pop-out is allowed on by default. Below this a floating window covers
+ * most of the screen, which is worse than letting the chat scroll away with the page.
+ */
+var DEFAULT_POP_OUT_MIN_WIDTH = 640;
+/**
+ * How long to keep correcting the message list's scroll after the chat moves. Text rewraps at
+ * the new width, so the content height settles over a frame or two rather than immediately.
+ */
+var SCROLL_SETTLE_MS = 250;
 /**
  * Check if we're in development mode. Uses typeof to prevent TypeScript
  * errors after Rollup replaces "production" with a literal string.
@@ -37265,12 +37292,25 @@ var ChatWidgetConnected = function (props) {
     }
     return (jsx(ChatConfigContext.Provider, { value: config, children: jsx(ChatServerContext.Provider, { value: chatServer, children: jsx(ChatWidgetUI, __assign$1({}, props, { config: rawConfig })) }) }));
 };
+var HOST_FORM_WIDGET_CHECK_MS = 500;
+/** About 15s: long enough for a slow host script, short enough not to poll forever. */
+var HOST_FORM_WIDGET_MAX_CHECKS = 30;
+/** The form widget key a Form/Book button carries on its own formConfig, if any. */
+function formButtonKey(button) {
+    var _a, _b;
+    return opensFormWidget(button)
+        ? ((_b = (_a = button.formConfig) === null || _a === void 0 ? void 0 : _a.api) === null || _b === void 0 ? void 0 : _b.key) || undefined
+        : undefined;
+}
+function isHostFormWidgetOnPage() {
+    return isFormWidgetScriptLoaded() || isFormWidgetReady();
+}
 /**
  * Inner ChatWidget component that renders the actual UI.
  * Exported for use by StaticChatWidgetContainer to avoid infinite loops.
  */
 var ChatWidgetUI = function (props) {
-    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0, _1, _2, _3, _4, _5, _6, _7, _8, _9, _10, _11, _12, _13, _14;
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0, _1, _2, _3, _4, _5, _6, _7, _8, _9, _10, _11, _12, _13, _14, _15, _16, _17, _18, _19, _20, _21, _22, _23;
     var innerDispatch = useChatDispatch();
     var dispatch = useChatServerDispatch();
     // Publish the visual viewport's geometry so the panel can size around the soft keyboard.
@@ -37295,23 +37335,176 @@ var ChatWidgetUI = function (props) {
     var arrivedViaChatLink = useArrivedViaChatLink(previewMode);
     var conversationOnScreen = hasConversation(chatState.chats);
     var chatButtonCta = useMemo(function () { var _a; return resolveCta((_a = props.config) === null || _a === void 0 ? void 0 : _a.cta, { hasConversation: conversationOnScreen, arrivedViaChatLink: arrivedViaChatLink }); }, [(_b = props.config) === null || _b === void 0 ? void 0 : _b.cta, conversationOnScreen, arrivedViaChatLink]);
+    // Pop-out: an embedded chat follows the visitor down the page rather than scrolling away
+    // mid-conversation. Same component, same store - it is moved, not reopened - so the
+    // conversation continues instead of restarting in a second widget.
+    var popOutEnabled = dockedMode && ((_c = props.config.popOut) === null || _c === void 0 ? void 0 : _c.enabled) === true;
+    var popOutMinWidth = (_e = (_d = props.config.popOut) === null || _d === void 0 ? void 0 : _d.minWidth) !== null && _e !== void 0 ? _e : DEFAULT_POP_OUT_MIN_WIDTH;
+    var anchorRef = useRef(null);
+    var _24 = useState(false), anchorOffScreen = _24[0], setAnchorOffScreen = _24[1];
+    // A returning visitor's chat often sits below the fold at load. Following them before they
+    // have even reached it would put a floating window in front of someone who never scrolled
+    // past anything, so the chat has to have been on screen once first.
+    var _25 = useState(false), anchorSeen = _25[0], setAnchorSeen = _25[1];
+    // Set when the visitor puts the floating window away: it stays put until their own
+    // scrolling brings the chat's place on the page back into view.
+    var _26 = useState(false), popOutDismissed = _26[0], setPopOutDismissed = _26[1];
+    // On a phone the chat offers its entry point rather than covering the page; this is set when
+    // the visitor taps that and asks for the conversation.
+    var _27 = useState(false), mobileOpened = _27[0], setMobileOpened = _27[1];
+    // Tracked rather than read at render: a visitor who narrows the window or rotates a tablet
+    // while the chat is popped out would otherwise keep a floating window over most of a phone
+    // screen until some unrelated re-render happened along.
+    var _28 = useState(typeof window === "undefined" ? 0 : window.innerWidth), viewportWidth = _28[0], setViewportWidth = _28[1];
+    useEffect(function () {
+        if (!popOutEnabled || typeof window === "undefined") {
+            return undefined;
+        }
+        var handleResize = function () { return setViewportWidth(window.innerWidth); };
+        handleResize();
+        window.addEventListener("resize", handleResize);
+        return function () { return window.removeEventListener("resize", handleResize); };
+    }, [popOutEnabled]);
+    useEffect(function () {
+        if (!popOutEnabled || typeof IntersectionObserver === "undefined" || !anchorRef.current) {
+            return undefined;
+        }
+        var observer = new IntersectionObserver(function (entries) {
+            var entry = entries[entries.length - 1];
+            if (!entry) {
+                return;
+            }
+            setAnchorOffScreen(!entry.isIntersecting);
+            if (entry.isIntersecting) {
+                setAnchorSeen(true);
+                setPopOutDismissed(false);
+                // Back at the chat itself, so the phone entry point starts over.
+                setMobileOpened(false);
+            }
+        });
+        observer.observe(anchorRef.current);
+        return function () { return observer.disconnect(); };
+    }, [popOutEnabled]);
+    // With `after: "message"` the chat only follows a visitor who has engaged - the assistant's
+    // greeting arrives before anyone types, so it does not count. A floating window also covers
+    // most of a phone screen, so narrow screens stay on the page either way.
+    var engaged = ((_f = props.config.popOut) === null || _f === void 0 ? void 0 : _f.after) !== "message" || hasVisitorMessage(chatState.chats);
+    var following = popOutEnabled && anchorSeen && anchorOffScreen && !popOutDismissed && engaged;
+    var wideEnough = viewportWidth >= popOutMinWidth;
+    var mobileEntry = (_h = (_g = props.config.popOut) === null || _g === void 0 ? void 0 : _g.mobile) !== null && _h !== void 0 ? _h : "auto";
+    /**
+     * Too narrow for a floating window: the chat stays put and offers its entry point instead,
+     * so a visitor reading on still has a way back to the conversation.
+     */
+    var collapsedOnMobile = following && !wideEnough && mobileEntry !== "none" && !mobileOpened;
+    var poppedOut = following && (wideEnough || mobileOpened);
+    function handlePopOutDismiss() {
+        // On a phone, putting the window away goes back to the entry point rather than leaving
+        // the visitor with nothing: the conversation is still off-screen up the page.
+        if (wideEnough) {
+            setPopOutDismissed(true);
+            return;
+        }
+        setMobileOpened(false);
+    }
+    function handleMobileOpen() {
+        setMobileOpened(true);
+    }
+    // The chat always renders into this one node, and the node is what moves between the page
+    // and the corner. Swapping the JSX between an element and a portal instead would hand React
+    // a different fiber type in the same slot, remounting the whole chat - and with it the
+    // visitor's half-typed message and the message list's scroll position - on every crossing.
+    var popOutHost = useMemo(function () { return (popOutEnabled && typeof document !== "undefined" ? document.createElement("div") : null); }, [popOutEnabled]);
+    // Where the visitor is reading, recorded as they scroll. Measuring this at move time does
+    // not work: React has already applied the new size by then, so the height is the new one
+    // while the scroll position is still the old one, and the mix is meaningless.
+    var readingRef = useRef({ fromBottom: 0, latest: true });
+    useEffect(function () {
+        if (!popOutHost) {
+            return undefined;
+        }
+        var onScroll = function (event) {
+            var el = event.target;
+            if (!(el instanceof HTMLElement) || !el.classList.contains("message-list-container")) {
+                return;
+            }
+            var fromBottom = el.scrollHeight - el.clientHeight - el.scrollTop;
+            readingRef.current = {
+                fromBottom: fromBottom,
+                // Within a screenful of the newest message is "following the conversation", and
+                // that is where they go back to. The list also smooth-scrolls after each
+                // message, so the last position it reports can be mid-animation.
+                latest: fromBottom <= el.clientHeight,
+            };
+        };
+        // Scroll events do not bubble, but they do capture.
+        popOutHost.addEventListener("scroll", onScroll, true);
+        return function () { return popOutHost.removeEventListener("scroll", onScroll, true); };
+    }, [popOutHost]);
+    useBeforePaintEffect(function () {
+        if (!popOutHost) {
+            return undefined;
+        }
+        popOutHost.className = "widget-portal";
+        var target = poppedOut ? document.body : anchorRef.current;
+        if (target && popOutHost.parentElement !== target) {
+            // Moving a node blurs whatever was focused inside it, which would drop the visitor
+            // out of the message box mid-sentence, so put the caret back afterwards.
+            var focused = document.activeElement;
+            var refocus = focused instanceof HTMLElement && popOutHost.contains(focused) ? focused : undefined;
+            // The embedded chat and the floating window are different heights, so a scroll
+            // position kept in pixels lands somewhere else in the thread - usually leaving the
+            // newest message below the fold, which reads as the conversation having been lost.
+            // Distance from the bottom is what the visitor actually chose: at the newest message
+            // they stay there, and reading back stays that far back.
+            var messages_1 = popOutHost.querySelector(".message-list-container");
+            // appendChild moves the node, children and all, without React re-rendering them.
+            target.appendChild(popOutHost);
+            // Read afresh each time rather than closing over the position from before the move:
+            // the delayed corrections below run up to a quarter of a second later, and a visitor
+            // who scrolls back through the thread in that window must not be snapped forward
+            // again. Their scrolling updates the ref, so the later passes simply hold their place.
+            var restoreScroll = function () {
+                if (!messages_1) {
+                    return;
+                }
+                var _a = readingRef.current, fromBottom = _a.fromBottom, latest = _a.latest;
+                var bottom = messages_1.scrollHeight - messages_1.clientHeight;
+                messages_1.scrollTop = latest ? bottom : Math.max(0, bottom - fromBottom);
+            };
+            restoreScroll();
+            refocus === null || refocus === void 0 ? void 0 : refocus.focus({ preventScroll: true });
+            // The thread rewraps at the new width, so the content keeps growing for a frame or
+            // two after the move. Restoring only once leaves the newest message under the fold,
+            // which is what a visitor reads as "my conversation is gone".
+            var frame_1 = requestAnimationFrame(restoreScroll);
+            var settled_1 = window.setTimeout(restoreScroll, SCROLL_SETTLE_MS);
+            return function () {
+                cancelAnimationFrame(frame_1);
+                window.clearTimeout(settled_1);
+            };
+        }
+        return undefined;
+    }, [popOutHost, poppedOut]);
+    useEffect(function () { return function () { return popOutHost === null || popOutHost === void 0 ? void 0 : popOutHost.remove(); }; }, [popOutHost]);
     // Only an embedded widget may drop its header. In normal mode the header holds the
     // minimize and close buttons, so hiding it would leave a floating window with no way out.
-    var headerHidden = ((_c = props.config.header) === null || _c === void 0 ? void 0 : _c.hidden) === true && (dockedMode || staticMode);
+    // While popped out the header is what lets the visitor put the window away, so it stays.
+    var headerHidden = ((_j = props.config.header) === null || _j === void 0 ? void 0 : _j.hidden) === true && (dockedMode || staticMode) && !poppedOut;
     // The header is the only place a HEADER_LEFT / HEADER_RIGHT menu button renders. Without it
     // the menu would be unreachable, so hand the button to the footer instead.
     var menuConfig = useMemo(function () {
         return headerHidden && props.config.menu && props.config.menu.menuButtonLocation !== "FOOTER"
             ? __assign$1(__assign$1({}, props.config.menu), { menuButtonLocation: "FOOTER" }) : props.config.menu;
     }, [headerHidden, props.config.menu]);
-    var canRefresh = (_e = (_d = props.config.header) === null || _d === void 0 ? void 0 : _d.actions) === null || _e === void 0 ? void 0 : _e.refresh;
+    var canRefresh = (_l = (_k = props.config.header) === null || _k === void 0 ? void 0 : _k.actions) === null || _l === void 0 ? void 0 : _l.refresh;
     // can't minimize in docked mode, static mode, or preview mode.
-    var canMinimize = !dockedMode && !staticMode && !previewMode && ((_g = (_f = props.config.header) === null || _f === void 0 ? void 0 : _f.actions) === null || _g === void 0 ? void 0 : _g.minimize);
-    log("docked: ".concat(dockedMode, " static: ").concat(staticMode, " preview: ").concat(previewMode, " minimized: ").concat((_j = (_h = props.config.header) === null || _h === void 0 ? void 0 : _h.actions) === null || _j === void 0 ? void 0 : _j.minimize));
+    var canMinimize = !dockedMode && !staticMode && !previewMode && ((_o = (_m = props.config.header) === null || _m === void 0 ? void 0 : _m.actions) === null || _o === void 0 ? void 0 : _o.minimize);
+    log("docked: ".concat(dockedMode, " static: ").concat(staticMode, " preview: ").concat(previewMode, " minimized: ").concat((_q = (_p = props.config.header) === null || _p === void 0 ? void 0 : _p.actions) === null || _q === void 0 ? void 0 : _q.minimize));
     var canCancel;
     // To preserve legacy behavior, cancel needs a little more checks
-    if (typeof ((_l = (_k = props.config.header) === null || _k === void 0 ? void 0 : _k.actions) === null || _l === void 0 ? void 0 : _l.cancel) === "boolean") {
-        canCancel = !dockedMode && !staticMode && !previewMode && ((_o = (_m = props.config.header) === null || _m === void 0 ? void 0 : _m.actions) === null || _o === void 0 ? void 0 : _o.cancel);
+    if (typeof ((_s = (_r = props.config.header) === null || _r === void 0 ? void 0 : _r.actions) === null || _s === void 0 ? void 0 : _s.cancel) === "boolean") {
+        canCancel = !dockedMode && !staticMode && !previewMode && ((_u = (_t = props.config.header) === null || _t === void 0 ? void 0 : _t.actions) === null || _u === void 0 ? void 0 : _u.cancel);
     }
     else {
         canCancel = !dockedMode && !staticMode && !previewMode;
@@ -37322,16 +37515,16 @@ var ChatWidgetUI = function (props) {
     }
     // Our state - pull from storage
     // Parse autoOpenOnWidth once for use in both initial state and useEffect
-    var autoOpenOnWidthValue = ((_p = props.config) === null || _p === void 0 ? void 0 : _p.autoOpenOnWidth)
+    var autoOpenOnWidthValue = ((_v = props.config) === null || _v === void 0 ? void 0 : _v.autoOpenOnWidth)
         ? parseInt(props.config.autoOpenOnWidth, 10)
         : NaN;
     var autoOpenOnWidthMatch = !isNaN(autoOpenOnWidthValue) && window.innerWidth >= autoOpenOnWidthValue;
     // When autoOpenOnWidth is configured, use width check instead of persisted visible state
     // to prevent greeting requests on viewports below the threshold
-    var _15 = useState((!canMinimize && !canCancel) ||
+    var _29 = useState((!canMinimize && !canCancel) ||
         // !!get("visible") ||
-        (!isNaN(autoOpenOnWidthValue) ? autoOpenOnWidthMatch : chatState.visuals.visible)), visible = _15[0], setVisibleState = _15[1];
-    var _16 = useState(false); _16[0]; var setTypingState = _16[1]; // false initially - state kept for potential external observers
+        (!isNaN(autoOpenOnWidthValue) ? autoOpenOnWidthMatch : chatState.visuals.visible)), visible = _29[0], setVisibleState = _29[1];
+    var _30 = useState(false); _30[0]; var setTypingState = _30[1]; // false initially - state kept for potential external observers
     // Ref to track typing state for use in timeout callbacks
     var typingRef = useRef(false);
     // Timeout ref for debouncing "stop typing" events
@@ -37339,11 +37532,11 @@ var ChatWidgetUI = function (props) {
     // Track whether autoOpenOnWidth has already fired so it doesn't re-open after user closes
     var autoOpenFiredRef = useRef(autoOpenOnWidthMatch);
     var chatServer = useContext(ChatServerContext);
-    var patternsConfig = (_r = (_q = props.config) === null || _q === void 0 ? void 0 : _q.autoOpenOnPattern) === null || _r === void 0 ? void 0 : _r.patterns;
+    var patternsConfig = (_x = (_w = props.config) === null || _w === void 0 ? void 0 : _w.autoOpenOnPattern) === null || _x === void 0 ? void 0 : _x.patterns;
     var currentUrl = window.location.href;
     var patternExist = patternsConfig && patternsConfig.length > 0;
     var patternMatches = patternsConfig === null || patternsConfig === void 0 ? void 0 : patternsConfig.some(function (pattern) { return currentUrl.includes(pattern); });
-    var configWidth = (_t = (_s = props.config) === null || _s === void 0 ? void 0 : _s.autoOpenOnPattern) === null || _t === void 0 ? void 0 : _t.minimumWidth;
+    var configWidth = (_z = (_y = props.config) === null || _y === void 0 ? void 0 : _y.autoOpenOnPattern) === null || _z === void 0 ? void 0 : _z.minimumWidth;
     var currentWidth = window.innerWidth;
     var setVisible = useCallback(function (newVisible) {
         if (staticMode || previewMode) {
@@ -37378,7 +37571,7 @@ var ChatWidgetUI = function (props) {
         };
         // eslint-disable-next-line react-hooks/exhaustive-deps
     }, []);
-    var _17 = useState(!document.hidden), isTabVisible = _17[0], setIsTabVisible = _17[1];
+    var _31 = useState(!document.hidden), isTabVisible = _31[0], setIsTabVisible = _31[1];
     useEffect(function () {
         var handleVisibilityChange = function () {
             setIsTabVisible(!document.hidden);
@@ -37602,8 +37795,8 @@ var ChatWidgetUI = function (props) {
         }));
     }
     // Action Bar state and handlers
-    var _18 = useState(false), formModalOpen = _18[0], setFormModalOpen = _18[1];
-    var _19 = useState(null), activeFormConfig = _19[0], setActiveFormConfig = _19[1];
+    var _32 = useState(false), formModalOpen = _32[0], setFormModalOpen = _32[1];
+    var _33 = useState(null), activeFormConfig = _33[0], setActiveFormConfig = _33[1];
     var handleFormButtonClick = useCallback(function (formButton) {
         // If form-widget is configured, use its openForm API
         // The form-widget script should already be pre-loaded
@@ -37670,19 +37863,56 @@ var ChatWidgetUI = function (props) {
     var messages = chatState && chatState.chats;
     log("Rendering - accountStatus: \"".concat(chatState.accountStatus, "\", connectionStatus: \"").concat(chatState.connection.connectionStatus, "\""));
     var config = props.config, onConnectionStatusChange = props.onConnectionStatusChange;
-    var actionBarEnabled = ((_u = config === null || config === void 0 ? void 0 : config.actionBar) === null || _u === void 0 ? void 0 : _u.enabled) === true;
+    var actionBarEnabled = ((_0 = config === null || config === void 0 ? void 0 : config.actionBar) === null || _0 === void 0 ? void 0 : _0.enabled) === true;
     // The host page declares this; the widget cannot work it out. On the standalone
     // contact/booking page the form already *is* the page, which makes every button that
     // only opens one redundant. XappMedia/chat-widget#1626.
     var isFormPage = useIsFormPage();
+    // Studio can save Form/Book buttons with no form widget key anywhere. They can only open the
+    // FormModal fallback, which then says "Form widget key not configured" - so drop them, unless
+    // the host page installed the form widget itself. One key anywhere is enough: a page has one
+    // form widget and every Form/Book button opens it through the same global.
+    var configuredButtons = (_2 = (_1 = config === null || config === void 0 ? void 0 : config.actionBar) === null || _1 === void 0 ? void 0 : _1.buttons) !== null && _2 !== void 0 ? _2 : [];
+    var hasKeylessFormButton = !(config === null || config === void 0 ? void 0 : config.formWidgetKey) &&
+        configuredButtons.some(opensFormWidget) &&
+        !configuredButtons.some(formButtonKey);
+    var _34 = useState(function () { return hasKeylessFormButton && isHostFormWidgetOnPage(); }), hostFormWidget = _34[0], setHostFormWidget = _34[1];
+    // The host's form-widget script loads independently of ours and can arrive after the first
+    // render, so keep looking for a while rather than deciding once. This only runs when there is
+    // no key anywhere, and with no key we never preload - so the script this finds by its fixed id
+    // cannot be our own.
+    useEffect(function () {
+        if (!hasKeylessFormButton || hostFormWidget) {
+            return undefined;
+        }
+        var checks = 0;
+        var interval = setInterval(function () {
+            checks++;
+            if (isHostFormWidgetOnPage()) {
+                setHostFormWidget(true);
+                clearInterval(interval);
+            }
+            else if (checks >= HOST_FORM_WIDGET_MAX_CHECKS) {
+                clearInterval(interval);
+            }
+        }, HOST_FORM_WIDGET_CHECK_MS);
+        return function () { return clearInterval(interval); };
+    }, [hasKeylessFormButton, hostFormWidget]);
+    var actionBarConfig = useMemo(function () {
+        var actionBar = config === null || config === void 0 ? void 0 : config.actionBar;
+        if (!actionBar || !hasKeylessFormButton || hostFormWidget) {
+            return actionBar;
+        }
+        return __assign$1(__assign$1({}, actionBar), { buttons: actionBar.buttons.filter(function (button) { return !opensFormWidget(button); }) });
+    }, [config === null || config === void 0 ? void 0 : config.actionBar, hasKeylessFormButton, hostFormWidget]);
     var actionBarButtons = useMemo(function () {
-        return actionBarEnabled && (config === null || config === void 0 ? void 0 : config.actionBar)
-            ? visibleActionBarButtons(config.actionBar.buttons, {
+        return actionBarEnabled && actionBarConfig
+            ? visibleActionBarButtons(actionBarConfig.buttons, {
                 chatDisabled: config.disabled,
                 formDisabled: isFormPage,
             })
             : [];
-    }, [actionBarEnabled, config === null || config === void 0 ? void 0 : config.actionBar, config === null || config === void 0 ? void 0 : config.disabled, isFormPage]);
+    }, [actionBarEnabled, actionBarConfig, config === null || config === void 0 ? void 0 : config.disabled, isFormPage]);
     // A bar that filters down to nothing is a bare strip of chrome. Treat it as if the bar
     // were off, so the visitor still gets the plain chat button rather than an empty shell.
     var actionBarVisible = actionBarEnabled && actionBarButtons.length > 0;
@@ -37694,7 +37924,7 @@ var ChatWidgetUI = function (props) {
             onConnectionStatusChange(connectionStatus);
         }
     }, [connectionStatus, onConnectionStatusChange]);
-    useExternalScript((_v = props.config) === null || _v === void 0 ? void 0 : _v.middlewareUrl);
+    useExternalScript((_3 = props.config) === null || _3 === void 0 ? void 0 : _3.middlewareUrl);
     // Only reach for form.xapp.ai when something on this page can still open the form.
     //
     // Loading it is not free: the script mounts a second form-widget instance whose wrapper
@@ -37704,11 +37934,16 @@ var ChatWidgetUI = function (props) {
     //
     // With no bar configured the side button IS the entry point, so that case still loads.
     var formWidgetNeeded = !isFormPage && (!actionBarEnabled || actionBarButtons.some(opensFormWidget));
+    // The top-level key is the documented place for it, but an App can carry the key only on
+    // a Form/Book button's formConfig - buildChatWidgetChannel did exactly that. Reading only
+    // the top-level key left the script unloaded, so every click waited out
+    // openFormWidgetWhenReady before the modal fallback found the button's key.
+    var formWidgetKey = (_4 = config === null || config === void 0 ? void 0 : config.formWidgetKey) !== null && _4 !== void 0 ? _4 : actionBarButtons.map(formButtonKey).find(Boolean);
     useEffect(function () {
-        if ((config === null || config === void 0 ? void 0 : config.formWidgetKey) && formWidgetNeeded) {
-            preloadFormWidgetScript(config.formWidgetKey);
+        if (formWidgetKey && formWidgetNeeded) {
+            preloadFormWidgetScript(formWidgetKey);
         }
-    }, [config === null || config === void 0 ? void 0 : config.formWidgetKey, formWidgetNeeded]);
+    }, [formWidgetKey, formWidgetNeeded]);
     // Set body attribute when actionBar is enabled (used by CSS to hide form-widget side button on mobile)
     // Uses reference counting to handle multiple widget instances
     useEffect(function () {
@@ -37734,18 +37969,23 @@ var ChatWidgetUI = function (props) {
         };
     }, [actionBarVisible]);
     // This is a pseudo agent. It represent's the widget (shown in the header avatar for instance)
-    var widgetAgent = ((_w = chatState.agents["agent:robot"]) === null || _w === void 0 ? void 0 : _w.user) ||
+    var widgetAgent = ((_5 = chatState.agents["agent:robot"]) === null || _5 === void 0 ? void 0 : _5.user) ||
         (config === null || config === void 0 ? void 0 : config.agent) || {
         nick: "agent:robot",
         avatarPath: config.avatarUrl,
         display_name: "Agent",
     };
-    return (jsxs(Fragment, { children: [jsxs("div", { className: "widget-container ".concat(modeClass, " ").concat(getVisibilityClass()).concat(actionBarVisible ? " widget-container--with-action-bar" : ""), children: [jsx(WidgetStylesheet, { theme: config === null || config === void 0 ? void 0 : config.theme }), !headerHidden && (jsx(ChatHeader, { accountStatus: chatState.accountStatus, refreshOnClick: handleRestartClick, minimizeOnClick: handleMinimizeClick, cancelOnClick: handleCancelClick, agent: widgetAgent, canRefresh: canRefresh, canMinimize: canMinimize, canCancel: canCancel, config: config === null || config === void 0 ? void 0 : config.header, menuConfig: config.menu, debugMode: (_z = (_y = (_x = props.config) === null || _x === void 0 ? void 0 : _x.connection) === null || _y === void 0 ? void 0 : _y.mcp) === null || _z === void 0 ? void 0 : _z.debugMode, onSubmit: handleOnSubmit })), jsx(MessageList, { visible: visible, queuePosition: chatState.queuePosition, isChatting: chatState.isChatting, isOffline: isOffline, messages: messages, agents: chatState.agents, agent: config === null || config === void 0 ? void 0 : config.agent, lastRatingRequestTimestamp: chatState.lastRatingRequestTimestamp, hasRating: chatState.hasRating, visitorId: chatState.visitorId, hasWsButton: !!chatState.wsButton, messageMiddleware: props.messageMiddleware, textTypingStatusEnabled: (_1 = (_0 = props.config) === null || _0 === void 0 ? void 0 : _0.typingStatus) === null || _1 === void 0 ? void 0 : _1.textTypingStatusEnabled, disableAutoScroll: props.disableAutoScroll, onSend: handleSendMessage, onWrite: handleWriteMessage, onOpenUrl: handleOpenUrl, minimizeOnClick: handleMinimizeClick }), jsx("div", { className: "xa-spinner-container ".concat(visible && connectionStatus === "pending" ? "visible" : ""), children: jsx("div", { className: "xa-spinner" }) }), connectionStatus === "offline" && jsx(ServerOffline, {}), chatState.wsButton && visible && (jsx(WsButton, { button: chatState.wsButton, onPress: handleWsButtonPress })), jsx(ChatFooter, { isAdmin: config === null || config === void 0 ? void 0 : config.isAdmin, isChatting: chatState.isChatting, placeholder: (_2 = config === null || config === void 0 ? void 0 : config.input) === null || _2 === void 0 ? void 0 : _2.placeholder, sendButtonIcon: (_4 = (_3 = config === null || config === void 0 ? void 0 : config.footer) === null || _3 === void 0 ? void 0 : _3.sendButton) === null || _4 === void 0 ? void 0 : _4.icon, sendButtonIconHover: (_6 = (_5 = config === null || config === void 0 ? void 0 : config.footer) === null || _5 === void 0 ? void 0 : _5.sendButton) === null || _6 === void 0 ? void 0 : _6.iconHover, sendButtonIconDisabled: (_8 = (_7 = config === null || config === void 0 ? void 0 : config.footer) === null || _7 === void 0 ? void 0 : _7.sendButton) === null || _8 === void 0 ? void 0 : _8.iconDisabled, visible: visible, hasWsButton: !!chatState.wsButton, menuConfig: menuConfig, footerConfig: (_9 = props.config) === null || _9 === void 0 ? void 0 : _9.footer, inputConfig: (_10 = props.config) === null || _10 === void 0 ? void 0 : _10.input, disabled: previewMode, onChange: handleOnChange, onSubmit: handleOnSubmit, onFileUpload: handleFileUpload }), jsx("div", { className: "restartModal", ref: modalRef, onClick: handleRestartModalCloseClick, children: jsx(ModalContent, { onClose: handleRestartModalCloseClick, onReset: handleReset }) })] }), actionBarVisible && config.actionBar ? (jsxs(Fragment, { children: [jsx(ActionBar, { config: __assign$1(__assign$1({}, config.actionBar), { 
+    var widgetContainer = (jsxs("div", { className: "widget-container ".concat(modeClass, " ").concat(getVisibilityClass()).concat(actionBarVisible ? " widget-container--with-action-bar" : "").concat(poppedOut ? " widget-container--popped" : "").concat(collapsedOnMobile ? " widget-container--collapsed" : ""), children: [jsx(WidgetStylesheet, { theme: config === null || config === void 0 ? void 0 : config.theme }), !headerHidden && (jsx(ChatHeader, { accountStatus: chatState.accountStatus, refreshOnClick: handleRestartClick, minimizeOnClick: poppedOut ? handlePopOutDismiss : handleMinimizeClick, cancelOnClick: handleCancelClick, agent: widgetAgent, canRefresh: canRefresh, canMinimize: poppedOut || canMinimize, canCancel: canCancel, config: config === null || config === void 0 ? void 0 : config.header, menuConfig: config.menu, debugMode: (_8 = (_7 = (_6 = props.config) === null || _6 === void 0 ? void 0 : _6.connection) === null || _7 === void 0 ? void 0 : _7.mcp) === null || _8 === void 0 ? void 0 : _8.debugMode, onSubmit: handleOnSubmit })), jsx(MessageList, { visible: visible, queuePosition: chatState.queuePosition, isChatting: chatState.isChatting, isOffline: isOffline, messages: messages, agents: chatState.agents, agent: config === null || config === void 0 ? void 0 : config.agent, lastRatingRequestTimestamp: chatState.lastRatingRequestTimestamp, hasRating: chatState.hasRating, visitorId: chatState.visitorId, hasWsButton: !!chatState.wsButton, messageMiddleware: props.messageMiddleware, textTypingStatusEnabled: (_10 = (_9 = props.config) === null || _9 === void 0 ? void 0 : _9.typingStatus) === null || _10 === void 0 ? void 0 : _10.textTypingStatusEnabled, disableAutoScroll: props.disableAutoScroll, onSend: handleSendMessage, onWrite: handleWriteMessage, onOpenUrl: handleOpenUrl, minimizeOnClick: handleMinimizeClick }), jsx("div", { className: "xa-spinner-container ".concat(visible && connectionStatus === "pending" ? "visible" : ""), children: jsx("div", { className: "xa-spinner" }) }), connectionStatus === "offline" && jsx(ServerOffline, {}), chatState.wsButton && visible && (jsx(WsButton, { button: chatState.wsButton, onPress: handleWsButtonPress })), jsx(ChatFooter, { isAdmin: config === null || config === void 0 ? void 0 : config.isAdmin, isChatting: chatState.isChatting, placeholder: (_11 = config === null || config === void 0 ? void 0 : config.input) === null || _11 === void 0 ? void 0 : _11.placeholder, sendButtonIcon: (_13 = (_12 = config === null || config === void 0 ? void 0 : config.footer) === null || _12 === void 0 ? void 0 : _12.sendButton) === null || _13 === void 0 ? void 0 : _13.icon, sendButtonIconHover: (_15 = (_14 = config === null || config === void 0 ? void 0 : config.footer) === null || _14 === void 0 ? void 0 : _14.sendButton) === null || _15 === void 0 ? void 0 : _15.iconHover, sendButtonIconDisabled: (_17 = (_16 = config === null || config === void 0 ? void 0 : config.footer) === null || _16 === void 0 ? void 0 : _16.sendButton) === null || _17 === void 0 ? void 0 : _17.iconDisabled, visible: visible, hasWsButton: !!chatState.wsButton, menuConfig: menuConfig, footerConfig: (_18 = props.config) === null || _18 === void 0 ? void 0 : _18.footer, inputConfig: (_19 = props.config) === null || _19 === void 0 ? void 0 : _19.input, disabled: previewMode, onChange: handleOnChange, onSubmit: handleOnSubmit, onFileUpload: handleFileUpload }), jsx("div", { className: "restartModal", ref: modalRef, onClick: handleRestartModalCloseClick, children: jsx(ModalContent, { onClose: handleRestartModalCloseClick, onReset: handleReset }) })] }));
+    return (jsxs(Fragment, { children: [popOutEnabled ? (
+            // The anchor keeps the chat's place in the page, so the layout does not jump when
+            // the chat pops out. The chat itself lives in popOutHost, which the effect above
+            // moves between this anchor and the body.
+            jsx("div", { className: "widget-anchor", ref: anchorRef, children: popOutHost && createPortal(widgetContainer, popOutHost) })) : (widgetContainer), actionBarVisible && actionBarConfig && !(collapsedOnMobile && mobileEntry === "button") ? (jsxs(Fragment, { children: [jsx(ActionBar, { config: __assign$1(__assign$1({}, actionBarConfig), { 
                             // Use actionBar.cta if set, otherwise fall back to widget-level cta
-                            cta: resolveCta((_11 = config.actionBar.cta) !== null && _11 !== void 0 ? _11 : config.cta, {
+                            cta: resolveCta((_20 = actionBarConfig.cta) !== null && _20 !== void 0 ? _20 : config.cta, {
                                 hasConversation: conversationOnScreen,
                                 arrivedViaChatLink: arrivedViaChatLink,
-                            }) }), visible: visible, chatDisabled: config.disabled, formDisabled: isFormPage, hasUserInteracted: (_12 = chatState.visuals) === null || _12 === void 0 ? void 0 : _12.hasInteracted, onChatClick: chatButtonOnClick, onChatMinimize: handleMinimizeClick, onFormClick: handleFormButtonClick, onCtaDismiss: handleCtaDismiss }), formModalOpen && activeFormConfig && (jsx(FormModal, { config: activeFormConfig, widgetEnv: config, onClose: handleFormModalClose }))] })) : (jsx(ChatButton, { addClass: visible ? "visible" : "", onClick: chatButtonOnClick, config: chatButtonCta, imageUrl: (_13 = config === null || config === void 0 ? void 0 : config.chatButton) === null || _13 === void 0 ? void 0 : _13.imageUrl, visible: visible, hasInteracted: (_14 = chatState.visuals) === null || _14 === void 0 ? void 0 : _14.hasInteracted, onCtaDismiss: handleCtaDismiss })), jsx(ErrorOverlay, { enableErrorOverlay: config === null || config === void 0 ? void 0 : config.enableErrorOverlay })] }));
+                            }) }), visible: collapsedOnMobile ? false : visible, chatDisabled: config.disabled, formDisabled: isFormPage, hasUserInteracted: (_21 = chatState.visuals) === null || _21 === void 0 ? void 0 : _21.hasInteracted, onChatClick: collapsedOnMobile ? handleMobileOpen : chatButtonOnClick, onChatMinimize: handleMinimizeClick, onFormClick: handleFormButtonClick, onCtaDismiss: handleCtaDismiss }), formModalOpen && activeFormConfig && (jsx(FormModal, { config: activeFormConfig, widgetEnv: config, onClose: handleFormModalClose }))] })) : (jsx(ChatButton, { addClass: visible && !collapsedOnMobile ? "visible" : "", onClick: collapsedOnMobile ? handleMobileOpen : chatButtonOnClick, config: chatButtonCta, imageUrl: (_22 = config === null || config === void 0 ? void 0 : config.chatButton) === null || _22 === void 0 ? void 0 : _22.imageUrl, visible: collapsedOnMobile ? false : visible, hasInteracted: (_23 = chatState.visuals) === null || _23 === void 0 ? void 0 : _23.hasInteracted, onCtaDismiss: handleCtaDismiss })), jsx(ErrorOverlay, { enableErrorOverlay: config === null || config === void 0 ? void 0 : config.enableErrorOverlay })] }));
 };
 /**
  * Top-level wrapper that dispatches between preview mode and connected mode.