@financial-times/qanda-ui 0.0.1-beta.2 → 0.0.1-beta.21

package/dist/esm/components/Calendar/Apps.js

@@ -0,0 +1,46 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "preact/jsx-runtime";
+function formatDateForIcs(date) {
+    return date.replace(/-|:|\.\d+/g, '');
+}
+function createIcsFile(title, startDateTime, endDateTime, url) {
+    const icsContent = `
+  BEGIN:VCALENDAR\nVERSION:2.0\nBEGIN:VEVENT\nSUMMARY:${title}\nDESCRIPTION:${description(url)}\nDTSTART:${formatDateForIcs(startDateTime)}\nDTEND:${formatDateForIcs(endDateTime)}\nLOCATION:${url}\nEND:VEVENT\nEND:VCALENDAR
+  `.trim();
+    return URL.createObjectURL(new Blob([icsContent], { type: 'title/calendar' }));
+}
+const CalendarLink = ({ href, children, }) => (_jsx("a", { href: href, target: "_blank", rel: "noopener noreferrer", role: "menuitem", "data-trackable": "liveqa_calendar-link", className: "live-qa-calendar-list__item__link", children: children }));
+function itemChildren(name, icon) {
+    return (_jsxs(_Fragment, { children: [_jsx("span", { className: "live-qa-calendar-list__item__icon", children: icon }), _jsx("span", { className: "live-qa-calendar-list__item__text", children: name })] }));
+}
+const description = (url) => `To join the Q&A session, visit: ${url}`;
+const apps = [
+    {
+        name: 'Gmail',
+        icon: (_jsx("svg", { className: "live-qa-calendar-icon", xmlns: "http://www.w3.org/2000/svg", width: "24", height: "25", viewBox: "0 0 24 25", fill: "none", children: _jsxs("g", { transform: "translate(4, 3.36)", children: [_jsx("path", { "fill-rule": "evenodd", "clip-rule": "evenodd", d: "M15.8514 7.64502H8.16309V10.8162H12.5564C12.3672 11.841 11.792 12.7093 10.9275 13.2906V15.3476H13.5657C15.1093 13.9204 15.9998 11.8187 15.9998 9.32193C15.9998 8.7406 15.9479 8.18163 15.8514 7.64502Z", fill: "black" }), _jsx("path", { "fill-rule": "evenodd", "clip-rule": "evenodd", d: "M8.16315 17.3339C10.3672 17.3339 12.2151 16.5998 13.5658 15.3477L10.9275 13.2907C10.1966 13.7826 9.26149 14.0733 8.16315 14.0733C6.037 14.0733 4.23737 12.6311 3.59544 10.6934H0.868164V12.8174C2.21139 15.4968 4.97206 17.3339 8.16315 17.3339Z", fill: "black" }), _jsx("path", { "fill-rule": "evenodd", "clip-rule": "evenodd", d: "M3.59555 10.6933C3.43228 10.2014 3.33952 9.67595 3.33952 9.13561C3.33952 8.59527 3.43228 8.06984 3.59555 7.57795V5.45386H0.868275C0.315399 6.56062 0 7.81272 0 9.13561C0 10.4585 0.315399 11.7106 0.868275 12.8174L3.59555 10.6933Z", fill: "black" }), _jsx("path", { "fill-rule": "evenodd", "clip-rule": "evenodd", d: "M8.16316 4.19816C9.36167 4.19816 10.4377 4.6118 11.2837 5.42417L13.6251 3.07277C12.2114 1.74987 10.3635 0.9375 8.16316 0.9375C4.97206 0.9375 2.21139 2.77465 0.868164 5.45399L3.59544 7.57808C4.23737 5.64031 6.037 4.19816 8.16316 4.19816Z", fill: "black" })] }) })),
+        getLink: ({ title, startDateTime, endDateTime, url }) => `https://www.google.com/calendar/render?action=TEMPLATE&text=${encodeURIComponent(title)}&dates=${startDateTime}/${endDateTime}&details=${encodeURIComponent(description(url))}&location=${encodeURIComponent(url)}`,
+    },
+    {
+        name: 'Outlook',
+        icon: (_jsx("svg", { className: "live-qa-calendar-icon", xmlns: "http://www.w3.org/2000/svg", width: "24", height: "25", viewBox: "0 0 24 25", fill: "none", children: _jsx("path", { d: "M21.9979 8.49306V17.3819C22.0068 17.5304 21.987 17.6792 21.9399 17.8185C21.8927 17.9578 21.8194 18.0842 21.7247 18.1894C21.63 18.2946 21.5162 18.3761 21.3909 18.4285C21.2656 18.4809 21.1316 18.5029 20.9981 18.4931H13.9988V22.9375L2 20.9375V4.9375L13.9988 2.9375V7.38194H20.9981C21.1316 7.37212 21.2656 7.39413 21.3909 7.4465C21.5162 7.49886 21.63 7.58037 21.7247 7.68558C21.8194 7.79078 21.8927 7.91724 21.9399 8.0565C21.987 8.19576 22.0068 8.3446 21.9979 8.49306ZM20.9981 8.60417L16.9985 11.1597L13.9988 9.27083V11.0486L16.9985 12.9375L20.9981 10.3819V8.60417ZM7.91939 8.60417C5.81961 8.52639 4.78971 10.5819 4.78971 13.0486C4.78971 15.5153 5.8596 17.4931 7.91939 17.4931C9.7892 17.4931 10.9991 15.6153 10.9991 13.1708C10.9991 10.7264 10.1292 8.72639 7.91939 8.6375M7.60943 10.3819C8.44934 10.3819 9.19926 11.2042 9.19926 12.8819C9.19926 14.5597 8.44934 15.5042 7.60943 15.5042C6.76951 15.5042 6.09958 14.2708 6.09958 12.9375C6.09958 11.6042 6.77951 10.3819 7.60943 10.3819Z", fill: "black" }) })),
+        getLink: ({ title, startDateTime, endDateTime, url }) => `https://outlook.live.com/calendar/0/deeplink/compose?subject=${encodeURIComponent(title)}&startdt=${startDateTime}&enddt=${endDateTime}&body=${encodeURIComponent(description(url))}&location=${encodeURIComponent(url)}`,
+    },
+    {
+        name: 'Apple',
+        icon: (_jsx("svg", { className: "live-qa-calendar-icon", xmlns: "http://www.w3.org/2000/svg", width: "24", height: "25", viewBox: "0 0 24 25", fill: "none", children: _jsx("path", { d: "M19.8023 9.75502C19.6851 9.84618 17.5884 11.002 17.5884 13.5675C17.5884 16.5367 20.2548 17.5851 20.3362 17.6111C20.3232 17.6762 19.9097 19.0501 18.9297 20.4501C18.0507 21.684 17.1358 22.9115 15.7424 22.9115C14.3522 22.9115 13.994 22.1236 12.3857 22.1236C10.8197 22.1236 10.263 22.9375 8.98671 22.9375C7.71371 22.9375 6.8249 21.798 5.80259 20.398C4.62076 18.7539 3.66357 16.1981 3.66357 13.7759C3.66357 9.88525 6.25189 7.82436 8.80113 7.82436C10.1523 7.82436 11.282 8.69365 12.1317 8.69365C12.9392 8.69365 14.2024 7.77227 15.7424 7.77227C16.3251 7.77227 18.4218 7.82436 19.8023 9.75502ZM15.0098 6.12487C15.6479 5.38907 16.0972 4.36351 16.0972 3.33796C16.0972 3.19796 16.0842 3.05471 16.0582 2.9375C15.0228 2.97657 13.7889 3.61144 13.0466 4.45467C12.4638 5.10257 11.9169 6.12487 11.9169 7.16345C11.9169 7.31972 11.9462 7.476 11.9559 7.52483C12.0243 7.53786 12.1285 7.55088 12.2359 7.55088C13.1671 7.55088 14.3359 6.94531 15.0098 6.12487Z", fill: "black" }) })),
+        getLink: ({ title, startDateTime, endDateTime, url }) => createIcsFile(title, startDateTime, endDateTime, url),
+        isDownload: true,
+    },
+    {
+        name: 'Yahoo',
+        icon: (_jsx("svg", { className: "live-qa-calendar-icon", xmlns: "http://www.w3.org/2000/svg", width: "24", height: "25", viewBox: "0 0 24 25", fill: "none", children: _jsx("path", { d: "M15.3929 13.7528C15.3614 13.7513 15.3247 13.7506 15.2879 13.7506C13.8674 13.7506 12.7109 14.8793 12.6659 16.2886V16.2931C12.7049 17.6536 13.8172 18.7411 15.1837 18.7411C15.2182 18.7411 15.2519 18.7403 15.2857 18.7388H15.2812C15.3194 18.7411 15.3637 18.7418 15.4087 18.7418C16.8217 18.7418 17.9737 17.6228 18.0269 16.2226V16.2181C18.0037 14.8501 16.8892 13.7498 15.5174 13.7498C15.4739 13.7498 15.4304 13.7513 15.3869 13.7528H15.3929ZM0.75293 7.97933L5.57993 18.8138L3.84593 22.7221H8.09168L14.5214 7.97933H10.3042L7.67993 14.2868L5.08343 7.97933H0.75368H0.75293ZM18.4297 3.15308L14.1277 12.8161H18.9359L23.2469 3.15308H18.4297Z", fill: "black" }) })),
+        getLink: ({ title, startDateTime, endDateTime, url }) => `https://calendar.yahoo.com/?v=60&title=${encodeURIComponent(title)}&st=${formatDateForIcs(startDateTime)}&et=${formatDateForIcs(endDateTime)}&desc=${encodeURIComponent(description(url))}&in_loc=${encodeURIComponent(url)}`,
+    },
+];
+export default apps.map(({ name, icon, getLink, isDownload }) => ({
+    name,
+    icon,
+    link: ({ title, startDateTime, endDateTime, url, }) => {
+        const href = getLink({ title, startDateTime, endDateTime, url });
+        return isDownload ? (_jsx("a", { href: href, download: "event.ics", role: "menuitem", "data-trackable": "liveqa_calendar-link", className: "live-qa-calendar-list__item__link", children: itemChildren(name, icon) })) : (_jsx(CalendarLink, { href: href, children: itemChildren(name, icon) }));
+    },
+}));

