@xplor-education/core-stencil-components 2.0.0

package/dist/collection/components/xplor-assistant/internal/AssistantInput.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AssistantInput.js","sourceRoot":"","sources":["../../../../src/components/xplor-assistant/internal/AssistantInput.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,eAAe,CAAC;AAClC,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAe1D,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAkC,EAAE,EAAE;IACnE,MAAM,EACJ,WAAW,EACX,QAAQ,EACR,SAAS,EACT,gBAAgB,EAChB,WAAW,EACX,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,aAAa,GACd,GAAG,KAAK,CAAC;IAEV,MAAM,YAAY,GAAG,CAAC,CAAQ,EAAE,EAAE;QAChC,CAAC,CAAC,cAAc,EAAE,CAAC;QACnB,OAAO,CAAC,GAAG,CAAC,gDAAgD,EAAE,UAAU,CAAC,CAAC;QAC1E,IAAI,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,IAAI,CAAC,SAAS,EAAE,CAAC;YACjD,OAAO,CAAC,GAAG,CAAC,8CAA8C,EAAE,UAAU,CAAC,CAAC;YACxE,aAAa,CAAC,UAAU,CAAC,CAAC;YAC1B,aAAa,CAAC,EAAE,CAAC,CAAC;QACpB,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,6CAA6C,EAAE,QAAQ,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;QAClI,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,iBAAiB,GAAG,CAAC,CAAQ,EAAE,EAAE;QACrC,MAAM,MAAM,GAAG,CAAC,CAAC,MAA0B,CAAC;QAC5C,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC,CAAC;IAEF,MAAM,gBAAgB,GAAG,GAAG,EAAE;QAC5B,IAAI,WAAW,EAAE,CAAC;YAChB,eAAe,EAAE,CAAC;QACpB,CAAC;aAAM,CAAC;YACN,gBAAgB,EAAE,CAAC;QACrB,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,cAAc,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,QAAQ,IAAI,SAAS,CAAC;IAEnE,OAAO,CACL,WAAK,KAAK,EAAC,kCAAkC;QAC3C,YAAM,QAAQ,EAAE,YAAY,EAAE,KAAK,EAAC,6BAA6B;YAC9D,gBAAgB,IAAI,CACnB,cACE,IAAI,EAAC,QAAQ,EACb,KAAK,EAAE;oBACL,+BAA+B,EAAE,IAAI;oBACrC,0CAA0C,EAAE,WAAW;iBACxD,EACD,OAAO,EAAE,gBAAgB,EACzB,QAAQ,EAAE,QAAQ,IAAI,SAAS,EAC/B,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,mBAAmB;gBAE3D,YAAM,KAAK,EAAC,6BAA6B,EAAC,SAAS,EAAE,cAAc,GAAS,CACrE,CACV;YAED,aACE,IAAI,EAAC,MAAM,EACX,KAAK,EAAC,wBAAwB,EAC9B,WAAW,EAAE,WAAW,EACxB,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,iBAAiB,EAC1B,QAAQ,EAAE,QAAQ,IAAI,SAAS,GAC/B;YAEF,cACE,IAAI,EAAC,QAAQ,EACb,KAAK,EAAC,8BAA8B,EACpC,QAAQ,EAAE,cAAc,EACxB,KAAK,EAAC,cAAc;gBAEpB,YAAM,KAAK,EAAC,4BAA4B,EAAC,SAAS,EAAE,QAAQ,GAAS,CAC9D,CACJ,CACH,CACP,CAAC;AACJ,CAAC,CAAC","sourcesContent":["/**\n * AssistantInput - Internal component\n * Renders the input field with voice and send buttons\n */\n\nimport { h } from '@stencil/core';\nimport { microphoneIcon, sendIcon } from '../utils/icons';\n\nexport interface AssistantInputInternalProps {\n  placeholder: string;\n  disabled: boolean;\n  isLoading: boolean;\n  enableVoiceInput: boolean;\n  isListening: boolean;\n  inputValue: string;\n  onSendMessage: (message: string) => void;\n  onStartListening: () => void;\n  onStopListening: () => void;\n  setInputValue: (value: string) => void;\n}\n\nexport const AssistantInput = (props: AssistantInputInternalProps) => {\n  const {\n    placeholder,\n    disabled,\n    isLoading,\n    enableVoiceInput,\n    isListening,\n    inputValue,\n    onSendMessage,\n    onStartListening,\n    onStopListening,\n    setInputValue,\n  } = props;\n\n  const handleSubmit = (e: Event) => {\n    e.preventDefault();\n    console.log('[AssistantInput] Submit triggered, inputValue:', inputValue);\n    if (inputValue.trim() && !disabled && !isLoading) {\n      console.log('[AssistantInput] Calling onSendMessage with:', inputValue);\n      onSendMessage(inputValue);\n      setInputValue('');\n    } else {\n      console.log('[AssistantInput] Submit blocked - disabled:', disabled, 'isLoading:', isLoading, 'hasValue:', !!inputValue.trim());\n    }\n  };\n\n  const handleInputChange = (e: Event) => {\n    const target = e.target as HTMLInputElement;\n    setInputValue(target.value);\n  };\n\n  const handleVoiceClick = () => {\n    if (isListening) {\n      onStopListening();\n    } else {\n      onStartListening();\n    }\n  };\n\n  const isSendDisabled = !inputValue.trim() || disabled || isLoading;\n\n  return (\n    <div class=\"xplor-assistant__input-container\">\n      <form onSubmit={handleSubmit} class=\"xplor-assistant__input-form\">\n        {enableVoiceInput && (\n          <button\n            type=\"button\"\n            class={{\n              'xplor-assistant__voice-button': true,\n              'xplor-assistant__voice-button--listening': isListening,\n            }}\n            onClick={handleVoiceClick}\n            disabled={disabled || isLoading}\n            title={isListening ? 'Stop listening' : 'Start voice input'}\n          >\n            <span class=\"xplor-assistant__voice-icon\" innerHTML={microphoneIcon}></span>\n          </button>\n        )}\n\n        <input\n          type=\"text\"\n          class=\"xplor-assistant__input\"\n          placeholder={placeholder}\n          value={inputValue}\n          onInput={handleInputChange}\n          disabled={disabled || isLoading}\n        />\n\n        <button\n          type=\"submit\"\n          class=\"xplor-assistant__send-button\"\n          disabled={isSendDisabled}\n          title=\"Send message\"\n        >\n          <span class=\"xplor-assistant__send-icon\" innerHTML={sendIcon}></span>\n        </button>\n      </form>\n    </div>\n  );\n};\n"]}

