@sinequa/atomic-angular 2.7.0 → 2.8.0

package/package.json

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

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

@@ -2595,7 +2595,7 @@ export declare class WorkspaceMentionNew implements AfterContentInit {
   /** 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<"sm" | "md" | "lg" | "small" | "xs" | "xsmall" | "medium" | "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. */

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,20 +11094,76 @@ export declare class ArticleSimilarDocumentsTabPanel {
     "selected": "selected";
   }, never, never, true, never>;
 }
+/** One piece of the summary: a translation key (translated by the template's pipe) or a ready text. */
+interface AlertSummaryPart {
+  key?: string;
+  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[];
+/**
+ * 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;
+  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>;
 }
@@ -11212,6 +11267,10 @@ export declare class AlertDialog {
   readonly alert: import("@angular/core").WritableSignal<Alert | undefined>;
   canUpdateQuery: import("@angular/core").WritableSignal<boolean>;
   updateStatus: import("@angular/core").WritableSignal<"idle" | "updating" | "updated">;
+  /** Why the last save failed — shown in the dialog until the next attempt. */
+  protected readonly saveError: import("@angular/core").WritableSignal<{
+    detail?: string;
+  } | undefined>;
   /** Form model. Replaces the five former scalar signals. */
   readonly alertModel: import("@angular/core").WritableSignal<AlertFormModel>;
   protected readonly alertForm: FieldTree<AlertFormModel, string | number, "writable">;
@@ -11663,7 +11722,7 @@ export declare class SignedOutComponent {
 }
 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>;
+  size: import("@angular/core").InputSignal<"small" | "sm" | "md" | "xs" | "xsmall" | "medium" | "lg" | "large" | null | undefined>;
   /**
    * Tab index applied to the inner button.
    *
@@ -15985,7 +16044,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. */
@@ -18623,7 +18682,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 +18879,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>;