@athoscommerce/snap-preact 1.11.0 → 1.12.1-beta.152

package/dist/cjs/components/src/components/Organisms/Chat/components/ChatTopicDrift.js

@@ -0,0 +1,149 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChatTopicDrift = void 0;
+const jsx_runtime_1 = require("@emotion/react/jsx-runtime");
+const react_1 = require("@emotion/react");
+const classnames_1 = __importDefault(require("classnames"));
+const deepmerge_1 = __importDefault(require("deepmerge"));
+const mobx_react_lite_1 = require("mobx-react-lite");
+const providers_1 = require("../../../../providers");
+const utilities_1 = require("../../../../utilities");
+const hooks_1 = require("../../../../hooks");
+const useA11y_1 = require("../../../../hooks/useA11y");
+const Button_1 = require("../../../Atoms/Button");
+const Icon_1 = require("../../../Atoms/Icon");
+const Chat_lang_1 = require("../Chat.lang");
+const defaultStyles = ({ primaryColorBg, primaryColorFg }) => {
+    const colorPrimary = primaryColorBg;
+    const colorPrimaryText = primaryColorFg;
+    return (0, react_1.css)({
+        display: 'flex',
+        alignItems: 'center',
+        gap: '12px',
+        padding: '12px 16px',
+        border: `1px solid ${new utilities_1.Colour(colorPrimary).mixWhite(0.6)}`,
+        borderRadius: '8px',
+        backgroundColor: '#fff',
+        '.ss__chat__topic-drift__icon--info': {
+            flex: '0 0 auto',
+            fill: colorPrimary,
+            stroke: colorPrimary,
+            svg: {
+                fill: colorPrimary,
+                stroke: colorPrimary,
+            },
+        },
+        '.ss__chat__topic-drift__text': {
+            flex: '1 1 0%',
+            display: 'flex',
+            flexDirection: 'column',
+            gap: '2px',
+            'span:first-of-type': {
+                fontWeight: 'bold',
+                color: colorPrimary,
+                fontSize: '14px',
+            },
+            'span:last-of-type': {
+                color: '#6A7282',
+                fontSize: '13px',
+            },
+        },
+        '.ss__chat__topic-drift__button': {
+            flex: '0 0 auto',
+            backgroundColor: colorPrimary,
+            color: colorPrimaryText,
+            borderRadius: '6px',
+            padding: '8px 14px',
+            fontSize: '13px',
+            fontWeight: 500,
+            cursor: 'pointer',
+            whiteSpace: 'nowrap',
+            '&:not(.ss__button--disabled):hover': {
+                background: new utilities_1.Colour(colorPrimary).mixBlack(),
+            },
+        },
+        '.ss__chat__topic-drift__icon--close': {
+            flex: '0 0 auto',
+            cursor: 'pointer',
+            fill: '#6A7282',
+            stroke: '#6A7282',
+            svg: {
+                fill: '#6A7282',
+                stroke: '#6A7282',
+            },
+        },
+    });
+};
+exports.ChatTopicDrift = (0, mobx_react_lite_1.observer)((properties) => {
+    const globalTheme = (0, providers_1.useTheme)();
+    const globalTreePath = (0, providers_1.useTreePath)();
+    const defaultProps = {
+        variant: 'drift',
+        treePath: globalTreePath,
+    };
+    const props = (0, utilities_1.mergeProps)('chatTopicDrift', globalTheme, defaultProps, properties);
+    const { className, internalClassName, controller, variant } = props;
+    const { store } = controller;
+    const lang = (0, deepmerge_1.default)(Chat_lang_1.chatDefaultLang, props.lang || {});
+    const mergedLang = (0, hooks_1.useLang)({
+        highVolumeMessage: lang.highVolumeMessage,
+        highVolumeSubMessage: lang.highVolumeSubMessage,
+        newSessionButton: lang.newSessionButton,
+        topicDriftScopeMessage: lang.topicDriftScopeMessage,
+        topicDriftScopeSubMessage: lang.topicDriftScopeSubMessage,
+        topicDriftMessage: lang.topicDriftMessage,
+        topicDriftSubMessage: lang.topicDriftSubMessage,
+    }, { controller }, { activeBreakpoint: globalTheme?.activeBreakpoint });
+    const styling = (0, utilities_1.mergeStyles)(props, defaultStyles);
+    if (variant === 'sessionLimit') {
+        if (!store.currentChat?.sessionLimitReached)
+            return null;
+        return ((0, jsx_runtime_1.jsx)(providers_1.CacheProvider, { children: (0, jsx_runtime_1.jsxs)("div", { ...styling, className: (0, classnames_1.default)('ss__chat__topic-drift', className, internalClassName), children: [(0, jsx_runtime_1.jsx)(Icon_1.Icon, { icon: "info", size: "18px", className: 'ss__chat__topic-drift__icon--info' }), (0, jsx_runtime_1.jsxs)("div", { className: 'ss__chat__topic-drift__text', children: [(0, jsx_runtime_1.jsx)("span", { ...mergedLang.highVolumeMessage?.all }), (0, jsx_runtime_1.jsx)("span", { ...mergedLang.highVolumeSubMessage?.all })] }), (0, jsx_runtime_1.jsx)(Button_1.Button, { className: 'ss__chat__topic-drift__button', onClick: () => {
+                            controller.store.createChat();
+                        }, children: (0, jsx_runtime_1.jsx)("span", { ...mergedLang.newSessionButton?.all }) })] }) }));
+    }
+    const drift = store.currentChat?.topicDrift;
+    if (!drift)
+        return null;
+    // recommendedAction is the prescription; driftType is the diagnosis.
+    // Hide the banner when the backend says to keep flowing, or when no drift was detected.
+    if (drift.recommendedAction === 'CONTINUE' || drift.driftType === 'NO_DRIFT')
+        return null;
+    const isScopeRedirect = drift.recommendedAction === 'SCOPE_REDIRECT';
+    return ((0, jsx_runtime_1.jsx)(providers_1.CacheProvider, { children: (0, jsx_runtime_1.jsxs)("div", { ...styling, className: (0, classnames_1.default)('ss__chat__topic-drift', className, internalClassName), children: [(0, jsx_runtime_1.jsx)(Icon_1.Icon, { icon: "info", size: "18px", className: 'ss__chat__topic-drift__icon--info' }), (0, jsx_runtime_1.jsxs)("div", { className: 'ss__chat__topic-drift__text', children: [(0, jsx_runtime_1.jsx)("span", { ...(isScopeRedirect ? mergedLang.topicDriftScopeMessage?.all : mergedLang.topicDriftMessage?.all) }), (0, jsx_runtime_1.jsx)("span", { ...(isScopeRedirect ? mergedLang.topicDriftScopeSubMessage?.all : mergedLang.topicDriftSubMessage?.all) })] }), !isScopeRedirect && ((0, jsx_runtime_1.jsx)(Button_1.Button, { className: 'ss__chat__topic-drift__button', onClick: () => {
+                        // Capture image attachments from the current chat before handleTopicDrift /
+                        // createChat tear down the conversation — an imageSearch that drifted needs
+                        // the same image attached to the carried-over message in the new session,
+                        // otherwise params would fall back to a `general` request without the image.
+                        const previousImageAttachments = (store.currentChat?.attachments.attached || [])
+                            .filter((item) => item.type === 'image' && item.state !== 'error')
+                            .map((item) => {
+                            const img = item;
+                            return {
+                                type: 'image',
+                                base64: img.base64,
+                                fileName: img.fileName,
+                                imageId: img.imageId,
+                                imageUrl: img.imageUrl,
+                                thumbnailUrl: img.thumbnailUrl,
+                                // Already uploaded — skip the 'loading' default state.
+                                state: 'attached',
+                            };
+                        });
+                        const messageText = store.currentChat?.handleTopicDrift();
+                        if (messageText) {
+                            controller.store.createChat();
+                            previousImageAttachments.forEach((cfg) => {
+                                controller.store.currentChat?.attachments.add(cfg);
+                            });
+                            // partial override — the params getter decides the requestType (e.g. imageSearch
+                            // when an image is re-attached), so only the message is overridden here
+                            controller.search({ data: { message: messageText } });
+                        }
+                    }, children: (0, jsx_runtime_1.jsx)("span", { ...mergedLang.newSessionButton?.all }) })), (0, jsx_runtime_1.jsx)("span", { role: "button", ref: (e) => (0, useA11y_1.useA11y)(e), "aria-label": (0, Chat_lang_1.langAttrOf)(lang.topicDriftDismissButton, 'aria-label'), onClick: () => {
+                        store.currentChat?.dismissTopicDrift();
+                    }, children: (0, jsx_runtime_1.jsx)(Icon_1.Icon, { icon: "close-thin", size: "14px", className: 'ss__chat__topic-drift__icon--close' }) })] }) }));
+});