package/dist/collection/components/xplor-assistant/internal/AssistantMessage.js

@@ -0,0 +1,35 @@
+/**
+ * AssistantMessage - Internal component
+ * Renders a single message bubble with optional text-to-speech functionality
+ */
+import { h } from "@stencil/core";
+import { speakerIcon, stopIcon } from "../utils/icons";
+export const AssistantMessage = (props) => {
+    const { message, enableTextToSpeech, isSpeaking, onSpeak, onStopSpeaking } = props;
+    const messageClasses = {
+        'xplor-assistant__message': true,
+        'xplor-assistant__message--user': message.role === 'user',
+        'xplor-assistant__message--assistant': message.role === 'assistant',
+    };
+    const handleSpeakClick = () => {
+        if (isSpeaking) {
+            onStopSpeaking === null || onStopSpeaking === void 0 ? void 0 : onStopSpeaking();
+        }
+        else {
+            onSpeak === null || onSpeak === void 0 ? void 0 : onSpeak(message.content);
+        }
+    };
+    const formatTime = (timestamp) => {
+        const hours = timestamp.getHours();
+        const minutes = timestamp.getMinutes();
+        const ampm = hours >= 12 ? 'PM' : 'AM';
+        const displayHours = hours % 12 || 12;
+        const displayMinutes = minutes < 10 ? `0${minutes}` : minutes;
+        return `${displayHours}:${displayMinutes} ${ampm}`;
+    };
+    return (h("div", { class: messageClasses }, h("div", { class: "xplor-assistant__message-content" }, message.content), h("div", { class: "xplor-assistant__message-footer" }, h("span", { class: "xplor-assistant__message-timestamp" }, formatTime(message.timestamp)), message.role === 'assistant' && enableTextToSpeech && (h("button", { class: {
+            'xplor-assistant__speak-button': true,
+            'xplor-assistant__speak-button--active': isSpeaking,
+        }, onClick: handleSpeakClick, title: isSpeaking ? 'Stop speaking' : 'Listen to message', type: "button" }, h("span", { class: "xplor-assistant__speak-icon", innerHTML: isSpeaking ? stopIcon : speakerIcon }))))));
+};
+//# sourceMappingURL=AssistantMessage.js.map

package/dist/collection/components/xplor-assistant/internal/AssistantMessage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AssistantMessage.js","sourceRoot":"","sources":["../../../../src/components/xplor-assistant/internal/AssistantMessage.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,eAAe,CAAC;AAElC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAEvD,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAA4B,EAAE,EAAE;IAC/D,MAAM,EAAE,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,KAAK,CAAC;IAEnF,MAAM,cAAc,GAAG;QACrB,0BAA0B,EAAE,IAAI;QAChC,gCAAgC,EAAE,OAAO,CAAC,IAAI,KAAK,MAAM;QACzD,qCAAqC,EAAE,OAAO,CAAC,IAAI,KAAK,WAAW;KACpE,CAAC;IAEF,MAAM,gBAAgB,GAAG,GAAG,EAAE;QAC5B,IAAI,UAAU,EAAE,CAAC;YACf,cAAc,aAAd,cAAc,uBAAd,cAAc,EAAI,CAAC;QACrB,CAAC;aAAM,CAAC;YACN,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,UAAU,GAAG,CAAC,SAAe,EAAE,EAAE;QACrC,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,EAAE,CAAC;QACnC,MAAM,OAAO,GAAG,SAAS,CAAC,UAAU,EAAE,CAAC;QACvC,MAAM,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;QACvC,MAAM,YAAY,GAAG,KAAK,GAAG,EAAE,IAAI,EAAE,CAAC;QACtC,MAAM,cAAc,GAAG,OAAO,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;QAC9D,OAAO,GAAG,YAAY,IAAI,cAAc,IAAI,IAAI,EAAE,CAAC;IACrD,CAAC,CAAC;IAEF,OAAO,CACL,WAAK,KAAK,EAAE,cAAc;QACxB,WAAK,KAAK,EAAC,kCAAkC,IAC1C,OAAO,CAAC,OAAO,CACZ;QACN,WAAK,KAAK,EAAC,iCAAiC;YAC1C,YAAM,KAAK,EAAC,oCAAoC,IAC7C,UAAU,CAAC,OAAO,CAAC,SAAS,CAAC,CACzB;YACN,OAAO,CAAC,IAAI,KAAK,WAAW,IAAI,kBAAkB,IAAI,CACrD,cACE,KAAK,EAAE;oBACL,+BAA+B,EAAE,IAAI;oBACrC,uCAAuC,EAAE,UAAU;iBACpD,EACD,OAAO,EAAE,gBAAgB,EACzB,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,mBAAmB,EACzD,IAAI,EAAC,QAAQ;gBAEb,YACE,KAAK,EAAC,6BAA6B,EACnC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,GACxC,CACD,CACV,CACG,CACF,CACP,CAAC;AACJ,CAAC,CAAC","sourcesContent":["/**\n * AssistantMessage - Internal component\n * Renders a single message bubble with optional text-to-speech functionality\n */\n\nimport { h } from '@stencil/core';\nimport { AssistantMessageProps } from './types';\nimport { speakerIcon, stopIcon } from '../utils/icons';\n\nexport const AssistantMessage = (props: AssistantMessageProps) => {\n  const { message, enableTextToSpeech, isSpeaking, onSpeak, onStopSpeaking } = props;\n\n  const messageClasses = {\n    'xplor-assistant__message': true,\n    'xplor-assistant__message--user': message.role === 'user',\n    'xplor-assistant__message--assistant': message.role === 'assistant',\n  };\n\n  const handleSpeakClick = () => {\n    if (isSpeaking) {\n      onStopSpeaking?.();\n    } else {\n      onSpeak?.(message.content);\n    }\n  };\n\n  const formatTime = (timestamp: Date) => {\n    const hours = timestamp.getHours();\n    const minutes = timestamp.getMinutes();\n    const ampm = hours >= 12 ? 'PM' : 'AM';\n    const displayHours = hours % 12 || 12;\n    const displayMinutes = minutes < 10 ? `0${minutes}` : minutes;\n    return `${displayHours}:${displayMinutes} ${ampm}`;\n  };\n\n  return (\n    <div class={messageClasses}>\n      <div class=\"xplor-assistant__message-content\">\n        {message.content}\n      </div>\n      <div class=\"xplor-assistant__message-footer\">\n        <span class=\"xplor-assistant__message-timestamp\">\n          {formatTime(message.timestamp)}\n        </span>\n        {message.role === 'assistant' && enableTextToSpeech && (\n          <button\n            class={{\n              'xplor-assistant__speak-button': true,\n              'xplor-assistant__speak-button--active': isSpeaking,\n            }}\n            onClick={handleSpeakClick}\n            title={isSpeaking ? 'Stop speaking' : 'Listen to message'}\n            type=\"button\"\n          >\n            <span\n              class=\"xplor-assistant__speak-icon\"\n              innerHTML={isSpeaking ? stopIcon : speakerIcon}\n            ></span>\n          </button>\n        )}\n      </div>\n    </div>\n  );\n};\n"]}

