@sinequa/atomic-angular 2.3.0 → 2.4.1

package/README.md

@@ -1,37 +1,45 @@
 # @sinequa/atomic-angular
 
-[![npm version](https://img.shields.io/npm/v/@sinequa/atomic-angular.svg)](https://npm.sinequa.com/@sinequa/atomic-angular)
+[![npm version](https://img.shields.io/npm/v/@sinequa/atomic-angular.svg)](https://www.npmjs.com/package/@sinequa/atomic-angular)
 [![Angular](https://img.shields.io/badge/Angular-v22-red.svg)](https://angular.dev)
-[![TypeScript](https://img.shields.io/badge/TypeScript-5.7-blue.svg)](https://www.typescriptlang.org/)
+[![TypeScript](https://img.shields.io/badge/TypeScript-6.0-blue.svg)](https://www.typescriptlang.org/)
 
-> A comprehensive Angular component library and design system for building modern Sinequa search applications.
+> Angular components, features and services for building modern Sinequa search applications.
 
 ## Overview
 
-**@sinequa/atomic-angular** provides a complete set of UI components, features, and utilities for building enterprise-grade search applications powered by Sinequa. Built with Angular 20+ and modern web standards, it offers a consistent, accessible, and themeable framework with TypeScript-first development experience.
+**@sinequa/atomic-angular** provides the business layer of a Sinequa search application: sign-in
+flows, the filter system, search results, document preview, alerts, bookmarks, saved searches and
+more. Built with Angular 22, standalone components and signals, it is accessible, themeable and
+tree-shakeable. UI primitives come from [`@sinequa/galactik`](https://www.npmjs.com/package/@sinequa/galactik)
+and backend access from [`@sinequa/atomic`](https://www.npmjs.com/package/@sinequa/atomic).
 
 ## Installation
 
 ```bash
-npm install @sinequa/atomic-angular
+npm install @sinequa/atomic-angular @sinequa/galactik @sinequa/atomic
 ```
 
-### Peer Dependencies
+### Peer dependencies
 
 ```json
 {
   "@angular/core": "^22.0.0",
-  "@angular/aria": "^22.0.0",
-  "@sinequa/galactik": "^2.0.0-next.1",
-  "@sinequa/atomic": ">=2.3.0"
+  "@angular/aria": "^22.2.0",
+  "@sinequa/galactik": "^2.0.0",
+  "@sinequa/atomic": ">=2.10.0",
+  "vanilla-calendar-pro": "^3.4.0"
 }
 ```
 
-> ℹ️ The peer dependency above targets the **2.x** line (Angular 22, pre-release). For the
-> Angular 20 lines (1.x / 1.0.x), see the compatibility table below.
+`vanilla-calendar-pro` powers the date facet's range picker (import
+`@sinequa/atomic-angular/styles/calendar.css` once in your global stylesheet). Some entry points need
+extra packages, all optional: `chart.js` (`/charts`), `chartjs-chart-matrix` (`/charts/heatmap`),
+`markdown-it` and `@angular/elements` (`/workspace-elements`). Install them only if you use the
+matching feature.
 
-> See [`ARCHITECTURE.md`](../../ARCHITECTURE.md) for how this library relates to
-> `@sinequa/galactik` (and the deprecated `@sinequa/ui`, which it no longer depends on).
+> ℹ️ These peer dependencies target the **2.x** line (Angular 22). For the Angular 20 line (1.x /
+> 1.0.x), see the compatibility table below.
 
 ## Versioning & Compatibility
 
@@ -42,188 +50,340 @@ matches the Angular version embedded in your product.
 | Library line | Angular | Product release  | Status                                     | Install                              |
 | ------------ | ------- | ---------------- | ------------------------------------------ | ------------------------------------ |
 | **1.0.x**    | 20      | 11.13.0          | 🩹 Maintenance — critical & bug fixes only | `npm i @sinequa/atomic-angular@~1.0` |
-| **1.x**      | 20      | 11.14.0          | ✅ Active — fixes + new features           | `npm i @sinequa/atomic-angular@^1`   |
-| **2.x**      | 22      | _future release_ | 🚧 Upcoming — pre-release                  | `npm i @sinequa/atomic-angular@next` |
+| **1.x**      | 20      | 11.14.0          | 🩹 Maintenance — fixes (`lts` dist-tag)    | `npm i @sinequa/atomic-angular@lts`  |
+| **2.x**      | 22      | _future release_ | ✅ Current (`latest` dist-tag)             | `npm i @sinequa/atomic-angular`      |
 
 **How the lines work**
 
 - **Each line is an independent version range.** A `1.0.x` patch and a `1.x` minor are
   unrelated number spaces — upgrading within a line never crosses an Angular major.
 - **`~1.0`** keeps you on patch releases of the 11.13 line (no minor jumps).
-  **`^1`** follows the active 1.x line (patches + minors, still Angular 20).
-  **`@next` / `^2`** is the Angular 22 line, for the upcoming product release.
+  **`^1`** follows the 1.x line (still Angular 20).
+  **`lts`** follows the 1.x line. **`latest` / `^2`** is the Angular 22 line, for the upcoming product release.
 - A fix relevant to several lines is applied to each supported line independently, so you
   receive it on whichever line you track — without being forced onto a new Angular major.
 
 ## Features
 
-### 🔐 Authentication & Authorization
+### Authentication & authorization
 
-- Complete authentication flows with SSO support
-- Password management (expiry, forgotten, change)
-- Route guards and access control
+- Sign-in, forgot-password, change-password and signed-out views behind a single `AuthPageComponent`
+- SSO support and a route guard (`AuthGuard()`)
+- Session-expiry warning (`provideSessionExpiry()`)
 - Multi-language support (EN, FR, DE)
 
-### 🔍 Advanced Search
+### Search
 
-- Powerful filter system with aggregations
-- "Did You Mean" suggestions and autocomplete
-- Recent and saved searches
-- Bookmark and collection management
+- Filter system: aggregation list, tree and date facets, filters bar, applied filters, aside filters
+- "Did you mean" suggestions and autocomplete
+- Advanced search and advanced filters
+- Recent and saved searches, bookmarks, collections, labels, alerts
 - Document preview and navigation
-- Export functionality
+- Export, feedback, user settings and profile
 
-### 🛠️ Developer Experience
+### Data visualisation and workspaces
 
-- **TypeScript-first** with full type safety
-- **Standalone components** (no NgModules required)
-- **Signal-based reactivity** for better performance
-- **Modern syntax**: @if, @for, @switch control flow
-- **Tree-shakeable** for optimal bundle size
+- Heatmap, tag cloud, word cloud, aggregation charts and timeline (`/charts`)
+- Document workspaces and their custom elements (`/document-workspaces`, `/workspace-elements`)
 
-## Package Structure
+### Developer experience
 
-### @sinequa/atomic-angular
+- **TypeScript-first**, with full type safety
+- **Standalone components** (no NgModules)
+- **Signal-based** reactivity and **Signal Forms**
+- **Injectable client**: serve several Sinequa backends from one application
+  (`provideAtomicClient()`, `provideAtomicScope()`)
+- **Keyboard shortcut engine** (`KeyboardShortcutsService`, `[keyShortcut]`)
+- **Tree-shakeable** secondary entry points
 
-```bash
-components/       # Reusable UI components
-  ├── backdrop/
-  ├── document-locator/
-  ├── navbar-tabs/
-  ├── pagination/
-  └── ...
-
-features/         # Feature modules
-  ├── auth/       # Authentication flows
-  ├── filters/    # Filter system
-  ├── bookmarks/  # Bookmark management
-  ├── collections/
-  └── ...
-
-services/         # Business logic services
-stores/           # State management
-guards/           # Route guards
-pipes/            # Custom pipes
-utils/            # Utility functions
-```
-
-## Available Components
+## Entry points
 
-### Core Components
+| Entry point                                   | Content                                               |
+| --------------------------------------------- | ----------------------------------------------------- |
+| `@sinequa/atomic-angular`                     | components, features, services, stores, guards, pipes |
+| `@sinequa/atomic-angular/charts`              | `<AggregationChart>`, `<AggregationTimeline>`         |
+| `@sinequa/atomic-angular/charts/heatmap`      | canvas `<AggregationHeatmap>`                         |
+| `@sinequa/atomic-angular/document-workspaces` | document workspaces components, store and services    |
+| `@sinequa/atomic-angular/workspace-elements`  | the workspaces view as custom elements                |
 
-- `SearchInputComponent` - Advanced search input with autocomplete
-- `FiltersComponent` - Dynamic filter system
-- `PaginationComponent` - Result pagination
-- `DocumentLocatorComponent` - Document navigation
-- `PreviewComponent` - Document preview
-- `BackdropComponent` - Backdrop overlay
-- `NavbarTabsComponent` - Navigation tabs
-- `NoResultComponent` - No results display
-- `SortSelectorComponent` - Sort options selector
-
-### Authentication
+## Main building blocks
 
-- `AuthPageComponent` - Authentication page, switches between the views below
-- `SignInComponent` - User sign-in
-- `ChangePasswordComponent` - Password change
-- `ForgotPasswordComponent` - Password recovery
-- `SignedOutComponent` - Post-logout confirmation
-- `AuthGuard` - Route protection
-- `PasswordExpiryGuard` - Password expiry detection
+### Components
 
-### Features
+- `NavbarTabsComponent` — navigation tabs
+- `SortSelectorComponent` — sort options selector
+- `NoResultComponent` — no-results display
+- `DocumentLocatorComponent` — document navigation
+- `BackdropComponent` — backdrop overlay
+- `PreviewContentComponent`, `PreviewHeaderComponent`, `PreviewActionsComponent` — document preview
+- `FiltersBarComponent`, `AsideFiltersComponent`, `AppliedFiltersComponent`, `AggregationComponent`
+  — filters
 
-- Alerts management
-- Bookmarks system
-- Collections management
-- Advanced search
-- Export functionality
-- Feedback system
-- Labels management
-- Recent searches
-- Saved searches
+### Authentication
 
-## API Documentation
+- `AuthPageComponent` — switches between the views below; route `/login` and `/logout` to it
+- `SignInComponent`, `ChangePasswordComponent`, `ForgotPasswordComponent`, `SignedOutComponent`
+- `AuthGuard()` — route protection
 
-### Services
+### Services and stores
 
 ```typescript
-// ApplicationService - Core application logic
-import { ApplicationService } from '@sinequa/atomic-angular';
-
-// AggregationsService - Filter management
-import { AggregationsService } from '@sinequa/atomic-angular';
-
-// AuthService - Authentication
-import { AuthService } from '@sinequa/atomic-angular';
+import {
+  AggregationsService,
+  ApplicationService,
+  QueryService,
+} from "@sinequa/atomic-angular";
 ```
 
-### Guards
+### Route guard
 
 ```typescript
-import { AuthGuard, PasswordExpiryGuard } from '@sinequa/atomic-angular';
+import { AuthGuard } from "@sinequa/atomic-angular";
 
 const routes: Routes = [
-  {
-    path: 'search',
-    canActivate: [AuthGuard],
-    component: SearchComponent
-  },
-  {
-    path: 'profile',
-    canActivate: [AuthGuard, PasswordExpiryGuard],
-    component: ProfileComponent
-  }
+  { path: "search", canActivate: [AuthGuard()], component: SearchComponent },
+  { path: "login", component: AuthPageComponent },
+  { path: "logout", component: AuthPageComponent },
 ];
 ```
 
-## Changelog
+## Releases
+
+A summary of the changes published on each version line. Versioning follows [SemVer](https://semver.org/): a **major** version may break the API, a **minor** version
+adds backward-compatible features, a **patch** fixes bugs.
+
+### 2.x line — from 2.0.0 (Angular 22, dist-tag `latest`)
+
+**2.4.0**
+
+- Date facet: the selected radio stays checked when the options change (for example once the
+  aggregation is reloaded with the applied filter); a committed two-bound preset (`gte` / `lt`) is
+  no longer read back as a custom range; `lt` is accepted as well as `lte` for the upper bound.
+- Date facet: support for masked dates (`YYYY`, `YYYY-MM`), labelled in the active language and sent
+  with the matching `aggregation_overrides` (new `aggregationOverridesChange` output in controlled
+  mode). Requires `@sinequa/atomic` 2.10.0.
+
+**2.3.0**
+
+- New `Settings` dialog (`Settings.call({ panel })`): a side-navigation shell with three panels —
+  Account (profile, reset / override user), Appearance (theme and language) and Keyboard shortcuts.
+- ⚠️ The language picker leaves `UserProfileFormComponent` (`currentLanguage`, `changeLanguage()`
+  and the `userProfile.language` key are removed) and the standalone `UserProfile` dialog is
+  removed: use `Settings.call({ panel: "account" })`.
+
+**2.2.0**
+
+- Move to `@sinequa/atomic` 2.9.0, which renames the document-upload API to _Agent Workspace_: the
+  peer dependency becomes `@sinequa/atomic >=2.9.0` and the backend must expose
+  `api/v2/agent-workspace/*`.
+- ⚠️ The `ContainerRole` type exported by `@sinequa/atomic-angular/elements` is renamed
+  `WorkspaceRole`, and the mappers `mapContainerDocumentToWorkspaceDocument` /
+  `mapContainerToWorkspace` become `mapWireDocumentToWorkspaceDocument` /
+  `mapWireWorkspaceToWorkspace`.
+
+**2.1.0**
+
+- New optional `provideSessionExpiry()`: warns the user shortly before their session expires, then
+  notifies them once it has, with a "Sign in again" action. Texts provided in en/fr/de. Requires
+  `@sinequa/atomic` 2.8.0 or later.
+- _Document workspaces_: the workspace mention menu (`<workspace-mention>`) can be assembled from
+  pieces (search, "select all", "new workspace", tabs), in controlled mode or ready-made; new
+  attributes on `<lexiq-workspace-mention-list>`.
+
+**2.0.0** — major version, Angular 22
+
+- ⚠️ **Breaking changes**
+  - Angular 22 and `@angular/aria` `^22.2.0` are required.
+  - The native `@sinequa/atomic-angular/elements` entry point is no longer published: use
+    `@sinequa/atomic-angular/workspace-elements`.
+  - The _drawer_ family (`DrawerComponent`, `DrawerService`, `DrawerStackService`,
+    `SelectArticleOnClickDirective`, `SelectionHistoryService`…) and the `"stack"` value of
+    `SelectionStrategy` are removed: use `[selectArticle]` and
+    `SelectionService.setCurrentArticle()`.
+  - The date facet's custom-range dialog follows the `createCallable` pattern:
+    `await AggregationDateRange.call({ min, max, lang })` replaces
+    `<aggregation-date-range-dialog>`. It is now built on `vanilla-calendar-pro` (peer dependency
+    `^3.4.0`, stylesheet `@sinequa/atomic-angular/styles/calendar.css` to import).
+  - `AlertDialog` is rebuilt on Signal Forms (the `Alert.Days` bitfield becomes seven booleans); its
+    public API changes.
+  - `@sinequa/galactik` icons are re-exported from the main barrel (`@sinequa/galactik/icons` no
+    longer exists).
+- **New**
+  - Data visualisation: `<Heatmap>`, `<TagCloud>`, `<WordCloud>` and, from
+    `@sinequa/atomic-angular/charts`, `<AggregationChart>` and `<AggregationTimeline>` (`chart.js`
+    as an optional peer dependency); canvas `<AggregationHeatmap>` from
+    `@sinequa/atomic-angular/charts/heatmap`.
+  - Document workspaces: `@sinequa/atomic-angular/document-workspaces` and `workspace-elements`
+    entry points (custom elements `<lexiq-workspaces>`, `<lexiq-workspace-picker>`,
+    `<lexiq-workspace-mention-list>`, ready-to-use stylesheet).
+  - Keyboard shortcut engine: `KeyboardShortcutsService`, the `[keyShortcut]` directive and a help
+    dialog, independent of the keyboard layout.
+  - `AdvancedSearchTabs`: an accessible tabbed alternative to `AdvancedSearch`.
+  - Injectable client: `ATOMIC_CLIENT`, `provideAtomicClient()`, `provideAtomicScope()` — serve
+    several Sinequa backends from one application. Services and stores go through this client;
+    `provideAtomicNotifications()` replaces `toastInterceptorFn`. The five HTTP interceptors stay
+    functional but are **deprecated**.
+  - `ui-language` follows the language the user picked, on every request.
+  - Facets: `itemDescription` input, `hideWhenEmpty` (`<Aggregation>`, `<aside-filters>`, `<more>`,
+    `<more-button>`), `collapsible` / `collapsed` on `<aside-filters>`.
+  - `ConverterSelectComponent`, `FaIconComponent`, `focusWhenReady()`, `tabIndex` on
+    `bookmark-button`.
+  - Accessibility: keyboard-usable filter bar and lists, named lists, named date-filter radio
+    group, translated labels (fr/de), `ArticleEntitiesTab` as a real accessible tree
+    (`@angular/aria/tree`), keyboard navigation across facet headers.
+  - Authentication views rebuilt as real forms (password-manager support, per-field validation).
+  - `SearchBar` / `SearchInput` no longer claim a global shortcut by default (`hotkey` is
+    undefined).
+
+### 1.x line — from 1.1.x to 1.18.0 (Angular 20, dist-tag `lts`)
+
+Last published version: **`@sinequa/atomic-angular` 1.18.0**. The 1.x line follows bug fixes and
+backward-compatible improvements; major new features are developed on 2.x.
+
+**1.18.0**
+
+- Date facet: the selected radio stays checked when the options change, a committed two-bound
+  preset (`gte` / `lt`) is recognised, `lt` is accepted as well as `lte`. Blank labels for masked
+  date values are fixed in `@sinequa/atomic`.
+- ⚠️ The _workspace documents_ / _upload documents_ components
+  (`@sinequa/atomic-angular/document-workspaces`) and the `elements` and `workspace-elements` entry
+  points are removed from the 1.x line. They remain available in 2.x. The optional
+  `@angular/elements` peer dependency and the `tus-js-client` dependency are dropped with them.
+
+**1.17.0**
+
+- The native `@sinequa/atomic-angular/elements` entry point is no longer published.
+- _Document workspaces_: a workspace's file list reflects the index only; the upload status popup
+  also shows uploads started by other users and stays visible for two minutes after the end of an
+  upload; reworded texts (en, fr, de, ja).
+
+**1.16.0**
+
+- _Document workspaces_: the workspace list and a workspace's document list refresh themselves in
+  the background (additions, renames, access changes, a workspace deleted by another user).
+
+**1.15.1** (bug fixes)
+
+- The buttons rendered by the aggregation components have `type="button"`, so they no longer
+  submit a surrounding `<form>` by accident.
+- _Document workspaces_: pagination ("Load more") of the workspace list, fixes to "Load more" after
+  deletions.
+
+**1.15.0**
+
+- New `@sinequa/atomic-angular/document-workspaces` entry point: the "collections" view rewritten
+  as Angular components (list, detail, sharing, upload, preview, workspace picker, chat mention
+  list) and `@sinequa/atomic-angular/workspace-elements` (custom elements). "Collection" becomes
+  "workspace".
+- `lexiq-collections` elements synchronised (document preview, principal picker, upload status
+  polling, session recovery, i18n en/fr/de/ja). Requires `@sinequa/atomic >= 2.7.0`.
+- Fixes: height of buttons with no explicit `variant`, selecting a collection with
+  `allowEmptySearch: false`, the result being updated when an empty search is skipped, alignment of
+  the custom date range fields, redundant tab tooltip, `allowSignalWrites` warning from
+  `@tanstack/angular-virtual` (updated to v6).
+
+**1.14.1** (bug fixes)
+
+- The user profile is shared between consumers (one request, updates visible everywhere).
+- A distribution facet ("Sizes", "Dates") keeps its selected state after the query reruns. Requires
+  `@sinequa/atomic` ^2.6.0.
+
+**1.14.0**
+
+- `<more-button>` adapts to its context: a bottom sheet on mobile, a modal dialog above a threshold
+  (`enrichedThreshold`), a facet search box above six filters; the popover height adapts to the
+  available space (facets scroll correctly).
+- New `lockPosition` input to pin a popover's placement.
+- Per-facet height variable fixed (`--scroll-height`).
+
+**1.13.0**
+
+- `<Aggregation>`, `<aggregation-list>`, `<aggregation-tree>`: a missing aggregation removes itself
+  from the layout; new `hideWhenEmpty` input to also hide an aggregation with no items (also on
+  `<aside-filters>`, `<more>`, `<more-button>`).
+- `<aside-filters>`: `collapsible` and `collapsed` inputs.
+- "Did you mean" relies on each term's correction action (`correction`, `expansion`, `suggestion`);
+  moved to `@sinequa/atomic` 2.5.0.
+- Fixes: the date facet's Apply / Clear buttons now match the list and tree; a `homepage: true`
+  filter always shows in the homepage filter bar; race between app bootstrap and the OAuth/SAML
+  redirect (moved to `@sinequa/atomic` 2.4.0).
+
+**1.12.0**
 
-### Recent Releases
+- New `applyOnSelect` input on `<aggregation-list>`, `<aggregation-tree>` and `<Aggregation>`.
+- Fix: a late `401` after a logout no longer sends the user back to the sign-in form.
 
-**v0.3.8** (2025-12-18)
+**1.11.0**
 
-- Added chevron icon in document locator menu
-- Improved component structure
+- New `@sinequa/atomic-angular/elements` entry point: `lexiq-collections` custom elements (requires
+  `@sinequa/atomic >= 2.2.0`).
 
-**v0.3.7** (2025-12-17)
+**1.10.0**
 
-- Fixed parent selection in filters with `linkChildren`
-- Enhanced selection state management
+- Date facet: `emitOn` input (`"selection"` by default, `"apply"` to defer emission to the Apply
+  button in controlled mode).
+- Fix: the delete button of the collections list is always visible.
 
-**v0.3.6** (2025-12-17)
+**1.9.x** (1.9.0 → 1.9.9)
 
-- Enhanced "Did You Mean" component styling
-- Added text truncation for long filter names
+- 1.9.0: `<aside-filters>`, a standalone facet list.
+- Fixes: aggregation tree selection with Enter behaves like a click, the query store is reset on
+  init (ends a leak of one user's search text to the next), navigation tabs disabled when their
+  count is zero, display and label of controlled aggregations, backend error message when a user
+  override fails, preview highlight restoration, auth guard, navigation and bootstrap race
+  conditions, long user-profile values.
 
-**v0.3.4** (2025-12-15)
+**1.8.0**
 
-- Complete password management flows
-- Added `PasswordExpiryGuard`
+- Controlled mode for `<Aggregation>` (the facet neither reads nor writes the URL): a structured
+  `Filter` is emitted alongside `selectionChange`, live emission on the date facet, an
+  `aggregationItem` template to customise a row's content, a "load more" example.
 
-**v0.3.0** (2025-12-09) - Major Release
+**1.7.x** (1.7.0 → 1.7.2)
 
-- New Chapsvision theme system
-- Standardized icon components
-- New `InputGroup` architecture
-- Badge API changes
+- `syncUrl` input to opt out of URL synchronisation of filters.
+- Fixes: `position: 'left'` filters only show in the left aside; fall back to native FontAwesome
+  markup in `FaIcon`; reach the last entity occurrence in the preview; sign-in driven by the
+  outcome of `login()`.
 
-## Migration Guide
+**1.6.x** (1.6.0 → 1.6.5)
 
-### Migrating from 0.2.x to 0.3.0+
+- Feedback: dynamic visibility and configuration.
+- Dialog to toggle feature flags live.
+- Filters persist across tabs (`navbar-tabs`).
+- Migration to the `AuthMode` authentication model, bootstrap race fixed.
+- Fixes: a signed-out view on `/logout` instead of the re-authentication loader, selecting items of
+  a multi-value filter, `basePath` prefix for the static search index.
 
-#### Authentication
+**1.5.x** (1.5.0 → 1.5.7)
 
-Route `/login` and `/logout` to `AuthPageComponent` rather than to `SignInComponent` directly — it is what switches between the sign-in, change-password, forgot-password and signed-out views.
+- Filter bar: the "more" button stays visible when filters exceed `filtersCount`, overflow is
+  recounted when item sizes or applied filters change; tabs (`navbar-tabs`) no longer truncate by
+  default, with a minimum width and an icon-only collapse; `homepage` input for the homepage filter
+  bar.
+- Fixes: alerts' `Query.filters` typing, `AppStore.getColumn` / `getColumnAlias` with non-string
+  input, source icon.
 
-```typescript
-// Before
-{ path: 'login', component: SignInComponent }
-// After
-{ path: 'login', component: AuthPageComponent }
-```
+**1.4.x** (1.4.0 → 1.4.2)
+
+- Navigation tabs react to dynamic router configuration.
+- ARIA attributes on the aggregation components.
+
+**1.3.x** (1.3.0)
+
+- New `SidebarNavComponent` (tooltip showing the tab label) and `injectRouteNavigation`.
+
+**1.2.x** (1.2.0 → 1.2.8)
+
+- New icons and improved accessibility; circular dependency fix.
+- Fixes: session storage clearing and date handling in the aggregation components, logout URL taken
+  from the challenge action, feedback translation pipe.
+
+**1.1.x** (1.1.0)
+
+- Icons in components updated to the new icon components.
 
-## Browser Support
+## Browser support
 
 - Chrome (latest)
 - Firefox (latest)