@seamly/web-ui 20.7.0 → 20.8.0-alpha.1

package/CHANGELOG.md

@@ -2,46 +2,82 @@
 
 ## Unreleased
 
+### Changes
+
+- The `preact` peerDependency has been upgraded to version `10.10.6`. This should also be used in client implementations.
+
+### Breaking changes
+
+- Added TypeScript support. Clients that do not use TypeScript will not be affected.
+- Redux has been replaced with `redux-toolkit` (RTK). This may have an impact on client implementations. Because `slices` in RTK automatically create `action` functions, it affects how `dispatch` should be called. So instead of;
+    ```
+    dispatch({
+      type: "SET_VALUE",
+      value: "the value"
+    })
+
+    dispatch({
+      type: "SET_NAME",
+      firstName: "first name",
+      lastName: "last name,
+    })
+    ```
+
+    It uses a more normalized approach;
+
+    ```
+    dispatch(setValue("the value"))
+    dispatch(setName({ firstName: "first name", lastName: "last name"}))
+    ```
+
 ## 20.7.0 (14 September 2022)
 
 ### Bugfixes
+
 - Fix an issue where destructuring the `type` of an `entry` would result in an error when the `payload` was `undefined`.
 
 ### Breaking changes
+
 - The sendInfo() Seamly command has been removed.
 
 ### Changes
+
 - Added `.suggestions--aside` class to the suggestions in the inline interface to allow for easier styling.
 
 ## 20.6.0 (12 August 2022)
 
 ### Bugfixes
+
 - Fix an issue where the interface would not be translated when translation had started before the user had sent a message.
 - Fix an issue where optimistically rendered user messages would re-render after being mutated with the response from the server.
 
 ## 20.5.0 (29 July 2022)
 
 ### Changes
+
 - When syncing, give incoming events in the history precedence over events in the local state to allow the server to push changes to events.
 - Added links to user messages and the full conversation demo's in the styleguide.
 - The `connect()` and `start()` methods are decoupled to avoid unnecessary chat sessions. The `start()` method will only be called if the `visibility` state is 'open' or if using the inline view if it's 'open' or 'minimized'.
 - Markdown and Mustache rendering have been removed as this is now done server-side. Any implementation that uses `useTextRendering` should be rewritten to directly work on the rendered message body.
 
 ### Bugfixes
+
 - Fix an issue where reconnecting to the api would not happen when a page is loaded from back/forward cache.
 - Fix an issue where the order of appearance was incorrect when there where multiple start events and the suggestions block was used.
 - Fix an issue where `showDisclaimer` would be overwritten by the config in the styleguide.
 - Fix an issue where the FAQ would not immediately disappear after submitting an entry.
 - Fix an issue where the input entry was not showing the correct character limit after an entry with `limit` was received.
 - Fix an issue where the inline interface would not reopen after returning from hibernation or after clearing the session storage. This changes the way `visibilityCallback` is called.
-If the `visibility` state is not present in the storage after returning to a chat session, it will be set once the conversation data is fetched. This results in an extra execution of the `visibilityCallback`.
+  If the `visibility` state is not present in the storage after returning to a chat session, it will be set once the conversation data is fetched. This results in an extra execution of the `visibilityCallback`.
 
 ## 20.4.0 (13 July 2022)
 
 ### Changes
+
 - Added minimized inline interface with limited characters to styleguide.
 
 ### Bugfixes
+
 - Fix an issue where the translation locale would be `undefined` after reopening a session from hibernation.
 - Fix an issue where virtual keyboards would close after submitting a message in the chat.
 - Fix an issue where message count would accidentally show up briefly when collapsing the chat.
@@ -49,11 +85,13 @@ If the `visibility` state is not present in the storage after returning to a cha
 ## 20.3.1 (11 July 2022)
 
 ### Bugfixes
+
 - Fix compatibility with existing custom view implementation by allowing passing of `children` to the `<View />` component.
 
 ## 20.3.0 (22 June 2022)
 
 ### Changes
+
 - The `preact` peerDependency has been upgraded to version `10.7.3`. This should also be used in client implementations.
 - Only load the inline chat interface when scrolled into view. This behaviour can be disabled by setting `connectWhenInView` in `config.js` to `false`.
 - Allow initial topic to be set through configuration or by calling the `setTopic` window API call before initialization.