package/dist/esm/components/Calendar/CalendarList.js

@@ -0,0 +1,7 @@
+import { jsx as _jsx } from "preact/jsx-runtime";
+import CalendarListItem from './CalendarListItem';
+import apps from './Apps';
+function CalendarList() {
+    return (_jsx("ul", { className: "live-qa-calendar-list", id: "live-qa-calendar-list-menu", "data-testid": "live-qa-calendar-list-menu", role: "menu", "aria-labelledby": "live-qa-calendar-button-menu", children: apps && apps.map((app) => _jsx(CalendarListItem, { ...app })) }));
+}
+export default CalendarList;

package/dist/esm/components/Calendar/CalendarListItem.js

@@ -0,0 +1,22 @@
+import { jsx as _jsx, Fragment as _Fragment } from "preact/jsx-runtime";
+import { useContext } from 'react';
+import { QandaContext } from '../QandaProvider';
+import { useGetQandAStreamQuery } from '../../services/comments-api';
+function CalendarListItem({ name, link }) {
+    const { storyId, useStaging, commentsAPIUrl, title } = useContext(QandaContext);
+    const { data } = useGetQandAStreamQuery({
+        storyId,
+        useStaging,
+        commentsAPIUrl,
+        // Calendar is only relevant for pre-live Q&A
+        status: 'pre-live',
+    });
+    return (_jsx(_Fragment, { children: data?.startDateTime && data?.endDateTime && (_jsx("li", { className: 'live-qa-calendar-list__item', role: "presentation", "data-testid": "live-qa-calendar-list-item", children: link({
+                title,
+                startDateTime: data.startDateTime,
+                endDateTime: data.endDateTime,
+                url: `https://www.ft.com/content/${storyId}`,
+                children: name,
+            }) })) }));
+}
+export default CalendarListItem;

