@sinequa/atomic-angular 0.0.140

package/lib/services/label.service.d.ts

@@ -0,0 +1,117 @@
+import { CCWebService, Query } from '@sinequa/atomic';
+import { Observable } from 'rxjs';
+import * as i0 from "@angular/core";
+export interface LabelsConfig {
+    allowPublicLabelsCreation?: boolean;
+    allowPublicLabelsModification?: boolean;
+    privateLabelsField?: string;
+    publicLabelsField?: string;
+    defaultPublicLabels?: string;
+    labelsAutoSuggestMaxCount?: string;
+    labelsAutoSuggestWildcard?: string;
+}
+export declare class LabelService {
+    appStore: {
+        webServices: import("@angular/core").Signal<Record<string, CCWebService>>;
+        data: import("@ngrx/signals/src/deep-signal").DeepSignal<import("@sinequa/atomic-angular").CJson>;
+        queries: import("@angular/core").Signal<Record<string, import("@sinequa/atomic").CCQuery>>;
+        customJSONs: import("@angular/core").Signal<import("@sinequa/atomic-angular").CJ[]>;
+        filters: import("@angular/core").Signal<import("@sinequa/atomic-angular").CFilter[]>;
+        sources: import("@angular/core").Signal<import("@sinequa/atomic-angular").CSources | {
+            routes?: [];
+            filters?: import("@sinequa/atomic-angular").CFilter[];
+        }>;
+        customizationJson: import("@angular/core").Signal<import("@sinequa/atomic-angular").CJson>;
+        update: (app: import("@sinequa/atomic").CCApp) => void;
+        initialize: () => Promise<void>;
+        initializeWithAppName: (appName: string) => Promise<void>;
+        getWebServiceByType: (type: CCWebService["webServiceType"]) => CCWebService | undefined;
+        getLabels: () => {
+            private: string;
+            public: string;
+        };
+        getQueryByName: (name: string) => import("@sinequa/atomic").CCQuery | undefined;
+        getQueryByIndex: (index: number) => import("@sinequa/atomic").CCQuery | undefined;
+        getDefaultQuery: () => import("@sinequa/atomic").CCQuery | undefined;
+        allowEmptySearch: (queryName: string) => boolean;
+        getNamedCustomizationJson: (name: string) => any | undefined;
+        getColumnAlias: (column: string) => string;
+        getAggregationIcon: (column: string) => string | undefined;
+        getAggregationItemsCustomization: (column: string) => import("@sinequa/atomic-angular").CFilterItem[] | undefined;
+        getAggregationCustomization: (column: string) => import("@sinequa/atomic-angular").CFilter | undefined;
+        getAuthorizedFilters: (route: import("@angular/router").ActivatedRoute) => import("@sinequa/atomic").Aggregation[];
+    } & import("@ngrx/signals").StateSignal<{
+        webServices: Record<string, CCWebService>;
+        data: import("@sinequa/atomic-angular").CJson;
+        queries: Record<string, import("@sinequa/atomic").CCQuery>;
+        customJSONs: import("@sinequa/atomic-angular").CJ[];
+    }>;
+    hasAccess: import("@angular/core").WritableSignal<boolean | undefined>;
+    /**
+     * Check user rights to verify if they can access labels handling
+     * @returns if has the rights
+     */
+    canHandleLabels(): Promise<boolean>;
+    /**
+     * Get relevant config info from the labels web service
+     * @returns the LabelsConfig or undefined if no rights
+     */
+    getLabelsConfig(): Observable<LabelsConfig | undefined>;
+    /**
+     * Fetch labels from string
+     * @param prefix the string prefix to filter with
+     * @param publicOnly whether they should be public or not
+     * @param locale optional locale filtering
+     * @returns list of label strings
+     */
+    fetch(prefix: string, publicOnly?: boolean, locale?: string): Observable<string[]>;
+    /**
+     * Add some labels to many documents
+     * @param labelsToAdd list of labels to add
+     * @param ids list of document id to add the label
+     * @param publicOnly whether the operation should be public only
+     * @returns a promise that resolves when the operation is complete
+     */
+    add(labelsToAdd: string[], ids: string[], publicOnly?: boolean): Observable<void>;
+    /**
+     * Remove some labels from many documents
+     * @param labelsToRemove list of labels to remove
+     * @param ids list of document id to add the label
+     * @param publicOnly whether the operation should be public only
+     * @returns a promise that resolves when the operation is complete
+     */
+    remove(labelsToRemove: string[], ids: string[], publicOnly?: boolean): Observable<void>;
+    /**
+     * Name some labels to a new name
+     * @param labelsToRename list of labels to rename
+     * @param newLabel the new label name
+     * @param publicOnly whether the operation should be public only
+     * @returns a promise that resolves when the operation is complete
+     */
+    rename(labelsToRename: string[], newLabel: string, publicOnly?: boolean): Observable<void>;
+    /**
+     * Delete some labels
+     * @param labelsToDelete the labels to delete
+     * @param publicOnly whether the operation should be public only
+     * @returns a promise that resolves when the operation is complete
+     */
+    delete(labelsToDelete: string[], publicOnly?: boolean): Observable<void>;
+    /**
+     * Create some labels for a query
+     * @param labelstoAdd the labels to create
+     * @param query the query object to which the labels will be added
+     * @param publicOnly whether the operation should be public only
+     * @returns a promise that resolves when the operation is complete
+     */
+    bulkAdd(labelstoAdd: string[], query: Query, publicOnly?: boolean): Observable<void>;
+    /**
+     * Delete some labels from a query
+     * @param labelsToRemove the labels to remove
+     * @param query the query object to which the labels will be removed
+     * @param publicOnly whether the operation should be public only
+     * @returns a promise that resolves when the operation is complete
+     */
+    bulkRemove(labelsToRemove: string[], query: Query, publicOnly?: boolean): Observable<void>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<LabelService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<LabelService>;
+}