package/dist/cjs/components/src/components/Organisms/Chat/components/chatAccentTheme.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.chatAccentThemeComponents = void 0;
+const utilities_1 = require("../../../../utilities");
+/**
+ * Accent styling for buttons living inside child components (ChatResult's cart /
+ * inquire icons and ChatProductQueryMessage's action buttons) — injected through
+ * the theme so each child applies it via its own style pipeline instead of the
+ * organism reaching in with `!important` overrides.
+ */
+const chatAccentThemeComponents = ({ primaryAccentColorBg, primaryAccentColorFg, secondaryAccentColorBg, secondaryAccentColorFg, }) => {
+    return {
+        chatResult: {
+            style: {
+                '.ss__chat-result__image__icons': {
+                    '.ss__button.ss__chat-result__image__icons__icon--cart': {
+                        backgroundColor: primaryAccentColorBg,
+                        svg: {
+                            fill: primaryAccentColorFg,
+                            stroke: primaryAccentColorFg,
+                        },
+                    },
+                    '.ss__button.ss__chat-result__image__icons__icon--inquire': {
+                        backgroundColor: secondaryAccentColorBg,
+                        svg: {
+                            fill: secondaryAccentColorFg,
+                            stroke: secondaryAccentColorFg,
+                        },
+                    },
+                },
+            },
+        },
+        chatProductQueryMessage: {
+            style: {
+                '.ss__chat-product-query-message__header__product__actions': {
+                    '.ss__chat-product-query-message__header__product__actions__add-to-cart .ss__button': {
+                        background: primaryAccentColorBg,
+                        color: primaryAccentColorFg,
+                        svg: {
+                            fill: primaryAccentColorFg,
+                            stroke: primaryAccentColorFg,
+                        },
+                        '&:not(.ss__button--disabled):hover': {
+                            background: new utilities_1.Colour(primaryAccentColorBg).mixBlack(),
+                        },
+                    },
+                    '.ss__chat-product-query-message__header__product__actions__show-similar .ss__button, .ss__chat-product-query-message__header__product__actions__discuss-product .ss__button': {
+                        background: secondaryAccentColorBg,
+                        color: secondaryAccentColorFg,
+                        border: `1px solid ${secondaryAccentColorFg}`,
+                        '&:not(.ss__button--disabled):hover': {
+                            background: new utilities_1.Colour(secondaryAccentColorBg).mixBlack(),
+                        },
+                    },
+                },
+            },
+        },
+    };
+};
+exports.chatAccentThemeComponents = chatAccentThemeComponents;

