@sinequa/atomic-angular 0.0.146

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

@@ -0,0 +1,123 @@
+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: {
+        name?: import("@angular/core").Signal<string | undefined> | undefined;
+        text?: import("@angular/core").Signal<string | undefined> | undefined;
+        aggregations?: import("@angular/core").Signal<string[] | Record<string, import("@sinequa/atomic").AggregationOptions> | undefined> | undefined;
+        sort?: 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;
+        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;
+        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;
+        filters?: import("@angular/core").Signal<import("@sinequa/atomic").LegacyFilter[] | undefined> | undefined;
+        id?: 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<import("../stores/query-params.store").QueryParamsState>) => void;
+        getFilter: (fieldOrName?: string) => Partial<import("@sinequa/atomic").LegacyFilter & {
+            count: number;
+        }> | null;
+        getQuery: () => import("@sinequa/atomic").Query;
+    } & import("@ngrx/signals").StateSource<{
+        name?: string | undefined;
+        text?: string | undefined;
+        aggregations?: (Record<string, import("@sinequa/atomic").AggregationOptions> | string[]) | undefined;
+        sort?: 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;
+        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;
+        orderBy?: string | undefined;
+        groupBy?: string | undefined;
+        neuralSearch?: boolean | undefined;
+        path?: string | undefined;
+        filters?: import("@sinequa/atomic").LegacyFilter[] | undefined;
+        id?: 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>;
+}

package/lib/stores/aggregations.store.d.ts

@@ -0,0 +1,25 @@
+import { Aggregation } from "@sinequa/atomic";
+export type AggregationsState = {
+    aggregations: Aggregation[];
+};
+export declare const AggregationsStore: import("@angular/core").Type<{
+    aggregations: import("@angular/core").Signal<Aggregation[]>;
+    update: (aggregations: Aggregation[]) => void;
+    updateAggregation: (aggregation: Aggregation) => void;
+    clear: () => void;
+    getAggregation: (name: string, kind?: "column" | "name") => Aggregation | undefined;
+} & import("@ngrx/signals").StateSource<{
+    aggregations: Aggregation[];
+}>>;
+export declare function withAggregationsFeatures(): import("@ngrx/signals").SignalStoreFeature<import("@ngrx/signals").EmptyFeatureResult, {
+    state: {
+        aggregations: Aggregation[];
+    };
+    computed: {};
+    methods: {
+        update: (aggregations: Aggregation[]) => void;
+        updateAggregation: (aggregation: Aggregation) => void;
+        clear: () => void;
+        getAggregation: (name: string, kind?: "column" | "name") => Aggregation | undefined;
+    };
+}>;

package/lib/stores/app.store.d.ts