package/lib/services/navigation.service.d.ts

@@ -0,0 +1,33 @@
+import { NavigationEnd } from "@angular/router";
+import * as i0 from "@angular/core";
+export declare class NavigationService {
+    private readonly router;
+    private readonly auditService;
+    urlAfterNavigation: string | null;
+    /**
+     * Observable that emits events of type `NavigationEnd` from the Angular Router.
+     *
+     * This observable performs the following operations:
+     * - Maps all router events to `RouterEvent`.
+     * - Filters the events to only include instances of `NavigationEnd`.
+     * - Taps into the event stream to extract the route name from the URL and notify the audit service of route changes,
+     *   excluding the "loading" route and duplicate navigations.
+     * - Updates the `urlAfterNavigation` property with the current URL after navigation.
+     * - Shares the replayed value with a buffer size of 1 to ensure subscribers receive the latest emitted value.
+     *
+     * @type Observable<RouterEvent>
+     */
+    navigationEnd$: import("rxjs").Observable<NavigationEnd>;
+    /**
+     * An observable that emits the tab extracted from the URL pathname or the last part of the URL.
+     *
+     * This observable listens to navigation end events and processes the URL to determine the current tab.
+     * It creates a fake URL object to extract the pathname and then uses the `getQueryParamsFromUrl` function
+     * to extract the tab from the URL pathname or defaults to the last part of the URL if no tab is found.
+     *
+     * @type Observable<string> - An observable that emits the current tab as a string.
+     */
+    path$: import("rxjs").Observable<string | undefined>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<NavigationService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<NavigationService>;
+}

package/lib/services/saved-searches.service.d.ts