package/dist/esm/components/Calendar/index.js

@@ -0,0 +1,42 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "preact/jsx-runtime";
+import { Button } from '@financial-times/o3-button';
+import { useState, useRef, useEffect, useContext } from 'react';
+import CalendarList from './CalendarList';
+import { useGetQandAStreamQuery } from '../../services/comments-api';
+import { QandaContext } from '../QandaProvider';
+function Calendar() {
+    const [dropDownVisible, setDropDownVisible] = useState(false);
+    const containerRef = useRef(null);
+    const { storyId, useStaging, commentsAPIUrl } = useContext(QandaContext);
+    const { data } = useGetQandAStreamQuery({
+        storyId,
+        useStaging,
+        commentsAPIUrl,
+        // Calendar is only relevant for pre-live Q&A
+        // so we can hardcode the status here
+        status: 'pre-live',
+    });
+    useEffect(() => {
+        const handleClickOutside = (event) => {
+            if (containerRef.current &&
+                event.target instanceof Node &&
+                !containerRef.current.contains(event.target)) {
+                setDropDownVisible(false);
+            }
+        };
+        document.addEventListener('click', handleClickOutside);
+        return () => {
+            document.removeEventListener('click', handleClickOutside);
+        };
+    }, []);
+    return (_jsx(_Fragment, { children: data?.status === 'pre-live' && (_jsxs("div", { className: "live-qa-calendar-container", ref: containerRef, children: [_jsx(Button, { label: "Add to your calendar", type: "secondary", theme: "mono", icon: "calendar", iconOnly: false, attributes: {
+                        className: 'live-qa-calendar-button',
+                        'aria-pressed': dropDownVisible,
+                        'aria-haspopup': 'true',
+                        'aria-controls': 'menu',
+                        id: 'live-qa-calendar-button-menu',
+                        'data-testid': 'live-qa-calendar-button',
+                        'data-trackable': 'liveqa_add-to-calendar-button',
+                    }, onClick: () => setDropDownVisible(!dropDownVisible) }), dropDownVisible && _jsx(CalendarList, {})] })) }));
+}
+export default Calendar;