package/dist/cjs/components/src/components/Organisms/Chat/hooks/useChatFileUpload.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useChatFileUpload = void 0;
+const hooks_1 = require("preact/hooks");
+const hasFiles = (e) => Array.from(e.dataTransfer?.types || []).includes('Files');
+/**
+ * Wires drag-and-drop image upload onto the chat footer plus a ref for the
+ * hidden file input. `dragenter` / `dragleave` fire on every child crossing,
+ * so a counter is kept to know when the pointer has truly left the footer.
+ */
+const useChatFileUpload = ({ enabled, onUpload }) => {
+    const fileInputRef = (0, hooks_1.useRef)(null);
+    const [isDraggingFile, setIsDraggingFile] = (0, hooks_1.useState)(false);
+    const dragCounterRef = (0, hooks_1.useRef)(0);
+    // Reset drag state when uploads become disabled mid-drag (e.g. loading starts)
+    // so the drop overlay cannot get stuck on screen.
+    (0, hooks_1.useEffect)(() => {
+        if (!enabled) {
+            dragCounterRef.current = 0;
+            setIsDraggingFile(false);
+        }
+    }, [enabled]);
+    const onDragEnter = (e) => {
+        if (!enabled || !hasFiles(e))
+            return;
+        e.preventDefault();
+        dragCounterRef.current += 1;
+        setIsDraggingFile(true);
+    };
+    const onDragOver = (e) => {
+        if (!enabled || !hasFiles(e))
+            return;
+        // Required to allow the drop event to fire
+        e.preventDefault();
+        if (e.dataTransfer)
+            e.dataTransfer.dropEffect = 'copy';
+    };
+    const onDragLeave = (e) => {
+        if (!enabled || !hasFiles(e))
+            return;
+        dragCounterRef.current = Math.max(0, dragCounterRef.current - 1);
+        if (dragCounterRef.current === 0)
+            setIsDraggingFile(false);
+    };
+    const onDrop = async (e) => {
+        if (!enabled || !hasFiles(e))
+            return;
+        e.preventDefault();
+        dragCounterRef.current = 0;
+        setIsDraggingFile(false);
+        const dropped = Array.from(e.dataTransfer?.files || []);
+        const firstImage = dropped.find((f) => f.type.startsWith('image/'));
+        if (!firstImage)
+            return;
+        // Reconstruct a FileList — consumers (e.g. controller.upload) expect FileList | null
+        const dt = new DataTransfer();
+        dt.items.add(firstImage);
+        await onUpload(dt.files);
+    };
+    return {
+        fileInputRef,
+        isDraggingFile,
+        dragHandlers: { onDragEnter, onDragOver, onDragLeave, onDrop },
+    };
+};
+exports.useChatFileUpload = useChatFileUpload;