@@ -65,6 +103,7 @@ If the `visibility` state is not present in the storage after returning to a cha
   ```
 
 ### Bugfixes
+
 - Fix scrolling to the bottom of a chat window after an image has fully loaded.
 - Fix support for sending in both an `apiKey` and an `externalId` as query parameter on the demo pages.
 - Fix ensuring conversation suggestions remain hidden in the window variant after user interaction.
@@ -74,9 +113,11 @@ If the `visibility` state is not present in the storage after returning to a cha
 ## 20.2.0 (10 May 2022)
 
 ### Changes
+
 - Allow setting the automatic translation of the conversation upon initialization.
 
 ### Bugfixes
+
 - Fix inline interface to be open by default if the user has responded.
 - Fix agent name as subtitle of the header in the `DeprecatedView`.
 - Fix missing variables for the client name and client version.
@@ -86,6 +127,7 @@ If the `visibility` state is not present in the storage after returning to a cha
 ## 20.1.0 (26 April 2022)
 
 ### Changes
+
 - The upload component has been rearranged to remove the redundant div container.
 - Expose `SeamlyStaticCore` component from styleguide in package.
 - All components that need disabled states now use aria-disabled for consistency across the board.
@@ -94,17 +136,19 @@ If the `visibility` state is not present in the storage after returning to a cha
 - Expose layoutMode to the server.
 
 ### Bugfixes
+
 - Fix scrolling to top of inline interface in style guide.
 
 ## 20.0.0 (4 April 2022)
 
 ### The new interface
+
 Version 20.0.0 contains a major upgrade of the look and feel. The most noticeable improvements are:
 
-* The inline interface now starts in a collapsed state so it uses less screen real-estate on load and allows for a more call-to-action based interaction.
-* The chat button for the window variant shows pre-chat messages which makes it possible to have different call-to-action triggers based on the users need/location.
-* All UI variants have more screen real-estate for chat as the fixed header has been redesigned.
-* FAQ/suggestion handling is now part of the chat-flow in the window and app variants making it a more natural interaction.
+- The inline interface now starts in a collapsed state so it uses less screen real-estate on load and allows for a more call-to-action based interaction.
+- The chat button for the window variant shows pre-chat messages which makes it possible to have different call-to-action triggers based on the users need/location.
+- All UI variants have more screen real-estate for chat as the fixed header has been redesigned.
+- FAQ/suggestion handling is now part of the chat-flow in the window and app variants making it a more natural interaction.
 
 ::: box--important
 **Important**
@@ -112,6 +156,7 @@ The old UI has been deprecated and will be removed in a future version. New impl
 :::
 
 ### Changes
+
 - Add `.cvco-form` class to form component.
 - Add `.cvco-form--submitted`, `.cvco-form--valid`, `.cvco-form--invalid` modifier classes to form component.
 - Add `onError` handler to form component.
@@ -126,20 +171,22 @@ The old UI has been deprecated and will be removed in a future version. New impl
 - Add `context.channelName` to the Seamly initialization configuration options.
 
 ### Breaking changes
+
 - Remove `modal` window variant
 - Non-structural implementation specific styling is now in a separate stylesheet (`src/stylesheets/styles-default-implementation.scss` or pre-built: `styles-default-implementation.css`). If you depend on styling for hover/scrollbars on these you need to load this stylesheet as well.
 - The `inline` and `window` UI has been completely revamped. The old UI can still be used by using the deprecated views. If you wish to retain the old UI when updating you need to:
+
   - Add `<DeprecatedView />` as `<CustomView />` to the client.
 
-      ```
-      import { DeprecatedView } from '@seamly/web-ui'
+    ```
+    import { DeprecatedView } from '@seamly/web-ui'
 
-      const config = {
-        customComponents: {
-          view: DeprecatedView,
-        }
+    const config = {
+      customComponents: {
+        view: DeprecatedView,
       }
-      ```
+    }
+    ```
 
   - Add deprecated stylesheet and remove the default stylesheet:
 
@@ -155,9 +202,10 @@ The old UI has been deprecated and will be removed in a future version. New impl
       isDeprecated: true,
     })
     ```
+
 - To mark the conversation's connection as ready we used to watch for a message of type `join_conversation_succeeded`, but this has been changed to type `attach_channel_succeeded`. If you depend on messages of type `join_conversation_succeeded` you should switch over to the new type.
 - Replace `defaults.startChatIcon`, `defaults.agentName`, `defaults.agentIcon` in config, with server-side equivalents.
-- Replace `defaults.userName`  with a translation label, allowing per language labels.
+- Replace `defaults.userName` with a translation label, allowing per language labels.
 
 ## 19.1.6 (14 September 2022)
 
@@ -168,11 +216,13 @@ The old UI has been deprecated and will be removed in a future version. New impl
 ## 19.1.5 (17 August 2022)
 
 ### Bugfixes