@@ -0,0 +1,110 @@
+import { InjectionToken } from '@angular/core';
+import { ActivatedRoute } from '@angular/router';
+import { Aggregation, CCApp, CCQuery, CCWebService } from '@sinequa/atomic';
+import { CFilter, CFilterItem, CJsonMint, SideCJson } from '../models/custom-json';
+/**
+ * Injection token for a list of facet names to display in the application.
+ *
+ * This token provides a default list of facet names including:
+ * - Geo
+ * - Company
+ * - Person
+ * - DocFormat
+ * - Modified
+ * - Size
+ * - DocumentLanguages
+ * - Concepts
+ *
+ * @constant
+ * @type {InjectionToken<string[]>}
+ */
+export declare const AGGREGATIONS_NAMES_PRESET_DEFAULT: string[];
+export declare const AGGREGATIONS_NAMES: InjectionToken<string[]>;
+export type CCWebServiceLabels = CCWebService & {
+    privateLabelsField: string;
+    publicLabelsField: string;
+};
+export type CCAppState = {
+    data: CJsonMint;
+    customJSONs: SideCJson[];
+    webServices: Record<string, CCWebService>;
+    queries: Record<string, CCQuery>;
+};
+export declare const AppStore: import("@angular/core").Type<{
+    webServices: import("@ngrx/signals").DeepSignal<{}>;
+    queries: import("@ngrx/signals").DeepSignal<{}>;
+    customJSONs: import("@angular/core").Signal<SideCJson[]>;
+    data: import("@ngrx/signals").DeepSignal<{}>;
+    customizationJson: import("@angular/core").Signal<CJsonMint>;
+    sources: import("@angular/core").Signal<any>;
+    filters: import("@angular/core").Signal<any>;
+    initialize: () => Promise<void>;
+    initializeWithAppName: (appName: string) => Promise<void>;
+    update: (app: CCApp) => void;
+    getWebServiceByType: (type: CCWebService["webServiceType"]) => CCWebService | undefined;
+    getLabels: () => {
+        private: string;
+        public: string;
+    };
+    getQueryByName: (name: string) => CCQuery | undefined;
+    getQueryByIndex: (index: number) => CCQuery | undefined;
+    getDefaultQuery: () => CCQuery | undefined;
+    allowEmptySearch: (queryName: string) => boolean;
+    getColumnAlias: (column: string) => string;
+    getAuthorizedFilters: (route: ActivatedRoute) => Aggregation[];
+    getNamedCustomizationJson: (name: string) => any | undefined;
+    getAggregationIcon: (column: string) => string | undefined;
+    getAggregationItemsCustomization: (column: string) => CFilterItem[] | undefined;
+    getAggregationCustomization: (column: string) => CFilter | undefined;
+} & import("@ngrx/signals").StateSource<{
+    webServices: {};
+    queries: {};
+    customJSONs: SideCJson[];
+    data: {};
+}>>;
+/**
+ * Basic app management features
+ */
+export declare function withAppFeatures(): import("@ngrx/signals").SignalStoreFeature<import("@ngrx/signals").EmptyFeatureResult, {
+    state: {
+        webServices: {};
+        queries: {};
+    };
+    computed: {};
+    methods: {
+        initialize: () => Promise<void>;
+        initializeWithAppName: (appName: string) => Promise<void>;
+        update: (app: CCApp) => void;
+        getWebServiceByType: (type: CCWebService["webServiceType"]) => CCWebService | undefined;
+        getLabels: () => {
+            private: string;
+            public: string;
+        };
+        getQueryByName: (name: string) => CCQuery | undefined;
+        getQueryByIndex: (index: number) => CCQuery | undefined;
+        getDefaultQuery: () => CCQuery | undefined;
+        allowEmptySearch: (queryName: string) => boolean;
+        getColumnAlias: (column: string) => string;
+        getAuthorizedFilters: (route: ActivatedRoute) => Aggregation[];
+    };
+}>;
+/**
+ * Management of customization JSONs features for the app
+ */
+export declare function withAppCustomizationFeatures(): import("@ngrx/signals").SignalStoreFeature<import("@ngrx/signals").EmptyFeatureResult, {
+    state: {
+        customJSONs: SideCJson[];
+        data: {};
+    };
+    computed: {
+        customizationJson: import("@angular/core").Signal<CJsonMint>;
+        sources: import("@angular/core").Signal<any>;
+        filters: import("@angular/core").Signal<any>;
+    };
+    methods: {
+        getNamedCustomizationJson: (name: string) => any | undefined;
+        getAggregationIcon: (column: string) => string | undefined;
+        getAggregationItemsCustomization: (column: string) => CFilterItem[] | undefined;
+        getAggregationCustomization: (column: string) => CFilter | undefined;
+    };
+}>;

package/lib/stores/application.store.d.ts

