@constructor-io/constructorio-ui-pia 2.2.0 → 2.3.0

package/lib/cjs/components/CioPia/CioPia.js

@@ -18,7 +18,7 @@ const PiaModal_1 = tslib_1.__importDefault(require("../PiaConversation/PiaModal"
 const PiaConversation_1 = tslib_1.__importDefault(require("../PiaConversation/PiaConversation"));
 function CioPia(props) {
     const { apiKey, itemId, threadId, variationId, cioClient, displayConfigs, componentOverrides, callbacks, formatters, children, translations, suggestedQuestionsParameters, } = props;
-    const { learnMoreUrl, showFeedback, mode = 'default', type = 'inline', showPreviousItems, } = displayConfigs || {};
+    const { learnMoreUrl, showFeedback, mode = 'default', type = 'inline', showPreviousItems, disclaimerPosition = 'bottom', } = displayConfigs || {};
     const isConversation = mode === 'conversation' || type === 'modal';
     const pia = (0, useCioPia_1.default)({
         apiKey,
@@ -29,7 +29,7 @@ function CioPia(props) {
         suggestedQuestionsParameters,
         formatImageUrl: formatters === null || formatters === void 0 ? void 0 : formatters.formatImageUrl,
     });
-    const { currentQuestion, displayedQuestions, conversationHistory, currentAnswer, currentItems, isLoading, error, handleSubmitQuestion, resetState, } = (0, useConversation_1.default)({ pia, itemId, isConversation });
+    const { currentQuestion, displayedQuestions, conversationHistory, currentAnswer, currentItems, isLoading, error, handleSubmitQuestion, resetState, } = (0, useConversation_1.default)({ pia, itemId, isConversation, callbacks });
     const renderProps = {
         items: currentItems,
         isLoading,
@@ -48,6 +48,7 @@ function CioPia(props) {
         showFeedback,
         showPreviousItems,
         learnMoreUrl,
+        disclaimerPosition,
         translations,
         callbacks,
         componentOverrides,
@@ -60,6 +61,7 @@ function CioPia(props) {
     }
     if (isConversation)
         return react_1.default.createElement(PiaConversation_1.default, Object.assign({}, conversationHistoryProps));
+    const disclaimer = (react_1.default.createElement(Disclaimer_1.default, { learnMoreUrl: learnMoreUrl, translations: translations, componentOverride: componentOverrides === null || componentOverrides === void 0 ? void 0 : componentOverrides.disclaimer }));
     // Default inline mode
     return (react_1.default.createElement("div", { className: 'cio-pia-container', "data-testid": 'cio-pia-container' },
         react_1.default.createElement(constructorio_ui_components_1.RenderPropsWrapper, { props: renderProps, override: children || (componentOverrides === null || componentOverrides === void 0 ? void 0 : componentOverrides.reactNode) },
@@ -69,10 +71,11 @@ function CioPia(props) {
             !isLoading && error && react_1.default.createElement(ErrorBlock_1.default, { message: (error === null || error === void 0 ? void 0 : error.message) || 'Unexpected error' }),
             !isLoading && !error && (react_1.default.createElement(react_1.default.Fragment, null,
                 currentAnswer && (react_1.default.createElement("div", { className: 'cio-pia-answer-container' },
+                    disclaimerPosition === 'top' && disclaimer,
                     react_1.default.createElement(Answer_1.default, { text: currentAnswer, componentOverride: componentOverrides === null || componentOverrides === void 0 ? void 0 : componentOverrides.answer }),
                     currentItems && (react_1.default.createElement(PiaCustomCarousel_1.default, { items: currentItems, componentOverrides: componentOverrides === null || componentOverrides === void 0 ? void 0 : componentOverrides.carousel, callbacks: callbacks })),
                     showFeedback && (react_1.default.createElement(Feedback_1.default, { translations: translations, onFeedback: callbacks === null || callbacks === void 0 ? void 0 : callbacks.onFeedback, componentOverride: componentOverrides === null || componentOverrides === void 0 ? void 0 : componentOverrides.feedback })),
-                    react_1.default.createElement(Disclaimer_1.default, { learnMoreUrl: learnMoreUrl, translations: translations, componentOverride: componentOverrides === null || componentOverrides === void 0 ? void 0 : componentOverrides.disclaimer }))),
+                    disclaimerPosition === 'bottom' && disclaimer)),
                 react_1.default.createElement(SuggestedQuestionsContainer_1.default, { questions: displayedQuestions, onQuestionClick: handleSubmitQuestion, componentOverride: componentOverrides === null || componentOverrides === void 0 ? void 0 : componentOverrides.suggestedQuestions }))))));
 }
 exports.default = CioPia;

package/lib/cjs/components/ConversationHistory/ConversationHistory.js

@@ -8,7 +8,7 @@ const Disclaimer_1 = tslib_1.__importDefault(require("../CioPia/Disclaimer"));
 const ErrorBlock_1 = tslib_1.__importDefault(require("../Error/ErrorBlock"));
 const LoadingSkeleton_1 = tslib_1.__importDefault(require("../LoadingSkeleton/LoadingSkeleton"));
 const PiaCustomCarousel_1 = tslib_1.__importDefault(require("../CioPia/PiaCustomCarousel"));
-function ConversationHistory({ conversationHistory, isLoading, error, currentItems, showFeedback, showPreviousItems = true, learnMoreUrl, translations, callbacks, componentOverrides, }) {
+function ConversationHistory({ conversationHistory, isLoading, error, currentItems, showFeedback, showPreviousItems = true, learnMoreUrl, disclaimerPosition = 'bottom', translations, callbacks, componentOverrides, }) {
     const scrollContainerRef = (0, react_1.useRef)(null);
     (0, react_1.useEffect)(() => {
         const container = scrollContainerRef.current;
@@ -19,7 +19,9 @@ function ConversationHistory({ conversationHistory, isLoading, error, currentIte
         });
         return () => cancelAnimationFrame(frameId);
     }, [conversationHistory, isLoading]);
+    const disclaimer = (react_1.default.createElement(Disclaimer_1.default, { learnMoreUrl: learnMoreUrl, translations: translations, componentOverride: componentOverrides === null || componentOverrides === void 0 ? void 0 : componentOverrides.disclaimer }));
     return (react_1.default.createElement("div", { className: 'cio-pia-conversation-history' },
+        disclaimerPosition === 'top' && disclaimer,
         react_1.default.createElement("div", { ref: scrollContainerRef, className: 'cio-pia-conversation-entries', role: 'log', "aria-label": 'Conversation history' }, conversationHistory.map((entry, index) => {
             const isLast = index === conversationHistory.length - 1;
             const previousEntryItems = showPreviousItems ? entry.items : null;
@@ -35,6 +37,6 @@ function ConversationHistory({ conversationHistory, isLoading, error, currentIte
                     carouselItems && (react_1.default.createElement(PiaCustomCarousel_1.default, { items: carouselItems, componentOverrides: componentOverrides === null || componentOverrides === void 0 ? void 0 : componentOverrides.carousel, callbacks: callbacks })),
                     isLast && showFeedback && (react_1.default.createElement(Feedback_1.default, { translations: translations, onFeedback: callbacks === null || callbacks === void 0 ? void 0 : callbacks.onFeedback, componentOverride: componentOverrides === null || componentOverrides === void 0 ? void 0 : componentOverrides.feedback }))))));
         })),
-        react_1.default.createElement(Disclaimer_1.default, { learnMoreUrl: learnMoreUrl, translations: translations, componentOverride: componentOverrides === null || componentOverrides === void 0 ? void 0 : componentOverrides.disclaimer })));
+        disclaimerPosition === 'bottom' && disclaimer));
 }
 exports.default = ConversationHistory;

package/lib/cjs/components/ConversationHistory/ConversationHistoryStyles.css

@@ -4,6 +4,7 @@
   flex-direction: column;
   flex: 1;
   min-height: 0;
+  gap: var(--conversation-gap);
 }
 
 .cio-pia-conversation-entries {

package/lib/cjs/components/PiaConversation/PiaConversation.js

@@ -7,11 +7,11 @@ const SuggestedQuestionsContainer_1 = tslib_1.__importDefault(require("../Sugges
 const SuggestedQuestionsSkeleton_1 = tslib_1.__importDefault(require("../SuggestedQuestionsContainer/SuggestedQuestionsSkeleton"));
 const translate_1 = require("../../utils/translate");
 const ConversationHistory_1 = tslib_1.__importDefault(require("../ConversationHistory/ConversationHistory"));
-function PiaConversation({ conversationHistory, isLoading, error, currentItems, showFeedback, showPreviousItems, learnMoreUrl, translations, callbacks, componentOverrides, displayedQuestions, handleSubmitQuestion, }) {
+function PiaConversation({ conversationHistory, isLoading, error, currentItems, showFeedback, showPreviousItems, learnMoreUrl, disclaimerPosition, translations, callbacks, componentOverrides, displayedQuestions, handleSubmitQuestion, }) {
     const hasHistory = conversationHistory.length > 0;
     return (react_1.default.createElement("div", { className: 'cio-pia-container cio-pia-conversation', "data-testid": 'cio-pia-container' },
         !hasHistory && (react_1.default.createElement("p", { className: 'cio-pia-title', "data-testid": 'cio-pia-title' }, (0, translate_1.translate)('Any questions about this product?', translations))),
-        react_1.default.createElement(ConversationHistory_1.default, { conversationHistory: conversationHistory, isLoading: isLoading, error: error, currentItems: currentItems, showFeedback: showFeedback, showPreviousItems: showPreviousItems, learnMoreUrl: learnMoreUrl, translations: translations, callbacks: callbacks, componentOverrides: componentOverrides }),
+        react_1.default.createElement(ConversationHistory_1.default, { conversationHistory: conversationHistory, isLoading: isLoading, error: error, currentItems: currentItems, showFeedback: showFeedback, showPreviousItems: showPreviousItems, learnMoreUrl: learnMoreUrl, disclaimerPosition: disclaimerPosition, translations: translations, callbacks: callbacks, componentOverrides: componentOverrides }),
         react_1.default.createElement("div", { className: 'cio-pia-conversation-footer' },
             isLoading && !error && react_1.default.createElement(SuggestedQuestionsSkeleton_1.default, null),
             !isLoading && !error && (react_1.default.createElement(SuggestedQuestionsContainer_1.default, { questions: displayedQuestions, onQuestionClick: handleSubmitQuestion, componentOverride: componentOverrides === null || componentOverrides === void 0 ? void 0 : componentOverrides.suggestedQuestions })),

package/lib/cjs/components/PiaConversation/PiaModal.js

@@ -61,8 +61,9 @@ function PiaModal({ initialQuestions, handleSubmitQuestion, isLoading, component
     }, [handleSubmitQuestion, openModal]);
     return (react_1.default.createElement("div", { className: 'cio-pia-container', "data-testid": 'cio-pia-container' },
         react_1.default.createElement("p", { className: 'cio-pia-title', "data-testid": 'cio-pia-title' }, (0, translate_1.translate)('Any questions about this product?', translations)),
-        react_1.default.createElement(Input_1.default, { onSubmit: handleQuestion, disabled: isLoading || isOpen, translations: translations }),
-        initialQuestions.length > 0 && (react_1.default.createElement(SuggestedQuestionsContainer_1.default, { questions: initialQuestions, onQuestionClick: handleQuestion, componentOverride: componentOverrides === null || componentOverrides === void 0 ? void 0 : componentOverrides.suggestedQuestions })),
+        react_1.default.createElement("div", { className: 'cio-pia-conversation-footer' },
+            initialQuestions.length > 0 && (react_1.default.createElement(SuggestedQuestionsContainer_1.default, { questions: initialQuestions, onQuestionClick: handleQuestion, componentOverride: componentOverrides === null || componentOverrides === void 0 ? void 0 : componentOverrides.suggestedQuestions })),
+            react_1.default.createElement(Input_1.default, { onSubmit: handleQuestion, disabled: isLoading || isOpen, translations: translations })),
         react_1.default.createElement("dialog", { ref: dialogRef, className: 'cio-pia-modal', "aria-labelledby": 'cio-pia-modal-title' },
             react_1.default.createElement("div", { className: 'cio-pia-modal-content' },
                 react_1.default.createElement("div", { className: 'cio-pia-modal-header' },

package/lib/cjs/hooks/useConversation.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const react_1 = require("react");
-function useConversation({ pia, itemId, isConversation, }) {
+function useConversation({ pia, itemId, isConversation, callbacks, }) {
     var _a, _b, _c, _d;
     const { suggestedQuestions, answers } = pia;
     const { getAnswer } = answers;
@@ -11,6 +11,8 @@ function useConversation({ pia, itemId, isConversation, }) {
     const entryIdRef = (0, react_1.useRef)(0);
     const prevAnswerValueRef = (0, react_1.useRef)((_a = answers.data) === null || _a === void 0 ? void 0 : _a.value);
     const handleSubmitQuestion = (0, react_1.useCallback)((question) => {
+        var _a;
+        (_a = callbacks === null || callbacks === void 0 ? void 0 : callbacks.onQuestionSubmit) === null || _a === void 0 ? void 0 : _a.call(callbacks, question);
         setCurrentQuestion(question);
         getAnswer(question);
         if (isConversation) {
@@ -18,7 +20,7 @@ function useConversation({ pia, itemId, isConversation, }) {
             const id = entryIdRef.current;
             setConversationHistory((prev) => [...prev, { id, question, answer: '' }]);
         }
-    }, [getAnswer, isConversation]);
+    }, [getAnswer, isConversation, callbacks]);
     const resetState = (0, react_1.useCallback)(() => {
         setCurrentQuestion('');
         setDisplayedQuestions(suggestedQuestions.data);

package/lib/cjs/version.js

@@ -1,3 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = '2.2.0';
+exports.default = '2.3.0';

package/lib/mjs/components/CioPia/CioPia.js

@@ -15,7 +15,7 @@ import PiaModal from '../PiaConversation/PiaModal';
 import PiaConversation from '../PiaConversation/PiaConversation';
 export default function CioPia(props) {
     const { apiKey, itemId, threadId, variationId, cioClient, displayConfigs, componentOverrides, callbacks, formatters, children, translations, suggestedQuestionsParameters, } = props;
-    const { learnMoreUrl, showFeedback, mode = 'default', type = 'inline', showPreviousItems, } = displayConfigs || {};
+    const { learnMoreUrl, showFeedback, mode = 'default', type = 'inline', showPreviousItems, disclaimerPosition = 'bottom', } = displayConfigs || {};
     const isConversation = mode === 'conversation' || type === 'modal';
     const pia = useCioPia({
         apiKey,
@@ -26,7 +26,7 @@ export default function CioPia(props) {
         suggestedQuestionsParameters,
         formatImageUrl: formatters?.formatImageUrl,
     });
-    const { currentQuestion, displayedQuestions, conversationHistory, currentAnswer, currentItems, isLoading, error, handleSubmitQuestion, resetState, } = useConversation({ pia, itemId, isConversation });
+    const { currentQuestion, displayedQuestions, conversationHistory, currentAnswer, currentItems, isLoading, error, handleSubmitQuestion, resetState, } = useConversation({ pia, itemId, isConversation, callbacks });
     const renderProps = {
         items: currentItems,
         isLoading,
@@ -45,6 +45,7 @@ export default function CioPia(props) {
         showFeedback,
         showPreviousItems,
         learnMoreUrl,
+        disclaimerPosition,
         translations,
         callbacks,
         componentOverrides,
@@ -57,6 +58,7 @@ export default function CioPia(props) {
     }
     if (isConversation)
         return React.createElement(PiaConversation, { ...conversationHistoryProps });
+    const disclaimer = (React.createElement(Disclaimer, { learnMoreUrl: learnMoreUrl, translations: translations, componentOverride: componentOverrides?.disclaimer }));
     // Default inline mode
     return (React.createElement("div", { className: 'cio-pia-container', "data-testid": 'cio-pia-container' },
         React.createElement(RenderPropsWrapper, { props: renderProps, override: children || componentOverrides?.reactNode },
@@ -66,9 +68,10 @@ export default function CioPia(props) {
             !isLoading && error && React.createElement(ErrorBlock, { message: error?.message || 'Unexpected error' }),
             !isLoading && !error && (React.createElement(React.Fragment, null,
                 currentAnswer && (React.createElement("div", { className: 'cio-pia-answer-container' },
+                    disclaimerPosition === 'top' && disclaimer,
                     React.createElement(Answer, { text: currentAnswer, componentOverride: componentOverrides?.answer }),
                     currentItems && (React.createElement(PiaCustomCarousel, { items: currentItems, componentOverrides: componentOverrides?.carousel, callbacks: callbacks })),
                     showFeedback && (React.createElement(Feedback, { translations: translations, onFeedback: callbacks?.onFeedback, componentOverride: componentOverrides?.feedback })),
-                    React.createElement(Disclaimer, { learnMoreUrl: learnMoreUrl, translations: translations, componentOverride: componentOverrides?.disclaimer }))),
+                    disclaimerPosition === 'bottom' && disclaimer)),
                 React.createElement(SuggestedQuestionsContainer, { questions: displayedQuestions, onQuestionClick: handleSubmitQuestion, componentOverride: componentOverrides?.suggestedQuestions }))))));
 }

package/lib/mjs/components/ConversationHistory/ConversationHistory.js

@@ -5,7 +5,7 @@ import Disclaimer from '../CioPia/Disclaimer';
 import ErrorBlock from '../Error/ErrorBlock';
 import LoadingSkeleton from '../LoadingSkeleton/LoadingSkeleton';
 import PiaCustomCarousel from '../CioPia/PiaCustomCarousel';
-export default function ConversationHistory({ conversationHistory, isLoading, error, currentItems, showFeedback, showPreviousItems = true, learnMoreUrl, translations, callbacks, componentOverrides, }) {
+export default function ConversationHistory({ conversationHistory, isLoading, error, currentItems, showFeedback, showPreviousItems = true, learnMoreUrl, disclaimerPosition = 'bottom', translations, callbacks, componentOverrides, }) {
     const scrollContainerRef = useRef(null);
     useEffect(() => {
         const container = scrollContainerRef.current;
@@ -16,7 +16,9 @@ export default function ConversationHistory({ conversationHistory, isLoading, er
         });
         return () => cancelAnimationFrame(frameId);
     }, [conversationHistory, isLoading]);
+    const disclaimer = (React.createElement(Disclaimer, { learnMoreUrl: learnMoreUrl, translations: translations, componentOverride: componentOverrides?.disclaimer }));
     return (React.createElement("div", { className: 'cio-pia-conversation-history' },
+        disclaimerPosition === 'top' && disclaimer,
         React.createElement("div", { ref: scrollContainerRef, className: 'cio-pia-conversation-entries', role: 'log', "aria-label": 'Conversation history' }, conversationHistory.map((entry, index) => {
             const isLast = index === conversationHistory.length - 1;
             const previousEntryItems = showPreviousItems ? entry.items : null;
@@ -32,5 +34,5 @@ export default function ConversationHistory({ conversationHistory, isLoading, er
                     carouselItems && (React.createElement(PiaCustomCarousel, { items: carouselItems, componentOverrides: componentOverrides?.carousel, callbacks: callbacks })),
                     isLast && showFeedback && (React.createElement(Feedback, { translations: translations, onFeedback: callbacks?.onFeedback, componentOverride: componentOverrides?.feedback }))))));
         })),
-        React.createElement(Disclaimer, { learnMoreUrl: learnMoreUrl, translations: translations, componentOverride: componentOverrides?.disclaimer })));
+        disclaimerPosition === 'bottom' && disclaimer));
 }

package/lib/mjs/components/ConversationHistory/ConversationHistoryStyles.css

@@ -4,6 +4,7 @@
   flex-direction: column;
   flex: 1;
   min-height: 0;
+  gap: var(--conversation-gap);
 }
 
 .cio-pia-conversation-entries {

package/lib/mjs/components/PiaConversation/PiaConversation.js

@@ -4,11 +4,11 @@ import SuggestedQuestionsContainer from '../SuggestedQuestionsContainer/Suggeste
 import SuggestedQuestionsSkeleton from '../SuggestedQuestionsContainer/SuggestedQuestionsSkeleton';
 import { translate } from '../../utils/translate';
 import ConversationHistory from '../ConversationHistory/ConversationHistory';
-export default function PiaConversation({ conversationHistory, isLoading, error, currentItems, showFeedback, showPreviousItems, learnMoreUrl, translations, callbacks, componentOverrides, displayedQuestions, handleSubmitQuestion, }) {
+export default function PiaConversation({ conversationHistory, isLoading, error, currentItems, showFeedback, showPreviousItems, learnMoreUrl, disclaimerPosition, translations, callbacks, componentOverrides, displayedQuestions, handleSubmitQuestion, }) {
     const hasHistory = conversationHistory.length > 0;
     return (React.createElement("div", { className: 'cio-pia-container cio-pia-conversation', "data-testid": 'cio-pia-container' },
         !hasHistory && (React.createElement("p", { className: 'cio-pia-title', "data-testid": 'cio-pia-title' }, translate('Any questions about this product?', translations))),
-        React.createElement(ConversationHistory, { conversationHistory: conversationHistory, isLoading: isLoading, error: error, currentItems: currentItems, showFeedback: showFeedback, showPreviousItems: showPreviousItems, learnMoreUrl: learnMoreUrl, translations: translations, callbacks: callbacks, componentOverrides: componentOverrides }),
+        React.createElement(ConversationHistory, { conversationHistory: conversationHistory, isLoading: isLoading, error: error, currentItems: currentItems, showFeedback: showFeedback, showPreviousItems: showPreviousItems, learnMoreUrl: learnMoreUrl, disclaimerPosition: disclaimerPosition, translations: translations, callbacks: callbacks, componentOverrides: componentOverrides }),
         React.createElement("div", { className: 'cio-pia-conversation-footer' },
             isLoading && !error && React.createElement(SuggestedQuestionsSkeleton, null),
             !isLoading && !error && (React.createElement(SuggestedQuestionsContainer, { questions: displayedQuestions, onQuestionClick: handleSubmitQuestion, componentOverride: componentOverrides?.suggestedQuestions })),

package/lib/mjs/components/PiaConversation/PiaModal.js

@@ -58,8 +58,9 @@ export default function PiaModal({ initialQuestions, handleSubmitQuestion, isLoa
     }, [handleSubmitQuestion, openModal]);
     return (React.createElement("div", { className: 'cio-pia-container', "data-testid": 'cio-pia-container' },
         React.createElement("p", { className: 'cio-pia-title', "data-testid": 'cio-pia-title' }, translate('Any questions about this product?', translations)),
-        React.createElement(Input, { onSubmit: handleQuestion, disabled: isLoading || isOpen, translations: translations }),
-        initialQuestions.length > 0 && (React.createElement(SuggestedQuestionsContainer, { questions: initialQuestions, onQuestionClick: handleQuestion, componentOverride: componentOverrides?.suggestedQuestions })),
+        React.createElement("div", { className: 'cio-pia-conversation-footer' },
+            initialQuestions.length > 0 && (React.createElement(SuggestedQuestionsContainer, { questions: initialQuestions, onQuestionClick: handleQuestion, componentOverride: componentOverrides?.suggestedQuestions })),
+            React.createElement(Input, { onSubmit: handleQuestion, disabled: isLoading || isOpen, translations: translations })),
         React.createElement("dialog", { ref: dialogRef, className: 'cio-pia-modal', "aria-labelledby": 'cio-pia-modal-title' },
             React.createElement("div", { className: 'cio-pia-modal-content' },
                 React.createElement("div", { className: 'cio-pia-modal-header' },

package/lib/mjs/hooks/useConversation.js

@@ -1,5 +1,5 @@
 import { useCallback, useEffect, useRef, useState } from 'react';
-export default function useConversation({ pia, itemId, isConversation, }) {
+export default function useConversation({ pia, itemId, isConversation, callbacks, }) {
     const { suggestedQuestions, answers } = pia;
     const { getAnswer } = answers;
     const [currentQuestion, setCurrentQuestion] = useState('');
@@ -8,6 +8,7 @@ export default function useConversation({ pia, itemId, isConversation, }) {
     const entryIdRef = useRef(0);
     const prevAnswerValueRef = useRef(answers.data?.value);
     const handleSubmitQuestion = useCallback((question) => {
+        callbacks?.onQuestionSubmit?.(question);
         setCurrentQuestion(question);
         getAnswer(question);
         if (isConversation) {
@@ -15,7 +16,7 @@ export default function useConversation({ pia, itemId, isConversation, }) {
             const id = entryIdRef.current;
             setConversationHistory((prev) => [...prev, { id, question, answer: '' }]);
         }
-    }, [getAnswer, isConversation]);
+    }, [getAnswer, isConversation, callbacks]);
     const resetState = useCallback(() => {
         setCurrentQuestion('');
         setDisplayedQuestions(suggestedQuestions.data);

package/lib/mjs/version.js

@@ -1 +1 @@
-export default '2.2.0';
+export default '2.3.0';

package/lib/types/components/CioPia/CioPia.d.ts

@@ -10,6 +10,18 @@ export interface CioPiaProps extends IncludeRenderProps<CioPiaRenderProps>, Incl
     variationId?: string;
     cioClient?: MockConstructorIOClient;
     displayConfigs?: CioPiaDisplayConfigs;
+    /**
+     * Callback handlers for user interactions:
+     *
+     * `onQuestionSubmit: (question: string) => void`
+     * Called when a question is submitted (via Enter key, Send button, or suggested question click).
+     *
+     * `onProductCardClick: (item: Item) => void`
+     * Called when a product card in the carousel is clicked.
+     *
+     * `onFeedback: (type: 'up' | 'down') => void`
+     * Called when the user submits positive or negative feedback on an answer.
+     */
     callbacks?: Callbacks;
     /** Define formatter functions outside the component or memoize to avoid unnecessary re-renders. */
     formatters?: Formatters;

package/lib/types/components/ConversationHistory/ConversationHistory.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { ConversationEntry, Translations, Item, Callbacks, CioPiaComponentOverrides } from '../../types';
+import { ConversationEntry, Translations, Item, Callbacks, CioPiaComponentOverrides, DisclaimerPosition } from '../../types';
 export interface ConversationHistoryProps {
     conversationHistory: ConversationEntry[];
     isLoading: boolean;
@@ -18,8 +18,9 @@ export interface ConversationHistoryProps {
      */
     showPreviousItems?: boolean;
     learnMoreUrl?: string;
+    disclaimerPosition?: DisclaimerPosition;
     translations?: Translations;
     callbacks?: Callbacks;
     componentOverrides?: CioPiaComponentOverrides;
 }
-export default function ConversationHistory({ conversationHistory, isLoading, error, currentItems, showFeedback, showPreviousItems, learnMoreUrl, translations, callbacks, componentOverrides, }: ConversationHistoryProps): React.JSX.Element;
+export default function ConversationHistory({ conversationHistory, isLoading, error, currentItems, showFeedback, showPreviousItems, learnMoreUrl, disclaimerPosition, translations, callbacks, componentOverrides, }: ConversationHistoryProps): React.JSX.Element;

package/lib/types/components/PiaConversation/PiaConversation.d.ts

@@ -5,4 +5,4 @@ export interface PiaConversationProps extends ConversationHistoryProps {
     displayedQuestions: Question[];
     handleSubmitQuestion: (question: string) => void;
 }
-export default function PiaConversation({ conversationHistory, isLoading, error, currentItems, showFeedback, showPreviousItems, learnMoreUrl, translations, callbacks, componentOverrides, displayedQuestions, handleSubmitQuestion, }: PiaConversationProps): React.JSX.Element;
+export default function PiaConversation({ conversationHistory, isLoading, error, currentItems, showFeedback, showPreviousItems, learnMoreUrl, disclaimerPosition, translations, callbacks, componentOverrides, displayedQuestions, handleSubmitQuestion, }: PiaConversationProps): React.JSX.Element;

package/lib/types/hooks/useConversation.d.ts

@@ -1,9 +1,10 @@
-import { ConversationEntry, Question, Item } from '../types';
+import { Callbacks, ConversationEntry, Question, Item } from '../types';
 import { UseCioPiaReturn } from './useCioPia';
 export interface UseConversationProps {
     pia: UseCioPiaReturn;
     itemId: string;
     isConversation: boolean;
+    callbacks?: Callbacks;
 }
 export interface UseConversationReturn {
     currentQuestion: string;
@@ -16,4 +17,4 @@ export interface UseConversationReturn {
     handleSubmitQuestion: (question: string) => void;
     resetState: () => void;
 }
-export default function useConversation({ pia, itemId, isConversation, }: UseConversationProps): UseConversationReturn;
+export default function useConversation({ pia, itemId, isConversation, callbacks, }: UseConversationProps): UseConversationReturn;

package/lib/types/types.d.ts

@@ -27,6 +27,7 @@ export interface CioPiaProviderProps {
 }
 export type CioPiaMode = 'default' | 'conversation';
 export type CioPiaType = 'inline' | 'modal';
+export type DisclaimerPosition = 'top' | 'bottom';
 export type CioPiaDisplayConfigs = {
     learnMoreUrl?: string;
     showFeedback?: boolean;
@@ -37,6 +38,14 @@ export type CioPiaDisplayConfigs = {
      * The last entry always falls back to its own items when currentItems is not provided.
      */
     showPreviousItems?: boolean;
+    /**
+     * Position of the AI disclaimer message relative to the conversation content.
+     * - `'top'` — renders the disclaimer above the conversation history or answer.
+     * - `'bottom'` — renders the disclaimer below the conversation history or answer.
+     *
+     * @default 'bottom'
+     */
+    disclaimerPosition?: DisclaimerPosition;
 };
 /**
  * Translations type for internationalizing UI strings.
@@ -52,7 +61,11 @@ export type Translations = {
     'Ask about this product'?: string;
 };
 export interface Callbacks {
+    /** Called when a question is submitted (via Enter key, Send button, or suggested question click). */
+    onQuestionSubmit?: (question: string) => void;
+    /** Called when a product card in the carousel is clicked. */
     onProductCardClick?: (item: Item) => void;
+    /** Called when the user submits positive or negative feedback on an answer. */
     onFeedback?: (type: FeedbackType) => void;
 }
 /** Formatter functions for transforming data before display. */

package/lib/types/version.d.ts

@@ -1,2 +1,2 @@
-declare const _default: "2.2.0";
+declare const _default: "2.3.0";
 export default _default;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@constructor-io/constructorio-ui-pia",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "description": "Constructor.io AI Product Insights Agent UI library for web applications",
   "author": "Constructor.io Corporation",
   "license": "MIT",