package/dist/esm/components/CountdownTimer/index.js

@@ -0,0 +1,88 @@
+import { jsx as _jsx, Fragment as _Fragment } from "preact/jsx-runtime";
+import { useEffect, useState, useContext, createPortal } from 'react';
+import { QandaContext } from '../QandaProvider';
+import { useGetQandAStreamQuery, useUpdatedQA, } from '../../services/comments-api';
+export function formatTime(remainingTime) {
+    const days = Math.floor(remainingTime / (1000 * 60 * 60 * 24));
+    if (days >= 1) {
+        return `${days} day${days === 1 ? '' : 's'} `;
+    }
+    const hours = Math.floor((remainingTime % (1000 * 60 * 60 * 24)) / (1000 * 60 * 60));
+    if (hours >= 1) {
+        return `${hours} hour${hours === 1 ? '' : 's'}`;
+    }
+    const minutes = Math.floor((remainingTime % (1000 * 60 * 60)) / (1000 * 60));
+    if (minutes >= 1) {
+        return `${minutes} minute${minutes === 1 ? '' : 's'}`;
+    }
+    const seconds = Math.floor((remainingTime % (1000 * 60)) / 1000);
+    if (seconds >= 1) {
+        return `${seconds} second${seconds === 1 ? '' : 's'}`;
+    }
+}
+function CountdownTimer({ container }) {
+    const { storyId, useStaging, commentsAPIUrl } = useContext(QandaContext);
+    const { data } = useGetQandAStreamQuery({
+        storyId,
+        useStaging,
+        commentsAPIUrl,
+        // Countdown is only relevant for pre-live Q&A
+        // so we can hardcode the status here
+        status: 'pre-live',
+    });
+    const updatedQA = useUpdatedQA({
+        storyId,
+        useStaging,
+        commentsAPIUrl,
+    });
+    const [count, setCount] = useState('');
+    const status = updatedQA?.status || data?.status || 'pre-live';
+    const startDateTime = updatedQA?.startDateTime || data?.startDateTime;
+    const endDateTime = updatedQA?.endDateTime || data?.endDateTime;
+    useEffect(() => {
+        function calculateTimeLeft() {
+            const currentDate = Date.now();
+            const isLive = status === 'live';
+            const timeForCountdown = isLive ? endDateTime : startDateTime;
+            if (!timeForCountdown) {
+                return;
+            }
+            const remainingTime = new Date(timeForCountdown).getTime() - currentDate;
+            const eventInfo = isLive ? 'Ending' : 'Starting';
+            if (remainingTime !== null && !isNaN(remainingTime)) {
+                if (remainingTime >= 1000) {
+                    setCount(`${eventInfo} in ${formatTime(remainingTime)}`);
+                }
+                else {
+                    setCount(`${eventInfo} Soon`);
+                }
+            }
+        }
+        calculateTimeLeft();
+        const interval = setInterval(calculateTimeLeft, 1000);
+        return () => clearInterval(interval);
+    }, [
+        data?.status,
+        data?.startDateTime,
+        data?.endDateTime,
+        updatedQA?.status,
+        updatedQA?.startDateTime,
+        updatedQA?.endDateTime,
+    ]);
+    const [portalTarget, setPortalTarget] = useState();
+    useEffect(() => {
+        if (container) {
+            const portalContainer = document.createElement('div');
+            container.prepend(portalContainer);
+            setPortalTarget(portalContainer);
+            return () => {
+                portalContainer.remove();
+            };
+        }
+    }, []);
+    const portalElement = data &&
+        ((status === 'pre-live' && startDateTime) ||
+            (status === 'live' && endDateTime)) && (_jsx("div", { className: "qanda-portal countdown-wrapper", children: _jsx("div", { className: "countdown-block", children: _jsx("p", { className: "countdown", children: count && (_jsx("time", { datetime: status === 'pre-live' ? startDateTime : endDateTime, children: count })) }) }) }));
+    return _jsx(_Fragment, { children: createPortal(portalElement, portalTarget || document.body) });
+}
+export default CountdownTimer;

package/dist/esm/components/EmbedFormField/index.js