package/dist/collection/components/xplor-assistant/internal/QuickReplies.js

@@ -0,0 +1,13 @@
+/**
+ * QuickReplies - Internal component
+ * Renders quick reply suggestion buttons
+ */
+import { h } from "@stencil/core";
+export const QuickReplies = (props) => {
+    const { replies, disabled, onReplyClick } = props;
+    if (!replies || replies.length === 0) {
+        return null;
+    }
+    return (h("div", { class: "xplor-assistant__quick-replies" }, replies.map((reply) => (h("button", { class: "xplor-assistant__quick-reply", onClick: () => onReplyClick(reply), disabled: disabled, type: "button" }, reply)))));
+};
+//# sourceMappingURL=QuickReplies.js.map

package/dist/collection/components/xplor-assistant/internal/QuickReplies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"QuickReplies.js","sourceRoot":"","sources":["../../../../src/components/xplor-assistant/internal/QuickReplies.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,eAAe,CAAC;AAGlC,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,KAAwB,EAAE,EAAE;IACvD,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,KAAK,CAAC;IAElD,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,CACL,WAAK,KAAK,EAAC,gCAAgC,IACxC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CACtB,cACE,KAAK,EAAC,8BAA8B,EACpC,OAAO,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,EAClC,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAC,QAAQ,IAEZ,KAAK,CACC,CACV,CAAC,CACE,CACP,CAAC;AACJ,CAAC,CAAC","sourcesContent":["/**\n * QuickReplies - Internal component\n * Renders quick reply suggestion buttons\n */\n\nimport { h } from '@stencil/core';\nimport { QuickRepliesProps } from './types';\n\nexport const QuickReplies = (props: QuickRepliesProps) => {\n  const { replies, disabled, onReplyClick } = props;\n\n  if (!replies || replies.length === 0) {\n    return null;\n  }\n\n  return (\n    <div class=\"xplor-assistant__quick-replies\">\n      {replies.map((reply) => (\n        <button\n          class=\"xplor-assistant__quick-reply\"\n          onClick={() => onReplyClick(reply)}\n          disabled={disabled}\n          type=\"button\"\n        >\n          {reply}\n        </button>\n      ))}\n    </div>\n  );\n};\n"]}

package/dist/collection/components/xplor-assistant/internal/TypingIndicator.js

@@ -0,0 +1,9 @@
+/**
+ * TypingIndicator - Internal component
+ * Displays animated dots to indicate the assistant is processing/typing
+ */
+import { h } from "@stencil/core";
+export const TypingIndicator = () => {
+    return (h("div", { class: "xplor-assistant__typing-indicator" }, h("span", { class: "xplor-assistant__typing-dot" }), h("span", { class: "xplor-assistant__typing-dot" }), h("span", { class: "xplor-assistant__typing-dot" })));
+};
+//# sourceMappingURL=TypingIndicator.js.map

package/dist/collection/components/xplor-assistant/internal/TypingIndicator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TypingIndicator.js","sourceRoot":"","sources":["../../../../src/components/xplor-assistant/internal/TypingIndicator.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,eAAe,CAAC;AAElC,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,EAAE;IAClC,OAAO,CACL,WAAK,KAAK,EAAC,mCAAmC;QAC5C,YAAM,KAAK,EAAC,6BAA6B,GAAQ;QACjD,YAAM,KAAK,EAAC,6BAA6B,GAAQ;QACjD,YAAM,KAAK,EAAC,6BAA6B,GAAQ,CAC7C,CACP,CAAC;AACJ,CAAC,CAAC","sourcesContent":["/**\n * TypingIndicator - Internal component\n * Displays animated dots to indicate the assistant is processing/typing\n */\n\nimport { h } from '@stencil/core';\n\nexport const TypingIndicator = () => {\n  return (\n    <div class=\"xplor-assistant__typing-indicator\">\n      <span class=\"xplor-assistant__typing-dot\"></span>\n      <span class=\"xplor-assistant__typing-dot\"></span>\n      <span class=\"xplor-assistant__typing-dot\"></span>\n    </div>\n  );\n};\n"]}