@@ -0,0 +1,145 @@
+import { SavedSearch } from '../models';
+import * as i0 from "@angular/core";
+export declare class SavedSearchesService {
+    protected readonly userSettingsStore: {
+        bookmarks: import("@angular/core").Signal<import("../models").Bookmark[]>;
+        recentSearches: import("@angular/core").Signal<import("../models").RecentSearch[]>;
+        savedSearches: import("@angular/core").Signal<SavedSearch[]>;
+        assistants: import("@angular/core").Signal<Record<string, unknown>>;
+        language?: import("@angular/core").Signal<string | undefined> | undefined;
+        initialize: () => Promise<void>;
+        reset: () => Promise<void>;
+        updateBookmarks: (bookmarks: import("../models").UserSettings["bookmarks"], auditEvents?: import("@sinequa/atomic").AuditEvents) => Promise<void>;
+        bookmark: (article: import("@sinequa/atomic").Article, queryName?: string) => Promise<void>;
+        unbookmark: (id: string) => Promise<void>;
+        isBookmarked: (article: Partial<import("@sinequa/atomic").Article>) => boolean;
+        toggleBookmark: (article: import("@sinequa/atomic").Article) => Promise<void>;
+        deleteRecentSearch: (index: number) => Promise<void>;
+        updateRecentSearches: (recentSearches: import("../models").UserSettings["recentSearches"], auditEvents?: import("@sinequa/atomic").AuditEvents) => Promise<void>;
+        addCurrentSearch: (queryParams: import("@sinequa/atomic").QueryParams) => Promise<void>;
+        deleteSavedSearch: (index: number) => Promise<void>;
+        updateSavedSearches: (savedSearches: import("../models").UserSettings["savedSearches"]) => Promise<void>;
+        updateAssistantSettings: (assistantSettings: import("../models").UserSettings["assistants"]) => Promise<void>;
+        updateLanguage: (language: import("../models").UserSettings["language"], auditEvents?: import("@sinequa/atomic").AuditEvents) => Promise<void>;
+    } & import("@ngrx/signals").StateSignal<{
+        bookmarks: import("../models").Bookmark[];
+        recentSearches: import("../models").RecentSearch[];
+        savedSearches: SavedSearch[];
+        assistants: Record<string, unknown>;
+        language?: string | undefined;
+    }>;
+    protected readonly queryParamsStore: {
+        id?: import("@angular/core").Signal<string | undefined> | undefined;
+        text?: import("@angular/core").Signal<string | undefined> | undefined;
+        filters?: import("@angular/core").Signal<import("@sinequa/atomic").LegacyFilter[] | undefined> | undefined;
+        name?: import("@angular/core").Signal<string | undefined> | undefined;
+        action?: import("@angular/core").Signal<"" | "open" | "search" | "aggregate" | undefined> | undefined;
+        select?: import("@angular/core").Signal<import("@sinequa/atomic").Select[] | undefined> | undefined;
+        open?: import("@angular/core").Signal<import("@sinequa/atomic").Open[] | undefined> | undefined;
+        page?: import("@angular/core").Signal<number | undefined> | undefined;
+        pageSize?: import("@angular/core").Signal<number | undefined> | undefined;
+        tab?: import("@angular/core").Signal<string | undefined> | undefined;
+        scope?: import("@angular/core").Signal<string | undefined> | undefined;
+        sort?: import("@angular/core").Signal<string | undefined> | undefined;
+        basket?: import("@angular/core").Signal<string | undefined> | undefined;
+        isFirstPage?: import("@angular/core").Signal<boolean | undefined> | undefined;
+        strictRefine?: import("@angular/core").Signal<boolean | undefined> | undefined;
+        globalRelevance?: import("@angular/core").Signal<number | undefined> | undefined;
+        questionLanguage?: import("@angular/core").Signal<string | undefined> | undefined;
+        questionDefaultLanguage?: import("@angular/core").Signal<string | undefined> | undefined;
+        spellingCorrectionMode?: import("@angular/core").Signal<import("@sinequa/atomic").SpellingCorrectionMode | undefined> | undefined;
+        spellingCorrectionFilter?: import("@angular/core").Signal<string | undefined> | undefined;
+        documentWeight?: import("@angular/core").Signal<string | undefined> | undefined;
+        textPartWeights?: import("@angular/core").Signal<string | undefined> | undefined;
+        relevanceTransforms?: import("@angular/core").Signal<string | undefined> | undefined;
+        removeDuplicates?: import("@angular/core").Signal<boolean | undefined> | undefined;
+        queryId?: import("@angular/core").Signal<string | undefined> | undefined;
+        aggregations?: import("@angular/core").Signal<Record<string, import("@sinequa/atomic").AggregationOptions> | string[] | undefined> | undefined;
+        orderBy?: import("@angular/core").Signal<string | undefined> | undefined;
+        groupBy?: import("@angular/core").Signal<string | undefined> | undefined;
+        neuralSearch?: import("@angular/core").Signal<boolean | undefined> | undefined;
+        path?: import("@angular/core").Signal<string | undefined> | undefined;
+        setFromUrl: (url: string) => void;
+        addFilter: (filter: import("@sinequa/atomic").LegacyFilter) => void;
+        updateFilter: (filter: import("@sinequa/atomic").LegacyFilter) => void;
+        removeFilter: (field?: string) => void;
+        removeFilterByName: (name?: string) => void;
+        clearFilters: () => void;
+        patch: (params: Partial<Partial<Omit<import("@sinequa/atomic").Query, "filters">> & {
+            path?: string;
+            filters?: import("@sinequa/atomic").LegacyFilter[];
+            id?: string;
+        }>) => void;
+        getFilter: (fieldOrName?: string) => Partial<import("@sinequa/atomic").LegacyFilter & {
+            count: number;
+        }> | null;
+        getQuery: () => import("@sinequa/atomic").Query;
+    } & import("@ngrx/signals").StateSignal<{
+        id?: string | undefined;
+        text?: string | undefined;
+        filters?: import("@sinequa/atomic").LegacyFilter[] | undefined;
+        name?: string | undefined;
+        action?: ("" | "search" | "open" | "aggregate") | undefined;
+        select?: import("@sinequa/atomic").Select[] | undefined;
+        open?: import("@sinequa/atomic").Open[] | undefined;
+        page?: number | undefined;
+        pageSize?: number | undefined;
+        tab?: string | undefined;
+        scope?: string | undefined;
+        sort?: string | undefined;
+        basket?: string | undefined;
+        isFirstPage?: boolean | undefined;
+        strictRefine?: boolean | undefined;
+        globalRelevance?: number | undefined;
+        questionLanguage?: string | undefined;
+        questionDefaultLanguage?: string | undefined;
+        spellingCorrectionMode?: import("@sinequa/atomic").SpellingCorrectionMode | undefined;
+        spellingCorrectionFilter?: string | undefined;
+        documentWeight?: string | undefined;
+        textPartWeights?: string | undefined;
+        relevanceTransforms?: string | undefined;
+        removeDuplicates?: boolean | undefined;
+        queryId?: string | undefined;
+        aggregations?: (Record<string, import("@sinequa/atomic").AggregationOptions> | string[]) | undefined;
+        orderBy?: string | undefined;
+        groupBy?: string | undefined;
+        neuralSearch?: boolean | undefined;
+        path?: string | undefined;
+    }>;
+    /**
+     * Retrieves the list of saved searches from the user settings store.
+     *
+     * @returns {SavedSearch[]} An array of saved searches.
+     */
+    getSavedSearches(): SavedSearch[];
+    /**
+     * Saves the current search query to the user's saved searches.
+     *
+     * This method retrieves the current search text from the query parameters store.
+     * If the search text is empty, it logs an error and exits.
+     * Otherwise, it creates a new saved search object with the current URL, date, and search text.
+     *
+     * The new saved search is added to the beginning of the saved searches array.
+     * If the array exceeds the maximum allowed storage, the oldest search is removed.
+     *
+     * Finally, the updated saved searches array is saved back to the user settings store,
+     * and a success message is displayed to the user.
+     *
+     * @throws {Error} If saving an empty search is attempted.
+     */
+    saveSearch(): void;
+    /**
+     * Updates the saved searches in the user settings store.
+     *
+     * @param savedSearches - An array of SavedSearch objects to update.
+     */
+    updateSavedSearches(savedSearches: SavedSearch[]): void;
+    /**
+     * Deletes a saved search from the user settings store.
+     *
+     * @param index - The index of the saved search to delete.
+     */
+    deleteSavedSearch(index: number): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SavedSearchesService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<SavedSearchesService>;
+}