@@ -0,0 +1,22 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "preact/jsx-runtime";
+import { useDispatch } from 'react-redux';
+import { openForm } from '../../store/questionSlice';
+import { useEffect, useState } from 'react';
+import { createPortal } from 'react-dom';
+function EmbedFormField({ container }) {
+    const dispatch = useDispatch();
+    const [portalTarget, setPortalTarget] = useState();
+    useEffect(() => {
+        if (container) {
+            const portalContainer = document.createElement('div');
+            container.prepend(portalContainer);
+            setPortalTarget(portalContainer);
+            return () => {
+                portalContainer.remove();
+            };
+        }
+    }, []);
+    const portalElement = (_jsxs("div", { className: "qanda-portal embed-form-field__container o3-type-body-highlight", children: ["Submit your question to the Q&A", _jsxs("div", { onClick: () => dispatch(openForm()), className: "embed-form-field__text-input o3-type-body-lg", "data-testid": "embed-form-field", children: [_jsx("span", { className: "embed-form-field__icon", children: _jsx("i", { style: { maskImage: 'var(--o3-icon-user)' } }) }), "Enter your question"] })] }));
+    return _jsx(_Fragment, { children: createPortal(portalElement, portalTarget || document.body) });
+}
+export default EmbedFormField;

package/dist/esm/components/ErrorMessage/humanReadableError.js

@@ -0,0 +1,71 @@
+const baseErrorMessages = {
+    generic: {
+        title: 'An error occurred',
+        message: 'Please try again later.',
+    },
+    serverError: {
+        title: 'Server error',
+        message: 'There was a server error. Please try again later.',
+    },
+    connectionError: {
+        title: 'Connection error',
+        message: 'Check your internet connection or browser settings and try again.',
+    },
+    timeoutError: {
+        title: 'Timeout error',
+        message: 'The request timed out. You may be on a slow connection. Please try again later.',
+    },
+};
+export default class HumanReadableError {
+    constructor(error, customErrorMessages = {}) {
+        // Default to generic error message
+        this._humanReadableError = baseErrorMessages.generic;
+        this._unMappedError = null;
+        const errorMessages = {
+            ...baseErrorMessages,
+            ...customErrorMessages,
+        };
+        try {
+            if ('status' in error) {
+                if (error.status === 'FETCH_ERROR') {
+                    this._humanReadableError = errorMessages.connectionError;
+                }
+                else if (typeof error.status === 'number' && error.status >= 500) {
+                    this._humanReadableError = errorMessages.serverError;
+                }
+                else if (typeof error.status === 'number' && error.status === 400) {
+                    // Assuming as an error  code otherwise will throw an error and we will fallback to generic error
+                    const typedError = error;
+                    this._humanReadableError =
+                        errorMessages[typedError.data.error.errorCode];
+                }
+            }
+            else if ('name' in error) {
+                if (error.name === 'AbortError') {
+                    this._humanReadableError = errorMessages.timeoutError;
+                }
+            }
+        }
+        catch (err) {
+            // Fallback to generic error message if we cannot parse the error correctly
+            this._humanReadableError = errorMessages.generic;
+            this._unMappedError = {
+                name: err && typeof err === 'object' && 'name' in err
+                    ? String(err.name)
+                    : '',
+                message: err && typeof err === 'object' && 'message' in err
+                    ? String(err.message)
+                    : '',
+            };
+        }
+    }
+    get title() {
+        return this._humanReadableError.title;
+    }
+    get message() {
+        return this._humanReadableError.message;
+    }
+    get unmappedError() {
+        return this._unMappedError;
+    }
+}

package/dist/esm/components/ErrorMessage/index.js

@@ -0,0 +1,57 @@
+import { jsx as _jsx } from "preact/jsx-runtime";
+import MessageBox from '../MessageBox';
+import { trackEvent } from '../../utils/tracking';
+import HumanReadableError from './humanReadableError';
+import { useEffect } from 'react';
+import { cleanString } from '../../utils/strings';
+export default function ErrorMessage({ error, storyId, errorMapping = {}, operation = 'not-specified', id = '', }) {
+    const humanReadableError = new HumanReadableError(error, errorMapping);
+    let errorDetails = [];
+    // If the error is unmapped, we log it for debugging purposes
+    if (humanReadableError.unmappedError) {
+        errorDetails = [
+            {
+                name: 'error_name',
+                value: humanReadableError.unmappedError.name,
+            },
+            {
+                name: 'error_message',
+                value: humanReadableError.unmappedError.message,
+            },
+        ];
+    }
+    else {
+        errorDetails = [
+            {
+                name: 'error',
+                value: cleanString(humanReadableError.title),
+            },
+            {
+                name: 'error_message',
+                value: cleanString(humanReadableError.message),
+            },
+        ];
+    }
+    useEffect(() => {
+        // Critical operation are tracked by the reliability service using AWS RUM
+        // We still log this to monitor untracked messages to the users.
+        trackEvent({
+            category: 'component',
+            action: 'act',
+            content: {
+                asset_type: 'article',
+                uuid: storyId,
+            },
+            trigger_action: operation,
+            custom: [
+                {
+                    name: 'state',
+                    value: 'error',
+                },
+                ...errorDetails,
+            ],
+        });
+        // Ensure trackEvent is only called once
+    }, []);
+    return (_jsx(MessageBox, { color: "var(--o3-color-use-case-error)", extraClassNames: "o-message--alert o-message--error", title: humanReadableError.title, text: humanReadableError.message, id: id }));
+}