package/dist/collection/components/xplor-assistant/internal/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/collection/components/xplor-assistant/internal/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/components/xplor-assistant/internal/types.ts"],"names":[],"mappings":"AAAA;;GAEG","sourcesContent":["/**\n * Type definitions for the xplor-assistant component\n */\n\n/**\n * Represents a single message in the conversation\n */\nexport interface AssistantMessage {\n  id: string;\n  role: 'user' | 'assistant';\n  content: string;\n  timestamp: Date;\n}\n\n/**\n * API Request payload sent to the backend\n */\nexport interface AssistantAPIRequest {\n  message: string;\n  sessionId: string;\n  userId: string;\n  userEmail: string;\n  userName: string;\n  currentDate: string;  // Format: YYYY-MM-DD\n  currentTime: string;  // Format: HH:MM:SS\n}\n\n/**\n * API Response received from the backend\n */\nexport interface AssistantAPIResponse {\n  message: string;\n  sessionId: string;\n}\n\n/**\n * Event emitted when a message is sent\n */\nexport interface AssistantMessageSentEvent {\n  message: string;\n  sessionId: string;\n  timestamp: Date;\n}\n\n/**\n * Event emitted when a message is received from the API\n */\nexport interface AssistantMessageReceivedEvent {\n  message: string;\n  sessionId: string;\n  timestamp: Date;\n}\n\n/**\n * Event emitted when an error occurs\n */\nexport interface AssistantErrorEvent {\n  error: string;\n  type: 'api' | 'voice' | 'tts' | 'network' | 'validation';\n  timestamp: Date;\n}\n\n/**\n * Event emitted when a session is created or updated\n */\nexport interface AssistantSessionEvent {\n  sessionId: string;\n  timestamp: Date;\n}\n\n/**\n * Props for internal AssistantMessage component\n */\nexport interface AssistantMessageProps {\n  message: AssistantMessage;\n  enableTextToSpeech: boolean;\n  autoSpeak: boolean;\n  onSpeak?: (text: string) => void;\n  onStopSpeaking?: () => void;\n  isSpeaking?: boolean;\n}\n\n/**\n * Props for internal AssistantInput component\n */\nexport interface AssistantInputProps {\n  placeholder: string;\n  disabled: boolean;\n  isLoading: boolean;\n  enableVoiceInput: boolean;\n  isListening: boolean;\n  onSendMessage: (message: string) => void;\n  onStartListening: () => void;\n  onStopListening: () => void;\n}\n\n/**\n * Props for internal QuickReplies component\n */\nexport interface QuickRepliesProps {\n  replies: string[];\n  disabled: boolean;\n  onReplyClick: (reply: string) => void;\n}\n\n/**\n * Props for internal TypingIndicator component\n */\nexport interface TypingIndicatorProps {\n  // No props needed - just animated dots\n}\n\n/**\n * Browser capabilities detection result\n */\nexport interface BrowserCapabilities {\n  voiceInput: boolean;\n  textToSpeech: boolean;\n}\n"]}

package/dist/collection/components/xplor-assistant/utils/api.js

@@ -0,0 +1,138 @@
+/**
+ * API integration utilities for the xplor-assistant component
+ */
+/**
+ * Generates a unique session ID
+ * Format: session_${timestamp}_${random}
+ */
+export function generateSessionId() {
+    const timestamp = Date.now();
+    const random = Math.random().toString(36).substring(2, 11);
+    return `session_${timestamp}_${random}`;
+}
+/**
+ * Formats the current date as YYYY-MM-DD
+ */
+export function getCurrentDate() {
+    const now = new Date();
+    const year = now.getFullYear();
+    const month = String(now.getMonth() + 1).padStart(2, '0');
+    const day = String(now.getDate()).padStart(2, '0');
+    return `${year}-${month}-${day}`;
+}
+/**
+ * Formats the current time as HH:MM:SS
+ */
+export function getCurrentTime() {
+    const now = new Date();
+    const hours = String(now.getHours()).padStart(2, '0');
+    const minutes = String(now.getMinutes()).padStart(2, '0');
+    const seconds = String(now.getSeconds()).padStart(2, '0');
+    return `${hours}:${minutes}:${seconds}`;
+}
+/**
+ * Sends a message to the assistant API
+ *
+ * @param endpoint - The API endpoint URL
+ * @param message - The user's message
+ * @param sessionId - The current session ID
+ * @param userId - The user's ID
+ * @param userEmail - The user's email
+ * @param userName - The user's name
+ * @returns Promise with the API response
+ * @throws Error if the API call fails
+ */
+export async function sendMessageToAPI(endpoint, message, sessionId, userId, userEmail, userName) {
+    if (!endpoint) {
+        throw new Error('API endpoint is required');
+    }
+    if (!message || !message.trim()) {
+        throw new Error('Message cannot be empty');
+    }
+    const payload = {
+        message: message.trim(),
+        sessionId,
+        userId,
+        userEmail,
+        userName,
+        currentDate: getCurrentDate(),
+        currentTime: getCurrentTime(),
+    };
+    try {
+        const response = await fetch(endpoint, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify(payload),
+        });
+        if (!response.ok) {
+            const errorText = await response.text().catch(() => response.statusText);
+            throw new Error(`API error: ${response.status} - ${errorText}`);
+        }
+        const data = await response.json();
+        // Validate response structure
+        if (!data.message || !data.sessionId) {
+            throw new Error('Invalid API response: missing required fields');
+        }
+        return data;
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            // Re-throw with more context if it's a fetch error
+            if (error.name === 'TypeError' && error.message.includes('fetch')) {
+                throw new Error('Network error: Unable to reach the API. Please check your connection.');
+            }
+            throw error;
+        }
+        throw new Error('Unknown error occurred while calling the API');
+    }
+}
+/**
+ * Creates an AbortController for cancelling requests
+ * Useful for cleanup when component unmounts
+ */
+export function createRequestController() {
+    return new AbortController();
+}
+/**
+ * Sends a message to the API with abort support
+ *
+ * @param endpoint - The API endpoint URL
+ * @param message - The user's message
+ * @param sessionId - The current session ID
+ * @param userId - The user's ID
+ * @param userEmail - The user's email
+ * @param userName - The user's name
+ * @param signal - AbortSignal for cancelling the request
+ * @returns Promise with the API response
+ */
+export async function sendMessageWithAbort(endpoint, message, sessionId, userId, userEmail, userName, signal) {
+    const payload = {
+        message: message.trim(),
+        sessionId,
+        userId,
+        userEmail,
+        userName,
+        currentDate: getCurrentDate(),
+        currentTime: getCurrentTime(),
+    };
+    const response = await fetch(endpoint, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+        },
+        body: JSON.stringify(payload),
+        signal,
+    });
+    if (!response.ok) {
+        const errorText = await response.text().catch(() => response.statusText);
+        throw new Error(`API error: ${response.status} - ${errorText}`);
+    }
+    const data = await response.json();
+    if (!data.message || !data.sessionId) {
+        throw new Error('Invalid API response: missing required fields');
+    }
+    return data;
+}
+//# sourceMappingURL=api.js.map