@@ -0,0 +1,83 @@
+import { SafeHtml } from '@angular/platform-browser';
+export type Extract = {
+    id: string;
+    text: SafeHtml;
+    startIndex: number;
+    relevanceIndex: number;
+    textIndex: number;
+};
+export type ApplicationState = {
+    assistantReady: boolean;
+    ready: boolean;
+    extracts: Map<string, Extract[]>;
+    hasLabelsAccess: boolean;
+};
+export declare const ApplicationStore: import("@angular/core").Type<{
+    assistantReady: import("@angular/core").Signal<boolean>;
+    ready: import("@angular/core").Signal<boolean>;
+    hasLabelsAccess: import("@angular/core").Signal<boolean>;
+    extracts: import("@angular/core").Signal<Map<string, Extract[]>>;
+    extractsCount: import("@angular/core").Signal<number>;
+    updateAssistantReady: () => void;
+    updateReadyState: (value?: boolean) => void;
+    updateHasLabelsAccess: (value?: boolean) => void;
+    updateExtracts: (id: string, extracts: Extract[]) => void;
+    getExtracts: (id: string) => Extract[] | undefined;
+} & import("@ngrx/signals").WritableStateSource<{
+    assistantReady: boolean;
+    ready: boolean;
+    hasLabelsAccess: boolean;
+    extracts: Map<string, Extract[]>;
+}>>;
+/**
+ * Enhances the application store with additional features.
+ *
+ * This function integrates several features into the application store, including state management,
+ * computed properties, and various methods for updating and retrieving application state.
+ *
+ * Features included:
+ * - State initialization with `intialState`.
+ * - Methods for updating the application state:
+ *   - `updateAssistantReady`: Marks the assistant as ready.
+ *   - `updateReadyState`: Sets the application store's ready state to true.
+ *
+ * @returns A configured signal store feature with state, computed properties, and methods.
+ */
+export declare function withApplicationFeatures(): import("@ngrx/signals").SignalStoreFeature<import("@ngrx/signals").EmptyFeatureResult, {
+    state: {
+        assistantReady: boolean;
+        ready: boolean;
+        hasLabelsAccess: boolean;
+    };
+    computed: {};
+    methods: {
+        updateAssistantReady: () => void;
+        updateReadyState: (value?: boolean) => void;
+        updateHasLabelsAccess: (value?: boolean) => void;
+    };
+}>;
+/**
+ * Provides features related to extracts within the application store.
+ *
+ * This function integrates state management, computed properties, and methods
+ * for handling extracts in the application store.
+ *
+ * Features:
+ * - State management for extracts.
+ * - Computed property to get the count of extracts.
+ * - Methods to update and retrieve extracts.
+ *
+ * @returns A configured signal store feature with state, computed properties, and methods for extracts.
+ */
+export declare function withExtractsFeatures(): import("@ngrx/signals").SignalStoreFeature<import("@ngrx/signals").EmptyFeatureResult, {
+    state: {
+        extracts: Map<string, Extract[]>;
+    };
+    computed: {
+        extractsCount: import("@angular/core").Signal<number>;
+    };
+    methods: {
+        updateExtracts: (id: string, extracts: Extract[]) => void;
+        getExtracts: (id: string) => Extract[] | undefined;
+    };
+}>;

package/lib/stores/index.d.ts

@@ -0,0 +1,8 @@
+export * from "./aggregations.store";
+export * from "./app.store";
+export * from "./application.store";
+export * from "./principal.store";
+export * from "./query-params.store";
+export * from "./selection.store";
+export * from "./theme.store";
+export * from "./user-settings.store";

package/lib/stores/principal.store.d.ts

@@ -0,0 +1,47 @@
+import { Principal } from "@sinequa/atomic";
+export type PrincipalState = {
+    principal: Principal;
+    userOverrideActive: boolean;
+};
+export declare const PrincipalStore: import("@angular/core").Type<{
+    principal: import("@ngrx/signals").DeepSignal<Principal>;
+    userOverrideActive: import("@angular/core").Signal<boolean>;
+    allowUserOverride: import("@angular/core").Signal<boolean>;
+    isOverridingUser: import("@angular/core").Signal<boolean>;
+    initialize: () => Promise<void>;
+} & import("@ngrx/signals").StateSource<{
+    principal: Principal;
+    userOverrideActive: boolean;
+}>>;
+/**
+ * Enhances the store with principal-related features.
+ *
+ * This function integrates state, methods, and computed properties related to the principal.
+ *
+ * @returns A feature that can be added to a signal store.
+ *
+ * @feature
+ * - State:
+ *   - `principal`: An object representing the principal.
+ *   - `userOverrideActive`: A boolean indicating if user override is active.
+ *
+ * - Methods:
+ *   - `initialize()`: Initializes the principal state by fetching the principal data from the `PrincipalService`.
+ *
+ * - Computed Properties:
+ *   - `allowUserOverride`: A computed boolean indicating if user override is allowed based on the principal's administrator status and the `userOverrideActive` state.
+ *   - `isOverridingUser`: A computed boolean indicating if the user override is currently active.
+ */
+export declare function withPrincipalFeatures(): import("@ngrx/signals").SignalStoreFeature<import("@ngrx/signals").EmptyFeatureResult, {
+    state: {};
+    computed: {};
+    methods: {
+        /**
+         * Initializes the principal store by fetching the principal data from the principal service.
+         * It patches the store with the fetched principal data and a user override active flag from the global configuration.
+         *
+         * @returns A promise that resolves when the principal data has been fetched and the store has been patched.
+         */
+        initialize(): Promise<void>;
+    };
+}>;

package/lib/stores/query-params.store.d.ts