package/dist/esm/components/Expander/index.js

@@ -0,0 +1,69 @@
+import { jsx as _jsx, jsxs as _jsxs } from "preact/jsx-runtime";
+import { useState, useRef, useEffect } from 'react';
+import { Button } from '@financial-times/o3-button';
+// Generic debounce function
+function debounce(func, delay) {
+    let timerId;
+    return (...args) => {
+        if (timerId)
+            clearTimeout(timerId);
+        timerId = setTimeout(() => {
+            func(...args);
+        }, delay);
+    };
+}
+// While comments submitted by Coral UI are always wrapped in paragraphs,
+// comments submitted via our `Ask a question` form are just text.
+// A wrapping paragraph is always needed for the expander to work correctly.
+function EnsureParagraph({ children }) {
+    if (typeof children === 'object' &&
+        children !== null &&
+        'props' in children &&
+        children.props?.structuredContent?.tree?.children?.[0]?.type === 'text') {
+        return _jsx("p", { children: children });
+    }
+    return children;
+}
+function Expander({ className = '', children = [], expandLabel = 'Expand', collapseLabel = 'Collapse', id, }) {
+    const textRef = useRef(null);
+    const [requiresExpander, setExpander] = useState(false);
+    const [state, setState] = useState('collapsed');
+    const expanderContentID = `expander_content-${id}`;
+    useEffect(() => {
+        const checkNeedForExpanderButton = () => {
+            const element = textRef.current;
+            if (!element) {
+                return;
+            }
+            const numberOfCharacters = element.textContent?.length || 300;
+            const windowWidth = window.visualViewport?.width || window.innerWidth || 1200; // Fallback to desktop configuration.
+            // Check if the element's height exceeds 3 lines for mobile or 1 line for above mobile
+            // Note: This need to stay aligned with the CSS for the expander
+            const mobileNumberOfCharacters = 100;
+            const desktopNumberOfCharacters = 200;
+            const characterForExpander = windowWidth <= 490
+                ? mobileNumberOfCharacters
+                : desktopNumberOfCharacters;
+            setExpander(numberOfCharacters > characterForExpander);
+        };
+        const debouncedCheck = debounce(checkNeedForExpanderButton, 250);
+        // Use requestAnimationFrame to ensure layout is complete
+        requestAnimationFrame(checkNeedForExpanderButton);
+        window.addEventListener('resize', debouncedCheck);
+        return () => window.removeEventListener('resize', debouncedCheck);
+    }, [children]); // re-run whenever the children change, although we don't expect it to
+    const label = state === 'expanded' ? collapseLabel : expandLabel;
+    const expandCollapseClass = state === 'expanded' ? 'expander--expanded' : 'expander--collapsed';
+    const componentClassName = `${expandCollapseClass} ${className}`;
+    return (_jsxs("div", { className: `${componentClassName}`, children: [_jsx("div", { className: `expander__text ${requiresExpander ? 'expander__text--multiline' : ''}`, id: expanderContentID, ref: textRef, children: _jsx(EnsureParagraph, { children: children }) }), requiresExpander && (_jsx(Button, { label: label, type: "ghost", theme: "neutral", icon: state === 'expanded' ? 'chevron-up' : 'chevron-down', iconOnly: false, iconPosition: "end", attributes: {
+                    className: 'expander__link',
+                    'data-trackable': `liveqa_expander`,
+                    'data-trackable-context-action': label,
+                    'aria-expanded': state === 'expanded' ? true : false,
+                    'aria-controls': expanderContentID,
+                    'data-action': state === 'expanded' ? 'collapse' : 'expand',
+                }, onClick: () => {
+                    setState((prevState) => prevState === 'expanded' ? 'collapsed' : 'expanded');
+                } }))] }));
+}
+export default Expander;

package/dist/esm/components/ExpertDrawer/index.js