package/lib/services/search.service.d.ts

@@ -0,0 +1,155 @@
+import { Injector } from '@angular/core';
+import { Observable } from 'rxjs';
+import { Article, AuditEvents, Query, Result } from '@sinequa/atomic';
+import * as i0 from "@angular/core";
+export type SearchOptions = {
+    appendFilters?: boolean;
+    audit?: AuditEvents;
+};
+export declare class SearchService {
+    private readonly router;
+    private readonly route;
+    private readonly queryService;
+    result: Result;
+    audit?: AuditEvents;
+    protected readonly queryParamsStore: {
+        id?: import("@angular/core").Signal<string | undefined> | undefined;
+        text?: import("@angular/core").Signal<string | undefined> | undefined;
+        filters?: import("@angular/core").Signal<import("@sinequa/atomic").LegacyFilter[] | undefined> | undefined;
+        name?: import("@angular/core").Signal<string | undefined> | undefined;
+        action?: import("@angular/core").Signal<"" | "open" | "search" | "aggregate" | undefined> | undefined;
+        select?: import("@angular/core").Signal<import("@sinequa/atomic").Select[] | undefined> | undefined;
+        open?: import("@angular/core").Signal<import("@sinequa/atomic").Open[] | undefined> | undefined;
+        page?: import("@angular/core").Signal<number | undefined> | undefined;
+        pageSize?: import("@angular/core").Signal<number | undefined> | undefined;
+        tab?: import("@angular/core").Signal<string | undefined> | undefined;
+        scope?: import("@angular/core").Signal<string | undefined> | undefined;
+        sort?: import("@angular/core").Signal<string | undefined> | undefined;
+        basket?: import("@angular/core").Signal<string | undefined> | undefined;
+        isFirstPage?: import("@angular/core").Signal<boolean | undefined> | undefined;
+        strictRefine?: import("@angular/core").Signal<boolean | undefined> | undefined;
+        globalRelevance?: import("@angular/core").Signal<number | undefined> | undefined;
+        questionLanguage?: import("@angular/core").Signal<string | undefined> | undefined;
+        questionDefaultLanguage?: import("@angular/core").Signal<string | undefined> | undefined;
+        spellingCorrectionMode?: import("@angular/core").Signal<import("@sinequa/atomic").SpellingCorrectionMode | undefined> | undefined;
+        spellingCorrectionFilter?: import("@angular/core").Signal<string | undefined> | undefined;
+        documentWeight?: import("@angular/core").Signal<string | undefined> | undefined;
+        textPartWeights?: import("@angular/core").Signal<string | undefined> | undefined;
+        relevanceTransforms?: import("@angular/core").Signal<string | undefined> | undefined;
+        removeDuplicates?: import("@angular/core").Signal<boolean | undefined> | undefined;
+        queryId?: import("@angular/core").Signal<string | undefined> | undefined;
+        aggregations?: import("@angular/core").Signal<Record<string, import("@sinequa/atomic").AggregationOptions> | string[] | undefined> | undefined;
+        orderBy?: import("@angular/core").Signal<string | undefined> | undefined;
+        groupBy?: import("@angular/core").Signal<string | undefined> | undefined;
+        neuralSearch?: import("@angular/core").Signal<boolean | undefined> | undefined;
+        path?: import("@angular/core").Signal<string | undefined> | undefined;
+        setFromUrl: (url: string) => void;
+        addFilter: (filter: import("@sinequa/atomic").LegacyFilter) => void;
+        updateFilter: (filter: import("@sinequa/atomic").LegacyFilter) => void;
+        removeFilter: (field?: string) => void;
+        removeFilterByName: (name?: string) => void;
+        clearFilters: () => void;
+        patch: (params: Partial<Partial<Omit<Query, "filters">> & {
+            path?: string;
+            filters?: import("@sinequa/atomic").LegacyFilter[];
+            id?: string;
+        }>) => void;
+        getFilter: (fieldOrName?: string) => Partial<import("@sinequa/atomic").LegacyFilter & {
+            count: number;
+        }> | null;
+        getQuery: () => Query;
+    } & import("@ngrx/signals").StateSignal<{
+        id?: string | undefined;
+        text?: string | undefined;
+        filters?: import("@sinequa/atomic").LegacyFilter[] | undefined;
+        name?: string | undefined;
+        action?: ("" | "search" | "open" | "aggregate") | undefined;
+        select?: import("@sinequa/atomic").Select[] | undefined;
+        open?: import("@sinequa/atomic").Open[] | undefined;
+        page?: number | undefined;
+        pageSize?: number | undefined;
+        tab?: string | undefined;
+        scope?: string | undefined;
+        sort?: string | undefined;
+        basket?: string | undefined;
+        isFirstPage?: boolean | undefined;
+        strictRefine?: boolean | undefined;
+        globalRelevance?: number | undefined;
+        questionLanguage?: string | undefined;
+        questionDefaultLanguage?: string | undefined;
+        spellingCorrectionMode?: import("@sinequa/atomic").SpellingCorrectionMode | undefined;
+        spellingCorrectionFilter?: string | undefined;
+        documentWeight?: string | undefined;
+        textPartWeights?: string | undefined;
+        relevanceTransforms?: string | undefined;
+        removeDuplicates?: boolean | undefined;
+        queryId?: string | undefined;
+        aggregations?: (Record<string, import("@sinequa/atomic").AggregationOptions> | string[]) | undefined;
+        orderBy?: string | undefined;
+        groupBy?: string | undefined;
+        neuralSearch?: boolean | undefined;
+        path?: string | undefined;
+    }>;
+    protected readonly userSettingsStore: {
+        bookmarks: import("@angular/core").Signal<import("@sinequa/atomic-angular").Bookmark[]>;
+        recentSearches: import("@angular/core").Signal<import("@sinequa/atomic-angular").RecentSearch[]>;
+        savedSearches: import("@angular/core").Signal<import("@sinequa/atomic-angular").SavedSearch[]>;
+        assistants: import("@angular/core").Signal<Record<string, unknown>>;
+        language?: import("@angular/core").Signal<string | undefined> | undefined;
+        initialize: () => Promise<void>;
+        reset: () => Promise<void>;
+        updateBookmarks: (bookmarks: import("@sinequa/atomic-angular").UserSettings["bookmarks"], auditEvents?: AuditEvents) => Promise<void>;
+        bookmark: (article: Article, queryName?: string) => Promise<void>;
+        unbookmark: (id: string) => Promise<void>;
+        isBookmarked: (article: Partial<Article>) => boolean;
+        toggleBookmark: (article: Article) => Promise<void>;
+        deleteRecentSearch: (index: number) => Promise<void>;
+        updateRecentSearches: (recentSearches: import("@sinequa/atomic-angular").UserSettings["recentSearches"], auditEvents?: AuditEvents) => Promise<void>;
+        addCurrentSearch: (queryParams: import("@sinequa/atomic").QueryParams) => Promise<void>;
+        deleteSavedSearch: (index: number) => Promise<void>;
+        updateSavedSearches: (savedSearches: import("@sinequa/atomic-angular").UserSettings["savedSearches"]) => Promise<void>;
+        updateAssistantSettings: (assistantSettings: import("@sinequa/atomic-angular").UserSettings["assistants"]) => Promise<void>;
+        updateLanguage: (language: import("@sinequa/atomic-angular").UserSettings["language"], auditEvents?: AuditEvents) => Promise<void>;
+    } & import("@ngrx/signals").StateSignal<{
+        bookmarks: import("@sinequa/atomic-angular").Bookmark[];
+        recentSearches: import("@sinequa/atomic-angular").RecentSearch[];
+        savedSearches: import("@sinequa/atomic-angular").SavedSearch[];
+        assistants: Record<string, unknown>;
+        language?: string | undefined;
+    }>;
+    protected readonly injector: Injector;
+    /**
+     * Executes a search operation with the given commands and options.
+     *
+     * @param commands - An array of strings representing the search commands.
+     * @param options - An optional object containing search options.
+     * @param options.appendFilters - A boolean indicating whether to append existing filters to the search query. Defaults to true.
+     * @param options.audit - An optional audit trail object to be stored in the navigation state.
+     *
+     * The method constructs query parameters based on the current state and the provided options,
+     * then navigates to the specified commands with the constructed query parameters and audit trail.
+     */
+    search(commands: string[], options?: SearchOptions): void;
+    /**
+     * Retrieves the search result based on the provided query.
+     *
+     * @param q - A partial query object containing search parameters.
+     * @returns An Observable of the search result.
+     *
+     * This method performs the following actions:
+     * - Creates an audit event with the type "Search_Text" and the query text.
+     * - Resets the audit property to undefined.
+     * - Calls the search method of the queryService with the query, a flag to include the query name in records, and the audit event.
+     * - Handles any errors by returning an empty Result object.
+     * - Maps the search result to the service's result property.
+     */
+    getResult(q: Partial<Query>): Observable<Result>;
+    /**
+     * Navigates to the specified page and returns the search result.
+     * @param page - The page number to navigate to.
+     * @returns A promise that resolves to the search result.
+     */
+    gotoPage(page: number): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SearchService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<SearchService>;
+}