@@ -0,0 +1,128 @@
+import { LegacyFilter, Query, SpellingCorrectionMode } from '@sinequa/atomic';
+export type QueryParamsState = Partial<Omit<Query, "filters">> & {
+    path?: string;
+    filters?: LegacyFilter[];
+    id?: string;
+};
+export declare const QueryParamsStore: import("@angular/core").Type<{
+    name?: import("@angular/core").Signal<string | undefined> | undefined;
+    text?: import("@angular/core").Signal<string | undefined> | undefined;
+    aggregations?: import("@angular/core").Signal<string[] | Record<string, import("@sinequa/atomic").AggregationOptions> | undefined> | undefined;
+    sort?: 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;
+    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<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;
+    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;
+    filters?: import("@angular/core").Signal<LegacyFilter[] | undefined> | undefined;
+    id?: import("@angular/core").Signal<string | undefined> | undefined;
+    setFromUrl: (url: string) => void;
+    addFilter: (filter: LegacyFilter) => void;
+    updateFilter: (filter: LegacyFilter) => void;
+    removeFilter: (field?: string) => void;
+    removeFilterByName: (name?: string) => void;
+    clearFilters: () => void;
+    patch: (params: Partial<QueryParamsState>) => void;
+    getFilter: (fieldOrName?: string) => Partial<LegacyFilter & {
+        count: number;
+    }> | null;
+    getQuery: () => Query;
+} & import("@ngrx/signals").StateSource<{
+    name?: string | undefined;
+    text?: string | undefined;
+    aggregations?: (Record<string, import("@sinequa/atomic").AggregationOptions> | string[]) | undefined;
+    sort?: 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;
+    basket?: string | undefined;
+    isFirstPage?: boolean | undefined;
+    strictRefine?: boolean | undefined;
+    globalRelevance?: number | undefined;
+    questionLanguage?: string | undefined;
+    questionDefaultLanguage?: string | undefined;
+    spellingCorrectionMode?: SpellingCorrectionMode | undefined;
+    spellingCorrectionFilter?: string | undefined;
+    documentWeight?: string | undefined;
+    textPartWeights?: string | undefined;
+    relevanceTransforms?: string | undefined;
+    removeDuplicates?: boolean | undefined;
+    queryId?: string | undefined;
+    orderBy?: string | undefined;
+    groupBy?: string | undefined;
+    neuralSearch?: boolean | undefined;
+    path?: string | undefined;
+    filters?: LegacyFilter[] | undefined;
+    id?: string | undefined;
+}>>;
+export declare function withQueryParamsFeatures(): import("@ngrx/signals").SignalStoreFeature<import("@ngrx/signals").EmptyFeatureResult, {
+    state: {
+        name?: string | undefined;
+        text?: string | undefined;
+        aggregations?: (Record<string, import("@sinequa/atomic").AggregationOptions> | string[]) | undefined;
+        sort?: 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;
+        basket?: string | undefined;
+        isFirstPage?: boolean | undefined;
+        strictRefine?: boolean | undefined;
+        globalRelevance?: number | undefined;
+        questionLanguage?: string | undefined;
+        questionDefaultLanguage?: string | undefined;
+        spellingCorrectionMode?: SpellingCorrectionMode | undefined;
+        spellingCorrectionFilter?: string | undefined;
+        documentWeight?: string | undefined;
+        textPartWeights?: string | undefined;
+        relevanceTransforms?: string | undefined;
+        removeDuplicates?: boolean | undefined;
+        queryId?: string | undefined;
+        orderBy?: string | undefined;
+        groupBy?: string | undefined;
+        neuralSearch?: boolean | undefined;
+        path?: string | undefined;
+        filters?: LegacyFilter[] | undefined;
+        id?: string | undefined;
+    };
+    computed: {};
+    methods: {
+        setFromUrl: (url: string) => void;
+        addFilter: (filter: LegacyFilter) => void;
+        updateFilter: (filter: LegacyFilter) => void;
+        removeFilter: (field?: string) => void;
+        removeFilterByName: (name?: string) => void;
+        clearFilters: () => void;
+        patch: (params: Partial<QueryParamsState>) => void;
+        getFilter: (fieldOrName?: string) => Partial<LegacyFilter & {
+            count: number;
+        }> | null;
+        getQuery: () => Query;
+    };
+}>;

package/lib/stores/selection.store.d.ts

