@financial-times/qanda-ui 0.0.1-beta.1 → 0.0.1-beta.11

package/README.md

@@ -2,24 +2,42 @@
 
 A library for the Live Q&A client-side component
 
-## Features
-
 ## Usage
 
-This library exports a class which can be used to construct a new instance of QandaUI and exposes methods to initialise that and to destroy it.
+### Importing styles
+
+This module comes with both a SASS export which you will need to import into your own sass file, and then run through your build process.
+
+The Origami components required are listed as peer dependencies in package.json.
+
+#### Example:
+
+```scss
+@import '@financial-times/qanda-ui/scss';
+```
+
+### Importing and running the component (JS)
+
+This library exports a class which can be used to construct a new instance of QandaUI and exposes methods to initialise it and to destroy it.
+
+It also exports QandaBlock, the UI that is used to show a question 'block' - a question and its answers along with the other data like poster name and expert details
+
+#### QandaUI
 
 You can pass the necessary settings to Qanda UI in either the JS or in the container element.
 
-### Example:
+##### Example:
 
 ```jsx
-<div class="qanda"></div>
+// JSX
+<div class="someclassname"></div>
 ```
 
 ```js
-import QandaUI from '@financial-times/qanda-ui';
+// JS
+import { QandaUI } from '@financial-times/qanda-ui';
 
-const qandaEl = document.querySelector('.qanda');
+const qandaEl = document.querySelector('.someclassname');
 const qandaUI = new QandaUI(qandaEl, {
   storyId: '71539bd7-1818-4193-8a58-d5a4d914a012',
   useStaging: true,
@@ -30,9 +48,10 @@ const qandaUI = new QandaUI(qandaEl, {
 qandaUI.init();
 ```
 
-Alternatively
+##### Alternative:
 
 ```jsx
+// JSX
 <div
   class="qanda"
   data-qanda-storyId="71539bd7-1818-4193-8a58-d5a4d914a012"
@@ -44,25 +63,41 @@ Alternatively
 ```
 
 ```js
-import QandaUI from '@financial-times/qanda-ui';
-const qandaEl = document.querySelector('.qanda');
+// JS
+import { QandaUI } from '@financial-times/qanda-ui';
+const qandaEl = document.querySelector('.someclassname');
 const qandaUI = new QandaUI(qandaEl);
 qandaUI.init();
 ```
 
-### Parameters
+##### Parameters
 
 - storyId: (required) string, the ID of the article used for Live Q&A
 - useStaging: (optional) boolean, set to true if you want to use the staging Coral
 - title: (required) string, the article title, needed to set up Coral properly
 - commentsAPIHost: (required) string, the host of the API to be used (include the protocol)
 - commentsAPIVersion: (required) string, the version of the API to be used
+- maxQuestionLength: (optional) number, set to the maximum allowable length (in characters) for the question text
 
-### Instance Methods
+##### Instance Methods
 
 - `myInstance.init()` - render the Qanda UI
 - `myInstance.destroy()` - remove the Qanda instance
 
+### QandaBlock
+
+```jsx
+import QandaBlock from '@financial-times/qanda-ui';
+
+<QandaBlock
+  id={questionId}
+  body={body}
+  children={answers}
+  byline={byeline}
+  subtitle={lorem}
+/>;
+```
+
 ## Development
 
 ### Prerequisites
@@ -94,9 +129,8 @@ You can customize the demo application by modifying the configuration files in t
 
 These are the config settings you can work with:
 
+- `export const COMMENTS_API_BASE_HOST = LOCAL_API;` // use one of the provided constants or set your own next comments api domain
 - `export const USE_STAGING = true;` // use Coral staging or production
-- `export const USE_LOCAL_API = true;` // use local next-comments-api or live
-- `export const MOCK_SSE = true;` // use a dummy eventsource that lets you send mock events rather than listen to ones coming from next-comments-api
 
 ### Building and Running the Production Server
 