package/dist/collection/components/xplor-assistant/utils/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../../../src/components/xplor-assistant/utils/api.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * API integration utilities for the xplor-assistant component\n */\n\nimport { AssistantAPIRequest, AssistantAPIResponse } from '../internal/types';\n\n/**\n * Generates a unique session ID\n * Format: session_${timestamp}_${random}\n */\nexport function generateSessionId(): string {\n  const timestamp = Date.now();\n  const random = Math.random().toString(36).substring(2, 11);\n  return `session_${timestamp}_${random}`;\n}\n\n/**\n * Formats the current date as YYYY-MM-DD\n */\nexport function getCurrentDate(): string {\n  const now = new Date();\n  const year = now.getFullYear();\n  const month = String(now.getMonth() + 1).padStart(2, '0');\n  const day = String(now.getDate()).padStart(2, '0');\n  return `${year}-${month}-${day}`;\n}\n\n/**\n * Formats the current time as HH:MM:SS\n */\nexport function getCurrentTime(): string {\n  const now = new Date();\n  const hours = String(now.getHours()).padStart(2, '0');\n  const minutes = String(now.getMinutes()).padStart(2, '0');\n  const seconds = String(now.getSeconds()).padStart(2, '0');\n  return `${hours}:${minutes}:${seconds}`;\n}\n\n/**\n * Sends a message to the assistant API\n *\n * @param endpoint - The API endpoint URL\n * @param message - The user's message\n * @param sessionId - The current session ID\n * @param userId - The user's ID\n * @param userEmail - The user's email\n * @param userName - The user's name\n * @returns Promise with the API response\n * @throws Error if the API call fails\n */\nexport async function sendMessageToAPI(\n  endpoint: string,\n  message: string,\n  sessionId: string,\n  userId: string,\n  userEmail: string,\n  userName: string\n): Promise<AssistantAPIResponse> {\n  if (!endpoint) {\n    throw new Error('API endpoint is required');\n  }\n\n  if (!message || !message.trim()) {\n    throw new Error('Message cannot be empty');\n  }\n\n  const payload: AssistantAPIRequest = {\n    message: message.trim(),\n    sessionId,\n    userId,\n    userEmail,\n    userName,\n    currentDate: getCurrentDate(),\n    currentTime: getCurrentTime(),\n  };\n\n  try {\n    const response = await fetch(endpoint, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n      },\n      body: JSON.stringify(payload),\n    });\n\n    if (!response.ok) {\n      const errorText = await response.text().catch(() => response.statusText);\n      throw new Error(`API error: ${response.status} - ${errorText}`);\n    }\n\n    const data: AssistantAPIResponse = await response.json();\n\n    // Validate response structure\n    if (!data.message || !data.sessionId) {\n      throw new Error('Invalid API response: missing required fields');\n    }\n\n    return data;\n  } catch (error) {\n    if (error instanceof Error) {\n      // Re-throw with more context if it's a fetch error\n      if (error.name === 'TypeError' && error.message.includes('fetch')) {\n        throw new Error('Network error: Unable to reach the API. Please check your connection.');\n      }\n      throw error;\n    }\n    throw new Error('Unknown error occurred while calling the API');\n  }\n}\n\n/**\n * Creates an AbortController for cancelling requests\n * Useful for cleanup when component unmounts\n */\nexport function createRequestController(): AbortController {\n  return new AbortController();\n}\n\n/**\n * Sends a message to the API with abort support\n *\n * @param endpoint - The API endpoint URL\n * @param message - The user's message\n * @param sessionId - The current session ID\n * @param userId - The user's ID\n * @param userEmail - The user's email\n * @param userName - The user's name\n * @param signal - AbortSignal for cancelling the request\n * @returns Promise with the API response\n */\nexport async function sendMessageWithAbort(\n  endpoint: string,\n  message: string,\n  sessionId: string,\n  userId: string,\n  userEmail: string,\n  userName: string,\n  signal?: AbortSignal\n): Promise<AssistantAPIResponse> {\n  const payload: AssistantAPIRequest = {\n    message: message.trim(),\n    sessionId,\n    userId,\n    userEmail,\n    userName,\n    currentDate: getCurrentDate(),\n    currentTime: getCurrentTime(),\n  };\n\n  const response = await fetch(endpoint, {\n    method: 'POST',\n    headers: {\n      'Content-Type': 'application/json',\n    },\n    body: JSON.stringify(payload),\n    signal,\n  });\n\n  if (!response.ok) {\n    const errorText = await response.text().catch(() => response.statusText);\n    throw new Error(`API error: ${response.status} - ${errorText}`);\n  }\n\n  const data: AssistantAPIResponse = await response.json();\n\n  if (!data.message || !data.sessionId) {\n    throw new Error('Invalid API response: missing required fields');\n  }\n\n  return data;\n}\n"]}

package/dist/collection/components/xplor-assistant/utils/icons.js