+
 - Fix an issue where the interface would not be translated when translation had started before the user had sent a message.
 
 ## 19.1.4 (16 February 2022)
 
 ### Bug fixes
+
 - Fix deep merging of `defaults` key in config when supplied by both implementation and in `init`.
 - Fix carousel sliding in Safari
 - Fix the aria-label of a slide to use the correct index
@@ -182,25 +232,32 @@ The old UI has been deprecated and will be removed in a future version. New impl
 ## 19.1.3 (16 February 2022)
 
 ### Changes
+
 - Extended and improved data of `errorCallback`.
 
 ## 19.1.2 (26 January 2022)
 
 ### Bug fixes
+
 - Fix open/close state in styleguide for window layoutMode.
 
 ## 19.1.0 (11 January 2022)
+
 ### Changes
+
 - Added an option to monitor errors by passing `errorCallback` to the config.
 
 ### Bug fixes
+
 - Do not display user input as Markdown or Mustache to prevent potential XSS attacks.
 - Add translation dividers to styleguide
 - Add all error types to styleguide
 - Show time-indicators in styleguide
 
 ## 19.0.0 (19 December 2021)
+
 ### Breaking Changes
+
 - Translation files will be loaded from the back-end and can be managed there. Translations will no longer be provided in this package.
 - `setLocale` window API call has been removed. The locale can only be set at initialisation of a conversation.
 - `setTranslation` now also triggers a translation of the UI
@@ -208,6 +265,7 @@ The old UI has been deprecated and will be removed in a future version. New impl
 - The default locale for a conversation is provided by the server, but can be overridden through `config.context.locale` during `init`.
 
 ### Changes
+
 - Provide representative demo images for card and image messages to be used in styleguides.
 - Increase inline window size. This also changes some of the Sass variables.
 - Determination of `userResponded` has been moved to the server. This also means the key `userResponded` in the Storage is no longer available. If you need to know the state on startup you can use the appstate parameter on the `ui.start` or `ui.beforeStart` events.
@@ -217,14 +275,19 @@ The old UI has been deprecated and will be removed in a future version. New impl
 - The locale for translations of the UI can now be changed to a different locale dynamically
 
 ## 18.3.1 (22 November 2021)
+
 ### Changes
+
 - Add class for styling to the `activity-monitor` div.
 
 ## 18.3.0 (20 October 2021)
+
 ### Changes
+
 - Improve entering send_transcript e-mail on mobile and desktop. Especially in combination with autocomplete on mobile.
 
 ### Bug fixes
+
 - Time indicators are properly shown before user messages.
 - Links in messages by users in the default UI are now legible.
 - Fix options dialog `max-height` issue to make implementations easier.
@@ -233,21 +296,28 @@ The old UI has been deprecated and will be removed in a future version. New impl
 - Make card description element a `div` instead of `p` to prevent invalid HTML nesting.
 
 ## 18.2.0 (17 September 2021)
+
 ### Changes
+
 - Add default `secondary` category to be used with choice prompts
 - ChoicePrompt `<li>`'s now have an additional class based on the choice category to aid styling of choices in client implementations
 - Process card descriptions as markdown
 - Don't process cta descriptions as Mustache templates as we won't ever have any variables
 
 ### Bug fixes
+
 - Remove redundant img alt attribute in cards
 
 ## 18.1.1 (9 September 2021)
+
 ### Bug fixes
+
 - Fix translation menu automatically closing on focus-out by removing the close-on-focus-out from the Translations-Dialog.
 
 ## 18.1.0 (8 September 2021)
+
 ### Changes
+
 - Add Carousel message type
 - Add Card message type, the following three card types can be rendered:
   - `ask` which contains a cta that sends a question into the conversation.
@@ -255,10 +325,13 @@ The old UI has been deprecated and will be removed in a future version. New impl
   - `topic` which contains a cta that sets the topic of the conversation.
 
 ### Bug fixes
+
 - Make uploads show correctly as not-deleted if they are still available.
 
 ## 18.0.0 (30 August 2021)
+
 ### Changes
+
 - Added `Automatic Translation` feature to support live machine translations.
 - Added `setTranslation` added to the window API (only works if the feature is enabled in the account).
 - Added `@seamly/web-ui/index.debug` as a drop-in replacement for `@seamly/web-ui` to enable debug tools in client implementations
@@ -267,9 +340,11 @@ The old UI has been deprecated and will be removed in a future version. New impl
 - Exported `useTranslations`, `useTranslatedEventData` and `useTranslationsContainer` for usage in client implementations
 
 ### Breaking changes
+
 - `useChoicePrompt` now requires the full event as a parameter instead of `event.payload`
 - Drop support for IE11
 - `useTranslation` is renamed to `useI18n` and exports a name function (`t`).