@@ -116,7 +150,7 @@ To run the Jest tests, use:
 npm run test
 ```
 
-## Technology
+### Technology
 
 This uses React, Redux and RTK Query to create the components and manage their states.
 
@@ -124,6 +158,20 @@ This uses React, Redux and RTK Query to create the components and manage their s
 - The store is used for non-API data that needs to be shared around the components
 - The story ID and useStaging settings passed in when the Qanda compontent is set are saved into the Context.
 
+### Architecture
+
+Quanda UI is strongly coupled with next-comments-api. See [architectural documentation in next-comments-api repository](https://github.com/Financial-Times/next-comments-api/blob/main/docs/liveqa.md#live-qa).
+
+## Support
+
+### Client-side metrics
+
+We send client-side metrics (Failures and optionally successes) to [Cloudwatch RUM in the `FT Tech Next Prod` account](https://eu-west-1.console.aws.amazon.com/cloudwatch/home?region=eu-west-1#rum:dashboard/cp-client-metrics?tab=events).
+
+Failure events may contain error information for debugging.
+
+Those events are also observable in a [Live Q&A Grafana dashboard](https://grafana.ft.com/d/fekh6pkkr80lcd/live-qanda).
+
 ### How updates work
 
 In order to receive updates from the next comments API, we use an EventSource that listens to an EventEmitter endpoint on next-comments-api.

package/dist/cjs/components/Author/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const jsx_runtime_1 = require("preact/jsx-runtime");
+const Headshot_1 = __importDefault(require("@financial-times/cp-content-pipeline-ui/lib/components/Headshot"));
+const cp_content_pipeline_ui_1 = require("@financial-times/cp-content-pipeline-ui");
+function Author({ byline, headshot, prefLabel, role, streamPage, }) {
+    const hasHeadshot = headshot && prefLabel;
+    return ((0, jsx_runtime_1.jsxs)("div", { className: "qanda-block__answer__author", "data-testid": "qanda-block__answer__author", children: [hasHeadshot ? ((0, jsx_runtime_1.jsx)("div", { className: "qanda-block__answer__author-headshot", children: (0, jsx_runtime_1.jsx)(Headshot_1.default, { headshot: headshot, prefLabel: prefLabel, streamPage: streamPage, className: "qanda-block__answer__author-headshot" }) })) : ((0, jsx_runtime_1.jsx)("div", { className: "qanda-block__answer__author-opinion-icon" })), (0, jsx_runtime_1.jsxs)("div", { className: "qanda-block__answer__author-info", children: [(0, jsx_runtime_1.jsx)("div", { className: "o3-type-body-highlight qanda-block__answer__author-name", children: (0, jsx_runtime_1.jsx)(cp_content_pipeline_ui_1.Byline, { structuredContent: byline, showEditedBy: false }) }), (0, jsx_runtime_1.jsx)("div", { className: "o3-type-body-base", children: role })] })] }));
+}
+Author.defaultProps = {
+    byline: '',
+    headshot: false,
+    prefLabel: false,
+    streamPage: '',
+};
+exports.default = Author;

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

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const jsx_runtime_1 = require("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, }) => ((0, jsx_runtime_1.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 ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [(0, jsx_runtime_1.jsx)("span", { className: "live-qa-calendar-list__item__icon", children: icon }), (0, jsx_runtime_1.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: ((0, jsx_runtime_1.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: (0, jsx_runtime_1.jsxs)("g", { transform: "translate(4, 3.36)", children: [(0, jsx_runtime_1.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" }), (0, jsx_runtime_1.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" }), (0, jsx_runtime_1.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" }), (0, jsx_runtime_1.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: ((0, jsx_runtime_1.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: (0, jsx_runtime_1.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: ((0, jsx_runtime_1.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: (0, jsx_runtime_1.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: ((0, jsx_runtime_1.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: (0, jsx_runtime_1.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)}`,
+    },
+];
+exports.default = apps.map(({ name, icon, getLink, isDownload }) => ({
+    name,
+    icon,
+    link: ({ title, startDateTime, endDateTime, url, }) => {
+        const href = getLink({ title, startDateTime, endDateTime, url });
+        return isDownload ? ((0, jsx_runtime_1.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) })) : ((0, jsx_runtime_1.jsx)(CalendarLink, { href: href, children: itemChildren(name, icon) }));
+    },
+}));

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

@@ -0,0 +1,12 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const jsx_runtime_1 = require("preact/jsx-runtime");
+const CalendarListItem_1 = __importDefault(require("./CalendarListItem"));
+const Apps_1 = __importDefault(require("./Apps"));
+function CalendarList() {
+    return ((0, jsx_runtime_1.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_1.default && Apps_1.default.map((app) => (0, jsx_runtime_1.jsx)(CalendarListItem_1.default, { ...app })) }));
+}
+exports.default = CalendarList;

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

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const jsx_runtime_1 = require("preact/jsx-runtime");
+const react_1 = require("react");
+const QandaProvider_1 = require("../QandaProvider");
+const comments_api_1 = require("../../services/comments-api");
+function CalendarListItem({ name, link }) {
+    const { storyId, useStaging, commentsAPIUrl, title } = (0, react_1.useContext)(QandaProvider_1.QandaContext);
+    const { data } = (0, comments_api_1.useGetQandAStreamQuery)({
+        storyId,
+        useStaging,
+        commentsAPIUrl,
+    });
+    return ((0, jsx_runtime_1.jsx)(jsx_runtime_1.Fragment, { children: data?.startDateTime && data?.endDateTime && ((0, jsx_runtime_1.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,
+            }) })) }));
+}
+exports.default = CalendarListItem;

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