package/lib/services/selection-history.service.d.ts

@@ -0,0 +1,50 @@
+import { EventEmitter } from '@angular/core';
+import { Article } from '@sinequa/atomic';
+import * as i0 from "@angular/core";
+export type SelectionHistoryEvent = 'back' | 'new';
+export declare class SelectionHistoryService {
+    readonly selectionHistoryEvent: EventEmitter<SelectionHistoryEvent>;
+    private readonly selectionService;
+    private readonly selectionStore;
+    private readonly history;
+    constructor();
+    /**
+     * Retrieves the index of the current selection.
+     *
+     * @returns {number} The index of the current selection, which is the last element in the history array.
+     */
+    getCurrentSelectionIndex(): number;
+    /**
+     * Retrieves an article from the selection history at the specified index.
+     *
+     * @param index - The index of the article to retrieve.
+     * @returns The article at the specified index, or `undefined` if the index is out of bounds.
+     */
+    getSelection(index: number): Article | undefined;
+    /**
+     * Retrieves the length of the history array.
+     *
+     * @returns {number} The number of entries in the history.
+     */
+    getHistoryLength(): number;
+    /**
+     * Clears the selection history and resets the current article selection.
+     *
+     * This method performs the following actions:
+     * - Empties the history array.
+     * - Calls the `clearCurrentArticle` method on the `selectionService` to reset the current article selection.
+     */
+    clearHistory(): void;
+    /**
+     * Navigates back in the selection history.
+     *
+     * Removes the most recent entry from the history. If the history is empty after this operation,
+     * it returns `undefined`. Otherwise, it sets the current article to the last entry in the history,
+     * triggers a 'back' event, and returns the last entry.
+     *
+     * @returns {Article | undefined} The last article in the history, or `undefined` if the history is empty.
+     */
+    back(): Article | undefined;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SelectionHistoryService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<SelectionHistoryService>;
+}