package/dist/cjs/components/src/components/Organisms/Chat/hooks/useChatGestures.js

@@ -0,0 +1,96 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useChatGestures = void 0;
+const hooks_1 = require("preact/hooks");
+/**
+ * Drag-down-to-dismiss gesture for the mobile secondary chat panel.
+ *
+ * Tracks vertical touch movement and applies a translateY offset until the user releases.
+ * If the user passes a distance or velocity threshold the panel animates the rest of the way
+ * out and `onDismiss` fires; otherwise it snaps back to zero.
+ */
+const useChatGestures = ({ panelRef, shouldShowSideChat, activeMessageId, onDismiss }) => {
+    const swipeStartY = (0, hooks_1.useRef)(0);
+    const swipeStartTime = (0, hooks_1.useRef)(0);
+    const swipeActive = (0, hooks_1.useRef)(false);
+    const swipeOffsetRef = (0, hooks_1.useRef)(0);
+    const animationTimerRef = (0, hooks_1.useRef)(null);
+    const [swipeOffset, setSwipeOffsetRaw] = (0, hooks_1.useState)(0);
+    const [swipeAnimating, setSwipeAnimating] = (0, hooks_1.useState)(false);
+    const updateSwipeOffset = (value) => {
+        swipeOffsetRef.current = value;
+        setSwipeOffsetRaw(value);
+    };
+    // Reset swipe state when secondary panel opens/closes or active message changes
+    (0, hooks_1.useEffect)(() => {
+        updateSwipeOffset(0);
+        setSwipeAnimating(false);
+        swipeActive.current = false;
+    }, [shouldShowSideChat, activeMessageId]);
+    const onTouchStart = (e) => {
+        swipeStartY.current = e.touches[0].clientY;
+        swipeStartTime.current = Date.now();
+        swipeActive.current = false; // only activate after dead-zone threshold
+        setSwipeAnimating(false);
+    };
+    const onTouchMove = (e) => {
+        const diff = e.touches[0].clientY - swipeStartY.current;
+        // Require a minimum drag distance before activating the swipe,
+        // so taps on buttons (e.g. close) still fire their click events.
+        if (!swipeActive.current) {
+            if (Math.abs(diff) < 8)
+                return; // still within dead-zone
+            swipeActive.current = true;
+        }
+        if (diff > 0) {
+            e.preventDefault();
+            updateSwipeOffset(diff);
+        }
+        else {
+            updateSwipeOffset(0);
+        }
+    };
+    const onTouchEnd = () => {
+        if (!swipeActive.current)
+            return;
+        swipeActive.current = false;
+        const offset = swipeOffsetRef.current;
+        const height = panelRef.current?.offsetHeight || 400;
+        const elapsed = Date.now() - swipeStartTime.current;
+        const velocity = offset / (elapsed || 1); // px per ms
+        // Dismiss if dragged past 25% threshold OR a quick flick (>0.5 px/ms with >50px travel)
+        const shouldDismiss = offset > height * 0.25 || (velocity > 0.5 && offset > 50);
+        if (shouldDismiss) {
+            // Animate out then dismiss
+            setSwipeAnimating(true);
+            updateSwipeOffset(height);
+            if (animationTimerRef.current)
+                clearTimeout(animationTimerRef.current);
+            animationTimerRef.current = setTimeout(() => {
+                onDismiss();
+                updateSwipeOffset(0);
+                setSwipeAnimating(false);
+            }, 300);
+        }
+        else {
+            // Snap back
+            setSwipeAnimating(true);
+            updateSwipeOffset(0);
+            if (animationTimerRef.current)
+                clearTimeout(animationTimerRef.current);
+            animationTimerRef.current = setTimeout(() => setSwipeAnimating(false), 300);
+        }
+    };
+    (0, hooks_1.useEffect)(() => {
+        return () => {
+            if (animationTimerRef.current)
+                clearTimeout(animationTimerRef.current);
+        };
+    }, []);
+    return {
+        swipeOffset,
+        swipeAnimating,
+        swipeHandlers: { onTouchStart, onTouchMove, onTouchEnd },
+    };
+};
+exports.useChatGestures = useChatGestures;

