@microsoft/omnichannel-chat-widget 1.8.3-main.ec1328d → 1.8.4-main.1bfa518

package/lib/cjs/common/utils/SecureEventBus.js

@@ -0,0 +1,307 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _TelemetryHelper = require("../telemetry/TelemetryHelper");
+var _TelemetryConstants = require("../telemetry/TelemetryConstants");
+function _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
+function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, _toPropertyKey(descriptor.key), descriptor); } }
+function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(arg) { var key = _toPrimitive(arg, "string"); return typeof key === "symbol" ? key : String(key); }
+function _toPrimitive(input, hint) { if (typeof input !== "object" || input === null) return input; var prim = input[Symbol.toPrimitive]; if (prim !== undefined) { var res = prim.call(input, hint || "default"); if (typeof res !== "object") return res; throw new TypeError("@@toPrimitive must return a primitive value."); } return (hint === "string" ? String : Number)(input); }
+/**
+ * SecureEventBus class implementing the singleton pattern for secure event communication.
+ * Provides authentication-based event dispatching to prevent unauthorized external access.
+ */
+let SecureEventBus = /*#__PURE__*/function () {
+  /**
+   * Private constructor to enforce singleton pattern.
+   * Generates a unique authentication token for this session.
+   */
+  function SecureEventBus() {
+    _classCallCheck(this, SecureEventBus);
+    _defineProperty(this, "listeners", new Map());
+    _defineProperty(this, "authToken", void 0);
+    _defineProperty(this, "eventCounter", 0);
+    // Generate a secure, unique token for this session
+    this.authToken = this.generateAuthToken();
+  }
+
+  /**
+   * Get the singleton instance of SecureEventBus.
+   * Creates a new instance if one doesn't exist.
+   * 
+   * @returns The singleton instance of SecureEventBus
+   * 
+   * @example
+   * ```typescript
+   * const eventBus = SecureEventBus.getInstance();
+   * ```
+   */
+  _createClass(SecureEventBus, [{
+    key: "generateAuthToken",
+    value:
+    /**
+     * Generate a cryptographically secure authentication token.
+     * Uses crypto.getRandomValues when available, falls back to Math.random.
+     * 
+     * @private
+     * @returns A 64-character hexadecimal string representing the authentication token
+     */
+    function generateAuthToken() {
+      const array = new Uint8Array(32);
+      if (typeof crypto !== "undefined" && crypto.getRandomValues) {
+        crypto.getRandomValues(array);
+      } else {
+        // Fallback for environments without crypto.getRandomValues
+        for (let i = 0; i < array.length; i++) {
+          array[i] = Math.floor(Math.random() * 256);
+        }
+      }
+      return Array.from(array, byte => byte.toString(16).padStart(2, "0")).join("");
+    }
+
+    /**
+     * Get the authentication token for this SecureEventBus instance.
+     * This token is required for dispatching events and should only be used internally.
+     * 
+     * @returns The authentication token string
+     * 
+     * @example
+     * ```typescript
+     * const eventBus = SecureEventBus.getInstance();
+     * const token = eventBus.getAuthToken();
+     * eventBus.dispatch('myEvent', { data: 'value' }, token);
+     * ```
+     */
+  }, {
+    key: "getAuthToken",
+    value: function getAuthToken() {
+      return this.authToken;
+    }
+
+    /**
+     * Dispatch an event with authentication to all registered listeners.
+     * Verifies the authentication token before dispatching to prevent unauthorized access.
+     * 
+     * @param eventName - The name of the event to dispatch
+     * @param payload - The data to send with the event (optional)
+     * @param token - Authentication token (must match the internal token)
+     * @returns true if event was successfully dispatched, false if unauthorized or error occurred
+     * 
+     * @example
+     * ```typescript
+     * const eventBus = SecureEventBus.getInstance();
+     * const token = eventBus.getAuthToken();
+     * 
+     * // Dispatch with payload
+     * const success = eventBus.dispatch('userAction', { action: 'click', target: 'button' }, token);
+     * 
+     * // Dispatch without payload
+     * eventBus.dispatch('windowClosed', undefined, token);
+     * ```
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  }, {
+    key: "dispatch",
+    value: function dispatch(eventName, payload, token) {
+      // Verify authentication token
+      if (token !== this.authToken) {
+        _TelemetryHelper.TelemetryHelper.logActionEvent(_TelemetryConstants.LogLevel.ERROR, {
+          Event: _TelemetryConstants.TelemetryEvent.SecureEventBusUnauthorizedDispatch,
+          Description: `Unauthorized event dispatch attempt blocked: ${eventName}`,
+          ExceptionDetails: {
+            eventName,
+            providedToken: token ? "provided" : "missing",
+            expectedToken: "secured"
+          }
+        });
+        return false;
+      }
+      const listeners = this.listeners.get(eventName);
+      if (!listeners || listeners.length === 0) {
+        return true; // No listeners, but not an error
+      }
+
+      // Dispatch to all registered listeners
+      try {
+        listeners.forEach(listener => {
+          try {
+            listener.callback(payload);
+          } catch (error) {
+            _TelemetryHelper.TelemetryHelper.logActionEvent(_TelemetryConstants.LogLevel.ERROR, {
+              Event: _TelemetryConstants.TelemetryEvent.SecureEventBusListenerError,
+              Description: `Error in event listener for event: ${eventName}`,
+              ExceptionDetails: error
+            });
+          }
+        });
+        return true;
+      } catch (error) {
+        _TelemetryHelper.TelemetryHelper.logActionEvent(_TelemetryConstants.LogLevel.ERROR, {
+          Event: _TelemetryConstants.TelemetryEvent.SecureEventBusDispatchError,
+          Description: `Error dispatching event: ${eventName}`,
+          ExceptionDetails: error
+        });
+        return false;
+      }
+    }
+
+    /**
+     * Subscribe to an event with a callback function.
+     * The callback will be executed whenever the specified event is dispatched.
+     * 
+     * @param eventName - The name of the event to listen for
+     * @param callback - The function to execute when the event is fired
+     * @returns A function that can be called to unsubscribe from the event
+     * 
+     * @example
+     * ```typescript
+     * const eventBus = SecureEventBus.getInstance();
+     * 
+     * // Subscribe to an event
+     * const unsubscribe = eventBus.subscribe('chatMessage', (message) => {
+     *   console.log('New message:', message.text);
+     *   console.log('From user:', message.userId);
+     * });
+     * 
+     * // Later, unsubscribe
+     * unsubscribe();
+     * ```
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  }, {
+    key: "subscribe",
+    value: function subscribe(eventName, callback) {
+      const listenerId = `listener_${++this.eventCounter}`;
+      if (!this.listeners.has(eventName)) {
+        this.listeners.set(eventName, []);
+      }
+      const listeners = this.listeners.get(eventName);
+      if (!listeners) {
+        throw new Error(`Listeners for event "${eventName}" not found.`);
+      }
+      const listener = {
+        callback,
+        id: listenerId
+      };
+      listeners.push(listener);
+
+      // Return unsubscribe function
+      return () => {
+        const currentListeners = this.listeners.get(eventName);
+        if (currentListeners) {
+          const index = currentListeners.findIndex(l => l.id === listenerId);
+          if (index !== -1) {
+            currentListeners.splice(index, 1);
+          }
+
+          // Clean up empty listener arrays
+          if (currentListeners.length === 0) {
+            this.listeners.delete(eventName);
+          }
+        }
+      };
+    }
+
+    /**
+     * Remove all listeners for a specific event.
+     * This completely removes the event from the internal listeners map.
+     * 
+     * @param eventName - The name of the event to remove all listeners for
+     * 
+     * @example
+     * ```typescript
+     * const eventBus = SecureEventBus.getInstance();
+     * 
+     * // Remove all listeners for 'chatClosed' event
+     * eventBus.removeAllListeners('chatClosed');
+     * ```
+     */
+  }, {
+    key: "removeAllListeners",
+    value: function removeAllListeners(eventName) {
+      this.listeners.delete(eventName);
+    }
+
+    /**
+     * Clear all listeners for all events.
+     * This resets the entire event bus to its initial state.
+     * Useful for cleanup during application shutdown or testing.
+     * 
+     * @example
+     * ```typescript
+     * const eventBus = SecureEventBus.getInstance();
+     * 
+     * // Clear all event listeners
+     * eventBus.clear();
+     * ```
+     */
+  }, {
+    key: "clear",
+    value: function clear() {
+      this.listeners.clear();
+    }
+
+    /**
+     * Get the number of listeners for a specific event.
+     * Useful for debugging and monitoring purposes.
+     * 
+     * @param eventName - The name of the event to count listeners for
+     * @returns The number of listeners registered for the event
+     * 
+     * @example
+     * ```typescript
+     * const eventBus = SecureEventBus.getInstance();
+     * 
+     * // Check how many listeners are registered for 'userAction'
+     * const count = eventBus.getListenerCount('userAction');
+     * console.log(`${count} listeners registered for userAction`);
+     * ```
+     */
+  }, {
+    key: "getListenerCount",
+    value: function getListenerCount(eventName) {
+      var _this$listeners$get;
+      return ((_this$listeners$get = this.listeners.get(eventName)) === null || _this$listeners$get === void 0 ? void 0 : _this$listeners$get.length) || 0;
+    }
+
+    /**
+     * Get all registered event names.
+     * Returns an array of event names that currently have listeners.
+     * Useful for debugging and monitoring purposes.
+     * 
+     * @returns An array of event names that have registered listeners
+     * 
+     * @example
+     * ```typescript
+     * const eventBus = SecureEventBus.getInstance();
+     * 
+     * // Get all registered events
+     * const events = eventBus.getRegisteredEvents();
+     * console.log('Active events:', events);
+     * // Output: ['userAction', 'chatMessage', 'windowResize']
+     * ```
+     */
+  }, {
+    key: "getRegisteredEvents",
+    value: function getRegisteredEvents() {
+      return Array.from(this.listeners.keys());
+    }
+  }], [{
+    key: "getInstance",
+    value: function getInstance() {
+      if (!SecureEventBus.instance) {
+        SecureEventBus.instance = new SecureEventBus();
+      }
+      return SecureEventBus.instance;
+    }
+  }]);
+  return SecureEventBus;
+}();
+_defineProperty(SecureEventBus, "instance", null);
+var _default = SecureEventBus;
+exports.default = _default;