@@ -0,0 +1,44 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const jsx_runtime_1 = require("preact/jsx-runtime");
+const o3_button_1 = require("@financial-times/o3-button");
+const react_1 = require("react");
+const CalendarList_1 = __importDefault(require("./CalendarList"));
+const comments_api_1 = require("../../services/comments-api");
+const QandaProvider_1 = require("../QandaProvider");
+function Calendar() {
+    const [dropDownVisible, setDropDownVisible] = (0, react_1.useState)(false);
+    const containerRef = (0, react_1.useRef)(null);
+    const { storyId, useStaging, commentsAPIUrl } = (0, react_1.useContext)(QandaProvider_1.QandaContext);
+    const { data } = (0, comments_api_1.useGetQandAStreamQuery)({
+        storyId,
+        useStaging,
+        commentsAPIUrl,
+    });
+    (0, react_1.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 ((0, jsx_runtime_1.jsx)(jsx_runtime_1.Fragment, { children: data?.status === 'pre-live' && ((0, jsx_runtime_1.jsxs)("div", { className: "live-qa-calendar-container", ref: containerRef, children: [(0, jsx_runtime_1.jsx)(o3_button_1.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 && (0, jsx_runtime_1.jsx)(CalendarList_1.default, {})] })) }));
+}
+exports.default = Calendar;

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

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatTime = formatTime;
+const jsx_runtime_1 = require("preact/jsx-runtime");
+const react_1 = require("react");
+const QandaProvider_1 = require("../QandaProvider");
+const comments_api_1 = require("../../services/comments-api");
+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 } = (0, react_1.useContext)(QandaProvider_1.QandaContext);
+    const { data } = (0, comments_api_1.useGetQandAStreamQuery)({
+        storyId,
+        useStaging,
+        commentsAPIUrl,
+    });
+    const updatedQA = (0, comments_api_1.useUpdatedQA)({
+        storyId,
+        useStaging,
+        commentsAPIUrl,
+    });
+    const [count, setCount] = (0, react_1.useState)('');
+    const status = updatedQA?.status || data?.status || 'pre-live';
+    const startDateTime = updatedQA?.startDateTime || data?.startDateTime;
+    const endDateTime = updatedQA?.endDateTime || data?.endDateTime;
+    (0, react_1.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] = (0, react_1.useState)();
+    (0, react_1.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)) && ((0, jsx_runtime_1.jsx)("div", { className: "qanda-portal countdown-wrapper", children: (0, jsx_runtime_1.jsx)("div", { className: "countdown-block", children: (0, jsx_runtime_1.jsx)("p", { className: "countdown", children: count && ((0, jsx_runtime_1.jsx)("time", { datetime: status === 'pre-live' ? startDateTime : endDateTime, children: count })) }) }) }));
+    return (0, jsx_runtime_1.jsx)(jsx_runtime_1.Fragment, { children: (0, react_1.createPortal)(portalElement, portalTarget || document.body) });
+}
+exports.default = CountdownTimer;

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

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const jsx_runtime_1 = require("preact/jsx-runtime");
+const react_redux_1 = require("react-redux");
+const questionSlice_1 = require("../../store/questionSlice");
+const react_1 = require("react");
+const react_dom_1 = require("react-dom");
+function EmbedFormField({ container }) {
+    const dispatch = (0, react_redux_1.useDispatch)();
+    const [portalTarget, setPortalTarget] = (0, react_1.useState)();
+    const expertView = (0, react_redux_1.useSelector)((state) => state.expert.expertView);
+    if (expertView) {
+        return null;
+    }
+    (0, react_1.useEffect)(() => {
+        if (container) {
+            const portalContainer = document.createElement('div');
+            container.prepend(portalContainer);
+            setPortalTarget(portalContainer);
+            return () => {
+                portalContainer.remove();
+            };
+        }
+    }, []);
+    const portalElement = ((0, jsx_runtime_1.jsxs)("div", { className: "qanda-portal embed-form-field__container o3-type-body-highlight", children: ["Submit your question to the Q&A", (0, jsx_runtime_1.jsxs)("div", { onClick: () => dispatch((0, questionSlice_1.openForm)()), className: "embed-form-field__text-input o3-type-body-lg", "data-testid": "embed-form-field", children: [(0, jsx_runtime_1.jsx)("span", { className: "embed-form-field__icon", children: (0, jsx_runtime_1.jsx)("i", { style: { maskImage: 'var(--o3-icon-user)' } }) }), "Enter your question"] })] }));
+    return (0, jsx_runtime_1.jsx)(jsx_runtime_1.Fragment, { children: (0, react_dom_1.createPortal)(portalElement, portalTarget || document.body) });
+}
+exports.default = EmbedFormField;

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

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const jsx_runtime_1 = require("preact/jsx-runtime");
+const react_1 = require("react");
+const o3_button_1 = require("@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 (0, jsx_runtime_1.jsx)("p", { children: children });
+    }
+    return children;
+}
+function Expander({ className = '', children = [], expandLabel = 'Expand', collapseLabel = 'Collapse', id, }) {
+    const textRef = (0, react_1.useRef)(null);
+    const [requiresExpander, setExpander] = (0, react_1.useState)(false);
+    const [state, setState] = (0, react_1.useState)('collapsed');
+    const expanderContentID = `expander_content-${id}`;
+    (0, react_1.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 ((0, jsx_runtime_1.jsxs)("div", { className: `${componentClassName}`, children: [(0, jsx_runtime_1.jsx)("div", { className: `expander__text ${requiresExpander ? 'expander__text--multiline' : ''}`, id: expanderContentID, ref: textRef, children: (0, jsx_runtime_1.jsx)(EnsureParagraph, { children: children }) }), requiresExpander && ((0, jsx_runtime_1.jsx)(o3_button_1.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');
+                } }))] }));
+}
+exports.default = Expander;

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