package/lib/services/selection.service.d.ts

@@ -0,0 +1,127 @@
+import { Article } from '@sinequa/atomic';
+import * as i0 from "@angular/core";
+export declare class SelectionService {
+    private readonly route;
+    private readonly router;
+    private readonly location;
+    private readonly selectionStore;
+    queryParamsStore: {
+        id?: import("@angular/core").Signal<string | undefined> | undefined;
+        text?: import("@angular/core").Signal<string | undefined> | undefined;
+        filters?: import("@angular/core").Signal<import("@sinequa/atomic").LegacyFilter[] | undefined> | undefined;
+        name?: import("@angular/core").Signal<string | undefined> | undefined;
+        action?: import("@angular/core").Signal<"" | "open" | "search" | "aggregate" | undefined> | undefined;
+        select?: import("@angular/core").Signal<import("@sinequa/atomic").Select[] | undefined> | undefined;
+        open?: import("@angular/core").Signal<import("@sinequa/atomic").Open[] | undefined> | undefined;
+        page?: import("@angular/core").Signal<number | undefined> | undefined;
+        pageSize?: import("@angular/core").Signal<number | undefined> | undefined;
+        tab?: import("@angular/core").Signal<string | undefined> | undefined;
+        scope?: import("@angular/core").Signal<string | undefined> | undefined;
+        sort?: import("@angular/core").Signal<string | undefined> | undefined;
+        basket?: import("@angular/core").Signal<string | undefined> | undefined;
+        isFirstPage?: import("@angular/core").Signal<boolean | undefined> | undefined;
+        strictRefine?: import("@angular/core").Signal<boolean | undefined> | undefined;
+        globalRelevance?: import("@angular/core").Signal<number | undefined> | undefined;
+        questionLanguage?: import("@angular/core").Signal<string | undefined> | undefined;
+        questionDefaultLanguage?: import("@angular/core").Signal<string | undefined> | undefined;
+        spellingCorrectionMode?: import("@angular/core").Signal<import("@sinequa/atomic").SpellingCorrectionMode | undefined> | undefined;
+        spellingCorrectionFilter?: import("@angular/core").Signal<string | undefined> | undefined;
+        documentWeight?: import("@angular/core").Signal<string | undefined> | undefined;
+        textPartWeights?: import("@angular/core").Signal<string | undefined> | undefined;
+        relevanceTransforms?: import("@angular/core").Signal<string | undefined> | undefined;
+        removeDuplicates?: import("@angular/core").Signal<boolean | undefined> | undefined;
+        queryId?: import("@angular/core").Signal<string | undefined> | undefined;
+        aggregations?: import("@angular/core").Signal<Record<string, import("@sinequa/atomic").AggregationOptions> | string[] | undefined> | undefined;
+        orderBy?: import("@angular/core").Signal<string | undefined> | undefined;
+        groupBy?: import("@angular/core").Signal<string | undefined> | undefined;
+        neuralSearch?: import("@angular/core").Signal<boolean | undefined> | undefined;
+        path?: import("@angular/core").Signal<string | undefined> | undefined;
+        setFromUrl: (url: string) => void;
+        addFilter: (filter: import("@sinequa/atomic").LegacyFilter) => void;
+        updateFilter: (filter: import("@sinequa/atomic").LegacyFilter) => void;
+        removeFilter: (field?: string) => void;
+        removeFilterByName: (name?: string) => void;
+        clearFilters: () => void;
+        patch: (params: Partial<Partial<Omit<import("@sinequa/atomic").Query, "filters">> & {
+            path?: string;
+            filters?: import("@sinequa/atomic").LegacyFilter[];
+            id?: string;
+        }>) => void;
+        getFilter: (fieldOrName?: string) => Partial<import("@sinequa/atomic").LegacyFilter & {
+            count: number;
+        }> | null;
+        getQuery: () => import("@sinequa/atomic").Query;
+    } & import("@ngrx/signals").StateSignal<{
+        id?: string | undefined;
+        text?: string | undefined;
+        filters?: import("@sinequa/atomic").LegacyFilter[] | undefined;
+        name?: string | undefined;
+        action?: ("" | "search" | "open" | "aggregate") | undefined;
+        select?: import("@sinequa/atomic").Select[] | undefined;
+        open?: import("@sinequa/atomic").Open[] | undefined;
+        page?: number | undefined;
+        pageSize?: number | undefined;
+        tab?: string | undefined;
+        scope?: string | undefined;
+        sort?: string | undefined;
+        basket?: string | undefined;
+        isFirstPage?: boolean | undefined;
+        strictRefine?: boolean | undefined;
+        globalRelevance?: number | undefined;
+        questionLanguage?: string | undefined;
+        questionDefaultLanguage?: string | undefined;
+        spellingCorrectionMode?: import("@sinequa/atomic").SpellingCorrectionMode | undefined;
+        spellingCorrectionFilter?: string | undefined;
+        documentWeight?: string | undefined;
+        textPartWeights?: string | undefined;
+        relevanceTransforms?: string | undefined;
+        removeDuplicates?: boolean | undefined;
+        queryId?: string | undefined;
+        aggregations?: (Record<string, import("@sinequa/atomic").AggregationOptions> | string[]) | undefined;
+        orderBy?: string | undefined;
+        groupBy?: string | undefined;
+        neuralSearch?: boolean | undefined;
+        path?: string | undefined;
+    }>;
+    /**
+     * Sets the current article in the selection store and optionally updates the query text.
+     * If the provided article is undefined, it clears the current article.
+     *
+     * @param article - The article to set as the current article. If undefined, the current article is cleared.
+     * @param withQueryText - A boolean indicating whether to update the query text in the selection store. Defaults to true.
+     *
+     * @returns void
+     */
+    setCurrentArticle(article?: Article, withQueryText?: boolean): void;
+    /**
+     * Clears the current article selection from the selection store and
+     * removes the article ID from the query parameters.
+     *
+     * @remarks
+     * This method performs two main actions:
+     * 1. Clears the current selection from the `selectionStore`.
+     * 2. Removes the article ID from the query parameters to ensure
+     *    the URL does not reference the cleared article.
+     *
+     * @public
+     */
+    clearCurrentArticle(): void;
+    /**
+     * Updates the article ID in the query parameters of the current route.
+     * If the provided ID is undefined, it will remove the ID from the query parameters.
+     *
+     * @param id - The article ID to be set in the query parameters. If undefined, the ID will be removed.
+     */
+    private updateArticleIdInQueryParams;
+    /**
+     * Clears the 'id' parameter from the current route's query parameters.
+     *
+     * This method creates a copy of the current query parameters, removes the 'id' parameter,
+     * and then updates the browser's URL to reflect the change without reloading the page.
+     *
+     * @private
+     */
+    private clearArticleIdFromQueryParams;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SelectionService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<SelectionService>;
+}