@@ -0,0 +1,53 @@
+/**
+ * SVG icon definitions for the xplor-assistant component
+ * Following the pattern used in xplor-button component
+ */
+/**
+ * Microphone icon for voice input button
+ */
+export const microphoneIcon = `
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+  <path d="M12 1a3 3 0 0 0-3 3v8a3 3 0 0 0 6 0V4a3 3 0 0 0-3-3z"></path>
+  <path d="M19 10v2a7 7 0 0 1-14 0v-2"></path>
+  <line x1="12" y1="19" x2="12" y2="23"></line>
+  <line x1="8" y1="23" x2="16" y2="23"></line>
+</svg>
+`;
+/**
+ * Send arrow icon for send message button
+ */
+export const sendIcon = `
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+  <line x1="22" y1="2" x2="11" y2="13"></line>
+  <polygon points="22 2 15 22 11 13 2 9 22 2"></polygon>
+</svg>
+`;
+/**
+ * Speaker icon for text-to-speech button
+ */
+export const speakerIcon = `
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+  <polygon points="11 5 6 9 2 9 2 15 6 15 11 19 11 5"></polygon>
+  <path d="M15.54 8.46a5 5 0 0 1 0 7.07"></path>
+  <path d="M19.07 4.93a10 10 0 0 1 0 14.14"></path>
+</svg>
+`;
+/**
+ * Stop square icon for stopping speech
+ */
+export const stopIcon = `
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="currentColor" stroke="none">
+  <rect x="6" y="6" width="12" height="12" rx="2"></rect>
+</svg>
+`;
+/**
+ * Muted speaker icon for when TTS is disabled
+ */
+export const speakerMutedIcon = `
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+  <polygon points="11 5 6 9 2 9 2 15 6 15 11 19 11 5"></polygon>
+  <line x1="23" y1="9" x2="17" y2="15"></line>
+  <line x1="17" y1="9" x2="23" y2="15"></line>
+</svg>
+`;
+//# sourceMappingURL=icons.js.map

package/dist/collection/components/xplor-assistant/utils/icons.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"icons.js","sourceRoot":"","sources":["../../../../src/components/xplor-assistant/utils/icons.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;;;;;;;CAO7B,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;;;;;CAKvB,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;;;;;;CAM1B,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;;;;CAIvB,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;;;;;;CAM/B,CAAC","sourcesContent":["/**\n * SVG icon definitions for the xplor-assistant component\n * Following the pattern used in xplor-button component\n */\n\n/**\n * Microphone icon for voice input button\n */\nexport const microphoneIcon = `\n<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\n  <path d=\"M12 1a3 3 0 0 0-3 3v8a3 3 0 0 0 6 0V4a3 3 0 0 0-3-3z\"></path>\n  <path d=\"M19 10v2a7 7 0 0 1-14 0v-2\"></path>\n  <line x1=\"12\" y1=\"19\" x2=\"12\" y2=\"23\"></line>\n  <line x1=\"8\" y1=\"23\" x2=\"16\" y2=\"23\"></line>\n</svg>\n`;\n\n/**\n * Send arrow icon for send message button\n */\nexport const sendIcon = `\n<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\n  <line x1=\"22\" y1=\"2\" x2=\"11\" y2=\"13\"></line>\n  <polygon points=\"22 2 15 22 11 13 2 9 22 2\"></polygon>\n</svg>\n`;\n\n/**\n * Speaker icon for text-to-speech button\n */\nexport const speakerIcon = `\n<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\n  <polygon points=\"11 5 6 9 2 9 2 15 6 15 11 19 11 5\"></polygon>\n  <path d=\"M15.54 8.46a5 5 0 0 1 0 7.07\"></path>\n  <path d=\"M19.07 4.93a10 10 0 0 1 0 14.14\"></path>\n</svg>\n`;\n\n/**\n * Stop square icon for stopping speech\n */\nexport const stopIcon = `\n<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 24 24\" fill=\"currentColor\" stroke=\"none\">\n  <rect x=\"6\" y=\"6\" width=\"12\" height=\"12\" rx=\"2\"></rect>\n</svg>\n`;\n\n/**\n * Muted speaker icon for when TTS is disabled\n */\nexport const speakerMutedIcon = `\n<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\n  <polygon points=\"11 5 6 9 2 9 2 15 6 15 11 19 11 5\"></polygon>\n  <line x1=\"23\" y1=\"9\" x2=\"17\" y2=\"15\"></line>\n  <line x1=\"17\" y1=\"9\" x2=\"23\" y2=\"15\"></line>\n</svg>\n`;\n"]}

package/dist/collection/components/xplor-assistant/utils/speech.js