@@ -0,0 +1,31 @@
+import { jsx as _jsx } from "preact/jsx-runtime";
+import OComments from '@financial-times/o-comments';
+import { useEffect, useContext } from 'react';
+import { useDispatch, useSelector } from 'react-redux';
+import { closeExpertForm } from '../../store/expertSlice';
+import { QandaContext } from '../QandaProvider';
+import { qandaReliability } from '../../services/reliability';
+import Overlay from '../Overlay';
+function ExpertDrawer() {
+    const dispatch = useDispatch();
+    const { storyId, useStaging, title } = useContext(QandaContext);
+    const { isExpertFormOpen, expertView } = useSelector((state) => state.expert);
+    useEffect(() => {
+        if (isExpertFormOpen) {
+            try {
+                OComments.init();
+            }
+            catch (error) {
+                qandaReliability.failure('expert-load-coral-ui', error);
+            }
+        }
+    }, [isExpertFormOpen]);
+    if (!isExpertFormOpen) {
+        return null;
+    }
+    return (_jsx(Overlay, { title: "Live Q&A", closeCallback: () => dispatch(closeExpertForm()), options: {
+            shadow: true,
+            noBackground: true,
+        }, children: _jsx("div", { className: "o-comments", id: "o-comments-stream", "data-o-component": "o-comments", "data-o-comments-article-id": storyId, "data-o-comments-article-url": `https://www.ft.com/content/${storyId}`, "data-o-comments-use-staging-environment": useStaging, "data-o-comments-title": title }) }));
+}
+export default ExpertDrawer;

package/dist/esm/components/FloatingActionBar/index.js

@@ -0,0 +1,57 @@
+import { jsx as _jsx, jsxs as _jsxs } from "preact/jsx-runtime";
+import { useDispatch, useSelector } from 'react-redux';
+import { Button } from '@financial-times/o3-button';
+import { openForm } from '../../store/questionSlice';
+import { openExpertForm } from '../../store/expertSlice';
+import { useIsMobile } from '../../hooks/useIsMobile';
+import { useUpdatedComments } from '../../services/comments-api';
+import { updateComments } from '../../store/updateComments';
+import { useContext } from 'react';
+import { QandaContext } from '../QandaProvider';
+function LiveIndicator() {
+    return (_jsx("div", { className: "o-labels-indicator--live o3-type-label floating-action-bar__live-container", children: _jsx("span", { className: "o-labels-indicator__status floating-action-bar__live-label", children: "Live" }) }));
+}
+function FloatingActionBar({ showLiveIndicator = true, }) {
+    const dispatch = useDispatch();
+    const isMobile = useIsMobile();
+    const { storyId, useStaging, commentsAPIUrl } = useContext(QandaContext);
+    const updatedComments = useUpdatedComments({
+        storyId,
+        useStaging,
+        commentsAPIUrl,
+    });
+    const handleShowUpdates = () => {
+        updateComments(dispatch, updatedComments, storyId, useStaging, commentsAPIUrl);
+        // Scrolling to start of qanda blocks container
+        const element = document.getElementById('qanda__blocks-container');
+        if (element) {
+            element.scrollIntoView({ behavior: 'smooth', block: 'start' });
+        }
+    };
+    const showExpertView = useSelector((state) => state.expert.expertView);
+    const userConfig = {
+        descripton: 'Ask a question',
+        testIdSuffix: 'ask-a-question-button',
+        onClick: () => dispatch(openForm()),
+        dataTrackable: 'open_question_form',
+    };
+    const expertConfig = {
+        descripton: 'Answer Q&A',
+        testIdSuffix: 'answer-a-qanda-button',
+        onClick: () => dispatch(openExpertForm()),
+        dataTrackable: 'open_expert_drawer',
+    };
+    const view = showExpertView ? expertConfig : userConfig;
+    return (_jsxs("div", { className: "floating-action-bar__container", "data-trackable": "floating-action-bar", children: [_jsx("div", { className: "floating-action-bar__fade-overlay" }), _jsxs("div", { className: "floating-action-bar", "data-testid": "floating-action-bar", children: [showLiveIndicator && _jsx(LiveIndicator, {}), _jsxs("div", { className: "floating-action-bar__buttons", children: [_jsx(Button, { attributes: {
+                                    ariaLabel: view.descripton,
+                                    'data-trackable': view.dataTrackable,
+                                    'data-trackable-context-action': view.descripton,
+                                    'data-testid': `floating-action-bar__${view.testIdSuffix}`,
+                                }, label: view.descripton, type: "ghost", theme: "mono", icon: "edit", iconOnly: isMobile, onClick: view.onClick }), _jsx(Button, { attributes: {
+                                    ariaLabel: 'Back to top',
+                                    'data-trackable': 'back_to_top',
+                                    'data-trackable-context-action': 'Back to top',
+                                    'data-testid': 'floating-action-bar__back-to-top-button',
+                                }, label: "Back to top", type: "ghost", theme: "mono", icon: "scroll-to", iconOnly: isMobile, onClick: handleShowUpdates })] }), updatedComments?.length > 0 && (_jsx("div", { className: "floating-action-bar__updates-counter o3-type-detail", children: updatedComments.length }))] })] }));
+}
+export default FloatingActionBar;

