@sinequa/atomic-angular 2.7.0 → 2.9.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sinequa/atomic-angular",
-  "version": "2.7.0",
+  "version": "2.9.0",
   "publishConfig": {
     "access": "public"
   },

package/types/sinequa-atomic-angular-document-workspaces.d.ts

@@ -1551,7 +1551,7 @@ export declare class WorkspaceList {
     labelKey: string;
   }[];
   protected readonly viewMode: import("@angular/core").WritableSignal<ViewMode$1>;
-  protected readonly status: import("@angular/core").WritableSignal<"loading" | "ready" | "error">;
+  protected readonly status: import("@angular/core").WritableSignal<"error" | "loading" | "ready">;
   protected readonly loadError: import("@angular/core").WritableSignal<Message | null>;
   protected readonly refreshError: import("@angular/core").WritableSignal<string | null>;
   protected readonly loadingMore: import("@angular/core").WritableSignal<boolean>;
@@ -2135,7 +2135,7 @@ export declare class WorkspaceEditDialog {
   protected readonly busy: import("@angular/core").WritableSignal<boolean>;
   protected readonly error: import("@angular/core").WritableSignal<WorkspaceErrorMessage | null>;
   protected readonly descriptionTooLong: import("@angular/core").Signal<boolean>;
-  protected readonly saveLabel: import("@angular/core").Signal<"documentWorkspaces.edit.creating" | "documentWorkspaces.edit.saving" | "documentWorkspaces.common.create" | "documentWorkspaces.common.save">;
+  protected readonly saveLabel: import("@angular/core").Signal<"documentWorkspaces.common.save" | "documentWorkspaces.edit.creating" | "documentWorkspaces.edit.saving" | "documentWorkspaces.common.create">;
   /** What to resolve with once the native dialog has closed: the saved workspace, or the plain dismissal. */
   private outcome;
   constructor();
@@ -2192,7 +2192,7 @@ export declare class WorkspaceDetail {
   protected readonly query: import("@angular/core").WritableSignal<string>;
   /** The search box, bound to `query`. */
   protected readonly searchForm: import("@angular/forms/signals").FieldTree<string, string | number, "writable">;
-  protected readonly status: import("@angular/core").WritableSignal<"loading" | "ready" | "error">;
+  protected readonly status: import("@angular/core").WritableSignal<"error" | "loading" | "ready">;
   protected readonly loadError: import("@angular/core").WritableSignal<Message | null>;
   protected readonly refreshError: import("@angular/core").WritableSignal<string | null>;
   protected readonly refreshing: import("@angular/core").WritableSignal<boolean>;
@@ -2327,7 +2327,7 @@ export declare function injectWorkspaceMention(options?: WorkspaceMentionOptions
   /** The workspaces in each category — the whole list, not what the search left. */
   counts: import("@angular/core").Signal<import("@sinequa/atomic-angular/document-workspaces").WorkspaceTabCounts>;
   /** Whether the first page is loading, ready or failed. */
-  status: import("@angular/core").Signal<"loading" | "ready" | "error">;
+  status: import("@angular/core").Signal<"error" | "loading" | "ready">;
   /** More workspaces than the loaded ones exist on the server: `loadMore()` fetches the next page. */
   hasMore: import("@angular/core").Signal<boolean>;
   /** The loading cap is reached: some workspaces will never be offered, search included. */
@@ -2374,7 +2374,7 @@ export declare const WORKSPACE_MENTION: InjectionToken<{
   /** The workspaces in each category — the whole list, not what the search left. */
   counts: import("@angular/core").Signal<import("@sinequa/atomic-angular/document-workspaces").WorkspaceTabCounts>;
   /** Whether the first page is loading, ready or failed. */
-  status: import("@angular/core").Signal<"loading" | "ready" | "error">;
+  status: import("@angular/core").Signal<"error" | "loading" | "ready">;
   /** More workspaces than the loaded ones exist on the server: `loadMore()` fetches the next page. */
   hasMore: import("@angular/core").Signal<boolean>;
   /** The loading cap is reached: some workspaces will never be offered, search included. */
@@ -2525,7 +2525,7 @@ export declare class WorkspaceMention implements WorkspaceMentionApi, AfterConte
     labelKey: string;
   }[];
   readonly counts: import("@angular/core").Signal<import("@sinequa/atomic-angular/document-workspaces").WorkspaceTabCounts>;
-  readonly status: import("@angular/core").Signal<"loading" | "ready" | "error">;
+  readonly status: import("@angular/core").Signal<"error" | "loading" | "ready">;
   readonly hasMore: import("@angular/core").Signal<boolean>;
   readonly truncated: import("@angular/core").Signal<boolean>;
   readonly loadingMore: import("@angular/core").Signal<boolean>;
@@ -2591,11 +2591,11 @@ export declare class WorkspaceMention implements WorkspaceMentionApi, AfterConte
  */
 export declare class WorkspaceMentionNew implements AfterContentInit {
   /** The button's variant. */
-  readonly variant: import("@angular/core").InputSignal<"primary" | "secondary" | "none" | "light-accent" | "accent" | "tertiary" | null | undefined>;
+  readonly variant: import("@angular/core").InputSignal<"none" | "primary" | "secondary" | "light-accent" | "accent" | "tertiary" | null | undefined>;
   /** The button's colour scheme. */
   readonly scheme: import("@angular/core").InputSignal<"default" | "neutral" | null | undefined>;
   /** The button's size. */
-  readonly size: import("@angular/core").InputSignal<"sm" | "md" | "lg" | "small" | "medium" | "large" | "xs" | "xsmall" | null | undefined>;
+  readonly size: import("@angular/core").InputSignal<"small" | "medium" | "md" | "lg" | "sm" | "xs" | "xsmall" | "large" | null | undefined>;
   private readonly mention;
   private readonly slot;
   /** Whether the host put its own content inside: the icon and the label then stay out. */
@@ -2638,7 +2638,7 @@ export declare class WorkspaceMentionRows {
       labelKey: string;
     }[];
     counts: import("@angular/core").Signal<import("@sinequa/atomic-angular/document-workspaces").WorkspaceTabCounts>;
-    status: import("@angular/core").Signal<"loading" | "ready" | "error">;
+    status: import("@angular/core").Signal<"error" | "loading" | "ready">;
     hasMore: import("@angular/core").Signal<boolean>;
     truncated: import("@angular/core").Signal<boolean>;
     loadingMore: import("@angular/core").Signal<boolean>;
@@ -2660,9 +2660,9 @@ export declare class WorkspaceMentionRows {
 /** The search box of the enclosing `<workspace-mention>`: it narrows what the menu offers. */
 export declare class WorkspaceMentionSearch {
   /** The size of the box, as `<SearchInput>` sizes it. */
-  readonly size: import("@angular/core").InputSignal<"sm" | "md" | "lg" | null | undefined>;
+  readonly size: import("@angular/core").InputSignal<"md" | "lg" | "sm" | null | undefined>;
   /** The size of the text, as `<SearchInput>` sizes it; follows `size` when absent. */
-  readonly textSize: import("@angular/core").InputSignal<"sm" | "base" | null | undefined>;
+  readonly textSize: import("@angular/core").InputSignal<"base" | "sm" | null | undefined>;
   /** The hint shown in the empty box; the translated "Search workspace..." when absent. */
   readonly placeholder: import("@angular/core").InputSignal<string | undefined>;
   /** The accessible name of the box; the placeholder when absent. */
@@ -2709,7 +2709,7 @@ export declare class WorkspaceMentionSelectAll {
       labelKey: string;
     }[];
     counts: import("@angular/core").Signal<import("@sinequa/atomic-angular/document-workspaces").WorkspaceTabCounts>;
-    status: import("@angular/core").Signal<"loading" | "ready" | "error">;
+    status: import("@angular/core").Signal<"error" | "loading" | "ready">;
     hasMore: import("@angular/core").Signal<boolean>;
     truncated: import("@angular/core").Signal<boolean>;
     loadingMore: import("@angular/core").Signal<boolean>;
@@ -2745,7 +2745,7 @@ export declare class WorkspaceMentionTabs {
       labelKey: string;
     }[];
     counts: import("@angular/core").Signal<import("@sinequa/atomic-angular/document-workspaces").WorkspaceTabCounts>;
-    status: import("@angular/core").Signal<"loading" | "ready" | "error">;
+    status: import("@angular/core").Signal<"error" | "loading" | "ready">;
     hasMore: import("@angular/core").Signal<boolean>;
     truncated: import("@angular/core").Signal<boolean>;
     loadingMore: import("@angular/core").Signal<boolean>;
@@ -2790,14 +2790,14 @@ export declare const NEW_WORKSPACE_NAME_MAX = 50;
  */
 export declare class WorkspacePicker {
   /** `save` attaches `documents` to the chosen workspace; `move` takes `documentIds` from `fromWorkspaceId` to it. */
-  readonly mode: import("@angular/core").InputSignal<"save" | "move">;
+  readonly mode: import("@angular/core").InputSignal<"move" | "save">;
   readonly documents: import("@angular/core").InputSignal<readonly PickerDocument[]>;
   readonly fromWorkspaceId: import("@angular/core").InputSignal<string | null>;
   readonly documentIds: import("@angular/core").InputSignal<readonly string[]>;
   /** The documents are in the workspace, and the check mark has been seen. */
   readonly completed: import("@angular/core").OutputEmitterRef<Workspace>;
   private readonly store;
-  protected readonly status: import("@angular/core").WritableSignal<"loading" | "ready" | "error">;
+  protected readonly status: import("@angular/core").WritableSignal<"error" | "loading" | "ready">;
   protected readonly busyId: import("@angular/core").WritableSignal<string | null>;
   protected readonly doneId: import("@angular/core").WritableSignal<string | null>;
   protected readonly error: import("@angular/core").WritableSignal<Message | null>;

package/types/sinequa-atomic-angular.d.ts

@@ -1,7 +1,7 @@
 import * as i0 from "@angular/core";
 import { ApplicationRef, ChangeDetectorRef, DestroyRef, ElementRef, EnvironmentProviders, InjectionToken, Injector, OnDestroy, OnInit, PipeTransform, Provider, ResourceRef, Signal, TemplateRef, Type, WritableSignal } from "@angular/core";
 import { TranslocoService } from "@jsverse/transloco";
-import { Aggregation, AggregationItem, Article, AtomicClient, AtomicClientConfig, AuditEventType, AuditEventTypeValues, AuditEvents, CCApp, CCColumn, CCQuery, CCSortingChoice, CCWebService, Conversion, Credentials, CustomHighlights, DidYouMeanAction, ExportOutputFormat, ExportQueryModel, Filter as Filter$1, FilterOperator, KeyOf, LegacyFilter, LinkResult, PreviewData, Principal, Query, QueryParams, RequestOptions, Result, SpellingCorrectionMode, Suggestion, TextChunk, TextLocation, TreeAggregation, TreeAggregationNode, UserProfile, getRelativeDate } from "@sinequa/atomic";
+import { Aggregation, AggregationItem, Article, AtomicClient, AtomicClientConfig, AuditEventType, AuditEventTypeValues, AuditEvents, CCApp, CCColumn, CCQuery, CCSortingChoice, CCWebService, Conversion, Credentials, CustomHighlights, DidYouMeanAction, ExportOutputFormat, ExportQueryModel, Filter as Filter$1, FilterOperator, KeyOf, LegacyFilter, LinkResult, PreviewData, Principal, Query, QueryParams, RequestOptions, Result, SpellingCorrectionMode, Suggestion, TextChunk, TextLocation, TreeAggregation, TreeAggregationNode, UserProfile } from "@sinequa/atomic";
 import { CanActivateFn, NavigationEnd, Params, ResolveFn, Route, Router } from "@angular/router";
 import { VariantProps } from "class-variance-authority";
 import { BreakpointObserverService, DialogComponent, DialogEvent, DialogResult, DropdownDirective, PopoverDirective, SheetComponent, SwitchComponent } from "@sinequa/galactik";
@@ -10,7 +10,6 @@ import { BehaviorSubject, Observable, Subject } from "rxjs";
 import { FieldTree } from "@angular/forms/signals";
 import MarkdownIt from "markdown-it";
 import { Placement } from "@floating-ui/dom";
-import { CdkDragDrop } from "@angular/cdk/drag-drop";
 import { Options as Options$1 } from "vanilla-calendar-pro";
 import { TreeItem } from "@angular/aria/tree";
 import { Toolbar } from "@angular/aria/toolbar";
@@ -1062,7 +1061,7 @@ export declare class MetadataComponent {
   }>;
   class: import("@angular/core").InputSignal<string | undefined>;
   variant: import("@angular/core").InputSignal<"primary" | "secondary" | null | undefined>;
-  size: import("@angular/core").InputSignal<"small" | "medium" | "xs" | "sm" | "md" | "xsmall" | null | undefined>;
+  size: import("@angular/core").InputSignal<"small" | "sm" | "md" | "xs" | "xsmall" | "medium" | null | undefined>;
   scheme: import("@angular/core").InputSignal<"error" | "sage" | "success" | "almond" | "pink" | "grey" | "yellow" | "cherry" | "indigo" | "cyan" | "warning" | "info" | null | undefined>;
   metadata: import("@angular/core").InputSignal<(string & Record<never, never>) | KeyOf<Article>>;
   article: import("@angular/core").InputSignal<Partial<Article> | (string & Record<never, never>)>;
@@ -11095,22 +11094,115 @@ export declare class ArticleSimilarDocumentsTabPanel {
     "selected": "selected";
   }, never, never, true, never>;
 }
+/**
+ * Short weekday names in the active language ("Mon", "lun."), Monday first. 2024-01-01 is a Monday.
+ */
+declare function weekdayNames(lang: string): string[];
+/** One piece of the summary: a translation key (translated by the template's pipe) or a ready text. */
+interface AlertSummaryPart {
+  key?: string;
+  /** Interpolation parameters of `key`. */
+  params?: Record<string, unknown>;
+  text?: string;
+}
+/**
+ * Second line of an alert row: what the alert does, so the list answers "when will I be notified?" without
+ * opening the dialog — « Daily · 09:00 · Mon–Fri ». A suspended alert starts with « Paused ».
+ *
+ * Returns the pieces rather than a sentence: the labels live in the `alerts` translation scope, which loads on
+ * demand, and only the template's `transloco` pipe waits for it. The caller joins the pieces with " · ".
+ *
+ * Tolerant of an alert that lacks `times` or `days`: the piece is left out rather than shown empty.
+ */
+declare function alertSummary(lang: string, alert: Alert): AlertSummaryPart[];
+/**
+ * What an alert watches, in pieces — « “data protection” · Web tab · 2 filters ». Same contract as
+ * {@link alertSummary}: translation keys for the template's pipe, ready text for the rest.
+ */
+declare function querySummary(query: Query | undefined): AlertSummaryPart[];
+/**
+ * The user's alerts: one row per alert (name, when it fires, an on/off switch), "Create" in the header.
+ *
+ * The rows are reordered by dragging them or with Alt + ↑ / ↓ on a focused row — the gesture is galactik's
+ * `[sortable]`, this component only saves the order it reports. A deletion is applied at once on screen and sent to
+ * the server after `UNDO_DELAY`, unless the user undoes it; it is also sent when the component goes away (the
+ * popover closes).
+ */
 export declare class AlertsComponent {
   floating: PopoverDirective | null;
   private readonly userSettingsStore;
   private readonly injector;
-  reordering: import("@angular/core").WritableSignal<boolean>;
-  protected alerts: import("@angular/core").Signal<Alert[]>;
-  tmpAlerts: Alert[];
+  private readonly transloco;
+  private readonly lang;
   query: Query;
+  /**
+   * Whether the form opens in a dialog (`AlertForm`), which is what a click on a row or on "Create" does by
+   * default. Set it to `false` to show the form yourself, wherever you like (see `AlertFormComponent`): the
+   * list then only reports the request, with `editRequested` and `createRequested`.
+   */
+  readonly dialog: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+  /** The user asked to edit an alert: its index in `UserSettingsStore.alerts()`. Only with `[dialog]="false"`. */
+  readonly editRequested: import("@angular/core").OutputEmitterRef<number>;
+  /** The user asked to create an alert. Only with `[dialog]="false"`. */
+  readonly createRequested: import("@angular/core").OutputEmitterRef<void>;
+  /**
+   * Why the last change could not be saved, shown above the list until the next one. A toast would not do: the
+   * list lives in popovers and modal dialogs, which are in the top layer, above any toast.
+   */
+  protected readonly saveError: import("@angular/core").WritableSignal<{
+    detail?: string;
+  } | undefined>;
+  protected readonly alerts: import("@angular/core").Signal<Alert[]>;
+  /**
+   * The order on screen. A copy of the store's list (the store edits its own array in place), and ahead of it
+   * while a new order is being saved: a drop shows its result at once instead of after the round trip.
+   */
+  private readonly order;
+  /** Alerts removed from the screen: awaiting the end of the undo delay, or being deleted on the server. */
+  private readonly hidden;
+  /** The alert whose deletion can still be undone. */
+  protected readonly pendingDeletion: import("@angular/core").WritableSignal<Alert | undefined>;
+  private undoTimer;
+  /** The alerts to show, in order — what `[sortable]` reorders. */
+  protected readonly visible: import("@angular/core").Signal<Alert[]>;
+  /** The second line of each row. */
+  private readonly summaries;
+  protected readonly summaryOf: (alert: Alert) => AlertSummaryPart[];
+  /** What a screen reader hears after a keyboard move. */
+  protected readonly announceMove: (alert: Alert, position: number, total: number) => string;
   constructor();
-  onClick(index: number): void;
+  /** A click on the switch or the delete button is theirs, not a request to edit the alert. */
+  protected onRowClick(event: Event, alert: Alert): void;
+  /** Enter edits the row only when the row itself has the focus — not when it comes from the switch or the button. */
+  protected onRowEnter(event: Event, alert: Alert): void;
+  private edit;
   createAlert(): void;
-  deleteAlert(event: Event, index: number): void;
-  reorder(): Promise<void>;
-  dropped(drop: CdkDragDrop<Alert[]>): void;
+  /**
+   * What each switch shows while its change is being saved. The switch flips itself on a click and the store
+   * only changes once the save has succeeded: dropping the entry on a failure changes the bound value back,
+   * which is what puts the switch back where it was.
+   */
+  private readonly pendingActive;
+  protected isActive(alert: Alert): boolean;
+  protected toggle(alert: Alert, active: boolean): Promise<void>;
+  protected deleteAlert(alert: Alert): void;
+  protected undoDeletion(): void;
+  /** Sends the pending deletion. The row stays hidden until the store no longer holds the alert. */
+  private commitDeletion;
+  private unhide;
+  /** The new order of the alerts shown. An alert being deleted is not in it: it goes after them, as it is about to leave. */
+  protected saveOrder(shown: Alert[]): Promise<void>;
   static ɵfac: i0.ɵɵFactoryDeclaration<AlertsComponent, never>;
-  static ɵcmp: i0.ɵɵComponentDeclaration<AlertsComponent, "Alerts", never, {}, {}, never, never, true, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<AlertsComponent, "Alerts", never, {
+    "dialog": {
+      "alias": "dialog";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {
+    "editRequested": "editRequested";
+    "createRequested": "createRequested";
+  }, never, never, true, never>;
 }
 /**
  * The seven weekdays, in display order, each paired with its bit in {@link Alert.Days}.
@@ -11165,22 +11257,47 @@ export interface AlertFormModel {
 export declare function weekdaysFromFlags(mask: Alert.Days): Record<WeekdayKey, boolean>;
 /** Folds the seven booleans of the form model back into an {@link Alert.Days} bitfield. */
 export declare function flagsFromWeekdays(days: Record<WeekdayKey, boolean>): Alert.Days;
-export declare class AlertDialog {
-  protected readonly call: import("@sinequa/galactik").CallRef<number | undefined, DialogEvent>;
+/**
+ * The form that creates or edits one alert: name, frequency and time, weekdays, on/off, and — for an
+ * existing alert — the search it watches.
+ *
+ * It knows nothing of its container. `<alert-form [index]="…" (saved)="…" />` can sit in a dialog (see
+ * {@link AlertDialog}), a panel, a drawer or a page: it saves through {@link UserSettingsStore} and tells its
+ * container with `saved` once the save has succeeded, or `executed` once the user has run the watched search.
+ * A failed save keeps what was typed and is shown inside the form — a toast would sit behind a modal dialog.
+ *
+ * The form renders no button of its own that submits or cancels: those belong to the container. A submit
+ * button placed outside the form submits it by pointing at {@link AlertFormComponent.formId} with its `form`
+ * attribute, and can use {@link AlertFormComponent.saving} to wait for the save.
+ *
+ * The layout follows the width of the form (a container query), not that of the window: frequency and time
+ * share a line from 24rem up and stack below.
+ */
+export declare class AlertFormComponent {
   private readonly queryService;
   private readonly queryParamsStore;
   private readonly userSettingsStore;
   private readonly transloco;
-  readonly dialog: import("@angular/core").Signal<DialogComponent | undefined>;
+  private readonly lang;
+  /** Index, in the user settings, of the alert to edit — leave it unset to create one. */
+  readonly index: import("@angular/core").InputSignal<number | undefined>;
+  /** Emitted once the alert has been saved. */
+  readonly saved: import("@angular/core").OutputEmitterRef<void>;
+  /** Emitted once the user has run the watched search: the query parameters now hold it. */
+  readonly executed: import("@angular/core").OutputEmitterRef<void>;
+  /** Id of the `<form>`: a submit button outside the component points at it with its `form` attribute. */
+  readonly formId: string;
   protected readonly fieldClass = "flex flex-col gap-(--spacing-2xs)";
   protected readonly labelClass = "text-(length:--size-base) font-(--weight-semibold) text-(--font-primary-base)";
   protected readonly errorClass = "text-(length:--size-base) text-(--font-error-base)";
-  frequencies: Alert.Frequency[];
-  frequency: typeof Alert.Frequency;
+  protected readonly frequencies: Alert.Frequency[];
+  protected readonly frequency: typeof Alert.Frequency;
+  protected readonly Days: typeof Alert.Days;
+  protected readonly querySummary: typeof querySummary;
   /** Libellé traduit d'une fréquence — utilisé par le typeahead du `SelectMenu`. */
-  readonly frequencyLabel: (value: Alert.Frequency) => string;
-  /** The seven weekdays, exposed to the template for the checkbox grid. */
-  readonly weekdays: readonly [{
+  protected readonly frequencyLabel: (value: Alert.Frequency) => string;
+  /** The seven weekdays, exposed to the template for the toggle chips. */
+  protected readonly weekdays: readonly [{
     readonly key: "monday";
     readonly flag: Alert.Days.Monday;
   }, {
@@ -11202,26 +11319,33 @@ export declare class AlertDialog {
     readonly key: "sunday";
     readonly flag: Alert.Days.Sunday;
   }];
-  /**
-   * The alert being edited, and its index in the user settings — `undefined` in "create" mode.
-   *
-   * Signals and not plain properties: they are written from `init()`, outside any template listener,
-   * and the template branches on them. A plain property mutated there does not mark the view dirty.
-   */
-  readonly index: import("@angular/core").WritableSignal<number | undefined>;
-  readonly alert: import("@angular/core").WritableSignal<Alert | undefined>;
-  canUpdateQuery: import("@angular/core").WritableSignal<boolean>;
-  updateStatus: import("@angular/core").WritableSignal<"idle" | "updating" | "updated">;
-  /** Form model. Replaces the five former scalar signals. */
+  /** Their short names in the active language, Monday first — what the chips show. */
+  protected readonly dayNames: import("@angular/core").Signal<string[]>;
+  /** The alert being edited — `undefined` in "create" mode. */
+  readonly alert: import("@angular/core").Signal<Alert | undefined>;
+  /**
+   * Whether the search currently on screen can replace the one the alert watches: it must have results.
+   * Only an existing alert has anything to replace, so a new one issues no search.
+   */
+  private readonly currentSearch;
+  readonly canUpdateQuery: import("@angular/core").Signal<boolean>;
+  readonly updateStatus: import("@angular/core").WritableSignal<"updating" | "updated" | "idle">;
+  /** Why the last save failed — shown in the form until the next attempt. */
+  protected readonly saveError: import("@angular/core").WritableSignal<{
+    detail?: string;
+  } | undefined>;
+  /** Form model: the stored alert's values, or the defaults of a new one. Follows the alert it edits. */
   readonly alertModel: import("@angular/core").WritableSignal<AlertFormModel>;
   protected readonly alertForm: FieldTree<AlertFormModel, string | number, "writable">;
+  /** True while a submission is being saved — for a container that disables its confirm button meanwhile. */
+  readonly saving: import("@angular/core").Signal<boolean>;
   /**
    * The weekday group shows its error like any other field: once touched — which, for a group the
    * checkboxes cannot blur, means once the form has been submitted.
    */
   protected readonly showDaysError: import("@angular/core").Signal<boolean>;
-  constructor();
-  private init;
+  /** Checks exactly the days of `mask` — the "Weekdays" and "Every day" shortcuts. */
+  protected setDays(mask: Alert.Days): void;
   /**
    * The submission itself, only ever reached with a valid form: `submit()` marks every field as
    * touched — revealing the messages — and runs the action only when the form is valid.
@@ -11233,8 +11357,35 @@ export declare class AlertDialog {
   protected showError<T>(field: FieldTree<T>): boolean;
   /** Maps the first validation error to its translation key (`alerts.errors.noDaySelected`, …). */
   protected errorKey<T>(field: FieldTree<T>): string;
-  updateQuery(): void;
-  execute(): void;
+  protected updateQuery(): void;
+  protected execute(): void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<AlertFormComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<AlertFormComponent, "alert-form, alertform, AlertFormComponent", never, {
+    "index": {
+      "alias": "index";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {
+    "saved": "saved";
+    "executed": "executed";
+  }, never, never, true, never>;
+}
+/**
+ * The modal dialog around {@link AlertFormComponent}: a title, the form, and the Cancel / Confirm buttons.
+ *
+ * It only hosts the form — the fields, the validation and the save are the form's. Confirm sits outside the
+ * `<form>` and submits it through its `form` attribute; the dialog closes when the form says the alert is
+ * saved (`dialog-confirm`) or that the watched search has been run.
+ *
+ * Open it with {@link AlertForm}, which takes the index of the alert to edit (none to create one).
+ */
+export declare class AlertDialog {
+  protected readonly call: import("@sinequa/galactik").CallRef<number | undefined, DialogEvent>;
+  readonly dialog: import("@angular/core").Signal<DialogComponent | undefined>;
+  /** Index, in the user settings, of the alert being edited — `undefined` in "create" mode. */
+  protected readonly index: import("@angular/core").WritableSignal<number | undefined>;
+  constructor();
   static ɵfac: i0.ɵɵFactoryDeclaration<AlertDialog, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<AlertDialog, "alert-dialog, alertdialog, AlertDialog", never, {}, {}, never, never, true, never>;
 }
@@ -11662,8 +11813,8 @@ export declare class SignedOutComponent {
   static ɵcmp: i0.ɵɵComponentDeclaration<SignedOutComponent, "signed-out, SignedOut, signedout", never, {}, {}, never, never, true, never>;
 }
 export declare class BookmarkButtonComponent {
-  variant: import("@angular/core").InputSignal<"primary" | "secondary" | "none" | "light-accent" | "accent" | "tertiary" | null | undefined>;
-  size: import("@angular/core").InputSignal<"small" | "medium" | "xs" | "sm" | "md" | "xsmall" | "large" | "lg" | null | undefined>;
+  variant: import("@angular/core").InputSignal<"none" | "primary" | "secondary" | "light-accent" | "accent" | "tertiary" | null | undefined>;
+  size: import("@angular/core").InputSignal<"small" | "large" | "sm" | "md" | "xs" | "xsmall" | "medium" | "lg" | null | undefined>;
   /**
    * Tab index applied to the inner button.
    *
@@ -12754,7 +12905,7 @@ export declare class SearchFeedbackComponent {
   onClose: import("@angular/core").OutputEmitterRef<void>;
   private readonly injector;
   pages: import("@angular/core").InputSignal<any>;
-  variant: import("@angular/core").InputSignal<"primary" | "secondary" | "none" | "light-accent" | "accent" | "tertiary" | null | undefined>;
+  variant: import("@angular/core").InputSignal<"none" | "primary" | "secondary" | "light-accent" | "accent" | "tertiary" | null | undefined>;
   readonly auditService: AuditService;
   protected readonly queryParamsStore: {
     name?: import("@angular/core").Signal<string | undefined> | undefined;
@@ -13087,7 +13238,7 @@ export declare class AggregationDateComponent {
    *
    * @default 'selection'
    */
-  emitOn: import("@angular/core").InputSignal<"selection" | "apply">;
+  emitOn: import("@angular/core").InputSignal<"apply" | "selection">;
   readonly title: import("@angular/core").InputSignal<AggregationTitle>;
   readonly displayEmptyDistributionIntervals: import("@angular/core").InputSignal<boolean>;
   onSelect: import("@angular/core").OutputEmitterRef<AggregationItem[]>;
@@ -15547,7 +15698,7 @@ export declare class AggregationComponent {
    *
    * @default 'selection'
    */
-  emitOn: import("@angular/core").InputSignal<"selection" | "apply">;
+  emitOn: import("@angular/core").InputSignal<"apply" | "selection">;
   /**
    * Which sub-component renders the aggregation.
    *
@@ -15560,7 +15711,7 @@ export declare class AggregationComponent {
    *
    * @default "auto"
    */
-  type: import("@angular/core").InputSignal<"auto" | "list" | "tree" | "date">;
+  type: import("@angular/core").InputSignal<"date" | "list" | "tree" | "auto">;
   /**
    * Whether the host removes itself from the layout (Tailwind's `hidden`, i.e.
    * `display: none`) when it resolves to zero items. When `false` (default), the
@@ -15612,7 +15763,7 @@ export declare class AggregationComponent {
    * The sub-component to render: the explicit `type` input, or the current
    * date/tree/list heuristic when `type` is `"auto"`.
    */
-  protected resolvedType: import("@angular/core").Signal<"list" | "tree" | "date">;
+  protected resolvedType: import("@angular/core").Signal<"date" | "list" | "tree">;
   /** Whether a filter is currently applied on this aggregation. */
   private readonly hasFilters;
   /**
@@ -15985,7 +16136,7 @@ export declare class AppliedFiltersComponent {
   /** Chip colour scheme, passed to galactik's `tag`. */
   readonly scheme: import("@angular/core").InputSignal<"error" | "sage" | "success" | "almond" | "pink" | "grey" | "yellow" | "cherry" | "indigo" | "cyan" | "warning" | "info" | null | undefined>;
   /** Chip size, passed to galactik's `tag`. */
-  readonly size: import("@angular/core").InputSignal<"small" | "medium" | "xs" | "sm" | "md" | "xsmall" | null | undefined>;
+  readonly size: import("@angular/core").InputSignal<"small" | "sm" | "md" | "xs" | "xsmall" | "medium" | null | undefined>;
   /** Extra classes for each chip, merged by galactik's `tag`. */
   readonly chipClass: import("@angular/core").InputSignal<string>;
   /** A chip was removed. */
@@ -16180,7 +16331,7 @@ export declare class FilterButtonComponent {
    * silently moved to a hidden one.
    */
   overflowed: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
-  protected variant: import("@angular/core").WritableSignal<"primary" | "secondary" | "none" | "light-accent" | "accent" | "tertiary" | null | undefined>;
+  protected variant: import("@angular/core").WritableSignal<"none" | "primary" | "secondary" | "light-accent" | "accent" | "tertiary" | null | undefined>;
   protected filter: import("@angular/core").WritableSignal<CFilterEx>;
   /** Unique id wiring the trigger's `popovertarget` to the `<div popover>` `id`. */
   protected readonly popoverId: string;
@@ -18623,7 +18774,7 @@ export declare class RecentSearchesComponent {
   }>;
   protected readonly transloco: TranslocoService;
   private readonly router;
-  protected getRelativeDate: typeof getRelativeDate;
+  protected subtextOf: (search: SearchItem) => string | undefined;
   protected urlOf: (search: SearchItem) => string;
   protected labelOf: (search: SearchItem) => string;
   protected readonly range: import("@angular/core").WritableSignal<number>;
@@ -18820,7 +18971,7 @@ export declare class SavedSearchesComponent {
   }>;
   protected readonly transloco: TranslocoService;
   private readonly router;
-  protected getRelativeDate: typeof getRelativeDate;
+  protected subtextOf: (search: SearchItem) => string | undefined;
   protected urlOf: (search: SearchItem) => string;
   protected labelOf: (search: SearchItem) => string;
   protected readonly range: import("@angular/core").WritableSignal<number>;
@@ -18840,7 +18991,7 @@ export declare class SavedSearchesComponent {
     };
   }, {}, never, never, true, never>;
 }
-export type SettingsPanelId = "account" | "appearance" | "shortcuts";
+export type SettingsPanelId = "account" | "appearance" | "alerts" | "shortcuts";
 /** Payload of `Settings.call()`: the panel to show first (default `account`). */
 export interface SettingsDialogProps {
   panel?: SettingsPanelId;
@@ -19003,6 +19154,27 @@ export declare class SettingsAppearancePanelComponent {
   static ɵfac: i0.ɵɵFactoryDeclaration<SettingsAppearancePanelComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<SettingsAppearancePanelComponent, "settings-appearance-panel", never, {}, {}, never, never, true, never>;
 }
+/**
+ * The user's alerts: the list, and — once one is picked, or "Create" is pressed — the form in the same panel.
+ *
+ * The form is not a second dialog on top of the settings: the panel swaps from the list to the form and back,
+ * and a failed save is shown in the form itself, which a toast could not do behind a modal dialog.
+ */
+export declare class SettingsAlertsPanelComponent {
+  /** The user ran an alert's search: the settings have nothing more to show, the page behind has the results. */
+  readonly closeRequested: import("@angular/core").OutputEmitterRef<void>;
+  /** The form being shown — `index` is the alert to edit, `undefined` to create one — or nothing: the list. */
+  protected readonly form: import("@angular/core").WritableSignal<{
+    index: number | undefined;
+  } | undefined>;
+  protected edit(index: number): void;
+  protected create(): void;
+  protected back(): void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<SettingsAlertsPanelComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<SettingsAlertsPanelComponent, "settings-alerts-panel", never, {}, {
+    "closeRequested": "closeRequested";
+  }, never, never, true, never>;
+}
 /** The keyboard shortcuts currently registered, as documented by the registry itself. */
 export declare class SettingsShortcutsPanelComponent {
   static ɵfac: i0.ɵɵFactoryDeclaration<SettingsShortcutsPanelComponent, never>;