@@ -0,0 +1,36 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const jsx_runtime_1 = require("preact/jsx-runtime");
+const o_comments_1 = __importDefault(require("@financial-times/o-comments"));
+const react_1 = require("react");
+const react_redux_1 = require("react-redux");
+const expertSlice_1 = require("../../store/expertSlice");
+const QandaProvider_1 = require("../QandaProvider");
+const reliability_1 = require("../../services/reliability");
+const Overlay_1 = __importDefault(require("../Overlay"));
+function ExpertDrawer() {
+    const dispatch = (0, react_redux_1.useDispatch)();
+    const { storyId, useStaging, title } = (0, react_1.useContext)(QandaProvider_1.QandaContext);
+    const { isExpertFormOpen, expertView } = (0, react_redux_1.useSelector)((state) => state.expert);
+    (0, react_1.useEffect)(() => {
+        if (isExpertFormOpen) {
+            try {
+                o_comments_1.default.init();
+            }
+            catch (error) {
+                reliability_1.qandaReliability.failure('expert-load-coral-ui', error);
+            }
+        }
+    }, [isExpertFormOpen]);
+    if (!isExpertFormOpen) {
+        return null;
+    }
+    return ((0, jsx_runtime_1.jsx)(Overlay_1.default, { title: "Live Q&A", closeCallback: () => dispatch((0, expertSlice_1.closeExpertForm)()), options: {
+            shadow: true,
+            noBackground: true,
+        }, children: (0, jsx_runtime_1.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 }) }));
+}
+exports.default = ExpertDrawer;

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

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const jsx_runtime_1 = require("preact/jsx-runtime");
+const react_redux_1 = require("react-redux");
+const o3_button_1 = require("@financial-times/o3-button");
+const questionSlice_1 = require("../../store/questionSlice");
+const expertSlice_1 = require("../../store/expertSlice");
+const useIsMobile_1 = require("../../hooks/useIsMobile");
+const comments_api_1 = require("../../services/comments-api");
+const updateComments_1 = require("../../store/updateComments");
+const react_1 = require("react");
+const QandaProvider_1 = require("../QandaProvider");
+function FloatingActionBar() {
+    const dispatch = (0, react_redux_1.useDispatch)();
+    const isMobile = (0, useIsMobile_1.useIsMobile)();
+    const { storyId, useStaging, commentsAPIUrl } = (0, react_1.useContext)(QandaProvider_1.QandaContext);
+    const updatedComments = (0, comments_api_1.useUpdatedComments)({
+        storyId,
+        useStaging,
+        commentsAPIUrl,
+    });
+    const handleShowUpdates = () => {
+        (0, updateComments_1.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 = (0, react_redux_1.useSelector)((state) => state.expert.expertView);
+    const userConfig = {
+        descripton: 'Ask a question',
+        testIdSuffix: 'ask-a-question-button',
+        onClick: () => dispatch((0, questionSlice_1.openForm)()),
+        dataTrackable: 'open_question_form',
+    };
+    const expertConfig = {
+        descripton: 'Answer Q&A',
+        testIdSuffix: 'answer-a-qanda-button',
+        onClick: () => dispatch((0, expertSlice_1.openExpertForm)()),
+        dataTrackable: 'open_expert_drawer',
+    };
+    const view = showExpertView ? expertConfig : userConfig;
+    return ((0, jsx_runtime_1.jsxs)("div", { className: "floating-action-bar__container", "data-trackable": "floating-action-bar", children: [(0, jsx_runtime_1.jsx)("div", { className: "floating-action-bar__fade-overlay" }), (0, jsx_runtime_1.jsxs)("div", { className: "floating-action-bar", "data-testid": "floating-action-bar", children: [(0, jsx_runtime_1.jsx)("div", { className: "o-labels-indicator--live o3-type-label floating-action-bar__live-container", children: (0, jsx_runtime_1.jsx)("span", { className: "o-labels-indicator__status floating-action-bar__live-label", children: "Live" }) }), (0, jsx_runtime_1.jsxs)("div", { className: "floating-action-bar__buttons", children: [(0, jsx_runtime_1.jsx)(o3_button_1.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 }), (0, jsx_runtime_1.jsx)(o3_button_1.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 && ((0, jsx_runtime_1.jsx)("div", { className: "floating-action-bar__updates-counter o3-type-detail", children: updatedComments.length }))] })] }));
+}
+exports.default = FloatingActionBar;

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

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = Loader;
+const jsx_runtime_1 = require("preact/jsx-runtime");
+function Loader({ size = 'small', theme = 'light', extraClassNames = '', }) {
+    return ((0, jsx_runtime_1.jsx)("div", { className: `o-loading o-loading--${theme} o-loading--${size} ${extraClassNames}`, role: "progressbar", "aria-label": "Loading content" }));
+}

package/dist/cjs/components/Overlay/MessageBox.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const jsx_runtime_1 = require("preact/jsx-runtime");
+function MessageBox({ color, styles, text, title }) {
+    return ((0, jsx_runtime_1.jsx)("div", { class: `o-message o-message--inner ${styles} message-box__container`, "data-o-message-close": "false", "data-o-component": "o-message", children: (0, jsx_runtime_1.jsx)("div", { class: "o-message__container", children: (0, jsx_runtime_1.jsxs)("div", { class: "message-box__content", children: [(0, jsx_runtime_1.jsx)("span", { style: { color }, class: "o3-type-body-highlight", children: title }), (0, jsx_runtime_1.jsx)("span", { style: { color }, class: "o3-type-body-base", children: text })] }) }) }));
+}
+exports.default = MessageBox;

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

@@ -0,0 +1,18 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const jsx_runtime_1 = require("preact/jsx-runtime");
+const o3_button_1 = require("@financial-times/o3-button");
+const classnames_1 = __importDefault(require("classnames"));
+function Overlay({ title, children, closeCallback, options = {}, }) {
+    return ((0, jsx_runtime_1.jsxs)("div", { className: "overlay", children: [(0, jsx_runtime_1.jsx)("div", { className: (0, classnames_1.default)([
+                    'overlay__outer',
+                    { 'overlay__outer--no-background': options.noBackground },
+                ]) }), (0, jsx_runtime_1.jsxs)("div", { className: (0, classnames_1.default)([
+                    'overlay__inner',
+                    { 'overlay__inner--shadow': options.shadow },
+                ]), children: [(0, jsx_runtime_1.jsx)("div", { className: "overlay__header", children: (0, jsx_runtime_1.jsxs)("div", { className: "overlay__header-bar", children: [(0, jsx_runtime_1.jsx)("span", { className: "o3-type-body-highlight overlay__header-title", children: title }), (0, jsx_runtime_1.jsx)(o3_button_1.Button, { attributes: { className: 'overlay__header-close' }, iconOnly: true, icon: "cross", label: "Close", type: "ghost", theme: "mono", onClick: () => closeCallback() })] }) }), (0, jsx_runtime_1.jsx)("div", { className: "overlay__content", children: children })] })] }));
+}
+exports.default = Overlay;