@@ -0,0 +1,52 @@
+import { Article, CustomHighlights } from "@sinequa/atomic";
+export type PreviewHighlights = {
+    highlights: CustomHighlights[];
+    snippetId?: number;
+};
+export type SelectionState = {
+    article: Article;
+    id: string;
+    queryText: string;
+    previewHighlights: PreviewHighlights;
+};
+/**
+ * @constant
+ * @name SelectionStore
+ * @description
+ * A store that manages the selection state of articles. It is provided in the root of the application and includes
+ * development tools for easier debugging. The store maintains the state with the following properties:
+ * - `article`: The selected article.
+ * - `id`: The ID of the selected article.
+ * - `queryText`: The query text associated with the selection.
+ *
+ * @methods
+ * - `update(article: Article, queryText?: string)`: Updates the store with a new article and optional query text.
+ * - `updateQueryText(queryText: string)`: Updates the query text in the store.
+ * - `clear()`: Clears the selection state, setting `article`, `id`, and `queryText` to `undefined`.
+ */
+export declare const SelectionStore: import("@angular/core").Type<{
+    article: import("@ngrx/signals").DeepSignal<Article>;
+    id: import("@angular/core").Signal<string>;
+    queryText: import("@angular/core").Signal<string>;
+    previewHighlights: import("@ngrx/signals").DeepSignal<PreviewHighlights>;
+    update: (newState: Partial<SelectionState>) => void;
+    clear: () => void;
+} & import("@ngrx/signals").StateSource<{
+    article: Article;
+    id: string;
+    queryText: string;
+    previewHighlights: PreviewHighlights;
+}>>;
+export declare function withSelectionFeatures(): import("@ngrx/signals").SignalStoreFeature<import("@ngrx/signals").EmptyFeatureResult, {
+    state: {
+        article: Article;
+        id: string;
+        queryText: string;
+        previewHighlights: PreviewHighlights;
+    };
+    computed: {};
+    methods: {
+        update: (newState: Partial<SelectionState>) => void;
+        clear: () => void;
+    };
+}>;

package/lib/stores/theme.store.d.ts

@@ -0,0 +1,66 @@
+export type CssVars = {
+    light?: Record<string, string>;
+    dark?: Record<string, string>;
+};
+export type ThemeScope = {
+    [key: string]: {
+        cssVars: CssVars;
+        darkMode?: boolean;
+        themeName: string;
+    };
+};
+export type ThemeStoreState = {
+    scopes: ThemeScope;
+};
+export declare const ThemeStore: import("@angular/core").Type<{
+    scopes: import("@angular/core").Signal<ThemeScope>;
+    loadDefaultTheme: (scope: string, darkMode?: boolean) => void;
+    setCurrentTheme: (scope: string, themeName: string, darkMode?: boolean) => void;
+    setDarkMode: (scope: string, darkMode: boolean) => void;
+} & import("@ngrx/signals").StateSource<{
+    scopes: ThemeScope;
+}>>;
+export declare function withThemesFeatures(): import("@ngrx/signals").SignalStoreFeature<import("@ngrx/signals").EmptyFeatureResult, {
+    state: {
+        scopes: ThemeScope;
+    };
+    computed: {};
+    methods: {
+        loadDefaultTheme: (scope: string, darkMode?: boolean) => void;
+        setCurrentTheme: (scope: string, themeName: string, darkMode?: boolean) => void;
+        setDarkMode: (scope: string, darkMode: boolean) => void;
+    };
+}>;
+/**
+ * Processes the CSS variables for a given theme name.
+ *
+ * @param themeName - The name of the theme to process.
+ * @returns An object containing the CSS variables for both light and dark themes.
+ * @throws Will throw an error if the theme with the specified name is not found.
+ */
+export declare function processCssVars(themeName: string): CssVars;
+/**
+ * Converts an object of theme colors to CSS variables.
+ *
+ * @param colors - An object where keys are theme color names and values are the corresponding color values.
+ * @returns An object where keys are CSS variable names and values are the corresponding color values.
+ */
+export declare function themeColorsToCssVariables(colors: any): any;
+/**
+ * Converts a camelCase theme color name to a CSS variable format.
+ *
+ * This function takes a camelCase string and transforms it into a CSS variable
+ * name by inserting hyphens between lowercase and uppercase letters and converting
+ * the entire string to lowercase.
+ *
+ * @param name - The camelCase theme color name to be converted.
+ * @returns The corresponding CSS variable name in kebab-case.
+ */
+export declare function themeColorNameToCssVariable(name: string): string;
+/**
+ * Applies a set of CSS variables to a given HTML element.
+ *
+ * @param element - The HTML element to which the CSS variables will be applied.
+ * @param cssVars - An optional record of CSS variable names and their corresponding values.
+ */
+export declare function applyThemeToNativeElement(element: HTMLElement, cssVars?: Record<string, string>): void;