package/dist/cjs/components/src/components/Organisms/Chat/hooks/useChatOverflow.js

@@ -0,0 +1,113 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useChatOverflow = void 0;
+const hooks_1 = require("preact/hooks");
+/**
+ * Manages the auto-scroll, "new message" indicator, and overflow detection for the
+ * chat message list. Owns all scroll listeners and ResizeObservers so the host
+ * component just consumes the derived state.
+ */
+const useChatOverflow = ({ messagesContainerRef, headerRef, open, loading, visibleChatLength, lastVisibleMessage, }) => {
+    const [showNewMessages, setShowNewMessages] = (0, hooks_1.useState)(false);
+    const [messagesOverflow, setMessagesOverflow] = (0, hooks_1.useState)(false);
+    const isNearBottomRef = (0, hooks_1.useRef)(true);
+    const scrollToBottom = () => {
+        // Scroll the messages container directly (instead of scrollIntoView on the
+        // bottom anchor) so the browser never walks up the ancestor chain. On small
+        // viewports a smooth scrollIntoView could otherwise animate the document /
+        // visual viewport and visually push the fixed-position chat off-screen.
+        const container = messagesContainerRef.current;
+        if (container) {
+            container.scrollTo({ top: container.scrollHeight, behavior: 'smooth' });
+        }
+    };
+    // Conditional scroll: only scrolls if the user is already near the bottom.
+    const scrollToBottomIfNear = () => {
+        if (isNearBottomRef.current) {
+            scrollToBottom();
+        }
+    };
+    // Scroll to bottom when chat opens
+    (0, hooks_1.useEffect)(() => {
+        if (open) {
+            scrollToBottom();
+            setShowNewMessages(false);
+            isNearBottomRef.current = true;
+        }
+    }, [open]);
+    // Handle new messages — auto-scroll for user messages, show popup for response messages when scrolled up
+    (0, hooks_1.useEffect)(() => {
+        if (!open || !lastVisibleMessage)
+            return;
+        if (lastVisibleMessage.messageType === 'user') {
+            scrollToBottom();
+            setShowNewMessages(false);
+        }
+        else if (isNearBottomRef.current) {
+            scrollToBottom();
+            setShowNewMessages(false);
+        }
+        else {
+            setShowNewMessages(true);
+        }
+    }, [visibleChatLength]);
+    // Scroll to show loading indicator when user sends a message
+    (0, hooks_1.useEffect)(() => {
+        if (open && loading) {
+            scrollToBottom();
+        }
+    }, [loading]);
+    // Track scroll position to dismiss the "New messages" popup when user scrolls to bottom
+    (0, hooks_1.useEffect)(() => {
+        const container = messagesContainerRef.current;
+        if (!container)
+            return;
+        const handleScroll = () => {
+            const threshold = 100;
+            const isNearBottom = container.scrollHeight - container.scrollTop - container.clientHeight < threshold;
+            isNearBottomRef.current = isNearBottom;
+            if (isNearBottom) {
+                setShowNewMessages(false);
+            }
+        };
+        container.addEventListener('scroll', handleScroll);
+        return () => container.removeEventListener('scroll', handleScroll);
+    }, [open]);
+    // Track whether the messages container is overflowing so the comparisons header
+    // can switch between in-flow (short conversations — top content stays reachable)
+    // and overlay (overflowing — avoid layout shift when toggling the tray).
+    // Hysteresis: when already in overlay, only return to in-flow if the content
+    // would still fit *with* the header re-inserted — otherwise the two states
+    // fight each other and the layout flickers.
+    (0, hooks_1.useEffect)(() => {
+        const container = messagesContainerRef.current;
+        if (!container || typeof ResizeObserver === 'undefined')
+            return;
+        const update = () => {
+            setMessagesOverflow((prev) => {
+                const headerHeight = headerRef.current?.offsetHeight || 0;
+                if (prev) {
+                    // Currently overlay: header isn't taking flow space. Only switch
+                    // back to in-flow if the content would fit with the header added.
+                    return container.scrollHeight > container.clientHeight - headerHeight + 1;
+                }
+                // Currently in-flow: header already takes space — straightforward check.
+                return container.scrollHeight > container.clientHeight + 1;
+            });
+        };
+        update();
+        const observer = new ResizeObserver(update);
+        observer.observe(container);
+        if (headerRef.current)
+            observer.observe(headerRef.current);
+        return () => observer.disconnect();
+    }, [open, visibleChatLength]);
+    return {
+        showNewMessages,
+        setShowNewMessages,
+        messagesOverflow,
+        scrollToBottom,
+        scrollToBottomIfNear,
+    };
+};
+exports.useChatOverflow = useChatOverflow;