package/lib/cjs/common/utils/dispatchCustomEvent.js

@@ -0,0 +1,25 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _SecureEventBus = _interopRequireDefault(require("./SecureEventBus"));
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const dispatchCustomEvent = (name, payload) => {
+  try {
+    const eventBus = _SecureEventBus.default.getInstance();
+    const authToken = eventBus.getAuthToken();
+
+    // Dispatch through the secure event bus instead of global window
+    const success = eventBus.dispatch(name, payload, authToken);
+    if (!success) {
+      console.error("Failed to dispatch secure event:", name);
+    }
+  } catch (error) {
+    console.error("Error dispatching secure custom event:", name, payload, error);
+  }
+};
+var _default = dispatchCustomEvent;
+exports.default = _default;

package/lib/cjs/common/utils.js

@@ -7,7 +7,9 @@ exports.getCustomEventValue = exports.getConversationDetailsCall = exports.getBr
 exports.getDeviceType = getDeviceType;
 exports.getWidgetEndChatEventName = exports.getWidgetCacheIdfromProps = exports.getWidgetCacheId = exports.getTimestampHourMinute = exports.getStateFromCache = exports.getLocaleDirection = exports.getIconText = exports.getDomain = void 0;
 exports.isEndConversationDueToOverflowActivity = isEndConversationDueToOverflowActivity;