+
 ```
 // v17.x
 import useTranslation from '@seamly/web-ui`
@@ -281,7 +356,9 @@ import useI18n from '@seamly/web-ui'
 
 const { t } = useI18n()
 ```
+
 - Translation files now use a flattened structure and should be updated.
+
 ```
 // config.js v17.x
 import nlInformal from '@seamly/web-ui/translations/nl-informal'
@@ -313,31 +390,41 @@ const translations = {
 ```
 
 ### Bug fixes
-* Fix timing issue between clearing entry and changing entry type based on incoming messages.
-* Fix issue in i18n where default object for overrides was provided, but tested against undefined instead of keys.length
+
+- Fix timing issue between clearing entry and changing entry type based on incoming messages.
+- Fix issue in i18n where default object for overrides was provided, but tested against undefined instead of keys.length
 
 ## 17.2.0 (3 august 2021)
+
 ### Changes
+
 - Added app state information to `ui.beforeStart`, `ui.start` and `ui.visiblity` window.api events. App state contains `hasResponded`, `hasConversation`, `visiblity` and `unreadMessagecount`.
 - Always show time indicator at beginning of conversation when enabled.
 - Always show username/agent name when it is preceded by a time indicator.
 
 ## 17.1.1 (13 july 2021)
+
 ### Bug fixes
+
 - Expose `useSeamlyConfig` & `useSeamlyVisibility` hooks for customer implementations.
 
 ## 17.1.0 (29 june 2021)
+
 ### Changes
+
 - Replace default `api.*.seamly.ai` domains with `api.*.seamly-app.com`.
 - Minor dependency updates
 
 ### Bug fixes
+
 - Replace all `/` used for division in SCSS files with fractions. The `/` for division is being deprecated by Sass, as it is technically a seperator in CSS. In future, it will be either `calc()`, `math.div()` or we can use a fraction.
 - Info messages no longer disable choice prompts
 - Server-side triggered idle-timer elapse no longer doubly triggers detach-service action
 
 ## 17.0.0 (7 june 2021)
+
 ### Breaking changes
+
 - The `system.service_changed` event has been renamed to `system.systemChanged`.
 - For file uploads the following translation keys have been affected and should be changed if overrides or nonstandard translations are used:
   - `srMessageIconText` has been removed.
@@ -345,6 +432,7 @@ const translations = {
   - Keys `srFileUploadedText` and `srFileDownloadText` have been added.
 
 ### Changes
+
 - File download messages without a `url` value are now supported and rendered correctly.
 - Authenticate all conversation requests
 - Now hides all chat content from being shown in the Google Search result snippet by applying the `data-nosnippet` attribute.
@@ -354,20 +442,27 @@ const translations = {
 - Add pre-built `@seamly/web-ui/styles.css` to the package exports.
 
 ### Bug fixes
+
 - Remove `cvco-false` class from the options toggle button.
 - The style guide will no longer display duplicate Preact key console errors.
 - Load scss imports from `node_modules` without deprecated `~`.
 
 ## 16.0.7 (18 may 2021)
+
 ### Bug fixes
+
 - Add missing styling for time indicators.
 
 ## 16.0.6 (12 may 2021)
+
 ### Bug fixes
+
 - Add optional chaining to prevent error in time indicator display when locale doesn't match.
 
 ## 16.0.5 (11 may 2021)
+
 ### Bug fixes
+
 - Export the following exports from the package as required by client implementations to enable upgrade to v16:
   - `useSeamlyCommands`
   - `useSeamlyIdleDetachCountdown`
@@ -384,24 +479,34 @@ const translations = {
   - `Interrupt`
 
 ## 16.0.4 (10 may 2021)
+
 ### Bug fixes
+
 - Export `useSeamlyEvents` as `useEvents` for the package
 
 ## 16.0.3 (10 may 2021)
+
 ### Bug fixes
+
 - Fix FAQ overflow on mobile screens with low height (especially an issue when the keyboard is open on Android)
 - Fix image modal not expanding to full height in the inline layoutmode
 
 ## 16.0.2 (4 may 2021)
+
 ### Bug fixes
+
 - Also export `useSeamlyChat` hook from the package.
 
 ## 16.0.1 (22 april 2021)
+
 ### Bug fixes
+
 - Properly export all package files so you can use exports like `@seamly/web-ui/storage`
 
 ## 16.0.0 (20 april 2021)
+
 ### Changes
+
 - Remove loading of `@include-media` in `index.scss` as this is now loaded through the `Web UI`.
 - `FAQ` is now part of `Web UI` and can be deactivated with the `showFaq` setting in the configuration.
 - An `action.click_cta` is now broadcast via the external api when the to action is clicked in a CTA message.
@@ -414,6 +519,7 @@ const translations = {
 - All HTML buttons are now explicitly typed and safe for use inside wrapping forms (mainly classic ASP.NET applications).
 
 ### Breaking changes
+
 - Regardless of whether `FAQ` is activated in `Web UI` or not, the main application is now wrapped in class `cvco-app-wrapper` which reguires styling adjustment in all implementations.
 - All implementations already containing `FAQ` should migrate to the internal implementation. This is mostly the removal of the flex styling on certain breakpoints, and making sure `position: absolute` is possible on the `faqs`.
 - All direct references to `@seamly/web-ui/src/javascript/*` must be updated to reflect the new exports at `@seamly/web-ui`
@@ -421,18 +527,24 @@ const translations = {
 - `preact` is now a peerDependency and must be included from the implementation
 
 ### Bug fixes
+
 - Don't render the skip link when minimized. This fixes the issue where you could focus the skip-link when only the button was visible.
 
 ## 15.0.1 (11 March 2021)
+
 ### Changes
+
 - `@babel/plugin-transform-react-jsx` now supports automatic transpilation of JSX without the need to import `preact`, `preact.h` or `preact.Fragment`.
 
 ### Breaking changes
+
 - Implementations must upgrade to Preact 10.5.12
 - Implementation must update the **Babel** configuration for `@babel/plugin-transform-react-jsx` to `{ runtime: 'automatic', importSource: 'preact' }` in order to support automatic transpilation.
 
 ## 15.0.0 (11 March 2021)
+
 ### Changes
+
 - Options, options dialogues, the upload button, as well as the Seamly modal version can now be animated with the same standard transition classes.
 - Add configurable z-index for implementations via config.
 - Add `overscroll-behaviour: contain` to windowed chat so scrolling a windowed chat will not automatically scroll the whole page when the user has reached the bottom of the chat.
@@ -440,24 +552,33 @@ const translations = {
 - Remove cog icon when just one specific option is shown in the bottom bar. Also add classes so the entry can be styled.
 
 ### Breaking changes
+
 - Implementations with options need to update the hide/show of the options menu, and the upload button to use the new transition classes.
 
 ### Bug fixes
+
 - Fix double rendering of upload bubbles on socket reconnect.
 
 ## 14.0.2 (12 February 2021)
+
 ### Changes
+
 - Send transcript button now has it's own translation and explicitly says `Send`.
 
 ### Bug fixes
+
 - Fix typo in `de-informal` translations.
 
 ## 14.0.1 (10 February 2021)
+
 ### Bugfixes
+
 - Transcript email validation now also allows capital letters.
 
 ## 14.0.0 (27 January 2021)
+
 ### Changes
+
 - Build all translations as UJS modules and expose them in the NPM package in `@seamly/web-ui/dist/translations/*`.
 - Use `description` field for rich text in CTA messages.
 - Add `fileUpload.errors.virusFound` translation to indicate an uploaded file contains an unsafe file.
@@ -469,6 +590,7 @@ const translations = {
 - The current agent name is passed to the resume conversation prompt translation.
 
 ### Breaking changes
+
 - Update the `marked` depdendency to 0.8.2, this fixes multiple security issue. Unfortunately this means implementations need to process `marked` by babel as it exports ES6
 - Upgrade webpack to v5. Implementations now have to upgrade to webpack 5 too. Things that need changing:
   - Update `webpack.config.js` to work with Webpack 5
@@ -486,11 +608,14 @@ const translations = {
 - The file upload button will now only show when uploads are available. This may affect the display of the entry container in implementations. Styling needs to be adapted.
 
 ## 13.0.0 (9 December 2020)
+
 ### Changes
+
 - The entry component can now be set via the `entry` property on messages. Currently this is available for `upload` entry types but this can be extended via the same mechanism for all entry types where required.
 - Validations loaded on entry components can also now be adjusted via server message inside the `entry` property as per the previous point.
 
 ### Breaking changes
+
 - The import path for `EntryContainer` has changed to `@seamly/web-ui/src/javascripts/ui/components/entry/entry_container`. This should be adjusted in all custom views.
 - The structure of the entry block has been changed. All custom views should update the JSX declaration:
 
@@ -505,40 +630,51 @@ const translations = {
 
 <EntryContainer />
 ```
+
 - As the entry block has been closed in JSX, custom implementations of the `Entry` component should now use the standard `customComponents` interface in the configuration as described in the documentation.
 - Any custom implementations of `Entry` will need to be recoded to follow the new structure in `Seamly Web UI`.
 - All implementations using the src from the `@seamly/web-ui` package should transpile the `phoenix` package to ES5 if IE11 support is required. If you use webpack, you should make sure `node_modules/phoenix` is not excluded from transpilation in webpack.config.js.
 
 ### Bugfixes
+
 - An edge case existed in the forms system where form element components could re-initialize if the upper application state changed thereby losing preloaded forms data. This has been fixed.
 - Fixed NL translation typo in the screen reader text of a configuration error.
 - The package now uses the source Phoenix file as the dist file contains JavaScript that violates the `unsafe-eval` CSP policy.
 - Send Content-Type header on POST requests to get config and to create a new conversation.
 
 ## 12.4.0 (27 November 2020)
+
 ### Changes
+
 - Send timezone information to server if it can be determined (only works in modern browsers)
 - Export new ViewWithFaq to use in implementations that use the bundled javascript.
 - Add support for file uploads without a deleteAt.
 
 ## 12.3.0 (19 November 2020)
+
 ### Changes
+
 - Add support for file upload messages from agents.
 - Add support for securely downloading uploaded files.
 - Clearly mark expired file upload links as such.
 
 ## 12.2.0 (17 November 2020)
+
 ### Changes
+
 - Add new `api.externalId` configuration option to persist conversations when messaging is enabled.
 - Add new `ResumeConversationPrompt` to ask users to continue or restart a conversation after returning to if after a while (when using messaging).
 
 ### Bug fixes
+
 - Always remove loader when initial events arrive from the server.
 - To avoid multiple instances sending events via the same event bus instance a unique event bus is now used for each chat instance.
 - Don't break on missing activeServiceSettings from a history call.
 
 ## 12.1.0 (9 November 2020)
+
 ### Changes
+
 - The character limit is visible 50 characters before the limit will be reached instead of the previous 25 characters.
 - History synchronisation with the server is now only performed when it results in new history.
 - The `Privacy Disclaimer` is now shown at the top of the chat window and scrolls away.
@@ -546,6 +682,7 @@ const translations = {
 - Add `appStorageProvider` with support for iOS, Android and React Native. This makes integration with those platform work out of the box (if implemented correctly on the app side).
 
 ### Bug fixes
+
 - In the Spanish language file, the `srStopCobrowsingText` language key has been repaired.
 - All event sorting is now based on the `occurredAt` timestamp on events. This ensures proper merging of history and current event streams in all cases.
 - Client side message again have the ID set properly from the server ACKs.
@@ -553,10 +690,13 @@ const translations = {
 - Add missing documentation for storage providers.
 
 ### Breaking changes
+
 - Hook `useSeamlyDisclaimerDelayedClose` no longer exists. Implementations with a custom `Entry` component should remove this.
 
 ## 12.0.0 (25 September 2020)
+
 ### Breaking changes
+
 - Hook `useSeamlyContainerClassNames` has been renamed to `useSeamlyMessageContainerClassNames`.
 - Chat bubbles are no longer full width. Most client implementations do not use this full width, so needed escaping every time. For clients who do have full width bubbles this needs checking.
 - The `api.defaults` configuration option has been moved to `context` on the main configuration level. Within this configuration object any usages of `meta` or `settingsProfile` should be removed if still present in implementations as these are dead options.
@@ -570,6 +710,7 @@ const translations = {
 - Split `useText` component hooks in to `useTextRendering` and `useEventLinkClickHandler`. Any custom text message components should now use these hooks instead of the `useText` hook.
 
 ### Changes
+
 - Add two `on` events to the window API for the idle detach warning: `'idleTimer.selectContinue` is sent when the user clicks on the `Continue coversation` button and `idleTimer.selectEnd` is sent when the user clicks on the `End conversation` button.
 - Do not show disabled option checkboxes.
 - Improve icon accessibility.
@@ -580,41 +721,53 @@ const translations = {
 - Add Call to Action (CTA) message type.
 
 ### Bug fixes
+
 - The participant displayed information is now cleared after an interrupt restart.
 - Fix duplicate rendering of accessiblity text in image messages.
 - Fix modification of the `body` data of messages when rendering them as rich text.
 - Fix issue with socket reconnects that would result in messages appearing at the start of the chat
 
 ## 11.1.0 (30 July 2020)
+
 ### Bug fixes
+
 - Fix history fetching when file uploads are disabled
 
 ### Changes
+
 - Clear waiting actions when destroying an instance
 
 ## 11.0.0 (29 July 2020)
+
 ### Bug fixes
+
 - Focus outline will now always show, also in browsers with `:focus-visible` activated.
 - Focus input when user clicked the restart button in the error interrupt.
 - Hide cobrowsing bar, options and options toggle button when the UI is minimized
 
 ### Breaking changes
--  Implementations with custom `Entry`, `ChatFrame` or `EntryContainer` components should re-align the implementations of these components to that inside Seamly UI in order to support `File uploads` and function with the adjusted `Multi Forms Data Engine` inside Seamly UI.
+
+- Implementations with custom `Entry`, `ChatFrame` or `EntryContainer` components should re-align the implementations of these components to that inside Seamly UI in order to support `File uploads` and function with the adjusted `Multi Forms Data Engine` inside Seamly UI.
 - Classname for the icon in the lightbox/modal has been changed. From `cvco-model__icon` to `cvco-icon` to be consistent with all other icons.
 - All icons are now outlined, so any implementations that use `stroke` in the css (for instance to change color or width) should be fixed to use `fill` instead. Implementations that target specific parts of any `svg` will need tweaking, because all icons are now compound shapes (as few different paths as possible).
 
 ### Changes
+
 - The `Forms Data Engine` inside Seamly UI now supports multiple forms as well as the persistence of forms data.
 - The `Forms Engine` now supports validation.
 - `File uploads` are now supported in Seamly UI if the account configuration and service supports it.
 - An `aria-live` window API event has been added for testing the main `ARIA Live region` in Seamly UI. Any texts added to this live region will be broadcast via this event.
 
 ## 10.0.1 (7 July 2020)
+
 ### Bug fixes
+
 - Export `useEntry` again (as `useInput` used to be exported).
 
 ## 10.0.0 (3 July 2020)
+
 ### Changes
+
 - When the idle detach warning countdown starts the `idleTimer.start` window API event gets called and when the timer stops, the `idleTimer.stop` event.
 - Add `sendCustomAction` action to the window API.
 - Add generic Form engine for easier form handling and future extensibility for validation.
@@ -622,31 +775,41 @@ const translations = {
 - Introduce option for screensharing. This will also activate the screensharing warning when enabled.
 
 ### Breaking changes
+
 - The idle detach warning now displays the countdown as minutes and seconds. This will need styling changes in the implementation on upgrade.
 - `Input` component has been replaced with a more generic `Entry` component. This is a drop-in replacement.
 - Rename package to `@seamly/web-ui`. Updage your package.json files accordingly. Versioning will continue.
 
 ## 9.3.0 (23 June 2020)
+
 ### Changes
+
 - FAQ click also sets `userResponded` to true
 
 ## 9.2.0 (16 June 2020)
+
 ### Changes
+
 - Add the `appContainerClassName` configuration option to set custom class names on the container element.
 - Add new ui.inputFocus event callback that is triggered whenever the input field gets focus.
 - Emit faq question with `faqclick` custom action on click to aid implementations who need the faq question.
 - The external API now support fetching the current visibility state with the `getVisibility` action.
 
 ## 9.1.0 (5 June 2020)
+
 ### Changes
+
 - Removed custom focus styles on disclaimer close, modal enlarge, modal close, input etc. These get in the way when doing custom styling for clients. Remove any CSS that escapes this now removed styling.
 - Expired chats no longer show an interrupt screen but automatically restarts. The `sessionExpired` error key can be removed from all custom language files.
 
 ### Breaking changes
+
 - Chat now starts at the bottom of the window container. This severely improves visibility of initial chat messages in smaller views. This adds an extra container div. Test if scrolling/window visibility is still ok after updating.
 
 ## 9.0.0 (19 May 2020)
+
 ### Changes
+
 - Depending on server configuration, send user typed text to the Seamly server periodically.
 - Prefetch api configuration prior to chat start.
 - Prefetch initial chat state prior to chat start.
@@ -659,25 +822,33 @@ const translations = {
 - Sanitize user input from any executable HTML.
 
 ### Breaking changes
+
 - Migrate the UI to version 2 of the Seamly API.
 - The exported Seamly function no longer returns an API
 - You need to explicitly `init` an instance to start it
 - The adjacent sibling combinator (`+`) has been removed in favour of the `cvco-conversation__item--new-participant` class on messages. Many implementations have either classes that override this default styling, or are using the adjacent sibling combinator themselves. This will need checking and potentially fixes on update.
 
 ## 8.1.0 (24 April 2020)
+
 ### Changes
+
 - FAQ events will now be persisted over application reloads and only be cleared when intended by the Seamly server.
 
 ## 8.0.1 (6 April 2020)
+
 ### Bug fixes
+
 - Repair text input labelling.
 
 ## 8.0.0 (6 April 2020)
+
 ### Changes
+
 - The default FAQ component has been adjusted to handle more implementation requirements. Refer to `faq.md` for the latest API.
 - An Idle Detach Warning will be shown if the user is connected to a live agent, inactive for a set amount of time and the server configuration allows for this.
 
 ### Breaking changes
+
 - The form element component used inside the view should now be wrapped inside a new `<EntryContainer>` component. All custom implementation should upgrade the custom view with this component:
 
 ```jsx harmony
@@ -692,19 +863,25 @@ const translations = {
 - Any usages of the hook `useInputFocusing` should be refactored to `useSkiplinkTargetFocusing`.
 
 ## 7.1.0 (26 March 2020)
+
 ### Bug fixes
+
 - FAQ's selections will now show in history as the original event ID is now passed to the FAQ click action.
 - Image and video elements will now also show the event participant, when appropriate.
 
 ### Changes
+
 - The current active participant will show as event participant on the chat loader bubble, when appropriate.
 
 ## 7.0.0 (12 March 2020)
+
 ### Bug fixes
+
 - Avoid empty introductions from overwriting existing avatar intros.
 - Update avatar in button/header to show initial state / active agent avatar.
 
 ### Changes
+
 - Display `info` messages in the chat windo when they are sent via the websocket.
 - Upgrade Preact to v10.3.3. It is recommended to upgrade custom implementations to this version of Preact as well.
 - The configuration object has been expanded with a new `defaults` object:
@@ -723,6 +900,7 @@ userName: 'You',
 - A default agent icon can be set using the `agentIcon` setting found in the new `defaults` object in the configuration object.
 
 ### Breaking Changes
+
 - Any custom implementations using `component overrides` should migrate to the `ComponentProvider` component instead. Passing custom components to the `Conversation` component is no longer supported and will be ignored.
 - The container classes are no longer exposed as `containerClassNames` by the internal component hooks. Any view components relying on this should import the new `useSeamlyContainerClassNames` hook to resolve the same classes.
 - The `choose again` divider will no longer render in history if used with a version of the server API that does not support info messages.
@@ -733,59 +911,77 @@ userName: 'You',
 - Any implementations relying on a `user defaultName` of `You` coming from the Seamly client itself, needs to implement this with the `userName` setting.
 
 ## 6.2.0 (3 March 2020)
+
 ### Changes
+
 - Upgrade Preact to v10.3.2. It is recommended to upgrade custom implementations to this version of Preact as well.
 
 ### Bug fixes
+
 - Avoid empty introductions from overwriting existing avatar intros.
 - Fixed race condition that sometimes caused a double connect of the chat client.
 
 ## 6.1.0 (17 February 2020)
+
 ### Changes
+
 - Allow links to open in new tabs via server configuration.
 
 ### Other
+
 - Fix image opening in lightbox after previous server change.
 
 ## 6.0.0 (17 February 2020)
+
 ### Bug fixes
+
 - Choice Prompts with prompts other than type="text" now displays properly.
 
 ### Changes
+
 - Custom `Text`, `Video` and `Image` components now implement a `descriptorId` prop as `id` to decorate description containers.
 
 ### Breaking Changes
+
 - Custom ChoicePrompt components should now allow for custom prompt component injection via the `children` prop.
 - Custom Text components should no longer use a `textBodyId` prop to decorate the text container via `id` but instead implement a `descriptorId` prop.
 
 ## 5.1.1 (12 February 2020)
 
 ### Bug fixes
+
 - Fix misalignment of balloon agent icon.
 
 ## 5.1.0 (7 February 2020)
 
 ### Changes
+
 - Expose new action events for `action.pick_choice`, `action.navigate` and `action.custom`.
 
 ## 5.0.2 (31 January 2020)
 
 ### Bug fixes
+
 - Properly build and release Dutch I18N text for Choose Again.
 
 ## 5.0.1 (31 January 2020)
 
 ### Changes
+
 - Adjust default Dutch I18N text for Choose Again.
 
 ## 5.0.0 (29 January 2020)
+
 ### New features
+
 - Enable choose again of choice prompt values.
 
 ### Bug fixes
+
 - Repair semantics of the Choice Prompt list.
 
 ### Breaking Changes
+
 - When services are setup to allow `Choose Again` of `Choice Prompts`, a choose again button will now be shown in the chat interface. New topic dividers will also be shown after choosing again. Styling should be adjusted to allow for this in implementations.
 - `Choice Prompts` will be rendered as a `<ul>` instead of `<div>`. Styling should be adjusted in implementations.
 - To align divider views the class postfix `divider__icon` in the `Participant` component has been adjusted to `divider__graphic`. Styling should be adjusted in implementations.