package/dist/cjs/components/src/components/Organisms/Chat/hooks/useChatScrollLock.js

@@ -0,0 +1,135 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useChatScrollLock = void 0;
+const hooks_1 = require("preact/hooks");
+/**
+ * Prevents the background page from scrolling while the chat is open.
+ *
+ * Locks body overflow for wheel/keyboard scrolling, and installs a `touchmove`
+ * handler for touch devices. iOS Safari (real iPad/iPhone) rubber-band-scrolls
+ * the body when a touchmove inside `.ss__chat__messages` reaches the top/bottom —
+ * and `overscroll-behavior: contain` is ignored there.
+ *
+ * We don't reposition the body (locking via `position: fixed` on `<body>` leaves
+ * iPad Safari in a stuck viewport state where the page can't scroll after the
+ * lock is released). Instead the `touchmove` handler:
+ *   - allows the touchmove if it's inside a scrollable region of the chat
+ *     and that region isn't at its scroll edge in the swipe direction;
+ *   - calls `preventDefault()` otherwise — which is what blocks both
+ *     background scrolling and iOS rubber-band overscroll.
+ * Cleanup just removes the listeners, so nothing can leak into the page.
+ */
+const useChatScrollLock = ({ open, chatRef }) => {
+    // Lock body scroll while chat is open so touch/wheel scrolls don't leak to the page behind
+    (0, hooks_1.useEffect)(() => {
+        if (!open)
+            return;
+        const body = document.body;
+        const previousOverflow = body.style.overflow;
+        const previousOverscroll = body.style.overscrollBehavior;
+        body.style.overflow = 'hidden';
+        body.style.overscrollBehavior = 'contain';
+        return () => {
+            body.style.overflow = previousOverflow;
+            body.style.overscrollBehavior = previousOverscroll;
+        };
+    }, [open]);
+    (0, hooks_1.useEffect)(() => {
+        if (!open)
+            return;
+        if (typeof document === 'undefined')
+            return;
+        let startX = 0;
+        let startY = 0;
+        let scrollEl = null;
+        // Walk up from the touch target to find the first ancestor inside the chat
+        // that is actually scrollable in either axis. Stop at the chat root so we
+        // never consider elements outside the chat.
+        const findScrollableInChat = (start) => {
+            const chatRoot = chatRef.current;
+            if (!chatRoot)
+                return null;
+            let el = start;
+            while (el && chatRoot.contains(el)) {
+                const style = getComputedStyle(el);
+                const scrollableY = (style.overflowY === 'auto' || style.overflowY === 'scroll') && el.scrollHeight > el.clientHeight;
+                const scrollableX = (style.overflowX === 'auto' || style.overflowX === 'scroll') && el.scrollWidth > el.clientWidth;
+                if (scrollableY || scrollableX) {
+                    return el;
+                }
+                if (el === chatRoot)
+                    break;
+                el = el.parentElement;
+            }
+            return null;
+        };
+        const onTouchStart = (e) => {
+            if (!e.touches[0])
+                return;
+            startX = e.touches[0].clientX;
+            startY = e.touches[0].clientY;
+            scrollEl = findScrollableInChat(e.target);
+        };
+        const onTouchMove = (e) => {
+            const target = e.target;
+            const chatRoot = chatRef.current;
+            const inChat = !!(chatRoot && target && chatRoot.contains(target));
+            // Touches outside the chat shouldn't scroll the background.
+            if (!inChat) {
+                if (e.cancelable)
+                    e.preventDefault();
+                return;
+            }
+            // Inside the chat but no scrollable container — block to prevent body scroll.
+            if (!scrollEl) {
+                if (e.cancelable)
+                    e.preventDefault();
+                return;
+            }
+            // Inside a scrollable container — only block when at the edge in the
+            // swipe direction, so internal scrolling continues to work. Detect the
+            // dominant axis so horizontally-scrollable rows (e.g. the facets row)
+            // also get to handle their own touch gestures.
+            const currentX = e.touches[0]?.clientX ?? startX;
+            const currentY = e.touches[0]?.clientY ?? startY;
+            const deltaX = currentX - startX;
+            const deltaY = currentY - startY;
+            const horizontal = Math.abs(deltaX) > Math.abs(deltaY);
+            if (horizontal) {
+                const scrollsX = scrollEl.scrollWidth > scrollEl.clientWidth;
+                if (!scrollsX) {
+                    if (e.cancelable)
+                        e.preventDefault();
+                    return;
+                }
+                const atLeft = scrollEl.scrollLeft <= 0;
+                const atRight = scrollEl.scrollLeft + scrollEl.clientWidth >= scrollEl.scrollWidth - 1;
+                if ((atLeft && deltaX > 0) || (atRight && deltaX < 0)) {
+                    if (e.cancelable)
+                        e.preventDefault();
+                }
+            }
+            else {
+                const scrollsY = scrollEl.scrollHeight > scrollEl.clientHeight;
+                if (!scrollsY) {
+                    if (e.cancelable)
+                        e.preventDefault();
+                    return;
+                }
+                const atTop = scrollEl.scrollTop <= 0;
+                const atBottom = scrollEl.scrollTop + scrollEl.clientHeight >= scrollEl.scrollHeight - 1;
+                if ((atTop && deltaY > 0) || (atBottom && deltaY < 0)) {
+                    if (e.cancelable)
+                        e.preventDefault();
+                }
+            }
+        };
+        document.addEventListener('touchstart', onTouchStart, { passive: true });
+        document.addEventListener('touchmove', onTouchMove, { passive: false });
+        return () => {
+            document.removeEventListener('touchstart', onTouchStart);
+            document.removeEventListener('touchmove', onTouchMove);
+        };
+    }, [open]);
+};
+exports.useChatScrollLock = useChatScrollLock;

package/dist/cjs/components/src/components/Organisms/Chat/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./Chat"), exports);
+__exportStar(require("./Chat.lang"), exports);