@microsoft/omnichannel-chat-widget 1.8.3-main.38c88a7 → 1.8.3-main.4743fdc

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

@@ -0,0 +1,20 @@
+import React from "react";
+import ReactDOM from "react-dom";
+import { DimLayer } from "../dimlayer/DimLayer";
+const CONTAINER_SELECTOR = ".webchat__stacked-layout_container";
+export const CitationDim = _ref => {
+  let {
+    brightness = "0.2"
+  } = _ref;
+  const container = document.querySelector(CONTAINER_SELECTOR);
+  if (!container) return null;
+  return /*#__PURE__*/ReactDOM.createPortal( /*#__PURE__*/React.createElement("div", {
+    style: {
+      position: "absolute",
+      inset: 0
+    }
+  }, /*#__PURE__*/React.createElement(DimLayer, {
+    brightness: brightness
+  })), container);
+};
+export default CitationDim;

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

@@ -0,0 +1,147 @@
+import { LogLevel, TelemetryEvent } from "../../common/telemetry/TelemetryConstants";
+import React, { useEffect, useState } from "react";
+import { createTimer, findAllFocusableElement, findParentFocusableElementsWithoutChildContainer, preventFocusToMoveOutOfElement, setTabIndices } from "../../common/utils";
+import CitationDim from "./CitationDim";
+import { CitationPane } from "@microsoft/omnichannel-chat-components";
+import { HtmlAttributeNames } from "../../common/Constants";
+import { LiveChatWidgetActionType } from "../../contexts/common/LiveChatWidgetActionType";
+import { TelemetryHelper } from "../../common/telemetry/TelemetryHelper";
+import { defaultCitationPaneStyles } from "./common/defaultProps/defaultCitationPaneProps";
+import useChatContextStore from "../../hooks/useChatContextStore";
+let uiTimer;
+export const CitationPaneStateful = props => {
+  useEffect(() => {
+    uiTimer = createTimer();
+    TelemetryHelper.logLoadingEvent(LogLevel.INFO, {
+      Event: TelemetryEvent.UXCitationPaneStart
+    });
+  }, []);
+  const initialTabIndexMap = new Map();
+  let elements = [];
+
+  // eslint-disable-next-line @typescript-eslint/no-unused-vars
+  const [state, dispatch] = useChatContextStore();
+  const controlId = 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] = useState(null);
+  const [isReady, setIsReady] = useState(false);
+
+  // Move focus to the container
+  useEffect(() => {
+    preventFocusToMoveOutOfElement(controlId);
+    const focusableElements = findAllFocusableElement(`#${controlId}`);
+    requestAnimationFrame(() => {
+      if (focusableElements && focusableElements.length > 0 && focusableElements[0]) {
+        focusableElements[0].focus({
+          preventScroll: true
+        });
+      }
+    });
+    elements = findParentFocusableElementsWithoutChildContainer(controlId);
+    setTabIndices(elements, initialTabIndexMap, false);
+    TelemetryHelper.logLoadingEvent(LogLevel.INFO, {
+      Event: TelemetryEvent.CitationPaneLoaded
+    });
+    TelemetryHelper.logLoadingEvent(LogLevel.INFO, {
+      Event: TelemetryEvent.UXCitationPaneCompleted,
+      ElapsedTimeInMilliseconds: uiTimer.milliSecondsElapsed
+    });
+  }, []);
+
+  // 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.
+  useEffect(() => {
+    const compute = () => {
+      try {
+        const container = document.querySelector(".webchat__stacked-layout_container");
+        if (container) {
+          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({}, 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;
+          }
+          setPaneStyle(Object.assign({}, base, {
+            left: `${leftPx}px`,
+            top: `${topPx}px`,
+            width: `${widthPx}px`,
+            height: `${heightPx}px`
+          }));
+          // Make the pane visible after the next paint to avoid layout
+          // flashes on initial mount.
+          requestAnimationFrame(() => setIsReady(true));
+          return;
+        }
+      } catch (e) {
+        // ignore
+      }
+
+      // fallback
+      setPaneStyle(defaultCitationPaneStyles.pane);
+      requestAnimationFrame(() => setIsReady(true));
+    };
+    compute();
+    window.addEventListener("resize", compute);
+    return () => window.removeEventListener("resize", compute);
+  }, []);
+  const handleClose = () => {
+    if (props.onClose) props.onClose();
+    dispatch({
+      type: LiveChatWidgetActionType.SET_PREVIOUS_FOCUSED_ELEMENT_ID,
+      payload: null
+    });
+    setTabIndices(elements, initialTabIndexMap, true);
+  };
+
+  // Merge a safe style object for the container and cast to CSSProperties to satisfy TS
+  const mergedStyle = 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"
+  };
+  const controlProps = {
+    id: controlId,
+    dir: state.domainStates.globalDir,
+    titleText: props.title,
+    contentHtml: props.contentHtml,
+    brightnessValueOnDim: "0.2",
+    onClose: handleClose,
+    ...(props === null || props === void 0 ? void 0 : props.controlProps)
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  };
+
+  return /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(CitationDim, {
+    brightness: "0.2"
+  }), /*#__PURE__*/React.createElement("div", {
+    style: Object.assign({}, mergedStyle, hiddenStyle, {
+      display: "flex",
+      flexDirection: "column",
+      zIndex: 10001
+    })
+  }, /*#__PURE__*/React.createElement(CitationPane, {
+    controlProps: controlProps,
+    styleProps: props === null || props === void 0 ? void 0 : props.styleProps
+  })));
+};
+export default CitationPaneStateful;

