@envive-ai/react-widgets-v3 0.3.67 → 0.3.69

package/dist/widgets/FloatingChatWidget/FloatingChatWidget.d.ts

@@ -1,4 +1,4 @@
-import * as react_jsx_runtime16 from "react/jsx-runtime";
+import * as react_jsx_runtime8 from "react/jsx-runtime";
 
 //#region src/widgets/FloatingChatWidget/FloatingChatWidget.d.ts
 interface FloatingChatWidgetProps {
@@ -13,7 +13,7 @@ declare const FloatingChatWidget: {
     previewChatAlwaysOpen,
     previewCXButtonsEnabled,
     previewDisclaimer
-  }?: FloatingChatWidgetProps): react_jsx_runtime16.JSX.Element;
+  }?: FloatingChatWidgetProps): react_jsx_runtime8.JSX.Element;
   displayName: string;
 };
 //#endregion

package/dist/widgets/FloatingChatWidget/FloatingChatWidget.js

@@ -84,7 +84,10 @@ const FloatingChatWidgetHandler = (props) => {
 		enabled: customerServiceIntegration?.enabled ?? false,
 		suppressMerchantButton: customerServiceIntegration?.suppressMerchantButton ?? false,
 		onSwitchToAgent: () => setIsCXOpen(true),
-		onCXClose: () => setIsCXOpen(false),
+		onCXClose: () => {
+			setIsCXOpen(false);
+			if (!previewChatAlwaysOpen) closeChat(ChatElementDisplayLocationV3.FLOATING_CHAT_CLOSE_BUTTON, void 0, "close_button");
+		},
 		children: ({ isSwitchEnabled, toggle }) => /* @__PURE__ */ jsxs(Fragment, { children: [!previewButtonOnly && /* @__PURE__ */ jsx(FloatingChatOverlay, {
 			isOpened: effectiveIsOpen,
 			isResultsModalOpen,

package/dist/widgets/FullPageSalesAgentWidget/FullPageSalesAgentWidget.d.ts

@@ -1,4 +1,4 @@
-import * as react_jsx_runtime12 from "react/jsx-runtime";
+import * as react_jsx_runtime10 from "react/jsx-runtime";
 
 //#region src/widgets/FullPageSalesAgentWidget/FullPageSalesAgentWidget.d.ts
 
@@ -8,7 +8,7 @@ interface FullPageSalesAgentBaseWidgetProps {
 declare const FullPageSalesAgentWidget: {
   ({
     widgetConfigId
-  }: FullPageSalesAgentBaseWidgetProps): react_jsx_runtime12.JSX.Element;
+  }: FullPageSalesAgentBaseWidgetProps): react_jsx_runtime10.JSX.Element;
   displayName: string;
 };
 //#endregion

package/dist/widgets/ProductCardWidget/ProductCardWidget.cjs

@@ -30,6 +30,7 @@ const ProductCardWidgetHandler = (props) => {
 	const productCardWidgetConfig = widgetConfig;
 	const carouselId = productCardWidgetConfig?.contentId || "";
 	const promptButtonType = productCardWidgetConfig?.promptButtonType || __envive_ai_react_toolkit_v3_PromptButton_types.PromptButtonVariant.LIGHT;
+	const promptButtonLayout = productCardWidgetConfig?.promptButtonLayout;
 	const italicizeHeadline = productCardWidgetConfig?.italicizeHeadline;
 	const fallbackColor = productCardWidgetConfig?.fallbackColor;
 	const imageSrc = productCardWidgetConfig?.imageSrc || "";
@@ -107,6 +108,7 @@ const ProductCardWidgetHandler = (props) => {
 		animatedText,
 		prompts,
 		promptButtonType,
+		promptButtonLayout,
 		carouselId,
 		placeholder,
 		voiceInputEnabled: isVoiceInputEnabled,

package/dist/widgets/ProductCardWidget/ProductCardWidget.d.cts

@@ -1,4 +1,4 @@
-import * as react_jsx_runtime9 from "react/jsx-runtime";
+import * as react_jsx_runtime3 from "react/jsx-runtime";
 
 //#region src/widgets/ProductCardWidget/ProductCardWidget.d.ts
 interface ProductCardWidgetProps {
@@ -7,7 +7,7 @@ interface ProductCardWidgetProps {
 declare const ProductCardWidget: {
   ({
     widgetConfigId
-  }: ProductCardWidgetProps): react_jsx_runtime9.JSX.Element;
+  }: ProductCardWidgetProps): react_jsx_runtime3.JSX.Element;
   displayName: string;
 };
 //#endregion

package/dist/widgets/ProductCardWidget/ProductCardWidget.d.ts

@@ -1,4 +1,4 @@
-import * as react_jsx_runtime11 from "react/jsx-runtime";
+import * as react_jsx_runtime9 from "react/jsx-runtime";
 
 //#region src/widgets/ProductCardWidget/ProductCardWidget.d.ts
 interface ProductCardWidgetProps {
@@ -7,7 +7,7 @@ interface ProductCardWidgetProps {
 declare const ProductCardWidget: {
   ({
     widgetConfigId
-  }: ProductCardWidgetProps): react_jsx_runtime11.JSX.Element;
+  }: ProductCardWidgetProps): react_jsx_runtime9.JSX.Element;
   displayName: string;
 };
 //#endregion

package/dist/widgets/ProductCardWidget/ProductCardWidget.js

@@ -29,6 +29,7 @@ const ProductCardWidgetHandler = (props) => {
 	const productCardWidgetConfig = widgetConfig;
 	const carouselId = productCardWidgetConfig?.contentId || "";
 	const promptButtonType = productCardWidgetConfig?.promptButtonType || PromptButtonVariant.LIGHT;
+	const promptButtonLayout = productCardWidgetConfig?.promptButtonLayout;
 	const italicizeHeadline = productCardWidgetConfig?.italicizeHeadline;
 	const fallbackColor = productCardWidgetConfig?.fallbackColor;
 	const imageSrc = productCardWidgetConfig?.imageSrc || "";
@@ -106,6 +107,7 @@ const ProductCardWidgetHandler = (props) => {
 		animatedText,
 		prompts,
 		promptButtonType,
+		promptButtonLayout,
 		carouselId,
 		placeholder,
 		voiceInputEnabled: isVoiceInputEnabled,

package/dist/widgets/PromptButtonCarouselWithImageWidget/PromptButtonCarouselWithImageWidget.d.cts

@@ -1,9 +1,9 @@
 import { BaseWidgetProps } from "../../hocs/withBaseWidget/types.cjs";
-import * as react_jsx_runtime12 from "react/jsx-runtime";
+import * as react_jsx_runtime17 from "react/jsx-runtime";
 
 //#region src/widgets/PromptButtonCarouselWithImageWidget/PromptButtonCarouselWithImageWidget.d.ts
 declare const PromptButtonCarouselWithImageWidgetWithBaseWidget: {
-  (props: BaseWidgetProps): react_jsx_runtime12.JSX.Element;
+  (props: BaseWidgetProps): react_jsx_runtime17.JSX.Element;
   displayName: string;
 };
 interface PromptButtonCarouselWithImageWidgetProps {
@@ -12,7 +12,7 @@ interface PromptButtonCarouselWithImageWidgetProps {
 declare const PromptButtonCarouselWithImageWidget: {
   ({
     widgetConfigId
-  }: PromptButtonCarouselWithImageWidgetProps): react_jsx_runtime12.JSX.Element;
+  }: PromptButtonCarouselWithImageWidgetProps): react_jsx_runtime17.JSX.Element;
   displayName: string;
 };
 //#endregion

package/dist/widgets/PromptButtonCarouselWithImageWidget/PromptButtonCarouselWithImageWidget.d.ts

@@ -1,9 +1,9 @@
 import { BaseWidgetProps } from "../../hocs/withBaseWidget/types.js";
-import * as react_jsx_runtime9 from "react/jsx-runtime";
+import * as react_jsx_runtime2 from "react/jsx-runtime";
 
 //#region src/widgets/PromptButtonCarouselWithImageWidget/PromptButtonCarouselWithImageWidget.d.ts
 declare const PromptButtonCarouselWithImageWidgetWithBaseWidget: {
-  (props: BaseWidgetProps): react_jsx_runtime9.JSX.Element;
+  (props: BaseWidgetProps): react_jsx_runtime2.JSX.Element;
   displayName: string;
 };
 interface PromptButtonCarouselWithImageWidgetProps {
@@ -12,7 +12,7 @@ interface PromptButtonCarouselWithImageWidgetProps {
 declare const PromptButtonCarouselWithImageWidget: {
   ({
     widgetConfigId
-  }: PromptButtonCarouselWithImageWidgetProps): react_jsx_runtime9.JSX.Element;
+  }: PromptButtonCarouselWithImageWidgetProps): react_jsx_runtime2.JSX.Element;
   displayName: string;
 };
 //#endregion

package/dist/widgets/PromptCarouselWidget/PromptCarouselWidget.d.cts

@@ -1,4 +1,4 @@
-import * as react_jsx_runtime0 from "react/jsx-runtime";
+import * as react_jsx_runtime4 from "react/jsx-runtime";
 
 //#region src/widgets/PromptCarouselWidget/PromptCarouselWidget.d.ts
 interface PromptCarouselWidgetProps {
@@ -7,7 +7,7 @@ interface PromptCarouselWidgetProps {
 declare const PromptCarouselWidget: {
   ({
     widgetConfigId
-  }: PromptCarouselWidgetProps): react_jsx_runtime0.JSX.Element;
+  }: PromptCarouselWidgetProps): react_jsx_runtime4.JSX.Element;
   displayName: string;
 };
 //#endregion

package/dist/widgets/PromptCarouselWidget/PromptCarouselWidget.d.ts

@@ -1,4 +1,4 @@
-import * as react_jsx_runtime8 from "react/jsx-runtime";
+import * as react_jsx_runtime6 from "react/jsx-runtime";
 
 //#region src/widgets/PromptCarouselWidget/PromptCarouselWidget.d.ts
 interface PromptCarouselWidgetProps {
@@ -7,7 +7,7 @@ interface PromptCarouselWidgetProps {
 declare const PromptCarouselWidget: {
   ({
     widgetConfigId
-  }: PromptCarouselWidgetProps): react_jsx_runtime8.JSX.Element;
+  }: PromptCarouselWidgetProps): react_jsx_runtime6.JSX.Element;
   displayName: string;
 };
 //#endregion

package/dist/widgets/SocialProofFlowWidget/SocialProofFlowWidget.d.cts

@@ -1,4 +1,4 @@
-import * as react_jsx_runtime1 from "react/jsx-runtime";
+import * as react_jsx_runtime2 from "react/jsx-runtime";
 
 //#region src/widgets/SocialProofFlowWidget/SocialProofFlowWidget.d.ts
 interface SocialProofFlowWidgetProps {
@@ -7,7 +7,7 @@ interface SocialProofFlowWidgetProps {
 declare const SocialProofFlowWidget: {
   ({
     widgetConfigId
-  }: SocialProofFlowWidgetProps): react_jsx_runtime1.JSX.Element;
+  }: SocialProofFlowWidgetProps): react_jsx_runtime2.JSX.Element;
   displayName: string;
 };
 //#endregion

package/dist/widgets/SocialProofFlowWidget/SocialProofFlowWidget.d.ts

@@ -1,4 +1,4 @@
-import * as react_jsx_runtime2 from "react/jsx-runtime";
+import * as react_jsx_runtime7 from "react/jsx-runtime";
 
 //#region src/widgets/SocialProofFlowWidget/SocialProofFlowWidget.d.ts
 interface SocialProofFlowWidgetProps {
@@ -7,7 +7,7 @@ interface SocialProofFlowWidgetProps {
 declare const SocialProofFlowWidget: {
   ({
     widgetConfigId
-  }: SocialProofFlowWidgetProps): react_jsx_runtime2.JSX.Element;
+  }: SocialProofFlowWidgetProps): react_jsx_runtime7.JSX.Element;
   displayName: string;
 };
 //#endregion

package/dist/widgets/SocialProofWidget/SocialProofWidget.d.cts

@@ -1,9 +1,9 @@
 import { BaseWidgetProps } from "../../hocs/withBaseWidget/types.cjs";
-import * as react_jsx_runtime4 from "react/jsx-runtime";
+import * as react_jsx_runtime15 from "react/jsx-runtime";
 
 //#region src/widgets/SocialProofWidget/SocialProofWidget.d.ts
 declare const SocialProofWidgetWithBaseWidget: {
-  (props: BaseWidgetProps): react_jsx_runtime4.JSX.Element;
+  (props: BaseWidgetProps): react_jsx_runtime15.JSX.Element;
   displayName: string;
 };
 interface SocialProofWidgetProps {
@@ -12,7 +12,7 @@ interface SocialProofWidgetProps {
 declare const SocialProofWidget: {
   ({
     widgetConfigId
-  }: SocialProofWidgetProps): react_jsx_runtime4.JSX.Element;
+  }: SocialProofWidgetProps): react_jsx_runtime15.JSX.Element;
   displayName: string;
 };
 //#endregion

package/dist/widgets/SocialProofWidget/SocialProofWidget.d.ts

@@ -1,9 +1,9 @@
 import { BaseWidgetProps } from "../../hocs/withBaseWidget/types.js";
-import * as react_jsx_runtime14 from "react/jsx-runtime";
+import * as react_jsx_runtime4 from "react/jsx-runtime";
 
 //#region src/widgets/SocialProofWidget/SocialProofWidget.d.ts
 declare const SocialProofWidgetWithBaseWidget: {
-  (props: BaseWidgetProps): react_jsx_runtime14.JSX.Element;
+  (props: BaseWidgetProps): react_jsx_runtime4.JSX.Element;
   displayName: string;
 };
 interface SocialProofWidgetProps {
@@ -12,7 +12,7 @@ interface SocialProofWidgetProps {
 declare const SocialProofWidget: {
   ({
     widgetConfigId
-  }: SocialProofWidgetProps): react_jsx_runtime14.JSX.Element;
+  }: SocialProofWidgetProps): react_jsx_runtime4.JSX.Element;
   displayName: string;
 };
 //#endregion

package/dist/widgets/TitledPromptCarouselWidget/TitledPromptCarouselWidget.d.cts

@@ -1,4 +1,4 @@
-import * as react_jsx_runtime6 from "react/jsx-runtime";
+import * as react_jsx_runtime1 from "react/jsx-runtime";
 
 //#region src/widgets/TitledPromptCarouselWidget/TitledPromptCarouselWidget.d.ts
 interface TitledPromptCarouselWidgetProps {
@@ -7,7 +7,7 @@ interface TitledPromptCarouselWidgetProps {
 declare const TitledPromptCarouselWidget: {
   ({
     widgetConfigId
-  }: TitledPromptCarouselWidgetProps): react_jsx_runtime6.JSX.Element;
+  }: TitledPromptCarouselWidgetProps): react_jsx_runtime1.JSX.Element;
   displayName: string;
 };
 //#endregion

package/dist/widgets/TitledPromptCarouselWidget/TitledPromptCarouselWidget.d.ts

@@ -1,4 +1,4 @@
-import * as react_jsx_runtime3 from "react/jsx-runtime";
+import * as react_jsx_runtime0 from "react/jsx-runtime";
 
 //#region src/widgets/TitledPromptCarouselWidget/TitledPromptCarouselWidget.d.ts
 interface TitledPromptCarouselWidgetProps {
@@ -7,7 +7,7 @@ interface TitledPromptCarouselWidgetProps {
 declare const TitledPromptCarouselWidget: {
   ({
     widgetConfigId
-  }: TitledPromptCarouselWidgetProps): react_jsx_runtime3.JSX.Element;
+  }: TitledPromptCarouselWidgetProps): react_jsx_runtime0.JSX.Element;
   displayName: string;
 };
 //#endregion

package/dist/widgets/TypingAnimationFlowWidget/TypingAnimationFlowWidget.d.cts

@@ -1,4 +1,4 @@
-import * as react_jsx_runtime0 from "react/jsx-runtime";
+import * as react_jsx_runtime14 from "react/jsx-runtime";
 
 //#region src/widgets/TypingAnimationFlowWidget/TypingAnimationFlowWidget.d.ts
 interface TypingAnimationFlowWidgetProps {
@@ -7,7 +7,7 @@ interface TypingAnimationFlowWidgetProps {
 declare const TypingAnimationFlowWidget: {
   ({
     widgetConfigId
-  }: TypingAnimationFlowWidgetProps): react_jsx_runtime0.JSX.Element;
+  }: TypingAnimationFlowWidgetProps): react_jsx_runtime14.JSX.Element;
   displayName: string;
 };
 //#endregion

package/dist/widgets/TypingAnimationFlowWidget/TypingAnimationFlowWidget.d.ts

@@ -1,4 +1,4 @@
-import * as react_jsx_runtime0 from "react/jsx-runtime";
+import * as react_jsx_runtime19 from "react/jsx-runtime";
 
 //#region src/widgets/TypingAnimationFlowWidget/TypingAnimationFlowWidget.d.ts
 interface TypingAnimationFlowWidgetProps {
@@ -7,7 +7,7 @@ interface TypingAnimationFlowWidgetProps {
 declare const TypingAnimationFlowWidget: {
   ({
     widgetConfigId
-  }: TypingAnimationFlowWidgetProps): react_jsx_runtime0.JSX.Element;
+  }: TypingAnimationFlowWidgetProps): react_jsx_runtime19.JSX.Element;
   displayName: string;
 };
 //#endregion

package/dist/widgets/TypingAnimationWidget/TypingAnimationWidget.d.cts

@@ -1,9 +1,9 @@
 import { BaseWidgetProps } from "../../hocs/withBaseWidget/types.cjs";
-import * as react_jsx_runtime16 from "react/jsx-runtime";
+import * as react_jsx_runtime0 from "react/jsx-runtime";
 
 //#region src/widgets/TypingAnimationWidget/TypingAnimationWidget.d.ts
 declare const TypingAnimationWithBaseWidget: {
-  (props: BaseWidgetProps): react_jsx_runtime16.JSX.Element;
+  (props: BaseWidgetProps): react_jsx_runtime0.JSX.Element;
   displayName: string;
 };
 interface TypingAnimationWidgetProps {
@@ -12,7 +12,7 @@ interface TypingAnimationWidgetProps {
 declare const TypingAnimationWidget: {
   ({
     widgetConfigId
-  }: TypingAnimationWidgetProps): react_jsx_runtime16.JSX.Element;
+  }: TypingAnimationWidgetProps): react_jsx_runtime0.JSX.Element;
   displayName: string;
 };
 //#endregion

package/dist/widgets/dist/SearchResults/SearchResultsWidget.d.cts

@@ -1,8 +1,8 @@
-import * as react_jsx_runtime0 from "react/jsx-runtime";
+import * as react_jsx_runtime1 from "react/jsx-runtime";
 
 //#region ../widgets/dist/SearchResults/SearchResultsWidget.d.ts
 //#region src/SearchResults/SearchResultsWidget.d.ts
-declare const SearchResultsWidget: () => react_jsx_runtime0.JSX.Element;
+declare const SearchResultsWidget: () => react_jsx_runtime1.JSX.Element;
 //#endregion
 
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@envive-ai/react-widgets-v3",
-  "version": "0.3.67",
+  "version": "0.3.69",
   "description": "React widget library v3 for Envive services.",
   "keywords": [
     "react",

package/src/CXIntegration/implementations/__tests__/useGladlyUnifiedCXButton.test.ts

@@ -0,0 +1,233 @@
+import { renderHook, waitFor } from '@testing-library/react';
+import { DOMObserver } from '@envive-ai/react-hooks/application/utils';
+import { useGladlyUnifiedCXButton } from '../useGladlyUnifiedCXButton';
+
+const GLADLY_CONTAINER_ID = 'gladlyChat_container';
+const HIDE_STYLE_ID = 'envive-gladly-pill-hide';
+const ENVIVE_BUTTON_HIDE_STYLE_ID = 'envive-floating-button-hide';
+
+/**
+ * Gladly renders into an OPEN shadow root attached to `#gladlyChat_container`
+ * (confirmed via live DOM inspection — see PR history). The host's own
+ * attributes/size never change between open and closed, and it has zero
+ * light-DOM children, so open/close can only be read from inside the shadow
+ * tree. Closed state: a small launcher icon (~50x50). Open state: a chat
+ * panel comfortably larger than the 200px threshold in both dimensions.
+ */
+describe('useGladlyUnifiedCXButton', () => {
+  beforeEach(() => {
+    document.body.innerHTML = '';
+    document.head.innerHTML = '';
+  });
+
+  afterEach(() => {
+    DOMObserver.destroy();
+  });
+
+  const flush = (ms = 0) =>
+    new Promise<void>(resolve => {
+      setTimeout(resolve, ms);
+    });
+
+  // jsdom has no layout engine — getBoundingClientRect() always returns all
+  // zeroes — so the sizes our production code reads from the real DOM have
+  // to be stubbed per element to exercise that branch here.
+  const stubRect = (el: HTMLElement, width: number, height: number) => {
+    Object.defineProperty(el, 'getBoundingClientRect', {
+      configurable: true,
+      value: () => ({ width, height, top: 0, left: 0, right: width, bottom: height }) as DOMRect,
+    });
+  };
+
+  const createHostWithShadowRoot = () => {
+    const host = document.createElement('div');
+    host.id = GLADLY_CONTAINER_ID;
+    document.body.appendChild(host);
+    const shadowRoot = host.attachShadow({ mode: 'open' });
+    return shadowRoot;
+  };
+
+  const renderClosedIcon = (shadowRoot: ShadowRoot) => {
+    const icon = document.createElement('button');
+    icon.className = '_chatIconButton_z80r8_17';
+    stubRect(icon, 50, 50);
+    shadowRoot.appendChild(icon);
+    return icon;
+  };
+
+  const renderOpenPanel = (shadowRoot: ShadowRoot) => {
+    const panel = document.createElement('div');
+    panel.className = '_baseWidgetContainer_1mosp_1 _panel_1mosp_21';
+    stubRect(panel, 364, 577);
+    shadowRoot.appendChild(panel);
+    return panel;
+  };
+
+  it('opens, then closes when the panel is replaced by the closed-state launcher icon', async () => {
+    const onSwitchToAgent = vi.fn();
+    const onCXClose = vi.fn();
+
+    // Host + shadow root already exist before the hook mounts, so its
+    // mount-time attach() finds them synchronously (no need to wait out the
+    // retry interval here — that path is covered by the next test).
+    const shadowRoot = createHostWithShadowRoot();
+    const icon = renderClosedIcon(shadowRoot);
+
+    const { result } = renderHook(() =>
+      useGladlyUnifiedCXButton({ onSwitchToAgent, onCXClose, suppressMerchantButton: true }),
+    );
+    await flush();
+
+    result.current.toggle();
+    expect(onSwitchToAgent).toHaveBeenCalledTimes(1);
+    expect(document.getElementById(ENVIVE_BUTTON_HIDE_STYLE_ID)).not.toBeNull();
+
+    // Gladly swaps the closed-state icon for the open chat panel.
+    icon.remove();
+    renderOpenPanel(shadowRoot);
+    await flush();
+
+    expect(onCXClose).not.toHaveBeenCalled();
+    expect(document.getElementById(ENVIVE_BUTTON_HIDE_STYLE_ID)).not.toBeNull();
+
+    // Real close: panel replaced by the small launcher icon again.
+    shadowRoot.querySelector('div')?.remove();
+    renderClosedIcon(shadowRoot);
+    await flush();
+
+    await waitFor(() => expect(onCXClose).toHaveBeenCalledTimes(1));
+    expect(document.getElementById(ENVIVE_BUTTON_HIDE_STYLE_ID)).toBeNull();
+    // The closed-state launcher icon lives inside the shadow root, out of
+    // reach of the `#custom-gladly-pill` document-level suppression rule —
+    // the whole host must be force-hidden again so it doesn't reappear.
+    expect(document.getElementById(GLADLY_CONTAINER_ID)?.style.display).toBe('none');
+  });
+
+  it('attaches to the shadow root even when it is not available until after the host node is created', async () => {
+    const onSwitchToAgent = vi.fn();
+    const onCXClose = vi.fn();
+
+    renderHook(() =>
+      useGladlyUnifiedCXButton({ onSwitchToAgent, onCXClose, suppressMerchantButton: true }),
+    ).result.current.toggle();
+
+    // Host appears first (e.g. Gladly SDK init), shadow root + content a tick
+    // later — after the hook's first attach() attempt already ran and found
+    // nothing, so this exercises the retry interval actually catching up.
+    const host = document.createElement('div');
+    host.id = GLADLY_CONTAINER_ID;
+    document.body.appendChild(host);
+    await flush();
+
+    const shadowRoot = host.attachShadow({ mode: 'open' });
+    renderOpenPanel(shadowRoot);
+    await flush(350);
+
+    expect(onCXClose).not.toHaveBeenCalled();
+
+    shadowRoot.querySelector('div')?.remove();
+    renderClosedIcon(shadowRoot);
+    await flush();
+
+    await waitFor(() => expect(onCXClose).toHaveBeenCalledTimes(1));
+  });
+
+  it('does not treat a transient small render during the opening animation as a close', async () => {
+    // toggle() sets wasOpenRef optimistically before the panel has actually
+    // grown to its open size. Without the hasConfirmedOpenRef gate, reading
+    // the panel here (still mid-animation) would be misread as "closed" and
+    // immediately flip the Envive button back — the panel flashing open then
+    // shut that an earlier version of this fix regressed on.
+    const onSwitchToAgent = vi.fn();
+    const onCXClose = vi.fn();
+
+    const shadowRoot = createHostWithShadowRoot();
+    const panel = document.createElement('div');
+    panel.className = '_baseWidgetContainer_1mosp_1 _panel_1mosp_21';
+    stubRect(panel, 40, 40); // still animating in, hasn't reached open size yet
+    shadowRoot.appendChild(panel);
+
+    renderHook(() =>
+      useGladlyUnifiedCXButton({ onSwitchToAgent, onCXClose, suppressMerchantButton: true }),
+    ).result.current.toggle();
+    await flush();
+
+    expect(onCXClose).not.toHaveBeenCalled();
+    expect(document.getElementById(ENVIVE_BUTTON_HIDE_STYLE_ID)).not.toBeNull();
+  });
+
+  it('confirms the open state via polling when the panel grows without an accompanying DOM mutation', async () => {
+    // MutationObserver never fires for a size change that isn't driven by a
+    // DOM mutation (e.g. a CSS transition finishing). Only the polling
+    // fallback can pick this up and set hasConfirmedOpenRef, which the later
+    // real (mutation-based) close then depends on to fire at all.
+    const onSwitchToAgent = vi.fn();
+    const onCXClose = vi.fn();
+
+    const shadowRoot = createHostWithShadowRoot();
+    const panel = document.createElement('div');
+    panel.className = '_baseWidgetContainer_1mosp_1 _panel_1mosp_21';
+    stubRect(panel, 40, 40);
+    shadowRoot.appendChild(panel);
+
+    renderHook(() =>
+      useGladlyUnifiedCXButton({ onSwitchToAgent, onCXClose, suppressMerchantButton: true }),
+    ).result.current.toggle();
+    await flush();
+
+    // Panel reaches its open size purely via layout/animation — no DOM
+    // mutation accompanies it.
+    stubRect(panel, 364, 577);
+    await flush(300); // > SHADOW_POLL_MS, no further mutation triggered
+
+    panel.remove();
+    renderClosedIcon(shadowRoot);
+    await flush();
+
+    await waitFor(() => expect(onCXClose).toHaveBeenCalledTimes(1));
+  });
+
+  it('removes the suppression rule and restores the host when suppressMerchantButton turns off', async () => {
+    const onSwitchToAgent = vi.fn();
+    const onCXClose = vi.fn();
+
+    const { rerender } = renderHook(
+      ({ suppressMerchantButton }) =>
+        useGladlyUnifiedCXButton({ onSwitchToAgent, onCXClose, suppressMerchantButton }),
+      { initialProps: { suppressMerchantButton: true } },
+    );
+
+    expect(document.getElementById(HIDE_STYLE_ID)).not.toBeNull();
+
+    const host = document.createElement('div');
+    host.id = GLADLY_CONTAINER_ID;
+    host.style.display = 'none';
+    document.body.appendChild(host);
+
+    rerender({ suppressMerchantButton: false });
+
+    expect(document.getElementById(HIDE_STYLE_ID)).toBeNull();
+    expect(document.getElementById(GLADLY_CONTAINER_ID)?.style.display).toBe('');
+  });
+
+  it('cleans up the suppression rule and host on unmount, so switching providers does not leave Gladly hidden', () => {
+    const onSwitchToAgent = vi.fn();
+    const onCXClose = vi.fn();
+
+    const host = document.createElement('div');
+    host.id = GLADLY_CONTAINER_ID;
+    document.body.appendChild(host);
+
+    const { unmount } = renderHook(() =>
+      useGladlyUnifiedCXButton({ onSwitchToAgent, onCXClose, suppressMerchantButton: true }),
+    );
+    expect(document.getElementById(HIDE_STYLE_ID)).not.toBeNull();
+
+    // FloatingChatWidget remounts this provider (key={cxProvider}) when the
+    // configured provider changes away from Gladly.
+    unmount();
+
+    expect(document.getElementById(HIDE_STYLE_ID)).toBeNull();
+    expect(document.getElementById(GLADLY_CONTAINER_ID)?.style.display).toBe('');
+  });
+});