package/dist/esm/components/Loader/index.js

@@ -0,0 +1,4 @@
+import { jsx as _jsx } from "preact/jsx-runtime";
+export default function Loader({ size = 'small', theme = 'light', extraClassNames = '', }) {
+    return (_jsx("div", { className: `o-loading o-loading--${theme} o-loading--${size} ${extraClassNames}`, role: "progressbar", "aria-label": "Loading content" }));
+}

package/dist/esm/components/MessageBox/index.js

@@ -0,0 +1,5 @@
+import { jsx as _jsx, jsxs as _jsxs } from "preact/jsx-runtime";
+function MessageBox({ color, extraClassNames = '', text, title, id = '', }) {
+    return (_jsx("div", { class: `o-message o-message--inner message-box__container ${extraClassNames}`, "data-o-message-close": "false", "data-o-component": "o-message", id: id, children: _jsx("div", { class: "o-message__container", children: _jsxs("div", { class: "message-box__content", children: [_jsx("span", { style: { color }, class: "o3-type-body-highlight", children: title }), _jsx("span", { style: { color }, class: "o3-type-body-base", children: text })] }) }) }));
+}
+export default MessageBox;

package/dist/esm/components/Overlay/index.js

@@ -0,0 +1,13 @@
+import { jsx as _jsx, jsxs as _jsxs } from "preact/jsx-runtime";
+import { Button } from '@financial-times/o3-button';
+import classNames from 'classnames';
+function Overlay({ title, children, closeCallback, options = {}, }) {
+    return (_jsxs("div", { className: "overlay", children: [_jsx("div", { className: classNames([
+                    'overlay__outer',
+                    { 'overlay__outer--no-background': options.noBackground },
+                ]) }), _jsxs("div", { className: classNames([
+                    'overlay__inner',
+                    { 'overlay__inner--shadow': options.shadow },
+                ]), children: [_jsx("div", { className: "overlay__header", children: _jsxs("div", { className: "overlay__header-bar", children: [_jsx("span", { className: "o3-type-body-highlight overlay__header-title", children: title }), _jsx(Button, { attributes: { className: 'overlay__header-close' }, iconOnly: true, icon: "cross", label: "Close", type: "ghost", theme: "mono", onClick: () => closeCallback() })] }) }), _jsx("div", { className: "overlay__content", children: children })] })] }));
+}
+export default Overlay;

package/dist/esm/components/Qanda.js

@@ -0,0 +1,32 @@
+import { jsx as _jsx } from "preact/jsx-runtime";
+import { Provider } from 'react-redux';
+import { store } from '../store';
+import QandaContainer from './QandaContainer';
+import { QandaContext } from './QandaProvider';
+function Qanda({ storyId, useStaging, title, commentsAPIHost, commentsAPIVersion, maxQuestionLength, embedFormFieldContainer, countdownTimerContainer, }) {
+    // check we have a valid ft.com url and remove any trailing slashes
+    const allowedHostRegx = /^[\w\-\.]+(\.ft\.com|\.ftweb\.tech)$/i;
+    const allowedVersionRegx = /^v\d+$/i;
+    const validateApiUrl = (url, version) => {
+        const baseURL = new URL(url);
+        if (!allowedHostRegx.test(baseURL.hostname) ||
+            !allowedVersionRegx.test(version)) {
+            console.error('Invalid comments API details provided');
+            return;
+        }
+        return `https://${baseURL.hostname}/qa/${version}`;
+    };
+    const cleanCommentsAPIUrl = validateApiUrl(commentsAPIHost, commentsAPIVersion);
+    if (!storyId || !title || !cleanCommentsAPIUrl) {
+        console.error('Missing required props');
+        return null;
+    }
+    return (_jsx(Provider, { store: store, children: _jsx(QandaContext.Provider, { value: {
+                storyId,
+                useStaging,
+                commentsAPIUrl: cleanCommentsAPIUrl,
+                title,
+                maxQuestionLength,
+            }, children: _jsx(QandaContainer, { embedFormFieldContainer: embedFormFieldContainer, countdownTimerContainer: countdownTimerContainer }) }) }));
+}
+export default Qanda;