@sinequa/atomic-angular 1.17.0 → 2.1.0

package/README.md

@@ -1,244 +1,249 @@
-# @sinequa/atomic-angular
-
-[![npm version](https://img.shields.io/npm/v/@sinequa/atomic-angular.svg)](https://npm.sinequa.com/@sinequa/atomic-angular)
-[![Angular](https://img.shields.io/badge/Angular-v20-red.svg)](https://angular.dev)
-[![TypeScript](https://img.shields.io/badge/TypeScript-5.7-blue.svg)](https://www.typescriptlang.org/)
-
-> A comprehensive Angular component library and design system 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.
-
-## Installation
-
-```bash
-npm install @sinequa/atomic-angular
-```
-
-### Peer Dependencies
-
-```json
-{
-  "@angular/common": "^20.0.0",
-  "@angular/core": "^20.0.0",
-  "rxjs": "^7.8.0"
-}
-```
-
-> ℹ️ The peer dependency above targets the **1.x** line (Angular 20). For the Angular 22
-> line, see the compatibility table below.
-
-## Versioning & Compatibility
-
-`@sinequa/atomic-angular` is maintained across several **parallel version lines**, each
-pinned to an Angular major and consumed by a specific product release. Pick the line that
-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` |
-
-**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.
-- 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.
-
-> Maintainers: the branching and propagation process is documented in
-> [`HOTFIX.md`](https://github.com/Product/sba-atomic-angular/blob/develop/HOTFIX.md).
-
-## Features
-
-### 🔐 Authentication & Authorization
-
-- Complete authentication flows with SSO support
-- Password management (expiry, forgotten, change)
-- Route guards and access control
-- Multi-language support (EN, FR, DE)
-
-### 🔍 Advanced Search
-
-- Powerful filter system with aggregations
-- "Did You Mean" suggestions and autocomplete
-- Recent and saved searches
-- Bookmark and collection management
-- Document preview and navigation
-- Export functionality
-
-### 🛠️ Developer Experience
-
-- **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
-
-## Package Structure
-
-### @sinequa/atomic-angular
-
-```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
-
-### Core Components
-
-- `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
-
-- `SignInFormComponent` - User sign-in
-- `ChangePasswordFormComponent` - Password change
-- `ForgotPasswordFormComponent` - Password recovery
-- `AuthGuard` - Route protection
-- `PasswordExpiryGuard` - Password expiry detection
-
-### Features
-
-- Alerts management
-- Bookmarks system
-- Collections management
-- Advanced search drawer
-- Export functionality
-- Feedback system
-- Labels management
-- Recent searches
-- Saved searches
-
-## API Documentation
-
-### Services
-
-```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';
-```
-
-### Guards
-
-```typescript
-import { AuthGuard, PasswordExpiryGuard } from '@sinequa/atomic-angular';
-
-const routes: Routes = [
-  {
-    path: 'search',
-    canActivate: [AuthGuard],
-    component: SearchComponent
-  },
-  {
-    path: 'profile',
-    canActivate: [AuthGuard, PasswordExpiryGuard],
-    component: ProfileComponent
-  }
-];
-```
-
-## Changelog
-
-### Recent Releases
-
-**v0.3.8** (2025-12-18)
-
-- Added chevron icon in document locator menu
-- Improved component structure
-
-**v0.3.7** (2025-12-17)  
-
-- Fixed parent selection in filters with `linkChildren`
-- Enhanced selection state management
-
-**v0.3.6** (2025-12-17)
-
-- Enhanced "Did You Mean" component styling
-- Added text truncation for long filter names
-
-**v0.3.4** (2025-12-15)
-
-- Complete password management flows
-- Added `PasswordExpiryGuard`
-
-**v0.3.0** (2025-12-09) - Major Release
-
-- New Chapsvision theme system
-- Standardized icon components
-- New `InputGroup` architecture
-- Badge API changes
-
-## Migration Guide
-
-### Migrating from 0.2.x to 0.3.0+
-
-#### Authentication
-
-```typescript
-// Before
-import { SignInComponent } from '@sinequa/atomic-angular';
-// After
-import { SignInFormComponent } from '@sinequa/atomic-angular';
-```
-
-## Browser Support
-
-- Chrome (latest)
-- Firefox (latest)
-- Safari (latest)
-- Edge (latest)
-
-## Requirements
-
-- Angular 20+
-- TypeScript 5.7+
-- Node.js 18+
-
-## License
-
-Proprietary - Copyright © 2025 Sinequa. All rights reserved.
-
-## Support
-
-- 📧 Email: [support@sinequa.com](mailto:support@sinequa.com)
-- 📚 Documentation: [sinequa.com/docs](https://sinequa.com/docs)
-- 🌐 Website: [www.sinequa.com](https://www.sinequa.com)
-
-**Built by the Sinequa Team**
+# @sinequa/atomic-angular
+
+[![npm version](https://img.shields.io/npm/v/@sinequa/atomic-angular.svg)](https://npm.sinequa.com/@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/)
+
+> A comprehensive Angular component library and design system 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.
+
+## Installation
+
+```bash
+npm install @sinequa/atomic-angular
+```
+
+### 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"
+}
+```
+
+> ℹ️ 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.
+
+> See [`ARCHITECTURE.md`](../../ARCHITECTURE.md) for how this library relates to
+> `@sinequa/galactik` (and the deprecated `@sinequa/ui`, which it no longer depends on).
+
+## Versioning & Compatibility
+
+`@sinequa/atomic-angular` is maintained across several **parallel version lines**, each
+pinned to an Angular major and consumed by a specific product release. Pick the line that
+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` |
+
+**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.
+- 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
+
+- Complete authentication flows with SSO support
+- Password management (expiry, forgotten, change)
+- Route guards and access control
+- Multi-language support (EN, FR, DE)
+
+### 🔍 Advanced Search
+
+- Powerful filter system with aggregations
+- "Did You Mean" suggestions and autocomplete
+- Recent and saved searches
+- Bookmark and collection management
+- Document preview and navigation
+- Export functionality
+
+### 🛠️ Developer Experience
+
+- **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
+
+## Package Structure
+
+### @sinequa/atomic-angular
+
+```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
+
+### Core Components
+
+- `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
+
+- `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
+
+### Features
+
+- Alerts management
+- Bookmarks system
+- Collections management
+- Advanced search
+- Export functionality
+- Feedback system
+- Labels management
+- Recent searches
+- Saved searches
+
+## API Documentation
+
+### Services
+
+```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';
+```
+
+### Guards
+
+```typescript
+import { AuthGuard, PasswordExpiryGuard } from '@sinequa/atomic-angular';
+
+const routes: Routes = [
+  {
+    path: 'search',
+    canActivate: [AuthGuard],
+    component: SearchComponent
+  },
+  {
+    path: 'profile',
+    canActivate: [AuthGuard, PasswordExpiryGuard],
+    component: ProfileComponent
+  }
+];
+```
+
+## Changelog
+
+### Recent Releases
+
+**v0.3.8** (2025-12-18)
+
+- Added chevron icon in document locator menu
+- Improved component structure
+
+**v0.3.7** (2025-12-17)
+
+- Fixed parent selection in filters with `linkChildren`
+- Enhanced selection state management
+
+**v0.3.6** (2025-12-17)
+
+- Enhanced "Did You Mean" component styling
+- Added text truncation for long filter names
+
+**v0.3.4** (2025-12-15)
+
+- Complete password management flows
+- Added `PasswordExpiryGuard`
+
+**v0.3.0** (2025-12-09) - Major Release
+
+- New Chapsvision theme system
+- Standardized icon components
+- New `InputGroup` architecture
+- Badge API changes
+
+## Migration Guide
+
+### Migrating from 0.2.x to 0.3.0+
+
+#### Authentication
+
+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.
+
+```typescript
+// Before
+{ path: 'login', component: SignInComponent }
+// After
+{ path: 'login', component: AuthPageComponent }
+```
+
+## Browser Support
+
+- Chrome (latest)
+- Firefox (latest)
+- Safari (latest)
+- Edge (latest)
+
+## Requirements
+
+- Angular 22+
+- TypeScript 6.0+
+- Node.js 22.22+
+
+## License
+
+Proprietary - Copyright © 2025 Sinequa. All rights reserved.
+
+## Support
+
+- 📧 Email: [support@sinequa.com](mailto:support@sinequa.com)
+- 📚 Documentation: [sinequa.com/docs](https://sinequa.com/docs)
+- 🌐 Website: [www.sinequa.com](https://www.sinequa.com)
+
+**Built by the Sinequa Team**

package/components/navbar-tabs/i18n/de.json

@@ -1,4 +1,6 @@
 {
+  "moreTabs": "Weitere Registerkarten",
   "result": "Ergebnis",
-  "results": "Ergebnisse"
-}
+  "results": "Ergebnisse",
+  "tabs": "Registerkarten"
+}

package/components/navbar-tabs/i18n/en.json

@@ -1,4 +1,6 @@
 {
+  "moreTabs": "More tabs",
   "result": "Result",
-  "results": "Results"
-}
+  "results": "Results",
+  "tabs": "Tabs"
+}

package/components/navbar-tabs/i18n/fr.json

@@ -1,4 +1,6 @@
 {
-    "result": "Résultat",
-    "results": "Résultats"
-}
+  "moreTabs": "Plus d'onglets",
+  "result": "Résultat",
+  "results": "Résultats",
+  "tabs": "Onglets"
+}

package/components/preview/i18n/de.json

@@ -0,0 +1,12 @@
+{
+  "documentPreview": "Dokumentenvorschau",
+  "zoomFit": "Anpassen",
+  "zoomIn": "Vergrößern",
+  "zoomOut": "Verkleinern",
+  "toggleHeader": "Dokumentdetails ein-/ausblenden",
+  "moreActions": "Weitere Aktionen",
+  "highlights": "Hervorhebungen",
+  "searchInDocument": "Im Dokument suchen",
+  "toggleAIDescription": "KI-Beschreibung anzeigen / KI-Beschreibung ausblenden",
+  "previewUnavailable": "Vorschau für diese Datei ist leider nicht verfügbar."
+}

package/components/preview/i18n/en.json

@@ -0,0 +1,12 @@
+{
+  "documentPreview": "Document preview",
+  "zoomFit": "Fit",
+  "zoomIn": "Zoom in",
+  "zoomOut": "Zoom out",
+  "toggleHeader": "Toggle document details",
+  "moreActions": "More actions",
+  "highlights": "Highlights",
+  "searchInDocument": "Search in document",
+  "toggleAIDescription": "Show AI description / Hide AI description",
+  "previewUnavailable": "Sorry, preview is not available for this file."
+}

package/components/preview/i18n/fr.json

@@ -0,0 +1,12 @@
+{
+  "documentPreview": "Prévisualisation du document",
+  "zoomFit": "Ajuster",
+  "zoomIn": "Zoomer",
+  "zoomOut": "Dézoomer",
+  "toggleHeader": "Afficher/masquer les détails du document",
+  "moreActions": "Plus d'actions",
+  "highlights": "Surlignages",
+  "searchInDocument": "Rechercher dans le document",
+  "toggleAIDescription": "Afficher la description de l'IA / Cacher la description de l'IA",
+  "previewUnavailable": "Désolé, la prévisualisation n'est pas disponible pour ce fichier."
+}

package/components/sort-selector/i18n/de.json

@@ -1,3 +1,4 @@
 {
+  "currentSort": "Sortierung: {{sort}}",
   "selectSort": "Sortierung auswählen"
 }

package/components/sort-selector/i18n/en.json

@@ -1,3 +1,4 @@
 {
+  "currentSort": "Sort: {{sort}}",
   "selectSort": "Select Sort"
 }

package/components/sort-selector/i18n/fr.json

@@ -1,3 +1,4 @@
 {
+  "currentSort": "Tri : {{sort}}",
   "selectSort": "Choisir un tri"
 }

package/components/sponsored-results/i18n/de.json

@@ -0,0 +1,3 @@
+{
+  "opensInNewWindow": "(öffnet in einem neuen Fenster)"
+}

package/components/sponsored-results/i18n/en.json

@@ -0,0 +1,3 @@
+{
+  "opensInNewWindow": "(opens in a new window)"
+}

package/components/sponsored-results/i18n/fr.json

@@ -0,0 +1,3 @@
+{
+  "opensInNewWindow": "(nouvelle fenêtre)"
+}

package/document-workspaces/i18n/de.json

@@ -92,6 +92,8 @@
     "saving": "Wird gespeichert…",
     "shareHint": "Suchen Sie eine Person, um Zugriff zu gewähren · klicken Sie auf die Rolle eines Chips, um zwischen Eigentümer und Leser zu wechseln",
     "shareLabel": "Freigeben für",
+    "tagAdded": "{tag} hinzugefügt",
+    "tagRemoved": "{tag} entfernt",
     "tagsHint": "Komma oder Enter fügt ein Tag hinzu · Rücktaste entfernt das letzte",
     "tagsLabel": "Tags",
     "tagsPlaceholder": "Tag eingeben und Komma drücken…"
@@ -218,7 +220,17 @@
   "mention": {
     "documentCount": "{count, plural, one {{count} Dokument} other {{count} Dokumente}}",
     "loadError": "Arbeitsbereiche konnten nicht geladen werden.",
-    "loading": "Wird geladen…"
+    "loading": "Wird geladen…",
+    "newWorkspace": "Neuer Arbeitsbereich",
+    "empty": "Noch kein Arbeitsbereich",
+    "noMatch": "Kein Arbeitsbereich entspricht Ihrer Suche",
+    "searchPlaceholder": "Arbeitsbereich suchen...",
+    "tabAll": "Alle",
+    "tabOwned": "Eigene",
+    "tabShared": "Geteilt",
+    "tabsLabel": "Kategorien",
+    "selectAll": "Alle auswählen",
+    "unselectAll": "Auswahl aufheben"
   },
   "format": {
     "added": "Hinzugefügt {relative}",