package/lib/esm/components/citationpanestateful/common/defaultProps/defaultCitationPaneProps.js

@@ -0,0 +1,61 @@
+export const defaultCitationPaneStyles = {
+  pane: {
+    position: "fixed",
+    left: "50%",
+    top: "18%",
+    transform: "translateX(-50%)",
+    background: "#fff",
+    width: "85%",
+    height: "85%",
+    overflowY: "auto",
+    overflowX: "hidden",
+    padding: 16,
+    borderRadius: 6,
+    zIndex: 10001,
+    boxSizing: "border-box"
+  }
+};
+export const defaultCitationContentCSS = controlId => `
+    #${controlId} .citation-content {
+        flex: 1;
+        min-height: 0; /* allow flex child to scroll */
+        overflow-y: auto;
+        overflow-x: auto;
+        margin-bottom: 12px;
+        white-space: normal; /* wrap normal text */
+        word-break: break-word;
+        -webkit-overflow-scrolling: touch;
+    }
+
+    #${controlId} .citation-content pre,
+    #${controlId} .citation-content code {
+        white-space: pre; /* preserve formatting */
+    }
+
+    #${controlId} .citation-content table {
+        width: 100%;
+        border-collapse: collapse;
+        margin-bottom: 12px;
+        table-layout: auto;
+        overflow-x: auto;
+        display: block;
+    }
+
+    #${controlId} .citation-content table th,
+    #${controlId} .citation-content table td {
+        padding: 8px 12px;
+        border: 1px solid rgba(0,0,0,0.08);
+        text-align: left;
+        vertical-align: top;
+        word-break: break-word;
+    }
+
+    #${controlId} .citation-content img {
+        max-width: 100%;
+        height: auto;
+    }
+`;
+export default {
+  defaultCitationPaneStyles,
+  defaultCitationContentCSS
+};

package/lib/esm/components/confirmationpanestateful/interfaces/IConfirmationPaneLocalizedTexts.js

@@ -0,0 +1 @@
+export {};

package/lib/esm/components/livechatwidget/common/endChat.js

@@ -39,7 +39,7 @@ const prepareEndChat = async (props, facadeChatSDK, state, dispatch, setAdapter,
       }
 
       // Use Case: If ended by Agent, stay chat in InActive state
-      let isConversationalSurveyEnabled = state.appStates.isConversationalSurveyEnabled;
+      const isConversationalSurveyEnabled = state.appStates.isConversationalSurveyEnabled;
       if (isConversationalSurveyEnabled && ((state === null || state === void 0 ? void 0 : (_state$appStates2 = state.appStates) === null || _state$appStates2 === void 0 ? void 0 : _state$appStates2.conversationEndedBy) === ConversationEndEntity.Agent || (state === null || state === void 0 ? void 0 : (_state$appStates3 = state.appStates) === null || _state$appStates3 === void 0 ? void 0 : _state$appStates3.conversationEndedBy) === ConversationEndEntity.Bot)) {
         dispatch({
           type: LiveChatWidgetActionType.SET_CONVERSATION_STATE,
@@ -211,7 +211,7 @@ const endChat = async (props, facadeChatSDK, state, dispatch, setAdapter, setWeb
         payload: undefined
       });
       // Always allow to close the chat for embedded mode irrespective of end chat errors
-      closeChatWidget(dispatch);
+      closeChatWidget(dispatch, setWebChatStyles, props);
       facadeChatSDK.destroy();
     }
   }
@@ -296,6 +296,10 @@ export const closeChatStateCleanUp = dispatch => {
       proactiveChatInNewWindow: false
     }
   });
+  dispatch({
+    type: LiveChatWidgetActionType.SET_CITATIONS,
+    payload: {}
+  });
 
   // Clear live chat context only if chat widget is fully closed to support transcript calls after sessionclose is called
   dispatch({
@@ -339,12 +343,22 @@ export const endVoiceVideoCallIfOngoing = async (facadeChatSDK, dispatch) => {
     }, callId);
   }
 };