@@ -0,0 +1,230 @@
+/**
+ * Web Speech API helpers for the xplor-assistant component
+ * Handles both Speech Recognition (voice input) and Speech Synthesis (text-to-speech)
+ */
+/**
+ * Detects browser capabilities for speech features
+ */
+export function detectBrowserCapabilities() {
+    if (typeof window === 'undefined') {
+        return {
+            voiceInput: false,
+            textToSpeech: false,
+        };
+    }
+    const hasVoiceInput = 'SpeechRecognition' in window ||
+        'webkitSpeechRecognition' in window;
+    const hasTTS = 'speechSynthesis' in window;
+    return {
+        voiceInput: hasVoiceInput,
+        textToSpeech: hasTTS,
+    };
+}
+/**
+ * Speech Recognition Manager
+ * Handles voice-to-text functionality
+ */
+export class SpeechRecognitionManager {
+    constructor() {
+        this.recognition = null;
+        this.onResultCallback = null;
+        this.onErrorCallback = null;
+        this.onStartCallback = null;
+        this.onEndCallback = null;
+        if (typeof window === 'undefined')
+            return;
+        const SpeechRecognition = window.SpeechRecognition ||
+            window.webkitSpeechRecognition;
+        if (SpeechRecognition) {
+            this.recognition = new SpeechRecognition();
+            this.recognition.continuous = false;
+            this.recognition.interimResults = false;
+            this.recognition.lang = 'en-US';
+            this.recognition.maxAlternatives = 1;
+            this.recognition.onstart = () => {
+                if (this.onStartCallback) {
+                    this.onStartCallback();
+                }
+            };
+            this.recognition.onresult = (event) => {
+                const transcript = event.results[0][0].transcript;
+                if (this.onResultCallback) {
+                    this.onResultCallback(transcript);
+                }
+            };
+            this.recognition.onerror = (event) => {
+                const errorMessage = this.getErrorMessage(event.error);
+                if (this.onErrorCallback) {
+                    this.onErrorCallback(errorMessage);
+                }
+            };
+            this.recognition.onend = () => {
+                if (this.onEndCallback) {
+                    this.onEndCallback();
+                }
+            };
+        }
+    }
+    /**
+     * Converts speech recognition error codes to user-friendly messages
+     */
+    getErrorMessage(error) {
+        switch (error) {
+            case 'no-speech':
+                return 'No speech detected. Please try again.';
+            case 'audio-capture':
+                return 'No microphone found. Please ensure a microphone is connected.';
+            case 'not-allowed':
+                return 'Microphone permission denied. Please allow microphone access.';
+            case 'network':
+                return 'Network error. Please check your connection.';
+            default:
+                return `Speech recognition error: ${error}`;
+        }
+    }
+    /**
+     * Starts listening for voice input
+     */
+    start() {
+        if (!this.recognition) {
+            console.error('Speech recognition not supported');
+            return;
+        }
+        try {
+            this.recognition.start();
+        }
+        catch (error) {
+            console.error('Failed to start speech recognition:', error);
+            if (this.onErrorCallback) {
+                this.onErrorCallback('Failed to start voice recognition');
+            }
+        }
+    }
+    /**
+     * Stops listening for voice input
+     */
+    stop() {
+        if (this.recognition) {
+            this.recognition.stop();
+        }
+    }
+    /**
+     * Sets the callback for when a result is received
+     */
+    onResult(callback) {
+        this.onResultCallback = callback;
+    }
+    /**
+     * Sets the callback for when an error occurs
+     */
+    onError(callback) {
+        this.onErrorCallback = callback;
+    }
+    /**
+     * Sets the callback for when recognition starts
+     */
+    onStart(callback) {
+        this.onStartCallback = callback;
+    }
+    /**
+     * Sets the callback for when recognition ends
+     */
+    onEnd(callback) {
+        this.onEndCallback = callback;
+    }
+    /**
+     * Checks if speech recognition is available
+     */
+    isAvailable() {
+        return this.recognition !== null;
+    }
+}
+/**
+ * Speech Synthesis Manager
+ * Handles text-to-speech functionality
+ */
+export class SpeechSynthesisManager {
+    constructor() {
+        this.currentUtterance = null;
+        this.onStartCallback = null;
+        this.onEndCallback = null;
+    }
+    /**
+     * Speaks the given text
+     */
+    speak(text) {
+        if (typeof window === 'undefined' || !('speechSynthesis' in window)) {
+            console.error('Speech synthesis not supported');
+            return;
+        }
+        // Stop any ongoing speech first
+        this.stop();
+        this.currentUtterance = new SpeechSynthesisUtterance(text);
+        this.currentUtterance.lang = 'en-US';
+        this.currentUtterance.rate = 1.0;
+        this.currentUtterance.pitch = 1.0;
+        this.currentUtterance.volume = 1.0;
+        this.currentUtterance.onstart = () => {
+            if (this.onStartCallback) {
+                this.onStartCallback();
+            }
+        };
+        this.currentUtterance.onend = () => {
+            if (this.onEndCallback) {
+                this.onEndCallback();
+            }
+            this.currentUtterance = null;
+        };
+        this.currentUtterance.onerror = (event) => {
+            console.error('Speech synthesis error:', event);
+            if (this.onEndCallback) {
+                this.onEndCallback();
+            }
+            this.currentUtterance = null;
+        };
+        window.speechSynthesis.speak(this.currentUtterance);
+    }
+    /**
+     * Stops any ongoing speech
+     */
+    stop() {
+        if (typeof window === 'undefined' || !('speechSynthesis' in window)) {
+            return;
+        }
+        if (window.speechSynthesis.speaking) {
+            window.speechSynthesis.cancel();
+            if (this.onEndCallback) {
+                this.onEndCallback();
+            }
+        }
+        this.currentUtterance = null;
+    }
+    /**
+     * Checks if currently speaking
+     */
+    isSpeaking() {
+        if (typeof window === 'undefined' || !('speechSynthesis' in window)) {
+            return false;
+        }
+        return window.speechSynthesis.speaking;
+    }
+    /**
+     * Sets the callback for when speech starts
+     */
+    onStart(callback) {
+        this.onStartCallback = callback;
+    }
+    /**
+     * Sets the callback for when speech ends
+     */
+    onEnd(callback) {
+        this.onEndCallback = callback;
+    }
+    /**
+     * Checks if speech synthesis is available
+     */
+    isAvailable() {
+        return typeof window !== 'undefined' && 'speechSynthesis' in window;
+    }
+}
+//# sourceMappingURL=speech.js.map