-exports.setTabIndices = exports.setOcUserAgent = exports.setFocusOnSendBox = exports.setFocusOnElement = exports.preventFocusToMoveOutOfElement = exports.parseLowerCaseString = exports.parseAdaptiveCardPayload = exports.newGuid = exports.isValidCustomEvent = exports.isUndefinedOrEmpty = exports.isThisSessionPopout = exports.isNullOrUndefined = exports.isNullOrEmptyString = void 0;
+exports.parseAdaptiveCardPayload = exports.newGuid = exports.isValidCustomEvent = exports.isUndefinedOrEmpty = exports.isThisSessionPopout = exports.isNullOrUndefined = exports.isNullOrEmptyString = void 0;
+exports.parseBooleanFromConfig = parseBooleanFromConfig;
+exports.setTabIndices = exports.setOcUserAgent = exports.setFocusOnSendBox = exports.setFocusOnElement = exports.preventFocusToMoveOutOfElement = exports.parseLowerCaseString = void 0;
 var _Constants = require("./Constants");
 var _TelemetryConstants = require("./telemetry/TelemetryConstants");
 var _omnichannelChatComponents = require("@microsoft/omnichannel-chat-components");
@@ -519,4 +521,15 @@ exports.getCustomEventValue = getCustomEventValue;
 function isEndConversationDueToOverflowActivity(activity) {
   var _activity$channelData, _activity$channelData2;
   return (activity === null || activity === void 0 ? void 0 : (_activity$channelData = activity.channelData) === null || _activity$channelData === void 0 ? void 0 : _activity$channelData.tags) && Array.isArray(activity === null || activity === void 0 ? void 0 : (_activity$channelData2 = activity.channelData) === null || _activity$channelData2 === void 0 ? void 0 : _activity$channelData2.tags) && activity.channelData.tags.includes(_Constants.Constants.EndConversationDueToOverflow);
+}
+
+/**
+ * Parses a value that can be boolean or string ("true"/"false") into a boolean.
+ * Handles null/undefined by returning false.
+ * 
+ * @param value - The value to parse (can be boolean, string, null, or undefined)
+ * @returns true if value is true or "true" (case-insensitive), false otherwise
+ */
+function parseBooleanFromConfig(value) {
+  return value === true || (value === null || value === void 0 ? void 0 : value.toString().toLowerCase()) === "true";
 }