-const closeChatWidget = dispatch => {
+
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const closeChatWidget = (dispatch, setWebChatStyles, props) => {
+  var _props$webChatContain2, _props$webChatContain3;
   // Embedded chat
   dispatch({
     type: LiveChatWidgetActionType.SET_CONVERSATION_STATE,
     payload: ConversationState.Closed
   });
+
+  // if customer is setting the hideSendbox, we should not alter its value
+  if ((props === null || props === void 0 ? void 0 : (_props$webChatContain2 = props.webChatContainerProps) === null || _props$webChatContain2 === void 0 ? void 0 : (_props$webChatContain3 = _props$webChatContain2.webChatStyles) === null || _props$webChatContain3 === void 0 ? void 0 : _props$webChatContain3.hideSendBox) === true) return;
+  setWebChatStyles(styles => ({
+    ...styles,
+    hideSendBox: false
+  }));
 };
 
 // eslint-disable-next-line @typescript-eslint/no-explicit-any

package/lib/esm/components/livechatwidget/common/initWebChatComposer.js

@@ -1,6 +1,9 @@
 import { ConversationEndEntity, ParticipantType } from "../../../common/Constants";
 import { LogLevel, TelemetryEvent } from "../../../common/telemetry/TelemetryConstants";
 import { changeLanguageCodeFormatForWebChat, getConversationDetailsCall } from "../../../common/utils";
+import { BroadcastService } from "@microsoft/omnichannel-chat-components";
+import { Constants } from "../../../common/Constants";
+import { ConversationState } from "../../../contexts/common/ConversationState";
 import DOMPurify from "dompurify";
 import HyperlinkTextOverrideRenderer from "../../webchatcontainerstateful/webchatcontroller/markdownrenderers/HyperlinkTextOverrideRenderer";
 import { LiveChatWidgetActionType } from "../../../contexts/common/LiveChatWidgetActionType";
@@ -12,36 +15,35 @@ import { createActivityMiddleware } from "../../webchatcontainerstateful/webchat
 import { createAttachmentMiddleware } from "../../webchatcontainerstateful/webchatcontroller/middlewares/renderingmiddlewares/attachmentMiddleware";
 import createAttachmentUploadValidatorMiddleware from "../../webchatcontainerstateful/webchatcontroller/middlewares/storemiddlewares/attachmentUploadValidatorMiddleware";
 import { createAvatarMiddleware } from "../../webchatcontainerstateful/webchatcontroller/middlewares/renderingmiddlewares/avatarMiddleware";
+import createCallActionMiddleware from "../../webchatcontainerstateful/webchatcontroller/middlewares/storemiddlewares/callActionMiddleware";
 import { createCardActionMiddleware } from "../../webchatcontainerstateful/webchatcontroller/middlewares/renderingmiddlewares/cardActionMiddleware";
+import { createCitationsMiddleware } from "../../webchatcontainerstateful/webchatcontroller/middlewares/storemiddlewares/citationsMiddleware";
 import createConversationEndMiddleware from "../../webchatcontainerstateful/webchatcontroller/middlewares/storemiddlewares/conversationEndMiddleware";
+import createCustomEventMiddleware from "../../webchatcontainerstateful/webchatcontroller/middlewares/storemiddlewares/customEventMiddleware";
 import createDataMaskingMiddleware from "../../webchatcontainerstateful/webchatcontroller/middlewares/storemiddlewares/dataMaskingMiddleware";
 import { createMarkdown } from "./createMarkdown";
 import createMaxMessageSizeValidator from "../../webchatcontainerstateful/webchatcontroller/middlewares/storemiddlewares/maxMessageSizeValidator";
 import { createMessageSequenceIdOverrideMiddleware } from "../../webchatcontainerstateful/webchatcontroller/middlewares/renderingmiddlewares/messageSequenceIdOverrideMiddleware";
 import { createMessageTimeStampMiddleware } from "../../webchatcontainerstateful/webchatcontroller/middlewares/renderingmiddlewares/messageTimestampMiddleware";
+import { createQueueOverflowMiddleware } from "../../webchatcontainerstateful/webchatcontroller/middlewares/storemiddlewares/queueOverflowHandlerMiddleware";
 import { createStore } from "botframework-webchat";
 import { createToastMiddleware } from "../../webchatcontainerstateful/webchatcontroller/middlewares/renderingmiddlewares/toastMiddleware";
 import { createWebChatTelemetry } from "../../webchatcontainerstateful/webchatcontroller/webchattelemetry/WebChatLogger";
 import { defaultAttachmentProps } from "../../webchatcontainerstateful/common/defaultProps/defaultAttachmentProps";
 import { defaultMiddlewareLocalizedTexts } from "../../webchatcontainerstateful/common/defaultProps/defaultMiddlewareLocalizedTexts";
 import { defaultWebChatContainerStatefulProps } from "../../webchatcontainerstateful/common/defaultProps/defaultWebChatContainerStatefulProps";
+import { executeReducer } from "../../../contexts/createReducer";
 import { getLocaleStringFromId } from "@microsoft/omnichannel-chat-sdk";
 import gifUploadMiddleware from "../../webchatcontainerstateful/webchatcontroller/middlewares/storemiddlewares/gifUploadMiddleware";
 import htmlPlayerMiddleware from "../../webchatcontainerstateful/webchatcontroller/middlewares/storemiddlewares/htmlPlayerMiddleware";
 import htmlTextMiddleware from "../../webchatcontainerstateful/webchatcontroller/middlewares/storemiddlewares/htmlTextMiddleware";
 import preProcessingMiddleware from "../../webchatcontainerstateful/webchatcontroller/middlewares/storemiddlewares/preProcessingMiddleware";
 import sanitizationMiddleware from "../../webchatcontainerstateful/webchatcontroller/middlewares/storemiddlewares/sanitizationMiddleware";
-import { Constants } from "../../../common/Constants";
-import createCallActionMiddleware from "../../webchatcontainerstateful/webchatcontroller/middlewares/storemiddlewares/callActionMiddleware";
-import createCustomEventMiddleware from "../../webchatcontainerstateful/webchatcontroller/middlewares/storemiddlewares/customEventMiddleware";
-import { ConversationState } from "../../../contexts/common/ConversationState";
-import { executeReducer } from "../../../contexts/createReducer";
-import { createQueueOverflowMiddleware } from "../../webchatcontainerstateful/webchatcontroller/middlewares/storemiddlewares/queueOverflowHandlerMiddleware";
-import { BroadcastService } from "@microsoft/omnichannel-chat-components";
+import { localizedStringsBotInitialsMiddleware, getOverriddenLocalizedStrings } from "../../webchatcontainerstateful/webchatcontroller/middlewares/storemiddlewares/localizedStringsBotInitialsMiddleware";
 
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 export const initWebChatComposer = (props, state, dispatch, facadeChatSDK, endChat) => {
-  var _props$webChatContain, _props$webChatContain2, _props$webChatContain3, _props$webChatContain4, _props$webChatContain5, _props$webChatContain6, _state$domainStates$l4, _state$domainStates$l5, _props$webChatContain11, _props$webChatContain12, _state$domainStates$r, _state$domainStates$r2, _props$webChatContain13, _props$webChatContain14, _state$domainStates$r3, _state$domainStates$r4, _props$webChatContain15, _props$webChatContain16, _defaultWebChatContai, _props$webChatContain17, _props$webChatContain18, _props$webChatContain19, _props$webChatContain20, _state$domainStates$r5, _state$domainStates$r6, _props$webChatContain21, _props$webChatContain22, _defaultWebChatContai2, _props$webChatContain23, _props$webChatContain24, _defaultWebChatContai3, _props$webChatContain25, _props$webChatContain26;
+  var _props$webChatContain, _props$webChatContain2, _props$webChatContain3, _props$webChatContain4, _props$webChatContain5, _props$webChatContain6, _state$domainStates$l4, _state$domainStates$l5, _props$webChatContain11, _props$webChatContain12, _state$domainStates$r, _state$domainStates$r2, _props$webChatContain13, _props$webChatContain14, _state$domainStates$r3, _state$domainStates$r4, _props$webChatContain15, _props$webChatContain16, _defaultWebChatContai, _props$webChatContain17, _props$webChatContain18, _props$webChatContain19, _props$webChatContain20, _state$domainStates$r5, _state$domainStates$r6, _props$webChatContain21, _props$webChatContain22, _defaultWebChatContai2, _props$webChatContain23, _props$webChatContain24, _defaultWebChatContai3, _props$webChatContain25, _props$webChatContain26, _props$webChatContain27, _props$webChatContain28;
   // Add a hook to make all links open a new window
   postDomPurifyActivities();
   const localizedTexts = {
@@ -116,7 +118,7 @@ export const initWebChatComposer = (props, state, dispatch, facadeChatSDK, endCh
     };
     webChatStore = createStore({},
     //initial state
-    preProcessingMiddleware, attachmentProcessingMiddleware, createAttachmentUploadValidatorMiddleware((_state$domainStates$l = state.domainStates.liveChatConfig) === null || _state$domainStates$l === void 0 ? void 0 : _state$domainStates$l.allowedFileExtensions, (_state$domainStates$l2 = state.domainStates.liveChatConfig) === null || _state$domainStates$l2 === void 0 ? void 0 : _state$domainStates$l2.maxUploadFileSize, localizedTexts), createCustomEventMiddleware(BroadcastService), createQueueOverflowMiddleware(state, dispatch), channelDataMiddleware(addConversationalSurveyTagsCallback), createConversationEndMiddleware(conversationEndCallback, startConversationalSurveyCallback, endConversationalSurveyCallback), createDataMaskingMiddleware((_state$domainStates$l3 = state.domainStates.liveChatConfig) === null || _state$domainStates$l3 === void 0 ? void 0 : _state$domainStates$l3.DataMaskingInfo), createMessageTimeStampMiddleware, createMessageSequenceIdOverrideMiddleware, gifUploadMiddleware, htmlPlayerMiddleware, htmlTextMiddleware(honorsTargetInHTMLLinks), createMaxMessageSizeValidator(localizedTexts), sanitizationMiddleware, createCallActionMiddleware(),
+    preProcessingMiddleware, attachmentProcessingMiddleware, createAttachmentUploadValidatorMiddleware((_state$domainStates$l = state.domainStates.liveChatConfig) === null || _state$domainStates$l === void 0 ? void 0 : _state$domainStates$l.allowedFileExtensions, (_state$domainStates$l2 = state.domainStates.liveChatConfig) === null || _state$domainStates$l2 === void 0 ? void 0 : _state$domainStates$l2.maxUploadFileSize, localizedTexts), createCustomEventMiddleware(BroadcastService), createQueueOverflowMiddleware(state, dispatch), channelDataMiddleware(addConversationalSurveyTagsCallback), createConversationEndMiddleware(conversationEndCallback, startConversationalSurveyCallback, endConversationalSurveyCallback), createDataMaskingMiddleware((_state$domainStates$l3 = state.domainStates.liveChatConfig) === null || _state$domainStates$l3 === void 0 ? void 0 : _state$domainStates$l3.DataMaskingInfo), createMessageTimeStampMiddleware, createMessageSequenceIdOverrideMiddleware, createCitationsMiddleware(state, dispatch), gifUploadMiddleware, htmlPlayerMiddleware, htmlTextMiddleware(honorsTargetInHTMLLinks), createMaxMessageSizeValidator(localizedTexts), sanitizationMiddleware, createCallActionMiddleware(), localizedStringsBotInitialsMiddleware(),
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     ...(((_props$webChatContain7 = props.webChatContainerProps) === null || _props$webChatContain7 === void 0 ? void 0 : _props$webChatContain7.storeMiddlewares) ?? []));
     WebChatStoreLoader.store = webChatStore;
@@ -170,7 +172,8 @@ export const initWebChatComposer = (props, state, dispatch, facadeChatSDK, endCh
     onTelemetry: createWebChatTelemetry(),
     cardActionMiddleware: createCardActionMiddleware(((_props$webChatContain25 = props.webChatContainerProps) === null || _props$webChatContain25 === void 0 ? void 0 : _props$webChatContain25.botMagicCode) || undefined),
     sendTypingIndicator: true,
-    ...((_props$webChatContain26 = props.webChatContainerProps) === null || _props$webChatContain26 === void 0 ? void 0 : _props$webChatContain26.webChatProps)
+    overrideLocalizedStrings: getOverriddenLocalizedStrings((_props$webChatContain26 = props.webChatContainerProps) === null || _props$webChatContain26 === void 0 ? void 0 : (_props$webChatContain27 = _props$webChatContain26.webChatProps) === null || _props$webChatContain27 === void 0 ? void 0 : _props$webChatContain27.overrideLocalizedStrings),
+    ...((_props$webChatContain28 = props.webChatContainerProps) === null || _props$webChatContain28 === void 0 ? void 0 : _props$webChatContain28.webChatProps)
   };
   return webChatProps;
 };

package/lib/esm/components/livechatwidget/common/startChat.js

@@ -1,5 +1,6 @@
 import { BroadcastEvent, LogLevel, TelemetryEvent } from "../../../common/telemetry/TelemetryConstants";
 import { Constants, LiveWorkItemState, WidgetLoadTelemetryMessage } from "../../../common/Constants";
+import { TelemetryManager, TelemetryTimers } from "../../../common/telemetry/TelemetryManager";
 import { checkContactIdError, createTimer, getConversationDetailsCall, getStateFromCache, getWidgetCacheIdfromProps, isNullOrEmptyString, isNullOrUndefined, isUndefinedOrEmpty } from "../../../common/utils";
 import { handleChatReconnect, isPersistentEnabled, isReconnectEnabled } from "./reconnectChatHelper";
 import { handleStartChatError, logWidgetLoadComplete } from "./startChatErrorHandler";
@@ -8,7 +9,6 @@ import { BroadcastService } from "@microsoft/omnichannel-chat-components";
 import { ConversationState } from "../../../contexts/common/ConversationState";
 import { LiveChatWidgetActionType } from "../../../contexts/common/LiveChatWidgetActionType";
 import { TelemetryHelper } from "../../../common/telemetry/TelemetryHelper";
-import { TelemetryTimers } from "../../../common/telemetry/TelemetryManager";
 import { chatSDKStateCleanUp } from "./endChat";
 import { createAdapter } from "./createAdapter";
 import { createOnNewAdapterActivityHandler } from "../../../plugins/newMessageEventHandler";
@@ -131,7 +131,7 @@ const setPreChatAndInitiateChat = async (facadeChatSDK, dispatch, setAdapter, is
    * This is because a new change to control OOH as closed event when a widget is coming from chat.
    */
   if ((state === null || state === void 0 ? void 0 : state.appStates.isMinimized) === undefined || (state === null || state === void 0 ? void 0 : (_state$appStates2 = state.appStates) === null || _state$appStates2 === void 0 ? void 0 : _state$appStates2.isMinimized) === true) {
-    var _state$domainStates5, _state$domainStates5$, _state$domainStates6, _state$domainStates6$;
+    var _state$domainStates5, _state$domainStates5$, _state$domainStates6, _state$domainStates6$, _TelemetryManager$Int;
     dispatch({
       type: LiveChatWidgetActionType.SET_MINIMIZED,
       payload: false
@@ -141,7 +141,8 @@ const setPreChatAndInitiateChat = async (facadeChatSDK, dispatch, setAdapter, is
       eventName: BroadcastEvent.MaximizeChat,
       payload: {
         height: state === null || state === void 0 ? void 0 : (_state$domainStates5 = state.domainStates) === null || _state$domainStates5 === void 0 ? void 0 : (_state$domainStates5$ = _state$domainStates5.widgetSize) === null || _state$domainStates5$ === void 0 ? void 0 : _state$domainStates5$.height,
-        width: state === null || state === void 0 ? void 0 : (_state$domainStates6 = state.domainStates) === null || _state$domainStates6 === void 0 ? void 0 : (_state$domainStates6$ = _state$domainStates6.widgetSize) === null || _state$domainStates6$ === void 0 ? void 0 : _state$domainStates6$.width
+        width: state === null || state === void 0 ? void 0 : (_state$domainStates6 = state.domainStates) === null || _state$domainStates6 === void 0 ? void 0 : (_state$domainStates6$ = _state$domainStates6.widgetSize) === null || _state$domainStates6$ === void 0 ? void 0 : _state$domainStates6$.width,
+        runtimeId: TelemetryManager === null || TelemetryManager === void 0 ? void 0 : (_TelemetryManager$Int = TelemetryManager.InternalTelemetryData) === null || _TelemetryManager$Int === void 0 ? void 0 : _TelemetryManager$Int.lcwRuntimeId
       }
     });
   }

package/lib/esm/components/livechatwidget/livechatwidgetstateful/LiveChatWidgetStateful.js

@@ -9,6 +9,7 @@ import { TelemetryManager, TelemetryTimers } from "../../../common/telemetry/Tel
 import { chatSDKStateCleanUp, endChat, endChatStateCleanUp, prepareEndChat } from "../common/endChat";
 import { checkIfConversationStillValid, initStartChat, prepareStartChat, setPreChatAndInitiateChat } from "../common/startChat";
 import { createTimer, getBroadcastChannelName, getConversationDetailsCall, getLocaleDirection, getStateFromCache, getWidgetCacheIdfromProps, getWidgetEndChatEventName, isNullOrEmptyString, isNullOrUndefined, isThisSessionPopout, isUndefinedOrEmpty, setOcUserAgent } from "../../../common/utils";
+import { customEventCallback, subscribeToSendCustomEvent } from "../common/customEventHandler";
 import { defaultClientDataStoreProvider, isCookieAllowed } from "../../../common/storage/default/defaultClientDataStoreProvider";
 import { handleChatReconnect, isPersistentEnabled, isReconnectEnabled } from "../common/reconnectChatHelper";
 import { shouldShowCallingContainer, shouldShowChatButton, shouldShowConfirmationPane, shouldShowEmailTranscriptPane, shouldShowHeader, shouldShowLoadingPane, shouldShowOutOfOfficeHoursPane, shouldShowPostChatLoadingPane, shouldShowPostChatSurveyPane, shouldShowPreChatSurveyPane, shouldShowProactiveChatPane, shouldShowReconnectChatPane, shouldShowStartChatErrorPane, shouldShowWebChatContainer } from "../../../controller/componentController";
@@ -53,7 +54,6 @@ import { startProactiveChat } from "../common/startProactiveChat";
 import useChatAdapterStore from "../../../hooks/useChatAdapterStore";
 import useChatContextStore from "../../../hooks/useChatContextStore";
 import useFacadeSDKStore from "../../../hooks/useFacadeChatSDKStore";
-import { customEventCallback, subscribeToSendCustomEvent } from "../common/customEventHandler";
 let uiTimer;
 export const LiveChatWidgetStateful = props => {
   var _props$webChatContain, _props$webChatContain2, _props$webChatContain3, _props$webChatContain4, _props$webChatContain5, _props$webChatContain6, _props$webChatContain7, _props$webChatContain8, _props$webChatContain9, _props$styleProps, _props$webChatContain10, _props$webChatContain11, _props$controlProps, _props$controlProps3, _state$appStates7, _props$webChatContain15, _state$appStates14, _props$webChatContain17, _props$webChatContain18, _props$controlProps12, _props$draggableChatW, _props$draggableChatW2, _props$draggableChatW3, _props$draggableChatW4, _props$draggableChatW5, _livechatProps$webCha, _livechatProps$styleP, _livechatProps$contro, _livechatProps$contro2, _livechatProps$compon, _livechatProps$contro3, _livechatProps$compon2, _livechatProps$contro4, _livechatProps$compon3, _livechatProps$contro5, _livechatProps$compon4, _livechatProps$contro6, _livechatProps$compon5, _livechatProps$contro7, _livechatProps$compon6, _livechatProps$contro8, _livechatProps$compon7, _livechatProps$contro9, _livechatProps$compon8, _livechatProps$contro10, _livechatProps$contro11, _livechatProps$compon9, _livechatProps$contro12, _livechatProps$compon10, _livechatProps$contro13, _livechatProps$compon11, _livechatProps$compon12, _livechatProps$compon13;
@@ -719,11 +719,7 @@ export const LiveChatWidgetStateful = props => {
       endChat(props, facadeChatSDK, state, dispatch, setAdapter, setWebChatStyles, adapter, false, false, true);
       return;
     }
-    const inMemoryState = executeReducer(state, {
-      type: LiveChatWidgetActionType.GET_IN_MEMORY_STATE,
-      payload: null
-    });
-    let isConversationalSurveyEnabled = state.appStates.isConversationalSurveyEnabled;
+    const isConversationalSurveyEnabled = state.appStates.isConversationalSurveyEnabled;
 
     // In conversational survey, we need to check post chat survey logics before we set ConversationState to InActive
     // Hence setting ConversationState to InActive will be done later in the post chat flows
@@ -896,11 +892,21 @@ export const LiveChatWidgetStateful = props => {
             .webchat__basic-transcript__activity-markdown-body > :first-child {
                 margin-top: 0px;
             }
+                
             .webchat__basic-transcript__activity-markdown-body img.webchat__render-markdown__external-link-icon {
                 background-image : url(data:image/svg+xml;base64,PHN2ZyB2aWV3Qm94PSIzIDMgMTggMTgiIGZpbGw9Im5vbmUiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyI+PHBhdGggZD0iTTcuMjUwMSA0LjUwMDE3SDEwLjc0OTVDMTEuMTYzNyA0LjUwMDE3IDExLjQ5OTUgNC44MzU5NiAxMS40OTk1IDUuMjUwMTdDMTEuNDk5NSA1LjYyOTg2IDExLjIxNzMgNS45NDM2NiAxMC44NTEzIDUuOTkzMzJMMTAuNzQ5NSA2LjAwMDE3SDcuMjQ5NzRDNi4wNzA3OSA1Ljk5OTYxIDUuMTAzNDkgNi45MDY1NiA1LjAwNzg2IDguMDYxMTJMNS4wMDAyOCA4LjIyMDAzTDUuMDAzMTIgMTYuNzUwN0M1LjAwMzQzIDE3Ljk0MTUgNS45Mjg4NSAxOC45MTYxIDcuMDk5NjYgMTguOTk0OUw3LjI1MzcxIDE5LjAwMDFMMTUuNzUxOCAxOC45ODg0QzE2Ljk0MTUgMTguOTg2OCAxNy45MTQ1IDE4LjA2MiAxNy45OTM1IDE2Ljg5MjNMMTcuOTk4NyAxNi43Mzg0VjEzLjIzMjFDMTcuOTk4NyAxMi44MTc5IDE4LjMzNDUgMTIuNDgyMSAxOC43NDg3IDEyLjQ4MjFDMTkuMTI4NCAxMi40ODIxIDE5LjQ0MjIgMTIuNzY0MyAxOS40OTE4IDEzLjEzMDNMMTkuNDk4NyAxMy4yMzIxVjE2LjczODRDMTkuNDk4NyAxOC43NDA3IDE3LjkyOTMgMjAuMzc2OSAxNS45NTI4IDIwLjQ4MjlMMTUuNzUzOCAyMC40ODg0TDcuMjU4MjcgMjAuNTAwMUw3LjA1NDk1IDIwLjQ5NDlDNS4xNDIzOSAyMC4zOTU0IDMuNjA4OTUgMTguODYyNyAzLjUwODM3IDE2Ljk1MDJMMy41MDMxMiAxNi43NTExTDMuNTAwODkgOC4yNTI3TDMuNTA1MjkgOC4wNTAyQzMuNjA1MzkgNi4xMzc0OSA1LjEzODY3IDQuNjA0NDkgNy4wNTA5NiA0LjUwNTI3TDcuMjUwMSA0LjUwMDE3SDEwLjc0OTVINy4yNTAxWk0xMy43NDgxIDMuMDAxNDZMMjAuMzAxOCAzLjAwMTk3TDIwLjQwMTQgMy4wMTU3NUwyMC41MDIyIDMuMDQzOTNMMjAuNTU5IDMuMDY4MDNDMjAuNjEyMiAzLjA5MTIyIDIwLjY2MzQgMy4xMjE2MyAyMC43MTExIDMuMTU4ODVMMjAuNzgwNCAzLjIyMTU2TDIwLjg2NDEgMy4zMjAxNEwyMC45MTgzIDMuNDEwMjVMMjAuOTU3IDMuNTAwNTdMMjAuOTc2MiAzLjU2NDc2TDIwLjk4OTggMy42Mjg2MkwyMC45OTkyIDMuNzIyODJMMjAuOTk5NyAxMC4yNTU0QzIwLjk5OTcgMTAuNjY5NiAyMC42NjM5IDExLjAwNTQgMjAuMjQ5NyAxMS4wMDU0QzE5Ljg3IDExLjAwNTQgMTkuNTU2MiAxMC43MjMyIDE5LjUwNjUgMTAuMzU3MUwxOS40OTk3IDEwLjI1NTRMMTkuNDk4OSA1LjU2MTQ3TDEyLjI3OTcgMTIuNzg0N0MxMi4wMTM0IDEzLjA1MSAxMS41OTY4IDEzLjA3NTMgMTEuMzAzMSAxMi44NTc1TDExLjIxOSAxMi43ODQ5QzEwLjk1MjcgMTIuNTE4NyAxMC45Mjg0IDEyLjEwMjEgMTEuMTQ2MiAxMS44MDg0TDExLjIxODggMTEuNzI0M0wxOC40MzY5IDQuNTAxNDZIMTMuNzQ4MUMxMy4zNjg0IDQuNTAxNDYgMTMuMDU0NiA0LjIxOTMxIDEzLjAwNSAzLjg1MzI0TDEyLjk5ODEgMy43NTE0NkMxMi45OTgxIDMuMzcxNzcgMTMuMjgwMyAzLjA1Nzk3IDEzLjY0NjQgMy4wMDgzMUwxMy43NDgxIDMuMDAxNDZaIiBmaWxsPSIjMjEyMTIxIiAvPjwvc3ZnPg==) !important;
                 height: .75em;
                 margin-left: .25em;
             }
+
+            .webchat__link-definitions__header-text {
+                color: ${bubbleBackground}
+            }
+            
+            .webchat__link-definitions__header-chevron {
+                color: ${bubbleBackground}
+            }
+
             ${(sendBoxTextArea === null || sendBoxTextArea === void 0 ? void 0 : sendBoxTextArea.minHeight) && `
             .webchat__auto-resize-textarea.webchat__send-box-text-box__text-area {
                 min-height: ${sendBoxTextArea === null || sendBoxTextArea === void 0 ? void 0 : sendBoxTextArea.minHeight} !important;

package/lib/esm/components/webchatcontainerstateful/WebChatContainerStateful.js

@@ -1,11 +1,10 @@
-/* eslint-disable @typescript-eslint/no-explicit-any */
-
 import { Constants, HtmlAttributeNames, HtmlClassNames } from "../../common/Constants";
 import { Stack } from "@fluentui/react";
 import { LogLevel, TelemetryEvent } from "../../common/telemetry/TelemetryConstants";
-import React, { useEffect } from "react";
+import React, { useEffect, useRef, useState } from "react";
 import { createTimer, getDeviceType, setFocusOnSendBox } from "../../common/utils";
 import { BotMagicCodeStore } from "./webchatcontroller/BotMagicCodeStore";
+import CitationPaneStateful from "../citationpanestateful/CitationPaneStateful";
 import { Components } from "botframework-webchat";
 import { LiveChatWidgetActionType } from "../../contexts/common/LiveChatWidgetActionType";
 import { NotificationHandler } from "./webchatcontroller/notification/NotificationHandler";
@@ -23,6 +22,7 @@ import { defaultWebChatContainerStatefulProps } from "./common/defaultProps/defa
 import { useChatContextStore } from "../..";
 let uiTimer;
 const broadcastChannelMessageEvent = "message";
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
 const postActivity = activity => {
   // eslint-disable-line @typescript-eslint/no-explicit-any
   return {
@@ -55,6 +55,17 @@ export const WebChatContainerStateful = props => {
       Event: TelemetryEvent.UXWebchatContainerCompleted
     });
   }, []);
+
+  // Citation pane state
+  const [citationPaneOpen, setCitationPaneOpen] = useState(false);
+  const [citationPaneText, setCitationPaneText] = useState("");
+
+  // Guard to prevent handling multiple rapid clicks which could cause
+  // the dim layer and pane to re-render out of sync and create a flicker.
+  const citationOpeningRef = useRef(false);
+
+  // ...existing code...
+
   const {
     BasicWebChat
   } = Components;
@@ -63,6 +74,53 @@ export const WebChatContainerStateful = props => {
     webChatContainerProps,
     contextDataStore
   } = props;
+
+  // Delegated click handler for citation anchors. Placed after state is
+  // available so we can prefer reading citations from app state and fall
+  // back to the legacy window map for backward-compatibility in tests.
+  useEffect(() => {
+    const clickHandler = ev => {
+      try {
+        if (citationOpeningRef.current) {
+          return;
+        }
+        const target = ev.target;
+        // Only consider anchors whose href starts with the citation scheme
+        const anchor = target.closest && target.closest("a[href^=\"cite:\"]");
+        if (anchor) {
+          ev.preventDefault();
+          citationOpeningRef.current = true;
+          // Rely only on the href to identify the citation key
+          let text = "";
+          try {
+            var _state$domainStates;
+            const cid = anchor.getAttribute("href");
+            // Prefer state-based citations injected by middleware
+            if (state !== null && state !== void 0 && (_state$domainStates = state.domainStates) !== null && _state$domainStates !== void 0 && _state$domainStates.citations && cid) {
+              text = state.domainStates.citations[cid] ?? "";
+            }
+            // If state lookup failed, fall back to the anchor's title or innerText
+            if (!text) {
+              text = anchor.getAttribute("title") || anchor.innerText || "";
+            }
+          } catch (e) {
+            // ignore
+          }
+          setCitationPaneOpen(true);
+          setCitationPaneText(text);
+
+          // Simple debounce - reset guard after a short delay
+          setTimeout(() => {
+            citationOpeningRef.current = false;
+          }, 100);
+        }
+      } catch (e) {
+        citationOpeningRef.current = false;
+      }
+    };
+    document.addEventListener("click", clickHandler);
+    return () => document.removeEventListener("click", clickHandler);
+  }, [state]);
   const containerStyles = {
     root: Object.assign({}, defaultWebChatContainerStatefulProps.containerStyles, webChatContainerProps === null || webChatContainerProps === void 0 ? void 0 : webChatContainerProps.containerStyles, {
       display: state.appStates.isMinimized ? "none" : ""
@@ -97,8 +155,10 @@ export const WebChatContainerStateful = props => {
         localStorage;
         sessionStorage;
       } catch (error) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
         if (!window.TPCWarningShown) {
           NotificationHandler.notifyWarning(NotificationScenarios.TPC, (localizedTexts === null || localizedTexts === void 0 ? void 0 : localizedTexts.THIRD_PARTY_COOKIES_BLOCKED_ALERT_MESSAGE) ?? "");
+          // eslint-disable-next-line @typescript-eslint/no-explicit-any
           window.TPCWarningShown = true;
         }
       }
@@ -287,10 +347,31 @@ export const WebChatContainerStateful = props => {
             overflow-y: unset;
             }
 
-        
+        /* Custom styles for carousel hero cards */
+		ul.webchat__carousel-filmstrip__attachments .ac-image {
+			width: 200px !important;
+			height: 150px !important;
+			object-fit: cover !important;
+			border-radius: 8px !important;
+			border: 1px solid #e0e0e0 !important;
+		}
+
+		.webchat__carousel-filmstrip-attachment .webchat__bubble {
+			height: 100% !important;
+		}
+
+		.webchat__carousel-filmstrip-attachment .webchat__bubble #ms_lcw_webchat_adaptive_card {
+			height: 100% !important;
+		}
+
         `), /*#__PURE__*/React.createElement(Stack, {
     styles: containerStyles,
     className: "webchat__stacked-layout_container"
-  }, /*#__PURE__*/React.createElement(BasicWebChat, null)));
+  }, /*#__PURE__*/React.createElement(BasicWebChat, null)), citationPaneOpen && /*#__PURE__*/React.createElement(CitationPaneStateful, {
+    id: HtmlAttributeNames.ocwCitationPaneClassName,
+    title: HtmlAttributeNames.ocwCitationPaneTitle,
+    contentHtml: citationPaneText,
+    onClose: () => setCitationPaneOpen(false)
+  }));
 };
 export default WebChatContainerStateful;

package/lib/esm/components/webchatcontainerstateful/interfaces/ICitation.js

@@ -0,0 +1 @@
+export {};