package/dist/collection/components/xplor-assistant/utils/speech.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"speech.js","sourceRoot":"","sources":["../../../../src/components/xplor-assistant/utils/speech.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Web Speech API helpers for the xplor-assistant component\n * Handles both Speech Recognition (voice input) and Speech Synthesis (text-to-speech)\n */\n\nimport { BrowserCapabilities } from '../internal/types';\n\n/**\n * Detects browser capabilities for speech features\n */\nexport function detectBrowserCapabilities(): BrowserCapabilities {\n  if (typeof window === 'undefined') {\n    return {\n      voiceInput: false,\n      textToSpeech: false,\n    };\n  }\n\n  const hasVoiceInput =\n    'SpeechRecognition' in window ||\n    'webkitSpeechRecognition' in window;\n\n  const hasTTS = 'speechSynthesis' in window;\n\n  return {\n    voiceInput: hasVoiceInput,\n    textToSpeech: hasTTS,\n  };\n}\n\n/**\n * Speech Recognition Manager\n * Handles voice-to-text functionality\n */\nexport class SpeechRecognitionManager {\n  private recognition: any = null;\n  private onResultCallback: ((transcript: string) => void) | null = null;\n  private onErrorCallback: ((error: string) => void) | null = null;\n  private onStartCallback: (() => void) | null = null;\n  private onEndCallback: (() => void) | null = null;\n\n  constructor() {\n    if (typeof window === 'undefined') return;\n\n    const SpeechRecognition =\n      (window as any).SpeechRecognition ||\n      (window as any).webkitSpeechRecognition;\n\n    if (SpeechRecognition) {\n      this.recognition = new SpeechRecognition();\n      this.recognition.continuous = false;\n      this.recognition.interimResults = false;\n      this.recognition.lang = 'en-US';\n      this.recognition.maxAlternatives = 1;\n\n      this.recognition.onstart = () => {\n        if (this.onStartCallback) {\n          this.onStartCallback();\n        }\n      };\n\n      this.recognition.onresult = (event: any) => {\n        const transcript = event.results[0][0].transcript;\n        if (this.onResultCallback) {\n          this.onResultCallback(transcript);\n        }\n      };\n\n      this.recognition.onerror = (event: any) => {\n        const errorMessage = this.getErrorMessage(event.error);\n        if (this.onErrorCallback) {\n          this.onErrorCallback(errorMessage);\n        }\n      };\n\n      this.recognition.onend = () => {\n        if (this.onEndCallback) {\n          this.onEndCallback();\n        }\n      };\n    }\n  }\n\n  /**\n   * Converts speech recognition error codes to user-friendly messages\n   */\n  private getErrorMessage(error: string): string {\n    switch (error) {\n      case 'no-speech':\n        return 'No speech detected. Please try again.';\n      case 'audio-capture':\n        return 'No microphone found. Please ensure a microphone is connected.';\n      case 'not-allowed':\n        return 'Microphone permission denied. Please allow microphone access.';\n      case 'network':\n        return 'Network error. Please check your connection.';\n      default:\n        return `Speech recognition error: ${error}`;\n    }\n  }\n\n  /**\n   * Starts listening for voice input\n   */\n  start(): void {\n    if (!this.recognition) {\n      console.error('Speech recognition not supported');\n      return;\n    }\n\n    try {\n      this.recognition.start();\n    } catch (error) {\n      console.error('Failed to start speech recognition:', error);\n      if (this.onErrorCallback) {\n        this.onErrorCallback('Failed to start voice recognition');\n      }\n    }\n  }\n\n  /**\n   * Stops listening for voice input\n   */\n  stop(): void {\n    if (this.recognition) {\n      this.recognition.stop();\n    }\n  }\n\n  /**\n   * Sets the callback for when a result is received\n   */\n  onResult(callback: (transcript: string) => void): void {\n    this.onResultCallback = callback;\n  }\n\n  /**\n   * Sets the callback for when an error occurs\n   */\n  onError(callback: (error: string) => void): void {\n    this.onErrorCallback = callback;\n  }\n\n  /**\n   * Sets the callback for when recognition starts\n   */\n  onStart(callback: () => void): void {\n    this.onStartCallback = callback;\n  }\n\n  /**\n   * Sets the callback for when recognition ends\n   */\n  onEnd(callback: () => void): void {\n    this.onEndCallback = callback;\n  }\n\n  /**\n   * Checks if speech recognition is available\n   */\n  isAvailable(): boolean {\n    return this.recognition !== null;\n  }\n}\n\n/**\n * Speech Synthesis Manager\n * Handles text-to-speech functionality\n */\nexport class SpeechSynthesisManager {\n  private currentUtterance: SpeechSynthesisUtterance | null = null;\n  private onStartCallback: (() => void) | null = null;\n  private onEndCallback: (() => void) | null = null;\n\n  /**\n   * Speaks the given text\n   */\n  speak(text: string): void {\n    if (typeof window === 'undefined' || !('speechSynthesis' in window)) {\n      console.error('Speech synthesis not supported');\n      return;\n    }\n\n    // Stop any ongoing speech first\n    this.stop();\n\n    this.currentUtterance = new SpeechSynthesisUtterance(text);\n    this.currentUtterance.lang = 'en-US';\n    this.currentUtterance.rate = 1.0;\n    this.currentUtterance.pitch = 1.0;\n    this.currentUtterance.volume = 1.0;\n\n    this.currentUtterance.onstart = () => {\n      if (this.onStartCallback) {\n        this.onStartCallback();\n      }\n    };\n\n    this.currentUtterance.onend = () => {\n      if (this.onEndCallback) {\n        this.onEndCallback();\n      }\n      this.currentUtterance = null;\n    };\n\n    this.currentUtterance.onerror = (event) => {\n      console.error('Speech synthesis error:', event);\n      if (this.onEndCallback) {\n        this.onEndCallback();\n      }\n      this.currentUtterance = null;\n    };\n\n    window.speechSynthesis.speak(this.currentUtterance);\n  }\n\n  /**\n   * Stops any ongoing speech\n   */\n  stop(): void {\n    if (typeof window === 'undefined' || !('speechSynthesis' in window)) {\n      return;\n    }\n\n    if (window.speechSynthesis.speaking) {\n      window.speechSynthesis.cancel();\n      if (this.onEndCallback) {\n        this.onEndCallback();\n      }\n    }\n    this.currentUtterance = null;\n  }\n\n  /**\n   * Checks if currently speaking\n   */\n  isSpeaking(): boolean {\n    if (typeof window === 'undefined' || !('speechSynthesis' in window)) {\n      return false;\n    }\n    return window.speechSynthesis.speaking;\n  }\n\n  /**\n   * Sets the callback for when speech starts\n   */\n  onStart(callback: () => void): void {\n    this.onStartCallback = callback;\n  }\n\n  /**\n   * Sets the callback for when speech ends\n   */\n  onEnd(callback: () => void): void {\n    this.onEndCallback = callback;\n  }\n\n  /**\n   * Checks if speech synthesis is available\n   */\n  isAvailable(): boolean {\n    return typeof window !== 'undefined' && 'speechSynthesis' in window;\n  }\n}\n"]}