@yext/chat-ui-react 0.1.0 → 0.2.1

package/lib/esm/index.d.ts

@@ -19,7 +19,7 @@ export declare function ChatHeader({ title, showRestartButton, restartButtonIcon
  * @public
  */
 export declare interface ChatHeaderCssClasses {
-    header?: string;
+    container?: string;
     title?: string;
     restartButton?: string;
     closeButton?: string;
@@ -93,9 +93,8 @@ export declare interface ChatInputProps {
     /** Enable auto focus for the input box. Defaults to false. */
     inputAutoFocus?: boolean;
     /**
-     * A function which is called when an error occurs from
-     * Chat API while processing the user's message.
-     * By default, the error is logged to the console.
+     * A function which is called when an error occurs from Chat API while processing the user's message.
+     * By default, the error is logged to the console and an error message is added to state.
      */
     handleError?: (e: unknown) => void;
     /** Custom icon for the send button. */

package/lib/esm/utils/withStylelessCssClasses.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Append styleless css classnames that user can target to add custom styling to components.
+ * The classes follows a format of "yext-chat-component-name__css-interface-field-name".
+ *
+ * @example
+ * the styleless css class name for {@link MessageBubble}'s "message__bot" field defined
+ * in its {@link MessageBubbleCssClasses} interface is "yext-chat-message-bubble__message__bot"
+ *
+ * @internal
+ *
+ * @param componentName - the component name
+ * @param builtInClasses - built in css classnames of the component
+ *
+ * @returns builtInClasses with styleless css classnames
+ */
+export declare function withStylelessCssClasses<ClassInterface extends Partial<Record<keyof ClassInterface, string | object>>>(componentName: string, builtInClasses: Readonly<ClassInterface>): ClassInterface;
+//# sourceMappingURL=withStylelessCssClasses.d.ts.map

package/lib/esm/utils/withStylelessCssClasses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"withStylelessCssClasses.d.ts","sourceRoot":"","sources":["../../../src/utils/withStylelessCssClasses.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,uBAAuB,CACrC,cAAc,SAAS,OAAO,CAAC,MAAM,CAAC,MAAM,cAAc,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,EAE7E,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,QAAQ,CAAC,cAAc,CAAC,GACvC,cAAc,CAOhB"}

package/lib/esm/utils/withStylelessCssClasses.js

@@ -0,0 +1,24 @@
+/**
+ * Append styleless css classnames that user can target to add custom styling to components.
+ * The classes follows a format of "yext-chat-component-name__css-interface-field-name".
+ *
+ * @example
+ * the styleless css class name for {@link MessageBubble}'s "message__bot" field defined
+ * in its {@link MessageBubbleCssClasses} interface is "yext-chat-message-bubble__message__bot"
+ *
+ * @internal
+ *
+ * @param componentName - the component name
+ * @param builtInClasses - built in css classnames of the component
+ *
+ * @returns builtInClasses with styleless css classnames
+ */
+export function withStylelessCssClasses(componentName, builtInClasses) {
+    const formatString = (str) => str.replace(/[A-Z]/g, (match) => `-${match.toLowerCase()}`);
+    const classes = { ...builtInClasses };
+    Object.keys(builtInClasses).forEach((key) => {
+        classes[key] = `${classes[key]} yext-chat${formatString(componentName)}__${formatString(key)}`;
+    });
+    return classes;
+}
+//# sourceMappingURL=withStylelessCssClasses.js.map

package/lib/esm/utils/withStylelessCssClasses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"withStylelessCssClasses.js","sourceRoot":"","sources":["../../../src/utils/withStylelessCssClasses.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,uBAAuB,CAGrC,aAAqB,EACrB,cAAwC;IAExC,MAAM,YAAY,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IAClG,MAAM,OAAO,GAAG,EAAE,GAAG,cAAc,EAAE,CAAA;IACrC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;QAC1C,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,YAAY,CAAC,aAAa,CAAC,KAAK,YAAY,CAAC,GAAG,CAAC,EAAE,CAAA;IAChG,CAAC,CAAC,CAAA;IACF,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yext/chat-ui-react",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "description": "A library of React Components for powering Yext Chat integrations.",
   "author": "clippy@yext.com",
   "main": "./lib/commonjs/index.js",
@@ -12,7 +12,8 @@
       "import": "./lib/esm/index.js",
       "require": "./lib/commonjs/index.js"
     },
-    "./bundle.css": "./lib/bundle.css"
+    "./bundle.css": "./lib/bundle.css",
+    "./bundle-no-resets.css": "./lib/bundle-no-resets.css"
   },
   "license": "BSD-3-Clause",
   "files": [
@@ -37,7 +38,7 @@
     "generate-docs": "api-extractor run --local --verbose && api-documenter markdown --input-folder temp --output-folder docs && rm -rf temp",
     "generate-notices": "generate-license-file --input package.json --output ./THIRD-PARTY-NOTICES --overwrite",
     "build:js": "tsc -p tsconfig.esm.json && tsc -p tsconfig.cjs.json",
-    "build:css": "tailwindcss -o ./lib/bundle.css --minify -c tailwind.config.js",
+    "build:css": "tailwindcss -o ./lib/bundle.css --minify -c tailwind.config.js && tailwindcss -o ./lib/bundle-no-resets.css --minify -c tailwind-no-resets.config.js",
     "build": "rm -rf lib/** && npm run build:js && npm run build:css && npm run generate-docs && npm run generate-notices",
     "build-storybook": "storybook build"
   },
@@ -79,7 +80,7 @@
     "typescript": "^5.0.4"
   },
   "peerDependencies": {
-    "@yext/chat-headless-react": "^0.3.1",
+    "@yext/chat-headless-react": "^0.3.2",
     "react": "^16.14 || ^17 || ^18",
     "react-dom": "^16.14 || ^17 || || ^18"
   },

package/src/components/ChatHeader.tsx

@@ -1,9 +1,10 @@
 import { useChatActions } from "@yext/chat-headless-react";
-import { DualSyncIcon } from "../icons/DualSync"
+import { DualSyncIcon } from "../icons/DualSync";
 import { useComposedCssClasses } from "../hooks/useComposedCssClasses";
 import { useCallback, useRef, useState } from "react";
 import { twMerge } from "tailwind-merge";
 import { CrossIcon } from "../icons/Cross";
+import { withStylelessCssClasses } from "../utils/withStylelessCssClasses";
 
 /**
  * The CSS class interface for the {@link ChatHeader} component.
@@ -11,19 +12,19 @@ import { CrossIcon } from "../icons/Cross";
  * @public
  */
 export interface ChatHeaderCssClasses {
-  header?: string;
+  container?: string;
   title?: string;
   restartButton?: string;
   closeButton?: string;
 }
 
-const builtInCssClasses: Readonly<ChatHeaderCssClasses> = {
-  header:
+const builtInCssClasses: Readonly<ChatHeaderCssClasses> = withStylelessCssClasses('Header', {
+  container:
     "w-full px-4 py-3 flex justify-between bg-gradient-to-tr from-blue-600 to-blue-800 rounded-t-3xl",
   title: "text-white text-xl font-medium",
   restartButton: "w-8 text-white stroke-[0.2] ml-auto",
-  closeButton: "w-8 text-white hover:scale-110"
-};
+  closeButton: "w-8 text-white hover:scale-110",
+});
 
 /**
  * The props for the {@link ChatHeader} component.
@@ -93,7 +94,7 @@ export function ChatHeader({
   }, [chat]);
 
   return (
-    <div className={cssClasses.header}>
+    <div className={cssClasses.container}>
       <h1 className={cssClasses.title}>{title}</h1>
       {showRestartButton && (
         <button
@@ -106,12 +107,12 @@ export function ChatHeader({
       )}
       {showCloseButton && (
         <button
-        aria-label="Close Chat"
-        onClick={onClose}
-        className={cssClasses.closeButton}
-      >
-        {closeButtonIcon}
-      </button>
+          aria-label="Close Chat"
+          onClick={onClose}
+          className={cssClasses.closeButton}
+        >
+          {closeButtonIcon}
+        </button>
       )}
     </div>
   );

package/src/components/ChatInput.tsx

@@ -4,7 +4,8 @@ import { ArrowIcon } from "../icons/Arrow";
 import { useComposedCssClasses } from "../hooks";
 import Textarea from "react-expanding-textarea";
 import { twMerge } from "tailwind-merge";
-import { defaultHandleApiError } from "../utils/defaultHandleError";
+import { useDefaultHandleApiError } from "../hooks/useDefaultHandleApiError";
+import { withStylelessCssClasses } from "../utils/withStylelessCssClasses";
 
 /**
  * The CSS class interface for the {@link ChatInput} component.
@@ -17,13 +18,13 @@ export interface ChatInputCssClasses {
   sendButton?: string;
 }
 
-const builtInCssClasses: ChatInputCssClasses = {
+const builtInCssClasses: ChatInputCssClasses = withStylelessCssClasses('Input', {
   container: "w-full h-fit flex flex-row relative @container",
   textArea:
     "w-full p-4 pr-10 border border-slate-300 disabled:bg-slate-50 rounded-3xl resize-none text-[13px] @[480px]:text-base",
   sendButton:
-    "rounded-full p-1.5 w-8 stroke-2 text-white bg-blue-600 disabled:bg-slate-100 hover:bg-blue-800 active:scale-90 transition-all absolute right-7 bottom-2.5 @[480px]:bottom-3.5",
-};
+    "rounded-full p-1.5 w-8 h-8 stroke-2 text-white bg-blue-600 disabled:bg-slate-100 hover:bg-blue-800 active:scale-90 transition-all absolute right-7 bottom-2.5 @[480px]:bottom-3.5",
+});
 
 /**
  * The props for the {@link ChatInput} component.
@@ -44,9 +45,8 @@ export interface ChatInputProps {
   /** Enable auto focus for the input box. Defaults to false. */
   inputAutoFocus?: boolean;
   /**
-   * A function which is called when an error occurs from
-   * Chat API while processing the user's message.
-   * By default, the error is logged to the console.
+   * A function which is called when an error occurs from Chat API while processing the user's message.
+   * By default, the error is logged to the console and an error message is added to state.
    */
   handleError?: (e: unknown) => void;
   /** Custom icon for the send button. */
@@ -74,6 +74,7 @@ export function ChatInput({
   const canSendMessage = useChatState(
     (state) => state.conversation.canSendMessage
   );
+  const defaultHandleApiError = useDefaultHandleApiError();
 
   const cssClasses = useComposedCssClasses(builtInCssClasses, customCssClasses);
   const sendButtonClassNames = twMerge(
@@ -87,7 +88,7 @@ export function ChatInput({
       : chat.getNextMessage(input);
     setInput("");
     res.catch((e) => (handleError ? handleError(e) : defaultHandleApiError(e)));
-  }, [chat, input, handleError, stream]);
+  }, [chat, input, handleError, defaultHandleApiError, stream]);
 
   const handleKeyDown = useCallback(
     (e: React.KeyboardEvent<HTMLTextAreaElement>) => {

package/src/components/ChatPanel.tsx

@@ -8,7 +8,8 @@ import {
 import { ChatInput, ChatInputCssClasses, ChatInputProps } from "./ChatInput";
 import { LoadingDots } from "./LoadingDots";
 import { useComposedCssClasses } from "../hooks";
-import { defaultHandleApiError } from "../utils/defaultHandleError";
+import { useDefaultHandleApiError } from "../hooks/useDefaultHandleApiError";
+import { withStylelessCssClasses } from "../utils/withStylelessCssClasses";
 
 /**
  * The CSS class interface for the {@link ChatPanel} component.
@@ -23,13 +24,13 @@ export interface ChatPanelCssClasses {
   messageBubbleCssClasses?: MessageBubbleCssClasses;
 }
 
-const builtInCssClasses: ChatPanelCssClasses = {
+const builtInCssClasses: ChatPanelCssClasses = withStylelessCssClasses('Panel', {
   container:
     "h-full w-full flex flex-col relative rounded-3xl shadow-2xl bg-white",
   messagesContainer:
     "flex flex-col gap-y-1 mt-auto px-4 pb-[85px] overflow-auto",
   inputContainer: "w-full absolute bottom-0 p-4 rounded-b-3xl backdrop-blur-lg",
-};
+});
 
 /**
  * The props for the {@link ChatPanel} component.
@@ -65,6 +66,7 @@ export function ChatPanel(props: ChatPanelProps) {
     (state) => state.conversation.canSendMessage
   );
   const cssClasses = useComposedCssClasses(builtInCssClasses, customCssClasses);
+  const defaultHandleApiError = useDefaultHandleApiError();
 
   // Fetch the first message on load, if there are no existing messages or a request being processed
   useEffect(() => {
@@ -74,7 +76,7 @@ export function ChatPanel(props: ChatPanelProps) {
     const { stream = true, handleError } = props;
     const res = stream ? chat.streamNextMessage() : chat.getNextMessage();
     res.catch((e) => (handleError ? handleError(e) : defaultHandleApiError(e)));
-  }, [chat, props, messages, canSendMessage]);
+  }, [chat, props, messages, defaultHandleApiError, canSendMessage]);
 
   const messagesRef = useRef<HTMLDivElement>(null);
 
@@ -82,8 +84,8 @@ export function ChatPanel(props: ChatPanelProps) {
   useEffect(() => {
     messagesRef.current?.scroll({
       top: messagesRef.current?.scrollHeight,
-      behavior: 'smooth',
-  });
+      behavior: "smooth",
+    });
   }, [messages]);
 
   return (

package/src/components/ChatPopUp.tsx

@@ -1,9 +1,14 @@
 import { useCallback, useState } from "react";
-import { MessageIcon } from '../icons/Message'
+import { MessageIcon } from "../icons/Message";
 import { ChatPanel, ChatPanelCssClasses, ChatPanelProps } from "./ChatPanel";
-import { ChatHeader, ChatHeaderCssClasses, ChatHeaderProps } from "./ChatHeader";
+import {
+  ChatHeader,
+  ChatHeaderCssClasses,
+  ChatHeaderProps,
+} from "./ChatHeader";
 import { twMerge } from "tailwind-merge";
 import { useComposedCssClasses } from "../hooks";
+import { withStylelessCssClasses } from "../utils/withStylelessCssClasses";
 
 /**
  * The CSS class interface for the {@link ChatPopUp} component.
@@ -18,30 +23,32 @@ export interface ChatPopUpCssClasses {
   button?: string;
   button__display?: string;
   button__hidden?: string;
-  headerCssClasses?: ChatHeaderCssClasses,
-  panelCssClasses?: ChatPanelCssClasses,
+  headerCssClasses?: ChatHeaderCssClasses;
+  panelCssClasses?: ChatPanelCssClasses;
 }
 
-const fixedPosition = "fixed bottom-6 right-4 lg:bottom-14 lg:right-10 "
-const builtInCssClasses: ChatPopUpCssClasses = {
+const fixedPosition = "fixed bottom-6 right-4 lg:bottom-14 lg:right-10 z-50 ";
+const builtInCssClasses: ChatPopUpCssClasses = withStylelessCssClasses('PopUp', {
   container: "transition-all",
   panel: fixedPosition + "w-80 lg:w-96 h-[75vh]",
   panel__display: "duration-300 translate-y-0",
   panel__hidden: "duration-300 translate-y-[20%] opacity-0 invisible",
-  button: fixedPosition + "p-2 w-12 h-12 lg:w-16 lg:h-16 flex justify-center items-center text-white shadow-xl rounded-full bg-gradient-to-br from-blue-600 to-blue-700 hover:-translate-y-2 duration-150",
+  button:
+    fixedPosition +
+    "p-2 w-12 h-12 lg:w-16 lg:h-16 flex justify-center items-center text-white shadow-xl rounded-full bg-gradient-to-br from-blue-600 to-blue-700 hover:-translate-y-2 duration-150",
   button__display: "duration-300 transform translate-y-0",
-  button__hidden: "duration-300 transform translate-y-[20%] opacity-0 invisible",
-};
+  button__hidden:
+    "duration-300 transform translate-y-[20%] opacity-0 invisible",
+});
 
 /**
  * The props for the {@link ChatPopUp} component.
  *
  * @public
  */
-export interface ChatPopUpProps extends
-  Omit<ChatHeaderProps, "showCloseButton" | "customCssClasses">,
-  Omit<ChatPanelProps, "header" | "customCssClasses">
-{
+export interface ChatPopUpProps
+  extends Omit<ChatHeaderProps, "showCloseButton" | "customCssClasses">,
+    Omit<ChatPanelProps, "header" | "customCssClasses"> {
   /** Custom icon for the popup button to open the panel. */
   openPanelButtonIcon?: JSX.Element;
   /**
@@ -63,9 +70,9 @@ export function ChatPopUp(props: ChatPopUpProps) {
     openPanelButtonIcon = <MessageIcon />,
     customCssClasses,
     showRestartButton = true,
-    onClose:customOnClose,
-    title
-  } = props
+    onClose: customOnClose,
+    title,
+  } = props;
   const [showChat, setShowChat] = useState(false);
   const onClick = useCallback(() => {
     setShowChat(!showChat);
@@ -74,8 +81,8 @@ export function ChatPopUp(props: ChatPopUpProps) {
   const onClose = useCallback(() => {
     setShowChat(false);
     customOnClose?.();
-  }, [customOnClose])
-  
+  }, [customOnClose]);
+
   const cssClasses = useComposedCssClasses(builtInCssClasses, customCssClasses);
   const panelCssClasses = twMerge(
     cssClasses.panel,
@@ -92,13 +99,16 @@ export function ChatPopUp(props: ChatPopUpProps) {
         <ChatPanel
           {...props}
           customCssClasses={cssClasses.panelCssClasses}
-          header={<ChatHeader
-            title={title}
-            showRestartButton={showRestartButton}
-            showCloseButton={true}
-            onClose={onClose}
-            customCssClasses={cssClasses.headerCssClasses}/>
-          } />
+          header={
+            <ChatHeader
+              title={title}
+              showRestartButton={showRestartButton}
+              showCloseButton={true}
+              onClose={onClose}
+              customCssClasses={cssClasses.headerCssClasses}
+            />
+          }
+        />
       </div>
       <button
         aria-label="Chat Popup Button"

package/src/components/LoadingDots.tsx

@@ -9,10 +9,7 @@ export function LoadingDots({ className }: { className?: string }) {
   return (
     <div
       aria-label="Loading Indicator"
-      className={twMerge(
-        "flex gap-1 p-2 animate-fade-in",
-        className
-      )}
+      className={twMerge("flex gap-1 p-2 animate-fade-in", className)}
     >
       <div className="w-2 h-2 bg-slate-500 rounded-full animate-[bounce_1s_infinite]" />
       <div className="w-2 h-2 bg-slate-500 rounded-full animate-[bounce_1s_infinite_0.3s]" />

package/src/components/Markdown.tsx

@@ -6,7 +6,7 @@ import rehypeSanitize from "rehype-sanitize";
 // The Remark and Rehype plugins to use in conjunction with ReactMarkdown.
 const unifiedPlugins: { remark?: PluggableList; rehype: PluggableList } = {
   remark: [
-    remarkGfm //renders Github-Flavored Markdown
+    remarkGfm, //renders Github-Flavored Markdown
   ],
   rehype: [
     rehypeRaw, //to support HTML embedded in markdown
@@ -22,7 +22,7 @@ interface MarkdownProps {
 /**
  * Renders Github-Flavored Markdown from the Knowledge Graph. This Markdown can include
  * arbitrary HTML. Any HTML will be sanitized according to Rehype's default Schema.
- * 
+ *
  * @public
  */
 export function Markdown({ content }: MarkdownProps) {
@@ -33,4 +33,4 @@ export function Markdown({ content }: MarkdownProps) {
       rehypePlugins={unifiedPlugins.rehype}
     />
   );
-}
+}

package/src/components/MessageBubble.tsx

@@ -2,6 +2,7 @@ import { Message, MessageSource } from "@yext/chat-headless-react";
 import { useComposedCssClasses } from "../hooks";
 import { twMerge } from "tailwind-merge";
 import { Markdown } from "./Markdown";
+import { withStylelessCssClasses } from "../utils/withStylelessCssClasses";
 
 /**
  * The CSS class interface for the {@link MessageBubble} component.
@@ -21,10 +22,11 @@ export interface MessageBubbleCssClasses {
   timestamp__user?: string;
 }
 
-const builtInCssClasses: MessageBubbleCssClasses = {
+const builtInCssClasses: MessageBubbleCssClasses = withStylelessCssClasses('MessageBubble', {
   topContainer: "w-full animate-fade-in @container",
   subContainer:
     "flex flex-col @lg:flex-row @lg:items-center @lg:gap-x-2 @lg:m-1",
+  subContainer__bot: "",
   subContainer__user: "@lg:flex-row-reverse",
   message:
     "peer rounded-2xl text-[13px] @[480px]:text-base p-4 w-fit max-w-[80%] prose overflow-x-auto",
@@ -33,8 +35,9 @@ const builtInCssClasses: MessageBubbleCssClasses = {
     "ml-auto @lg:ml-0 text-white bg-gradient-to-tr from-blue-600 to-blue-700",
   timestamp:
     "w-fit my-0.5 text-slate-400 text-[13px] opacity-0 peer-hover:opacity-100 duration-200 whitespace-pre-wrap",
+  timestamp__bot: "",
   timestamp__user: "ml-auto",
-};
+});
 
 /**
  * The props for the {@link MessageBubble} component.

package/src/hooks/useDefaultHandleApiError.ts

@@ -0,0 +1,32 @@
+import {
+  MessageSource,
+  useChatActions,
+  useChatState,
+} from "@yext/chat-headless-react";
+import { useCallback } from "react";
+
+/**
+ * Returns a default handler function for API errors. It will log the error and
+ * add a default error message to state.
+ *
+ * @internal
+ */
+export function useDefaultHandleApiError() {
+  const chat = useChatActions();
+  const messages = useChatState((s) => s.conversation.messages);
+
+  return useCallback(
+    (e: unknown) => {
+      console.error(e);
+      chat.setMessages([
+        ...messages,
+        {
+          text: "Sorry, I'm unable to respond at the moment. Please try again later!",
+          source: MessageSource.BOT,
+          timestamp: new Date().toISOString(),
+        },
+      ]);
+    },
+    [chat, messages]
+  );
+}

package/src/icons/Arrow.tsx

@@ -1,8 +1,16 @@
 export function ArrowIcon(): JSX.Element {
   return (
-    <svg width="100%" height="100%" viewBox="0 0 20 20"  fill='none' stroke="currentColor" strokeLinecap="square" xmlns="http://www.w3.org/2000/svg">
-      <path d="M10 5V15"/>
-      <path d="M15 8.84615L10 4L5 8.84615"/>
+    <svg
+      width="100%"
+      height="100%"
+      viewBox="0 0 20 20"
+      fill="none"
+      stroke="currentColor"
+      strokeLinecap="square"
+      xmlns="http://www.w3.org/2000/svg"
+    >
+      <path d="M10 5V15" />
+      <path d="M15 8.84615L10 4L5 8.84615" />
     </svg>
   );
-}
+}

package/src/icons/Cross.tsx

@@ -1,8 +1,14 @@
 export function CrossIcon(): JSX.Element {
   return (
-    <svg width="100%" height="100%" viewBox="0 0 20 20" stroke="currentColor" xmlns="http://www.w3.org/2000/svg">
-      <path d="M14 14L6 6" strokeLinecap="square" strokeLinejoin="round"/>
-      <path d="M14 6L6 14" strokeLinecap="square" strokeLinejoin="round"/>
+    <svg
+      width="100%"
+      height="100%"
+      viewBox="0 0 20 20"
+      stroke="currentColor"
+      xmlns="http://www.w3.org/2000/svg"
+    >
+      <path d="M14 14L6 6" strokeLinecap="square" strokeLinejoin="round" />
+      <path d="M14 6L6 14" strokeLinecap="square" strokeLinejoin="round" />
     </svg>
   );
-}
+}

package/src/icons/DualSync.tsx

@@ -1,8 +1,15 @@
 export function DualSyncIcon(): JSX.Element {
   return (
-    <svg width="100%" height="100%" viewBox="0 0 20 20" fill='currentColor' stroke="currentColor" xmlns="http://www.w3.org/2000/svg">
-    <path d="M14.3148 6.47397C14.9074 7.36266 15.2593 8.46858 15.2593 9.63375C15.2593 12.675 12.9259 15.1634 10.0741 15.1634C9.11111 15.1634 8.2037 14.8671 7.42593 14.3734L9.05556 13.8995L8.87037 13.1293L6 13.939L6.75926 17L7.48148 16.8025L7.03704 15.0449C7.92593 15.6176 8.96296 15.9336 10.0741 15.9336C13.3519 15.9336 16 13.1095 16 9.614C16 8.2711 15.6111 7.02693 14.9259 6L14.3148 6.47397Z"/>
-    <path d="M9.92593 4.68459C10.8889 4.68459 11.7963 4.95341 12.5741 5.40143L10.9444 5.81362L11.1296 6.51254L14 5.77778L13.2407 3L12.5185 3.17921L12.963 4.77419C12.0741 4.25448 11.037 3.96774 9.92593 3.96774C6.64815 3.96774 4 6.53047 4 9.70251C4 10.9211 4.40741 12.0681 5.07407 13L5.68518 12.5878C5.09259 11.7634 4.74074 10.7778 4.74074 9.70251C4.74074 6.94265 7.07407 4.68459 9.92593 4.68459Z"/>
+    <svg
+      width="100%"
+      height="100%"
+      viewBox="0 0 20 20"
+      fill="currentColor"
+      stroke="currentColor"
+      xmlns="http://www.w3.org/2000/svg"
+    >
+      <path d="M14.3148 6.47397C14.9074 7.36266 15.2593 8.46858 15.2593 9.63375C15.2593 12.675 12.9259 15.1634 10.0741 15.1634C9.11111 15.1634 8.2037 14.8671 7.42593 14.3734L9.05556 13.8995L8.87037 13.1293L6 13.939L6.75926 17L7.48148 16.8025L7.03704 15.0449C7.92593 15.6176 8.96296 15.9336 10.0741 15.9336C13.3519 15.9336 16 13.1095 16 9.614C16 8.2711 15.6111 7.02693 14.9259 6L14.3148 6.47397Z" />
+      <path d="M9.92593 4.68459C10.8889 4.68459 11.7963 4.95341 12.5741 5.40143L10.9444 5.81362L11.1296 6.51254L14 5.77778L13.2407 3L12.5185 3.17921L12.963 4.77419C12.0741 4.25448 11.037 3.96774 9.92593 3.96774C6.64815 3.96774 4 6.53047 4 9.70251C4 10.9211 4.40741 12.0681 5.07407 13L5.68518 12.5878C5.09259 11.7634 4.74074 10.7778 4.74074 9.70251C4.74074 6.94265 7.07407 4.68459 9.92593 4.68459Z" />
     </svg>
   );
-}
+}

package/src/icons/Message.tsx

@@ -1,10 +1,16 @@
 export function MessageIcon(): JSX.Element {
   return (
-    <svg width="100%" height="100%" viewBox="0 0 20 20" fill='currentColor' xmlns="http://www.w3.org/2000/svg">
-      <path d="M3.37424 17.1166L6.31902 14.1718H16.6258V4.84663H3.37424V17.1166ZM3.86503 5.33742H16.135V13.681H6.31902H6.11043L5.96319 13.8282L3.85276 15.9386V5.33742H3.86503Z"/>
+    <svg
+      width="100%"
+      height="100%"
+      viewBox="0 0 20 20"
+      fill="currentColor"
+      xmlns="http://www.w3.org/2000/svg"
+    >
+      <path d="M3.37424 17.1166L6.31902 14.1718H16.6258V4.84663H3.37424V17.1166ZM3.86503 5.33742H16.135V13.681H6.31902H6.11043L5.96319 13.8282L3.85276 15.9386V5.33742H3.86503Z" />
       <path d="M14.4172 9.2638H6.07362V9.7546H14.4172V9.2638Z" />
       <path d="M13.9264 10.7362H6.07362V11.227H13.9264V10.7362Z" />
       <path d="M13.4356 7.79141H6.07362V8.28221H13.4356V7.79141Z" />
     </svg>
   );
-}
+}

package/src/utils/withStylelessCssClasses.ts

@@ -0,0 +1,28 @@
+/**
+ * Append styleless css classnames that user can target to add custom styling to components.
+ * The classes follows a format of "yext-chat-component-name__css-interface-field-name".
+ * 
+ * @example
+ * the styleless css class name for {@link MessageBubble}'s "message__bot" field defined
+ * in its {@link MessageBubbleCssClasses} interface is "yext-chat-message-bubble__message__bot"
+ * 
+ * @internal
+ * 
+ * @param componentName - the component name
+ * @param builtInClasses - built in css classnames of the component
+ * 
+ * @returns builtInClasses with styleless css classnames
+ */
+export function withStylelessCssClasses<
+  ClassInterface extends Partial<Record<keyof ClassInterface, string | object>>
+>(
+  componentName: string,
+  builtInClasses: Readonly<ClassInterface>
+): ClassInterface {
+  const formatString = (str: string) => str.replace(/[A-Z]/g, (match) => `-${match.toLowerCase()}`);
+  const classes = { ...builtInClasses }
+  Object.keys(builtInClasses).forEach((key) => {
+    classes[key] = `${classes[key]} yext-chat${formatString(componentName)}__${formatString(key)}`
+  })
+  return classes;
+}

package/lib/commonjs/utils/defaultHandleError.d.ts

@@ -1,9 +0,0 @@
-/**
- * Default handler function for API errors.
- *
- * @internal
- *
- * @param e - error returned from api request
- */
-export declare function defaultHandleApiError(e: unknown): void;
-//# sourceMappingURL=defaultHandleError.d.ts.map

package/lib/commonjs/utils/defaultHandleError.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"defaultHandleError.d.ts","sourceRoot":"","sources":["../../../src/utils/defaultHandleError.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,OAAO,QAE/C"}

package/lib/commonjs/utils/defaultHandleError.js

@@ -1,15 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.defaultHandleApiError = void 0;
-/**
- * Default handler function for API errors.
- *
- * @internal
- *
- * @param e - error returned from api request
- */
-function defaultHandleApiError(e) {
-    console.error(e);
-}
-exports.defaultHandleApiError = defaultHandleApiError;
-//# sourceMappingURL=defaultHandleError.js.map

package/lib/commonjs/utils/defaultHandleError.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"defaultHandleError.js","sourceRoot":"","sources":["../../../src/utils/defaultHandleError.ts"],"names":[],"mappings":";;;AAAA;;;;;;GAMG;AACH,SAAgB,qBAAqB,CAAC,CAAU;IAC9C,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACnB,CAAC;AAFD,sDAEC"}

package/lib/esm/utils/defaultHandleError.d.ts

@@ -1,9 +0,0 @@
-/**
- * Default handler function for API errors.
- *
- * @internal
- *
- * @param e - error returned from api request
- */
-export declare function defaultHandleApiError(e: unknown): void;
-//# sourceMappingURL=defaultHandleError.d.ts.map