package/lib/cjs/components/chatbuttonstateful/ChatButtonStateful.js

@@ -26,7 +26,10 @@ const ChatButtonStateful = props => {
     uiTimer = (0, _utils.createTimer)();
     _TelemetryHelper.TelemetryHelper.logLoadingEventToAllTelemetry(_TelemetryConstants.LogLevel.INFO, {
       Event: _TelemetryConstants.TelemetryEvent.UXLCWChatButtonLoadingStart,
-      Description: "Chat button loading started"
+      Description: "Chat button loading started",
+      CustomProperties: {
+        ConversationStage: _TelemetryConstants.ConversationStage.Initialization
+      }
     });
   }, []);
 
@@ -49,7 +52,10 @@ const ChatButtonStateful = props => {
   ref.current = async () => {
     _TelemetryHelper.TelemetryHelper.logActionEventToAllTelemetry(_TelemetryConstants.LogLevel.INFO, {
       Event: _TelemetryConstants.TelemetryEvent.LCWChatButtonClicked,
-      Description: "Chat button click action started"
+      Description: "Chat button click action started",
+      CustomProperties: {
+        ConversationStage: _TelemetryConstants.ConversationStage.Initialization
+      }
     });
     if (state.appStates.isMinimized) {
       dispatch({
@@ -69,7 +75,10 @@ const ChatButtonStateful = props => {
     }
     _TelemetryHelper.TelemetryHelper.logActionEventToAllTelemetry(_TelemetryConstants.LogLevel.INFO, {
       Event: _TelemetryConstants.TelemetryEvent.LCWChatButtonActionCompleted,
-      Description: "Chat button action completed"
+      Description: "Chat button action completed",
+      CustomProperties: {
+        ConversationStage: _TelemetryConstants.ConversationStage.Initialization
+      }
     });
   };
   const outOfOfficeStyleProps = Object.assign({}, _defaultOutOfOfficeChatButtonStyleProps.defaultOutOfOfficeChatButtonStyleProps, outOfOfficeButtonProps === null || outOfOfficeButtonProps === void 0 ? void 0 : outOfOfficeButtonProps.styleProps);
@@ -123,7 +132,10 @@ const ChatButtonStateful = props => {
     _TelemetryHelper.TelemetryHelper.logLoadingEventToAllTelemetry(_TelemetryConstants.LogLevel.INFO, {
       Event: _TelemetryConstants.TelemetryEvent.UXLCWChatButtonLoadingCompleted,
       Description: "Chat button loading completed",
-      ElapsedTimeInMilliseconds: uiTimer.milliSecondsElapsed
+      ElapsedTimeInMilliseconds: uiTimer.milliSecondsElapsed,
+      CustomProperties: {
+        ConversationStage: _TelemetryConstants.ConversationStage.Initialization
+      }
     });
   }, []);
   (0, _react.useEffect)(() => {

package/lib/cjs/components/citationpanestateful/CitationDim.js

@@ -0,0 +1,29 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = exports.CitationDim = void 0;
+var _react = _interopRequireDefault(require("react"));
+var _reactDom = _interopRequireDefault(require("react-dom"));
+var _DimLayer = require("../dimlayer/DimLayer");
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+const CONTAINER_SELECTOR = ".webchat__stacked-layout_container";
+const CitationDim = _ref => {
+  let {
+    brightness = "0.2"
+  } = _ref;
+  const container = document.querySelector(CONTAINER_SELECTOR);
+  if (!container) return null;
+  return /*#__PURE__*/_reactDom.default.createPortal( /*#__PURE__*/_react.default.createElement("div", {
+    style: {
+      position: "absolute",
+      inset: 0
+    }
+  }, /*#__PURE__*/_react.default.createElement(_DimLayer.DimLayer, {
+    brightness: brightness
+  })), container);
+};
+exports.CitationDim = CitationDim;
+var _default = CitationDim;
+exports.default = _default;

package/lib/cjs/components/citationpanestateful/CitationPaneStateful.js

@@ -0,0 +1,218 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = exports.CitationPaneStateful = void 0;
+var _TelemetryConstants = require("../../common/telemetry/TelemetryConstants");
+var _react = _interopRequireWildcard(require("react"));
+var _utils = require("../../common/utils");
+var _CitationDim = _interopRequireDefault(require("./CitationDim"));
+var _omnichannelChatComponents = require("@microsoft/omnichannel-chat-components");
+var _Constants = require("../../common/Constants");
+var _LiveChatWidgetActionType = require("../../contexts/common/LiveChatWidgetActionType");
+var _TelemetryHelper = require("../../common/telemetry/TelemetryHelper");
+var _defaultCitationPaneProps = require("./common/defaultProps/defaultCitationPaneProps");
+var _useChatContextStore = _interopRequireDefault(require("../../hooks/useChatContextStore"));
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function (nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
+function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || typeof obj !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
+let uiTimer;
+const CitationPaneStateful = props => {
+  var _props$styleProps3;
+  (0, _react.useEffect)(() => {
+    uiTimer = (0, _utils.createTimer)();
+    _TelemetryHelper.TelemetryHelper.logLoadingEvent(_TelemetryConstants.LogLevel.INFO, {
+      Event: _TelemetryConstants.TelemetryEvent.UXCitationPaneStart
+    });
+  }, []);
+  const initialTabIndexMap = new Map();
+  let elements = [];
+
+  // eslint-disable-next-line @typescript-eslint/no-unused-vars
+  const [state, dispatch] = (0, _useChatContextStore.default)();
+
+  // Use props.id if provided, otherwise fall back to default
+  const controlId = props.id || _Constants.HtmlAttributeNames.ocwCitationPaneClassName;
+
+  // Pane style computed to match the webchat widget container bounds so the pane
+  // stays within the widget and scrolls only vertically. We also track an
+  // "isReady" flag so we don't render the pane contents until the style is
+  // computed — this prevents a transient render that can appear as a flicker.
+  const [paneStyle, setPaneStyle] = (0, _react.useState)(null);
+  const [isReady, setIsReady] = (0, _react.useState)(false);
+
+  // Initial focus pattern (mirrors ConfirmationPaneStateful): focus first focusable element (will re-attempt after visibility becomes true)
+  (0, _react.useEffect)(() => {
+    (0, _utils.preventFocusToMoveOutOfElement)(controlId);
+    const focusableElements = (0, _utils.findAllFocusableElement)(`#${controlId}`);
+    requestAnimationFrame(() => {
+      if (focusableElements && focusableElements.length > 0 && focusableElements[0]) {
+        focusableElements[0].focus({
+          preventScroll: true
+        });
+      }
+    });
+    elements = (0, _utils.findParentFocusableElementsWithoutChildContainer)(controlId);
+    (0, _utils.setTabIndices)(elements, initialTabIndexMap, false);
+    _TelemetryHelper.TelemetryHelper.logLoadingEvent(_TelemetryConstants.LogLevel.INFO, {
+      Event: _TelemetryConstants.TelemetryEvent.CitationPaneLoaded
+    });
+    _TelemetryHelper.TelemetryHelper.logLoadingEvent(_TelemetryConstants.LogLevel.INFO, {
+      Event: _TelemetryConstants.TelemetryEvent.UXCitationPaneCompleted,
+      ElapsedTimeInMilliseconds: uiTimer.milliSecondsElapsed
+    });
+  }, []);
+
+  // Retry focus once pane is actually visible (isReady) in case initial attempt occurred while wrapper was visibility:hidden
+  (0, _react.useEffect)(() => {
+    if (!isReady) return;
+    const focusableElements = (0, _utils.findAllFocusableElement)(`#${controlId}`);
+    if (focusableElements && focusableElements.length > 0) {
+      const first = focusableElements[0];
+      // If focused element is not already inside the pane, move focus
+      if (!first.contains(document.activeElement) && !(document.activeElement && document.activeElement.id.startsWith(controlId))) {
+        requestAnimationFrame(() => {
+          if (first.isConnected) {
+            first.focus({
+              preventScroll: true
+            });
+          }
+        });
+      }
+    }
+  }, [isReady, controlId]);
+
+  // Compute the widget bounds and set pane style accordingly (95% of widget size
+  // and centered inside the widget). If the widget container can't be found,
+  // fall back to the default pane styles from defaultCitationPaneProps.
+  (0, _react.useEffect)(() => {
+    const compute = () => {
+      var _props$styleProps2;
+      try {
+        const container = document.querySelector(".webchat__stacked-layout_container");
+        if (container) {
+          var _props$styleProps;
+          const rect = container.getBoundingClientRect();
+          const widthPx = Math.round(rect.width * 0.95);
+          const heightPx = Math.round(rect.height * 0.95);
+          const leftPx = Math.round(rect.left + (rect.width - widthPx) / 2);
+          const topPx = Math.round(rect.top + (rect.height - heightPx) / 2);
+          // Clone defaults and remove transform so explicit left/top pixel
+          // coordinates are respected and the pane stays within the
+          // widget bounds.
+          const base = Object.assign({}, _defaultCitationPaneProps.defaultCitationPaneStyles.pane);
+          // eslint-disable-next-line @typescript-eslint/no-explicit-any
+          if (base && base.transform) {
+            // remove centering transform when we compute exact pixel coords
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            delete base.transform;
+          }
+
+          // Merge user styles first, then computed positioning to ensure proper positioning
+          const computedStyle = {
+            left: `${leftPx}px`,
+            top: `${topPx}px`,
+            width: `${widthPx}px`,
+            height: `${heightPx}px`
+          };
+
+          // Apply user styles first, then override with computed positioning
+          const generalProps = (_props$styleProps = props.styleProps) === null || _props$styleProps === void 0 ? void 0 : _props$styleProps.generalStyleProps;
+          const userStyles = generalProps && typeof generalProps === "object" ? Object.assign({}, generalProps) : {};
+          // Remove positioning properties from user styles that would interfere
+          delete userStyles.position;
+          delete userStyles.left;
+          delete userStyles.top;
+          delete userStyles.width;
+          delete userStyles.height;
+          setPaneStyle(Object.assign({}, base, userStyles, computedStyle));
+          // Make the pane visible after the next paint to avoid layout
+          // flashes on initial mount.
+          requestAnimationFrame(() => setIsReady(true));
+          return;
+        }
+      } catch (e) {
+        // ignore
+      }
+
+      // fallback - merge defaults with user-provided styles but preserve positioning
+      const generalProps = (_props$styleProps2 = props.styleProps) === null || _props$styleProps2 === void 0 ? void 0 : _props$styleProps2.generalStyleProps;
+      const userStyles = generalProps && typeof generalProps === "object" ? Object.assign({}, generalProps) : {};
+      // Remove positioning properties from user styles for fallback
+      delete userStyles.position;
+      delete userStyles.left;
+      delete userStyles.top;
+      delete userStyles.width;
+      delete userStyles.height;
+      const fallbackStyle = Object.assign({}, _defaultCitationPaneProps.defaultCitationPaneStyles.pane, userStyles);
+      setPaneStyle(fallbackStyle);
+      requestAnimationFrame(() => setIsReady(true));
+    };
+    compute();
+    window.addEventListener("resize", compute);
+    return () => window.removeEventListener("resize", compute);
+  }, [(_props$styleProps3 = props.styleProps) === null || _props$styleProps3 === void 0 ? void 0 : _props$styleProps3.generalStyleProps]);
+  const handleClose = () => {
+    if (props.onClose) props.onClose();
+    dispatch({
+      type: _LiveChatWidgetActionType.LiveChatWidgetActionType.SET_PREVIOUS_FOCUSED_ELEMENT_ID,
+      payload: null
+    });
+    (0, _utils.setTabIndices)(elements, initialTabIndexMap, true);
+  };
+
+  // Merge a safe style object for the container and cast to CSSProperties to satisfy TS
+  const baseStyle = Object.assign({
+    position: "relative"
+  }, paneStyle ?? {
+    position: "fixed"
+  });
+
+  // If paneStyle hasn't been computed yet, render the DimLayer so clicks
+  // still close overlays but hide the pane itself to avoid flashes.
+  const hiddenStyle = {
+    visibility: isReady ? "visible" : "hidden",
+    pointerEvents: isReady ? "auto" : "none"
+  };
+
+  // Default wrapper styles - these control the positioning container
+  const defaultWrapperStyles = {
+    display: "flex",
+    flexDirection: "column",
+    zIndex: 10001
+  };
+
+  // Wrapper styles for the positioning container
+  const wrapperStyles = Object.assign({}, baseStyle, hiddenStyle, defaultWrapperStyles);
+
+  // Merge the computed positioning styles with user's generalStyleProps for the CitationPane
+  const mergedStyleProps = props.styleProps ? {
+    ...props.styleProps,
+    generalStyleProps: Object.assign({}, props.styleProps.generalStyleProps)
+  } : undefined;
+  const controlProps = {
+    id: controlId,
+    dir: state.domainStates.globalDir,
+    titleText: props.title,
+    contentHtml: props.contentHtml,
+    brightnessValueOnDim: "0.2",
+    // Default brightness
+    onClose: handleClose,
+    ...(props === null || props === void 0 ? void 0 : props.controlProps) // User props override defaults
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  };
+
+  return /*#__PURE__*/_react.default.createElement(_react.default.Fragment, null, /*#__PURE__*/_react.default.createElement(_CitationDim.default, {
+    brightness: controlProps.brightnessValueOnDim
+  }), /*#__PURE__*/_react.default.createElement("div", {
+    style: wrapperStyles
+  }, /*#__PURE__*/_react.default.createElement(_omnichannelChatComponents.CitationPane, {
+    componentOverrides: props === null || props === void 0 ? void 0 : props.componentOverrides,
+    controlProps: controlProps,
+    styleProps: mergedStyleProps
+  })));
+};
+exports.CitationPaneStateful = CitationPaneStateful;
+var _default = CitationPaneStateful;
+exports.default = _default;